feat(api): disputes & mark url as a required param in lithic.events().subscriptions().update()

feat(api): disputes & mark url as a required param in `lithic.events().subscriptions().update()`

- Add CLOSED enum member to account state
- Update docs
- Internally rename `event_types` param to `event_types[]`

Author: stainless-bot

lithic-java-core/src/main/kotlin/com/lithic/api/client/LithicClient.kt

@@ -18,6 +18,8 @@ interface LithicClient {
 
     fun cards(): CardService
 
+    fun disputes(): DisputeService
+
     fun events(): EventService
 
     fun fundingSources(): FundingSourceService

lithic-java-core/src/main/kotlin/com/lithic/api/client/LithicClientAsync.kt

@@ -19,6 +19,8 @@ interface LithicClientAsync {
 
     fun cards(): CardServiceAsync
 
+    fun disputes(): DisputeServiceAsync
+
     fun events(): EventServiceAsync
 
     fun fundingSources(): FundingSourceServiceAsync

lithic-java-core/src/main/kotlin/com/lithic/api/client/LithicClientAsyncImpl.kt

@@ -34,6 +34,8 @@ constructor(
 
     private val cards: CardServiceAsync by lazy { CardServiceAsyncImpl(clientOptions) }
 
+    private val disputes: DisputeServiceAsync by lazy { DisputeServiceAsyncImpl(clientOptions) }
+
     private val events: EventServiceAsync by lazy { EventServiceAsyncImpl(clientOptions) }
 
     private val fundingSources: FundingSourceServiceAsync by lazy {
@@ -56,6 +58,8 @@ constructor(
 
     override fun cards(): CardServiceAsync = cards
 
+    override fun disputes(): DisputeServiceAsync = disputes
+
     override fun events(): EventServiceAsync = events
 
     override fun fundingSources(): FundingSourceServiceAsync = fundingSources

lithic-java-core/src/main/kotlin/com/lithic/api/client/LithicClientImpl.kt

@@ -33,6 +33,8 @@ constructor(
 
     private val cards: CardService by lazy { CardServiceImpl(clientOptions) }
 
+    private val disputes: DisputeService by lazy { DisputeServiceImpl(clientOptions) }
+
     private val events: EventService by lazy { EventServiceImpl(clientOptions) }
 
     private val fundingSources: FundingSourceService by lazy {
@@ -53,6 +55,8 @@ constructor(
 
     override fun cards(): CardService = cards
 
+    override fun disputes(): DisputeService = disputes
+
     override fun events(): EventService = events
 
     override fun fundingSources(): FundingSourceService = fundingSources

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

@@ -41,8 +41,10 @@ private constructor(
     /**
      * Account state:
      *
-     * - `ACTIVE` - Active, account is able to transact and create new cards.
-     * - `PAUSED` - Paused, account will not be able to transact or create new cards.
+     * - `ACTIVE` - Account is able to transact and create new cards.
+     * - `PAUSED` - Account will not be able to transact or create new cards. It can be set back to
+     * `ACTIVE`.
+     * - `CLOSED` - Account will permanently not be able to transact or create new cards.
      */
     fun state(): State = state.getRequired("state")
 
@@ -67,8 +69,10 @@ private constructor(
     /**
      * Account state:
      *
-     * - `ACTIVE` - Active, account is able to transact and create new cards.
-     * - `PAUSED` - Paused, account will not be able to transact or create new cards.
+     * - `ACTIVE` - Account is able to transact and create new cards.
+     * - `PAUSED` - Account will not be able to transact or create new cards. It can be set back to
+     * `ACTIVE`.
+     * - `CLOSED` - Account will permanently not be able to transact or create new cards.
      */
     @JsonProperty("state") @ExcludeMissing fun _state() = state
 
@@ -170,16 +174,20 @@ private constructor(
         /**
          * Account state:
          *
-         * - `ACTIVE` - Active, account is able to transact and create new cards.
-         * - `PAUSED` - Paused, account will not be able to transact or create new cards.
+         * - `ACTIVE` - Account is able to transact and create new cards.
+         * - `PAUSED` - Account will not be able to transact or create new cards. It can be set back
+         * to `ACTIVE`.
+         * - `CLOSED` - Account will permanently not be able to transact or create new cards.
          */
         fun state(state: State) = state(JsonField.of(state))
 
         /**
          * Account state:
          *
-         * - `ACTIVE` - Active, account is able to transact and create new cards.
-         * - `PAUSED` - Paused, account will not be able to transact or create new cards.
+         * - `ACTIVE` - Account is able to transact and create new cards.
+         * - `PAUSED` - Account will not be able to transact or create new cards. It can be set back
+         * to `ACTIVE`.
+         * - `CLOSED` - Account will permanently not be able to transact or create new cards.
          */
         @JsonProperty("state")
         @ExcludeMissing
@@ -409,31 +417,37 @@ private constructor(
 
             @JvmField val PAUSED = State(JsonField.of("PAUSED"))
 
+            @JvmField val CLOSED = State(JsonField.of("CLOSED"))
+
             @JvmStatic fun of(value: String) = State(JsonField.of(value))
         }
 
         enum class Known {
             ACTIVE,
             PAUSED,
+            CLOSED,
         }
 
         enum class Value {
             ACTIVE,
             PAUSED,
+            CLOSED,
             _UNKNOWN,
         }
 
         fun value(): Value =
             when (this) {
                 ACTIVE -> Value.ACTIVE
                 PAUSED -> Value.PAUSED
+                CLOSED -> Value.CLOSED
                 else -> Value._UNKNOWN
             }
 
         fun known(): Known =
             when (this) {
                 ACTIVE -> Known.ACTIVE
                 PAUSED -> Known.PAUSED
+                CLOSED -> Known.CLOSED
                 else -> throw LithicInvalidDataException("Unknown State: $value")
             }
 

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

@@ -353,7 +353,7 @@ constructor(
         @JsonProperty("control_person") fun controlPerson(): Individual? = controlPerson
 
         /**
-         * An ISO 8601 timestamp indicating when precomputed KYC was completed on the business with
+         * An RFC 3339 timestamp indicating when precomputed KYC was completed on the business with
          * a pass result.
          *
          * This field is required only if workflow type is `KYB_BYO`.
@@ -366,7 +366,7 @@ constructor(
         @JsonProperty("nature_of_business") fun natureOfBusiness(): String? = natureOfBusiness
 
         /**
-         * An ISO 8601 timestamp indicating when the account holder accepted the applicable legal
+         * An RFC 3339 timestamp indicating when the account holder accepted the applicable legal
          * agreements (e.g., cardholder terms) as agreed upon during API customer's implementation
          * with Lithic.
          */
@@ -508,7 +508,7 @@ constructor(
             }
 
             /**
-             * An ISO 8601 timestamp indicating when precomputed KYC was completed on the business
+             * An RFC 3339 timestamp indicating when precomputed KYC was completed on the business
              * with a pass result.
              *
              * This field is required only if workflow type is `KYB_BYO`.
@@ -528,7 +528,7 @@ constructor(
             }
 
             /**
-             * An ISO 8601 timestamp indicating when the account holder accepted the applicable
+             * An RFC 3339 timestamp indicating when the account holder accepted the applicable
              * legal agreements (e.g., cardholder terms) as agreed upon during API customer's
              * implementation with Lithic.
              */
@@ -787,7 +787,7 @@ constructor(
              */
             @JsonProperty("address") fun address(): Address? = address
 
-            /** Individual's date of birth, as an ISO 8601 date. */
+            /** Individual's date of birth, as an RFC 3339 date. */
             @JsonProperty("dob") fun dob(): String? = dob
 
             /**
@@ -890,7 +890,7 @@ constructor(
                 @JsonProperty("address")
                 fun address(address: Address) = apply { this.address = address }
 
-                /** Individual's date of birth, as an ISO 8601 date. */
+                /** Individual's date of birth, as an RFC 3339 date. */
                 @JsonProperty("dob") fun dob(dob: String) = apply { this.dob = dob }
 
                 /**
@@ -1028,15 +1028,15 @@ constructor(
         @JsonProperty("individual") fun individual(): Individual? = individual
 
         /**
-         * An ISO 8601 timestamp indicating when precomputed KYC was completed on the individual
+         * An RFC 3339 timestamp indicating when precomputed KYC was completed on the individual
          * with a pass result.
          *
          * This field is required only if workflow type is `KYC_BYO`.
          */
         @JsonProperty("kyc_passed_timestamp") fun kycPassedTimestamp(): String? = kycPassedTimestamp
 
         /**
-         * An ISO 8601 timestamp indicating when the account holder accepted the applicable legal
+         * An RFC 3339 timestamp indicating when the account holder accepted the applicable legal
          * agreements (e.g., cardholder terms) as agreed upon during API customer's implementation
          * with Lithic.
          */
@@ -1110,7 +1110,7 @@ constructor(
             fun individual(individual: Individual) = apply { this.individual = individual }
 
             /**
-             * An ISO 8601 timestamp indicating when precomputed KYC was completed on the individual
+             * An RFC 3339 timestamp indicating when precomputed KYC was completed on the individual
              * with a pass result.
              *
              * This field is required only if workflow type is `KYC_BYO`.
@@ -1121,7 +1121,7 @@ constructor(
             }
 
             /**
-             * An ISO 8601 timestamp indicating when the account holder accepted the applicable
+             * An RFC 3339 timestamp indicating when the account holder accepted the applicable
              * legal agreements (e.g., cardholder terms) as agreed upon during API customer's
              * implementation with Lithic.
              */
@@ -1179,7 +1179,7 @@ constructor(
              */
             @JsonProperty("address") fun address(): Address? = address
 
-            /** Individual's date of birth, as an ISO 8601 date. */
+            /** Individual's date of birth, as an RFC 3339 date. */
             @JsonProperty("dob") fun dob(): String? = dob
 
             /**
@@ -1282,7 +1282,7 @@ constructor(
                 @JsonProperty("address")
                 fun address(address: Address) = apply { this.address = address }
 
-                /** Individual's date of birth, as an ISO 8601 date. */
+                /** Individual's date of birth, as an RFC 3339 date. */
                 @JsonProperty("dob") fun dob(dob: String) = apply { this.dob = dob }
 
                 /**

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

@@ -69,7 +69,7 @@ constructor(
         @JsonProperty("workflow") fun workflow(): Workflow? = workflow
 
         /**
-         * An ISO 8601 timestamp indicating when the account holder accepted the applicable legal
+         * An RFC 3339 timestamp indicating when the account holder accepted the applicable legal
          * agreements (e.g., cardholder terms) as agreed upon during API customer's implementation
          * with Lithic.
          */
@@ -138,7 +138,7 @@ constructor(
             fun workflow(workflow: Workflow) = apply { this.workflow = workflow }
 
             /**
-             * An ISO 8601 timestamp indicating when the account holder accepted the applicable
+             * An RFC 3339 timestamp indicating when the account holder accepted the applicable
              * legal agreements (e.g., cardholder terms) as agreed upon during API customer's
              * implementation with Lithic.
              */
@@ -248,7 +248,7 @@ constructor(
         fun workflow(workflow: Workflow) = apply { this.workflow = workflow }
 
         /**
-         * An ISO 8601 timestamp indicating when the account holder accepted the applicable legal
+         * An RFC 3339 timestamp indicating when the account holder accepted the applicable legal
          * agreements (e.g., cardholder terms) as agreed upon during API customer's implementation
          * with Lithic.
          */
@@ -401,7 +401,7 @@ constructor(
          */
         @JsonProperty("address") fun address(): Address? = address
 
-        /** Individual's date of birth, as an ISO 8601 date. */
+        /** Individual's date of birth, as an RFC 3339 date. */
         @JsonProperty("dob") fun dob(): String? = dob
 
         /**
@@ -504,7 +504,7 @@ constructor(
             @JsonProperty("address")
             fun address(address: Address) = apply { this.address = address }
 
-            /** Individual's date of birth, as an ISO 8601 date. */
+            /** Individual's date of birth, as an RFC 3339 date. */
             @JsonProperty("dob") fun dob(dob: String) = apply { this.dob = dob }
 
             /**

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

@@ -98,13 +98,13 @@ constructor(
         }
 
         /**
-         * Date string in 8601 format. Only entries created after the specified date will be
+         * Date string in RFC 3339 format. Only entries created after the specified date will be
          * included. UTC time zone.
          */
         fun begin(begin: OffsetDateTime) = apply { this.begin = begin }
 
         /**
-         * Date string in 8601 format. Only entries created before the specified date will be
+         * Date string in RFC 3339 format. Only entries created before the specified date will be
          * included. UTC time zone.
          */
         fun end(end: OffsetDateTime) = apply { this.end = end }

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

@@ -43,7 +43,7 @@ private constructor(
 
     private var hashCode: Int = 0
 
-    /** An ISO 8601 timestamp for when the card was created. UTC time zone. */
+    /** An RFC 3339 timestamp for when the card was created. UTC time zone. */
     fun created(): OffsetDateTime = created.getRequired("created")
 
     /** Three digit cvv printed on the back of the card. */
@@ -146,7 +146,7 @@ private constructor(
     fun digitalCardArtToken(): Optional<String> =
         Optional.ofNullable(digitalCardArtToken.getNullable("digital_card_art_token"))
 
-    /** An ISO 8601 timestamp for when the card was created. UTC time zone. */
+    /** An RFC 3339 timestamp for when the card was created. UTC time zone. */
     @JsonProperty("created") @ExcludeMissing fun _created() = created
 
     /** Three digit cvv printed on the back of the card. */
@@ -378,10 +378,10 @@ private constructor(
             additionalProperties(card.additionalProperties)
         }
 
-        /** An ISO 8601 timestamp for when the card was created. UTC time zone. */
+        /** An RFC 3339 timestamp for when the card was created. UTC time zone. */
         fun created(created: OffsetDateTime) = created(JsonField.of(created))
 
-        /** An ISO 8601 timestamp for when the card was created. UTC time zone. */
+        /** An RFC 3339 timestamp for when the card was created. UTC time zone. */
         @JsonProperty("created")
         @ExcludeMissing
         fun created(created: JsonField<OffsetDateTime>) = apply { this.created = created }

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

@@ -118,10 +118,10 @@ constructor(
         private var hashCode: Int = 0
 
         /**
-         * Only required for multi-account users. Token identifying the account the card will be
-         * associated with. Only applicable if using account holder enrollment. See
-         * [Managing Your Program](https://docs.lithic.com/docs/managing-your-program) for more
-         * information.
+         * Globally unique identifier for the account that the card will be associated with.
+         * Required for programs enrolling users using the
+         * [/account_holders endpoint](https://docs.lithic.com/docs/account-holders-kyc). See
+         * [Managing Your Program](doc:managing-your-program) for more information.
          */
         @JsonProperty("account_token") fun accountToken(): String? = accountToken
 
@@ -342,10 +342,10 @@ constructor(
             }
 
             /**
-             * Only required for multi-account users. Token identifying the account the card will be
-             * associated with. Only applicable if using account holder enrollment. See
-             * [Managing Your Program](https://docs.lithic.com/docs/managing-your-program) for more
-             * information.
+             * Globally unique identifier for the account that the card will be associated with.
+             * Required for programs enrolling users using the
+             * [/account_holders endpoint](https://docs.lithic.com/docs/account-holders-kyc). See
+             * [Managing Your Program](doc:managing-your-program) for more information.
              */
             @JsonProperty("account_token")
             fun accountToken(accountToken: String) = apply { this.accountToken = accountToken }
@@ -632,10 +632,10 @@ constructor(
         }
 
         /**
-         * Only required for multi-account users. Token identifying the account the card will be
-         * associated with. Only applicable if using account holder enrollment. See
-         * [Managing Your Program](https://docs.lithic.com/docs/managing-your-program) for more
-         * information.
+         * Globally unique identifier for the account that the card will be associated with.
+         * Required for programs enrolling users using the
+         * [/account_holders endpoint](https://docs.lithic.com/docs/account-holders-kyc). See
+         * [Managing Your Program](doc:managing-your-program) for more information.
          */
         fun accountToken(accountToken: String) = apply { this.accountToken = accountToken }