release: 0.169.0

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.168.0"
+  ".": "0.169.0"
 }

.stats.yml

@@ -1,2 +1,2 @@
 configured_endpoints: 201
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/increase%2Fincrease-fb44f7a35402f0dc2a091841c1ee5c0d0b1c0dc21bbd49f9fe7a07cfaca8dfca.yml
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/increase%2Fincrease-acd347798fc268a8063bde83e83ff69541a1feb789e40bc54b3798937a7492ca.yml

CHANGELOG.md

@@ -1,5 +1,24 @@
 # Changelog
 
+## 0.169.0 (2025-01-30)
+
+Full Changelog: [v0.168.0...v0.169.0](https://github.com/Increase/increase-java/compare/v0.168.0...v0.169.0)
+
+### Features
+
+* **api:** api update ([#732](https://github.com/Increase/increase-java/issues/732)) ([d9c7602](https://github.com/Increase/increase-java/commit/d9c76020a8a59249207221042fb374c8d4f735b2))
+* **client:** add `_queryParams` and `_headers` methods ([#729](https://github.com/Increase/increase-java/issues/729)) ([c3c0560](https://github.com/Increase/increase-java/commit/c3c0560787d0765fd87e3d3829d9e2082d79a684))
+
+
+### Chores
+
+* **internal:** improve `RetryingHttpClientTest` ([#731](https://github.com/Increase/increase-java/issues/731)) ([fc8dcc1](https://github.com/Increase/increase-java/commit/fc8dcc15257cbe0b945fc69f8ae0a16997bd7edb))
+
+
+### Refactors
+
+* **internal:** extract request preparation logic ([c3c0560](https://github.com/Increase/increase-java/commit/c3c0560787d0765fd87e3d3829d9e2082d79a684))
+
 ## 0.168.0 (2025-01-30)
 
 Full Changelog: [v0.167.0...v0.168.0](https://github.com/Increase/increase-java/compare/v0.167.0...v0.168.0)

README.md

@@ -2,7 +2,7 @@
 
 <!-- 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.168.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.169.0)
 
 <!-- x-release-please-end -->
 
@@ -19,7 +19,7 @@ The REST API documentation can be found on [increase.com](https://increase.com/d
 ### Gradle
 
 ```kotlin
-implementation("com.increase.api:increase-java:0.168.0")
+implementation("com.increase.api:increase-java:0.169.0")
 ```
 
 ### Maven
@@ -28,7 +28,7 @@ implementation("com.increase.api:increase-java:0.168.0")
 <dependency>
     <groupId>com.increase.api</groupId>
     <artifactId>increase-java</artifactId>
-    <version>0.168.0</version>
+    <version>0.169.0</version>
 </dependency>
 ```
 

build.gradle.kts

@@ -1,4 +1,4 @@
 allprojects {
     group = "com.increase.api"
-    version = "0.168.0" // x-release-please-version
+    version = "0.169.0" // x-release-please-version
 }

increase-java-core/src/main/kotlin/com/increase/api/core/Params.kt

@@ -0,0 +1,16 @@
+package com.increase.api.core
+
+import com.increase.api.core.http.Headers
+import com.increase.api.core.http.QueryParams
+
+/** An interface representing parameters passed to a service method. */
+interface Params {
+    /** The full set of headers in the parameters, including both fixed and additional headers. */
+    fun _headers(): Headers
+
+    /**
+     * The full set of query params in the parameters, including both fixed and additional query
+     * params.
+     */
+    fun _queryParams(): QueryParams
+}

increase-java-core/src/main/kotlin/com/increase/api/core/PrepareRequest.kt

@@ -0,0 +1,24 @@
+@file:JvmName("PrepareRequest")
+
+package com.increase.api.core
+
+import com.increase.api.core.http.HttpRequest
+import java.util.concurrent.CompletableFuture
+
+@JvmSynthetic
+internal fun HttpRequest.prepare(clientOptions: ClientOptions, params: Params): HttpRequest =
+    toBuilder()
+        .putAllQueryParams(clientOptions.queryParams)
+        .replaceAllQueryParams(params._queryParams())
+        .putAllHeaders(clientOptions.headers)
+        .replaceAllHeaders(params._headers())
+        .build()
+
+@JvmSynthetic
+internal fun HttpRequest.prepareAsync(
+    clientOptions: ClientOptions,
+    params: Params
+): CompletableFuture<HttpRequest> =
+    // This async version exists to make it easier to add async specific preparation logic in the
+    // future.
+    CompletableFuture.completedFuture(prepare(clientOptions, params))

increase-java-core/src/main/kotlin/com/increase/api/models/AccountBalanceParams.kt

@@ -3,6 +3,7 @@
 package com.increase.api.models
 
 import com.increase.api.core.NoAutoDetect
+import com.increase.api.core.Params
 import com.increase.api.core.checkRequired
 import com.increase.api.core.http.Headers
 import com.increase.api.core.http.QueryParams
@@ -18,7 +19,7 @@ private constructor(
     private val atTime: OffsetDateTime?,
     private val additionalHeaders: Headers,
     private val additionalQueryParams: QueryParams,
-) {
+) : Params {
 
     /** The identifier of the Account to retrieve. */
     fun accountId(): String = accountId
@@ -30,10 +31,9 @@ private constructor(
 
     fun _additionalQueryParams(): QueryParams = additionalQueryParams
 
-    @JvmSynthetic internal fun getHeaders(): Headers = additionalHeaders
+    override fun _headers(): Headers = additionalHeaders
 
-    @JvmSynthetic
-    internal fun getQueryParams(): QueryParams {
+    override fun _queryParams(): QueryParams {
         val queryParams = QueryParams.builder()
         this.atTime?.let {
             queryParams.put("at_time", listOf(DateTimeFormatter.ISO_OFFSET_DATE_TIME.format(it)))

increase-java-core/src/main/kotlin/com/increase/api/models/AccountCloseParams.kt

@@ -4,6 +4,7 @@ package com.increase.api.models
 
 import com.increase.api.core.JsonValue
 import com.increase.api.core.NoAutoDetect
+import com.increase.api.core.Params
 import com.increase.api.core.checkRequired
 import com.increase.api.core.http.Headers
 import com.increase.api.core.http.QueryParams
@@ -18,7 +19,7 @@ private constructor(
     private val additionalHeaders: Headers,
     private val additionalQueryParams: QueryParams,
     private val additionalBodyProperties: Map<String, JsonValue>,
-) {
+) : Params {
 
     /** The identifier of the Account to close. The account must have a zero balance. */
     fun accountId(): String = accountId
@@ -30,12 +31,12 @@ private constructor(
     fun _additionalBodyProperties(): Map<String, JsonValue> = additionalBodyProperties
 
     @JvmSynthetic
-    internal fun getBody(): Optional<Map<String, JsonValue>> =
+    internal fun _body(): Optional<Map<String, JsonValue>> =
         Optional.ofNullable(additionalBodyProperties.ifEmpty { null })
 
-    @JvmSynthetic internal fun getHeaders(): Headers = additionalHeaders
+    override fun _headers(): Headers = additionalHeaders
 
-    @JvmSynthetic internal fun getQueryParams(): QueryParams = additionalQueryParams
+    override fun _queryParams(): QueryParams = additionalQueryParams
 
     fun getPathParam(index: Int): String {
         return when (index) {

increase-java-core/src/main/kotlin/com/increase/api/models/AccountCreateParams.kt

@@ -11,6 +11,7 @@ import com.increase.api.core.JsonField
 import com.increase.api.core.JsonMissing
 import com.increase.api.core.JsonValue
 import com.increase.api.core.NoAutoDetect
+import com.increase.api.core.Params
 import com.increase.api.core.checkRequired
 import com.increase.api.core.http.Headers
 import com.increase.api.core.http.QueryParams
@@ -25,7 +26,7 @@ private constructor(
     private val body: AccountCreateBody,
     private val additionalHeaders: Headers,
     private val additionalQueryParams: QueryParams,
-) {
+) : Params {
 
     /** The name you choose for the Account. */
     fun name(): String = body.name()
@@ -69,11 +70,11 @@ private constructor(
 
     fun _additionalQueryParams(): QueryParams = additionalQueryParams
 
-    @JvmSynthetic internal fun getBody(): AccountCreateBody = body
+    @JvmSynthetic internal fun _body(): AccountCreateBody = body
 
-    @JvmSynthetic internal fun getHeaders(): Headers = additionalHeaders
+    override fun _headers(): Headers = additionalHeaders
 
-    @JvmSynthetic internal fun getQueryParams(): QueryParams = additionalQueryParams
+    override fun _queryParams(): QueryParams = additionalQueryParams
 
     @NoAutoDetect
     class AccountCreateBody

increase-java-core/src/main/kotlin/com/increase/api/models/AccountListParams.kt

@@ -6,6 +6,7 @@ import com.fasterxml.jackson.annotation.JsonCreator
 import com.increase.api.core.Enum
 import com.increase.api.core.JsonField
 import com.increase.api.core.NoAutoDetect
+import com.increase.api.core.Params
 import com.increase.api.core.http.Headers
 import com.increase.api.core.http.QueryParams
 import com.increase.api.errors.IncreaseInvalidDataException
@@ -27,7 +28,7 @@ private constructor(
     private val status: Status?,
     private val additionalHeaders: Headers,
     private val additionalQueryParams: QueryParams,
-) {
+) : Params {
 
     fun createdAt(): Optional<CreatedAt> = Optional.ofNullable(createdAt)
 
@@ -60,10 +61,9 @@ private constructor(
 
     fun _additionalQueryParams(): QueryParams = additionalQueryParams
 
-    @JvmSynthetic internal fun getHeaders(): Headers = additionalHeaders
+    override fun _headers(): Headers = additionalHeaders
 
-    @JvmSynthetic
-    internal fun getQueryParams(): QueryParams {
+    override fun _queryParams(): QueryParams {
         val queryParams = QueryParams.builder()
         this.createdAt?.forEachQueryParam { key, values ->
             queryParams.put("created_at.$key", values)

increase-java-core/src/main/kotlin/com/increase/api/models/AccountNumberCreateParams.kt

@@ -12,6 +12,7 @@ import com.increase.api.core.JsonField
 import com.increase.api.core.JsonMissing
 import com.increase.api.core.JsonValue
 import com.increase.api.core.NoAutoDetect
+import com.increase.api.core.Params
 import com.increase.api.core.checkRequired
 import com.increase.api.core.http.Headers
 import com.increase.api.core.http.QueryParams
@@ -27,7 +28,7 @@ private constructor(
     private val body: AccountNumberCreateBody,
     private val additionalHeaders: Headers,
     private val additionalQueryParams: QueryParams,
-) {
+) : Params {
 
     /** The Account the Account Number should belong to. */
     fun accountId(): String = body.accountId()
@@ -59,11 +60,11 @@ private constructor(
 
     fun _additionalQueryParams(): QueryParams = additionalQueryParams
 
-    @JvmSynthetic internal fun getBody(): AccountNumberCreateBody = body
+    @JvmSynthetic internal fun _body(): AccountNumberCreateBody = body
 
-    @JvmSynthetic internal fun getHeaders(): Headers = additionalHeaders
+    override fun _headers(): Headers = additionalHeaders
 
-    @JvmSynthetic internal fun getQueryParams(): QueryParams = additionalQueryParams
+    override fun _queryParams(): QueryParams = additionalQueryParams
 
     @NoAutoDetect
     class AccountNumberCreateBody

increase-java-core/src/main/kotlin/com/increase/api/models/AccountNumberListParams.kt

@@ -6,6 +6,7 @@ import com.fasterxml.jackson.annotation.JsonCreator
 import com.increase.api.core.Enum
 import com.increase.api.core.JsonField
 import com.increase.api.core.NoAutoDetect
+import com.increase.api.core.Params
 import com.increase.api.core.http.Headers
 import com.increase.api.core.http.QueryParams
 import com.increase.api.errors.IncreaseInvalidDataException
@@ -26,7 +27,7 @@ private constructor(
     private val status: Status?,
     private val additionalHeaders: Headers,
     private val additionalQueryParams: QueryParams,
-) {
+) : Params {
 
     /** Filter Account Numbers to those belonging to the specified Account. */
     fun accountId(): Optional<String> = Optional.ofNullable(accountId)
@@ -56,10 +57,9 @@ private constructor(
 
     fun _additionalQueryParams(): QueryParams = additionalQueryParams
 
-    @JvmSynthetic internal fun getHeaders(): Headers = additionalHeaders
+    override fun _headers(): Headers = additionalHeaders
 
-    @JvmSynthetic
-    internal fun getQueryParams(): QueryParams {
+    override fun _queryParams(): QueryParams {
         val queryParams = QueryParams.builder()
         this.accountId?.let { queryParams.put("account_id", listOf(it.toString())) }
         this.achDebitStatus?.let { queryParams.put("ach_debit_status", listOf(it.toString())) }

increase-java-core/src/main/kotlin/com/increase/api/models/AccountNumberRetrieveParams.kt

@@ -3,6 +3,7 @@
 package com.increase.api.models
 
 import com.increase.api.core.NoAutoDetect
+import com.increase.api.core.Params
 import com.increase.api.core.checkRequired
 import com.increase.api.core.http.Headers
 import com.increase.api.core.http.QueryParams
@@ -14,7 +15,7 @@ private constructor(
     private val accountNumberId: String,
     private val additionalHeaders: Headers,
     private val additionalQueryParams: QueryParams,
-) {
+) : Params {
 
     /** The identifier of the Account Number to retrieve. */
     fun accountNumberId(): String = accountNumberId
@@ -23,9 +24,9 @@ private constructor(
 
     fun _additionalQueryParams(): QueryParams = additionalQueryParams
 
-    @JvmSynthetic internal fun getHeaders(): Headers = additionalHeaders
+    override fun _headers(): Headers = additionalHeaders
 
-    @JvmSynthetic internal fun getQueryParams(): QueryParams = additionalQueryParams
+    override fun _queryParams(): QueryParams = additionalQueryParams
 
     fun getPathParam(index: Int): String {
         return when (index) {

increase-java-core/src/main/kotlin/com/increase/api/models/AccountNumberUpdateParams.kt

@@ -12,6 +12,7 @@ import com.increase.api.core.JsonField
 import com.increase.api.core.JsonMissing
 import com.increase.api.core.JsonValue
 import com.increase.api.core.NoAutoDetect
+import com.increase.api.core.Params
 import com.increase.api.core.checkRequired
 import com.increase.api.core.http.Headers
 import com.increase.api.core.http.QueryParams
@@ -28,7 +29,7 @@ private constructor(
     private val body: AccountNumberUpdateBody,
     private val additionalHeaders: Headers,
     private val additionalQueryParams: QueryParams,
-) {
+) : Params {
 
     /** The identifier of the Account Number. */
     fun accountNumberId(): String = accountNumberId
@@ -63,11 +64,11 @@ private constructor(
 
     fun _additionalQueryParams(): QueryParams = additionalQueryParams
 
-    @JvmSynthetic internal fun getBody(): AccountNumberUpdateBody = body
+    @JvmSynthetic internal fun _body(): AccountNumberUpdateBody = body
 
-    @JvmSynthetic internal fun getHeaders(): Headers = additionalHeaders
+    override fun _headers(): Headers = additionalHeaders
 
-    @JvmSynthetic internal fun getQueryParams(): QueryParams = additionalQueryParams
+    override fun _queryParams(): QueryParams = additionalQueryParams
 
     fun getPathParam(index: Int): String {
         return when (index) {

increase-java-core/src/main/kotlin/com/increase/api/models/AccountRetrieveParams.kt

@@ -3,6 +3,7 @@
 package com.increase.api.models
 
 import com.increase.api.core.NoAutoDetect
+import com.increase.api.core.Params
 import com.increase.api.core.checkRequired
 import com.increase.api.core.http.Headers
 import com.increase.api.core.http.QueryParams
@@ -14,7 +15,7 @@ private constructor(
     private val accountId: String,
     private val additionalHeaders: Headers,
     private val additionalQueryParams: QueryParams,
-) {
+) : Params {
 
     /** The identifier of the Account to retrieve. */
     fun accountId(): String = accountId
@@ -23,9 +24,9 @@ private constructor(
 
     fun _additionalQueryParams(): QueryParams = additionalQueryParams
 
-    @JvmSynthetic internal fun getHeaders(): Headers = additionalHeaders
+    override fun _headers(): Headers = additionalHeaders
 
-    @JvmSynthetic internal fun getQueryParams(): QueryParams = additionalQueryParams
+    override fun _queryParams(): QueryParams = additionalQueryParams
 
     fun getPathParam(index: Int): String {
         return when (index) {