@powersync/common 0.0.0-dev-20250915110424 → 0.0.0-dev-20250916075127

package/dist/index.d.cts

@@ -1815,12 +1815,14 @@ declare enum WatchedQueryListenerEvent {
     ON_DATA = "onData",
     ON_ERROR = "onError",
     ON_STATE_CHANGE = "onStateChange",
+    SETTINGS_WILL_UPDATE = "settingsWillUpdate",
     CLOSED = "closed"
 }
 interface WatchedQueryListener<Data> extends BaseListener {
     [WatchedQueryListenerEvent.ON_DATA]?: (data: Data) => void | Promise<void>;
     [WatchedQueryListenerEvent.ON_ERROR]?: (error: Error) => void | Promise<void>;
     [WatchedQueryListenerEvent.ON_STATE_CHANGE]?: (state: WatchedQueryState<Data>) => void | Promise<void>;
+    [WatchedQueryListenerEvent.SETTINGS_WILL_UPDATE]?: () => void;
     [WatchedQueryListenerEvent.CLOSED]?: () => void | Promise<void>;
 }
 declare const DEFAULT_WATCH_THROTTLE_MS = 30;
@@ -1900,7 +1902,7 @@ declare abstract class AbstractQueryProcessor<Data = unknown[], Settings extends
     /**
      * Configures base DB listeners and links the query to listeners.
      */
-    protected init(): Promise<void>;
+    protected init(signal: AbortSignal): Promise<void>;
     close(): Promise<void>;
     /**
      * Runs a callback and reports errors to the error listeners.

package/lib/client/watched/WatchedQuery.d.ts

@@ -65,12 +65,14 @@ export declare enum WatchedQueryListenerEvent {
     ON_DATA = "onData",
     ON_ERROR = "onError",
     ON_STATE_CHANGE = "onStateChange",
+    SETTINGS_WILL_UPDATE = "settingsWillUpdate",
     CLOSED = "closed"
 }
 export interface WatchedQueryListener<Data> extends BaseListener {
     [WatchedQueryListenerEvent.ON_DATA]?: (data: Data) => void | Promise<void>;
     [WatchedQueryListenerEvent.ON_ERROR]?: (error: Error) => void | Promise<void>;
     [WatchedQueryListenerEvent.ON_STATE_CHANGE]?: (state: WatchedQueryState<Data>) => void | Promise<void>;
+    [WatchedQueryListenerEvent.SETTINGS_WILL_UPDATE]?: () => void;
     [WatchedQueryListenerEvent.CLOSED]?: () => void | Promise<void>;
 }
 export declare const DEFAULT_WATCH_THROTTLE_MS = 30;

package/lib/client/watched/WatchedQuery.js

@@ -3,6 +3,7 @@ export var WatchedQueryListenerEvent;
     WatchedQueryListenerEvent["ON_DATA"] = "onData";
     WatchedQueryListenerEvent["ON_ERROR"] = "onError";
     WatchedQueryListenerEvent["ON_STATE_CHANGE"] = "onStateChange";
+    WatchedQueryListenerEvent["SETTINGS_WILL_UPDATE"] = "settingsWillUpdate";
     WatchedQueryListenerEvent["CLOSED"] = "closed";
 })(WatchedQueryListenerEvent || (WatchedQueryListenerEvent = {}));
 export const DEFAULT_WATCH_THROTTLE_MS = 30;

package/lib/client/watched/processors/AbstractQueryProcessor.d.ts

@@ -54,7 +54,7 @@ export declare abstract class AbstractQueryProcessor<Data = unknown[], Settings
     /**
      * Configures base DB listeners and links the query to listeners.
      */
-    protected init(): Promise<void>;
+    protected init(signal: AbortSignal): Promise<void>;
     close(): Promise<void>;
     /**
      * Runs a callback and reports errors to the error listeners.

package/lib/client/watched/processors/AbstractQueryProcessor.js

@@ -1,4 +1,5 @@
 import { MetaBaseObserver } from '../../../utils/MetaBaseObserver.js';
+import { WatchedQueryListenerEvent } from '../WatchedQuery.js';
 /**
  * Performs underlying watching and yields a stream of results.
  * @internal
@@ -20,7 +21,7 @@ export class AbstractQueryProcessor extends MetaBaseObserver {
         this._closed = false;
         this.state = this.constructInitialState();
         this.disposeListeners = null;
-        this.initialized = this.init();
+        this.initialized = this.init(this.abortController.signal);
     }
     constructInitialState() {
         return {
@@ -36,10 +37,11 @@ export class AbstractQueryProcessor extends MetaBaseObserver {
     }
     async updateSettingsInternal(settings, signal) {
         // This may have been aborted while awaiting or if multiple calls to `updateSettings` were made
-        if (signal.aborted) {
+        if (this._closed || signal.aborted) {
             return;
         }
         this.options.watchOptions = settings;
+        this.iterateListeners((l) => l[WatchedQueryListenerEvent.SETTINGS_WILL_UPDATE]?.());
         if (!this.state.isFetching && this.reportFetching) {
             await this.updateState({
                 isFetching: true
@@ -54,7 +56,7 @@ export class AbstractQueryProcessor extends MetaBaseObserver {
      * Updates the underlying query.
      */
     async updateSettings(settings) {
-        // Abort any previous requests
+        // Abort the previous request
         this.abortController.abort();
         // Keep track of this controller's abort status
         const abortController = new AbortController();
@@ -64,6 +66,9 @@ export class AbstractQueryProcessor extends MetaBaseObserver {
         return this.updateSettingsInternal(settings, abortController.signal);
     }
     async updateState(update) {
+        if (this._closed) {
+            return;
+        }
         if (typeof update.error !== 'undefined') {
             await this.iterateAsyncListenersWithError(async (l) => l.onError?.(update.error));
             // An error always stops for the current fetching state
@@ -79,7 +84,7 @@ export class AbstractQueryProcessor extends MetaBaseObserver {
     /**
      * Configures base DB listeners and links the query to listeners.
      */
-    async init() {
+    async init(signal) {
         const { db } = this.options;
         const disposeCloseListener = db.registerListener({
             closing: async () => {
@@ -101,15 +106,14 @@ export class AbstractQueryProcessor extends MetaBaseObserver {
         };
         // Initial setup
         await this.runWithReporting(async () => {
-            await this.updateSettingsInternal(this.options.watchOptions, this.abortController.signal);
+            await this.updateSettingsInternal(this.options.watchOptions, signal);
         });
     }
     async close() {
-        await this.initialized;
+        this._closed = true;
         this.abortController.abort();
         this.disposeListeners?.();
         this.disposeListeners = null;
-        this._closed = true;
         this.iterateListeners((l) => l.closed?.());
         this.listeners.clear();
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@powersync/common",
-  "version": "0.0.0-dev-20250915110424",
+  "version": "0.0.0-dev-20250916075127",
   "publishConfig": {
     "registry": "https://registry.npmjs.org/",
     "access": "public"