release: 6.0.0

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "5.5.0"
+  ".": "6.0.0"
 }

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 45
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/finch%2Ffinch-05a1c7485ea6dd75ad2fb1a0628570d88a3e7c4f1e1ecad433711c78deae50e6.yml
-openapi_spec_hash: 6d6014d50e18c98219b496bb2a5dab1d
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/finch%2Ffinch-f09e5f2c555d7ee764478b7bc73e92cd21f403d6ec189be14574c8367bc131ce.yml
+openapi_spec_hash: bd0a8e001f14132c105992d40149909a
 config_hash: 53778a0b839c4f6ad34fbba051f5e8a6

CHANGELOG.md

@@ -1,5 +1,41 @@
 # Changelog
 
+## 6.0.0 (2025-05-08)
+
+Full Changelog: [v5.5.0...v6.0.0](https://github.com/Finch-API/finch-api-java/compare/v5.5.0...v6.0.0)
+
+### ⚠ BREAKING CHANGES
+
+* **client:** don't require end-users to specify constants
+* **client:** **Migration:** Builder methods that previously accepted a single possible value no longer need to be called.
+
+### Features
+
+* **api:** api update ([59c1d39](https://github.com/Finch-API/finch-api-java/commit/59c1d397d17589eec93f6c1dab760aaa1d548188))
+* **api:** api update ([2aa8003](https://github.com/Finch-API/finch-api-java/commit/2aa8003c7dfeb9be0a15a57d1c46931a7f85ab3e))
+* **api:** api update ([988e834](https://github.com/Finch-API/finch-api-java/commit/988e8348cd1d2e31f5e2aaa91adfc835ae973ba0))
+* **api:** api update ([b98adb3](https://github.com/Finch-API/finch-api-java/commit/b98adb325de5d5b7220bbeac1f1e5fd56f7a0c13))
+* **api:** api update ([f816b28](https://github.com/Finch-API/finch-api-java/commit/f816b281bd01e85660f613f14431a43eb761a221))
+* **api:** api update ([d399e4f](https://github.com/Finch-API/finch-api-java/commit/d399e4f9395f2e84f6a97399ae6f0fdcbc34d7cd))
+* **api:** api update ([cc2b828](https://github.com/Finch-API/finch-api-java/commit/cc2b8288f7c3ce5bc62e7ca074fd53fc6f05e253))
+* **api:** api update ([a9fefbc](https://github.com/Finch-API/finch-api-java/commit/a9fefbc485cfa35d7c34aa409333a7b2e244f26a))
+* **api:** api update ([9e451d0](https://github.com/Finch-API/finch-api-java/commit/9e451d0ea744078d1c4f10c878a950ca3719237b))
+* **api:** api update ([f45fb21](https://github.com/Finch-API/finch-api-java/commit/f45fb2151509dd96e2630b94ed4b3a1f3f711439))
+* **api:** api update ([43c21f7](https://github.com/Finch-API/finch-api-java/commit/43c21f75d63053a888c4ba99dd63847b145bf360))
+* **api:** api update ([35e522b](https://github.com/Finch-API/finch-api-java/commit/35e522ba3ad911b49f41ad4b62f1ddc3257dbcd2))
+* **api:** api update ([70708d7](https://github.com/Finch-API/finch-api-java/commit/70708d78bc704b34f936e835b614e54c87c2db03))
+* **api:** api update ([f8988d7](https://github.com/Finch-API/finch-api-java/commit/f8988d7fc959241b683da19b068c95a8ac023e24))
+* **api:** api update ([53c3147](https://github.com/Finch-API/finch-api-java/commit/53c31470ca6f0cf5985f8ebd60446f8f08e84913))
+* **api:** api update ([30df955](https://github.com/Finch-API/finch-api-java/commit/30df955523928c30ef0e29f1154ff5fee88d80d1))
+* **api:** api update ([79e067e](https://github.com/Finch-API/finch-api-java/commit/79e067e9790c16095a9a81cea65fb500c6f4aea6))
+* **client:** don't require end-users to specify constants ([055d459](https://github.com/Finch-API/finch-api-java/commit/055d4597de3f260537ccfa65a8f094e9df39bebb))
+
+
+### Chores
+
+* **internal:** remove flaky `-Xbackend-threads=0` option ([4271051](https://github.com/Finch-API/finch-api-java/commit/4271051bb2d5b34d55418363f2e8f958a3688dd5))
+* **internal:** update java toolchain ([0242272](https://github.com/Finch-API/finch-api-java/commit/02422720923c2ec5b5348b0c7e90657433015847))
+
 ## 5.5.0 (2025-04-23)
 
 Full Changelog: [v5.4.0...v5.5.0](https://github.com/Finch-API/finch-api-java/compare/v5.4.0...v5.5.0)

README.md

@@ -2,8 +2,8 @@
 
 <!-- x-release-please-start-version -->
 
-[![Maven Central](https://img.shields.io/maven-central/v/com.tryfinch.api/finch-java)](https://central.sonatype.com/artifact/com.tryfinch.api/finch-java/5.5.0)
-[![javadoc](https://javadoc.io/badge2/com.tryfinch.api/finch-java/5.5.0/javadoc.svg)](https://javadoc.io/doc/com.tryfinch.api/finch-java/5.5.0)
+[![Maven Central](https://img.shields.io/maven-central/v/com.tryfinch.api/finch-java)](https://central.sonatype.com/artifact/com.tryfinch.api/finch-java/6.0.0)
+[![javadoc](https://javadoc.io/badge2/com.tryfinch.api/finch-java/6.0.0/javadoc.svg)](https://javadoc.io/doc/com.tryfinch.api/finch-java/6.0.0)
 
 <!-- x-release-please-end -->
 
@@ -15,7 +15,7 @@ It is generated with [Stainless](https://www.stainless.com/).
 
 <!-- x-release-please-start-version -->
 
-The REST API documentation can be found on [developer.tryfinch.com](https://developer.tryfinch.com/). Javadocs are available on [javadoc.io](https://javadoc.io/doc/com.tryfinch.api/finch-java/5.5.0).
+The REST API documentation can be found on [developer.tryfinch.com](https://developer.tryfinch.com/). Javadocs are available on [javadoc.io](https://javadoc.io/doc/com.tryfinch.api/finch-java/6.0.0).
 
 <!-- x-release-please-end -->
 
@@ -26,7 +26,7 @@ The REST API documentation can be found on [developer.tryfinch.com](https://deve
 ### Gradle
 
 ```kotlin
-implementation("com.tryfinch.api:finch-java:5.5.0")
+implementation("com.tryfinch.api:finch-java:6.0.0")
 ```
 
 ### Maven
@@ -35,7 +35,7 @@ implementation("com.tryfinch.api:finch-java:5.5.0")
 <dependency>
   <groupId>com.tryfinch.api</groupId>
   <artifactId>finch-java</artifactId>
-  <version>5.5.0</version>
+  <version>6.0.0</version>
 </dependency>
 ```
 

build.gradle.kts

@@ -8,7 +8,7 @@ repositories {
 
 allprojects {
     group = "com.tryfinch.api"
-    version = "5.5.0" // x-release-please-version
+    version = "6.0.0" // x-release-please-version
 }
 
 subprojects {

buildSrc/src/main/kotlin/finch.java.gradle.kts

@@ -21,7 +21,7 @@ configure<SpotlessExtension> {
 
 java {
     toolchain {
-        languageVersion.set(JavaLanguageVersion.of(17))
+        languageVersion.set(JavaLanguageVersion.of(21))
     }
 
     sourceCompatibility = JavaVersion.VERSION_1_8

buildSrc/src/main/kotlin/finch.kotlin.gradle.kts

@@ -19,8 +19,6 @@ kotlin {
             // Suppress deprecation warnings because we may still reference and test deprecated members.
             // TODO: Replace with `-Xsuppress-warning=DEPRECATION` once we use Kotlin compiler 2.1.0+.
             "-nowarn",
-            // Use as many threads as there are CPU cores on the machine for compilation.
-            "-Xbackend-threads=0",
         )
         jvmTarget.set(JvmTarget.JVM_1_8)
         languageVersion.set(KotlinVersion.KOTLIN_1_8)

finch-java-core/src/main/kotlin/com/tryfinch/api/models/Company.kt

@@ -692,18 +692,29 @@ private constructor(
 
         companion object {
 
-            /** Returns a mutable builder for constructing an instance of [Account]. */
+            /**
+             * Returns a mutable builder for constructing an instance of [Account].
+             *
+             * The following fields are required:
+             * ```java
+             * .accountName()
+             * .accountNumber()
+             * .accountType()
+             * .institutionName()
+             * .routingNumber()
+             * ```
+             */
             @JvmStatic fun builder() = Builder()
         }
 
         /** A builder for [Account]. */
         class Builder internal constructor() {
 
-            private var accountName: JsonField<String> = JsonMissing.of()
-            private var accountNumber: JsonField<String> = JsonMissing.of()
-            private var accountType: JsonField<AccountType> = JsonMissing.of()
-            private var institutionName: JsonField<String> = JsonMissing.of()
-            private var routingNumber: JsonField<String> = JsonMissing.of()
+            private var accountName: JsonField<String>? = null
+            private var accountNumber: JsonField<String>? = null
+            private var accountType: JsonField<AccountType>? = null
+            private var institutionName: JsonField<String>? = null
+            private var routingNumber: JsonField<String>? = null
             private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
 
             @JvmSynthetic
@@ -835,14 +846,25 @@ private constructor(
              * Returns an immutable instance of [Account].
              *
              * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .accountName()
+             * .accountNumber()
+             * .accountType()
+             * .institutionName()
+             * .routingNumber()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
              */
             fun build(): Account =
                 Account(
-                    accountName,
-                    accountNumber,
-                    accountType,
-                    institutionName,
-                    routingNumber,
+                    checkRequired("accountName", accountName),
+                    checkRequired("accountNumber", accountNumber),
+                    checkRequired("accountType", accountType),
+                    checkRequired("institutionName", institutionName),
+                    checkRequired("routingNumber", routingNumber),
                     additionalProperties.toMutableMap(),
                 )
         }
@@ -1091,15 +1113,23 @@ private constructor(
 
         companion object {
 
-            /** Returns a mutable builder for constructing an instance of [Department]. */
+            /**
+             * Returns a mutable builder for constructing an instance of [Department].
+             *
+             * The following fields are required:
+             * ```java
+             * .name()
+             * .parent()
+             * ```
+             */
             @JvmStatic fun builder() = Builder()
         }
 
         /** A builder for [Department]. */
         class Builder internal constructor() {
 
-            private var name: JsonField<String> = JsonMissing.of()
-            private var parent: JsonField<Parent> = JsonMissing.of()
+            private var name: JsonField<String>? = null
+            private var parent: JsonField<Parent>? = null
             private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
 
             @JvmSynthetic
@@ -1162,8 +1192,21 @@ private constructor(
              * Returns an immutable instance of [Department].
              *
              * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .name()
+             * .parent()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
              */
-            fun build(): Department = Department(name, parent, additionalProperties.toMutableMap())
+            fun build(): Department =
+                Department(
+                    checkRequired("name", name),
+                    checkRequired("parent", parent),
+                    additionalProperties.toMutableMap(),
+                )
         }
 
         private var validated: Boolean = false
@@ -1238,14 +1281,21 @@ private constructor(
 
             companion object {
 
-                /** Returns a mutable builder for constructing an instance of [Parent]. */
+                /**
+                 * Returns a mutable builder for constructing an instance of [Parent].
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .name()
+                 * ```
+                 */
                 @JvmStatic fun builder() = Builder()
             }
 
             /** A builder for [Parent]. */
             class Builder internal constructor() {
 
-                private var name: JsonField<String> = JsonMissing.of()
+                private var name: JsonField<String>? = null
                 private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
 
                 @JvmSynthetic
@@ -1295,8 +1345,16 @@ private constructor(
                  * Returns an immutable instance of [Parent].
                  *
                  * Further updates to this [Builder] will not mutate the returned instance.
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .name()
+                 * ```
+                 *
+                 * @throws IllegalStateException if any required field is unset.
                  */
-                fun build(): Parent = Parent(name, additionalProperties.toMutableMap())
+                fun build(): Parent =
+                    Parent(checkRequired("name", name), additionalProperties.toMutableMap())
             }
 
             private var validated: Boolean = false
@@ -1420,15 +1478,23 @@ private constructor(
 
         companion object {
 
-            /** Returns a mutable builder for constructing an instance of [Entity]. */
+            /**
+             * Returns a mutable builder for constructing an instance of [Entity].
+             *
+             * The following fields are required:
+             * ```java
+             * .subtype()
+             * .type()
+             * ```
+             */
             @JvmStatic fun builder() = Builder()
         }
 
         /** A builder for [Entity]. */
         class Builder internal constructor() {
 
-            private var subtype: JsonField<Subtype> = JsonMissing.of()
-            private var type: JsonField<Type> = JsonMissing.of()
+            private var subtype: JsonField<Subtype>? = null
+            private var type: JsonField<Type>? = null
             private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
 
             @JvmSynthetic
@@ -1491,8 +1557,21 @@ private constructor(
              * Returns an immutable instance of [Entity].
              *
              * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .subtype()
+             * .type()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
              */
-            fun build(): Entity = Entity(subtype, type, additionalProperties.toMutableMap())
+            fun build(): Entity =
+                Entity(
+                    checkRequired("subtype", subtype),
+                    checkRequired("type", type),
+                    additionalProperties.toMutableMap(),
+                )
         }
 
         private var validated: Boolean = false