@powersync/common 0.0.0-dev-20240903063630 → 0.0.0-dev-20240920093037

package/lib/client/AbstractPowerSyncDatabase.d.ts

@@ -1,16 +1,16 @@
 import { Mutex } from 'async-mutex';
-import { ILogger } from 'js-logger';
-import { DBAdapter, QueryResult, Transaction } from '../db/DBAdapter';
-import { SyncStatus } from '../db/crud/SyncStatus';
-import { UploadQueueStats } from '../db/crud/UploadQueueStatus';
-import { Schema } from '../db/schema/Schema';
-import { BaseObserver } from '../utils/BaseObserver';
-import { SQLOpenFactory, SQLOpenOptions } from './SQLOpenFactory';
-import { PowerSyncBackendConnector } from './connection/PowerSyncBackendConnector';
-import { BucketStorageAdapter } from './sync/bucket/BucketStorageAdapter';
-import { CrudBatch } from './sync/bucket/CrudBatch';
-import { CrudTransaction } from './sync/bucket/CrudTransaction';
-import { AbstractStreamingSyncImplementation, PowerSyncConnectionOptions, StreamingSyncImplementation, StreamingSyncImplementationListener } from './sync/stream/AbstractStreamingSyncImplementation';
+import Logger, { ILogger } from 'js-logger';
+import { DBAdapter, QueryResult, Transaction } from '../db/DBAdapter.js';
+import { SyncStatus } from '../db/crud/SyncStatus.js';
+import { UploadQueueStats } from '../db/crud/UploadQueueStatus.js';
+import { Schema } from '../db/schema/Schema.js';
+import { BaseObserver } from '../utils/BaseObserver.js';
+import { SQLOpenFactory, SQLOpenOptions } from './SQLOpenFactory.js';
+import { PowerSyncBackendConnector } from './connection/PowerSyncBackendConnector.js';
+import { BucketStorageAdapter } from './sync/bucket/BucketStorageAdapter.js';
+import { CrudBatch } from './sync/bucket/CrudBatch.js';
+import { CrudTransaction } from './sync/bucket/CrudTransaction.js';
+import { PowerSyncConnectionOptions, StreamingSyncImplementation, StreamingSyncImplementationListener } from './sync/stream/AbstractStreamingSyncImplementation.js';
 export interface DisconnectAndClearOptions {
     /** When set to false, data in local-only tables is preserved. */
     clearLocal?: boolean;
@@ -87,7 +87,7 @@ export declare const DEFAULT_POWERSYNC_CLOSE_OPTIONS: PowerSyncCloseOptions;
 export declare const DEFAULT_WATCH_THROTTLE_MS = 30;
 export declare const DEFAULT_POWERSYNC_DB_OPTIONS: {
     retryDelay: number;
-    logger: ILogger;
+    logger: Logger.ILogger;
     crudUploadThrottleMs: number;
 };
 /**
@@ -132,7 +132,7 @@ export declare abstract class AbstractPowerSyncDatabase extends BaseObserver<Pow
      * Schema used for the local database.
      */
     get schema(): Schema<{
-        [x: string]: import("..").TableV2<any>;
+        [x: string]: import("../index.js").Table<any>;
     }>;
     /**
      * The underlying database.
@@ -148,7 +148,7 @@ export declare abstract class AbstractPowerSyncDatabase extends BaseObserver<Pow
      * Opens the DBAdapter given open options using a default open factory
      */
     protected abstract openDBAdapter(options: PowerSyncDatabaseOptionsWithSettings): DBAdapter;
-    protected abstract generateSyncStreamImplementation(connector: PowerSyncBackendConnector): AbstractStreamingSyncImplementation;
+    protected abstract generateSyncStreamImplementation(connector: PowerSyncBackendConnector): StreamingSyncImplementation;
     protected abstract generateBucketStorageAdapter(): BucketStorageAdapter;
     /**
      * @returns A promise which will resolve once initialization is completed.
@@ -168,6 +168,7 @@ export declare abstract class AbstractPowerSyncDatabase extends BaseObserver<Pow
      * This is to be automatically executed in the constructor.
      */
     protected initialize(): Promise<void>;
+    private _loadVersion;
     protected updateHasSynced(): Promise<void>;
     /**
      * Replace the schema with a new version. This is for advanced use cases - typically the schema should just be specified once in the constructor.
@@ -244,6 +245,12 @@ export declare abstract class AbstractPowerSyncDatabase extends BaseObserver<Pow
      * All data for the transaction is loaded into memory.
      */
     getNextCrudTransaction(): Promise<CrudTransaction | null>;
+    /**
+     * Get an unique client id for this database.
+     *
+     * The id is not reset when the database is cleared, only when the database is deleted.
+     */
+    getClientId(): Promise<string>;
     private handleCrudCheckpoint;
     /**
      * Execute a write (INSERT/UPDATE/DELETE) query

package/lib/client/AbstractPowerSyncDatabase.js

@@ -1,20 +1,19 @@
 import { Mutex } from 'async-mutex';
 import { EventIterator } from 'event-iterator';
 import Logger from 'js-logger';
-import throttle from 'lodash/throttle';
-import { isBatchedUpdateNotification } from '../db/DBAdapter';
-import { SyncStatus } from '../db/crud/SyncStatus';
-import { UploadQueueStats } from '../db/crud/UploadQueueStatus';
-import { BaseObserver } from '../utils/BaseObserver';
-import { ControlledExecutor } from '../utils/ControlledExecutor';
-import { mutexRunExclusive } from '../utils/mutex';
-import { quoteIdentifier } from '../utils/strings';
-import { isDBAdapter, isSQLOpenFactory, isSQLOpenOptions } from './SQLOpenFactory';
-import { PSInternalTable } from './sync/bucket/BucketStorageAdapter';
-import { CrudBatch } from './sync/bucket/CrudBatch';
-import { CrudEntry } from './sync/bucket/CrudEntry';
-import { CrudTransaction } from './sync/bucket/CrudTransaction';
-import { DEFAULT_CRUD_UPLOAD_THROTTLE_MS } from './sync/stream/AbstractStreamingSyncImplementation';
+import { isBatchedUpdateNotification } from '../db/DBAdapter.js';
+import { SyncStatus } from '../db/crud/SyncStatus.js';
+import { UploadQueueStats } from '../db/crud/UploadQueueStatus.js';
+import { BaseObserver } from '../utils/BaseObserver.js';
+import { ControlledExecutor } from '../utils/ControlledExecutor.js';
+import { mutexRunExclusive } from '../utils/mutex.js';
+import { throttleTrailing } from '../utils/throttle.js';
+import { isDBAdapter, isSQLOpenFactory, isSQLOpenOptions } from './SQLOpenFactory.js';
+import { PSInternalTable } from './sync/bucket/BucketStorageAdapter.js';
+import { CrudBatch } from './sync/bucket/CrudBatch.js';
+import { CrudEntry } from './sync/bucket/CrudEntry.js';
+import { CrudTransaction } from './sync/bucket/CrudTransaction.js';
+import { DEFAULT_CRUD_UPLOAD_THROTTLE_MS } from './sync/stream/AbstractStreamingSyncImplementation.js';
 const POWERSYNC_TABLE_MATCH = /(^ps_data__|^ps_data_local__)/;
 const DEFAULT_DISCONNECT_CLEAR_OPTIONS = {
     clearLocal: true
@@ -151,19 +150,41 @@ export class AbstractPowerSyncDatabase extends BaseObserver {
     async initialize() {
         await this._initialize();
         await this.bucketStorageAdapter.init();
-        const version = await this.database.execute('SELECT powersync_rs_version()');
-        this.sdkVersion = version.rows?.item(0)['powersync_rs_version()'] ?? '';
+        await this._loadVersion();
         await this.updateSchema(this.options.schema);
         await this.updateHasSynced();
         await this.database.execute('PRAGMA RECURSIVE_TRIGGERS=TRUE');
         this.ready = true;
         this.iterateListeners((cb) => cb.initialized?.());
     }
+    async _loadVersion() {
+        try {
+            const { version } = await this.database.get('SELECT powersync_rs_version() as version');
+            this.sdkVersion = version;
+        }
+        catch (e) {
+            throw new Error(`The powersync extension is not loaded correctly. Details: ${e.message}`);
+        }
+        let versionInts;
+        try {
+            versionInts = this.sdkVersion.split(/[.\/]/)
+                .slice(0, 3)
+                .map((n) => parseInt(n));
+        }
+        catch (e) {
+            throw new Error(`Unsupported powersync extension version. Need ^0.2.0, got: ${this.sdkVersion}. Details: ${e.message}`);
+        }
+        // Validate ^0.2.0
+        if (versionInts[0] != 0 || versionInts[1] != 2 || versionInts[2] < 0) {
+            throw new Error(`Unsupported powersync extension version. Need ^0.2.0, got: ${this.sdkVersion}`);
+        }
+    }
     async updateHasSynced() {
-        const result = await this.database.getOptional('SELECT 1 FROM ps_buckets WHERE last_applied_op > 0 LIMIT 1');
-        const hasSynced = !!result;
+        const result = await this.database.get('SELECT powersync_last_synced_at() as synced_at');
+        const hasSynced = result.synced_at != null;
+        const syncedAt = result.synced_at != null ? new Date(result.synced_at + 'Z') : undefined;
         if (hasSynced != this.currentStatus.hasSynced) {
-            this.currentStatus = new SyncStatus({ ...this.currentStatus.toJSON(), hasSynced });
+            this.currentStatus = new SyncStatus({ ...this.currentStatus.toJSON(), hasSynced, lastSyncedAt: syncedAt });
             this.iterateListeners((l) => l.statusChanged?.(this.currentStatus));
         }
     }
@@ -247,20 +268,7 @@ export class AbstractPowerSyncDatabase extends BaseObserver {
         const { clearLocal } = options;
         // TODO DB name, verify this is necessary with extension
         await this.database.writeTransaction(async (tx) => {
-            await tx.execute(`DELETE FROM ${PSInternalTable.OPLOG}`);
-            await tx.execute(`DELETE FROM ${PSInternalTable.CRUD}`);
-            await tx.execute(`DELETE FROM ${PSInternalTable.BUCKETS}`);
-            await tx.execute(`DELETE FROM ${PSInternalTable.UNTYPED}`);
-            const tableGlob = clearLocal ? 'ps_data_*' : 'ps_data__*';
-            const existingTableRows = await tx.execute(`
-      SELECT name FROM sqlite_master WHERE type='table' AND name GLOB ?
-      `, [tableGlob]);
-            if (!existingTableRows.rows?.length) {
-                return;
-            }
-            for (const row of existingTableRows.rows._array) {
-                await tx.execute(`DELETE FROM ${quoteIdentifier(row.name)} WHERE 1`);
-            }
+            await tx.execute('SELECT powersync_clear(?)', [clearLocal ? 1 : 0]);
         });
         // The data has been deleted - reset the sync status
         this.currentStatus = new SyncStatus({});
@@ -364,6 +372,14 @@ export class AbstractPowerSyncDatabase extends BaseObserver {
             return new CrudTransaction(all, async (writeCheckpoint) => this.handleCrudCheckpoint(last.clientId, writeCheckpoint), txId);
         });
     }
+    /**
+     * Get an unique client id for this database.
+     *
+     * The id is not reset when the database is cleared, only when the database is deleted.
+     */
+    async getClientId() {
+        return this.bucketStorageAdapter.getClientId();
+    }
     async handleCrudCheckpoint(lastClientId, writeCheckpoint) {
         return this.writeTransaction(async (tx) => {
             await tx.execute(`DELETE FROM ${PSInternalTable.CRUD} WHERE id <= ?`, [lastClientId]);
@@ -578,11 +594,11 @@ export class AbstractPowerSyncDatabase extends BaseObserver {
         const executor = new ControlledExecutor(async (e) => {
             await onChange(e);
         });
-        const flushTableUpdates = throttle(() => this.handleTableChanges(changedTables, watchedTables, (intersection) => {
+        const flushTableUpdates = throttleTrailing(() => this.handleTableChanges(changedTables, watchedTables, (intersection) => {
             if (resolvedOptions?.signal?.aborted)
                 return;
             executor.schedule({ changedTables: intersection });
-        }), throttleMs, { leading: false, trailing: true });
+        }), throttleMs);
         const dispose = this.database.registerListener({
             tablesUpdated: async (update) => {
                 try {
@@ -660,4 +676,3 @@ export class AbstractPowerSyncDatabase extends BaseObserver {
         return this.database.readLock((tx) => tx.execute(sql, params));
     }
 }
-//# sourceMappingURL=AbstractPowerSyncDatabase.js.map

package/lib/client/AbstractPowerSyncOpenFactory.d.ts

@@ -1,7 +1,7 @@
-import { DBAdapter } from '../db/DBAdapter';
-import { Schema } from '../db/schema/Schema';
-import { AbstractPowerSyncDatabase, PowerSyncDatabaseOptions } from './AbstractPowerSyncDatabase';
-import { SQLOpenOptions } from './SQLOpenFactory';
+import { DBAdapter } from '../db/DBAdapter.js';
+import { Schema } from '../db/schema/Schema.js';
+import { AbstractPowerSyncDatabase, PowerSyncDatabaseOptions } from './AbstractPowerSyncDatabase.js';
+import { SQLOpenOptions } from './SQLOpenFactory.js';
 export interface PowerSyncOpenFactoryOptions extends Partial<PowerSyncDatabaseOptions>, SQLOpenOptions {
     /** Schema used for the local database. */
     schema: Schema;
@@ -13,7 +13,7 @@ export declare abstract class AbstractPowerSyncDatabaseOpenFactory {
      * Schema used for the local database.
      */
     get schema(): Schema<{
-        [x: string]: import("..").TableV2<any>;
+        [x: string]: import("../index.js").Table<any>;
     }>;
     protected abstract openDB(): DBAdapter;
     generateOptions(): PowerSyncDatabaseOptions;

package/lib/client/AbstractPowerSyncOpenFactory.js

@@ -22,4 +22,3 @@ export class AbstractPowerSyncDatabaseOpenFactory {
         return this.generateInstance(options);
     }
 }
-//# sourceMappingURL=AbstractPowerSyncOpenFactory.js.map

package/lib/client/SQLOpenFactory.d.ts

@@ -1,4 +1,4 @@
-import { DBAdapter } from '../db/DBAdapter';
+import { DBAdapter } from '../db/DBAdapter.js';
 export interface SQLOpenOptions {
     /**
      * Filename for the database.

package/lib/client/SQLOpenFactory.js

@@ -17,4 +17,3 @@ export const isSQLOpenFactory = (test) => {
 export const isDBAdapter = (test) => {
     return typeof test?.writeTransaction == 'function';
 };
-//# sourceMappingURL=SQLOpenFactory.js.map

package/lib/client/connection/PowerSyncBackendConnector.d.ts

@@ -1,5 +1,5 @@
-import { PowerSyncCredentials } from './PowerSyncCredentials';
-import type { AbstractPowerSyncDatabase } from '../AbstractPowerSyncDatabase';
+import { PowerSyncCredentials } from './PowerSyncCredentials.js';
+import type { AbstractPowerSyncDatabase } from '../AbstractPowerSyncDatabase.js';
 export interface PowerSyncBackendConnector {
     /** Allows the PowerSync client to retrieve an authentication token from your backend
      * which is used to authenticate against the PowerSync service.

package/lib/client/connection/PowerSyncBackendConnector.js

@@ -1,2 +1 @@
 export {};
-//# sourceMappingURL=PowerSyncBackendConnector.js.map

package/lib/client/connection/PowerSyncCredentials.js

@@ -1,2 +1 @@
 export {};
-//# sourceMappingURL=PowerSyncCredentials.js.map

package/lib/client/constants.js

@@ -1,2 +1 @@
 export const MAX_OP_ID = '9223372036854775807';
-//# sourceMappingURL=constants.js.map

package/lib/client/sync/bucket/BucketStorageAdapter.d.ts

@@ -1,7 +1,7 @@
-import { BaseListener, BaseObserver, Disposable } from '../../../utils/BaseObserver';
-import { CrudBatch } from './CrudBatch';
-import { CrudEntry, OpId } from './CrudEntry';
-import { SyncDataBatch } from './SyncDataBatch';
+import { BaseListener, BaseObserver, Disposable } from '../../../utils/BaseObserver.js';
+import { CrudBatch } from './CrudBatch.js';
+import { CrudEntry, OpId } from './CrudEntry.js';
+import { SyncDataBatch } from './SyncDataBatch.js';
 export interface Checkpoint {
     last_op_id: OpId;
     buckets: BucketChecksum[];
@@ -70,4 +70,8 @@ export interface BucketStorageAdapter extends BaseObserver<BucketStorageListener
      */
     forceCompact(): Promise<void>;
     getMaxOpId(): string;
+    /**
+     * Get an unique client id.
+     */
+    getClientId(): Promise<string>;
 }

package/lib/client/sync/bucket/BucketStorageAdapter.js

@@ -6,4 +6,3 @@ export var PSInternalTable;
     PSInternalTable["OPLOG"] = "ps_oplog";
     PSInternalTable["UNTYPED"] = "ps_untyped";
 })(PSInternalTable || (PSInternalTable = {}));
-//# sourceMappingURL=BucketStorageAdapter.js.map

package/lib/client/sync/bucket/CrudBatch.d.ts

@@ -1,4 +1,4 @@
-import { CrudEntry } from './CrudEntry';
+import { CrudEntry } from './CrudEntry.js';
 /**
  * A batch of client-side changes.
  */

package/lib/client/sync/bucket/CrudBatch.js

@@ -23,4 +23,3 @@ export class CrudBatch {
         this.complete = complete;
     }
 }
-//# sourceMappingURL=CrudBatch.js.map

package/lib/client/sync/bucket/CrudEntry.js

@@ -82,4 +82,3 @@ export class CrudEntry {
         return [this.transactionId, this.clientId, this.op, this.table, this.id, this.opData];
     }
 }
-//# sourceMappingURL=CrudEntry.js.map

package/lib/client/sync/bucket/CrudTransaction.d.ts

@@ -1,5 +1,5 @@
-import { CrudBatch } from './CrudBatch';
-import { CrudEntry } from './CrudEntry';
+import { CrudBatch } from './CrudBatch.js';
+import { CrudEntry } from './CrudEntry.js';
 export declare class CrudTransaction extends CrudBatch {
     /**
      * List of client-side changes.

package/lib/client/sync/bucket/CrudTransaction.js

@@ -1,4 +1,4 @@
-import { CrudBatch } from './CrudBatch';
+import { CrudBatch } from './CrudBatch.js';
 export class CrudTransaction extends CrudBatch {
     crud;
     complete;
@@ -22,4 +22,3 @@ export class CrudTransaction extends CrudBatch {
         this.transactionId = transactionId;
     }
 }
-//# sourceMappingURL=CrudTransaction.js.map

package/lib/client/sync/bucket/OpType.js

@@ -20,4 +20,3 @@ export class OpType {
         return Object.entries(OpTypeEnum).find(([, value]) => value === this.value)[0];
     }
 }
-//# sourceMappingURL=OpType.js.map

package/lib/client/sync/bucket/OplogEntry.d.ts

@@ -1,5 +1,5 @@
-import { OpId } from './CrudEntry';
-import { OpType, OpTypeJSON } from './OpType';
+import { OpId } from './CrudEntry.js';
+import { OpType, OpTypeJSON } from './OpType.js';
 export interface OplogEntryJSON {
     checksum: number;
     data?: string;

package/lib/client/sync/bucket/OplogEntry.js

@@ -1,4 +1,4 @@
-import { OpType } from './OpType';
+import { OpType } from './OpType.js';
 export class OplogEntry {
     op_id;
     op;
@@ -31,4 +31,3 @@ export class OplogEntry {
         };
     }
 }
-//# sourceMappingURL=OplogEntry.js.map

package/lib/client/sync/bucket/SqliteBucketStorage.d.ts

@@ -1,11 +1,11 @@
 import { Mutex } from 'async-mutex';
 import { ILogger } from 'js-logger';
-import { DBAdapter, Transaction } from '../../../db/DBAdapter';
-import { BaseObserver } from '../../../utils/BaseObserver';
-import { BucketState, BucketStorageAdapter, BucketStorageListener, Checkpoint, SyncLocalDatabaseResult } from './BucketStorageAdapter';
-import { CrudBatch } from './CrudBatch';
-import { CrudEntry } from './CrudEntry';
-import { SyncDataBatch } from './SyncDataBatch';
+import { DBAdapter, Transaction } from '../../../db/DBAdapter.js';
+import { BaseObserver } from '../../../utils/BaseObserver.js';
+import { BucketState, BucketStorageAdapter, BucketStorageListener, Checkpoint, SyncLocalDatabaseResult } from './BucketStorageAdapter.js';
+import { CrudBatch } from './CrudBatch.js';
+import { CrudEntry } from './CrudEntry.js';
+import { SyncDataBatch } from './SyncDataBatch.js';
 export declare class SqliteBucketStorage extends BaseObserver<BucketStorageListener> implements BucketStorageAdapter {
     private db;
     private mutex;
@@ -14,6 +14,7 @@ export declare class SqliteBucketStorage extends BaseObserver<BucketStorageListe
     private pendingBucketDeletes;
     private _hasCompletedSync;
     private updateListener;
+    private _clientId?;
     /**
      * Count up, and do a compact on startup.
      */
@@ -21,6 +22,8 @@ export declare class SqliteBucketStorage extends BaseObserver<BucketStorageListe
     constructor(db: DBAdapter, mutex: Mutex, logger?: ILogger);
     init(): Promise<void>;
     dispose(): Promise<void>;
+    _getClientId(): Promise<string>;
+    getClientId(): Promise<string>;
     getMaxOpId(): string;
     /**
      * Reset any caches.

package/lib/client/sync/bucket/SqliteBucketStorage.js

@@ -1,9 +1,9 @@
 import Logger from 'js-logger';
-import { extractTableUpdates } from '../../../db/DBAdapter';
-import { BaseObserver } from '../../../utils/BaseObserver';
-import { PSInternalTable } from './BucketStorageAdapter';
-import { MAX_OP_ID } from '../../constants';
-import { CrudEntry } from './CrudEntry';
+import { extractTableUpdates } from '../../../db/DBAdapter.js';
+import { BaseObserver } from '../../../utils/BaseObserver.js';
+import { MAX_OP_ID } from '../../constants.js';
+import { PSInternalTable } from './BucketStorageAdapter.js';
+import { CrudEntry } from './CrudEntry.js';
 const COMPACT_OPERATION_INTERVAL = 1_000;
 export class SqliteBucketStorage extends BaseObserver {
     db;
@@ -13,6 +13,7 @@ export class SqliteBucketStorage extends BaseObserver {
     pendingBucketDeletes;
     _hasCompletedSync;
     updateListener;
+    _clientId;
     /**
      * Count up, and do a compact on startup.
      */
@@ -44,6 +45,16 @@ export class SqliteBucketStorage extends BaseObserver {
     async dispose() {
         this.updateListener?.();
     }
+    async _getClientId() {
+        const row = await this.db.get('SELECT powersync_client_id() as client_id');
+        return row['client_id'];
+    }
+    getClientId() {
+        if (this._clientId == null) {
+            this._clientId = this._getClientId();
+        }
+        return this._clientId;
+    }
     getMaxOpId() {
         return MAX_OP_ID;
     }
@@ -88,8 +99,8 @@ export class SqliteBucketStorage extends BaseObserver {
         if (this._hasCompletedSync) {
             return true;
         }
-        const r = await this.db.execute(`SELECT name, last_applied_op FROM ps_buckets WHERE last_applied_op > 0 LIMIT 1`);
-        const completed = !!r.rows?.length;
+        const r = await this.db.get(`SELECT powersync_last_synced_at() as synced_at`);
+        const completed = r.synced_at != null;
         if (completed) {
             this._hasCompletedSync = true;
         }
@@ -177,8 +188,7 @@ export class SqliteBucketStorage extends BaseObserver {
     async deletePendingBuckets() {
         if (this.pendingBucketDeletes !== false) {
             await this.writeTransaction(async (tx) => {
-                await tx.execute('DELETE FROM ps_oplog WHERE bucket IN (SELECT name FROM ps_buckets WHERE pending_delete = 1 AND last_applied_op = last_op AND last_op >= target_op)');
-                await tx.execute('DELETE FROM ps_buckets WHERE pending_delete = 1 AND last_applied_op = last_op AND last_op >= target_op');
+                await tx.execute('INSERT INTO powersync_operations(op, data) VALUES (?, ?)', ['delete_pending_buckets', '']);
             });
             // Executed once after start-up, and again when there are pending deletes.
             this.pendingBucketDeletes = false;
@@ -228,7 +238,9 @@ export class SqliteBucketStorage extends BaseObserver {
                 // New crud data may have been uploaded since we got the checkpoint. Abort.
                 return false;
             }
-            const response = await tx.execute("UPDATE ps_buckets SET target_op = ? WHERE name='$local'", [opId]);
+            const response = await tx.execute("UPDATE ps_buckets SET target_op = CAST(? as INTEGER) WHERE name='$local'", [
+                opId
+            ]);
             this.logger.debug(['[updateLocalTarget] Response from updating target_op ', JSON.stringify(response)]);
             return true;
         });
@@ -270,11 +282,15 @@ export class SqliteBucketStorage extends BaseObserver {
                     if (writeCheckpoint) {
                         const crudResult = await tx.execute('SELECT 1 FROM ps_crud LIMIT 1');
                         if (crudResult.rows?.length) {
-                            await tx.execute("UPDATE ps_buckets SET target_op = ? WHERE name='$local'", [writeCheckpoint]);
+                            await tx.execute("UPDATE ps_buckets SET target_op = CAST(? as INTEGER) WHERE name='$local'", [
+                                writeCheckpoint
+                            ]);
                         }
                     }
                     else {
-                        await tx.execute("UPDATE ps_buckets SET target_op = ? WHERE name='$local'", [this.getMaxOpId()]);
+                        await tx.execute("UPDATE ps_buckets SET target_op = CAST(? as INTEGER) WHERE name='$local'", [
+                            this.getMaxOpId()
+                        ]);
                     }
                 });
             }
@@ -290,4 +306,3 @@ export class SqliteBucketStorage extends BaseObserver {
         // No-op for now
     }
 }
-//# sourceMappingURL=SqliteBucketStorage.js.map

package/lib/client/sync/bucket/SyncDataBatch.d.ts

@@ -1,4 +1,4 @@
-import { SyncDataBucket } from './SyncDataBucket';
+import { SyncDataBucket } from './SyncDataBucket.js';
 export declare class SyncDataBatch {
     buckets: SyncDataBucket[];
     static fromJSON(json: any): SyncDataBatch;

package/lib/client/sync/bucket/SyncDataBatch.js

@@ -1,4 +1,4 @@
-import { SyncDataBucket } from './SyncDataBucket';
+import { SyncDataBucket } from './SyncDataBucket.js';
 // TODO JSON
 export class SyncDataBatch {
     buckets;
@@ -9,4 +9,3 @@ export class SyncDataBatch {
         this.buckets = buckets;
     }
 }
-//# sourceMappingURL=SyncDataBatch.js.map

package/lib/client/sync/bucket/SyncDataBucket.d.ts

@@ -1,5 +1,5 @@
-import { OpId } from './CrudEntry';
-import { OplogEntry, OplogEntryJSON } from './OplogEntry';
+import { OpId } from './CrudEntry.js';
+import { OplogEntry, OplogEntryJSON } from './OplogEntry.js';
 export type SyncDataBucketJSON = {
     bucket: string;
     has_more?: boolean;

package/lib/client/sync/bucket/SyncDataBucket.js

@@ -1,4 +1,4 @@
-import { OplogEntry } from './OplogEntry';
+import { OplogEntry } from './OplogEntry.js';
 export class SyncDataBucket {
     bucket;
     data;
@@ -37,4 +37,3 @@ export class SyncDataBucket {
         };
     }
 }
-//# sourceMappingURL=SyncDataBucket.js.map

package/lib/client/sync/stream/AbstractRemote.d.ts

@@ -1,14 +1,14 @@
-import { ILogger } from 'js-logger';
-import { type fetch } from 'cross-fetch';
-import { PowerSyncCredentials } from '../../connection/PowerSyncCredentials';
-import { StreamingSyncLine, StreamingSyncRequest } from './streaming-sync-types';
-import { DataStream } from '../../../utils/DataStream';
 import type { BSON } from 'bson';
+import { type fetch } from 'cross-fetch';
+import Logger, { ILogger } from 'js-logger';
+import { DataStream } from '../../../utils/DataStream.js';
+import { PowerSyncCredentials } from '../../connection/PowerSyncCredentials.js';
+import { StreamingSyncLine, StreamingSyncRequest } from './streaming-sync-types.js';
 export type BSONImplementation = typeof BSON;
 export type RemoteConnector = {
     fetchCredentials: () => Promise<PowerSyncCredentials | null>;
 };
-export declare const DEFAULT_REMOTE_LOGGER: ILogger;
+export declare const DEFAULT_REMOTE_LOGGER: Logger.ILogger;
 export type SyncStreamOptions = {
     path: string;
     data: StreamingSyncRequest;
@@ -53,11 +53,13 @@ export declare abstract class AbstractRemote {
      */
     get fetch(): FetchImplementation;
     getCredentials(): Promise<PowerSyncCredentials | null>;
+    getUserAgent(): string;
     protected buildRequest(path: string): Promise<{
         url: string;
         headers: {
             'content-type': string;
             Authorization: string;
+            'x-user-agent': string;
         };
     }>;
     post(path: string, data: any, headers?: Record<string, string>): Promise<any>;

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

@@ -1,10 +1,11 @@
-import Logger from 'js-logger';
-import { DataStream } from '../../../utils/DataStream';
+import { Buffer } from 'buffer';
 import ndjsonStream from 'can-ndjson-stream';
+import Logger from 'js-logger';
 import { RSocketConnector } from 'rsocket-core';
 import { WebsocketClientTransport } from 'rsocket-websocket-client';
-import { AbortOperation } from '../../../utils/AbortOperation';
-import { Buffer } from 'buffer';
+import { AbortOperation } from '../../../utils/AbortOperation.js';
+import { DataStream } from '../../../utils/DataStream.js';
+import { version as POWERSYNC_JS_VERSION } from '../../../../package.json';
 // Refresh at least 30 sec before it expires
 const REFRESH_CREDENTIALS_SAFETY_PERIOD_MS = 30_000;
 const SYNC_QUEUE_REQUEST_N = 10;
@@ -62,6 +63,9 @@ export class AbstractRemote {
         this.credentials = await this.connector.fetchCredentials();
         return this.credentials;
     }
+    getUserAgent() {
+        return `powersync-js/${POWERSYNC_JS_VERSION}`;
+    }
     async buildRequest(path) {
         const credentials = await this.getCredentials();
         if (credentials != null && (credentials.endpoint == null || credentials.endpoint == '')) {
@@ -72,11 +76,13 @@ export class AbstractRemote {
             error.status = 401;
             throw error;
         }
+        const userAgent = this.getUserAgent();
         return {
             url: credentials.endpoint + path,
             headers: {
                 'content-type': 'application/json',
-                Authorization: `Token ${credentials.token}`
+                Authorization: `Token ${credentials.token}`,
+                'x-user-agent': userAgent
             }
         };
     }
@@ -137,6 +143,10 @@ export class AbstractRemote {
         const { path } = options;
         const request = await this.buildRequest(path);
         const bson = await this.getBSON();
+        // Add the user agent in the setup payload - we can't set custom
+        // headers with websockets on web. The browser userAgent is however added
+        // automatically as a header.
+        const userAgent = this.getUserAgent();
         const connector = new RSocketConnector({
             transport: new WebsocketClientTransport({
                 url: this.options.socketUrlTransformer(request.url)
@@ -149,7 +159,8 @@ export class AbstractRemote {
                 payload: {
                     data: null,
                     metadata: Buffer.from(bson.serialize({
-                        token: request.headers.Authorization
+                        token: request.headers.Authorization,
+                        user_agent: userAgent
                     }))
                 }
             }
@@ -383,4 +394,3 @@ export class AbstractRemote {
         return stream;
     }
 }
-//# sourceMappingURL=AbstractRemote.js.map