feat(client): add close method (#714)

Author: stainless-app[bot]

increase-java-core/src/main/kotlin/com/increase/api/client/IncreaseClient.kt

@@ -171,4 +171,17 @@ interface IncreaseClient {
     fun realTimePaymentsRequestForPayments(): RealTimePaymentsRequestForPaymentService
 
     fun simulations(): SimulationService
+
+    /**
+     * Closes this client, relinquishing any underlying resources.
+     *
+     * This is purposefully not inherited from [AutoCloseable] because the client is long-lived and
+     * usually should not be synchronously closed via try-with-resources.
+     *
+     * It's also usually not necessary to call this method at all. the default HTTP client
+     * automatically releases threads and connections if they remain idle, but if you are writing an
+     * application that needs to aggressively release unused resources, then you may call this
+     * method.
+     */
+    fun close()
 }

increase-java-core/src/main/kotlin/com/increase/api/client/IncreaseClientAsync.kt

@@ -171,4 +171,17 @@ interface IncreaseClientAsync {
     fun realTimePaymentsRequestForPayments(): RealTimePaymentsRequestForPaymentServiceAsync
 
     fun simulations(): SimulationServiceAsync
+
+    /**
+     * Closes this client, relinquishing any underlying resources.
+     *
+     * This is purposefully not inherited from [AutoCloseable] because the client is long-lived and
+     * usually should not be synchronously closed via try-with-resources.
+     *
+     * It's also usually not necessary to call this method at all. the default HTTP client
+     * automatically releases threads and connections if they remain idle, but if you are writing an
+     * application that needs to aggressively release unused resources, then you may call this
+     * method.
+     */
+    fun close()
 }

increase-java-core/src/main/kotlin/com/increase/api/client/IncreaseClientAsyncImpl.kt

@@ -467,4 +467,6 @@ constructor(
     override fun webhooks(): WebhookServiceAsync = webhooks
 
     override fun simulations(): SimulationServiceAsync = simulations
+
+    override fun close() = clientOptions.httpClient.close()
 }

increase-java-core/src/main/kotlin/com/increase/api/client/IncreaseClientImpl.kt

@@ -451,4 +451,6 @@ constructor(
     override fun webhooks(): WebhookService = webhooks
 
     override fun simulations(): SimulationService = simulations
+
+    override fun close() = clientOptions.httpClient.close()
 }