feat(api)!: add carrier delivery estimate; nullable trust grantor fields

.stats.yml

@@ -1,3 +1,3 @@
 configured_endpoints: 239
-openapi_spec_hash: f0a8620e85b9d96f7ebd57a165897ee4
+openapi_spec_hash: f6a1f4bde6efb971145f60df61c0f8cc
 config_hash: 1ca082e374ef7000e2a5971e8da740e0

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

@@ -5518,6 +5518,7 @@ private constructor(
         class TrackingUpdate
         @JsonCreator(mode = JsonCreator.Mode.DISABLED)
         private constructor(
+            private val carrierEstimatedDeliveryAt: JsonField<OffsetDateTime>,
             private val category: JsonField<Category>,
             private val country: JsonField<String>,
             private val createdAt: JsonField<OffsetDateTime>,
@@ -5527,6 +5528,9 @@ private constructor(
 
             @JsonCreator
             private constructor(
+                @JsonProperty("carrier_estimated_delivery_at")
+                @ExcludeMissing
+                carrierEstimatedDeliveryAt: JsonField<OffsetDateTime> = JsonMissing.of(),
                 @JsonProperty("category")
                 @ExcludeMissing
                 category: JsonField<Category> = JsonMissing.of(),
@@ -5539,7 +5543,24 @@ private constructor(
                 @JsonProperty("postal_code")
                 @ExcludeMissing
                 postalCode: JsonField<String> = JsonMissing.of(),
-            ) : this(category, country, createdAt, postalCode, mutableMapOf())
+            ) : this(
+                carrierEstimatedDeliveryAt,
+                category,
+                country,
+                createdAt,
+                postalCode,
+                mutableMapOf(),
+            )
+
+            /**
+             * The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time when the carrier
+             * expects the check to be delivered.
+             *
+             * @throws IncreaseInvalidDataException if the JSON field has an unexpected type (e.g.
+             *   if the server responded with an unexpected value).
+             */
+            fun carrierEstimatedDeliveryAt(): Optional<OffsetDateTime> =
+                carrierEstimatedDeliveryAt.getOptional("carrier_estimated_delivery_at")
 
             /**
              * The type of tracking event.
@@ -5578,6 +5599,17 @@ private constructor(
              */
             fun postalCode(): String = postalCode.getRequired("postal_code")
 
+            /**
+             * Returns the raw JSON value of [carrierEstimatedDeliveryAt].
+             *
+             * Unlike [carrierEstimatedDeliveryAt], this method doesn't throw if the JSON field has
+             * an unexpected type.
+             */
+            @JsonProperty("carrier_estimated_delivery_at")
+            @ExcludeMissing
+            fun _carrierEstimatedDeliveryAt(): JsonField<OffsetDateTime> =
+                carrierEstimatedDeliveryAt
+
             /**
              * Returns the raw JSON value of [category].
              *
@@ -5634,6 +5666,7 @@ private constructor(
                  *
                  * The following fields are required:
                  * ```java
+                 * .carrierEstimatedDeliveryAt()
                  * .category()
                  * .country()
                  * .createdAt()
@@ -5646,6 +5679,7 @@ private constructor(
             /** A builder for [TrackingUpdate]. */
             class Builder internal constructor() {
 
+                private var carrierEstimatedDeliveryAt: JsonField<OffsetDateTime>? = null
                 private var category: JsonField<Category>? = null
                 private var country: JsonField<String>? = null
                 private var createdAt: JsonField<OffsetDateTime>? = null
@@ -5654,13 +5688,40 @@ private constructor(
 
                 @JvmSynthetic
                 internal fun from(trackingUpdate: TrackingUpdate) = apply {
+                    carrierEstimatedDeliveryAt = trackingUpdate.carrierEstimatedDeliveryAt
                     category = trackingUpdate.category
                     country = trackingUpdate.country
                     createdAt = trackingUpdate.createdAt
                     postalCode = trackingUpdate.postalCode
                     additionalProperties = trackingUpdate.additionalProperties.toMutableMap()
                 }
 
+                /**
+                 * The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time when the
+                 * carrier expects the check to be delivered.
+                 */
+                fun carrierEstimatedDeliveryAt(carrierEstimatedDeliveryAt: OffsetDateTime?) =
+                    carrierEstimatedDeliveryAt(JsonField.ofNullable(carrierEstimatedDeliveryAt))
+
+                /**
+                 * Alias for calling [Builder.carrierEstimatedDeliveryAt] with
+                 * `carrierEstimatedDeliveryAt.orElse(null)`.
+                 */
+                fun carrierEstimatedDeliveryAt(
+                    carrierEstimatedDeliveryAt: Optional<OffsetDateTime>
+                ) = carrierEstimatedDeliveryAt(carrierEstimatedDeliveryAt.getOrNull())
+
+                /**
+                 * Sets [Builder.carrierEstimatedDeliveryAt] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.carrierEstimatedDeliveryAt] with a well-typed
+                 * [OffsetDateTime] value instead. This method is primarily for setting the field to
+                 * an undocumented or not yet supported value.
+                 */
+                fun carrierEstimatedDeliveryAt(
+                    carrierEstimatedDeliveryAt: JsonField<OffsetDateTime>
+                ) = apply { this.carrierEstimatedDeliveryAt = carrierEstimatedDeliveryAt }
+
                 /** The type of tracking event. */
                 fun category(category: Category) = category(JsonField.of(category))
 
@@ -5747,6 +5808,7 @@ private constructor(
                  *
                  * The following fields are required:
                  * ```java
+                 * .carrierEstimatedDeliveryAt()
                  * .category()
                  * .country()
                  * .createdAt()
@@ -5757,6 +5819,7 @@ private constructor(
                  */
                 fun build(): TrackingUpdate =
                     TrackingUpdate(
+                        checkRequired("carrierEstimatedDeliveryAt", carrierEstimatedDeliveryAt),
                         checkRequired("category", category),
                         checkRequired("country", country),
                         checkRequired("createdAt", createdAt),
@@ -5782,6 +5845,7 @@ private constructor(
                     return@apply
                 }
 
+                carrierEstimatedDeliveryAt()
                 category().validate()
                 country()
                 createdAt()
@@ -5805,7 +5869,8 @@ private constructor(
              */
             @JvmSynthetic
             internal fun validity(): Int =
-                (category.asKnown().getOrNull()?.validity() ?: 0) +
+                (if (carrierEstimatedDeliveryAt.asKnown().isPresent) 1 else 0) +
+                    (category.asKnown().getOrNull()?.validity() ?: 0) +
                     (if (country.asKnown().isPresent) 1 else 0) +
                     (if (createdAt.asKnown().isPresent) 1 else 0) +
                     (if (postalCode.asKnown().isPresent) 1 else 0)
@@ -6024,6 +6089,7 @@ private constructor(
                 }
 
                 return other is TrackingUpdate &&
+                    carrierEstimatedDeliveryAt == other.carrierEstimatedDeliveryAt &&
                     category == other.category &&
                     country == other.country &&
                     createdAt == other.createdAt &&
@@ -6032,13 +6098,20 @@ private constructor(
             }
 
             private val hashCode: Int by lazy {
-                Objects.hash(category, country, createdAt, postalCode, additionalProperties)
+                Objects.hash(
+                    carrierEstimatedDeliveryAt,
+                    category,
+                    country,
+                    createdAt,
+                    postalCode,
+                    additionalProperties,
+                )
             }
 
             override fun hashCode(): Int = hashCode
 
             override fun toString() =
-                "TrackingUpdate{category=$category, country=$country, createdAt=$createdAt, postalCode=$postalCode, additionalProperties=$additionalProperties}"
+                "TrackingUpdate{carrierEstimatedDeliveryAt=$carrierEstimatedDeliveryAt, category=$category, country=$country, createdAt=$createdAt, postalCode=$postalCode, additionalProperties=$additionalProperties}"
         }
 
         override fun equals(other: Any?): Boolean {

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

@@ -10250,25 +10250,23 @@ private constructor(
             ) : this(address, dateOfBirth, identification, name, mutableMapOf())
 
             /**
-             * The person's address.
+             * The grantor's address.
              *
-             * @throws IncreaseInvalidDataException if the JSON field has an unexpected type or is
-             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
-             *   value).
+             * @throws IncreaseInvalidDataException if the JSON field has an unexpected type (e.g.
+             *   if the server responded with an unexpected value).
              */
-            fun address(): Address = address.getRequired("address")
+            fun address(): Optional<Address> = address.getOptional("address")
 
             /**
-             * The person's date of birth in YYYY-MM-DD format.
+             * The grantor's date of birth in YYYY-MM-DD format.
              *
-             * @throws IncreaseInvalidDataException if the JSON field has an unexpected type or is
-             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
-             *   value).
+             * @throws IncreaseInvalidDataException if the JSON field has an unexpected type (e.g.
+             *   if the server responded with an unexpected value).
              */
-            fun dateOfBirth(): LocalDate = dateOfBirth.getRequired("date_of_birth")
+            fun dateOfBirth(): Optional<LocalDate> = dateOfBirth.getOptional("date_of_birth")
 
             /**
-             * A means of verifying the person's identity.
+             * A means of verifying the grantor's identity.
              *
              * @throws IncreaseInvalidDataException if the JSON field has an unexpected type (e.g.
              *   if the server responded with an unexpected value).
@@ -10277,7 +10275,7 @@ private constructor(
                 identification.getOptional("identification")
 
             /**
-             * The person's legal name.
+             * The grantor's legal name.
              *
              * @throws IncreaseInvalidDataException if the JSON field has an unexpected type or is
              *   unexpectedly missing or null (e.g. if the server responded with an unexpected
@@ -10365,8 +10363,11 @@ private constructor(
                     additionalProperties = grantor.additionalProperties.toMutableMap()
                 }
 
-                /** The person's address. */
-                fun address(address: Address) = address(JsonField.of(address))
+                /** The grantor's address. */
+                fun address(address: Address?) = address(JsonField.ofNullable(address))
+
+                /** Alias for calling [Builder.address] with `address.orElse(null)`. */
+                fun address(address: Optional<Address>) = address(address.getOrNull())
 
                 /**
                  * Sets [Builder.address] to an arbitrary JSON value.
@@ -10377,8 +10378,13 @@ private constructor(
                  */
                 fun address(address: JsonField<Address>) = apply { this.address = address }
 
-                /** The person's date of birth in YYYY-MM-DD format. */
-                fun dateOfBirth(dateOfBirth: LocalDate) = dateOfBirth(JsonField.of(dateOfBirth))
+                /** The grantor's date of birth in YYYY-MM-DD format. */
+                fun dateOfBirth(dateOfBirth: LocalDate?) =
+                    dateOfBirth(JsonField.ofNullable(dateOfBirth))
+
+                /** Alias for calling [Builder.dateOfBirth] with `dateOfBirth.orElse(null)`. */
+                fun dateOfBirth(dateOfBirth: Optional<LocalDate>) =
+                    dateOfBirth(dateOfBirth.getOrNull())
 
                 /**
                  * Sets [Builder.dateOfBirth] to an arbitrary JSON value.
@@ -10391,7 +10397,7 @@ private constructor(
                     this.dateOfBirth = dateOfBirth
                 }
 
-                /** A means of verifying the person's identity. */
+                /** A means of verifying the grantor's identity. */
                 fun identification(identification: Identification?) =
                     identification(JsonField.ofNullable(identification))
 
@@ -10412,7 +10418,7 @@ private constructor(
                     this.identification = identification
                 }
 
-                /** The person's legal name. */
+                /** The grantor's legal name. */
                 fun name(name: String) = name(JsonField.of(name))
 
                 /**
@@ -10488,7 +10494,7 @@ private constructor(
                     return@apply
                 }
 
-                address().validate()
+                address().ifPresent { it.validate() }
                 dateOfBirth()
                 identification().ifPresent { it.validate() }
                 name()
@@ -10516,7 +10522,7 @@ private constructor(
                     (identification.asKnown().getOrNull()?.validity() ?: 0) +
                     (if (name.asKnown().isPresent) 1 else 0)
 
-            /** The person's address. */
+            /** The grantor's address. */
             class Address
             @JsonCreator(mode = JsonCreator.Mode.DISABLED)
             private constructor(
@@ -10911,7 +10917,7 @@ private constructor(
                     "Address{city=$city, country=$country, line1=$line1, line2=$line2, state=$state, zip=$zip, additionalProperties=$additionalProperties}"
             }
 
-            /** A means of verifying the person's identity. */
+            /** A means of verifying the grantor's identity. */
             class Identification
             @JsonCreator(mode = JsonCreator.Mode.DISABLED)
             private constructor(
@@ -10931,7 +10937,7 @@ private constructor(
                 ) : this(method, numberLast4, mutableMapOf())
 
                 /**
-                 * A method that can be used to verify the individual's identity.
+                 * A method that can be used to verify the grantor's identity.
                  *
                  * @throws IncreaseInvalidDataException if the JSON field has an unexpected type or
                  *   is unexpectedly missing or null (e.g. if the server responded with an
@@ -10941,7 +10947,7 @@ private constructor(
 
                 /**
                  * The last 4 digits of the identification number that can be used to verify the
-                 * individual's identity.
+                 * grantor's identity.
                  *
                  * @throws IncreaseInvalidDataException if the JSON field has an unexpected type or
                  *   is unexpectedly missing or null (e.g. if the server responded with an
@@ -11007,7 +11013,7 @@ private constructor(
                         additionalProperties = identification.additionalProperties.toMutableMap()
                     }
 
-                    /** A method that can be used to verify the individual's identity. */
+                    /** A method that can be used to verify the grantor's identity. */
                     fun method(method: Method) = method(JsonField.of(method))
 
                     /**
@@ -11021,7 +11027,7 @@ private constructor(
 
                     /**
                      * The last 4 digits of the identification number that can be used to verify the
-                     * individual's identity.
+                     * grantor's identity.
                      */
                     fun numberLast4(numberLast4: String) = numberLast4(JsonField.of(numberLast4))
 
@@ -11120,7 +11126,7 @@ private constructor(
                     (method.asKnown().getOrNull()?.validity() ?: 0) +
                         (if (numberLast4.asKnown().isPresent) 1 else 0)
 
-                /** A method that can be used to verify the individual's identity. */
+                /** A method that can be used to verify the grantor's identity. */
                 class Method
                 @JsonCreator
                 private constructor(private val value: JsonField<String>) : Enum {