@powersync/common 0.0.0-dev-20260202162549 → 0.0.0-dev-20260216124709

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

@@ -0,0 +1,110 @@
+/**
+ * Type of local change.
+ */
+export var UpdateType;
+(function (UpdateType) {
+    /** Insert or replace existing row. All non-null columns are included in the data. Generated by INSERT statements. */
+    UpdateType["PUT"] = "PUT";
+    /** Update existing row. Contains the id, and value of each changed column. Generated by UPDATE statements. */
+    UpdateType["PATCH"] = "PATCH";
+    /** Delete existing row. Contains the id. Generated by DELETE statements. */
+    UpdateType["DELETE"] = "DELETE";
+})(UpdateType || (UpdateType = {}));
+/**
+ * A single client-side change.
+ */
+export class CrudEntry {
+    /**
+     * Auto-incrementing client-side id.
+     */
+    clientId;
+    /**
+     * ID of the changed row.
+     */
+    id;
+    /**
+     * Type of change.
+     */
+    op;
+    /**
+     * Data associated with the change.
+     */
+    opData;
+    /**
+     * For tables where the `trackPreviousValues` option has been enabled, this tracks previous values for
+     * `UPDATE` and `DELETE` statements.
+     */
+    previousValues;
+    /**
+     * Table that contained the change.
+     */
+    table;
+    /**
+     * Auto-incrementing transaction id. This is the same for all operations within the same transaction.
+     */
+    transactionId;
+    /**
+     * Client-side metadata attached with this write.
+     *
+     * This field is only available when the `trackMetadata` option was set to `true` when creating a table
+     * and the insert or update statement set the `_metadata` column.
+     */
+    metadata;
+    static fromRow(dbRow) {
+        const data = JSON.parse(dbRow.data);
+        return new CrudEntry(parseInt(dbRow.id), data.op, data.type, data.id, dbRow.tx_id, data.data, data.old, data.metadata);
+    }
+    constructor(clientId, op, table, id, transactionId, opData, previousValues, metadata) {
+        this.clientId = clientId;
+        this.id = id;
+        this.op = op;
+        this.opData = opData;
+        this.table = table;
+        this.transactionId = transactionId;
+        this.previousValues = previousValues;
+        this.metadata = metadata;
+    }
+    /**
+     * Converts the change to JSON format.
+     */
+    toJSON() {
+        return {
+            op_id: this.clientId,
+            op: this.op,
+            type: this.table,
+            id: this.id,
+            tx_id: this.transactionId,
+            data: this.opData,
+            old: this.previousValues,
+            metadata: this.metadata
+        };
+    }
+    equals(entry) {
+        return JSON.stringify(this.toComparisonArray()) == JSON.stringify(entry.toComparisonArray());
+    }
+    /**
+     * The hash code for this object.
+     * @deprecated This should not be necessary in the JS SDK.
+     * Use the  @see CrudEntry#equals method instead.
+     * TODO remove in the next major release.
+     */
+    hashCode() {
+        return JSON.stringify(this.toComparisonArray());
+    }
+    /**
+     * Generates an array for use in deep comparison operations
+     */
+    toComparisonArray() {
+        return [
+            this.transactionId,
+            this.clientId,
+            this.op,
+            this.table,
+            this.id,
+            this.opData,
+            this.previousValues,
+            this.metadata
+        ];
+    }
+}
+//# sourceMappingURL=CrudEntry.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CrudEntry.js","sourceRoot":"","sources":["../../../../src/client/sync/bucket/CrudEntry.ts"],"names":[],"mappings":"AAOA;;GAEG;AACH,MAAM,CAAN,IAAY,UAOX;AAPD,WAAY,UAAU;IACpB,qHAAqH;IACrH,yBAAW,CAAA;IACX,8GAA8G;IAC9G,6BAAe,CAAA;IACf,4EAA4E;IAC5E,+BAAiB,CAAA;AACnB,CAAC,EAPW,UAAU,KAAV,UAAU,QAOrB;AA+BD;;GAEG;AACH,MAAM,OAAO,SAAS;IACpB;;OAEG;IACH,QAAQ,CAAS;IACjB;;OAEG;IACH,EAAE,CAAS;IACX;;OAEG;IACH,EAAE,CAAa;IACf;;OAEG;IACH,MAAM,CAAuB;IAE7B;;;OAGG;IACH,cAAc,CAAuB;IAErC;;OAEG;IACH,KAAK,CAAS;IACd;;OAEG;IACH,aAAa,CAAU;IAEvB;;;;;OAKG;IACH,QAAQ,CAAU;IAElB,MAAM,CAAC,OAAO,CAAC,KAAoB;QACjC,MAAM,IAAI,GAAsB,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACvD,OAAO,IAAI,SAAS,CAClB,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,EAClB,IAAI,CAAC,EAAE,EACP,IAAI,CAAC,IAAI,EACT,IAAI,CAAC,EAAE,EACP,KAAK,CAAC,KAAK,EACX,IAAI,CAAC,IAAI,EACT,IAAI,CAAC,GAAG,EACR,IAAI,CAAC,QAAQ,CACd,CAAC;IACJ,CAAC;IAED,YACE,QAAgB,EAChB,EAAc,EACd,KAAa,EACb,EAAU,EACV,aAAsB,EACtB,MAA4B,EAC5B,cAAoC,EACpC,QAAiB;QAEjB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;QACnC,IAAI,CAAC,cAAc,GAAG,cAAc,CAAC;QACrC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,MAAM;QACJ,OAAO;YACL,KAAK,EAAE,IAAI,CAAC,QAAQ;YACpB,EAAE,EAAE,IAAI,CAAC,EAAE;YACX,IAAI,EAAE,IAAI,CAAC,KAAK;YAChB,EAAE,EAAE,IAAI,CAAC,EAAE;YACX,KAAK,EAAE,IAAI,CAAC,aAAa;YACzB,IAAI,EAAE,IAAI,CAAC,MAAM;YACjB,GAAG,EAAE,IAAI,CAAC,cAAc;YACxB,QAAQ,EAAE,IAAI,CAAC,QAAQ;SACxB,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,KAAgB;QACrB,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,iBAAiB,EAAE,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,iBAAiB,EAAE,CAAC,CAAC;IAC/F,CAAC;IAED;;;;;OAKG;IACH,QAAQ;QACN,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,iBAAiB,EAAE,CAAC,CAAC;IAClD,CAAC;IAED;;OAEG;IACH,iBAAiB;QACf,OAAO;YACL,IAAI,CAAC,aAAa;YAClB,IAAI,CAAC,QAAQ;YACb,IAAI,CAAC,EAAE;YACP,IAAI,CAAC,KAAK;YACV,IAAI,CAAC,EAAE;YACP,IAAI,CAAC,MAAM;YACX,IAAI,CAAC,cAAc;YACnB,IAAI,CAAC,QAAQ;SACd,CAAC;IACJ,CAAC;CACF"}

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

@@ -0,0 +1,29 @@
+import { CrudBatch } from './CrudBatch.js';
+import { CrudEntry } from './CrudEntry.js';
+export declare class CrudTransaction extends CrudBatch {
+    /**
+     * List of client-side changes.
+     */
+    crud: CrudEntry[];
+    /**
+     * Call to remove the changes from the local queue, once successfully uploaded.
+     */
+    complete: (checkpoint?: string) => Promise<void>;
+    /**
+     * If null, this contains a list of changes recorded without an explicit transaction associated.
+     */
+    transactionId?: number | undefined;
+    constructor(
+    /**
+     * List of client-side changes.
+     */
+    crud: CrudEntry[], 
+    /**
+     * Call to remove the changes from the local queue, once successfully uploaded.
+     */
+    complete: (checkpoint?: string) => Promise<void>, 
+    /**
+     * If null, this contains a list of changes recorded without an explicit transaction associated.
+     */
+    transactionId?: number | undefined);
+}

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

@@ -0,0 +1,25 @@
+import { CrudBatch } from './CrudBatch.js';
+export class CrudTransaction extends CrudBatch {
+    crud;
+    complete;
+    transactionId;
+    constructor(
+    /**
+     * List of client-side changes.
+     */
+    crud, 
+    /**
+     * Call to remove the changes from the local queue, once successfully uploaded.
+     */
+    complete, 
+    /**
+     * If null, this contains a list of changes recorded without an explicit transaction associated.
+     */
+    transactionId) {
+        super(crud, false, complete);
+        this.crud = crud;
+        this.complete = complete;
+        this.transactionId = transactionId;
+    }
+}
+//# sourceMappingURL=CrudTransaction.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CrudTransaction.js","sourceRoot":"","sources":["../../../../src/client/sync/bucket/CrudTransaction.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAG3C,MAAM,OAAO,eAAgB,SAAQ,SAAS;IAKnC;IAIA;IAIA;IAZT;IACE;;OAEG;IACI,IAAiB;IACxB;;OAEG;IACI,QAAgD;IACvD;;OAEG;IACI,aAAsB;QAE7B,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC;QAVtB,SAAI,GAAJ,IAAI,CAAa;QAIjB,aAAQ,GAAR,QAAQ,CAAwC;QAIhD,kBAAa,GAAb,aAAa,CAAS;IAG/B,CAAC;CACF"}

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

@@ -0,0 +1,16 @@
+export declare enum OpTypeEnum {
+    CLEAR = 1,
+    MOVE = 2,
+    PUT = 3,
+    REMOVE = 4
+}
+export type OpTypeJSON = string;
+/**
+ * Used internally for sync buckets.
+ */
+export declare class OpType {
+    value: OpTypeEnum;
+    static fromJSON(jsonValue: OpTypeJSON): OpType;
+    constructor(value: OpTypeEnum);
+    toJSON(): string;
+}

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

@@ -0,0 +1,23 @@
+export var OpTypeEnum;
+(function (OpTypeEnum) {
+    OpTypeEnum[OpTypeEnum["CLEAR"] = 1] = "CLEAR";
+    OpTypeEnum[OpTypeEnum["MOVE"] = 2] = "MOVE";
+    OpTypeEnum[OpTypeEnum["PUT"] = 3] = "PUT";
+    OpTypeEnum[OpTypeEnum["REMOVE"] = 4] = "REMOVE";
+})(OpTypeEnum || (OpTypeEnum = {}));
+/**
+ * Used internally for sync buckets.
+ */
+export class OpType {
+    value;
+    static fromJSON(jsonValue) {
+        return new OpType(OpTypeEnum[jsonValue]);
+    }
+    constructor(value) {
+        this.value = value;
+    }
+    toJSON() {
+        return Object.entries(OpTypeEnum).find(([, value]) => value === this.value)[0];
+    }
+}
+//# sourceMappingURL=OpType.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"OpType.js","sourceRoot":"","sources":["../../../../src/client/sync/bucket/OpType.ts"],"names":[],"mappings":"AAAA,MAAM,CAAN,IAAY,UAKX;AALD,WAAY,UAAU;IACpB,6CAAS,CAAA;IACT,2CAAQ,CAAA;IACR,yCAAO,CAAA;IACP,+CAAU,CAAA;AACZ,CAAC,EALW,UAAU,KAAV,UAAU,QAKrB;AAID;;GAEG;AACH,MAAM,OAAO,MAAM;IAKE;IAJnB,MAAM,CAAC,QAAQ,CAAC,SAAqB;QACnC,OAAO,IAAI,MAAM,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC;IAC3C,CAAC;IAED,YAAmB,KAAiB;QAAjB,UAAK,GAAL,KAAK,CAAY;IAAG,CAAC;IAExC,MAAM;QACJ,OAAO,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,KAAK,IAAI,CAAC,KAAK,CAAE,CAAC,CAAC,CAAC,CAAC;IAClF,CAAC;CACF"}

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

@@ -0,0 +1,23 @@
+import { OpId } from './CrudEntry.js';
+import { OpType, OpTypeJSON } from './OpType.js';
+export interface OplogEntryJSON {
+    checksum: number;
+    data?: string;
+    object_id?: string;
+    object_type?: string;
+    op_id: string;
+    op: OpTypeJSON;
+    subkey?: string;
+}
+export declare class OplogEntry {
+    op_id: OpId;
+    op: OpType;
+    checksum: number;
+    subkey?: string | undefined;
+    object_type?: string | undefined;
+    object_id?: string | undefined;
+    data?: string | undefined;
+    static fromRow(row: OplogEntryJSON): OplogEntry;
+    constructor(op_id: OpId, op: OpType, checksum: number, subkey?: string | undefined, object_type?: string | undefined, object_id?: string | undefined, data?: string | undefined);
+    toJSON(fixedKeyEncoding?: boolean): OplogEntryJSON;
+}

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

@@ -0,0 +1,36 @@
+import { OpType } from './OpType.js';
+export class OplogEntry {
+    op_id;
+    op;
+    checksum;
+    subkey;
+    object_type;
+    object_id;
+    data;
+    static fromRow(row) {
+        return new OplogEntry(row.op_id, OpType.fromJSON(row.op), row.checksum, row.subkey, row.object_type, row.object_id, row.data);
+    }
+    constructor(op_id, op, checksum, subkey, object_type, object_id, data) {
+        this.op_id = op_id;
+        this.op = op;
+        this.checksum = checksum;
+        this.subkey = subkey;
+        this.object_type = object_type;
+        this.object_id = object_id;
+        this.data = data;
+    }
+    toJSON(fixedKeyEncoding = false) {
+        return {
+            op_id: this.op_id,
+            op: this.op.toJSON(),
+            object_type: this.object_type,
+            object_id: this.object_id,
+            checksum: this.checksum,
+            data: this.data,
+            // Older versions of the JS SDK used to always JSON.stringify here. That has always been wrong,
+            // but we need to migrate gradually to not break existing databases.
+            subkey: fixedKeyEncoding ? this.subkey : JSON.stringify(this.subkey)
+        };
+    }
+}
+//# sourceMappingURL=OplogEntry.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"OplogEntry.js","sourceRoot":"","sources":["../../../../src/client/sync/bucket/OplogEntry.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAc,MAAM,aAAa,CAAC;AAYjD,MAAM,OAAO,UAAU;IAcZ;IACA;IACA;IACA;IACA;IACA;IACA;IAnBT,MAAM,CAAC,OAAO,CAAC,GAAmB;QAChC,OAAO,IAAI,UAAU,CACnB,GAAG,CAAC,KAAK,EACT,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,EACvB,GAAG,CAAC,QAAQ,EACZ,GAAG,CAAC,MAAM,EACV,GAAG,CAAC,WAAW,EACf,GAAG,CAAC,SAAS,EACb,GAAG,CAAC,IAAI,CACT,CAAC;IACJ,CAAC;IAED,YACS,KAAW,EACX,EAAU,EACV,QAAgB,EAChB,MAAe,EACf,WAAoB,EACpB,SAAkB,EAClB,IAAa;QANb,UAAK,GAAL,KAAK,CAAM;QACX,OAAE,GAAF,EAAE,CAAQ;QACV,aAAQ,GAAR,QAAQ,CAAQ;QAChB,WAAM,GAAN,MAAM,CAAS;QACf,gBAAW,GAAX,WAAW,CAAS;QACpB,cAAS,GAAT,SAAS,CAAS;QAClB,SAAI,GAAJ,IAAI,CAAS;IACnB,CAAC;IAEJ,MAAM,CAAC,gBAAgB,GAAG,KAAK;QAC7B,OAAO;YACL,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,EAAE,EAAE,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE;YACpB,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,+FAA+F;YAC/F,oEAAoE;YACpE,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC;SACrE,CAAC;IACJ,CAAC;CACF"}

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

@@ -0,0 +1,61 @@
+import { ILogger } from 'js-logger';
+import { DBAdapter, Transaction } from '../../../db/DBAdapter.js';
+import { BaseObserver } from '../../../utils/BaseObserver.js';
+import { BucketOperationProgress, BucketState, BucketStorageAdapter, BucketStorageListener, Checkpoint, PowerSyncControlCommand, 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 logger;
+    tableNames: Set<string>;
+    private _hasCompletedSync;
+    private updateListener;
+    private _clientId?;
+    constructor(db: DBAdapter, logger?: ILogger);
+    init(): Promise<void>;
+    dispose(): Promise<void>;
+    _getClientId(): Promise<string>;
+    getClientId(): Promise<string>;
+    getMaxOpId(): string;
+    /**
+     * Reset any caches.
+     */
+    startSession(): void;
+    getBucketStates(): Promise<BucketState[]>;
+    getBucketOperationProgress(): Promise<BucketOperationProgress>;
+    saveSyncData(batch: SyncDataBatch, fixedKeyFormat?: boolean): Promise<void>;
+    removeBuckets(buckets: string[]): Promise<void>;
+    /**
+     * Mark a bucket for deletion.
+     */
+    private deleteBucket;
+    hasCompletedSync(): Promise<boolean>;
+    syncLocalDatabase(checkpoint: Checkpoint, priority?: number): Promise<SyncLocalDatabaseResult>;
+    /**
+     * Atomically update the local state to the current checkpoint.
+     *
+     * This includes creating new tables, dropping old tables, and copying data over from the oplog.
+     */
+    private updateObjectsFromBuckets;
+    validateChecksums(checkpoint: Checkpoint, priority: number | undefined): Promise<SyncLocalDatabaseResult>;
+    updateLocalTarget(cb: () => Promise<string>): Promise<boolean>;
+    nextCrudItem(): Promise<CrudEntry | undefined>;
+    hasCrud(): Promise<boolean>;
+    /**
+     * Get a batch of objects to send to the server.
+     * When the objects are successfully sent to the server, call .complete()
+     */
+    getCrudBatch(limit?: number): Promise<CrudBatch | null>;
+    writeTransaction<T>(callback: (tx: Transaction) => Promise<T>, options?: {
+        timeoutMs: number;
+    }): Promise<T>;
+    /**
+     * Set a target checkpoint.
+     */
+    setTargetCheckpoint(checkpoint: Checkpoint): Promise<void>;
+    control(op: PowerSyncControlCommand, payload: string | Uint8Array | ArrayBuffer | null): Promise<string>;
+    hasMigratedSubkeys(): Promise<boolean>;
+    migrateToFixedSubkeys(): Promise<void>;
+    static _subkeyMigrationKey: string;
+}

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

@@ -0,0 +1,324 @@
+import Logger from 'js-logger';
+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';
+export class SqliteBucketStorage extends BaseObserver {
+    db;
+    logger;
+    tableNames;
+    _hasCompletedSync;
+    updateListener;
+    _clientId;
+    constructor(db, logger = Logger.get('SqliteBucketStorage')) {
+        super();
+        this.db = db;
+        this.logger = logger;
+        this._hasCompletedSync = false;
+        this.tableNames = new Set();
+        this.updateListener = db.registerListener({
+            tablesUpdated: (update) => {
+                const tables = extractTableUpdates(update);
+                if (tables.includes(PSInternalTable.CRUD)) {
+                    this.iterateListeners((l) => l.crudUpdate?.());
+                }
+            }
+        });
+    }
+    async init() {
+        this._hasCompletedSync = false;
+        const existingTableRows = await this.db.getAll(`SELECT name FROM sqlite_master WHERE type='table' AND name GLOB 'ps_data_*'`);
+        for (const row of existingTableRows ?? []) {
+            this.tableNames.add(row.name);
+        }
+    }
+    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;
+    }
+    /**
+     * Reset any caches.
+     */
+    startSession() { }
+    async getBucketStates() {
+        const result = await this.db.getAll("SELECT name as bucket, cast(last_op as TEXT) as op_id FROM ps_buckets WHERE pending_delete = 0 AND name != '$local'");
+        return result;
+    }
+    async getBucketOperationProgress() {
+        const rows = await this.db.getAll('SELECT name, count_at_last, count_since_last FROM ps_buckets');
+        return Object.fromEntries(rows.map((r) => [r.name, { atLast: r.count_at_last, sinceLast: r.count_since_last }]));
+    }
+    async saveSyncData(batch, fixedKeyFormat = false) {
+        await this.writeTransaction(async (tx) => {
+            for (const b of batch.buckets) {
+                await tx.execute('INSERT INTO powersync_operations(op, data) VALUES(?, ?)', [
+                    'save',
+                    JSON.stringify({ buckets: [b.toJSON(fixedKeyFormat)] })
+                ]);
+                this.logger.debug(`Saved batch of data for  bucket: ${b.bucket}, operations: ${b.data.length}`);
+            }
+        });
+    }
+    async removeBuckets(buckets) {
+        for (const bucket of buckets) {
+            await this.deleteBucket(bucket);
+        }
+    }
+    /**
+     * Mark a bucket for deletion.
+     */
+    async deleteBucket(bucket) {
+        await this.writeTransaction(async (tx) => {
+            await tx.execute('INSERT INTO powersync_operations(op, data) VALUES(?, ?)', ['delete_bucket', bucket]);
+        });
+        this.logger.debug(`Done deleting bucket ${bucket}`);
+    }
+    async hasCompletedSync() {
+        if (this._hasCompletedSync) {
+            return true;
+        }
+        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;
+        }
+        return completed;
+    }
+    async syncLocalDatabase(checkpoint, priority) {
+        const r = await this.validateChecksums(checkpoint, priority);
+        if (!r.checkpointValid) {
+            this.logger.error('Checksums failed for', r.checkpointFailures);
+            for (const b of r.checkpointFailures ?? []) {
+                await this.deleteBucket(b);
+            }
+            return { ready: false, checkpointValid: false, checkpointFailures: r.checkpointFailures };
+        }
+        if (priority == null) {
+            this.logger.debug(`Validated checksums checkpoint ${checkpoint.last_op_id}`);
+        }
+        else {
+            this.logger.debug(`Validated checksums for partial checkpoint ${checkpoint.last_op_id}, priority ${priority}`);
+        }
+        let buckets = checkpoint.buckets;
+        if (priority !== undefined) {
+            buckets = buckets.filter((b) => hasMatchingPriority(priority, b));
+        }
+        const bucketNames = buckets.map((b) => b.bucket);
+        await this.writeTransaction(async (tx) => {
+            await tx.execute(`UPDATE ps_buckets SET last_op = ? WHERE name IN (SELECT json_each.value FROM json_each(?))`, [
+                checkpoint.last_op_id,
+                JSON.stringify(bucketNames)
+            ]);
+            if (priority == null && checkpoint.write_checkpoint) {
+                await tx.execute("UPDATE ps_buckets SET last_op = ? WHERE name = '$local'", [checkpoint.write_checkpoint]);
+            }
+        });
+        const valid = await this.updateObjectsFromBuckets(checkpoint, priority);
+        if (!valid) {
+            return { ready: false, checkpointValid: true };
+        }
+        return {
+            ready: true,
+            checkpointValid: true
+        };
+    }
+    /**
+     * Atomically update the local state to the current checkpoint.
+     *
+     * This includes creating new tables, dropping old tables, and copying data over from the oplog.
+     */
+    async updateObjectsFromBuckets(checkpoint, priority) {
+        let arg = '';
+        if (priority !== undefined) {
+            const affectedBuckets = [];
+            for (const desc of checkpoint.buckets) {
+                if (hasMatchingPriority(priority, desc)) {
+                    affectedBuckets.push(desc.bucket);
+                }
+            }
+            arg = JSON.stringify({ priority, buckets: affectedBuckets });
+        }
+        return this.writeTransaction(async (tx) => {
+            const { insertId: result } = await tx.execute('INSERT INTO powersync_operations(op, data) VALUES(?, ?)', [
+                'sync_local',
+                arg
+            ]);
+            if (result == 1) {
+                if (priority == null) {
+                    const bucketToCount = Object.fromEntries(checkpoint.buckets.map((b) => [b.bucket, b.count]));
+                    // The two parameters could be replaced with one, but: https://github.com/powersync-ja/better-sqlite3/pull/6
+                    const jsonBucketCount = JSON.stringify(bucketToCount);
+                    await tx.execute("UPDATE ps_buckets SET count_since_last = 0, count_at_last = ?->name WHERE name != '$local' AND ?->name IS NOT NULL", [jsonBucketCount, jsonBucketCount]);
+                }
+                return true;
+            }
+            else {
+                return false;
+            }
+        });
+    }
+    async validateChecksums(checkpoint, priority) {
+        if (priority !== undefined) {
+            // Only validate the buckets within the priority we care about
+            const newBuckets = checkpoint.buckets.filter((cs) => hasMatchingPriority(priority, cs));
+            checkpoint = { ...checkpoint, buckets: newBuckets };
+        }
+        const rs = await this.db.execute('SELECT powersync_validate_checkpoint(?) as result', [
+            JSON.stringify({ ...checkpoint })
+        ]);
+        const resultItem = rs.rows?.item(0);
+        if (!resultItem) {
+            return {
+                checkpointValid: false,
+                ready: false,
+                checkpointFailures: []
+            };
+        }
+        const result = JSON.parse(resultItem['result']);
+        if (result['valid']) {
+            return { ready: true, checkpointValid: true };
+        }
+        else {
+            return {
+                checkpointValid: false,
+                ready: false,
+                checkpointFailures: result['failed_buckets']
+            };
+        }
+    }
+    async updateLocalTarget(cb) {
+        const rs1 = await this.db.getAll("SELECT target_op FROM ps_buckets WHERE name = '$local' AND target_op = CAST(? as INTEGER)", [MAX_OP_ID]);
+        if (!rs1.length) {
+            // Nothing to update
+            return false;
+        }
+        const rs = await this.db.getAll("SELECT seq FROM main.sqlite_sequence WHERE name = 'ps_crud'");
+        if (!rs.length) {
+            // Nothing to update
+            return false;
+        }
+        const seqBefore = rs[0]['seq'];
+        const opId = await cb();
+        return this.writeTransaction(async (tx) => {
+            const anyData = await tx.execute('SELECT 1 FROM ps_crud LIMIT 1');
+            if (anyData.rows?.length) {
+                // if isNotEmpty
+                this.logger.debug(`New data uploaded since write checkpoint ${opId} - need new write checkpoint`);
+                return false;
+            }
+            const rs = await tx.execute("SELECT seq FROM main.sqlite_sequence WHERE name = 'ps_crud'");
+            if (!rs.rows?.length) {
+                // assert isNotEmpty
+                throw new Error('SQLite Sequence should not be empty');
+            }
+            const seqAfter = rs.rows?.item(0)['seq'];
+            if (seqAfter != seqBefore) {
+                this.logger.debug(`New data uploaded since write checpoint ${opId} - need new write checkpoint (sequence updated)`);
+                // New crud data may have been uploaded since we got the checkpoint. Abort.
+                return false;
+            }
+            this.logger.debug(`Updating target write checkpoint to ${opId}`);
+            await tx.execute("UPDATE ps_buckets SET target_op = CAST(? as INTEGER) WHERE name='$local'", [opId]);
+            return true;
+        });
+    }
+    async nextCrudItem() {
+        const next = await this.db.getOptional('SELECT * FROM ps_crud ORDER BY id ASC LIMIT 1');
+        if (!next) {
+            return;
+        }
+        return CrudEntry.fromRow(next);
+    }
+    async hasCrud() {
+        const anyData = await this.db.getOptional('SELECT 1 FROM ps_crud LIMIT 1');
+        return !!anyData;
+    }
+    /**
+     * Get a batch of objects to send to the server.
+     * When the objects are successfully sent to the server, call .complete()
+     */
+    async getCrudBatch(limit = 100) {
+        if (!(await this.hasCrud())) {
+            return null;
+        }
+        const crudResult = await this.db.getAll('SELECT * FROM ps_crud ORDER BY id ASC LIMIT ?', [limit]);
+        const all = [];
+        for (const row of crudResult) {
+            all.push(CrudEntry.fromRow(row));
+        }
+        if (all.length === 0) {
+            return null;
+        }
+        const last = all[all.length - 1];
+        return {
+            crud: all,
+            haveMore: true,
+            complete: async (writeCheckpoint) => {
+                return this.writeTransaction(async (tx) => {
+                    await tx.execute('DELETE FROM ps_crud WHERE id <= ?', [last.clientId]);
+                    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 = CAST(? as INTEGER) WHERE name='$local'", [
+                                writeCheckpoint
+                            ]);
+                        }
+                    }
+                    else {
+                        await tx.execute("UPDATE ps_buckets SET target_op = CAST(? as INTEGER) WHERE name='$local'", [
+                            this.getMaxOpId()
+                        ]);
+                    }
+                });
+            }
+        };
+    }
+    async writeTransaction(callback, options) {
+        return this.db.writeTransaction(callback, options);
+    }
+    /**
+     * Set a target checkpoint.
+     */
+    async setTargetCheckpoint(checkpoint) {
+        // No-op for now
+    }
+    async control(op, payload) {
+        return await this.writeTransaction(async (tx) => {
+            const [[raw]] = await tx.executeRaw('SELECT powersync_control(?, ?)', [op, payload]);
+            return raw;
+        });
+    }
+    async hasMigratedSubkeys() {
+        const { r } = await this.db.get('SELECT EXISTS(SELECT * FROM ps_kv WHERE key = ?) as r', [
+            SqliteBucketStorage._subkeyMigrationKey
+        ]);
+        return r != 0;
+    }
+    async migrateToFixedSubkeys() {
+        await this.writeTransaction(async (tx) => {
+            await tx.execute('UPDATE ps_oplog SET key = powersync_remove_duplicate_key_encoding(key);');
+            await tx.execute('INSERT OR REPLACE INTO ps_kv (key, value) VALUES (?, ?);', [
+                SqliteBucketStorage._subkeyMigrationKey,
+                '1'
+            ]);
+        });
+    }
+    static _subkeyMigrationKey = 'powersync_js_migrated_subkeys';
+}
+function hasMatchingPriority(priority, bucket) {
+    return bucket.priority != null && bucket.priority <= priority;
+}
+//# sourceMappingURL=SqliteBucketStorage.js.map