feat(api): api update

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 45
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/finch%2Ffinch-bfcb61384672f485be2ee4e2ae2938ef8c57c063c2ea5d0e7890e68098300579.yml
-openapi_spec_hash: 5d75581b91b95d16f0fae017a36b4ea9
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/finch%2Ffinch-199a2fd8b7387b0648e88b5942a8248895373a561aff663389982073e55c8eb5.yml
+openapi_spec_hash: 7415c1faca5f2e873824893b140650f1
 config_hash: 6d3585c0032e08d723d077d660fc8448

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

@@ -11,6 +11,7 @@ import com.tryfinch.api.core.ExcludeMissing
 import com.tryfinch.api.core.JsonField
 import com.tryfinch.api.core.JsonMissing
 import com.tryfinch.api.core.JsonValue
+import com.tryfinch.api.core.checkRequired
 import com.tryfinch.api.errors.FinchInvalidDataException
 import java.util.Collections
 import java.util.Objects
@@ -42,10 +43,10 @@ private constructor(
     /**
      * A stable Finch id for the document.
      *
-     * @throws FinchInvalidDataException if the JSON field has an unexpected type (e.g. if the
-     *   server responded with an unexpected value).
+     * @throws FinchInvalidDataException if the JSON field has an unexpected type or is unexpectedly
+     *   missing or null (e.g. if the server responded with an unexpected value).
      */
-    fun id(): Optional<String> = id.getOptional("id")
+    fun id(): String = id.getRequired("id")
 
     /**
      * The ID of the individual associated with the document. This will be null for employer-level
@@ -59,27 +60,27 @@ private constructor(
     /**
      * The type of document.
      *
-     * @throws FinchInvalidDataException if the JSON field has an unexpected type (e.g. if the
-     *   server responded with an unexpected value).
+     * @throws FinchInvalidDataException if the JSON field has an unexpected type or is unexpectedly
+     *   missing or null (e.g. if the server responded with an unexpected value).
      */
-    fun type(): Optional<Type> = type.getOptional("type")
+    fun type(): Type = type.getRequired("type")
 
     /**
      * A URL to access the document. Format:
      * `https://api.tryfinch.com/employer/documents/:document_id`.
      *
-     * @throws FinchInvalidDataException if the JSON field has an unexpected type (e.g. if the
-     *   server responded with an unexpected value).
+     * @throws FinchInvalidDataException if the JSON field has an unexpected type or is unexpectedly
+     *   missing or null (e.g. if the server responded with an unexpected value).
      */
-    fun url(): Optional<String> = url.getOptional("url")
+    fun url(): String = url.getRequired("url")
 
     /**
      * The year the document applies to, if available.
      *
-     * @throws FinchInvalidDataException if the JSON field has an unexpected type (e.g. if the
-     *   server responded with an unexpected value).
+     * @throws FinchInvalidDataException if the JSON field has an unexpected type or is unexpectedly
+     *   missing or null (e.g. if the server responded with an unexpected value).
      */
-    fun year(): Optional<Double> = year.getOptional("year")
+    fun year(): Double = year.getRequired("year")
 
     /**
      * Returns the raw JSON value of [id].
@@ -132,18 +133,29 @@ private constructor(
 
     companion object {
 
-        /** Returns a mutable builder for constructing an instance of [DocumentResponse]. */
+        /**
+         * Returns a mutable builder for constructing an instance of [DocumentResponse].
+         *
+         * The following fields are required:
+         * ```java
+         * .id()
+         * .individualId()
+         * .type()
+         * .url()
+         * .year()
+         * ```
+         */
         @JvmStatic fun builder() = Builder()
     }
 
     /** A builder for [DocumentResponse]. */
     class Builder internal constructor() {
 
-        private var id: JsonField<String> = JsonMissing.of()
-        private var individualId: JsonField<String> = JsonMissing.of()
-        private var type: JsonField<Type> = JsonMissing.of()
-        private var url: JsonField<String> = JsonMissing.of()
-        private var year: JsonField<Double> = JsonMissing.of()
+        private var id: JsonField<String>? = null
+        private var individualId: JsonField<String>? = null
+        private var type: JsonField<Type>? = null
+        private var url: JsonField<String>? = null
+        private var year: JsonField<Double>? = null
         private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
 
         @JvmSynthetic
@@ -213,17 +225,7 @@ private constructor(
         fun url(url: JsonField<String>) = apply { this.url = url }
 
         /** The year the document applies to, if available. */
-        fun year(year: Double?) = year(JsonField.ofNullable(year))
-
-        /**
-         * Alias for [Builder.year].
-         *
-         * This unboxed primitive overload exists for backwards compatibility.
-         */
-        fun year(year: Double) = year(year as Double?)
-
-        /** Alias for calling [Builder.year] with `year.orElse(null)`. */
-        fun year(year: Optional<Double>) = year(year.getOrNull())
+        fun year(year: Double) = year(JsonField.of(year))
 
         /**
          * Sets [Builder.year] to an arbitrary JSON value.
@@ -256,9 +258,27 @@ private constructor(
          * Returns an immutable instance of [DocumentResponse].
          *
          * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .id()
+         * .individualId()
+         * .type()
+         * .url()
+         * .year()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
          */
         fun build(): DocumentResponse =
-            DocumentResponse(id, individualId, type, url, year, additionalProperties.toMutableMap())
+            DocumentResponse(
+                checkRequired("id", id),
+                checkRequired("individualId", individualId),
+                checkRequired("type", type),
+                checkRequired("url", url),
+                checkRequired("year", year),
+                additionalProperties.toMutableMap(),
+            )
     }
 
     private var validated: Boolean = false
@@ -270,7 +290,7 @@ private constructor(
 
         id()
         individualId()
-        type().ifPresent { it.validate() }
+        type().validate()
         url()
         year()
         validated = true