Merge release 'release-2.1.0' branch into main

.github/CODEOWNERS

@@ -1,2 +1,2 @@
 # https://docs.github.com/en/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-code-owners
-*      @asein-sinch @JPPortier @matsk-sinch @rpredescu-sinch @edu-sinch @Hurus111
+*      @asein-sinch @JPPortier @matsk-sinch @edu-sinch @Hurus111 @marcos-sinch

.github/workflows/generate-upload-documentation.yml

@@ -0,0 +1,78 @@
+name: Generate and upload documentation
+
+on:
+  release:
+    types: [published]
+  workflow_dispatch:
+    inputs:
+      version:
+        description: 'Version to use for the documentation package in semver format (e.g. 1.2.3)'
+        required: true
+
+jobs:
+  upload-documentation:
+    runs-on: ubuntu-latest
+    env:
+      SDK_NAME: sinch-sdk-java
+
+    steps:
+      - name: Checkout Code
+        uses: actions/checkout@v4
+
+      - name: Resolve Version
+        id: version
+        run: |
+          if [ "${{ github.event_name }}" = "release" ]; then
+            VERSION="${{ github.event.release.tag_name }}"
+          else
+            VERSION="${{ inputs.version }}"
+          fi
+          # Strip leading 'v' if present (e.g. v1.2.3 → 1.2.3)
+          VERSION="${VERSION#v}"
+          echo "value=${VERSION}" >> "$GITHUB_OUTPUT"
+
+      - name: Validate Version Format
+        run: |
+          VERSION="${{ steps.version.outputs.value }}"
+          SEMVER_REGEX='^(0|[1-9][0-9]*)\.(0|[1-9][0-9]*)\.(0|[1-9][0-9]*)(-((alpha|beta|preview)(\.[0-9]+)?))?$'
+          if [[ ! "$VERSION" =~ $SEMVER_REGEX ]]; then
+            echo "::error::Invalid version format: '$VERSION'. Expected semver (e.g. 1.2.3, 1.2.3-alpha, 1.2.3-beta.1, 1.2.3-preview)"
+            exit 1
+          fi
+          echo "Version '$VERSION' is valid"
+
+      - name: Setup Java SDK
+        uses: actions/setup-java@v4
+        with:
+          java-version: '21'
+          distribution: 'temurin'
+          cache: maven
+
+      - name: Generate Documentation
+        run: mvn -B javadoc:javadoc --file pom.xml
+
+      - name: Package Documentation
+        run: |
+          cd target/site/apidocs
+          zip -r "../../../${{ env.SDK_NAME }}-${{ steps.version.outputs.value }}.zip" .
+
+      - name: Upload to GitLab Registry
+        run: |
+          echo "Uploading documentation package to GitLab Registry..."
+          VERSION="${{ steps.version.outputs.value }}"
+          curl --fail --show-error --location --header "PRIVATE-TOKEN: ${{ secrets.GITLAB_REGISTRY_UPLOAD_DOC_TOKEN }}" \
+               --upload-file "./${{ env.SDK_NAME }}-${VERSION}.zip" \
+               "https://gitlab.com/api/v4/projects/63164411/packages/generic/${{ env.SDK_NAME }}/${VERSION}/${{ env.SDK_NAME }}-${VERSION}.zip"
+          echo "Documentation package for version ${VERSION} uploaded to GitLab Registry"
+
+      - name: Trigger Downstream GitLab Pipeline
+        run: |
+          echo "Triggering downstream GitLab pipeline to notify about new documentation package version..."
+          VERSION="${{ steps.version.outputs.value }}"
+          curl --fail --show-error --location --request POST \
+               --form "token=${{ secrets.GITLAB_NOTIFY_REGISTRY_UPLOADED_DOC_TOKEN }}" \
+               --form "ref=main" \
+               --form "variables[UPSTREAM_PACKAGE_NAME]=${{ env.SDK_NAME }}" \
+               --form "variables[UPSTREAM_PACKAGE_VERSION]=${VERSION}" \
+               "https://gitlab.com/api/v4/projects/63164411/trigger/pipeline"
+          echo "Documentation repo notified about new package version ${VERSION}"

CHANGELOG.md

@@ -16,6 +16,36 @@ All notable changes to the **Sinch Java SDK** are documented in this file.
 
 ---
 
+## v2.1 – 2026-07-02
+
+### Numbers
+- Extend `NumberSinchEvents` class.
+  - **[fix]** `EventTypeEnum`: `DEPROVISIONING_TO_VOICE_PLATFORM` is deprecated and has to be replaced by `DEPROVISIONING_FROM_VOICE_PLATFORM`.
+  - **[feature]** Support new `internalFailureCode` field.
+  - **[feature]** Support new `StatusEnum` values: `IN_REVIEW`, `BLOCKED`, `COMPLETED`, `REJECTED`, `EXPIRED`.
+  - **[feature]** Support new `EventTypeEnum` value: `NUMBER_ORDER_PROCESSING`.
+
+### Conversation
+- **[feature]** Support `Consents` API: `listIdentities` and `listAuditRecords` endpoints
+
+### Number Lookup
+- **[feature]** Support `Number Lookup` API V2
+
+### SDK
+- **[feature]** HTTP proxy support: configure an unauthenticated or authenticated (Basic) proxy via `HttpProxyConfiguration`
+- **[feature]** `SinchClient` exposes a `close()` method to shut down the underlying HTTP connection pool and release all associated resources deterministically
+- **[fix]** `HttpClientApache`: declare now `headersToBeAdded` as `volatile` to guarantee visibility across threads in concurrent usage
+- **[fix]** `HttpClientApache`: wrap response-body `Scanner` in a try-with-resources block to prevent resource leaks; gracefully handle empty (`null`) response entities
+- **[fix]** `SinchClient`: guard against a `NullPointerException` when `java.vendor` system property is absent while building the `User-Agent` auxiliary flag
+- **[fix]** `Configuration`: correct copy-paste error in `toString()` and Javadoc — `conversationContext` label was incorrectly attributed to the Voice domain
+- **[doc]** Improve README structure and content.
+
+
+### Examples / Snippets
+- **[doc]** Fix typos in `conversation/conversations/Create` and `voice/applications/GetEventDestinations` snippets
+
+---
+
 ## v2.0 – 2026-03-31
 
 ### Major breaking changes with major release

README.md

@@ -19,6 +19,7 @@ For more information on the SDK, refer to the dedicated [Java SDK documentation
 - [Getting started](#getting-started)
 - [Logging](#logging)
 - [Handling Exceptions](#handling-exceptions)
+- [Proxy configuration](#proxy-configuration)
 - [Third-party dependencies](#third-party-dependencies)
 - [Examples](#examples)
 - [Changelog and Migration](#changelog--migration)
@@ -61,6 +62,7 @@ Note: The `${sdk.version}` needs to be set according to the released version to
 | Voice and Video | [Voice API](https://developers.sinch.com/docs/voice/)               |
 | Numbers         | [Numbers API](https://developers.sinch.com/docs/numbers/)           |
 | Verification    | [Verification API](https://developers.sinch.com/docs/verification/) |
+|                 | [Number Lookup API](https://developers.sinch.com/docs/number-lookup/) |
 
 > **Note:** The SMS API is end-of-sale. New integrations should use the [Conversation API](https://developers.sinch.com/docs/conversation/) instead, which supports SMS and many other channels.
 
@@ -226,6 +228,10 @@ NumberSinchEvent event = sinchEvents.parseEvent(body);
 
 You can find a complete example in [examples/sinch-events](examples/sinch-events).
 
+### Number Lookup API
+
+The Number Lookup API needs no extra parameters, use the [common client](#client-initialization) shown above.
+
 ### Verification API
 
 The Verification API uses application credentials. Set `applicationKey` and `applicationSecret`, both available on the [Apps dashboard](https://dashboard.sinch.com/verification/apps):
@@ -392,6 +398,54 @@ try {
 - `ApiAuthException`: authentication/authorization failures.
 - `ApiMappingException`: the response payload could not be deserialized into the expected type.
 
+## Proxy configuration
+
+If your network environment routes outbound traffic through an HTTP proxy, provide proxy
+configuration via [HttpProxyConfiguration](client/src/main/com/sinch/sdk/models/HttpProxyConfiguration.java) on the [Configuration](client/src/main/com/sinch/sdk/models/Configuration.java) builder.
+
+When used, all connections will go through the proxy (including OAuth).
+
+**Unauthenticated proxy:**
+
+```java
+import com.sinch.sdk.SinchClient;
+import com.sinch.sdk.models.Configuration;
+import com.sinch.sdk.models.HttpProxyConfiguration;
+
+...
+Configuration configuration = Configuration.builder()
+        .setKeyId(PARAM_KEY_ID)
+        .setKeySecret(PARAM_KEY_SECRET)
+        .setProjectId(PARAM_PROJECT_ID)
+        .setHttpProxyConfiguration(
+                HttpProxyConfiguration.builder()
+                        .setHostname(PARAM_PROXY_HOSTNAME)
+                        .setPort(PARAM_PROXY_PORT)
+                        .build())
+        .build();
+SinchClient client = new SinchClient(configuration);
+```
+
+**Authenticated proxy:**
+
+
+```java
+Configuration configuration = Configuration.builder()
+        .setKeyId(PARAM_KEY_ID)
+        .setKeySecret(PARAM_KEY_SECRET)
+        .setProjectId(PARAM_PROJECT_ID)
+        .setHttpProxyConfiguration(
+              HttpProxyConfiguration.builder()
+                  .setHostname(PARAM_PROXY_HOSTNAME)
+                  .setPort(PARAM_PROXY_PORT)
+                  .setUsername(PARAM_PROXY_USERNAME)
+                  // prefer char[] over String to reduce password exposure in heap memory    
+                  .setPassword(PARAM_PROXY_PASSWORD_AS_CHAR_ARRAY)
+                  .build())
+        .build();
+SinchClient client = new SinchClient(configuration);
+```
+
 
 ## Third-party dependencies
 The SDK relies on the following third-party dependencies:
@@ -435,11 +489,11 @@ Note: Replace `VERSION-YOU-WANT-TO-BE-USED` with a Jackson version of at least `
 ## Examples
 
 You can find:
- - self-contained code snippets covering every API operation in the [examples/snippets](./examples/snippets) folder.
- - getting started guides for specific use cases in the [examples/getting-started](./examples/getting-started) folder.
- - a Spring Boot server template to process received Sinch Events in the [examples/sinch-events](./examples/sinch-events) folder.
- - an SDK client template application in the [examples/client](./examples/client) folder.
- - step-by-step tutorials combining multiple SDK features in the [examples/tutorials](./examples/tutorials) folder.
+- self-contained code snippets covering every API operation in the [examples/snippets](./examples/snippets) folder.
+- getting started guides for specific use cases in the [examples/getting-started](./examples/getting-started) folder.
+- a Spring Boot server template to process received Sinch Events in the [examples/sinch-events](./examples/sinch-events) folder.
+- an SDK client template application in the [examples/client](./examples/client) folder.
+- step-by-step tutorials combining multiple SDK features in the [examples/tutorials](./examples/tutorials) folder.
 
 
 ## Changelog & Migration
@@ -452,4 +506,4 @@ This project is licensed under the Apache License. See the [LICENSE](LICENSE) fi
 
 ## Contact
 
-Developer Experience engineering team: [team-developer-experience@sinch.com](mailto:team-developer-experience@sinch.com)
+Developer Experience engineering team: [team-developer-experience@sinch.com](mailto:team-developer-experience@sinch.com)

client/resources/config-default.properties

@@ -21,3 +21,5 @@ voice-server-south-east-asia2=https://calling-apse2.api.sinch.com
 conversation-region=
 conversation-server=https://%s.conversation.api.sinch.com
 template-management-conversation-server=https://%s.template.api.sinch.com
+
+number-lookup-server=https://lookup.api.sinch.com

client/src/main/com/sinch/sdk/SDK.java

@@ -3,6 +3,6 @@
 public class SDK {
 
   public static final String NAME = "Sinch Java SDK";
-  public static final String VERSION = "2.1.0-dev";
+  public static final String VERSION = "2.2.0-dev";
   public static final String AUXILIARY_FLAG = "";
 }