Increase · stainless-app · Jul 17, 2025 · Jul 15, 2025 · Jul 16, 2025 · Jul 17, 2025
diff --git a/.github/workflows/publish-sonatype.yml b/.github/workflows/publish-sonatype.yml
@@ -17,7 +17,7 @@ jobs:
       - uses: actions/checkout@v4
 
       - name: Set up Java
-        uses: actions/setup-java@v3
+        uses: actions/setup-java@v4
         with:
           distribution: temurin
           java-version: |

diff --git a/.release-please-manifest.json b/.release-please-manifest.json
@@ -1,3 +1,3 @@
 {
-  ".": "0.261.0"
+  ".": "0.261.1"
 }
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,5 +1,19 @@
 # Changelog
 
+## 0.261.1 (2025-07-17)
+
+Full Changelog: [v0.261.0...v0.261.1](https://github.com/Increase/increase-java/compare/v0.261.0...v0.261.1)
+
+### Bug Fixes
+
+* **client:** ensure error handling always occurs ([82faed8](https://github.com/Increase/increase-java/commit/82faed8125f96e02e9c20d989d41bb50942df037))
+
+
+### Chores
+
+* **ci:** bump `actions/setup-java` to v4 ([90bded8](https://github.com/Increase/increase-java/commit/90bded87bd08864097d705f9a05f8d52735f54c7))
+* **internal:** allow running specific example from cli ([9ac4855](https://github.com/Increase/increase-java/commit/9ac4855ae6f2fbe7d7a82a7e10b79fc9d62b631f))
+
 ## 0.261.0 (2025-07-11)
 
 Full Changelog: [v0.260.0...v0.261.0](https://github.com/Increase/increase-java/compare/v0.260.0...v0.261.0)

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.increase.api/increase-java)](https://central.sonatype.com/artifact/com.increase.api/increase-java/0.261.0)
-[![javadoc](https://javadoc.io/badge2/com.increase.api/increase-java/0.261.0/javadoc.svg)](https://javadoc.io/doc/com.increase.api/increase-java/0.261.0)
+[![Maven Central](https://img.shields.io/maven-central/v/com.increase.api/increase-java)](https://central.sonatype.com/artifact/com.increase.api/increase-java/0.261.1)
+[![javadoc](https://javadoc.io/badge2/com.increase.api/increase-java/0.261.1/javadoc.svg)](https://javadoc.io/doc/com.increase.api/increase-java/0.261.1)
 
 <!-- x-release-please-end -->
 
@@ -13,7 +13,7 @@ The Increase Java SDK is similar to the Increase Kotlin SDK but with minor diffe
 
 <!-- x-release-please-start-version -->
 
-The REST API documentation can be found on [increase.com](https://increase.com/documentation). Javadocs are available on [javadoc.io](https://javadoc.io/doc/com.increase.api/increase-java/0.261.0).
+The REST API documentation can be found on [increase.com](https://increase.com/documentation). Javadocs are available on [javadoc.io](https://javadoc.io/doc/com.increase.api/increase-java/0.261.1).
 
 <!-- x-release-please-end -->
 
@@ -24,7 +24,7 @@ The REST API documentation can be found on [increase.com](https://increase.com/d
 ### Gradle
 
 ```kotlin
-implementation("com.increase.api:increase-java:0.261.0")
+implementation("com.increase.api:increase-java:0.261.1")
 ```
 
 ### Maven
@@ -33,7 +33,7 @@ implementation("com.increase.api:increase-java:0.261.0")
 <dependency>
   <groupId>com.increase.api</groupId>
   <artifactId>increase-java</artifactId>
-  <version>0.261.0</version>
+  <version>0.261.1</version>
 </dependency>
 ```
 

diff --git a/build.gradle.kts b/build.gradle.kts
@@ -8,7 +8,7 @@ repositories {
 
 allprojects {
     group = "com.increase.api"
-    version = "0.261.0" // x-release-please-version
+    version = "0.261.1" // x-release-please-version
 }
 
 subprojects {

diff --git a/increase-java-core/src/main/kotlin/com/increase/api/core/handlers/ErrorHandler.kt b/increase-java-core/src/main/kotlin/com/increase/api/core/handlers/ErrorHandler.kt
@@ -19,7 +19,7 @@ import com.increase.api.errors.UnexpectedStatusCodeException
 import com.increase.api.errors.UnprocessableEntityException
 
 @JvmSynthetic
-internal fun errorHandler(jsonMapper: JsonMapper): Handler<JsonValue> {
+internal fun errorBodyHandler(jsonMapper: JsonMapper): Handler<JsonValue> {
     val handler = jsonHandler<JsonValue>(jsonMapper)
 
     return object : Handler<JsonValue> {
@@ -33,52 +33,52 @@ internal fun errorHandler(jsonMapper: JsonMapper): Handler<JsonValue> {
 }
 
 @JvmSynthetic
-internal fun <T> Handler<T>.withErrorHandler(errorHandler: Handler<JsonValue>): Handler<T> =
-    object : Handler<T> {
-        override fun handle(response: HttpResponse): T =
+internal fun errorHandler(errorBodyHandler: Handler<JsonValue>): Handler<HttpResponse> =
+    object : Handler<HttpResponse> {
+        override fun handle(response: HttpResponse): HttpResponse =
             when (val statusCode = response.statusCode()) {
-                in 200..299 -> this@withErrorHandler.handle(response)
+                in 200..299 -> response
                 400 ->
                     throw BadRequestException.builder()
                         .headers(response.headers())
-                        .body(errorHandler.handle(response))
+                        .body(errorBodyHandler.handle(response))
                         .build()
                 401 ->
                     throw UnauthorizedException.builder()
                         .headers(response.headers())
-                        .body(errorHandler.handle(response))
+                        .body(errorBodyHandler.handle(response))
                         .build()
                 403 ->
                     throw PermissionDeniedException.builder()
                         .headers(response.headers())
-                        .body(errorHandler.handle(response))
+                        .body(errorBodyHandler.handle(response))
                         .build()
                 404 ->
                     throw NotFoundException.builder()
                         .headers(response.headers())
-                        .body(errorHandler.handle(response))
+                        .body(errorBodyHandler.handle(response))
                         .build()
                 422 ->
                     throw UnprocessableEntityException.builder()
                         .headers(response.headers())
-                        .body(errorHandler.handle(response))
+                        .body(errorBodyHandler.handle(response))
                         .build()
                 429 ->
                     throw RateLimitException.builder()
                         .headers(response.headers())
-                        .body(errorHandler.handle(response))
+                        .body(errorBodyHandler.handle(response))
                         .build()
                 in 500..599 ->
                     throw InternalServerException.builder()
                         .statusCode(statusCode)
                         .headers(response.headers())
-                        .body(errorHandler.handle(response))
+                        .body(errorBodyHandler.handle(response))
                         .build()
                 else ->
                     throw UnexpectedStatusCodeException.builder()
                         .statusCode(statusCode)
                         .headers(response.headers())
-                        .body(errorHandler.handle(response))
+                        .body(errorBodyHandler.handle(response))
                         .build()
             }
     }
diff --git a/...ava-core/src/main/kotlin/com/increase/api/services/async/AccountNumberServiceAsyncImpl.kt b/...ava-core/src/main/kotlin/com/increase/api/services/async/AccountNumberServiceAsyncImpl.kt
@@ -3,14 +3,14 @@
 package com.increase.api.services.async
 
 import com.increase.api.core.ClientOptions
-import com.increase.api.core.JsonValue
 import com.increase.api.core.RequestOptions
 import com.increase.api.core.checkRequired
+import com.increase.api.core.handlers.errorBodyHandler
 import com.increase.api.core.handlers.errorHandler
 import com.increase.api.core.handlers.jsonHandler
-import com.increase.api.core.handlers.withErrorHandler
 import com.increase.api.core.http.HttpMethod
 import com.increase.api.core.http.HttpRequest
+import com.increase.api.core.http.HttpResponse
 import com.increase.api.core.http.HttpResponse.Handler
 import com.increase.api.core.http.HttpResponseFor
 import com.increase.api.core.http.json
@@ -70,7 +70,8 @@ class AccountNumberServiceAsyncImpl internal constructor(private val clientOptio
     class WithRawResponseImpl internal constructor(private val clientOptions: ClientOptions) :
         AccountNumberServiceAsync.WithRawResponse {
 
-        private val errorHandler: Handler<JsonValue> = errorHandler(clientOptions.jsonMapper)
+        private val errorHandler: Handler<HttpResponse> =
+            errorHandler(errorBodyHandler(clientOptions.jsonMapper))
 
         override fun withOptions(
             modifier: Consumer<ClientOptions.Builder>
@@ -80,7 +81,7 @@ class AccountNumberServiceAsyncImpl internal constructor(private val clientOptio
             )
 
         private val createHandler: Handler<AccountNumber> =
-            jsonHandler<AccountNumber>(clientOptions.jsonMapper).withErrorHandler(errorHandler)
+            jsonHandler<AccountNumber>(clientOptions.jsonMapper)
 
         override fun create(
             params: AccountNumberCreateParams,
@@ -98,7 +99,7 @@ class AccountNumberServiceAsyncImpl internal constructor(private val clientOptio
             return request
                 .thenComposeAsync { clientOptions.httpClient.executeAsync(it, requestOptions) }
                 .thenApply { response ->
-                    response.parseable {
+                    errorHandler.handle(response).parseable {
                         response
                             .use { createHandler.handle(it) }
                             .also {
@@ -111,7 +112,7 @@ class AccountNumberServiceAsyncImpl internal constructor(private val clientOptio
         }
 
         private val retrieveHandler: Handler<AccountNumber> =
-            jsonHandler<AccountNumber>(clientOptions.jsonMapper).withErrorHandler(errorHandler)
+            jsonHandler<AccountNumber>(clientOptions.jsonMapper)
 
         override fun retrieve(
             params: AccountNumberRetrieveParams,
@@ -131,7 +132,7 @@ class AccountNumberServiceAsyncImpl internal constructor(private val clientOptio
             return request
                 .thenComposeAsync { clientOptions.httpClient.executeAsync(it, requestOptions) }
                 .thenApply { response ->
-                    response.parseable {
+                    errorHandler.handle(response).parseable {
                         response
                             .use { retrieveHandler.handle(it) }
                             .also {
@@ -144,7 +145,7 @@ class AccountNumberServiceAsyncImpl internal constructor(private val clientOptio
         }
 
         private val updateHandler: Handler<AccountNumber> =
-            jsonHandler<AccountNumber>(clientOptions.jsonMapper).withErrorHandler(errorHandler)
+            jsonHandler<AccountNumber>(clientOptions.jsonMapper)
 
         override fun update(
             params: AccountNumberUpdateParams,
@@ -165,7 +166,7 @@ class AccountNumberServiceAsyncImpl internal constructor(private val clientOptio
             return request
                 .thenComposeAsync { clientOptions.httpClient.executeAsync(it, requestOptions) }
                 .thenApply { response ->
-                    response.parseable {
+                    errorHandler.handle(response).parseable {
                         response
                             .use { updateHandler.handle(it) }
                             .also {
@@ -179,7 +180,6 @@ class AccountNumberServiceAsyncImpl internal constructor(private val clientOptio
 
         private val listHandler: Handler<AccountNumberListPageResponse> =
             jsonHandler<AccountNumberListPageResponse>(clientOptions.jsonMapper)
-                .withErrorHandler(errorHandler)
 
         override fun list(
             params: AccountNumberListParams,
@@ -196,7 +196,7 @@ class AccountNumberServiceAsyncImpl internal constructor(private val clientOptio
             return request
                 .thenComposeAsync { clientOptions.httpClient.executeAsync(it, requestOptions) }
                 .thenApply { response ->
-                    response.parseable {
+                    errorHandler.handle(response).parseable {
                         response
                             .use { listHandler.handle(it) }
                             .also {

diff --git a/...ease-java-core/src/main/kotlin/com/increase/api/services/async/AccountServiceAsyncImpl.kt b/...ease-java-core/src/main/kotlin/com/increase/api/services/async/AccountServiceAsyncImpl.kt
@@ -3,14 +3,14 @@
 package com.increase.api.services.async
 
 import com.increase.api.core.ClientOptions
-import com.increase.api.core.JsonValue
 import com.increase.api.core.RequestOptions
 import com.increase.api.core.checkRequired
+import com.increase.api.core.handlers.errorBodyHandler
 import com.increase.api.core.handlers.errorHandler
 import com.increase.api.core.handlers.jsonHandler
-import com.increase.api.core.handlers.withErrorHandler
 import com.increase.api.core.http.HttpMethod
 import com.increase.api.core.http.HttpRequest
+import com.increase.api.core.http.HttpResponse
 import com.increase.api.core.http.HttpResponse.Handler
 import com.increase.api.core.http.HttpResponseFor
 import com.increase.api.core.http.json
@@ -87,7 +87,8 @@ class AccountServiceAsyncImpl internal constructor(private val clientOptions: Cl
     class WithRawResponseImpl internal constructor(private val clientOptions: ClientOptions) :
         AccountServiceAsync.WithRawResponse {
 
-        private val errorHandler: Handler<JsonValue> = errorHandler(clientOptions.jsonMapper)
+        private val errorHandler: Handler<HttpResponse> =
+            errorHandler(errorBodyHandler(clientOptions.jsonMapper))
 
         override fun withOptions(
             modifier: Consumer<ClientOptions.Builder>
@@ -96,8 +97,7 @@ class AccountServiceAsyncImpl internal constructor(private val clientOptions: Cl
                 clientOptions.toBuilder().apply(modifier::accept).build()
             )
 
-        private val createHandler: Handler<Account> =
-            jsonHandler<Account>(clientOptions.jsonMapper).withErrorHandler(errorHandler)
+        private val createHandler: Handler<Account> = jsonHandler<Account>(clientOptions.jsonMapper)
 
         override fun create(
             params: AccountCreateParams,
@@ -115,7 +115,7 @@ class AccountServiceAsyncImpl internal constructor(private val clientOptions: Cl
             return request
                 .thenComposeAsync { clientOptions.httpClient.executeAsync(it, requestOptions) }
                 .thenApply { response ->
-                    response.parseable {
+                    errorHandler.handle(response).parseable {
                         response
                             .use { createHandler.handle(it) }
                             .also {
@@ -128,7 +128,7 @@ class AccountServiceAsyncImpl internal constructor(private val clientOptions: Cl
         }
 
         private val retrieveHandler: Handler<Account> =
-            jsonHandler<Account>(clientOptions.jsonMapper).withErrorHandler(errorHandler)
+            jsonHandler<Account>(clientOptions.jsonMapper)
 
         override fun retrieve(
             params: AccountRetrieveParams,
@@ -148,7 +148,7 @@ class AccountServiceAsyncImpl internal constructor(private val clientOptions: Cl
             return request
                 .thenComposeAsync { clientOptions.httpClient.executeAsync(it, requestOptions) }
                 .thenApply { response ->
-                    response.parseable {
+                    errorHandler.handle(response).parseable {
                         response
                             .use { retrieveHandler.handle(it) }
                             .also {
@@ -160,8 +160,7 @@ class AccountServiceAsyncImpl internal constructor(private val clientOptions: Cl
                 }
         }
 
-        private val updateHandler: Handler<Account> =
-            jsonHandler<Account>(clientOptions.jsonMapper).withErrorHandler(errorHandler)
+        private val updateHandler: Handler<Account> = jsonHandler<Account>(clientOptions.jsonMapper)
 
         override fun update(
             params: AccountUpdateParams,
@@ -182,7 +181,7 @@ class AccountServiceAsyncImpl internal constructor(private val clientOptions: Cl
             return request
                 .thenComposeAsync { clientOptions.httpClient.executeAsync(it, requestOptions) }
                 .thenApply { response ->
-                    response.parseable {
+                    errorHandler.handle(response).parseable {
                         response
                             .use { updateHandler.handle(it) }
                             .also {
@@ -196,7 +195,6 @@ class AccountServiceAsyncImpl internal constructor(private val clientOptions: Cl
 
         private val listHandler: Handler<AccountListPageResponse> =
             jsonHandler<AccountListPageResponse>(clientOptions.jsonMapper)
-                .withErrorHandler(errorHandler)
 
         override fun list(
             params: AccountListParams,
@@ -213,7 +211,7 @@ class AccountServiceAsyncImpl internal constructor(private val clientOptions: Cl
             return request
                 .thenComposeAsync { clientOptions.httpClient.executeAsync(it, requestOptions) }
                 .thenApply { response ->
-                    response.parseable {
+                    errorHandler.handle(response).parseable {
                         response
                             .use { listHandler.handle(it) }
                             .also {
@@ -234,7 +232,7 @@ class AccountServiceAsyncImpl internal constructor(private val clientOptions: Cl
         }
 
         private val balanceHandler: Handler<BalanceLookup> =
-            jsonHandler<BalanceLookup>(clientOptions.jsonMapper).withErrorHandler(errorHandler)
+            jsonHandler<BalanceLookup>(clientOptions.jsonMapper)
 
         override fun balance(
             params: AccountBalanceParams,
@@ -254,7 +252,7 @@ class AccountServiceAsyncImpl internal constructor(private val clientOptions: Cl
             return request
                 .thenComposeAsync { clientOptions.httpClient.executeAsync(it, requestOptions) }
                 .thenApply { response ->
-                    response.parseable {
+                    errorHandler.handle(response).parseable {
                         response
                             .use { balanceHandler.handle(it) }
                             .also {
@@ -266,8 +264,7 @@ class AccountServiceAsyncImpl internal constructor(private val clientOptions: Cl
                 }
         }
 
-        private val closeHandler: Handler<Account> =
-            jsonHandler<Account>(clientOptions.jsonMapper).withErrorHandler(errorHandler)
+        private val closeHandler: Handler<Account> = jsonHandler<Account>(clientOptions.jsonMapper)
 
         override fun close(
             params: AccountCloseParams,
@@ -288,7 +285,7 @@ class AccountServiceAsyncImpl internal constructor(private val clientOptions: Cl
             return request
                 .thenComposeAsync { clientOptions.httpClient.executeAsync(it, requestOptions) }
                 .thenApply { response ->
-                    response.parseable {
+                    errorHandler.handle(response).parseable {
                         response
                             .use { closeHandler.handle(it) }
                             .also {