@powersync/web 2.1.1 → 2.3.0

package/lib/db/adapters/memory-pool/shared.d.ts

@@ -0,0 +1,51 @@
+import { RawQueryResult } from '@powersync/common';
+import type { RawWaSqliteDatabaseOptions, RawWebResult } from '../wa-sqlite/RawSqliteConnection.js';
+export interface WriteAheadBuffers {
+    database: SharedArrayBuffer;
+    writeAheadLog: SharedArrayBuffer;
+}
+export interface WriteAheadState {
+    /**
+     * Length of the main database file.
+     */
+    fileSize: number;
+    walEnd: number;
+    /**
+     * A map of database position offsets to offsets in the WAL logs at which position contents of the page are stored.
+     */
+    overlay: Map<number, WalOverlayEntry>;
+}
+export interface WalOverlayEntry {
+    logOffset: number;
+    size: number;
+}
+export interface WalIndexChange {
+    fileSize: number;
+    walEnd: number;
+    /**
+     * New overlay entries to add, encoded as (key, value) pairs of {@link WriteAheadState.overlay}.
+     */
+    added: (number | WalOverlayEntry)[];
+    /**
+     * Whether to clear the overlay (meaning that we ran a checkpoint).
+     */
+    cleared: boolean;
+}
+export interface DatabaseServer {
+    /**
+     * Open a database connection from the given database and write-ahead log buffers.
+     */
+    open(buffers: WriteAheadBuffers, options: Partial<RawWaSqliteDatabaseOptions>): Promise<void>;
+    /**
+     * Push new wal changes to this worker.
+     */
+    updateWalState(overlay: WalIndexChange): Promise<void>;
+    executeRaw(query: string, params?: any[] | undefined): Promise<RawQueryResult>;
+    executeBatch(query: string, params?: any[][] | undefined): Promise<RawWebResult[]>;
+    /**
+     * Takes WAL changes made by this worker during its active write iteration.
+     */
+    takeWalChanges(): Promise<WalIndexChange>;
+}
+export declare function emptyWalState(): WriteAheadState;
+export declare function applyWalChanges(state: WriteAheadState, changes: WalIndexChange): void;

package/lib/db/adapters/memory-pool/shared.js

@@ -0,0 +1,16 @@
+export function emptyWalState() {
+    return { fileSize: 0, walEnd: 0, overlay: new Map() };
+}
+export function applyWalChanges(state, changes) {
+    state.fileSize = changes.fileSize;
+    state.walEnd = changes.walEnd;
+    if (changes.cleared) {
+        state.overlay.clear();
+    }
+    for (let i = 0; i < changes.added.length; i += 2) {
+        const dbOffset = changes.added[i];
+        const walEntry = changes.added[i + 1];
+        state.overlay.set(dbOffset, walEntry);
+    }
+}
+//# sourceMappingURL=shared.js.map

package/lib/db/adapters/memory-pool/shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../../../src/db/adapters/memory-pool/shared.ts"],"names":[],"mappings":"AA6DA,MAAM,UAAU,aAAa;IAC3B,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,GAAG,EAAE,EAAE,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAAsB,EAAE,OAAuB;IAC7E,KAAK,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;IAClC,KAAK,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAE9B,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QACpB,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;IAED,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QACjD,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAW,CAAC;QAC5C,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAoB,CAAC;QACzD,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IACxC,CAAC;AACH,CAAC"}

package/lib/db/adapters/memory-pool/vfs.d.ts

@@ -0,0 +1,19 @@
+import { FacadeVFS } from '@journeyapps/wa-sqlite/src/FacadeVFS.js';
+import { WalIndexChange, WriteAheadBuffers, WriteAheadState } from './shared.js';
+export declare class InMemoryWriteAheadLog extends FacadeVFS {
+    #private;
+    readonly buffers: WriteAheadBuffers;
+    writeAheadState: WriteAheadState;
+    constructor(module: any, buffers: WriteAheadBuffers);
+    takeChanges(): WalIndexChange;
+    jAccess(zName: string, _pFlags: number, pResOut: DataView): 0;
+    jOpen(zName: string | null, fileId: number, flags: number, pOutFlags: DataView): number;
+    jClose(fileid: number): 0;
+    jRead(fileId: number, data: Uint8Array, offset: number): 0 | 522;
+    jWrite(fileId: number, data: Uint8Array, offset: number): number;
+    jTruncate(fileid: number, size: number): number;
+    jFileSize(fileid: number, pSize64: DataView): 0;
+    jDelete(name: string): 0 | 2570;
+    jDeviceCharacteristics(): number;
+    jFileControl(fileid: number, op: number): 0 | 12;
+}

package/lib/db/adapters/memory-pool/vfs.js

@@ -0,0 +1,247 @@
+// @ts-ignore
+import { FacadeVFS } from '@journeyapps/wa-sqlite/src/FacadeVFS.js';
+import * as VFS from '@journeyapps/wa-sqlite/src/VFS.js';
+import { emptyWalState } from './shared.js';
+const mainDbSentinel = Symbol();
+export class InMemoryWriteAheadLog extends FacadeVFS {
+    buffers;
+    // The main /database file is the only file for which we create a write-ahead log. All other files (including the
+    // journal) are local-only.
+    #openedFiles = new Map();
+    #files = new Map();
+    #tx = undefined;
+    #newOverlayPagesToSendToMainTab = new Map();
+    writeAheadState = emptyWalState();
+    constructor(module, buffers) {
+        super('InMemoryWriteAheadLog', module);
+        this.buffers = buffers;
+        this.#files.set('/database', mainDbSentinel);
+    }
+    takeChanges() {
+        const added = [];
+        this.#newOverlayPagesToSendToMainTab.forEach((v, k) => {
+            added.push(k);
+            added.push(v);
+        });
+        this.#newOverlayPagesToSendToMainTab.clear();
+        return {
+            cleared: false,
+            walEnd: this.writeAheadState.walEnd,
+            fileSize: this.writeAheadState.fileSize,
+            added
+        };
+    }
+    jAccess(zName, _pFlags, pResOut) {
+        const file = this.#files.get(zName);
+        pResOut.setInt32(0, file != null ? 1 : 0, true);
+        return VFS.SQLITE_OK;
+    }
+    jOpen(zName, fileId, flags, pOutFlags) {
+        if (flags & VFS.SQLITE_OPEN_MAIN_DB) {
+            this.#openedFiles.set(fileId, mainDbSentinel);
+        }
+        else {
+            // Treat all other files, including the mostly unused journal as temporary.
+            zName ??= `tmp-${crypto.randomUUID()}`;
+            const existing = this.#files.get(zName);
+            if (existing != null) {
+                this.#openedFiles.set(fileId, existing);
+            }
+            else {
+                if (!(flags & VFS.SQLITE_OPEN_CREATE)) {
+                    return VFS.SQLITE_IOERR;
+                }
+                const newFile = new LocalFile(zName);
+                newFile.deleteOnClose = (flags & VFS.SQLITE_OPEN_DELETEONCLOSE) != 0;
+                this.#openedFiles.set(fileId, newFile);
+                this.#files.set(zName, newFile);
+            }
+        }
+        pOutFlags.setInt32(0, flags, true);
+        return VFS.SQLITE_OK;
+    }
+    jClose(fileid) {
+        const file = this.#openedFiles.get(fileid);
+        this.#openedFiles.delete(fileid);
+        if (file != mainDbSentinel && file.deleteOnClose) {
+            this.#files.delete(file.name);
+        }
+        return VFS.SQLITE_OK;
+    }
+    jRead(fileId, data, offset) {
+        const file = this.#openedFiles.get(fileId);
+        let endOffset;
+        let readableBytes;
+        if (file == mainDbSentinel) {
+            const { fileSize, overlay } = this.writeAheadState;
+            const startOffset = Math.min(offset, fileSize);
+            endOffset = Math.min(fileSize, offset + data.byteLength);
+            readableBytes = endOffset - startOffset;
+            // Try reading from the write-ahead overlay first. A read on the database file is always a complete page, except
+            // when reading from the 100-byte header.
+            const page = overlay.get(offset < 100 ? 0 : offset);
+            if (page != null) {
+                const pageOffset = page.logOffset;
+                const source = new Uint8Array(this.buffers.writeAheadLog, offset < 100 ? pageOffset + offset : pageOffset, readableBytes);
+                data.set(source);
+            }
+            else {
+                // Page is not in WAL overlay, read directly from underlying in-memory buffer.
+                data.set(new Uint8Array(this.buffers.database, startOffset, readableBytes));
+            }
+        }
+        else {
+            const fileSize = file.size;
+            const startOffset = Math.min(offset, fileSize);
+            endOffset = Math.min(fileSize, offset + data.byteLength);
+            readableBytes = endOffset - startOffset;
+            if (readableBytes > 0) {
+                data.set(new Uint8Array(file.buffer, startOffset, readableBytes));
+            }
+        }
+        if (readableBytes < data.byteLength) {
+            data.fill(0, readableBytes); // Fill rest with zeroes.
+            return VFS.SQLITE_IOERR_SHORT_READ;
+        }
+        return VFS.SQLITE_OK;
+    }
+    jWrite(fileId, data, offset) {
+        const file = this.#openedFiles.get(fileId);
+        // wa-sqlite passes a proxy instead of a real Uint8Array.
+        const actualBuffer = data.subarray();
+        if (file === mainDbSentinel) {
+            // Write to the write-ahead overlay.
+            let didWrite = false;
+            if (this.#tx != null) {
+                didWrite = this.#tx.appendPage(offset, actualBuffer);
+            }
+            else {
+                const tx = new WriteAheadTransaction(this.writeAheadState.walEnd, this.writeAheadState.fileSize, this.buffers);
+                didWrite = tx.appendPage(offset, actualBuffer);
+                this.#commit(tx);
+            }
+            return didWrite ? VFS.SQLITE_OK : VFS.SQLITE_FULL;
+        }
+        else {
+            const writeLength = data.length;
+            const endOffset = offset + writeLength;
+            if (endOffset > file.buffer.byteLength) {
+                const didGrow = file.growBuffer(endOffset);
+                if (!didGrow) {
+                    return VFS.SQLITE_FULL;
+                }
+            }
+            new Uint8Array(file.buffer, offset, writeLength).set(actualBuffer);
+            file.size = Math.max(file.size, endOffset);
+            return VFS.SQLITE_OK;
+        }
+    }
+    jTruncate(fileid, size) {
+        const file = this.#openedFiles.get(fileid);
+        if (file === mainDbSentinel) {
+            this.writeAheadState.fileSize = Math.min(this.writeAheadState.fileSize, size);
+        }
+        else {
+            file.size = Math.min(size, file.size);
+        }
+        return VFS.SQLITE_OK;
+    }
+    jFileSize(fileid, pSize64) {
+        const file = this.#openedFiles.get(fileid);
+        if (file === mainDbSentinel) {
+            pSize64.setBigInt64(0, BigInt(this.writeAheadState.fileSize), true);
+        }
+        else {
+            pSize64.setBigInt64(0, BigInt(file.size), true);
+        }
+        return VFS.SQLITE_OK;
+    }
+    jDelete(name) {
+        if (name === '/database') {
+            return VFS.SQLITE_IOERR_DELETE;
+        }
+        this.#files.delete(name);
+        return VFS.SQLITE_OK;
+    }
+    jDeviceCharacteristics() {
+        return VFS.SQLITE_IOCAP_UNDELETABLE_WHEN_OPEN | VFS.SQLITE_IOCAP_BATCH_ATOMIC;
+    }
+    jFileControl(fileid, op) {
+        const file = this.#openedFiles.get(fileid);
+        if (file !== mainDbSentinel)
+            return VFS.SQLITE_NOTFOUND;
+        switch (op) {
+            case VFS.SQLITE_FCNTL_BEGIN_ATOMIC_WRITE:
+                this.#tx = new WriteAheadTransaction(this.writeAheadState.walEnd, this.writeAheadState.fileSize, this.buffers);
+                break;
+            case VFS.SQLITE_FCNTL_ROLLBACK_ATOMIC_WRITE:
+                this.#tx = undefined;
+                break;
+            case VFS.SQLITE_FCNTL_COMMIT_ATOMIC_WRITE:
+                this.#commit(this.#tx);
+                this.#tx = undefined;
+                break;
+            default:
+                return VFS.SQLITE_NOTFOUND;
+        }
+        return VFS.SQLITE_OK;
+    }
+    #commit(tx) {
+        this.writeAheadState.walEnd = tx.walEndOffset;
+        this.writeAheadState.fileSize = tx.fileSize;
+        tx.changedPages.forEach((walEntry, databaseOffset) => {
+            this.#newOverlayPagesToSendToMainTab.set(databaseOffset, walEntry);
+            this.writeAheadState.overlay.set(databaseOffset, walEntry);
+        });
+    }
+}
+class WriteAheadTransaction {
+    buffers;
+    walEndOffset;
+    fileSize;
+    changedPages = new Map();
+    constructor(endOffset, fileSize, buffers) {
+        this.buffers = buffers;
+        this.walEndOffset = endOffset;
+        this.fileSize = fileSize;
+    }
+    appendPage(offset, data) {
+        const currentEnd = this.walEndOffset;
+        const newEnd = currentEnd + data.length;
+        const wal = this.buffers.writeAheadLog;
+        if (newEnd > wal.byteLength) {
+            if (!this.#growWal(wal, newEnd))
+                return false;
+        }
+        this.fileSize = Math.max(this.fileSize, offset + data.length);
+        new Uint8Array(wal, currentEnd, data.length).set(data);
+        this.walEndOffset = newEnd;
+        this.changedPages.set(offset, { logOffset: currentEnd, size: data.length });
+        return true;
+    }
+    #growWal(buffer, minSize) {
+        const newSize = Math.max(minSize, Math.min(2 * buffer.byteLength, buffer.maxByteLength));
+        if (newSize > buffer.maxByteLength) {
+            return false;
+        }
+        buffer.grow(newSize);
+        return true;
+    }
+}
+class LocalFile {
+    deleteOnClose = false;
+    name;
+    buffer = new ArrayBuffer(1024);
+    size = 0;
+    constructor(name) {
+        this.name = name;
+    }
+    growBuffer(minSize) {
+        const newSize = Math.max(minSize, 2 * this.buffer.byteLength);
+        const newBuffer = new ArrayBuffer(newSize);
+        new Uint8Array(newBuffer).set(new Uint8Array(this.buffer));
+        this.buffer = newBuffer;
+        return true;
+    }
+}
+//# sourceMappingURL=vfs.js.map

package/lib/db/adapters/memory-pool/vfs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vfs.js","sourceRoot":"","sources":["../../../../src/db/adapters/memory-pool/vfs.ts"],"names":[],"mappings":"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"}

package/lib/db/adapters/memory-pool/worker.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/db/adapters/memory-pool/worker.js

@@ -0,0 +1,45 @@
+import * as Comlink from 'comlink';
+import { applyWalChanges } from './shared.js';
+import { InMemoryWriteAheadLog } from './vfs.js';
+import { RawSqliteConnection } from '../wa-sqlite/RawSqliteConnection.js';
+import { WASQLiteVFS } from '../wa-sqlite/vfs.js';
+import { TemporaryStorageOption } from '../options.js';
+class MemoryDatabaseServer {
+    #vfs;
+    #connection;
+    async open(buffers, options) {
+        const { default: factory } = await import('@journeyapps/wa-sqlite/dist/wa-sqlite.mjs');
+        const module = await factory();
+        const vfs = (this.#vfs = new InMemoryWriteAheadLog(module, buffers));
+        const connection = new RawSqliteConnection({
+            encryptionKey: undefined,
+            vfs: WASQLiteVFS.InMemoryVfs,
+            // Unused, since we register our own VFS. Only needed to satisfy the type.
+            temporaryStorage: TemporaryStorageOption.MEMORY,
+            cacheSizeKb: 50 * 1024,
+            preparedStatementsCache: 0,
+            ...options,
+            // The rest of these options is not overridable: The VFS handles /database reads and writes in a special way and
+            // there can only be one database per buffers instance.
+            filename: '/database',
+            readonly: false
+        });
+        await connection.initWithModule(module, vfs);
+        this.#connection = connection;
+    }
+    async updateWalState(overlay) {
+        const currentState = this.#vfs.writeAheadState;
+        applyWalChanges(currentState, overlay);
+    }
+    async executeRaw(query, params) {
+        return await this.#connection.execute(query, params);
+    }
+    async executeBatch(query, params) {
+        return await this.#connection.executeBatch(query, params);
+    }
+    async takeWalChanges() {
+        return this.#vfs.takeChanges();
+    }
+}
+Comlink.expose(new MemoryDatabaseServer());
+//# sourceMappingURL=worker.js.map

package/lib/db/adapters/memory-pool/worker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.js","sourceRoot":"","sources":["../../../../src/db/adapters/memory-pool/worker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,SAAS,CAAC;AACnC,OAAO,EAAE,eAAe,EAAqD,MAAM,aAAa,CAAC;AAEjG,OAAO,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AACjD,OAAO,EAAE,mBAAmB,EAA4C,MAAM,qCAAqC,CAAC;AACpH,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAEvD,MAAM,oBAAoB;IACxB,IAAI,CAAyB;IAC7B,WAAW,CAAuB;IAElC,KAAK,CAAC,IAAI,CAAC,OAA0B,EAAE,OAA4C;QACjF,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,MAAM,MAAM,CAAC,2CAA2C,CAAC,CAAC;QACvF,MAAM,MAAM,GAAG,MAAM,OAAO,EAAE,CAAC;QAC/B,MAAM,GAAG,GAAG,CAAC,IAAI,CAAC,IAAI,GAAG,IAAI,qBAAqB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;QAErE,MAAM,UAAU,GAAG,IAAI,mBAAmB,CAAC;YACzC,aAAa,EAAE,SAAS;YACxB,GAAG,EAAE,WAAW,CAAC,WAAW;YAC5B,0EAA0E;YAC1E,gBAAgB,EAAE,sBAAsB,CAAC,MAAM;YAC/C,WAAW,EAAE,EAAE,GAAG,IAAI;YACtB,uBAAuB,EAAE,CAAC;YAC1B,GAAG,OAAO;YACV,gHAAgH;YAChH,uDAAuD;YACvD,QAAQ,EAAE,WAAW;YACrB,QAAQ,EAAE,KAAK;SAChB,CAAC,CAAC;QACH,MAAM,UAAU,CAAC,cAAc,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAC7C,IAAI,CAAC,WAAW,GAAG,UAAU,CAAC;IAChC,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,OAAuB;QAC1C,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC;QAC/C,eAAe,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;IACzC,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,KAAa,EAAE,MAA0B;QACxD,OAAO,MAAM,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IACvD,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,KAAa,EAAE,MAAe;QAC/C,OAAO,MAAM,IAAI,CAAC,WAAW,CAAC,YAAY,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAC5D,CAAC;IAED,KAAK,CAAC,cAAc;QAClB,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;IACjC,CAAC;CACF;AAED,OAAO,CAAC,MAAM,CAAC,IAAI,oBAAoB,EAAE,CAAC,CAAC"}

package/lib/db/adapters/options.d.ts

@@ -76,6 +76,13 @@ export interface WebSpecificOpenOptions {
      * A worker will be initialized if none is provided
      */
     workerPort?: MessagePort | undefined;
+    /**
+     * If set to a value greater than zero, the worker will cache prepared statements to avoid preparing them every time
+     * a query runs.
+     *
+     * Defaults to 0 (disabling the cache).
+     */
+    preparedStatementsCache?: number;
 }
 export interface ResolvedWebSQLOpenOptions extends SQLOpenOptions, WebSpecificOpenOptions {
 }

package/lib/db/adapters/options.js.map

@@ -1 +1 @@
-{"version":3,"file":"options.js","sourceRoot":"","sources":["../../../src/db/adapters/options.ts"],"names":[],"mappings":"AAgGA,MAAM,CAAN,IAAY,sBAGX;AAHD,WAAY,sBAAsB;IAChC,2CAAiB,CAAA;IACjB,6CAAmB,CAAA;AACrB,CAAC,EAHW,sBAAsB,KAAtB,sBAAsB,QAGjC"}
+{"version":3,"file":"options.js","sourceRoot":"","sources":["../../../src/db/adapters/options.ts"],"names":[],"mappings":"AAwGA,MAAM,CAAN,IAAY,sBAGX;AAHD,WAAY,sBAAsB;IAChC,2CAAiB,CAAA;IACjB,6CAAmB,CAAA;AACrB,CAAC,EAHW,sBAAsB,KAAtB,sBAAsB,QAGjC"}

package/lib/db/adapters/wa-sqlite/RawSqliteConnection.d.ts

@@ -18,6 +18,10 @@ export interface RawWaSqliteDatabaseOptions {
     encryptionKey: string | undefined;
     temporaryStorage: TemporaryStorageOption;
     cacheSizeKb: number;
+    /**
+     * The amount of prepared statements to cache, or 0 to disable caching.
+     */
+    preparedStatementsCache: number;
 }
 /**
  * A small wrapper around WA-sqlite to help with opening databases and running statements by preparing them internally.
@@ -28,13 +32,16 @@ export interface RawWaSqliteDatabaseOptions {
 export declare class RawSqliteConnection {
     readonly options: RawWaSqliteDatabaseOptions;
     private _sqliteAPI;
+    private sqlite3_stmt_isexplain;
     /**
      * The `sqlite3*` connection pointer.
      */
     private db;
+    private statementCache;
     constructor(options: RawWaSqliteDatabaseOptions);
     get isOpen(): boolean;
     init(): Promise<void>;
+    initWithModule(module: any, vfs: any): Promise<void>;
     private openSQLiteAPI;
     requireSqlite(): SQLiteAPI;
     /**
@@ -52,4 +59,5 @@ export declare class RawSqliteConnection {
     executeRaw(sql: string, bindings?: any[]): Promise<RawResultSet[]>;
     private stepThroughStatement;
     close(): Promise<void>;
+    private cachedStatements;
 }

package/lib/db/adapters/wa-sqlite/RawSqliteConnection.js

@@ -1,6 +1,7 @@
 import { Factory as WaSqliteFactory, SQLITE_ROW } from '@journeyapps/wa-sqlite';
 import { loadModuleAndVfs } from './vfs.js';
 import { maxPathNameLength } from '../resolveAndValidateOptions.js';
+import { PreparedStatementCache } from './StatementCache.js';
 /**
  * A small wrapper around WA-sqlite to help with opening databases and running statements by preparing them internally.
  *
@@ -10,18 +11,26 @@ import { maxPathNameLength } from '../resolveAndValidateOptions.js';
 export class RawSqliteConnection {
     options;
     _sqliteAPI = null;
+    sqlite3_stmt_isexplain;
     /**
      * The `sqlite3*` connection pointer.
      */
     db = 0;
+    statementCache;
     constructor(options) {
         this.options = options;
+        this.statementCache =
+            options.preparedStatementsCache > 0 ? new PreparedStatementCache(options.preparedStatementsCache) : null;
     }
     get isOpen() {
         return this.db != 0;
     }
     async init() {
-        const api = (this._sqliteAPI = await this.openSQLiteAPI());
+        const { module, vfs } = await loadModuleAndVfs(this.options);
+        await this.initWithModule(module, vfs);
+    }
+    async initWithModule(module, vfs) {
+        const api = (this._sqliteAPI = await this.openSQLiteAPI(module, vfs));
         this.db = await api.open_v2(this.options.filename, this.options.readonly ? 1 /* SQLITE_OPEN_READONLY */ : 6 /* SQLITE_OPEN_READWRITE | SQLITE_OPEN_CREATE */);
         await this.executeRaw(`PRAGMA temp_store = ${this.options.temporaryStorage};`);
         if (this.options.encryptionKey) {
@@ -31,9 +40,9 @@ export class RawSqliteConnection {
         await this.executeRaw(`PRAGMA cache_size = -${this.options.cacheSizeKb};`);
         await this.executeRaw(`SELECT powersync_update_hooks('install');`);
     }
-    async openSQLiteAPI() {
-        const { module, vfs } = await loadModuleAndVfs(this.options);
+    async openSQLiteAPI(module, vfs) {
         vfs.mxPathname = maxPathNameLength;
+        this.sqlite3_stmt_isexplain = module.cwrap('sqlite3_stmt_isexplain', 'int', ['int']);
         const sqlite3 = WaSqliteFactory(module);
         sqlite3.vfs_register(vfs, true);
         /**
@@ -101,7 +110,7 @@ export class RawSqliteConnection {
     async executeRaw(sql, bindings) {
         const results = [];
         const api = this.requireSqlite();
-        for await (const stmt of api.statements(this.db, sql)) {
+        for await (const stmt of this.cachedStatements(api, sql)) {
             let columns;
             const rs = await this.stepThroughStatement(api, stmt, bindings ?? [], columns);
             columns = rs.columnNames;
@@ -138,9 +147,51 @@ export class RawSqliteConnection {
     }
     async close() {
         if (this.isOpen) {
-            await this.requireSqlite().close(this.db);
+            const api = this.requireSqlite();
+            if (this.statementCache) {
+                for (const stmt of this.statementCache.drain()) {
+                    await api.finalize(stmt);
+                }
+            }
+            await api.close(this.db);
             this.db = 0;
         }
     }
+    async *cachedStatements(api, sql) {
+        {
+            const existing = this.statementCache?.lookup(sql);
+            if (existing != null) {
+                yield existing;
+                return;
+            }
+        }
+        const inner = api.statements(this.db, sql, { unscoped: true });
+        const preparedStatements = [];
+        try {
+            for await (const stmt of inner) {
+                preparedStatements.push(stmt);
+                yield stmt;
+            }
+        }
+        finally {
+            // We can only cache statements if the sql text corresponds to a single statement, otherwise it's not clear what
+            // portion of the original sql text to use as a key.
+            if (preparedStatements.length === 1 && this.statementCache) {
+                const stmt = preparedStatements[0];
+                // Don't cache EXPLAIN statements, their result becomes invalid after schema changes.
+                if (this.sqlite3_stmt_isexplain(stmt) == 0) {
+                    const evicted = this.statementCache.addStatement(sql, stmt);
+                    if (evicted != null) {
+                        await api.finalize(evicted);
+                    }
+                    return;
+                }
+            }
+            // We're not caching statements, so finalize them.
+            for (const stmt of preparedStatements) {
+                await api.finalize(stmt);
+            }
+        }
+    }
 }
 //# sourceMappingURL=RawSqliteConnection.js.map

package/lib/db/adapters/wa-sqlite/RawSqliteConnection.js.map

@@ -1 +1 @@
-{"version":3,"file":"RawSqliteConnection.js","sourceRoot":"","sources":["../../../../src/db/adapters/wa-sqlite/RawSqliteConnection.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"RawSqliteConnection.js","sourceRoot":"","sources":["../../../../src/db/adapters/wa-sqlite/RawSqliteConnection.ts"],"names":[],"mappings":"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"}

package/lib/db/adapters/wa-sqlite/StatementCache.d.ts

@@ -0,0 +1,16 @@
+export declare class PreparedStatementCache {
+    #private;
+    constructor(size: number);
+    /**
+     * Attempts to look up the cached sql statement, if it's currently cached.
+     */
+    lookup(sql: string): number | null;
+    /**
+     * Adds a new statement into the cache.
+     *
+     * If that exceeds the target size of the statement cache, returns an old statement to evict.
+     * The caller is responsible for freeing that statement.
+     */
+    addStatement(sql: string, statement: number): number | null;
+    drain(): number[];
+}