chore(internal): add async lock helper

Author: stainless-app[bot]

onebusaway-sdk-java-core/src/main/kotlin/org/onebusaway/core/Utils.kt

@@ -4,6 +4,8 @@ package org.onebusaway.core
 
 import java.util.Collections
 import java.util.SortedMap
+import java.util.concurrent.CompletableFuture
+import java.util.concurrent.locks.Lock
 import org.onebusaway.errors.OnebusawaySdkInvalidDataException
 
 @JvmSynthetic
@@ -90,3 +92,24 @@ internal fun Any?.contentToString(): String {
 }
 
 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
+}