@powersync/common 1.37.0 → 1.38.1

package/lib/client/AbstractPowerSyncDatabase.js

@@ -223,11 +223,11 @@ export class AbstractPowerSyncDatabase extends BaseObserver {
                 .map((n) => parseInt(n));
         }
         catch (e) {
-            throw new Error(`Unsupported powersync extension version. Need >=0.3.11 <1.0.0, got: ${this.sdkVersion}. Details: ${e.message}`);
+            throw new Error(`Unsupported powersync extension version. Need >=0.4.5 <1.0.0, got: ${this.sdkVersion}. Details: ${e.message}`);
         }
-        // Validate >=0.3.11 <1.0.0
-        if (versionInts[0] != 0 || versionInts[1] < 3 || (versionInts[1] == 3 && versionInts[2] < 11)) {
-            throw new Error(`Unsupported powersync extension version. Need >=0.3.11 <1.0.0, got: ${this.sdkVersion}`);
+        // Validate >=0.4.5 <1.0.0
+        if (versionInts[0] != 0 || versionInts[1] < 4 || (versionInts[1] == 4 && versionInts[2] < 5)) {
+            throw new Error(`Unsupported powersync extension version. Need >=0.4.5 <1.0.0, got: ${this.sdkVersion}`);
         }
     }
     async updateHasSynced() {

package/lib/client/sync/stream/AbstractStreamingSyncImplementation.js

@@ -439,7 +439,9 @@ The next upload iteration will be delayed.`);
                     ...DEFAULT_STREAM_CONNECTION_OPTIONS,
                     ...(options ?? {})
                 };
-                if (resolvedOptions.clientImplementation == SyncClientImplementation.JAVASCRIPT) {
+                const clientImplementation = resolvedOptions.clientImplementation;
+                this.updateSyncStatus({ clientImplementation });
+                if (clientImplementation == SyncClientImplementation.JAVASCRIPT) {
                     await this.legacyStreamingSyncIteration(signal, resolvedOptions);
                 }
                 else {
@@ -937,7 +939,8 @@ The next upload iteration will be delayed.`);
                 ...this.syncStatus.dataFlowStatus,
                 ...options.dataFlow
             },
-            priorityStatusEntries: options.priorityStatusEntries ?? this.syncStatus.priorityStatusEntries
+            priorityStatusEntries: options.priorityStatusEntries ?? this.syncStatus.priorityStatusEntries,
+            clientImplementation: options.clientImplementation ?? this.syncStatus.clientImplementation
         });
         if (!this.syncStatus.isEqual(updatedStatus)) {
             this.syncStatus = updatedStatus;

package/lib/client/triggers/TriggerManager.d.ts

@@ -323,7 +323,7 @@ export interface TriggerManager {
      *        },
      *        onChange: async (context) => {
      *          // Fetches the todo records that were inserted during this diff
-     *          const newTodos = await context.getAll<Database['todos']>(`
+     *          const newTodos = await context.withDiff<Database['todos']>(`
      *            SELECT
      *              todos.*
      *            FROM

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

@@ -40,6 +40,7 @@ export declare abstract class AbstractQueryProcessor<Data = unknown[], Settings
     constructor(options: AbstractQueryProcessorOptions<Data, Settings>);
     protected constructInitialState(): WatchedQueryState<Data>;
     protected get reportFetching(): boolean;
+    protected updateSettingsInternal(settings: Settings, signal: AbortSignal): Promise<void>;
     /**
      * Updates the underlying query.
      */
@@ -53,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 {
@@ -34,25 +35,40 @@ export class AbstractQueryProcessor extends MetaBaseObserver {
     get reportFetching() {
         return this.options.watchOptions.reportFetching ?? true;
     }
-    /**
-     * Updates the underlying query.
-     */
-    async updateSettings(settings) {
-        await this.initialized;
+    async updateSettingsInternal(settings, signal) {
+        // This may have been aborted while awaiting or if multiple calls to `updateSettings` were made
+        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
             });
         }
-        this.options.watchOptions = settings;
-        this.abortController.abort();
-        this.abortController = new AbortController();
         await this.runWithReporting(() => this.linkQuery({
-            abortSignal: this.abortController.signal,
+            abortSignal: signal,
             settings
         }));
     }
+    /**
+     * Updates the underlying query.
+     */
+    async updateSettings(settings) {
+        // Abort the previous request
+        this.abortController.abort();
+        // Keep track of this controller's abort status
+        const abortController = new AbortController();
+        // Allow this to be aborted externally
+        this.abortController = abortController;
+        await this.initialized;
+        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
@@ -68,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 () => {
@@ -89,16 +105,15 @@ export class AbstractQueryProcessor extends MetaBaseObserver {
             disposeSchemaListener();
         };
         // Initial setup
-        this.runWithReporting(async () => {
-            await this.updateSettings(this.options.watchOptions);
+        await this.runWithReporting(async () => {
+            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/lib/client/watched/processors/DifferentialQueryProcessor.js

@@ -113,7 +113,7 @@ export class DifferentialQueryProcessor extends AbstractQueryProcessor {
         });
         db.onChangeWithCallback({
             onChange: async () => {
-                if (this.closed) {
+                if (this.closed || abortSignal.aborted) {
                     return;
                 }
                 // This fires for each change of the relevant tables
@@ -130,6 +130,9 @@ export class DifferentialQueryProcessor extends AbstractQueryProcessor {
                         parameters: [...compiledQuery.parameters],
                         db: this.options.db
                     });
+                    if (abortSignal.aborted) {
+                        return;
+                    }
                     if (this.reportFetching) {
                         partialStateUpdate.isFetching = false;
                     }
@@ -145,6 +148,9 @@ export class DifferentialQueryProcessor extends AbstractQueryProcessor {
                             data: diff.all
                         });
                     }
+                    if (this.state.error) {
+                        partialStateUpdate.error = null;
+                    }
                     if (Object.keys(partialStateUpdate).length > 0) {
                         await this.updateState(partialStateUpdate);
                     }

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

@@ -26,7 +26,7 @@ export class OnChangeQueryProcessor extends AbstractQueryProcessor {
         });
         db.onChangeWithCallback({
             onChange: async () => {
-                if (this.closed) {
+                if (this.closed || abortSignal.aborted) {
                     return;
                 }
                 // This fires for each change of the relevant tables
@@ -43,6 +43,9 @@ export class OnChangeQueryProcessor extends AbstractQueryProcessor {
                         parameters: [...compiledQuery.parameters],
                         db: this.options.db
                     });
+                    if (abortSignal.aborted) {
+                        return;
+                    }
                     if (this.reportFetching) {
                         partialStateUpdate.isFetching = false;
                     }
@@ -55,6 +58,9 @@ export class OnChangeQueryProcessor extends AbstractQueryProcessor {
                             data: result
                         });
                     }
+                    if (this.state.error) {
+                        partialStateUpdate.error = null;
+                    }
                     if (Object.keys(partialStateUpdate).length > 0) {
                         await this.updateState(partialStateUpdate);
                     }

package/lib/db/crud/SyncStatus.d.ts

@@ -1,3 +1,4 @@
+import { SyncClientImplementation } from '../../client/sync/stream/AbstractStreamingSyncImplementation.js';
 import { InternalProgressInformation, SyncProgress } from './SyncProgress.js';
 export type SyncDataFlowStatus = Partial<{
     downloading: boolean;
@@ -32,10 +33,18 @@ export type SyncStatusOptions = {
     lastSyncedAt?: Date;
     hasSynced?: boolean;
     priorityStatusEntries?: SyncPriorityStatus[];
+    clientImplementation?: SyncClientImplementation;
 };
 export declare class SyncStatus {
     protected options: SyncStatusOptions;
     constructor(options: SyncStatusOptions);
+    /**
+     * Returns the used sync client implementation (either the one implemented in JavaScript or the newer Rust-based
+     * implementation).
+     *
+     * This information is only available after a connection has been requested.
+     */
+    get clientImplementation(): SyncClientImplementation | undefined;
     /**
      * Indicates if the client is currently connected to the PowerSync service.
      *

package/lib/db/crud/SyncStatus.js

@@ -4,6 +4,15 @@ export class SyncStatus {
     constructor(options) {
         this.options = options;
     }
+    /**
+     * Returns the used sync client implementation (either the one implemented in JavaScript or the newer Rust-based
+     * implementation).
+     *
+     * This information is only available after a connection has been requested.
+     */
+    get clientImplementation() {
+        return this.options.clientImplementation;
+    }
     /**
      * Indicates if the client is currently connected to the PowerSync service.
      *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@powersync/common",
-  "version": "1.37.0",
+  "version": "1.38.1",
   "publishConfig": {
     "registry": "https://registry.npmjs.org/",
     "access": "public"