@powersync/common 0.0.0-dev-20250828091657 → 0.0.0-dev-20250909205633

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/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): Promise<void>;
     /**
      * Updates the underlying query.
      */

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

@@ -34,24 +34,35 @@ 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) {
+        // Abort any previous requests
+        this.abortController.abort();
+        // Keep track of this controller's abort status
+        const abortController = new AbortController();
+        // Allow this to be aborted externally
+        this.abortController = abortController;
+        // This may have been aborted while awaiting or if multiple calls to `updateSettings` were made
+        if (abortController.signal.aborted) {
+            return;
+        }
+        this.options.watchOptions = settings;
         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: abortController.signal,
             settings
         }));
     }
+    /**
+     * Updates the underlying query.
+     */
+    async updateSettings(settings) {
+        await this.initialized;
+        return this.updateSettingsInternal(settings);
+    }
     async updateState(update) {
         if (typeof update.error !== 'undefined') {
             await this.iterateAsyncListenersWithError(async (l) => l.onError?.(update.error));
@@ -89,8 +100,8 @@ 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);
         });
     }
     async close() {

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;
                     }

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;
                     }

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": "0.0.0-dev-20250828091657",
+  "version": "0.0.0-dev-20250909205633",
   "publishConfig": {
     "registry": "https://registry.npmjs.org/",
     "access": "public"