@powersync/web 2.1.1 → 2.2.0

package/lib/db/PowerSyncDatabase.js

@@ -102,27 +102,32 @@ export class WebPowerSyncDatabase extends BasePowerSyncDatabase {
             identifier: this.database.name,
             logger: this.logger
         };
-        switch (true) {
-            case this.resolvedOpenOptions.ssrMode:
-                return new SSRStreamingSyncImplementation();
-            case this.resolvedOpenOptions.enableMultiTabs:
-                if (!this.enableBroadcastLogs) {
-                    const warning = `
+        if (this.resolvedOpenOptions.ssrMode) {
+            return new SSRStreamingSyncImplementation();
+        }
+        else if (this.resolvedOpenOptions.enableMultiTabs) {
+            if (!this.enableBroadcastLogs) {
+                const warning = `
             Multiple tabs are enabled, but broadcasting of logs is disabled.
             Logs for shared sync worker will only be available in the shared worker context
           `;
-                    const logger = this.options.logger;
-                    logger ? logger.log({ level: LogLevels.warn, message: warning }) : console.warn(warning);
-                }
+                const logger = this.options.logger;
+                logger ? logger.log({ level: LogLevels.warn, message: warning }) : console.warn(warning);
+            }
+            if ('shareConnection' in this.database) {
                 return new SharedWebStreamingSyncImplementation({
                     ...syncOptions,
                     db: this.database, // This should always be the case
                     logLevel: this.options.sync?.logLevel ?? LogLevels.info,
                     enableBroadcastLogs: this.enableBroadcastLogs
                 });
-            default:
-                return new TabLocalStreamingSyncImplementation(syncOptions);
+            }
+            this.logger.log({
+                level: LogLevels.warn,
+                message: "Not using a shared sync worker because the database adapter doesn't support it."
+            });
         }
+        return new TabLocalStreamingSyncImplementation(syncOptions);
     }
 }
 /**

package/lib/db/PowerSyncDatabase.js.map

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

package/lib/db/adapters/AsyncWebAdapter.js

@@ -1,5 +1,6 @@
 import { DBAdapter } from '@powersync/common';
 import { Mutex, Semaphore } from '@powersync/shared-internals';
+import { acquireFromPool } from './acquireFromPool.js';
 /**
  * A connection pool implementation delegating to another pool opened asynchronnously.
  */
@@ -95,61 +96,9 @@ function readWritePoolState(writer, readers) {
     return {
         writer,
         async withConnection(allowReadOnly, fn, options) {
-            const abortController = new AbortController();
-            const abortSignal = abortController.signal;
-            let timeout = null;
-            let release;
-            if (options?.timeoutMs) {
-                timeout = setTimeout(() => abortController.abort('requesting database timed out'), options.timeoutMs);
-            }
-            try {
-                if (allowReadOnly) {
-                    let connection;
-                    // Even if we have a pool of read connections, it's typically very small and we assume that most queries are
-                    // reads. So, we want to request any connection from the read pool and the dedicated write connection (which
-                    // can also serve reads). We race for the first connection we can obtain this way, and then abort the other
-                    // request.
-                    [connection, release] = await new Promise((resolve, reject) => {
-                        let didComplete = false;
-                        function complete() {
-                            didComplete = true;
-                            abortController.abort();
-                        }
-                        function completeSuccess(connection, returnFn) {
-                            if (didComplete) {
-                                // We're not going to use this connection, so return it immediately.
-                                returnFn();
-                            }
-                            else {
-                                complete();
-                                resolve([connection, returnFn]);
-                            }
-                        }
-                        function completeError(error) {
-                            // We either have a working connection already, or we've rejected the promise. Either way, we don't need
-                            // to do either thing again.
-                            if (didComplete)
-                                return;
-                            complete();
-                            reject(error);
-                        }
-                        writerMutex.acquire(abortSignal).then((unlock) => completeSuccess(writer, unlock), completeError);
-                        readerSemaphore
-                            .requestOne(abortSignal)
-                            .then(({ item, release }) => completeSuccess(item, release), completeError);
-                    });
-                    return await connection.readLock(fn);
-                }
-                else {
-                    return await writerMutex.runExclusive(() => writer.writeLock(fn), abortSignal);
-                }
-            }
-            finally {
-                if (timeout != null) {
-                    clearTimeout(timeout);
-                }
-                release?.();
-            }
+            return acquireFromPool(writerMutex, writer, readerSemaphore, (connection) => {
+                return allowReadOnly ? connection.readLock(fn) : connection.writeLock(fn);
+            }, options, allowReadOnly);
         },
         async close() {
             await writer.close();

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

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

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

@@ -0,0 +1,7 @@
+import type { DBLockOptions } from '@powersync/common';
+import type { Mutex, Semaphore } from '@powersync/shared-internals';
+/**
+ * Internal helper function to acquire a connection from a pool that has a designated writer, additional readers, and
+ * also allows dispatching reads to the writer.
+ */
+export declare function acquireFromPool<Connection, Res>(writerMutex: Mutex, writer: Connection, readers: Semaphore<Connection> | undefined, callback: (connection: Connection) => Promise<Res>, options: DBLockOptions | undefined, allowReadOnly: boolean): Promise<Res>;

package/lib/db/adapters/acquireFromPool.js

@@ -0,0 +1,60 @@
+/**
+ * Internal helper function to acquire a connection from a pool that has a designated writer, additional readers, and
+ * also allows dispatching reads to the writer.
+ */
+export async function acquireFromPool(writerMutex, writer, readers, callback, options, allowReadOnly) {
+    const abortController = new AbortController();
+    const abortSignal = abortController.signal;
+    let timeout = null;
+    let release;
+    if (options?.timeoutMs) {
+        timeout = setTimeout(() => abortController.abort('requesting database timed out'), options.timeoutMs);
+    }
+    try {
+        if (allowReadOnly) {
+            let connection;
+            // Even if we have a pool of read connections, it's typically very small and we assume that most queries are
+            // reads. So, we want to request any connection from the read pool and the dedicated write connection (which
+            // can also serve reads). We race for the first connection we can obtain this way, and then abort the other
+            // request.
+            [connection, release] = await new Promise((resolve, reject) => {
+                let didComplete = false;
+                function complete() {
+                    didComplete = true;
+                    abortController.abort();
+                }
+                function completeSuccess(connection, returnFn) {
+                    if (didComplete) {
+                        // We're not going to use this connection, so return it immediately.
+                        returnFn();
+                    }
+                    else {
+                        complete();
+                        resolve([connection, returnFn]);
+                    }
+                }
+                function completeError(error) {
+                    // We either have a working connection already, or we've rejected the promise. Either way, we don't need
+                    // to do either thing again.
+                    if (didComplete)
+                        return;
+                    complete();
+                    reject(error);
+                }
+                writerMutex.acquire(abortSignal).then((unlock) => completeSuccess(writer, unlock), completeError);
+                readers?.requestOne(abortSignal).then(({ item, release }) => completeSuccess(item, release), completeError);
+            });
+            return await callback(connection);
+        }
+        else {
+            return await writerMutex.runExclusive(() => callback(writer), abortSignal);
+        }
+    }
+    finally {
+        if (timeout != null) {
+            clearTimeout(timeout);
+        }
+        release?.();
+    }
+}
+//# sourceMappingURL=acquireFromPool.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"acquireFromPool.js","sourceRoot":"","sources":["../../../src/db/adapters/acquireFromPool.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,WAAkB,EAClB,MAAkB,EAClB,OAA0C,EAC1C,QAAkD,EAClD,OAAkC,EAClC,aAAsB;IAEtB,MAAM,eAAe,GAAG,IAAI,eAAe,EAAE,CAAC;IAC9C,MAAM,WAAW,GAAG,eAAe,CAAC,MAAM,CAAC;IAE3C,IAAI,OAAO,GAAQ,IAAI,CAAC;IACxB,IAAI,OAA6B,CAAC;IAClC,IAAI,OAAO,EAAE,SAAS,EAAE,CAAC;QACvB,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,eAAe,CAAC,KAAK,CAAC,+BAA+B,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;IACxG,CAAC;IAED,IAAI,CAAC;QACH,IAAI,aAAa,EAAE,CAAC;YAClB,IAAI,UAAsB,CAAC;YAE3B,4GAA4G;YAC5G,4GAA4G;YAC5G,2GAA2G;YAC3G,WAAW;YACX,CAAC,UAAU,EAAE,OAAO,CAAC,GAAG,MAAM,IAAI,OAAO,CAAyB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;gBACpF,IAAI,WAAW,GAAG,KAAK,CAAC;gBACxB,SAAS,QAAQ;oBACf,WAAW,GAAG,IAAI,CAAC;oBACnB,eAAe,CAAC,KAAK,EAAE,CAAC;gBAC1B,CAAC;gBAED,SAAS,eAAe,CAAC,UAAsB,EAAE,QAAkB;oBACjE,IAAI,WAAW,EAAE,CAAC;wBAChB,oEAAoE;wBACpE,QAAQ,EAAE,CAAC;oBACb,CAAC;yBAAM,CAAC;wBACN,QAAQ,EAAE,CAAC;wBACX,OAAO,CAAC,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC,CAAC;oBAClC,CAAC;gBACH,CAAC;gBAED,SAAS,aAAa,CAAC,KAAc;oBACnC,wGAAwG;oBACxG,4BAA4B;oBAC5B,IAAI,WAAW;wBAAE,OAAO;oBAExB,QAAQ,EAAE,CAAC;oBACX,MAAM,CAAC,KAAK,CAAC,CAAC;gBAChB,CAAC;gBAED,WAAW,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,eAAe,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,aAAa,CAAC,CAAC;gBAClG,OAAO,EAAE,UAAU,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,eAAe,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,aAAa,CAAC,CAAC;YAC9G,CAAC,CAAC,CAAC;YAEH,OAAO,MAAM,QAAQ,CAAC,UAAU,CAAC,CAAC;QACpC,CAAC;aAAM,CAAC;YACN,OAAO,MAAM,WAAW,CAAC,YAAY,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC,CAAC;QAC7E,CAAC;IACH,CAAC;YAAS,CAAC;QACT,IAAI,OAAO,IAAI,IAAI,EAAE,CAAC;YACpB,YAAY,CAAC,OAAO,CAAC,CAAC;QACxB,CAAC;QACD,OAAO,EAAE,EAAE,CAAC;IACd,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,70 @@
+import { DBAdapter, DBLockOptions, LockContext } from '@powersync/common';
+import type { RawWaSqliteDatabaseOptions } from '../wa-sqlite/RawSqliteConnection.js';
+/**
+ * Options for a {@link InMemoryWriteAheadLogPool}.
+ */
+export interface InMemoryWriteAheadLogPoolOptions {
+    /**
+     * The amount of workers to use, must at least be `1`.
+     */
+    numWorkers: number;
+    /**
+     * Optional additional options used to configure how the database is opened in workers.
+     */
+    database?: Partial<RawWaSqliteDatabaseOptions>;
+    /**
+     * The maximum size of the database buffer, in bytes.
+     *
+     * This VFS uses a growable buffer, so not all of this is allocated immediately. By default, the VFS attempts to use
+     * 16 GB and falls back to 1 GB if that fails (e.g. on 32-bit platforms).
+     */
+    maxDatabaseSize?: number;
+    /**
+     * The maximum size of the write-ahead log, in bytes.
+     *
+     * The size of the write-ahead log constraints the amount of data that can be written in a single transaction.
+     *
+     * This VFS uses a growable buffer, so not all of this is allocated immediately. By default, the VFS attempts to use
+     * 1 GB.
+     */
+    maxWriteAheadLogSize?: number;
+}
+/**
+ * An in-memory database backed by a pool of workers.
+ *
+ * Multiple workers can execute readonly transactions in parallel, and a single writer is allowed to write to the
+ * database in parallel to readers. To allow multiple workers to access the same database, this is based on shared array
+ * buffers and requires the page to be [cross-origin isolated](https://web.dev/articles/cross-origin-isolation-guide).
+ *
+ * To use this VFS, pass it to the {@link PowerSyncDatabase} constructor:
+ *
+ * ```TypeScript
+ * import { PowerSyncDatabase, Schema } from '@powersync/web';
+ * import InMemoryWriteAheadLogPool from '@powersync/web/extra/shared-memory-pool';
+ *
+ * const db = new PowerSyncDatabase({
+ *   opened: new InMemoryWriteAheadLogPool({numWorkers: 3}),
+ *   schema: new Schema(...),
+ * });
+ * ```
+ *
+ * This database uses a concept known as a write-ahead log: Instead of writing changes directly to the database (which
+ * would cause conflicts with readers), the writer appends modified database pages into an append-only overlay log. When
+ * readers start a transaction, they consider the main database and items from the log until a specific position,
+ * meaning that future appends won't disrupt existing readers.
+ *
+ * To avoid the write-ahead log from growing indefinitely, it is regularly copied back into the main database file. This
+ * process is called a checkpoint, and in this implementation it blocks all other database access. However, it only
+ * needs to copy between memory and is usually fairly fast. This implementation checkpoints after a transaction
+ * completes and at least 10% of the WAL are used. We might fine-tune this later.
+ */
+export declare class InMemoryWriteAheadLogPool extends DBAdapter {
+    #private;
+    readonly name: string;
+    constructor(options: InMemoryWriteAheadLogPoolOptions);
+    readLock<T>(fn: (tx: LockContext) => Promise<T>, options?: DBLockOptions): Promise<T>;
+    writeLock<T>(fn: (tx: LockContext) => Promise<T>, options?: DBLockOptions): Promise<T>;
+    refreshSchema(): Promise<void>;
+    close(): Promise<void>;
+}
+export default InMemoryWriteAheadLogPool;

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

@@ -0,0 +1,269 @@
+import * as Comlink from 'comlink';
+import { DBAdapter, LockContext, queryResultWithoutRows } from '@powersync/common';
+import { applyWalChanges, emptyWalState } from './shared.js';
+import { Mutex, Semaphore } from '@powersync/shared-internals';
+import { acquireFromPool } from '../acquireFromPool.js';
+function createWriteAheadLogBuffers(options) {
+    const gigabyte = 1024 * 1024 * 1024;
+    let database;
+    if (options.maxDatabaseSize) {
+        database = new SharedArrayBuffer(0, { maxByteLength: options.maxDatabaseSize });
+    }
+    else {
+        try {
+            database = new SharedArrayBuffer(0, { maxByteLength: 16 * gigabyte });
+        }
+        catch {
+            database = new SharedArrayBuffer(0, { maxByteLength: 1 * gigabyte });
+        }
+    }
+    return {
+        database,
+        writeAheadLog: new SharedArrayBuffer(0, { maxByteLength: options.maxWriteAheadLogSize ?? 1 * gigabyte })
+    };
+}
+/**
+ * An in-memory database backed by a pool of workers.
+ *
+ * Multiple workers can execute readonly transactions in parallel, and a single writer is allowed to write to the
+ * database in parallel to readers. To allow multiple workers to access the same database, this is based on shared array
+ * buffers and requires the page to be [cross-origin isolated](https://web.dev/articles/cross-origin-isolation-guide).
+ *
+ * To use this VFS, pass it to the {@link PowerSyncDatabase} constructor:
+ *
+ * ```TypeScript
+ * import { PowerSyncDatabase, Schema } from '@powersync/web';
+ * import InMemoryWriteAheadLogPool from '@powersync/web/extra/shared-memory-pool';
+ *
+ * const db = new PowerSyncDatabase({
+ *   opened: new InMemoryWriteAheadLogPool({numWorkers: 3}),
+ *   schema: new Schema(...),
+ * });
+ * ```
+ *
+ * This database uses a concept known as a write-ahead log: Instead of writing changes directly to the database (which
+ * would cause conflicts with readers), the writer appends modified database pages into an append-only overlay log. When
+ * readers start a transaction, they consider the main database and items from the log until a specific position,
+ * meaning that future appends won't disrupt existing readers.
+ *
+ * To avoid the write-ahead log from growing indefinitely, it is regularly copied back into the main database file. This
+ * process is called a checkpoint, and in this implementation it blocks all other database access. However, it only
+ * needs to copy between memory and is usually fairly fast. This implementation checkpoints after a transaction
+ * completes and at least 10% of the WAL are used. We might fine-tune this later.
+ */
+export class InMemoryWriteAheadLogPool extends DBAdapter {
+    // Note that this name is also used as an identifier for sync navigator locks, so we want it to be unique. As there is
+    // no persistence, the name is not configurable and serves no other purpose.
+    name = `in-memory-${crypto.randomUUID()}`;
+    #buffers;
+    // There is nothing that tells the read and write workers apart, and we will use a write worker for reads too. But we
+    // must have a single designated write worker, because sync state is stored on the connection and the sync client
+    // relies on this.
+    #readers;
+    #underlyingReaders = [];
+    #writer;
+    #writeLock = new Mutex();
+    #walState = emptyWalState();
+    #checkpointThreshold;
+    constructor(options) {
+        super();
+        if (options.numWorkers < 1) {
+            throw new Error('Need at least one worker');
+        }
+        this.#buffers = createWriteAheadLogBuffers(options);
+        this.#checkpointThreshold = this.#buffers.writeAheadLog.maxByteLength / 10;
+        this.#writer = new PoolWorker(this.#buffers, options.database ?? {});
+        for (let i = 0; i < options.numWorkers - 1; i++) {
+            this.#underlyingReaders.push(new PoolWorker(this.#buffers, options.database ?? {}));
+        }
+        if (this.#underlyingReaders.length) {
+            this.#readers = new Semaphore(this.#underlyingReaders);
+        }
+    }
+    async #withWorker(allowReadOnly, fn, lockOptions) {
+        return acquireFromPool(this.#writeLock, this.#writer, this.#readers, async (worker) => {
+            await worker.pushWalState();
+            return await fn(worker);
+        }, lockOptions, allowReadOnly);
+    }
+    readLock(fn, options) {
+        return this.#withWorker(true, fn, options);
+    }
+    /**
+     * Moves data from the write-ahead log overlay into the main database file.
+     *
+     * This may only be called with the writers and all readers locked.
+     */
+    #checkpoint(changes) {
+        const walBuffer = this.#buffers.writeAheadLog;
+        const databaseBuffer = this.#buffers.database;
+        const newFileSize = changes.fileSize;
+        // Note: Checkpointing can fail (e.g. due to us exceeding the max db size), in which case we must tell the
+        // writer to drop the WAL changes it has made to consistently roll back the failure after throwing.
+        try {
+            if (databaseBuffer.byteLength < newFileSize) {
+                databaseBuffer.grow(newFileSize);
+            }
+            function copyFromWal(dbOffset, overlayEntry) {
+                const source = new Uint8Array(walBuffer, overlayEntry.logOffset, overlayEntry.size);
+                new Uint8Array(databaseBuffer, dbOffset).set(source);
+            }
+            // Checkpoint existing entries from previous writes.
+            for (const [pageOffset, overlayEntry] of this.#walState.overlay.entries()) {
+                copyFromWal(pageOffset, overlayEntry);
+            }
+            // Checkpoint changes from the last writeLock call that haven't been applied yet.
+            for (let i = 0; i < changes.added.length; i += 2) {
+                const dbOffset = changes.added[i];
+                const walEntry = changes.added[i + 1];
+                copyFromWal(dbOffset, walEntry);
+            }
+        }
+        catch (e) {
+            // Checkpointing failed, reset the state in the write worker to the local state here.
+            const allEntries = [];
+            this.#walState.overlay.forEach((entry, offset) => allEntries.push(offset, entry));
+            this.#writer.addChanges({
+                cleared: true,
+                fileSize: this.#walState.fileSize,
+                walEnd: this.#walState.walEnd,
+                added: allEntries
+            });
+            throw e;
+        }
+        // Checkpoint complete, inform all workers to reset their WAL view when they're used again.
+        const cleared = { cleared: true, fileSize: newFileSize, walEnd: 0, added: [] };
+        applyWalChanges(this.#walState, cleared);
+        this.#writer.addChanges(cleared);
+        for (const worker of this.#underlyingReaders) {
+            worker.addChanges(cleared);
+        }
+    }
+    /**
+     * Propagates WAL additions from the writer to other workers, checkpointing if necessary.
+     *
+     * The caller must hold the write lock for the duration of the call.
+     */
+    async #propagateChangesFromWriter(writer) {
+        const changes = await writer.takeWalChanges();
+        if (changes.walEnd > this.#checkpointThreshold) {
+            // Instead of applying these changes to the local overlay and other workers, checkpoint! This can't run
+            // concurrently with anything else, so acquire read workers workers (we already have the  write lock when this
+            // gets called).
+            const acquiredReaders = await this.#readers?.requestAll();
+            try {
+                this.#checkpoint(changes);
+            }
+            finally {
+                acquiredReaders?.release();
+            }
+        }
+        else {
+            // No checkpoint necessary, just forward WAL changes to other workers.
+            applyWalChanges(this.#walState, changes);
+            for (const otherWorker of this.#underlyingReaders) {
+                otherWorker.addChanges(changes);
+            }
+        }
+    }
+    writeLock(fn, options) {
+        return this.#withWorker(false, // Don't allow read-only connection
+        async (worker) => {
+            try {
+                const res = await fn(worker);
+                const { rawRows: [[updates]] } = await worker.executeRaw(`SELECT powersync_update_hooks('get')`);
+                const updatedTables = JSON.parse(updates);
+                if (updatedTables.length) {
+                    const notification = { tables: updatedTables };
+                    this.iterateListeners((l) => l.tablesUpdated?.(notification));
+                }
+                return res;
+            }
+            finally {
+                await this.#propagateChangesFromWriter(worker);
+            }
+        }, options);
+    }
+    async refreshSchema() {
+        // We only have to refresh readers, as the schema change itself was made on the write connection.
+        if (this.#readers) {
+            const { items, release } = await this.#readers.requestAll();
+            try {
+                await Promise.all(items.map(async (worker) => {
+                    await worker.pushWalState();
+                    await worker.executeRaw("pragma table_info('sqlite_master')");
+                }));
+            }
+            finally {
+                release();
+            }
+        }
+    }
+    async close() {
+        const releaseWriter = await this.#writeLock.acquire();
+        const readers = await this.#readers?.requestAll();
+        await Promise.race([this.#writer.close(), ...(readers?.items ?? []).map((e) => e.close())]);
+        releaseWriter();
+        readers?.release();
+    }
+}
+export default InMemoryWriteAheadLogPool;
+class PoolWorker extends LockContext {
+    #buffers;
+    #options;
+    #worker;
+    #server;
+    #isInitialized = false;
+    #outstandingChanges = null;
+    constructor(buffers, options) {
+        super();
+        this.#buffers = buffers;
+        this.#options = options;
+        this.#worker = new Worker(new URL('./worker.js', import.meta.url), { type: 'module' });
+        this.#worker.onerror = (e) => {
+            console.error('Worker error', e);
+        };
+        this.#server = Comlink.wrap(this.#worker);
+    }
+    addChanges(changes) {
+        if (changes.cleared) {
+            this.#outstandingChanges = { fileSize: changes.fileSize, walEnd: 0, cleared: true, added: [] };
+        }
+        else {
+            const outstandingChanges = (this.#outstandingChanges ??= { fileSize: 0, walEnd: 0, added: [], cleared: false });
+            outstandingChanges.fileSize = changes.fileSize;
+            outstandingChanges.walEnd = changes.walEnd;
+            outstandingChanges.added.push(...changes.added);
+        }
+    }
+    async pushWalState() {
+        if (!this.#isInitialized) {
+            await this.#server.open(this.#buffers, this.#options);
+            this.#isInitialized = true;
+        }
+        const pending = this.#outstandingChanges;
+        if (pending) {
+            this.#outstandingChanges = null;
+            await this.#server.updateWalState(pending);
+        }
+    }
+    takeWalChanges() {
+        return this.#server.takeWalChanges();
+    }
+    executeRaw(query, params) {
+        return this.#server.executeRaw(query, params);
+    }
+    async executeBatch(query, params) {
+        const results = await this.#server.executeBatch(query, params ?? []);
+        const result = { insertId: undefined, rowsAffected: 0 };
+        for (const source of results) {
+            result.insertId = source.insertId;
+            result.rowsAffected = (result.rowsAffected ?? 0) + source.rowsAffected;
+        }
+        return queryResultWithoutRows(result);
+    }
+    close() {
+        this.#worker.terminate();
+    }
+}
+//# sourceMappingURL=client.js.map

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

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

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;