[Fix] OPFS Sleeping Tabs Sync Deadlock

.changeset/tidy-stingrays-fold.md

@@ -0,0 +1,5 @@
+---
+'@powersync/web': minor
+---
+
+Ensured OPFS tabs are not frozen or put to sleep by browsers. This prevents potential deadlocks in the syncing process.

packages/web/src/db/adapters/WorkerWrappedAsyncDatabaseConnection.ts

@@ -29,7 +29,11 @@ export type WrappedWorkerConnectionOptions<Config extends ResolvedWebSQLOpenOpti
 export class WorkerWrappedAsyncDatabaseConnection<Config extends ResolvedWebSQLOpenOptions = ResolvedWebSQLOpenOptions>
   implements AsyncDatabaseConnection
 {
-  constructor(protected options: WrappedWorkerConnectionOptions<Config>) {}
+  protected lockAbortController: AbortController;
+
+  constructor(protected options: WrappedWorkerConnectionOptions<Config>) {
+    this.lockAbortController = new AbortController();
+  }
 
   protected get baseConnection() {
     return this.options.baseConnection;
@@ -44,6 +48,39 @@ export class WorkerWrappedAsyncDatabaseConnection<Config extends ResolvedWebSQLO
    */
   async shareConnection(): Promise<SharedConnectionWorker> {
     const { identifier, remote } = this.options;
+    /**
+     * Hold a navigator lock in order to avoid features such as Chrome's frozen tabs,
+     * or Edge's sleeping tabs from pausing the thread for this connection.
+     * This promise resolves once a lock is obtained.
+     * This lock will be held as long as this connection is open.
+     * The `shareConnection` method should not be called on multiple tabs concurrently.
+     */
+    await new Promise<void>((lockObtained) =>
+      navigator.locks
+        .request(
+          `shared-connection-${this.options.identifier}`,
+          {
+            signal: this.lockAbortController.signal
+          },
+          async () => {
+            lockObtained();
+
+            // Free the lock when the connection is already closed.
+            if (this.lockAbortController.signal.aborted) {
+              return;
+            }
+
+            // Hold the lock while the shared connection is in use.
+            await new Promise<void>((releaseLock) => {
+              this.lockAbortController.signal.addEventListener('abort', () => {
+                releaseLock();
+              });
+            });
+          }
+        )
+        // We aren't concerned with errors here
+        .catch(() => {})
+    );
 
     const newPort = await remote[Comlink.createEndpoint]();
     return { port: newPort, identifier };
@@ -58,6 +95,8 @@ export class WorkerWrappedAsyncDatabaseConnection<Config extends ResolvedWebSQLO
   }
 
   async close(): Promise<void> {
+    // Abort any pending lock requests.
+    this.lockAbortController.abort();
     await this.baseConnection.close();
     this.options.remote[Comlink.releaseProxy]();
     this.options.onClose?.();