release: 0.1.0-alpha.4 (#5)

stainless-app[bot] · web-flow · commit 0f190ab517c7 · 2026-05-07T11:13:33.000+03:00
* feat(client): support proxy authentication

* release: 0.1.0-alpha.4

---------

Co-authored-by: stainless-app[bot] &lt;142633134+stainless-app[bot]@users.noreply.github.com&gt;
diff --git a/.release-please-manifest.json b/.release-please-manifest.json
@@ -1,3 +1,3 @@
 {
-  ".": "0.1.0-alpha.3"
+  ".": "0.1.0-alpha.4"
 }
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,5 +1,13 @@
 # Changelog
 
+## 0.1.0-alpha.4 (2026-05-06)
+
+Full Changelog: [v0.1.0-alpha.3...v0.1.0-alpha.4](https://github.com/HubSpot/hubspot-sdk-java/compare/v0.1.0-alpha.3...v0.1.0-alpha.4)
+
+### Features
+
+* **client:** support proxy authentication ([59950f7](https://github.com/HubSpot/hubspot-sdk-java/commit/59950f799fdca00a756378f15da57290f6bb0c0b))
+
 ## 0.1.0-alpha.3 (2026-05-05)
 
 Full Changelog: [v0.1.0-alpha.2...v0.1.0-alpha.3](https://github.com/HubSpot/hubspot-sdk-java/compare/v0.1.0-alpha.2...v0.1.0-alpha.3)
diff --git a/README.md b/README.md
@@ -2,8 +2,8 @@
 
 <!-- x-release-please-start-version -->
 
-[![Maven Central](https://img.shields.io/maven-central/v/com.hubspot.sdk/hubspot-java)](https://central.sonatype.com/artifact/com.hubspot.sdk/hubspot-java/0.1.0-alpha.3)
-[![javadoc](https://javadoc.io/badge2/com.hubspot.sdk/hubspot-java/0.1.0-alpha.3/javadoc.svg)](https://javadoc.io/doc/com.hubspot.sdk/hubspot-java/0.1.0-alpha.3)
+[![Maven Central](https://img.shields.io/maven-central/v/com.hubspot.sdk/hubspot-java)](https://central.sonatype.com/artifact/com.hubspot.sdk/hubspot-java/0.1.0-alpha.4)
+[![javadoc](https://javadoc.io/badge2/com.hubspot.sdk/hubspot-java/0.1.0-alpha.4/javadoc.svg)](https://javadoc.io/doc/com.hubspot.sdk/hubspot-java/0.1.0-alpha.4)
 
 <!-- x-release-please-end -->
 
@@ -13,7 +13,7 @@ It is generated with [Stainless](https://www.stainless.com/).
 
 <!-- x-release-please-start-version -->
 
-The REST API documentation can be found on [developers.hubspot.com](https://developers.hubspot.com/docs/api-reference/overview). Javadocs are available on [javadoc.io](https://javadoc.io/doc/com.hubspot.sdk/hubspot-java/0.1.0-alpha.3).
+The REST API documentation can be found on [developers.hubspot.com](https://developers.hubspot.com/docs/api-reference/overview). Javadocs are available on [javadoc.io](https://javadoc.io/doc/com.hubspot.sdk/hubspot-java/0.1.0-alpha.4).
 
 <!-- x-release-please-end -->
 
@@ -24,7 +24,7 @@ The REST API documentation can be found on [developers.hubspot.com](https://deve
 ### Gradle
 
 ```kotlin
-implementation("com.hubspot.sdk:hubspot-java:0.1.0-alpha.3")
+implementation("com.hubspot.sdk:hubspot-java:0.1.0-alpha.4")
 ```
 
 ### Maven
@@ -33,7 +33,7 @@ implementation("com.hubspot.sdk:hubspot-java:0.1.0-alpha.3")
 <dependency>
   <groupId>com.hubspot.sdk</groupId>
   <artifactId>hubspot-java</artifactId>
-  <version>0.1.0-alpha.3</version>
+  <version>0.1.0-alpha.4</version>
 </dependency>
 ```
 
@@ -579,6 +579,22 @@ HubSpotClient client = HubSpotOkHttpClient.builder()
     .build();
 ```
 
+If the proxy responds with `407 Proxy Authentication Required`, supply credentials by also configuring `proxyAuthenticator`:
+
+```java
+import com.hubspot.sdk.client.HubSpotClient;
+import com.hubspot.sdk.client.okhttp.HubSpotOkHttpClient;
+import com.hubspot.sdk.core.http.ProxyAuthenticator;
+
+HubSpotClient client = HubSpotOkHttpClient.builder()
+    .fromEnv()
+    .proxy(...)
+    // Or a custom implementation of `ProxyAuthenticator`.
+    .proxyAuthenticator(ProxyAuthenticator.basic("username", "password"))
+    .accessToken("My Access Token")
+    .build();
+```
+
 ### Connection pooling
 
 To customize the underlying OkHttp connection pool, configure the client using the `maxIdleConnections` and `keepAliveDuration` methods:
diff --git a/build.gradle.kts b/build.gradle.kts
@@ -9,7 +9,7 @@ repositories {
 
 allprojects {
     group = "com.hubspot.sdk"
-    version = "0.1.0-alpha.3" // x-release-please-version
+    version = "0.1.0-alpha.4" // x-release-please-version
 }
 
 subprojects {
diff --git a/hubspot-java-client-okhttp/src/main/kotlin/com/hubspot/sdk/client/okhttp/HubSpotOkHttpClient.kt b/hubspot-java-client-okhttp/src/main/kotlin/com/hubspot/sdk/client/okhttp/HubSpotOkHttpClient.kt
@@ -11,6 +11,7 @@ import com.hubspot.sdk.core.Timeout
 import com.hubspot.sdk.core.http.AsyncStreamResponse
 import com.hubspot.sdk.core.http.Headers
 import com.hubspot.sdk.core.http.HttpClient
+import com.hubspot.sdk.core.http.ProxyAuthenticator
 import com.hubspot.sdk.core.http.QueryParams
 import com.hubspot.sdk.core.jsonMapper
 import java.net.Proxy
@@ -49,6 +50,7 @@ class HubSpotOkHttpClient private constructor() {
         private var clientOptions: ClientOptions.Builder = ClientOptions.builder()
         private var dispatcherExecutorService: ExecutorService? = null
         private var proxy: Proxy? = null
+        private var proxyAuthenticator: ProxyAuthenticator? = null
         private var maxIdleConnections: Int? = null
         private var keepAliveDuration: Duration? = null
         private var sslSocketFactory: SSLSocketFactory? = null
@@ -79,6 +81,20 @@ class HubSpotOkHttpClient private constructor() {
         /** Alias for calling [Builder.proxy] with `proxy.orElse(null)`. */
         fun proxy(proxy: Optional<Proxy>) = proxy(proxy.getOrNull())
 
+        /**
+         * Provides credentials when an HTTP proxy responds with `407 Proxy Authentication
+         * Required`.
+         */
+        fun proxyAuthenticator(proxyAuthenticator: ProxyAuthenticator?) = apply {
+            this.proxyAuthenticator = proxyAuthenticator
+        }
+
+        /**
+         * Alias for calling [Builder.proxyAuthenticator] with `proxyAuthenticator.orElse(null)`.
+         */
+        fun proxyAuthenticator(proxyAuthenticator: Optional<ProxyAuthenticator>) =
+            proxyAuthenticator(proxyAuthenticator.getOrNull())
+
         /**
          * The maximum number of idle connections kept by the underlying OkHttp connection pool.
          *
@@ -386,6 +402,7 @@ class HubSpotOkHttpClient private constructor() {
                         OkHttpClient.builder()
                             .timeout(clientOptions.timeout())
                             .proxy(proxy)
+                            .proxyAuthenticator(proxyAuthenticator)
                             .maxIdleConnections(maxIdleConnections)
                             .keepAliveDuration(keepAliveDuration)
                             .dispatcherExecutorService(dispatcherExecutorService)
diff --git a/hubspot-java-client-okhttp/src/main/kotlin/com/hubspot/sdk/client/okhttp/HubSpotOkHttpClientAsync.kt b/hubspot-java-client-okhttp/src/main/kotlin/com/hubspot/sdk/client/okhttp/HubSpotOkHttpClientAsync.kt
@@ -11,6 +11,7 @@ import com.hubspot.sdk.core.Timeout
 import com.hubspot.sdk.core.http.AsyncStreamResponse
 import com.hubspot.sdk.core.http.Headers
 import com.hubspot.sdk.core.http.HttpClient
+import com.hubspot.sdk.core.http.ProxyAuthenticator
 import com.hubspot.sdk.core.http.QueryParams
 import com.hubspot.sdk.core.jsonMapper
 import java.net.Proxy
@@ -49,6 +50,7 @@ class HubSpotOkHttpClientAsync private constructor() {
         private var clientOptions: ClientOptions.Builder = ClientOptions.builder()
         private var dispatcherExecutorService: ExecutorService? = null
         private var proxy: Proxy? = null
+        private var proxyAuthenticator: ProxyAuthenticator? = null
         private var maxIdleConnections: Int? = null
         private var keepAliveDuration: Duration? = null
         private var sslSocketFactory: SSLSocketFactory? = null
@@ -79,6 +81,20 @@ class HubSpotOkHttpClientAsync private constructor() {
         /** Alias for calling [Builder.proxy] with `proxy.orElse(null)`. */
         fun proxy(proxy: Optional<Proxy>) = proxy(proxy.getOrNull())
 
+        /**
+         * Provides credentials when an HTTP proxy responds with `407 Proxy Authentication
+         * Required`.
+         */
+        fun proxyAuthenticator(proxyAuthenticator: ProxyAuthenticator?) = apply {
+            this.proxyAuthenticator = proxyAuthenticator
+        }
+
+        /**
+         * Alias for calling [Builder.proxyAuthenticator] with `proxyAuthenticator.orElse(null)`.
+         */
+        fun proxyAuthenticator(proxyAuthenticator: Optional<ProxyAuthenticator>) =
+            proxyAuthenticator(proxyAuthenticator.getOrNull())
+
         /**
          * The maximum number of idle connections kept by the underlying OkHttp connection pool.
          *
@@ -386,6 +402,7 @@ class HubSpotOkHttpClientAsync private constructor() {
                         OkHttpClient.builder()
                             .timeout(clientOptions.timeout())
                             .proxy(proxy)
+                            .proxyAuthenticator(proxyAuthenticator)
                             .maxIdleConnections(maxIdleConnections)
                             .keepAliveDuration(keepAliveDuration)
                             .dispatcherExecutorService(dispatcherExecutorService)
diff --git a/hubspot-java-client-okhttp/src/main/kotlin/com/hubspot/sdk/client/okhttp/OkHttpClient.kt b/hubspot-java-client-okhttp/src/main/kotlin/com/hubspot/sdk/client/okhttp/OkHttpClient.kt
diff --git a/hubspot-java-core/src/main/kotlin/com/hubspot/sdk/core/http/ProxyAuthenticator.kt b/hubspot-java-core/src/main/kotlin/com/hubspot/sdk/core/http/ProxyAuthenticator.kt

Original file line number	Diff line number	Diff line change
`@@ -1,3 +1,3 @@`
`1`	`1`	`{`
`2`		`- ".": "0.1.0-alpha.3"`
	`2`	`+ ".": "0.1.0-alpha.4"`
`3`	`3`	`}`
Original file line number	Diff line number	Diff line change
`@@ -9,7 +9,7 @@ repositories {`
`9`	`9`
`10`	`10`	`allprojects {`
`11`	`11`	`group = "com.hubspot.sdk"`
`12`		`- version = "0.1.0-alpha.3" // x-release-please-version`
	`12`	`+ version = "0.1.0-alpha.4" // x-release-please-version`
`13`	`13`	`}`
`14`	`14`
`15`	`15`	`subprojects {`