feat(api): api update

.stats.yml

@@ -1,3 +1,3 @@
 configured_endpoints: 239
-openapi_spec_hash: d691eb2845a0108278fe81faa111d29f
+openapi_spec_hash: e8136cf3fc19b9f1d4632136a98880cd
 config_hash: 1ca082e374ef7000e2a5971e8da740e0

buildSrc/src/main/kotlin/increase.java.gradle.kts

@@ -38,6 +38,12 @@ tasks.withType<Test>().configureEach {
     maxParallelForks = (Runtime.getRuntime().availableProcessors() / 2).coerceAtLeast(1)
     forkEvery = 100
 
+    // Mockito's inline mock maker attaches the Byte Buddy agent dynamically, which makes the
+    // JVM print a warning to stderr. Tests that capture stderr to assert on logging output run
+    // concurrently with tests that use Mockito, so that warning can land in their captured
+    // output and fail them. Enabling dynamic agent loading up front suppresses the warning.
+    jvmArgs("-XX:+EnableDynamicAgentLoading")
+
     testLogging {
         exceptionFormat = TestExceptionFormat.FULL
     }

increase-java-core/src/main/kotlin/com/increase/api/models/pendingtransactions/PendingTransaction.kt

@@ -103,8 +103,8 @@ private constructor(
 
     /**
      * The Pending Transaction amount in the minor unit of its currency. For dollars, for example,
-     * this is cents. This amount does not change after the Pending Transaction is created. If a
-     * card authorization settles for a different amount, the settled amount is available on the
+     * this is cents. For a card authorization this is the amount still held: it decreases when the
+     * merchant reverses part of the authorization. The amount that settled is available on the
      * resulting Transaction and on the Card Payment's `state.settled_amount`.
      *
      * @throws IncreaseInvalidDataException if the JSON field has an unexpected type or is
@@ -394,9 +394,10 @@ private constructor(
 
         /**
          * The Pending Transaction amount in the minor unit of its currency. For dollars, for
-         * example, this is cents. This amount does not change after the Pending Transaction is
-         * created. If a card authorization settles for a different amount, the settled amount is
-         * available on the resulting Transaction and on the Card Payment's `state.settled_amount`.
+         * example, this is cents. For a card authorization this is the amount still held: it
+         * decreases when the merchant reverses part of the authorization. The amount that settled
+         * is available on the resulting Transaction and on the Card Payment's
+         * `state.settled_amount`.
          */
         fun amount(amount: Long) = amount(JsonField.of(amount))
 
@@ -19660,8 +19661,9 @@ private constructor(
             /**
              * The Pending Transaction is confirmed. An associated Transaction exists for this
              * object. The Pending Transaction will no longer count against your balance and can
-             * generally be hidden from UIs, etc. The Pending Transaction's `amount` is not updated
-             * if the associated Transaction settles for a different amount.
+             * generally be hidden from UIs, etc. The Pending Transaction's `amount` is the amount
+             * that was still held when it completed, which can differ from the amount of the
+             * associated Transaction.
              */
             @JvmField val COMPLETE = of("complete")
 
@@ -19675,8 +19677,9 @@ private constructor(
             /**
              * The Pending Transaction is confirmed. An associated Transaction exists for this
              * object. The Pending Transaction will no longer count against your balance and can
-             * generally be hidden from UIs, etc. The Pending Transaction's `amount` is not updated
-             * if the associated Transaction settles for a different amount.
+             * generally be hidden from UIs, etc. The Pending Transaction's `amount` is the amount
+             * that was still held when it completed, which can differ from the amount of the
+             * associated Transaction.
              */
             COMPLETE,
         }
@@ -19696,8 +19699,9 @@ private constructor(
             /**
              * The Pending Transaction is confirmed. An associated Transaction exists for this
              * object. The Pending Transaction will no longer count against your balance and can
-             * generally be hidden from UIs, etc. The Pending Transaction's `amount` is not updated
-             * if the associated Transaction settles for a different amount.
+             * generally be hidden from UIs, etc. The Pending Transaction's `amount` is the amount
+             * that was still held when it completed, which can differ from the amount of the
+             * associated Transaction.
              */
             COMPLETE,
             /** An enum member indicating that [Status] was instantiated with an unknown value. */

increase-java-core/src/main/kotlin/com/increase/api/models/pendingtransactions/PendingTransactionListParams.kt

@@ -1135,8 +1135,9 @@ private constructor(
                 /**
                  * The Pending Transaction is confirmed. An associated Transaction exists for this
                  * object. The Pending Transaction will no longer count against your balance and can
-                 * generally be hidden from UIs, etc. The Pending Transaction's `amount` is not
-                 * updated if the associated Transaction settles for a different amount.
+                 * generally be hidden from UIs, etc. The Pending Transaction's `amount` is the
+                 * amount that was still held when it completed, which can differ from the amount of
+                 * the associated Transaction.
                  */
                 @JvmField val COMPLETE = of("complete")
 
@@ -1150,8 +1151,9 @@ private constructor(
                 /**
                  * The Pending Transaction is confirmed. An associated Transaction exists for this
                  * object. The Pending Transaction will no longer count against your balance and can
-                 * generally be hidden from UIs, etc. The Pending Transaction's `amount` is not
-                 * updated if the associated Transaction settles for a different amount.
+                 * generally be hidden from UIs, etc. The Pending Transaction's `amount` is the
+                 * amount that was still held when it completed, which can differ from the amount of
+                 * the associated Transaction.
                  */
                 COMPLETE,
             }
@@ -1171,8 +1173,9 @@ private constructor(
                 /**
                  * The Pending Transaction is confirmed. An associated Transaction exists for this
                  * object. The Pending Transaction will no longer count against your balance and can
-                 * generally be hidden from UIs, etc. The Pending Transaction's `amount` is not
-                 * updated if the associated Transaction settles for a different amount.
+                 * generally be hidden from UIs, etc. The Pending Transaction's `amount` is the
+                 * amount that was still held when it completed, which can differ from the amount of
+                 * the associated Transaction.
                  */
                 COMPLETE,
                 /** An enum member indicating that [In] was instantiated with an unknown value. */

increase-java-core/src/test/kotlin/com/increase/api/core/http/LoggingHttpClientTest.kt

@@ -20,11 +20,11 @@ import org.assertj.core.api.Assertions.assertThatThrownBy
 import org.junit.jupiter.api.AfterEach
 import org.junit.jupiter.api.BeforeEach
 import org.junit.jupiter.api.Test
-import org.junit.jupiter.api.parallel.ResourceLock
+import org.junit.jupiter.api.parallel.Isolated
 import org.junit.jupiter.params.ParameterizedTest
 import org.junit.jupiter.params.provider.ValueSource
 
-@ResourceLock("stderr")
+@Isolated
 internal class LoggingHttpClientTest {
 
     private lateinit var originalErr: PrintStream