@powersync/web 2.4.2 → 2.5.0

package/dist/index.react_native_web.js

@@ -1,7 +1,7 @@
 import { DBAdapter, LockContext, LogLevels, queryResultWithoutRows, BaseObserver } from '@powersync/common';
 export * from '@powersync/common';
 import * as Comlink from 'comlink';
-import { Mutex, ConnectionClosedError, Semaphore, LockType, AbstractRemote, AbstractStreamingSyncImplementation, BasePowerSyncDatabase, openDatabase } from '@powersync/shared-internals';
+import { Mutex, ConnectionClosedError, Semaphore, LockType, AbstractRemote, AbstractStreamingSyncImplementation, serializeErrorForRelay, BasePowerSyncDatabase, openDatabase } from '@powersync/shared-internals';
 import { Factory, SQLITE_ROW } from '@journeyapps/wa-sqlite';
 
 /**
@@ -1683,10 +1683,24 @@ class WebRemote extends AbstractRemote {
 let websockets;
 
 class WebStreamingSyncImplementation extends AbstractStreamingSyncImplementation {
+    diagnosticsChannel;
     constructor(options) {
         // Super will store and provide default values for options
         super(options);
     }
+    /**
+     * Broadcasts a core diagnostics event on a same-origin channel for diagnostics tooling to consume.
+     * The channel reaches the page even when sync runs in a shared worker.
+     */
+    emitDiagnostics(event) {
+        this.diagnosticsChannel ??= new BroadcastChannel('powersync-diagnostics-events');
+        this.diagnosticsChannel.postMessage(event);
+    }
+    async dispose() {
+        await super.dispose();
+        this.diagnosticsChannel?.close();
+        this.diagnosticsChannel = undefined;
+    }
     get webOptions() {
         return this.options;
     }
@@ -1731,11 +1745,24 @@ class SharedSyncClientProvider extends AbstractSharedSyncClientProvider {
         const { port } = await this.webDB.shareConnection();
         return Comlink.transfer(port, [port]);
     }
+    async #relay(action) {
+        try {
+            return await action();
+        }
+        catch (ex) {
+            /**
+             * Connector callbacks run in this tab and their rejection crosses the
+             * MessagePort to the sync worker, so serialize it here, where the error
+             * originates, before Comlink's error transfer can drop custom fields.
+             */
+            throw serializeErrorForRelay(ex);
+        }
+    }
     invalidateCredentials() {
         this.options.remote.invalidateCredentials();
     }
     async fetchCredentials() {
-        const credentials = await this.options.remote.getCredentials();
+        const credentials = await this.#relay(() => this.options.remote.getCredentials());
         if (credentials == null) {
             return null;
         }
@@ -1755,10 +1782,10 @@ class SharedSyncClientProvider extends AbstractSharedSyncClientProvider {
          * Don't return anything here, just incase something which is not
          * serializable is returned from the `uploadCrud` function.
          */
-        await this.options.uploadCrud();
+        await this.#relay(() => this.options.uploadCrud());
     }
     async postCheckpointRequest(clientId, requestId) {
-        return await this.options.postCheckpointRequest(clientId, requestId);
+        return await this.#relay(async () => (await this.options.postCheckpointRequest(clientId, requestId)) ?? null);
     }
     get logger() {
         return this.options.logger;
@@ -1963,6 +1990,34 @@ class TabLocalStreamingSyncImplementation extends WebStreamingSyncImplementation
     }
 }
 
+/**
+ * Live database instances in this page, for development tooling.
+ *
+ * Every {@link WebPowerSyncDatabase} registers itself when constructed and leaves when closed, so a
+ * tool that runs in the same page (for example the diagnostics Vite plugin's injected agent) can find
+ * the app's databases without the app wiring anything up. The set holds only instances that already
+ * exist, so it adds nothing to a production bundle beyond the references themselves.
+ */
+class DatabaseRegistry extends BaseObserver {
+    databases = new Set();
+    notify() {
+        const snapshot = [...this.databases];
+        this.iterateListeners((listener) => listener.databasesChanged?.(snapshot));
+    }
+}
+const registry = new DatabaseRegistry();
+/** @internal Called by the database constructor. */
+function registerDatabase(db) {
+    registry.databases.add(db);
+    registry.notify();
+}
+/** @internal Called when the database closes. */
+function unregisterDatabase(db) {
+    if (registry.databases.delete(db)) {
+        registry.notify();
+    }
+}
+
 /**
  * @internal Use {@link PowerSyncDatabase} instead, this class is only used by other SDKs also needing web support.
  */
@@ -1975,6 +2030,8 @@ class WebPowerSyncDatabase extends BasePowerSyncDatabase {
         super(options);
         this.resolvedOpenOptions = resolvedOpenOptions;
         this.enableBroadcastLogs = options.broadcastLogs ?? true;
+        // Lets development tooling in this page find the live databases.
+        registerDatabase(this);
     }
     async _initialize() {
         if (this.database instanceof AsyncDbAdapter) {
@@ -2015,11 +2072,12 @@ class WebPowerSyncDatabase extends BasePowerSyncDatabase {
      * By default the sync stream client is only disconnected if
      * multiple tabs are not enabled.
      */
-    close(options) {
-        return super.close({
+    async close(options) {
+        await super.close({
             // Don't disconnect by default if multiple tabs are enabled
             disconnect: options?.disconnect ?? !this.resolvedOpenOptions.enableMultiTabs
         });
+        unregisterDatabase(this);
     }
     async loadVersion() {
         if (this.resolvedOpenOptions.ssrMode) {