feat(api)!: updates book transfer status, updates to transactions, add currency model (#305)

- Breaking: Removed book transfer status `PENDING`. While technically a breaking change, that was a mistake and should not impact user code, the API never accepted `PENDING` as a status for book transfer.
- Add book transfer status `REVERSED`
- Add `updated` and `amounts` fields to transactions
- Add shared model `Currency`
# Migration
The SDK previously stated that `PENDING` was an accepted value for book transfer status. That was a mistake, `PENDING` has never been accepted by the API for book transfers.
While this is a breaking change we do not expect user code to be impacted.

Author: stainless-app[bot]

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

@@ -42,21 +42,15 @@ private constructor(
     fun city(): String = city.getRequired("city")
 
     /**
-     * Valid country code. Only USA is currently supported, entered in uppercase ISO 3166-1 alpha-3
+     * Valid country code. USA and CAN are supported, entered in uppercase ISO 3166-1 alpha-3
      * three-character format.
      */
     fun country(): String = country.getRequired("country")
 
-    /**
-     * Valid postal code. Only USA postal codes (ZIP codes) are currently supported, entered as a
-     * five-digit postal code or nine-digit postal code (ZIP+4) using the format 12345-1234.
-     */
+    /** Valid postal code. */
     fun postalCode(): String = postalCode.getRequired("postal_code")
 
-    /**
-     * Valid state code. Only USA state codes are currently supported, entered in uppercase ISO
-     * 3166-2 two-character format.
-     */
+    /** Valid state code. */
     fun state(): String = state.getRequired("state")
 
     /** Valid deliverable address (no PO boxes). */
@@ -69,21 +63,15 @@ private constructor(
     @JsonProperty("city") @ExcludeMissing fun _city() = city
 
     /**
-     * Valid country code. Only USA is currently supported, entered in uppercase ISO 3166-1 alpha-3
+     * Valid country code. USA and CAN are supported, entered in uppercase ISO 3166-1 alpha-3
      * three-character format.
      */
     @JsonProperty("country") @ExcludeMissing fun _country() = country
 
-    /**
-     * Valid postal code. Only USA postal codes (ZIP codes) are currently supported, entered as a
-     * five-digit postal code or nine-digit postal code (ZIP+4) using the format 12345-1234.
-     */
+    /** Valid postal code. */
     @JsonProperty("postal_code") @ExcludeMissing fun _postalCode() = postalCode
 
-    /**
-     * Valid state code. Only USA state codes are currently supported, entered in uppercase ISO
-     * 3166-2 two-character format.
-     */
+    /** Valid state code. */
     @JsonProperty("state") @ExcludeMissing fun _state() = state
 
     @JsonAnyGetter
@@ -189,43 +177,31 @@ private constructor(
         fun city(city: JsonField<String>) = apply { this.city = city }
 
         /**
-         * Valid country code. Only USA is currently supported, entered in uppercase ISO 3166-1
-         * alpha-3 three-character format.
+         * Valid country code. USA and CAN are supported, entered in uppercase ISO 3166-1 alpha-3
+         * three-character format.
          */
         fun country(country: String) = country(JsonField.of(country))
 
         /**
-         * Valid country code. Only USA is currently supported, entered in uppercase ISO 3166-1
-         * alpha-3 three-character format.
+         * Valid country code. USA and CAN are supported, entered in uppercase ISO 3166-1 alpha-3
+         * three-character format.
          */
         @JsonProperty("country")
         @ExcludeMissing
         fun country(country: JsonField<String>) = apply { this.country = country }
 
-        /**
-         * Valid postal code. Only USA postal codes (ZIP codes) are currently supported, entered as
-         * a five-digit postal code or nine-digit postal code (ZIP+4) using the format 12345-1234.
-         */
+        /** Valid postal code. */
         fun postalCode(postalCode: String) = postalCode(JsonField.of(postalCode))
 
-        /**
-         * Valid postal code. Only USA postal codes (ZIP codes) are currently supported, entered as
-         * a five-digit postal code or nine-digit postal code (ZIP+4) using the format 12345-1234.
-         */
+        /** Valid postal code. */
         @JsonProperty("postal_code")
         @ExcludeMissing
         fun postalCode(postalCode: JsonField<String>) = apply { this.postalCode = postalCode }
 
-        /**
-         * Valid state code. Only USA state codes are currently supported, entered in uppercase ISO
-         * 3166-2 two-character format.
-         */
+        /** Valid state code. */
         fun state(state: String) = state(JsonField.of(state))
 
-        /**
-         * Valid state code. Only USA state codes are currently supported, entered in uppercase ISO
-         * 3166-2 two-character format.
-         */
+        /** Valid state code. */
         @JsonProperty("state")
         @ExcludeMissing
         fun state(state: JsonField<String>) = apply { this.state = state }

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

@@ -80,8 +80,8 @@ private constructor(
     fun settledAmount(): Long = settledAmount.getRequired("settled_amount")
 
     /**
-     * Status types: _ `DECLINED` - The transfer was declined. _ `PENDING` - The transfer is pending
-     * release from a hold. \* `SETTLED` - The transfer is completed.
+     * Status types: _ `DECLINED` - The transfer was declined. _ `REVERSED` - The transfer was
+     * reversed \* `SETTLED` - The transfer is completed.
      */
     fun status(): Status = status.getRequired("status")
 
@@ -134,8 +134,8 @@ private constructor(
     @JsonProperty("settled_amount") @ExcludeMissing fun _settledAmount() = settledAmount
 
     /**
-     * Status types: _ `DECLINED` - The transfer was declined. _ `PENDING` - The transfer is pending
-     * release from a hold. \* `SETTLED` - The transfer is completed.
+     * Status types: _ `DECLINED` - The transfer was declined. _ `REVERSED` - The transfer was
+     * reversed \* `SETTLED` - The transfer is completed.
      */
     @JsonProperty("status") @ExcludeMissing fun _status() = status
 
@@ -361,14 +361,14 @@ private constructor(
         }
 
         /**
-         * Status types: _ `DECLINED` - The transfer was declined. _ `PENDING` - The transfer is
-         * pending release from a hold. \* `SETTLED` - The transfer is completed.
+         * Status types: _ `DECLINED` - The transfer was declined. _ `REVERSED` - The transfer was
+         * reversed \* `SETTLED` - The transfer is completed.
          */
         fun status(status: Status) = status(JsonField.of(status))
 
         /**
-         * Status types: _ `DECLINED` - The transfer was declined. _ `PENDING` - The transfer is
-         * pending release from a hold. \* `SETTLED` - The transfer is completed.
+         * Status types: _ `DECLINED` - The transfer was declined. _ `REVERSED` - The transfer was
+         * reversed \* `SETTLED` - The transfer is completed.
          */
         @JsonProperty("status")
         @ExcludeMissing
@@ -997,7 +997,7 @@ private constructor(
 
             @JvmField val DECLINED = Status(JsonField.of("DECLINED"))
 
-            @JvmField val PENDING = Status(JsonField.of("PENDING"))
+            @JvmField val REVERSED = Status(JsonField.of("REVERSED"))
 
             @JvmField val SETTLED = Status(JsonField.of("SETTLED"))
 
@@ -1006,29 +1006,29 @@ private constructor(
 
         enum class Known {
             DECLINED,
-            PENDING,
+            REVERSED,
             SETTLED,
         }
 
         enum class Value {
             DECLINED,
-            PENDING,
+            REVERSED,
             SETTLED,
             _UNKNOWN,
         }
 
         fun value(): Value =
             when (this) {
                 DECLINED -> Value.DECLINED
-                PENDING -> Value.PENDING
+                REVERSED -> Value.REVERSED
                 SETTLED -> Value.SETTLED
                 else -> Value._UNKNOWN
             }
 
         fun known(): Known =
             when (this) {
                 DECLINED -> Known.DECLINED
-                PENDING -> Known.PENDING
+                REVERSED -> Known.REVERSED
                 SETTLED -> Known.SETTLED
                 else -> throw LithicInvalidDataException("Unknown Status: $value")
             }