chore(internal): add async lock helper

Author: stainless-app[bot]

finch-java-core/src/main/kotlin/com/tryfinch/api/core/Utils.kt

@@ -6,6 +6,8 @@ import com.tryfinch.api.core.http.Headers
 import com.tryfinch.api.errors.FinchInvalidDataException
 import java.util.Collections
 import java.util.SortedMap
+import java.util.concurrent.CompletableFuture
+import java.util.concurrent.locks.Lock
 
 @JvmSynthetic
 internal fun <T : Any> T?.getOrThrow(name: String): T =
@@ -95,3 +97,24 @@ internal fun Headers.getRequiredHeader(name: String): String =
     values(name).firstOrNull() ?: throw FinchInvalidDataException("Could not find $name header")
 
 internal interface Enum
+
+/**
+ * Executes the given [action] while holding the lock, returning a [CompletableFuture] with the
+ * result.
+ *
+ * @param action The asynchronous action to execute while holding the lock
+ * @return A [CompletableFuture] that completes with the result of the action
+ */
+@JvmSynthetic
+internal fun <T> Lock.withLockAsync(action: () -> CompletableFuture<T>): CompletableFuture<T> {
+    lock()
+    val future =
+        try {
+            action()
+        } catch (e: Throwable) {
+            unlock()
+            throw e
+        }
+    future.whenComplete { _, _ -> unlock() }
+    return future
+}