release: 0.162.0

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.161.0"
+  ".": "0.162.0"
 }

.stats.yml

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

CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## 0.162.0 (2025-01-14)
+
+Full Changelog: [v0.161.0...v0.162.0](https://github.com/Increase/increase-java/compare/v0.161.0...v0.162.0)
+
+### Features
+
+* **api:** api update ([#694](https://github.com/Increase/increase-java/issues/694)) ([a4a521b](https://github.com/Increase/increase-java/commit/a4a521bf4d2937f97472ab6765df88ea8a04a452))
+
+
+### Chores
+
+* **internal:** add and tweak check functions ([#692](https://github.com/Increase/increase-java/issues/692)) ([abbf2d2](https://github.com/Increase/increase-java/commit/abbf2d2cb7f925b2eb15f0f2e6c57f878cf80e00))
+* **internal:** tweak client options nullability handling ([abbf2d2](https://github.com/Increase/increase-java/commit/abbf2d2cb7f925b2eb15f0f2e6c57f878cf80e00))
+
 ## 0.161.0 (2025-01-14)
 
 Full Changelog: [v0.160.0...v0.161.0](https://github.com/Increase/increase-java/compare/v0.160.0...v0.161.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.161.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.162.0)
 
 <!-- x-release-please-end -->
 
@@ -25,7 +25,7 @@ The REST API documentation can be found on [increase.com](https://increase.com/
 <!-- x-release-please-start-version -->
 
 ```kotlin
-implementation("com.increase.api:increase-java:0.161.0")
+implementation("com.increase.api:increase-java:0.162.0")
 ```
 
 #### Maven
@@ -34,7 +34,7 @@ implementation("com.increase.api:increase-java:0.161.0")
 <dependency>
     <groupId>com.increase.api</groupId>
     <artifactId>increase-java</artifactId>
-    <version>0.161.0</version>
+    <version>0.162.0</version>
 </dependency>
 ```
 

build.gradle.kts

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

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

@@ -4,4 +4,27 @@ package com.increase.api.core
 
 @JvmSynthetic
 internal fun <T : Any> checkRequired(name: String, value: T?): T =
-    checkNotNull(value) { "`$name` is required but was not set" }
+    checkNotNull(value) { "`$name` is required, but was not set" }
+
+@JvmSynthetic
+internal fun checkLength(name: String, value: String, length: Int): String =
+    value.also {
+        check(it.length == length) { "`$name` must have length $length, but was ${it.length}" }
+    }
+
+@JvmSynthetic
+internal fun checkMinLength(name: String, value: String, minLength: Int): String =
+    value.also {
+        check(it.length >= minLength) {
+            if (minLength == 1) "`$name` must be non-empty, but was empty"
+            else "`$name` must have at least length $minLength, but was ${it.length}"
+        }
+    }
+
+@JvmSynthetic
+internal fun checkMaxLength(name: String, value: String, maxLength: Int): String =
+    value.also {
+        check(it.length <= maxLength) {
+            "`$name` must have at most length $maxLength, but was ${it.length}"
+        }
+    }

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

@@ -173,8 +173,8 @@ private constructor(
         }
 
         fun build(): ClientOptions {
-            checkRequired("httpClient", httpClient)
-            checkRequired("apiKey", apiKey)
+            val httpClient = checkRequired("httpClient", httpClient)
+            val apiKey = checkRequired("apiKey", apiKey)
 
             val headers = Headers.builder()
             val queryParams = QueryParams.builder()
@@ -185,7 +185,7 @@ private constructor(
             headers.put("X-Stainless-Package-Version", getPackageVersion())
             headers.put("X-Stainless-Runtime", "JRE")
             headers.put("X-Stainless-Runtime-Version", getJavaVersion())
-            apiKey?.let {
+            apiKey.let {
                 if (!it.isEmpty()) {
                     headers.put("Authorization", "Bearer $it")
                 }
@@ -194,10 +194,10 @@ private constructor(
             queryParams.replaceAll(this.queryParams.build())
 
             return ClientOptions(
-                httpClient!!,
+                httpClient,
                 PhantomReachableClosingHttpClient(
                     RetryingHttpClient.builder()
-                        .httpClient(httpClient!!)
+                        .httpClient(httpClient)
                         .clock(clock)
                         .maxRetries(maxRetries)
                         .idempotencyHeader("Idempotency-Key")
@@ -210,7 +210,7 @@ private constructor(
                 queryParams.build(),
                 responseValidation,
                 maxRetries,
-                apiKey!!,
+                apiKey,
                 webhookSecret,
             )
         }

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

@@ -117,6 +117,8 @@ sealed class JsonField<out T : Any> {
             is JsonValue -> this
         }
 
+    @JvmSynthetic fun accept(consume: (T) -> Unit) = asKnown().ifPresent(consume)
+
     fun <R> accept(visitor: Visitor<T, R>): R =
         when (this) {
             is KnownValue -> visitor.visitKnown(value)

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

@@ -199,7 +199,12 @@ private constructor(
     /** The status of the transfer. */
     fun status(): Status = status.getRequired("status")
 
-    /** The trace number of the transfer. */
+    /**
+     * A 15 digit number set by the sending bank and transmitted to the receiving bank. Along with
+     * the amount, date, and originating routing number, this can be used to identify the ACH
+     * transfer. ACH trace numbers are not unique, but are
+     * [used to correlate returns](https://increase.com/documentation/ach-returns#ach-returns).
+     */
     fun traceNumber(): String = traceNumber.getRequired("trace_number")
 
     /** If your transfer is returned, this will contain details of the return. */
@@ -326,7 +331,12 @@ private constructor(
     /** The status of the transfer. */
     @JsonProperty("status") @ExcludeMissing fun _status(): JsonField<Status> = status
 
-    /** The trace number of the transfer. */
+    /**
+     * A 15 digit number set by the sending bank and transmitted to the receiving bank. Along with
+     * the amount, date, and originating routing number, this can be used to identify the ACH
+     * transfer. ACH trace numbers are not unique, but are
+     * [used to correlate returns](https://increase.com/documentation/ach-returns#ach-returns).
+     */
     @JsonProperty("trace_number")
     @ExcludeMissing
     fun _traceNumber(): JsonField<String> = traceNumber
@@ -699,10 +709,20 @@ private constructor(
         /** The status of the transfer. */
         fun status(status: JsonField<Status>) = apply { this.status = status }
 
-        /** The trace number of the transfer. */
+        /**
+         * A 15 digit number set by the sending bank and transmitted to the receiving bank. Along
+         * with the amount, date, and originating routing number, this can be used to identify the
+         * ACH transfer. ACH trace numbers are not unique, but are
+         * [used to correlate returns](https://increase.com/documentation/ach-returns#ach-returns).
+         */
         fun traceNumber(traceNumber: String) = traceNumber(JsonField.of(traceNumber))
 
-        /** The trace number of the transfer. */
+        /**
+         * A 15 digit number set by the sending bank and transmitted to the receiving bank. Along
+         * with the amount, date, and originating routing number, this can be used to identify the
+         * ACH transfer. ACH trace numbers are not unique, but are
+         * [used to correlate returns](https://increase.com/documentation/ach-returns#ach-returns).
+         */
         fun traceNumber(traceNumber: JsonField<String>) = apply { this.traceNumber = traceNumber }
 
         /** If your transfer is returned, this will contain details of the return. */