fix(types): add EMPTY exemption type, make fields optional in Account/Card/NonPciCard

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 191
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/lithic%2Flithic-d29b68bb85936070878d8badaa8a7c5991313285e70a990bc812c838eba85373.yml
-openapi_spec_hash: 54b44da68df22eb0ea99f2bc564667a2
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/lithic%2Flithic-dc8aacc11d74a1e25c95ba549dd0f4a4e735cbf7562fc6b17b0c81d62fd5475c.yml
+openapi_spec_hash: 1906583f260a3e9ace5ae38fd2254763
 config_hash: ac8326134e692f3f3bdec82396bbec80

lithic-java-core/src/main/kotlin/com/lithic/api/models/Account.kt

@@ -504,7 +504,10 @@ private constructor(
          * * `OTHER` - The reason for the account's current status does not fall into any of the
          *   above categories. A comment should be provided to specify the particular reason.
          */
-        fun substatus(substatus: Substatus) = substatus(JsonField.of(substatus))
+        fun substatus(substatus: Substatus?) = substatus(JsonField.ofNullable(substatus))
+
+        /** Alias for calling [Builder.substatus] with `substatus.orElse(null)`. */
+        fun substatus(substatus: Optional<Substatus>) = substatus(substatus.getOrNull())
 
         /**
          * Sets [Builder.substatus] to an arbitrary JSON value.

lithic-java-core/src/main/kotlin/com/lithic/api/models/AccountHolderSimulateEnrollmentReviewResponse.kt

@@ -209,7 +209,7 @@ private constructor(
     fun email(): Optional<String> = email.getOptional("email")
 
     /**
-     * The type of KYC exemption for a KYC-Exempt Account Holder. "None" if the account holder is
+     * The type of KYC exemption for a KYC-Exempt Account Holder. `null` if the account holder is
      * not KYC-Exempt.
      *
      * @throws LithicInvalidDataException if the JSON field has an unexpected type (e.g. if the
@@ -733,10 +733,15 @@ private constructor(
         fun email(email: JsonField<String>) = apply { this.email = email }
 
         /**
-         * The type of KYC exemption for a KYC-Exempt Account Holder. "None" if the account holder
+         * The type of KYC exemption for a KYC-Exempt Account Holder. `null` if the account holder
          * is not KYC-Exempt.
          */
-        fun exemptionType(exemptionType: ExemptionType) = exemptionType(JsonField.of(exemptionType))
+        fun exemptionType(exemptionType: ExemptionType?) =
+            exemptionType(JsonField.ofNullable(exemptionType))
+
+        /** Alias for calling [Builder.exemptionType] with `exemptionType.orElse(null)`. */
+        fun exemptionType(exemptionType: Optional<ExemptionType>) =
+            exemptionType(exemptionType.getOrNull())
 
         /**
          * Sets [Builder.exemptionType] to an arbitrary JSON value.
@@ -1871,7 +1876,7 @@ private constructor(
     }
 
     /**
-     * The type of KYC exemption for a KYC-Exempt Account Holder. "None" if the account holder is
+     * The type of KYC exemption for a KYC-Exempt Account Holder. `null` if the account holder is
      * not KYC-Exempt.
      */
     class ExemptionType @JsonCreator private constructor(private val value: JsonField<String>) :

lithic-java-core/src/main/kotlin/com/lithic/api/models/AccountHolderUpdateResponse.kt

@@ -402,7 +402,7 @@ private constructor(
         fun email(): Optional<String> = email.getOptional("email")
 
         /**
-         * The type of KYC exemption for a KYC-Exempt Account Holder. "None" if the account holder
+         * The type of KYC exemption for a KYC-Exempt Account Holder. `null` if the account holder
          * is not KYC-Exempt.
          *
          * @throws LithicInvalidDataException if the JSON field has an unexpected type (e.g. if the
@@ -927,7 +927,7 @@ private constructor(
             fun email(email: JsonField<String>) = apply { this.email = email }
 
             /**
-             * The type of KYC exemption for a KYC-Exempt Account Holder. "None" if the account
+             * The type of KYC exemption for a KYC-Exempt Account Holder. `null` if the account
              * holder is not KYC-Exempt.
              */
             fun exemptionType(exemptionType: ExemptionType) =
@@ -2098,7 +2098,7 @@ private constructor(
         }
 
         /**
-         * The type of KYC exemption for a KYC-Exempt Account Holder. "None" if the account holder
+         * The type of KYC exemption for a KYC-Exempt Account Holder. `null` if the account holder
          * is not KYC-Exempt.
          */
         class ExemptionType @JsonCreator private constructor(private val value: JsonField<String>) :

lithic-java-core/src/main/kotlin/com/lithic/api/models/AccountUpdateParams.kt

@@ -337,7 +337,10 @@ private constructor(
          * * `OTHER` - The reason for the account's current status does not fall into any of the
          *   above categories. A comment should be provided to specify the particular reason.
          */
-        fun substatus(substatus: Substatus) = apply { body.substatus(substatus) }
+        fun substatus(substatus: Substatus?) = apply { body.substatus(substatus) }
+
+        /** Alias for calling [Builder.substatus] with `substatus.orElse(null)`. */
+        fun substatus(substatus: Optional<Substatus>) = substatus(substatus.getOrNull())
 
         /**
          * Sets [Builder.substatus] to an arbitrary JSON value.
@@ -864,7 +867,10 @@ private constructor(
              * * `OTHER` - The reason for the account's current status does not fall into any of the
              *   above categories. A comment should be provided to specify the particular reason.
              */
-            fun substatus(substatus: Substatus) = substatus(JsonField.of(substatus))
+            fun substatus(substatus: Substatus?) = substatus(JsonField.ofNullable(substatus))
+
+            /** Alias for calling [Builder.substatus] with `substatus.orElse(null)`. */
+            fun substatus(substatus: Optional<Substatus>) = substatus(substatus.getOrNull())
 
             /**
              * Sets [Builder.substatus] to an arbitrary JSON value.

lithic-java-core/src/main/kotlin/com/lithic/api/models/Card.kt

@@ -206,12 +206,12 @@ private constructor(
     fun created(): OffsetDateTime = created.getRequired("created")
 
     /**
-     * Deprecated: Funding account for the card.
+     * Funding account for a card
      *
-     * @throws LithicInvalidDataException 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 LithicInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
      */
-    fun funding(): NonPciCard.FundingAccount = funding.getRequired("funding")
+    fun funding(): Optional<NonPciCard.FundingAccount> = funding.getOptional("funding")
 
     /**
      * Last four digits of the card number.
@@ -822,8 +822,11 @@ private constructor(
          */
         fun created(created: JsonField<OffsetDateTime>) = apply { this.created = created }
 
-        /** Deprecated: Funding account for the card. */
-        fun funding(funding: NonPciCard.FundingAccount) = funding(JsonField.of(funding))
+        /** Funding account for a card */
+        fun funding(funding: NonPciCard.FundingAccount?) = funding(JsonField.ofNullable(funding))
+
+        /** Alias for calling [Builder.funding] with `funding.orElse(null)`. */
+        fun funding(funding: Optional<NonPciCard.FundingAccount>) = funding(funding.getOrNull())
 
         /**
          * Sets [Builder.funding] to an arbitrary JSON value.
@@ -1040,8 +1043,14 @@ private constructor(
          * tokenization. This artwork must be approved by Mastercard and configured by Lithic to
          * use.
          */
-        fun digitalCardArtToken(digitalCardArtToken: String) =
-            digitalCardArtToken(JsonField.of(digitalCardArtToken))
+        fun digitalCardArtToken(digitalCardArtToken: String?) =
+            digitalCardArtToken(JsonField.ofNullable(digitalCardArtToken))
+
+        /**
+         * Alias for calling [Builder.digitalCardArtToken] with `digitalCardArtToken.orElse(null)`.
+         */
+        fun digitalCardArtToken(digitalCardArtToken: Optional<String>) =
+            digitalCardArtToken(digitalCardArtToken.getOrNull())
 
         /**
          * Sets [Builder.digitalCardArtToken] to an arbitrary JSON value.
@@ -1159,7 +1168,10 @@ private constructor(
          * use. Specifies the configuration (i.e., physical card art) that the card should be
          * manufactured with.
          */
-        fun productId(productId: String) = productId(JsonField.of(productId))
+        fun productId(productId: String?) = productId(JsonField.ofNullable(productId))
+
+        /** Alias for calling [Builder.productId] with `productId.orElse(null)`. */
+        fun productId(productId: Optional<String>) = productId(productId.getOrNull())
 
         /**
          * Sets [Builder.productId] to an arbitrary JSON value.
@@ -1212,7 +1224,10 @@ private constructor(
          * has been returned. * `OTHER` - The reason for the status does not fall into any of the
          * above categories. A comment can be provided to specify the reason.
          */
-        fun substatus(substatus: NonPciCard.Substatus) = substatus(JsonField.of(substatus))
+        fun substatus(substatus: NonPciCard.Substatus?) = substatus(JsonField.ofNullable(substatus))
+
+        /** Alias for calling [Builder.substatus] with `substatus.orElse(null)`. */
+        fun substatus(substatus: Optional<NonPciCard.Substatus>) = substatus(substatus.getOrNull())
 
         /**
          * Sets [Builder.substatus] to an arbitrary JSON value.
@@ -1336,7 +1351,7 @@ private constructor(
         accountToken()
         cardProgramToken()
         created()
-        funding().validate()
+        funding().ifPresent { it.validate() }
         lastFour()
         pinStatus().validate()
         spendLimit()

lithic-java-core/src/main/kotlin/com/lithic/api/models/NonPciCard.kt

@@ -170,12 +170,12 @@ private constructor(
     fun created(): OffsetDateTime = created.getRequired("created")
 
     /**
-     * Deprecated: Funding account for the card.
+     * Funding account for a card
      *
-     * @throws LithicInvalidDataException 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 LithicInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
      */
-    fun funding(): FundingAccount = funding.getRequired("funding")
+    fun funding(): Optional<FundingAccount> = funding.getOptional("funding")
 
     /**
      * Last four digits of the card number.
@@ -745,8 +745,11 @@ private constructor(
          */
         fun created(created: JsonField<OffsetDateTime>) = apply { this.created = created }
 
-        /** Deprecated: Funding account for the card. */
-        fun funding(funding: FundingAccount) = funding(JsonField.of(funding))
+        /** Funding account for a card */
+        fun funding(funding: FundingAccount?) = funding(JsonField.ofNullable(funding))
+
+        /** Alias for calling [Builder.funding] with `funding.orElse(null)`. */
+        fun funding(funding: Optional<FundingAccount>) = funding(funding.getOrNull())
 
         /**
          * Sets [Builder.funding] to an arbitrary JSON value.
@@ -957,8 +960,14 @@ private constructor(
          * tokenization. This artwork must be approved by Mastercard and configured by Lithic to
          * use.
          */
-        fun digitalCardArtToken(digitalCardArtToken: String) =
-            digitalCardArtToken(JsonField.of(digitalCardArtToken))
+        fun digitalCardArtToken(digitalCardArtToken: String?) =
+            digitalCardArtToken(JsonField.ofNullable(digitalCardArtToken))
+
+        /**
+         * Alias for calling [Builder.digitalCardArtToken] with `digitalCardArtToken.orElse(null)`.
+         */
+        fun digitalCardArtToken(digitalCardArtToken: Optional<String>) =
+            digitalCardArtToken(digitalCardArtToken.getOrNull())
 
         /**
          * Sets [Builder.digitalCardArtToken] to an arbitrary JSON value.
@@ -1076,7 +1085,10 @@ private constructor(
          * use. Specifies the configuration (i.e., physical card art) that the card should be
          * manufactured with.
          */
-        fun productId(productId: String) = productId(JsonField.of(productId))
+        fun productId(productId: String?) = productId(JsonField.ofNullable(productId))
+
+        /** Alias for calling [Builder.productId] with `productId.orElse(null)`. */
+        fun productId(productId: Optional<String>) = productId(productId.getOrNull())
 
         /**
          * Sets [Builder.productId] to an arbitrary JSON value.
@@ -1129,7 +1141,10 @@ private constructor(
          * has been returned. * `OTHER` - The reason for the status does not fall into any of the
          * above categories. A comment can be provided to specify the reason.
          */
-        fun substatus(substatus: Substatus) = substatus(JsonField.of(substatus))
+        fun substatus(substatus: Substatus?) = substatus(JsonField.ofNullable(substatus))
+
+        /** Alias for calling [Builder.substatus] with `substatus.orElse(null)`. */
+        fun substatus(substatus: Optional<Substatus>) = substatus(substatus.getOrNull())
 
         /**
          * Sets [Builder.substatus] to an arbitrary JSON value.
@@ -1223,7 +1238,7 @@ private constructor(
         accountToken()
         cardProgramToken()
         created()
-        funding().validate()
+        funding().ifPresent { it.validate() }
         lastFour()
         pinStatus().validate()
         spendLimit()
@@ -1288,7 +1303,7 @@ private constructor(
             (if (replacementFor.asKnown().isPresent) 1 else 0) +
             (substatus.asKnown().getOrNull()?.validity() ?: 0)
 
-    /** Deprecated: Funding account for the card. */
+    /** Funding account for a card */
     class FundingAccount
     @JsonCreator(mode = JsonCreator.Mode.DISABLED)
     private constructor(
@@ -1574,7 +1589,10 @@ private constructor(
             }
 
             /** The nickname given to the `FundingAccount` or `null` if it has no nickname. */
-            fun nickname(nickname: String) = nickname(JsonField.of(nickname))
+            fun nickname(nickname: String?) = nickname(JsonField.ofNullable(nickname))
+
+            /** Alias for calling [Builder.nickname] with `nickname.orElse(null)`. */
+            fun nickname(nickname: Optional<String>) = nickname(nickname.getOrNull())
 
             /**
              * Sets [Builder.nickname] to an arbitrary JSON value.

lithic-java-core/src/test/kotlin/com/lithic/api/models/CardTest.kt

@@ -59,7 +59,7 @@ internal class CardTest {
         assertThat(card.cardProgramToken()).isEqualTo("5e9483eb-8103-4e16-9794-2106111b2eca")
         assertThat(card.created()).isEqualTo(OffsetDateTime.parse("2021-06-28T22:53:15Z"))
         assertThat(card.funding())
-            .isEqualTo(
+            .contains(
                 NonPciCard.FundingAccount.builder()
                     .token("182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e")
                     .created(OffsetDateTime.parse("2019-12-27T18:11:19.117Z"))

lithic-java-core/src/test/kotlin/com/lithic/api/models/NonPciCardTest.kt

@@ -57,7 +57,7 @@ internal class NonPciCardTest {
         assertThat(nonPciCard.cardProgramToken()).isEqualTo("5e9483eb-8103-4e16-9794-2106111b2eca")
         assertThat(nonPciCard.created()).isEqualTo(OffsetDateTime.parse("2021-06-28T22:53:15Z"))
         assertThat(nonPciCard.funding())
-            .isEqualTo(
+            .contains(
                 NonPciCard.FundingAccount.builder()
                     .token("182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e")
                     .created(OffsetDateTime.parse("2019-12-27T18:11:19.117Z"))