fix(types): add enum values, make fields optional in Balance/SettlementDetail/Statement

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 194
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/lithic/lithic-659808bfd15f4eafd418ec0db871b22be857ca94f771c9539792ecda2d2d0dbe.yml
-openapi_spec_hash: e870e6403121ac3bbd1667deec6788de
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/lithic/lithic-89ce5b3ff634397bdfc05a63d3103b9c767726dfc6b042883d220d08d4156c99.yml
+openapi_spec_hash: 867ab9ab196ad28740f46ec4e7bf7aba
 config_hash: 1c5c139a2aa0d1d45c063f953a9bc803

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

@@ -16,6 +16,7 @@ import com.lithic.api.errors.LithicInvalidDataException
 import java.time.OffsetDateTime
 import java.util.Collections
 import java.util.Objects
+import java.util.Optional
 import kotlin.jvm.optionals.getOrNull
 
 /** Balance */
@@ -125,19 +126,20 @@ private constructor(
      * Globally unique identifier for the last financial transaction event that impacted this
      * balance.
      *
-     * @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 lastTransactionEventToken(): String =
-        lastTransactionEventToken.getRequired("last_transaction_event_token")
+    fun lastTransactionEventToken(): Optional<String> =
+        lastTransactionEventToken.getOptional("last_transaction_event_token")
 
     /**
      * Globally unique identifier for the last financial transaction that impacted this balance.
      *
-     * @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 lastTransactionToken(): String = lastTransactionToken.getRequired("last_transaction_token")
+    fun lastTransactionToken(): Optional<String> =
+        lastTransactionToken.getOptional("last_transaction_token")
 
     /**
      * Funds not available for spend due to card authorizations or pending ACH release. Shown in the
@@ -386,8 +388,15 @@ private constructor(
          * Globally unique identifier for the last financial transaction event that impacted this
          * balance.
          */
-        fun lastTransactionEventToken(lastTransactionEventToken: String) =
-            lastTransactionEventToken(JsonField.of(lastTransactionEventToken))
+        fun lastTransactionEventToken(lastTransactionEventToken: String?) =
+            lastTransactionEventToken(JsonField.ofNullable(lastTransactionEventToken))
+
+        /**
+         * Alias for calling [Builder.lastTransactionEventToken] with
+         * `lastTransactionEventToken.orElse(null)`.
+         */
+        fun lastTransactionEventToken(lastTransactionEventToken: Optional<String>) =
+            lastTransactionEventToken(lastTransactionEventToken.getOrNull())
 
         /**
          * Sets [Builder.lastTransactionEventToken] to an arbitrary JSON value.
@@ -403,8 +412,15 @@ private constructor(
         /**
          * Globally unique identifier for the last financial transaction that impacted this balance.
          */
-        fun lastTransactionToken(lastTransactionToken: String) =
-            lastTransactionToken(JsonField.of(lastTransactionToken))
+        fun lastTransactionToken(lastTransactionToken: String?) =
+            lastTransactionToken(JsonField.ofNullable(lastTransactionToken))
+
+        /**
+         * Alias for calling [Builder.lastTransactionToken] with
+         * `lastTransactionToken.orElse(null)`.
+         */
+        fun lastTransactionToken(lastTransactionToken: Optional<String>) =
+            lastTransactionToken(lastTransactionToken.getOrNull())
 
         /**
          * Sets [Builder.lastTransactionToken] to an arbitrary JSON value.
@@ -588,10 +604,14 @@ private constructor(
 
         companion object {
 
+            @JvmField val CARD = of("CARD")
+
             @JvmField val ISSUING = of("ISSUING")
 
             @JvmField val OPERATING = of("OPERATING")
 
+            @JvmField val PROGRAM_RECEIVABLES = of("PROGRAM_RECEIVABLES")
+
             @JvmField val RESERVE = of("RESERVE")
 
             @JvmField val SECURITY = of("SECURITY")
@@ -601,8 +621,10 @@ private constructor(
 
         /** An enum containing [FinancialAccountType]'s known values. */
         enum class Known {
+            CARD,
             ISSUING,
             OPERATING,
+            PROGRAM_RECEIVABLES,
             RESERVE,
             SECURITY,
         }
@@ -618,8 +640,10 @@ private constructor(
          * - It was constructed with an arbitrary value using the [of] method.
          */
         enum class Value {
+            CARD,
             ISSUING,
             OPERATING,
+            PROGRAM_RECEIVABLES,
             RESERVE,
             SECURITY,
             /**
@@ -638,8 +662,10 @@ private constructor(
          */
         fun value(): Value =
             when (this) {
+                CARD -> Value.CARD
                 ISSUING -> Value.ISSUING
                 OPERATING -> Value.OPERATING
+                PROGRAM_RECEIVABLES -> Value.PROGRAM_RECEIVABLES
                 RESERVE -> Value.RESERVE
                 SECURITY -> Value.SECURITY
                 else -> Value._UNKNOWN
@@ -656,8 +682,10 @@ private constructor(
          */
         fun known(): Known =
             when (this) {
+                CARD -> Known.CARD
                 ISSUING -> Known.ISSUING
                 OPERATING -> Known.OPERATING
+                PROGRAM_RECEIVABLES -> Known.PROGRAM_RECEIVABLES
                 RESERVE -> Known.RESERVE
                 SECURITY -> Known.SECURITY
                 else -> throw LithicInvalidDataException("Unknown FinancialAccountType: $value")

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

@@ -623,6 +623,8 @@ private constructor(
 
             @JvmField val MONTHLY_REVERSAL = of("MONTHLY_REVERSAL")
 
+            @JvmField val ACCOUNT_TO_ACCOUNT = of("ACCOUNT_TO_ACCOUNT")
+
             @JvmStatic fun of(value: String) = FinancialEventType(JsonField.of(value))
         }
 
@@ -715,6 +717,7 @@ private constructor(
             QUARTERLY_REVERSAL,
             MONTHLY,
             MONTHLY_REVERSAL,
+            ACCOUNT_TO_ACCOUNT,
         }
 
         /**
@@ -814,6 +817,7 @@ private constructor(
             QUARTERLY_REVERSAL,
             MONTHLY,
             MONTHLY_REVERSAL,
+            ACCOUNT_TO_ACCOUNT,
             /**
              * An enum member indicating that [FinancialEventType] was instantiated with an unknown
              * value.
@@ -917,6 +921,7 @@ private constructor(
                 QUARTERLY_REVERSAL -> Value.QUARTERLY_REVERSAL
                 MONTHLY -> Value.MONTHLY
                 MONTHLY_REVERSAL -> Value.MONTHLY_REVERSAL
+                ACCOUNT_TO_ACCOUNT -> Value.ACCOUNT_TO_ACCOUNT
                 else -> Value._UNKNOWN
             }
 
@@ -1018,6 +1023,7 @@ private constructor(
                 QUARTERLY_REVERSAL -> Known.QUARTERLY_REVERSAL
                 MONTHLY -> Known.MONTHLY
                 MONTHLY_REVERSAL -> Known.MONTHLY_REVERSAL
+                ACCOUNT_TO_ACCOUNT -> Known.ACCOUNT_TO_ACCOUNT
                 else -> throw LithicInvalidDataException("Unknown FinancialEventType: $value")
             }
 

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

@@ -139,27 +139,27 @@ private constructor(
     /**
      * Globally unique identifier denoting the account that the associated transaction occurred on.
      *
-     * @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 accountToken(): String = accountToken.getRequired("account_token")
+    fun accountToken(): Optional<String> = accountToken.getOptional("account_token")
 
     /**
      * Globally unique identifier denoting the card program that the associated transaction occurred
      * on.
      *
-     * @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 cardProgramToken(): String = cardProgramToken.getRequired("card_program_token")
+    fun cardProgramToken(): Optional<String> = cardProgramToken.getOptional("card_program_token")
 
     /**
      * Globally unique identifier denoting the card that the associated transaction occurred on.
      *
-     * @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 cardToken(): String = cardToken.getRequired("card_token")
+    fun cardToken(): Optional<String> = cardToken.getOptional("card_token")
 
     /**
      * Date and time when the transaction first occurred. UTC time zone.
@@ -264,15 +264,15 @@ private constructor(
 
     /**
      * Globally unique identifier denoting the associated transaction. For settlement records with
-     * type `CLEARING`, `FINANCIAL`, or `NON-FINANCIAL`, this references a card transaction token.
+     * type `CLEARING`, `FINANCIAL`, or `NON_FINANCIAL`, this references a card transaction token.
      * For settlement records with type `CHARGEBACK`, `REPRESENTMENT`, `PREARBITRATION`,
      * `ARBITRATION`, or `COLLABORATION`, this references the dispute transaction token. May be null
      * for certain settlement types.
      *
-     * @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 transactionToken(): String = transactionToken.getRequired("transaction_token")
+    fun transactionToken(): Optional<String> = transactionToken.getOptional("transaction_token")
 
     /**
      * The total amount of settlement impacting transactions (excluding interchange, fees, and
@@ -598,7 +598,10 @@ private constructor(
          * Globally unique identifier denoting the account that the associated transaction occurred
          * on.
          */
-        fun accountToken(accountToken: String) = accountToken(JsonField.of(accountToken))
+        fun accountToken(accountToken: String?) = accountToken(JsonField.ofNullable(accountToken))
+
+        /** Alias for calling [Builder.accountToken] with `accountToken.orElse(null)`. */
+        fun accountToken(accountToken: Optional<String>) = accountToken(accountToken.getOrNull())
 
         /**
          * Sets [Builder.accountToken] to an arbitrary JSON value.
@@ -615,8 +618,12 @@ private constructor(
          * Globally unique identifier denoting the card program that the associated transaction
          * occurred on.
          */
-        fun cardProgramToken(cardProgramToken: String) =
-            cardProgramToken(JsonField.of(cardProgramToken))
+        fun cardProgramToken(cardProgramToken: String?) =
+            cardProgramToken(JsonField.ofNullable(cardProgramToken))
+
+        /** Alias for calling [Builder.cardProgramToken] with `cardProgramToken.orElse(null)`. */
+        fun cardProgramToken(cardProgramToken: Optional<String>) =
+            cardProgramToken(cardProgramToken.getOrNull())
 
         /**
          * Sets [Builder.cardProgramToken] to an arbitrary JSON value.
@@ -632,7 +639,10 @@ private constructor(
         /**
          * Globally unique identifier denoting the card that the associated transaction occurred on.
          */
-        fun cardToken(cardToken: String) = cardToken(JsonField.of(cardToken))
+        fun cardToken(cardToken: String?) = cardToken(JsonField.ofNullable(cardToken))
+
+        /** Alias for calling [Builder.cardToken] with `cardToken.orElse(null)`. */
+        fun cardToken(cardToken: Optional<String>) = cardToken(cardToken.getOrNull())
 
         /**
          * Sets [Builder.cardToken] to an arbitrary JSON value.
@@ -828,13 +838,17 @@ private constructor(
 
         /**
          * Globally unique identifier denoting the associated transaction. For settlement records
-         * with type `CLEARING`, `FINANCIAL`, or `NON-FINANCIAL`, this references a card transaction
+         * with type `CLEARING`, `FINANCIAL`, or `NON_FINANCIAL`, this references a card transaction
          * token. For settlement records with type `CHARGEBACK`, `REPRESENTMENT`, `PREARBITRATION`,
          * `ARBITRATION`, or `COLLABORATION`, this references the dispute transaction token. May be
          * null for certain settlement types.
          */
-        fun transactionToken(transactionToken: String) =
-            transactionToken(JsonField.of(transactionToken))
+        fun transactionToken(transactionToken: String?) =
+            transactionToken(JsonField.ofNullable(transactionToken))
+
+        /** Alias for calling [Builder.transactionToken] with `transactionToken.orElse(null)`. */
+        fun transactionToken(transactionToken: Optional<String>) =
+            transactionToken(transactionToken.getOrNull())
 
         /**
          * Sets [Builder.transactionToken] to an arbitrary JSON value.
@@ -1392,7 +1406,7 @@ private constructor(
 
             @JvmField val FINANCIAL = of("FINANCIAL")
 
-            @JvmField val NON_FINANCIAL = of("NON-FINANCIAL")
+            @JvmField val NON_FINANCIAL = of("NON_FINANCIAL")
 
             @JvmField val PREARBITRATION = of("PREARBITRATION")
 

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

@@ -897,8 +897,14 @@ private constructor(
         }
 
         /** Date when the next payment is due */
-        fun nextPaymentDueDate(nextPaymentDueDate: LocalDate) =
-            nextPaymentDueDate(JsonField.of(nextPaymentDueDate))
+        fun nextPaymentDueDate(nextPaymentDueDate: LocalDate?) =
+            nextPaymentDueDate(JsonField.ofNullable(nextPaymentDueDate))
+
+        /**
+         * Alias for calling [Builder.nextPaymentDueDate] with `nextPaymentDueDate.orElse(null)`.
+         */
+        fun nextPaymentDueDate(nextPaymentDueDate: Optional<LocalDate>) =
+            nextPaymentDueDate(nextPaymentDueDate.getOrNull())
 
         /**
          * Sets [Builder.nextPaymentDueDate] to an arbitrary JSON value.
@@ -912,8 +918,15 @@ private constructor(
         }
 
         /** Date when the next billing period will end */
-        fun nextStatementEndDate(nextStatementEndDate: LocalDate) =
-            nextStatementEndDate(JsonField.of(nextStatementEndDate))
+        fun nextStatementEndDate(nextStatementEndDate: LocalDate?) =
+            nextStatementEndDate(JsonField.ofNullable(nextStatementEndDate))
+
+        /**
+         * Alias for calling [Builder.nextStatementEndDate] with
+         * `nextStatementEndDate.orElse(null)`.
+         */
+        fun nextStatementEndDate(nextStatementEndDate: Optional<LocalDate>) =
+            nextStatementEndDate(nextStatementEndDate.getOrNull())
 
         /**
          * Sets [Builder.nextStatementEndDate] to an arbitrary JSON value.

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

@@ -744,7 +744,10 @@ private constructor(
             }
 
             /** Globally unique identifier for a card */
-            fun cardToken(cardToken: String) = cardToken(JsonField.of(cardToken))
+            fun cardToken(cardToken: String?) = cardToken(JsonField.ofNullable(cardToken))
+
+            /** Alias for calling [Builder.cardToken] with `cardToken.orElse(null)`. */
+            fun cardToken(cardToken: Optional<String>) = cardToken(cardToken.getOrNull())
 
             /**
              * Sets [Builder.cardToken] to an arbitrary JSON value.
@@ -1386,6 +1389,8 @@ private constructor(
 
                 @JvmField val MONTHLY_REVERSAL = of("MONTHLY_REVERSAL")
 
+                @JvmField val ACCOUNT_TO_ACCOUNT = of("ACCOUNT_TO_ACCOUNT")
+
                 @JvmStatic fun of(value: String) = FinancialEventType(JsonField.of(value))
             }
 
@@ -1478,6 +1483,7 @@ private constructor(
                 QUARTERLY_REVERSAL,
                 MONTHLY,
                 MONTHLY_REVERSAL,
+                ACCOUNT_TO_ACCOUNT,
             }
 
             /**
@@ -1579,6 +1585,7 @@ private constructor(
                 QUARTERLY_REVERSAL,
                 MONTHLY,
                 MONTHLY_REVERSAL,
+                ACCOUNT_TO_ACCOUNT,
                 /**
                  * An enum member indicating that [FinancialEventType] was instantiated with an
                  * unknown value.
@@ -1682,6 +1689,7 @@ private constructor(
                     QUARTERLY_REVERSAL -> Value.QUARTERLY_REVERSAL
                     MONTHLY -> Value.MONTHLY
                     MONTHLY_REVERSAL -> Value.MONTHLY_REVERSAL
+                    ACCOUNT_TO_ACCOUNT -> Value.ACCOUNT_TO_ACCOUNT
                     else -> Value._UNKNOWN
                 }
 
@@ -1783,6 +1791,7 @@ private constructor(
                     QUARTERLY_REVERSAL -> Known.QUARTERLY_REVERSAL
                     MONTHLY -> Known.MONTHLY
                     MONTHLY_REVERSAL -> Known.MONTHLY_REVERSAL
+                    ACCOUNT_TO_ACCOUNT -> Known.ACCOUNT_TO_ACCOUNT
                     else -> throw LithicInvalidDataException("Unknown FinancialEventType: $value")
                 }