@statewalker/cellb 0.8.1 → 0.8.5

package/README.md

@@ -171,7 +171,10 @@ import { MemFilesApi } from "@statewalker/webrun-files-mem";
 
 const dir = "./counter"; // wrangler.jsonc and its `main`
 const { runtime, unsupported } = await loadNodeProject(dir, {
-  openSql: nodeSqliteOpener(), // in memory: every cell is restored from the bucket on first use
+  // Every cell starts empty and is restored from the bucket on first use. pageCapture logs each
+  // commit's pages from the WAL (O(changed pages)) instead of imaging the whole database per
+  // commit; without a directory, cells live in temporary files removed when they close.
+  openSql: nodeSqliteOpener(undefined, { pageCapture: true }),
   files: new MemFilesApi(), // blob store for large KV values
   storage: celldBucket(sqliteObjectStore(`${dir}/.celld/dev/objects.sqlite3`), { node: "cellb-1" }),
 });
@@ -308,8 +311,10 @@ docs/               topic pages
   the server end acknowledges the bytes of each message it dispatched and a client's
   `bufferedAmount` counts the bytes not acknowledged yet: the WHATWG signal a sender throttles on.
   workerd's server-side WebSocket has no `bufferedAmount`, and cellb's has none.
-- **Each loaded Worker gets a realm of its own**, a thread or a Dedicated Worker: as in celld's
-  isolates, loaded code must not see the host's globals or env.
+- **Each loaded Worker gets a realm of its own**, a worker thread in Node, or in a browser a
+  Dedicated Worker when `isolateScript` is set (the browser `loadProject` sets it;
+  `browserProjectRuntime` and the shard functions do not): as in celld's isolates, loaded code must
+  not see the host's globals or env.
 - **`idFromName` is synchronous**, with `@noble/hashes` instead of `crypto.subtle`, which is
   asynchronous only; Worker code relies on getting the id at once.
 - **Ownership depends on the deployment**: a Web Lock per shard in an origin, celld's ownership

package/dist/adapters/node-sqlite.d.ts

@@ -5,6 +5,7 @@ export declare class NodeSqliteDriver implements SyncSqlDriver {
     constructor(path?: string, opts?: {
         exclusive?: boolean;
         pageCapture?: boolean;
+        temporary?: boolean;
     });
     /** The pages of the transactions committed since the previous call (WAL frames). */
     takeDirtyPages(): {
@@ -34,10 +35,15 @@ export declare class NodeSqliteDriver implements SyncSqlDriver {
     /** Replaces the database file with `image` and reopens it (an in-memory DB becomes file-backed). */
     restore(image: Uint8Array): void;
 }
-/** One file per cell in `dir`, or in-memory when `dir` is omitted. */
 /**
- * `pageCapture` (file-backed only): WAL mode, and each commit's changed pages read from the WAL
- * (takeDirtyPages) — LTX logs then cost O(changed pages) on Node as with SQLite WASM.
+ * One file per cell in `dir`; without `dir`, each cell in memory.
+ *
+ * `pageCapture`: WAL mode, and each commit's changed pages read from the WAL (takeDirtyPages),
+ * so LTX logs (a celld bucket) cost O(changed pages) on Node as with SQLite WASM, instead of an
+ * image of the whole database (VACUUM INTO) and a page-by-page diff per commit. A WAL needs a
+ * file: without `dir`, each cell opened gets a temporary file (in a `cellb-cells-…` directory
+ * under the OS temp directory), removed when the cell closes, so it still starts empty each
+ * time as in memory (a bucket restores it).
  */
 export declare function nodeSqliteOpener(dir?: string, opts?: {
     exclusive?: boolean;

package/dist/adapters/node-sqlite.js

@@ -1,4 +1,4 @@
-import { closeSync, fstatSync, mkdtempSync, openSync, readFileSync, readSync, rmSync, writeFileSync, } from "node:fs";
+import { closeSync, existsSync, fstatSync, mkdtempSync, openSync, readFileSync, readSync, rmdirSync, rmSync, statSync, writeFileSync, } from "node:fs";
 import { createRequire } from "node:module";
 import { tmpdir } from "node:os";
 import { dirname, join } from "node:path";
@@ -15,8 +15,11 @@ export class NodeSqliteDriver {
     #path;
     #exclusive;
     #pageCapture;
+    /** A file of its own that close() removes (a cell "in memory" that needs a WAL). */
+    #temporary;
     constructor(path = ":memory:", opts = {}) {
         this.#path = path;
+        this.#temporary = !!opts.temporary && path !== ":memory:";
         this.#exclusive = !!opts.exclusive;
         this.#pageCapture = !!opts.pageCapture && path !== ":memory:";
         // As celld and workerd: a double-quoted name that is no column is a string literal.
@@ -39,10 +42,16 @@ export class NodeSqliteDriver {
     // instead of reading the whole file. Automatic checkpoints are off; take() checkpoints
     // (TRUNCATE) itself once the WAL grows, and restarts from its start.
     #walOffset = 0;
+    /** Whether anyone reads the captured pages; until then exec() keeps the WAL bounded itself. */
+    #taken = false;
+    #writes = 0;
     #walSetup() {
         if (!this.#pageCapture)
             return;
         this.#db.exec("PRAGMA journal_mode = WAL; PRAGMA wal_autocheckpoint = 0;");
+        // A temporary file is only the WAL's carrier (the bucket keeps the cell): no fsync per commit.
+        if (this.#temporary)
+            this.#db.exec("PRAGMA synchronous = OFF");
         this.#db.exec("PRAGMA wal_checkpoint(TRUNCATE)");
         this.#walOffset = 0;
     }
@@ -50,6 +59,7 @@ export class NodeSqliteDriver {
     takeDirtyPages() {
         if (!this.#pageCapture)
             return undefined;
+        this.#taken = true;
         const walPath = `${this.#path}-wal`;
         let fd;
         try {
@@ -118,6 +128,8 @@ export class NodeSqliteDriver {
             last = this.#one(text, params);
             written += last.rowsWritten;
         }
+        if (this.#pageCapture && !this.#taken && ++this.#writes % 64 === 0)
+            this.#boundWal();
         return { ...last, rowsWritten: written };
     }
     #one(sql, params) {
@@ -132,6 +144,23 @@ export class NodeSqliteDriver {
         const rows = stmt.all(...args).map((row) => row.map(fromSqlite));
         return { columnNames, rows, rowsWritten: 0 };
     }
+    /**
+     * A database whose pages nobody takes (the runtime's own tables, a storage that logs no pages)
+     * has no one to checkpoint its WAL (automatic checkpoints are off): past 4 MiB, fold it in.
+     */
+    #boundWal() {
+        if (this.inTransaction())
+            return;
+        try {
+            if (statSync(`${this.#path}-wal`).size <= 4 * 1024 * 1024)
+                return;
+        }
+        catch {
+            return;
+        }
+        this.#db.exec("PRAGMA wal_checkpoint(TRUNCATE)");
+        this.#walOffset = 0;
+    }
     inTransaction() {
         return this.#db.isTransaction;
     }
@@ -142,6 +171,15 @@ export class NodeSqliteDriver {
     }
     close() {
         this.#db.close();
+        if (!this.#temporary)
+            return;
+        for (const suffix of ["", "-wal", "-shm", "-journal"])
+            rmSync(this.#path + suffix, { force: true });
+        try {
+            rmdirSync(dirname(this.#path)); // the opener's directory, once its last cell is closed
+            temporaryDirs.delete(dirname(this.#path));
+        }
+        catch { }
     }
     // ---- change capture (session extension) for transaction logs -------------------------
     #session;
@@ -242,12 +280,51 @@ function fromSqlite(v) {
         return v.buffer.slice(v.byteOffset, v.byteOffset + v.byteLength);
     return v;
 }
-/** One file per cell in `dir`, or in-memory when `dir` is omitted. */
+/** Temporary cell directories still present: removed if the process exits without closing them. */
+const temporaryDirs = new Set();
+let exitHook = false;
+function removeAtExit(dir) {
+    temporaryDirs.add(dir);
+    if (exitHook)
+        return;
+    exitHook = true;
+    process.once("exit", () => {
+        for (const d of temporaryDirs)
+            rmSync(d, { recursive: true, force: true });
+    });
+}
 /**
- * `pageCapture` (file-backed only): WAL mode, and each commit's changed pages read from the WAL
- * (takeDirtyPages) — LTX logs then cost O(changed pages) on Node as with SQLite WASM.
+ * One file per cell in `dir`; without `dir`, each cell in memory.
+ *
+ * `pageCapture`: WAL mode, and each commit's changed pages read from the WAL (takeDirtyPages),
+ * so LTX logs (a celld bucket) cost O(changed pages) on Node as with SQLite WASM, instead of an
+ * image of the whole database (VACUUM INTO) and a page-by-page diff per commit. A WAL needs a
+ * file: without `dir`, each cell opened gets a temporary file (in a `cellb-cells-…` directory
+ * under the OS temp directory), removed when the cell closes, so it still starts empty each
+ * time as in memory (a bucket restores it).
  */
 export function nodeSqliteOpener(dir, opts = {}) {
-    return (cellKey) => new NodeSqliteDriver(dir ? `${dir}/${cellKey.replace(/[^\w.-]/g, "_")}.sqlite` : ":memory:", opts);
+    let temp;
+    let opened = 0;
+    return (cellKey) => {
+        const name = cellKey.replace(/[^\w.-]/g, "_");
+        // The runtime's own databases (alarms index, cron state) log no pages: never captured.
+        const capture = !!opts.pageCapture && !cellKey.startsWith("__cellb/");
+        const o = { ...opts, pageCapture: capture };
+        if (dir)
+            return new NodeSqliteDriver(`${dir}/${name}.sqlite`, o);
+        if (!capture)
+            return new NodeSqliteDriver(":memory:", o);
+        if (!temp || !existsSync(temp)) {
+            temp = mkdtempSync(join(tmpdir(), "cellb-cells-"));
+            removeAtExit(temp);
+        }
+        // A file per opening: a cell reopened while its previous database is still closing gets
+        // a fresh one, as in memory.
+        return new NodeSqliteDriver(join(temp, `${name}-${++opened}.sqlite`), {
+            ...o,
+            temporary: true,
+        });
+    };
 }
 //# sourceMappingURL=node-sqlite.js.map

package/dist/adapters/node-sqlite.js.map

@@ -1 +1 @@
-{"version":3,"file":"node-sqlite.js","sourceRoot":"","sources":["../../src/adapters/node-sqlite.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  closeSync,\n  fstatSync,\n  mkdtempSync,\n  openSync,\n  readFileSync,\n  readSync,\n  rmSync,\n  writeFileSync,\n} from \"node:fs\";\nimport { createRequire } from \"node:module\";\nimport { tmpdir } from \"node:os\";\nimport { dirname, join } from \"node:path\";\nimport type { DatabaseSync as DatabaseSyncT } from \"node:sqlite\";\n\nimport { splitSqlStatements } from \"../core/sql-split.js\";\nimport type { OpenCellSql, SqlResult, SyncSqlDriver } from \"../ports.js\";\nimport { requireNodeSqlite } from \"./node-sqlite-module.js\";\n\nconst { DatabaseSync } = requireNodeSqlite();\n\nconst requireCjs = createRequire(import.meta.url);\nconst KNOWN_EXTENSIONS: Record<string, () => string> = {\n  sqlite_vec: () => (requireCjs(\"sqlite-vec\") as { getLoadablePath(): string }).getLoadablePath(),\n};\n\n/** Server-side SyncSqlDriver over node:sqlite (Node >= 22.13). */\nexport class NodeSqliteDriver implements SyncSqlDriver {\n  #db: DatabaseSyncT;\n  #path: string;\n  readonly #exclusive: boolean;\n  readonly #pageCapture: boolean;\n  constructor(path = \":memory:\", opts: { exclusive?: boolean; pageCapture?: boolean } = {}) {\n    this.#path = path;\n    this.#exclusive = !!opts.exclusive;\n    this.#pageCapture = !!opts.pageCapture && path !== \":memory:\";\n    // As celld and workerd: a double-quoted name that is no column is a string literal.\n    this.#db = new DatabaseSync(path, {\n      allowExtension: true,\n      enableDoubleQuotedStringLiterals: true,\n    });\n    this.#db.enableLoadExtension(false); // only loadExtension() below may load, by name\n    // EXCLUSIVE locking: the first write takes an OS lock on the file that is\n    // kept until close (or process death) — a second process can neither read\n    // nor write the cell. Storage-level fencing on one host, no lease needed.\n    if (opts.exclusive) this.#db.exec(\"PRAGMA locking_mode = EXCLUSIVE; PRAGMA busy_timeout = 0;\");\n    this.#walSetup();\n  }\n\n  // ---- page capture through the WAL (what the WASM driver does with its xWrite hook) ----\n  // In WAL mode every commit appends its changed pages to `<db>-wal` as frames (24-byte frame\n  // header + page; a commit frame carries the database size in pages). Reading the frames\n  // appended since the last read gives exactly the committed transaction's pages, O(changed),\n  // instead of reading the whole file. Automatic checkpoints are off; take() checkpoints\n  // (TRUNCATE) itself once the WAL grows, and restarts from its start.\n  #walOffset = 0;\n  #walSetup(): void {\n    if (!this.#pageCapture) return;\n    this.#db.exec(\"PRAGMA journal_mode = WAL; PRAGMA wal_autocheckpoint = 0;\");\n    this.#db.exec(\"PRAGMA wal_checkpoint(TRUNCATE)\");\n    this.#walOffset = 0;\n  }\n  /** The pages of the transactions committed since the previous call (WAL frames). */\n  takeDirtyPages():\n    | { pageSize: number; pageCount: number; pages: Map<number, Uint8Array> }\n    | undefined {\n    if (!this.#pageCapture) return undefined;\n    const walPath = `${this.#path}-wal`;\n    let fd: number;\n    try {\n      fd = openSync(walPath, \"r\");\n    } catch {\n      return undefined;\n    }\n    try {\n      const size = fstatSync(fd).size;\n      if (size < 32) return undefined;\n      const header = Buffer.alloc(32);\n      readSync(fd, header, 0, 32, 0);\n      const pageSize = header.readUInt32BE(8) === 1 ? 65536 : header.readUInt32BE(8);\n      const [salt1, salt2] = [header.readUInt32BE(16), header.readUInt32BE(20)];\n      const frameSize = 24 + pageSize;\n      let offset = Math.max(32, this.#walOffset);\n      const pending = new Map<number, Uint8Array>();\n      const pages = new Map<number, Uint8Array>();\n      let pageCount = 0;\n      let committedTo = offset;\n      const frame = Buffer.alloc(frameSize);\n      while (offset + frameSize <= size) {\n        readSync(fd, frame, 0, frameSize, offset);\n        if (frame.readUInt32BE(8) !== salt1 || frame.readUInt32BE(12) !== salt2) break; // stale frames\n        pending.set(frame.readUInt32BE(0), new Uint8Array(frame.subarray(24)));\n        offset += frameSize;\n        const commit = frame.readUInt32BE(4);\n        if (commit) {\n          for (const [p, d] of pending) pages.set(p, d);\n          pending.clear();\n          pageCount = commit;\n          committedTo = offset;\n        }\n      }\n      this.#walOffset = committedTo;\n      if (!pageCount)\n        return {\n          pageSize,\n          pageCount: Number(this.exec(\"PRAGMA page_count\", []).rows[0][0]),\n          pages,\n        };\n      for (const p of [...pages.keys()]) if (p > pageCount) pages.delete(p);\n      // keep the WAL bounded: fold it into the database and start over\n      if (committedTo > 4 * 1024 * 1024) {\n        this.#db.exec(\"PRAGMA wal_checkpoint(TRUNCATE)\");\n        this.#walOffset = 0;\n      }\n      return { pageSize, pageCount, pages };\n    } finally {\n      closeSync(fd);\n    }\n  }\n  exec(sql: string, params: unknown[]): SqlResult {\n    const statements = params.length === 0 ? splitSqlStatements(sql) : [sql];\n    // Several statements: the result of the last one, with the rows written by all of them.\n    let last: SqlResult = { columnNames: [], rows: [], rowsWritten: 0 };\n    let written = 0;\n    for (const text of statements) {\n      last = this.#one(text, params);\n      written += last.rowsWritten;\n    }\n    return { ...last, rowsWritten: written };\n  }\n  #one(sql: string, params: unknown[]): SqlResult {\n    const stmt = this.#db.prepare(sql);\n    const columnNames = stmt.columns().map((c) => c.name);\n    const args = params.map(toSqlite) as any[];\n    if (columnNames.length === 0) {\n      const r = stmt.run(...args);\n      return { columnNames, rows: [], rowsWritten: Number(r.changes) };\n    }\n    stmt.setReturnArrays(true);\n    const rows = (stmt.all(...args) as unknown as unknown[][]).map((row) => row.map(fromSqlite));\n    return { columnNames, rows, rowsWritten: 0 };\n  }\n  inTransaction(): boolean {\n    return (this.#db as unknown as { isTransaction: boolean }).isTransaction;\n  }\n  databaseSize(): number {\n    const [pc] = this.exec(\"PRAGMA page_count\", []).rows[0] as [number];\n    const [ps] = this.exec(\"PRAGMA page_size\", []).rows[0] as [number];\n    return Number(pc) * Number(ps);\n  }\n  close(): void {\n    this.#db.close();\n  }\n\n  // ---- change capture (session extension) for transaction logs -------------------------\n  #session: { changeset(): Uint8Array; close(): void } | undefined;\n  /** node:sqlite exposes no ROWID session option: PK-less tables are logged as statements. */\n  readonly captureCoversRowidTables = false;\n  captureStart(): void {\n    this.#session?.close();\n    this.#session = (\n      this.#db as unknown as { createSession(): { changeset(): Uint8Array; close(): void } }\n    ).createSession();\n  }\n  captureTake(): Uint8Array {\n    const s = this.#session;\n    this.#session = undefined;\n    if (!s) return new Uint8Array();\n    try {\n      return s.changeset();\n    } finally {\n      s.close();\n    }\n  }\n  captureDiscard(): void {\n    this.#session?.close();\n    this.#session = undefined;\n  }\n  applyChangeset(changeset: Uint8Array): void {\n    if (!changeset.byteLength) return;\n    const SQLITE_CHANGESET_REPLACE = 1;\n    (this.#db as unknown as { applyChangeset(c: Uint8Array, o: unknown): boolean }).applyChangeset(\n      changeset,\n      {\n        onConflict: () => SQLITE_CHANGESET_REPLACE,\n      },\n    );\n  }\n\n  /** Known extensions only: \"sqlite_vec\" → the sqlite-vec npm package's loadable library. */\n  loadExtension(name: string): void {\n    const path = KNOWN_EXTENSIONS[name]?.();\n    if (!path) throw new Error(`Unknown SQLite extension \"${name}\"`);\n    this.#db.enableLoadExtension(true);\n    try {\n      this.#db.loadExtension(path);\n    } finally {\n      this.#db.enableLoadExtension(false);\n    }\n  }\n\n  /**\n   * The database file as SQLite wrote it (page for page), for page-level logs; an in-memory\n   * database falls back to image(). Valid between transactions (rollback journal mode).\n   */\n  pageImage(): Uint8Array {\n    if (this.#path === \":memory:\") return this.image();\n    // A database restored from celld's files is in WAL mode (litestream needs it): its last\n    // commits are in the -wal file until a checkpoint moves them into the main file.\n    const mode = String(this.#db.prepare(\"PRAGMA journal_mode\").get()?.journal_mode ?? \"\");\n    if (mode.toLowerCase() === \"wal\") {\n      this.#db.exec(\"PRAGMA wal_checkpoint(TRUNCATE)\");\n      this.#walOffset = 0; // the WAL starts over\n    }\n    return new Uint8Array(readFileSync(this.#path));\n  }\n\n  /** `VACUUM INTO` a temp file: a consistent, compact image (no open transaction allowed). */\n  image(): Uint8Array {\n    const tmp = join(mkdtempSync(join(tmpdir(), \"cell-snap-\")), \"db.sqlite\");\n    try {\n      this.#db.exec(`VACUUM INTO '${tmp.replace(/'/g, \"''\")}'`);\n      return new Uint8Array(readFileSync(tmp));\n    } finally {\n      rmSync(dirname(tmp), { recursive: true, force: true });\n    }\n  }\n\n  /** Replaces the database file with `image` and reopens it (an in-memory DB becomes file-backed). */\n  restore(image: Uint8Array): void {\n    this.#db.close();\n    if (this.#path === \":memory:\")\n      this.#path = join(mkdtempSync(join(tmpdir(), \"cell-mem-\")), \"db.sqlite\");\n    for (const suffix of [\"-wal\", \"-shm\", \"-journal\"]) rmSync(this.#path + suffix, { force: true });\n    writeFileSync(this.#path, image);\n    this.#db = new DatabaseSync(this.#path, { enableDoubleQuotedStringLiterals: true });\n    if (this.#exclusive) this.#db.exec(\"PRAGMA locking_mode = EXCLUSIVE; PRAGMA busy_timeout = 0;\");\n    this.#walSetup(); // a new file: a new WAL\n  }\n}\n\nfunction toSqlite(v: unknown): unknown {\n  if (v instanceof ArrayBuffer) return new Uint8Array(v);\n  if (typeof v === \"boolean\") return v ? 1 : 0;\n  return v === undefined ? null : v;\n}\n/** Workers return BLOBs as ArrayBuffer. */\nfunction fromSqlite(v: unknown): unknown {\n  if (v instanceof Uint8Array) return v.buffer.slice(v.byteOffset, v.byteOffset + v.byteLength);\n  return v;\n}\n\n/** One file per cell in `dir`, or in-memory when `dir` is omitted. */\n/**\n * `pageCapture` (file-backed only): WAL mode, and each commit's changed pages read from the WAL\n * (takeDirtyPages) — LTX logs then cost O(changed pages) on Node as with SQLite WASM.\n */\nexport function nodeSqliteOpener(\n  dir?: string,\n  opts: { exclusive?: boolean; pageCapture?: boolean } = {},\n): OpenCellSql {\n  return (cellKey) =>\n    new NodeSqliteDriver(\n      dir ? `${dir}/${cellKey.replace(/[^\\w.-]/g, \"_\")}.sqlite` : \":memory:\",\n      opts,\n    );\n}\n"]}
+{"version":3,"file":"node-sqlite.js","sourceRoot":"","sources":["../../src/adapters/node-sqlite.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  closeSync,\n  existsSync,\n  fstatSync,\n  mkdtempSync,\n  openSync,\n  readFileSync,\n  readSync,\n  rmdirSync,\n  rmSync,\n  statSync,\n  writeFileSync,\n} from \"node:fs\";\nimport { createRequire } from \"node:module\";\nimport { tmpdir } from \"node:os\";\nimport { dirname, join } from \"node:path\";\nimport type { DatabaseSync as DatabaseSyncT } from \"node:sqlite\";\n\nimport { splitSqlStatements } from \"../core/sql-split.js\";\nimport type { OpenCellSql, SqlResult, SyncSqlDriver } from \"../ports.js\";\nimport { requireNodeSqlite } from \"./node-sqlite-module.js\";\n\nconst { DatabaseSync } = requireNodeSqlite();\n\nconst requireCjs = createRequire(import.meta.url);\nconst KNOWN_EXTENSIONS: Record<string, () => string> = {\n  sqlite_vec: () => (requireCjs(\"sqlite-vec\") as { getLoadablePath(): string }).getLoadablePath(),\n};\n\n/** Server-side SyncSqlDriver over node:sqlite (Node >= 22.13). */\nexport class NodeSqliteDriver implements SyncSqlDriver {\n  #db: DatabaseSyncT;\n  #path: string;\n  readonly #exclusive: boolean;\n  readonly #pageCapture: boolean;\n  /** A file of its own that close() removes (a cell \"in memory\" that needs a WAL). */\n  readonly #temporary: boolean;\n  constructor(\n    path = \":memory:\",\n    opts: { exclusive?: boolean; pageCapture?: boolean; temporary?: boolean } = {},\n  ) {\n    this.#path = path;\n    this.#temporary = !!opts.temporary && path !== \":memory:\";\n    this.#exclusive = !!opts.exclusive;\n    this.#pageCapture = !!opts.pageCapture && path !== \":memory:\";\n    // As celld and workerd: a double-quoted name that is no column is a string literal.\n    this.#db = new DatabaseSync(path, {\n      allowExtension: true,\n      enableDoubleQuotedStringLiterals: true,\n    });\n    this.#db.enableLoadExtension(false); // only loadExtension() below may load, by name\n    // EXCLUSIVE locking: the first write takes an OS lock on the file that is\n    // kept until close (or process death) — a second process can neither read\n    // nor write the cell. Storage-level fencing on one host, no lease needed.\n    if (opts.exclusive) this.#db.exec(\"PRAGMA locking_mode = EXCLUSIVE; PRAGMA busy_timeout = 0;\");\n    this.#walSetup();\n  }\n\n  // ---- page capture through the WAL (what the WASM driver does with its xWrite hook) ----\n  // In WAL mode every commit appends its changed pages to `<db>-wal` as frames (24-byte frame\n  // header + page; a commit frame carries the database size in pages). Reading the frames\n  // appended since the last read gives exactly the committed transaction's pages, O(changed),\n  // instead of reading the whole file. Automatic checkpoints are off; take() checkpoints\n  // (TRUNCATE) itself once the WAL grows, and restarts from its start.\n  #walOffset = 0;\n  /** Whether anyone reads the captured pages; until then exec() keeps the WAL bounded itself. */\n  #taken = false;\n  #writes = 0;\n  #walSetup(): void {\n    if (!this.#pageCapture) return;\n    this.#db.exec(\"PRAGMA journal_mode = WAL; PRAGMA wal_autocheckpoint = 0;\");\n    // A temporary file is only the WAL's carrier (the bucket keeps the cell): no fsync per commit.\n    if (this.#temporary) this.#db.exec(\"PRAGMA synchronous = OFF\");\n    this.#db.exec(\"PRAGMA wal_checkpoint(TRUNCATE)\");\n    this.#walOffset = 0;\n  }\n  /** The pages of the transactions committed since the previous call (WAL frames). */\n  takeDirtyPages():\n    | { pageSize: number; pageCount: number; pages: Map<number, Uint8Array> }\n    | undefined {\n    if (!this.#pageCapture) return undefined;\n    this.#taken = true;\n    const walPath = `${this.#path}-wal`;\n    let fd: number;\n    try {\n      fd = openSync(walPath, \"r\");\n    } catch {\n      return undefined;\n    }\n    try {\n      const size = fstatSync(fd).size;\n      if (size < 32) return undefined;\n      const header = Buffer.alloc(32);\n      readSync(fd, header, 0, 32, 0);\n      const pageSize = header.readUInt32BE(8) === 1 ? 65536 : header.readUInt32BE(8);\n      const [salt1, salt2] = [header.readUInt32BE(16), header.readUInt32BE(20)];\n      const frameSize = 24 + pageSize;\n      let offset = Math.max(32, this.#walOffset);\n      const pending = new Map<number, Uint8Array>();\n      const pages = new Map<number, Uint8Array>();\n      let pageCount = 0;\n      let committedTo = offset;\n      const frame = Buffer.alloc(frameSize);\n      while (offset + frameSize <= size) {\n        readSync(fd, frame, 0, frameSize, offset);\n        if (frame.readUInt32BE(8) !== salt1 || frame.readUInt32BE(12) !== salt2) break; // stale frames\n        pending.set(frame.readUInt32BE(0), new Uint8Array(frame.subarray(24)));\n        offset += frameSize;\n        const commit = frame.readUInt32BE(4);\n        if (commit) {\n          for (const [p, d] of pending) pages.set(p, d);\n          pending.clear();\n          pageCount = commit;\n          committedTo = offset;\n        }\n      }\n      this.#walOffset = committedTo;\n      if (!pageCount)\n        return {\n          pageSize,\n          pageCount: Number(this.exec(\"PRAGMA page_count\", []).rows[0][0]),\n          pages,\n        };\n      for (const p of [...pages.keys()]) if (p > pageCount) pages.delete(p);\n      // keep the WAL bounded: fold it into the database and start over\n      if (committedTo > 4 * 1024 * 1024) {\n        this.#db.exec(\"PRAGMA wal_checkpoint(TRUNCATE)\");\n        this.#walOffset = 0;\n      }\n      return { pageSize, pageCount, pages };\n    } finally {\n      closeSync(fd);\n    }\n  }\n  exec(sql: string, params: unknown[]): SqlResult {\n    const statements = params.length === 0 ? splitSqlStatements(sql) : [sql];\n    // Several statements: the result of the last one, with the rows written by all of them.\n    let last: SqlResult = { columnNames: [], rows: [], rowsWritten: 0 };\n    let written = 0;\n    for (const text of statements) {\n      last = this.#one(text, params);\n      written += last.rowsWritten;\n    }\n    if (this.#pageCapture && !this.#taken && ++this.#writes % 64 === 0) this.#boundWal();\n    return { ...last, rowsWritten: written };\n  }\n  #one(sql: string, params: unknown[]): SqlResult {\n    const stmt = this.#db.prepare(sql);\n    const columnNames = stmt.columns().map((c) => c.name);\n    const args = params.map(toSqlite) as any[];\n    if (columnNames.length === 0) {\n      const r = stmt.run(...args);\n      return { columnNames, rows: [], rowsWritten: Number(r.changes) };\n    }\n    stmt.setReturnArrays(true);\n    const rows = (stmt.all(...args) as unknown as unknown[][]).map((row) => row.map(fromSqlite));\n    return { columnNames, rows, rowsWritten: 0 };\n  }\n  /**\n   * A database whose pages nobody takes (the runtime's own tables, a storage that logs no pages)\n   * has no one to checkpoint its WAL (automatic checkpoints are off): past 4 MiB, fold it in.\n   */\n  #boundWal(): void {\n    if (this.inTransaction()) return;\n    try {\n      if (statSync(`${this.#path}-wal`).size <= 4 * 1024 * 1024) return;\n    } catch {\n      return;\n    }\n    this.#db.exec(\"PRAGMA wal_checkpoint(TRUNCATE)\");\n    this.#walOffset = 0;\n  }\n  inTransaction(): boolean {\n    return (this.#db as unknown as { isTransaction: boolean }).isTransaction;\n  }\n  databaseSize(): number {\n    const [pc] = this.exec(\"PRAGMA page_count\", []).rows[0] as [number];\n    const [ps] = this.exec(\"PRAGMA page_size\", []).rows[0] as [number];\n    return Number(pc) * Number(ps);\n  }\n  close(): void {\n    this.#db.close();\n    if (!this.#temporary) return;\n    for (const suffix of [\"\", \"-wal\", \"-shm\", \"-journal\"])\n      rmSync(this.#path + suffix, { force: true });\n    try {\n      rmdirSync(dirname(this.#path)); // the opener's directory, once its last cell is closed\n      temporaryDirs.delete(dirname(this.#path));\n    } catch {}\n  }\n\n  // ---- change capture (session extension) for transaction logs -------------------------\n  #session: { changeset(): Uint8Array; close(): void } | undefined;\n  /** node:sqlite exposes no ROWID session option: PK-less tables are logged as statements. */\n  readonly captureCoversRowidTables = false;\n  captureStart(): void {\n    this.#session?.close();\n    this.#session = (\n      this.#db as unknown as { createSession(): { changeset(): Uint8Array; close(): void } }\n    ).createSession();\n  }\n  captureTake(): Uint8Array {\n    const s = this.#session;\n    this.#session = undefined;\n    if (!s) return new Uint8Array();\n    try {\n      return s.changeset();\n    } finally {\n      s.close();\n    }\n  }\n  captureDiscard(): void {\n    this.#session?.close();\n    this.#session = undefined;\n  }\n  applyChangeset(changeset: Uint8Array): void {\n    if (!changeset.byteLength) return;\n    const SQLITE_CHANGESET_REPLACE = 1;\n    (this.#db as unknown as { applyChangeset(c: Uint8Array, o: unknown): boolean }).applyChangeset(\n      changeset,\n      {\n        onConflict: () => SQLITE_CHANGESET_REPLACE,\n      },\n    );\n  }\n\n  /** Known extensions only: \"sqlite_vec\" → the sqlite-vec npm package's loadable library. */\n  loadExtension(name: string): void {\n    const path = KNOWN_EXTENSIONS[name]?.();\n    if (!path) throw new Error(`Unknown SQLite extension \"${name}\"`);\n    this.#db.enableLoadExtension(true);\n    try {\n      this.#db.loadExtension(path);\n    } finally {\n      this.#db.enableLoadExtension(false);\n    }\n  }\n\n  /**\n   * The database file as SQLite wrote it (page for page), for page-level logs; an in-memory\n   * database falls back to image(). Valid between transactions (rollback journal mode).\n   */\n  pageImage(): Uint8Array {\n    if (this.#path === \":memory:\") return this.image();\n    // A database restored from celld's files is in WAL mode (litestream needs it): its last\n    // commits are in the -wal file until a checkpoint moves them into the main file.\n    const mode = String(this.#db.prepare(\"PRAGMA journal_mode\").get()?.journal_mode ?? \"\");\n    if (mode.toLowerCase() === \"wal\") {\n      this.#db.exec(\"PRAGMA wal_checkpoint(TRUNCATE)\");\n      this.#walOffset = 0; // the WAL starts over\n    }\n    return new Uint8Array(readFileSync(this.#path));\n  }\n\n  /** `VACUUM INTO` a temp file: a consistent, compact image (no open transaction allowed). */\n  image(): Uint8Array {\n    const tmp = join(mkdtempSync(join(tmpdir(), \"cell-snap-\")), \"db.sqlite\");\n    try {\n      this.#db.exec(`VACUUM INTO '${tmp.replace(/'/g, \"''\")}'`);\n      return new Uint8Array(readFileSync(tmp));\n    } finally {\n      rmSync(dirname(tmp), { recursive: true, force: true });\n    }\n  }\n\n  /** Replaces the database file with `image` and reopens it (an in-memory DB becomes file-backed). */\n  restore(image: Uint8Array): void {\n    this.#db.close();\n    if (this.#path === \":memory:\")\n      this.#path = join(mkdtempSync(join(tmpdir(), \"cell-mem-\")), \"db.sqlite\");\n    for (const suffix of [\"-wal\", \"-shm\", \"-journal\"]) rmSync(this.#path + suffix, { force: true });\n    writeFileSync(this.#path, image);\n    this.#db = new DatabaseSync(this.#path, { enableDoubleQuotedStringLiterals: true });\n    if (this.#exclusive) this.#db.exec(\"PRAGMA locking_mode = EXCLUSIVE; PRAGMA busy_timeout = 0;\");\n    this.#walSetup(); // a new file: a new WAL\n  }\n}\n\nfunction toSqlite(v: unknown): unknown {\n  if (v instanceof ArrayBuffer) return new Uint8Array(v);\n  if (typeof v === \"boolean\") return v ? 1 : 0;\n  return v === undefined ? null : v;\n}\n/** Workers return BLOBs as ArrayBuffer. */\nfunction fromSqlite(v: unknown): unknown {\n  if (v instanceof Uint8Array) return v.buffer.slice(v.byteOffset, v.byteOffset + v.byteLength);\n  return v;\n}\n\n/** Temporary cell directories still present: removed if the process exits without closing them. */\nconst temporaryDirs = new Set<string>();\nlet exitHook = false;\nfunction removeAtExit(dir: string): void {\n  temporaryDirs.add(dir);\n  if (exitHook) return;\n  exitHook = true;\n  process.once(\"exit\", () => {\n    for (const d of temporaryDirs) rmSync(d, { recursive: true, force: true });\n  });\n}\n\n/**\n * One file per cell in `dir`; without `dir`, each cell in memory.\n *\n * `pageCapture`: WAL mode, and each commit's changed pages read from the WAL (takeDirtyPages),\n * so LTX logs (a celld bucket) cost O(changed pages) on Node as with SQLite WASM, instead of an\n * image of the whole database (VACUUM INTO) and a page-by-page diff per commit. A WAL needs a\n * file: without `dir`, each cell opened gets a temporary file (in a `cellb-cells-…` directory\n * under the OS temp directory), removed when the cell closes, so it still starts empty each\n * time as in memory (a bucket restores it).\n */\nexport function nodeSqliteOpener(\n  dir?: string,\n  opts: { exclusive?: boolean; pageCapture?: boolean } = {},\n): OpenCellSql {\n  let temp: string | undefined;\n  let opened = 0;\n  return (cellKey) => {\n    const name = cellKey.replace(/[^\\w.-]/g, \"_\");\n    // The runtime's own databases (alarms index, cron state) log no pages: never captured.\n    const capture = !!opts.pageCapture && !cellKey.startsWith(\"__cellb/\");\n    const o = { ...opts, pageCapture: capture };\n    if (dir) return new NodeSqliteDriver(`${dir}/${name}.sqlite`, o);\n    if (!capture) return new NodeSqliteDriver(\":memory:\", o);\n    if (!temp || !existsSync(temp)) {\n      temp = mkdtempSync(join(tmpdir(), \"cellb-cells-\"));\n      removeAtExit(temp);\n    }\n    // A file per opening: a cell reopened while its previous database is still closing gets\n    // a fresh one, as in memory.\n    return new NodeSqliteDriver(join(temp, `${name}-${++opened}.sqlite`), {\n      ...o,\n      temporary: true,\n    });\n  };\n}\n"]}

package/dist/adapters/wasm-sqlite.d.ts

@@ -84,8 +84,10 @@ export declare function sahpoolOpener(sqlite3: {
     }): Promise<{
         OpfsSAHPoolDb: new (path: string) => Oo1Db;
         reserveMinimumCapacity(n: number): Promise<number>;
+        addCapacity?(n: number): Promise<number>;
         getCapacity(): number;
         getFileCount(): number;
+        getFileNames?(): string[];
         pauseVfs?(): unknown;
         isPaused?(): boolean;
         unpauseVfs?(): Promise<unknown>;

package/dist/adapters/wasm-sqlite.js

@@ -209,41 +209,80 @@ export async function sahpoolOpener(sqlite3, opts = {}) {
     if (pool.isPaused?.())
         await pool.unpauseVfs?.();
     // A full pool fails the open (`SAH pool is full`), and opening is synchronous while growing
-    // the pool is not. A cell about to open reserves room first (`room`, awaited by the runtime
-    // before the cell's first event); the pool grows when the reservations would not fit, and in
-    // the background whenever less than half of it is free.
+    // the pool is not. Each new slot is an OPFS file with a sync access handle, made one at a time,
+    // and once the worker is busy each one takes seconds (about 5 s with 32 Flue conversations in
+    // one worker), so the pool grows ahead of need, in small steps:
+    // - a cell about to open reserves room first (`room`, awaited by the runtime before the cell's
+    //   first event): its database, its journal and a spare, and it waits until what was needed
+    //   when it asked fits, one step of 16 slots at a time (not a doubling, nor later reservations);
+    // - an open cell counts its journal until it has one (SQLite makes it at the cell's first
+    //   write), so the pool grows while it still has room, not once the journals fill it;
+    // - at each open (failed ones too: a cell can reopen without `room`), the pool grows in the
+    //   background until two thirds of it are free: an unused slot costs a small file, a missing
+    //   one a wait of seconds per slot, so it grows while the worker is still quiet.
     const SLOTS_PER_CELL = 3; // the database, its journal, and one spare
+    const STEP = 16; // slots per growth step, made in parallel
+    const AHEAD = 3; // the pool's size, in multiples of what it needs, kept by the background growth
     const reserved = new Set();
+    const opened = new Map(); // the open cells' databases
     let growing;
-    const grow = (min) => {
-        growing ??= pool
-            .reserveMinimumCapacity(Math.max(min, pool.getCapacity() * 2))
+    /**
+     * One growth step toward `target` (one at a time: a second caller joins it). SQLite makes a
+     * pool's new slots one after another, two awaited OPFS calls each, and in a busy worker each
+     * await waits seconds for the event loop: the step asks for its slots in parallel instead,
+     * one `addCapacity(1)` each, so it costs about one slot's wait.
+     */
+    const step = (target) => {
+        const n = Math.min(target, pool.getCapacity() + STEP) - pool.getCapacity();
+        growing ??= (pool.addCapacity && n > 0
+            ? Promise.all(Array.from({ length: n }, () => pool.addCapacity?.(1)))
+            : pool.reserveMinimumCapacity(pool.getCapacity() + Math.max(n, 0)))
             .then(() => { })
             .finally(() => {
             growing = undefined;
         });
         return growing;
     };
-    const needed = () => pool.getFileCount() + SLOTS_PER_CELL * reserved.size;
+    const needed = () => {
+        // Journals not made yet. Without the pool's file names (older SQLite WASM builds) none
+        // is counted, as before: the files that exist are.
+        let journals = 0;
+        if (pool.getFileNames) {
+            const files = new Set(pool.getFileNames());
+            for (const { path } of opened.values())
+                if (!files.has(`${path}-journal`))
+                    journals++;
+        }
+        return pool.getFileCount() + journals + SLOTS_PER_CELL * reserved.size;
+    };
+    /** Grows until `target()` fits; stops when a step of its own adds nothing (the open says why). */
+    const growTo = async (target) => {
+        while (target() > pool.getCapacity()) {
+            // A step already under way may have added its slots and not ended yet: joining it says
+            // nothing about whether the pool can grow.
+            const joined = growing !== undefined;
+            const before = pool.getCapacity();
+            await step(target());
+            if (!joined && pool.getCapacity() <= before)
+                return;
+        }
+    };
     const room = (cellKey) => {
         reserved.add(cellKey);
-        if (needed() <= pool.getCapacity())
+        const target = needed();
+        if (target <= pool.getCapacity())
             return undefined;
-        // Grow until this reservation (and every other one) fits; the open fails visibly if not.
-        const fit = async () => {
-            while (needed() > pool.getCapacity()) {
-                const before = pool.getCapacity();
-                await grow(needed());
-                if (pool.getCapacity() <= before)
-                    return; // it did not grow: the open will say why
-            }
-        };
-        return fit();
+        return growTo(() => target);
     };
+    let ahead;
     const keepRoom = () => {
-        const capacity = pool.getCapacity();
-        if (!growing && capacity - needed() < capacity / 2)
-            grow(capacity * 2).catch(() => { });
+        if (ahead || pool.getCapacity() >= AHEAD * needed())
+            return;
+        ahead = growTo(() => AHEAD * needed())
+            .catch(() => { })
+            .finally(() => {
+            ahead = undefined;
+        });
     };
     // The rollback journal stays in the pool between transactions (PERSIST): DELETE gives its pool
     // slot back and takes it again on every commit, which costs a header write each time. The
@@ -257,16 +296,35 @@ export async function sahpoolOpener(sqlite3, opts = {}) {
     const open = (cellKey) => {
         const path = `/${cellKey.replace(/[^\w.-]/g, "_")}.sqlite`;
         reserved.delete(cellKey);
-        queueMicrotask(keepRoom); // after this open (and its first slot) is counted
-        return new WasmSqliteDriver(openDb(path), {
-            image: (db) => sqlite3.capi.sqlite3_js_db_export(db),
-            // Replace the file inside the pool, then reopen it.
-            restore(db, image) {
-                db.close();
-                pool.importDb(path, image);
-                return openDb(path);
-            },
-        }, sqlite3);
+        // Counted from now on, with its journal until it has one; no longer once it is closed.
+        const entry = { path };
+        opened.set(cellKey, entry);
+        keepRoom();
+        let driver;
+        try {
+            driver = new WasmSqliteDriver(openDb(path), {
+                image: (db) => sqlite3.capi.sqlite3_js_db_export(db),
+                // Replace the file inside the pool, then reopen it.
+                restore(db, image) {
+                    db.close();
+                    pool.importDb(path, image);
+                    return openDb(path);
+                },
+            }, sqlite3);
+        }
+        catch (err) {
+            if (opened.get(cellKey) === entry)
+                opened.delete(cellKey);
+            throw err;
+        }
+        const close = driver.close.bind(driver);
+        driver.close = () => {
+            // Only this driver's entry: the cell may have been opened again since.
+            if (opened.get(cellKey) === entry)
+                opened.delete(cellKey);
+            close();
+        };
+        return driver;
     };
     return Object.assign(open, {
         room,

package/dist/adapters/wasm-sqlite.js.map

@@ -1 +1 @@
-{"version":3,"file":"wasm-sqlite.js","sourceRoot":"","sources":["../../src/adapters/wasm-sqlite.ts"],"names":[],"mappings":"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","sourcesContent":["import { splitSqlStatements } from \"../core/sql-split.js\";\nimport type { OpenCellSql, SqlResult, SyncSqlDriver } from \"../ports.js\";\nimport { type DirtyPages, installPageHook } from \"./wasm-page-hook.js\";\nimport { type WasmSqlite3, wasmSessionCapture } from \"./wasm-session.js\";\n\n/** Minimal slice of the @sqlite.org/sqlite-wasm `oo1.DB` API we rely on. */\nexport interface Oo1Db {\n  prepare(sql: string): Oo1Stmt;\n  exec(sql: string): unknown;\n  changes(): number;\n  close(): void;\n}\ninterface Oo1Stmt {\n  bind(values: unknown[]): Oo1Stmt;\n  getColumnNames(): string[];\n  columnCount: number;\n  step(): boolean;\n  get(target: unknown[]): unknown[];\n  finalize(): void;\n}\n\n/**\n * SyncSqlDriver over the official SQLite WASM build (oo1 API). Synchronous,\n * so it satisfies `ctx.storage.sql`. Works in Node (in-memory, for tests) and\n * in browsers; persistence comes from the VFS behind the DB (see sahpoolOpener).\n */\n/** Backup hooks: how to export an image of the DB and how to replace it (returns the reopened DB). */\nexport interface WasmImageHooks {\n  image(db: Oo1Db): Uint8Array;\n  restore(db: Oo1Db, image: Uint8Array): Oo1Db;\n}\n\nexport class WasmSqliteDriver implements SyncSqlDriver {\n  captureStart?: () => void;\n  captureTake?: () => Uint8Array;\n  captureDiscard?: () => void;\n  applyChangeset?: (changeset: Uint8Array) => void;\n  captureCoversRowidTables?: boolean;\n  #db: Oo1Db;\n  readonly #hooks?: WasmImageHooks;\n  readonly #sqlite3?: WasmSqlite3;\n  readonly #capi?: { sqlite3_get_autocommit(db: number): number };\n  #pageHook?: ReturnType<typeof installPageHook>;\n  constructor(\n    db: Oo1Db,\n    hooks?: WasmImageHooks,\n    sqlite3?: WasmSqlite3,\n    /** SQLite's C API, for `inTransaction()` alone (when `sqlite3` is not given). */\n    capi?: { sqlite3_get_autocommit(db: number): number },\n  ) {\n    this.#db = db;\n    this.#hooks = hooks;\n    this.#sqlite3 = sqlite3;\n    this.#capi = capi ?? sqlite3?.capi;\n    if (!this.#capi?.sqlite3_get_autocommit)\n      (this as { inTransaction?: unknown }).inTransaction = undefined;\n    this.#enableDqs();\n    this.#hookPages();\n    if (sqlite3?.capi?.sqlite3session_create) {\n      // Transaction-log capture (session extension), following the current DB handle.\n      Object.assign(\n        this,\n        wasmSessionCapture(sqlite3, () => (this.#db as unknown as { pointer: number }).pointer),\n      );\n    }\n    if (!hooks) {\n      // No image support for this driver: hide the optional port methods.\n      (this as { image?: unknown }).image = undefined;\n      (this as { restore?: unknown }).restore = undefined;\n    }\n  }\n  image(): Uint8Array {\n    return this.#hooks!.image(this.#db);\n  }\n\n  /**\n   * As celld and workerd: a double-quoted name that is no column is a string literal (SQLite's\n   * DQS misfeature, off in this build).\n   */\n  #enableDqs(): void {\n    const capi = this.#sqlite3?.capi;\n    if (!capi?.sqlite3_db_config) return;\n    const db = (this.#db as unknown as { pointer: number }).pointer;\n    capi.sqlite3_db_config(db, capi.SQLITE_DBCONFIG_DQS_DML, 1, 0);\n    capi.sqlite3_db_config(db, capi.SQLITE_DBCONFIG_DQS_DDL, 1, 0);\n  }\n\n  /** Installs the page hook on the current main database file (see wasm-page-hook.ts). */\n  #hookPages(): void {\n    this.#pageHook = undefined;\n    if (!this.#sqlite3?.capi?.sqlite3_file_control) return;\n    try {\n      this.#pageHook = installPageHook(\n        this.#sqlite3,\n        (this.#db as unknown as { pointer: number }).pointer,\n      );\n    } catch {\n      this.#pageHook = undefined;\n    }\n  }\n  /** Pages written since the previous call — a committed transaction's changed pages. */\n  takeDirtyPages(): DirtyPages | undefined {\n    if (!this.#pageHook) return undefined;\n    const pageSize = Number(this.exec(\"PRAGMA page_size\", []).rows[0][0]);\n    const pageCount = Number(this.exec(\"PRAGMA page_count\", []).rows[0][0]);\n    return this.#pageHook.take(pageSize, pageCount);\n  }\n  discardDirtyPages(): void {\n    this.#pageHook?.discard();\n  }\n  /**\n   * WASM builds cannot load extensions at run time; an extension must be compiled into the\n   * build (e.g. the `sqlite-vec-wasm-demo` package for \"sqlite_vec\"). This only checks it is.\n   */\n  loadExtension(name: string): void {\n    const probe: Record<string, string> = { sqlite_vec: \"SELECT vec_version()\" };\n    if (!probe[name]) throw new Error(`Unknown SQLite extension \"${name}\"`);\n    try {\n      this.exec(probe[name], []);\n    } catch {\n      throw new Error(`SQLite extension \"${name}\" is not compiled into this SQLite WASM build`);\n    }\n  }\n  restore(image: Uint8Array): void {\n    // celld's databases are in WAL mode (header bytes 18–19 = 2); the WASM VFSes (memdb,\n    // opfs-sahpool) have no shared memory for WAL and refuse to open such a file. The pages\n    // are the same in rollback-journal mode: switch the header to 1 (celld sets WAL again\n    // when it opens the database).\n    if (image.length > 19 && image[18] === 2 && image[19] === 2) {\n      image = image.slice();\n      image[18] = 1;\n      image[19] = 1;\n    }\n    this.#db = this.#hooks!.restore(this.#db, image);\n    this.#enableDqs();\n    this.#hookPages(); // a new database file behind the connection\n  }\n  exec(sql: string, params: unknown[]): SqlResult {\n    const statements = params.length === 0 ? splitSqlStatements(sql) : [sql];\n    // Several statements: the result of the last one, with the rows written by all of them.\n    let last: SqlResult = { columnNames: [], rows: [], rowsWritten: 0 };\n    let written = 0;\n    for (const text of statements) {\n      last = this.#one(text, params);\n      written += last.rowsWritten;\n    }\n    return { ...last, rowsWritten: written };\n  }\n  #one(sql: string, params: unknown[]): SqlResult {\n    const st = this.#db.prepare(sql);\n    try {\n      if (params.length) st.bind(params.map(toSqlite));\n      const columnNames = st.columnCount ? st.getColumnNames() : [];\n      const rows: unknown[][] = [];\n      while (st.step()) if (columnNames.length) rows.push(st.get([]).map(fromSqlite));\n      return { columnNames, rows, rowsWritten: columnNames.length ? 0 : this.#db.changes() };\n    } finally {\n      st.finalize();\n    }\n  }\n  inTransaction(): boolean {\n    const pointer = (this.#db as unknown as { pointer: number }).pointer;\n    return this.#capi!.sqlite3_get_autocommit(pointer) === 0;\n  }\n  databaseSize(): number {\n    const pc = this.exec(\"PRAGMA page_count\", []).rows[0][0];\n    const ps = this.exec(\"PRAGMA page_size\", []).rows[0][0];\n    return Number(pc) * Number(ps);\n  }\n  close(): void {\n    this.#db.close();\n  }\n}\n\nfunction toSqlite(v: unknown): unknown {\n  if (v instanceof ArrayBuffer) return new Uint8Array(v);\n  if (typeof v === \"boolean\") return v ? 1 : 0;\n  return v === undefined ? null : v;\n}\nfunction fromSqlite(v: unknown): unknown {\n  if (v instanceof Uint8Array) return v.buffer.slice(v.byteOffset, v.byteOffset + v.byteLength);\n  return v;\n}\n\n/** In-memory WASM databases (tests, ephemeral cells). `sqlite3` = await sqlite3InitModule(). */\n/** Image hooks for an in-memory DB: `sqlite3_js_db_export` / `sqlite3_deserialize`. */\nexport function memoryImageHooks(sqlite3: any): WasmImageHooks {\n  const { capi, wasm } = sqlite3;\n  return {\n    image: (db) => sqlite3.capi.sqlite3_js_db_export(db),\n    restore(db, image) {\n      const p = wasm.allocFromTypedArray(image);\n      const rc = capi.sqlite3_deserialize(\n        (db as any).pointer,\n        \"main\",\n        p,\n        image.byteLength,\n        image.byteLength,\n        capi.SQLITE_DESERIALIZE_FREEONCLOSE | capi.SQLITE_DESERIALIZE_RESIZEABLE,\n      );\n      if (rc) throw new Error(`sqlite3_deserialize failed: ${capi.sqlite3_js_rc_str?.(rc) ?? rc}`);\n      return db;\n    },\n  };\n}\n\n/**\n * Sets up a new SQLite WASM connection for a cell. One worker holds many small cells, and SQLite\n * WASM's heap is capped at 2 GiB and never shrinks, so each connection's fixed memory decides how\n * many cells can be open at once:\n * - no lookaside: SQLite's per-connection allocator of small blocks, about 45 KiB each;\n * - 4 KiB pages for a database that is still empty (celld's page size: SQLite's native default;\n *   the WASM build's is 8 KiB). The page cache starts with a block of pages, so the page size\n *   sets most of a connection's memory. A database that already holds data keeps its page size.\n * Together they bring a connection with one small table from about 258 KiB to about 120 KiB.\n */\nexport function tuneCellConnection(sqlite3: unknown, db: Oo1Db): void {\n  const capi = (sqlite3 as { capi?: Record<string, any> }).capi;\n  const pointer = (db as unknown as { pointer?: number }).pointer;\n  // Before the connection runs any statement: SQLite refuses (SQLITE_BUSY) while lookaside is used.\n  if (capi?.sqlite3_db_config && pointer) {\n    capi.sqlite3_db_config(pointer, capi.SQLITE_DBCONFIG_LOOKASIDE, 0, 0, 0);\n  }\n  db.exec(\"PRAGMA page_size=4096\");\n}\n\nlet memdbCounter = 0;\nexport function wasmMemoryOpener(sqlite3: {\n  oo1: { DB: new (path: string, mode?: string) => Oo1Db };\n}): OpenCellSql {\n  return () => {\n    // memdb (not \":memory:\"): an in-memory database that IS a VFS file, so the page hook works.\n    const db = new sqlite3.oo1.DB(`file:/cells-mem-${++memdbCounter}?vfs=memdb`, \"c\");\n    tuneCellConnection(sqlite3, db);\n    return new WasmSqliteDriver(db, memoryImageHooks(sqlite3), sqlite3 as never);\n  };\n}\n\n/**\n * Browser persistence: one OPFS \"SyncAccessHandle pool\" database per cell.\n * Must run in a Dedicated Worker; needs neither COOP/COEP nor SharedArrayBuffer.\n * Not runnable in Node (installOpfsSAHPoolVfs is browser-only) — covered by P04's Playwright spec.\n */\nexport async function sahpoolOpener(\n  sqlite3: {\n    installOpfsSAHPoolVfs(opts: { name?: string; initialCapacity?: number }): Promise<{\n      OpfsSAHPoolDb: new (path: string) => Oo1Db;\n      reserveMinimumCapacity(n: number): Promise<number>;\n      getCapacity(): number;\n      getFileCount(): number;\n      // Not in older SQLite WASM builds (sqlite-vec's): there `release()` does nothing.\n      pauseVfs?(): unknown;\n      isPaused?(): boolean;\n      unpauseVfs?(): Promise<unknown>;\n    }>;\n  },\n  opts: { name?: string; initialCapacity?: number } = {},\n): Promise<OpenCellSql & { reserve(n: number): Promise<number>; release(): void }> {\n  const pool = await sqlite3.installOpfsSAHPoolVfs({\n    name: opts.name ?? \"cellb\",\n    initialCapacity: opts.initialCapacity ?? 16,\n  });\n  // The same pool again in this worker (SQLite WASM keeps one per name), after a `release()`.\n  if (pool.isPaused?.()) await pool.unpauseVfs?.();\n  // A full pool fails the open (`SAH pool is full`), and opening is synchronous while growing\n  // the pool is not. A cell about to open reserves room first (`room`, awaited by the runtime\n  // before the cell's first event); the pool grows when the reservations would not fit, and in\n  // the background whenever less than half of it is free.\n  const SLOTS_PER_CELL = 3; // the database, its journal, and one spare\n  const reserved = new Set<string>();\n  let growing: Promise<void> | undefined;\n  const grow = (min: number): Promise<void> => {\n    growing ??= pool\n      .reserveMinimumCapacity(Math.max(min, pool.getCapacity() * 2))\n      .then(() => {})\n      .finally(() => {\n        growing = undefined;\n      });\n    return growing;\n  };\n  const needed = () => pool.getFileCount() + SLOTS_PER_CELL * reserved.size;\n  const room = (cellKey: string): Promise<void> | undefined => {\n    reserved.add(cellKey);\n    if (needed() <= pool.getCapacity()) return undefined;\n    // Grow until this reservation (and every other one) fits; the open fails visibly if not.\n    const fit = async (): Promise<void> => {\n      while (needed() > pool.getCapacity()) {\n        const before = pool.getCapacity();\n        await grow(needed());\n        if (pool.getCapacity() <= before) return; // it did not grow: the open will say why\n      }\n    };\n    return fit();\n  };\n  const keepRoom = () => {\n    const capacity = pool.getCapacity();\n    if (!growing && capacity - needed() < capacity / 2) grow(capacity * 2).catch(() => {});\n  };\n  // The rollback journal stays in the pool between transactions (PERSIST): DELETE gives its pool\n  // slot back and takes it again on every commit, which costs a header write each time. The\n  // database file is the same in both modes (only WAL marks it).\n  const openDb = (path: string) => {\n    const db = new pool.OpfsSAHPoolDb(path);\n    tuneCellConnection(sqlite3, db);\n    db.exec(\"PRAGMA journal_mode=PERSIST\");\n    return db;\n  };\n  const open: OpenCellSql = (cellKey) => {\n    const path = `/${cellKey.replace(/[^\\w.-]/g, \"_\")}.sqlite`;\n    reserved.delete(cellKey);\n    queueMicrotask(keepRoom); // after this open (and its first slot) is counted\n    return new WasmSqliteDriver(\n      openDb(path),\n      {\n        image: (db) => (sqlite3 as any).capi.sqlite3_js_db_export(db),\n        // Replace the file inside the pool, then reopen it.\n        restore(db, image) {\n          db.close();\n          (pool as any).importDb(path, image);\n          return openDb(path);\n        },\n      },\n      sqlite3 as never,\n    );\n  };\n  return Object.assign(open, {\n    room,\n    reserve: (n: number) => pool.reserveMinimumCapacity(n),\n    /**\n     * Gives the pool's OPFS files back once every database is closed, so that another worker\n     * (another tab's) can open the pool at once instead of when this worker is gone.\n     */\n    release: () => void pool.pauseVfs?.(),\n  });\n}\n"]}
+{"version":3,"file":"wasm-sqlite.js","sourceRoot":"","sources":["../../src/adapters/wasm-sqlite.ts"],"names":[],"mappings":"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","sourcesContent":["import { splitSqlStatements } from \"../core/sql-split.js\";\nimport type { OpenCellSql, SqlResult, SyncSqlDriver } from \"../ports.js\";\nimport { type DirtyPages, installPageHook } from \"./wasm-page-hook.js\";\nimport { type WasmSqlite3, wasmSessionCapture } from \"./wasm-session.js\";\n\n/** Minimal slice of the @sqlite.org/sqlite-wasm `oo1.DB` API we rely on. */\nexport interface Oo1Db {\n  prepare(sql: string): Oo1Stmt;\n  exec(sql: string): unknown;\n  changes(): number;\n  close(): void;\n}\ninterface Oo1Stmt {\n  bind(values: unknown[]): Oo1Stmt;\n  getColumnNames(): string[];\n  columnCount: number;\n  step(): boolean;\n  get(target: unknown[]): unknown[];\n  finalize(): void;\n}\n\n/**\n * SyncSqlDriver over the official SQLite WASM build (oo1 API). Synchronous,\n * so it satisfies `ctx.storage.sql`. Works in Node (in-memory, for tests) and\n * in browsers; persistence comes from the VFS behind the DB (see sahpoolOpener).\n */\n/** Backup hooks: how to export an image of the DB and how to replace it (returns the reopened DB). */\nexport interface WasmImageHooks {\n  image(db: Oo1Db): Uint8Array;\n  restore(db: Oo1Db, image: Uint8Array): Oo1Db;\n}\n\nexport class WasmSqliteDriver implements SyncSqlDriver {\n  captureStart?: () => void;\n  captureTake?: () => Uint8Array;\n  captureDiscard?: () => void;\n  applyChangeset?: (changeset: Uint8Array) => void;\n  captureCoversRowidTables?: boolean;\n  #db: Oo1Db;\n  readonly #hooks?: WasmImageHooks;\n  readonly #sqlite3?: WasmSqlite3;\n  readonly #capi?: { sqlite3_get_autocommit(db: number): number };\n  #pageHook?: ReturnType<typeof installPageHook>;\n  constructor(\n    db: Oo1Db,\n    hooks?: WasmImageHooks,\n    sqlite3?: WasmSqlite3,\n    /** SQLite's C API, for `inTransaction()` alone (when `sqlite3` is not given). */\n    capi?: { sqlite3_get_autocommit(db: number): number },\n  ) {\n    this.#db = db;\n    this.#hooks = hooks;\n    this.#sqlite3 = sqlite3;\n    this.#capi = capi ?? sqlite3?.capi;\n    if (!this.#capi?.sqlite3_get_autocommit)\n      (this as { inTransaction?: unknown }).inTransaction = undefined;\n    this.#enableDqs();\n    this.#hookPages();\n    if (sqlite3?.capi?.sqlite3session_create) {\n      // Transaction-log capture (session extension), following the current DB handle.\n      Object.assign(\n        this,\n        wasmSessionCapture(sqlite3, () => (this.#db as unknown as { pointer: number }).pointer),\n      );\n    }\n    if (!hooks) {\n      // No image support for this driver: hide the optional port methods.\n      (this as { image?: unknown }).image = undefined;\n      (this as { restore?: unknown }).restore = undefined;\n    }\n  }\n  image(): Uint8Array {\n    return this.#hooks!.image(this.#db);\n  }\n\n  /**\n   * As celld and workerd: a double-quoted name that is no column is a string literal (SQLite's\n   * DQS misfeature, off in this build).\n   */\n  #enableDqs(): void {\n    const capi = this.#sqlite3?.capi;\n    if (!capi?.sqlite3_db_config) return;\n    const db = (this.#db as unknown as { pointer: number }).pointer;\n    capi.sqlite3_db_config(db, capi.SQLITE_DBCONFIG_DQS_DML, 1, 0);\n    capi.sqlite3_db_config(db, capi.SQLITE_DBCONFIG_DQS_DDL, 1, 0);\n  }\n\n  /** Installs the page hook on the current main database file (see wasm-page-hook.ts). */\n  #hookPages(): void {\n    this.#pageHook = undefined;\n    if (!this.#sqlite3?.capi?.sqlite3_file_control) return;\n    try {\n      this.#pageHook = installPageHook(\n        this.#sqlite3,\n        (this.#db as unknown as { pointer: number }).pointer,\n      );\n    } catch {\n      this.#pageHook = undefined;\n    }\n  }\n  /** Pages written since the previous call — a committed transaction's changed pages. */\n  takeDirtyPages(): DirtyPages | undefined {\n    if (!this.#pageHook) return undefined;\n    const pageSize = Number(this.exec(\"PRAGMA page_size\", []).rows[0][0]);\n    const pageCount = Number(this.exec(\"PRAGMA page_count\", []).rows[0][0]);\n    return this.#pageHook.take(pageSize, pageCount);\n  }\n  discardDirtyPages(): void {\n    this.#pageHook?.discard();\n  }\n  /**\n   * WASM builds cannot load extensions at run time; an extension must be compiled into the\n   * build (e.g. the `sqlite-vec-wasm-demo` package for \"sqlite_vec\"). This only checks it is.\n   */\n  loadExtension(name: string): void {\n    const probe: Record<string, string> = { sqlite_vec: \"SELECT vec_version()\" };\n    if (!probe[name]) throw new Error(`Unknown SQLite extension \"${name}\"`);\n    try {\n      this.exec(probe[name], []);\n    } catch {\n      throw new Error(`SQLite extension \"${name}\" is not compiled into this SQLite WASM build`);\n    }\n  }\n  restore(image: Uint8Array): void {\n    // celld's databases are in WAL mode (header bytes 18–19 = 2); the WASM VFSes (memdb,\n    // opfs-sahpool) have no shared memory for WAL and refuse to open such a file. The pages\n    // are the same in rollback-journal mode: switch the header to 1 (celld sets WAL again\n    // when it opens the database).\n    if (image.length > 19 && image[18] === 2 && image[19] === 2) {\n      image = image.slice();\n      image[18] = 1;\n      image[19] = 1;\n    }\n    this.#db = this.#hooks!.restore(this.#db, image);\n    this.#enableDqs();\n    this.#hookPages(); // a new database file behind the connection\n  }\n  exec(sql: string, params: unknown[]): SqlResult {\n    const statements = params.length === 0 ? splitSqlStatements(sql) : [sql];\n    // Several statements: the result of the last one, with the rows written by all of them.\n    let last: SqlResult = { columnNames: [], rows: [], rowsWritten: 0 };\n    let written = 0;\n    for (const text of statements) {\n      last = this.#one(text, params);\n      written += last.rowsWritten;\n    }\n    return { ...last, rowsWritten: written };\n  }\n  #one(sql: string, params: unknown[]): SqlResult {\n    const st = this.#db.prepare(sql);\n    try {\n      if (params.length) st.bind(params.map(toSqlite));\n      const columnNames = st.columnCount ? st.getColumnNames() : [];\n      const rows: unknown[][] = [];\n      while (st.step()) if (columnNames.length) rows.push(st.get([]).map(fromSqlite));\n      return { columnNames, rows, rowsWritten: columnNames.length ? 0 : this.#db.changes() };\n    } finally {\n      st.finalize();\n    }\n  }\n  inTransaction(): boolean {\n    const pointer = (this.#db as unknown as { pointer: number }).pointer;\n    return this.#capi!.sqlite3_get_autocommit(pointer) === 0;\n  }\n  databaseSize(): number {\n    const pc = this.exec(\"PRAGMA page_count\", []).rows[0][0];\n    const ps = this.exec(\"PRAGMA page_size\", []).rows[0][0];\n    return Number(pc) * Number(ps);\n  }\n  close(): void {\n    this.#db.close();\n  }\n}\n\nfunction toSqlite(v: unknown): unknown {\n  if (v instanceof ArrayBuffer) return new Uint8Array(v);\n  if (typeof v === \"boolean\") return v ? 1 : 0;\n  return v === undefined ? null : v;\n}\nfunction fromSqlite(v: unknown): unknown {\n  if (v instanceof Uint8Array) return v.buffer.slice(v.byteOffset, v.byteOffset + v.byteLength);\n  return v;\n}\n\n/** In-memory WASM databases (tests, ephemeral cells). `sqlite3` = await sqlite3InitModule(). */\n/** Image hooks for an in-memory DB: `sqlite3_js_db_export` / `sqlite3_deserialize`. */\nexport function memoryImageHooks(sqlite3: any): WasmImageHooks {\n  const { capi, wasm } = sqlite3;\n  return {\n    image: (db) => sqlite3.capi.sqlite3_js_db_export(db),\n    restore(db, image) {\n      const p = wasm.allocFromTypedArray(image);\n      const rc = capi.sqlite3_deserialize(\n        (db as any).pointer,\n        \"main\",\n        p,\n        image.byteLength,\n        image.byteLength,\n        capi.SQLITE_DESERIALIZE_FREEONCLOSE | capi.SQLITE_DESERIALIZE_RESIZEABLE,\n      );\n      if (rc) throw new Error(`sqlite3_deserialize failed: ${capi.sqlite3_js_rc_str?.(rc) ?? rc}`);\n      return db;\n    },\n  };\n}\n\n/**\n * Sets up a new SQLite WASM connection for a cell. One worker holds many small cells, and SQLite\n * WASM's heap is capped at 2 GiB and never shrinks, so each connection's fixed memory decides how\n * many cells can be open at once:\n * - no lookaside: SQLite's per-connection allocator of small blocks, about 45 KiB each;\n * - 4 KiB pages for a database that is still empty (celld's page size: SQLite's native default;\n *   the WASM build's is 8 KiB). The page cache starts with a block of pages, so the page size\n *   sets most of a connection's memory. A database that already holds data keeps its page size.\n * Together they bring a connection with one small table from about 258 KiB to about 120 KiB.\n */\nexport function tuneCellConnection(sqlite3: unknown, db: Oo1Db): void {\n  const capi = (sqlite3 as { capi?: Record<string, any> }).capi;\n  const pointer = (db as unknown as { pointer?: number }).pointer;\n  // Before the connection runs any statement: SQLite refuses (SQLITE_BUSY) while lookaside is used.\n  if (capi?.sqlite3_db_config && pointer) {\n    capi.sqlite3_db_config(pointer, capi.SQLITE_DBCONFIG_LOOKASIDE, 0, 0, 0);\n  }\n  db.exec(\"PRAGMA page_size=4096\");\n}\n\nlet memdbCounter = 0;\nexport function wasmMemoryOpener(sqlite3: {\n  oo1: { DB: new (path: string, mode?: string) => Oo1Db };\n}): OpenCellSql {\n  return () => {\n    // memdb (not \":memory:\"): an in-memory database that IS a VFS file, so the page hook works.\n    const db = new sqlite3.oo1.DB(`file:/cells-mem-${++memdbCounter}?vfs=memdb`, \"c\");\n    tuneCellConnection(sqlite3, db);\n    return new WasmSqliteDriver(db, memoryImageHooks(sqlite3), sqlite3 as never);\n  };\n}\n\n/**\n * Browser persistence: one OPFS \"SyncAccessHandle pool\" database per cell.\n * Must run in a Dedicated Worker; needs neither COOP/COEP nor SharedArrayBuffer.\n * Not runnable in Node (installOpfsSAHPoolVfs is browser-only) — covered by P04's Playwright spec.\n */\nexport async function sahpoolOpener(\n  sqlite3: {\n    installOpfsSAHPoolVfs(opts: { name?: string; initialCapacity?: number }): Promise<{\n      OpfsSAHPoolDb: new (path: string) => Oo1Db;\n      reserveMinimumCapacity(n: number): Promise<number>;\n      addCapacity?(n: number): Promise<number>;\n      getCapacity(): number;\n      getFileCount(): number;\n      getFileNames?(): string[];\n      // Not in older SQLite WASM builds (sqlite-vec's): there `release()` does nothing.\n      pauseVfs?(): unknown;\n      isPaused?(): boolean;\n      unpauseVfs?(): Promise<unknown>;\n    }>;\n  },\n  opts: { name?: string; initialCapacity?: number } = {},\n): Promise<OpenCellSql & { reserve(n: number): Promise<number>; release(): void }> {\n  const pool = await sqlite3.installOpfsSAHPoolVfs({\n    name: opts.name ?? \"cellb\",\n    initialCapacity: opts.initialCapacity ?? 16,\n  });\n  // The same pool again in this worker (SQLite WASM keeps one per name), after a `release()`.\n  if (pool.isPaused?.()) await pool.unpauseVfs?.();\n  // A full pool fails the open (`SAH pool is full`), and opening is synchronous while growing\n  // the pool is not. Each new slot is an OPFS file with a sync access handle, made one at a time,\n  // and once the worker is busy each one takes seconds (about 5 s with 32 Flue conversations in\n  // one worker), so the pool grows ahead of need, in small steps:\n  // - a cell about to open reserves room first (`room`, awaited by the runtime before the cell's\n  //   first event): its database, its journal and a spare, and it waits until what was needed\n  //   when it asked fits, one step of 16 slots at a time (not a doubling, nor later reservations);\n  // - an open cell counts its journal until it has one (SQLite makes it at the cell's first\n  //   write), so the pool grows while it still has room, not once the journals fill it;\n  // - at each open (failed ones too: a cell can reopen without `room`), the pool grows in the\n  //   background until two thirds of it are free: an unused slot costs a small file, a missing\n  //   one a wait of seconds per slot, so it grows while the worker is still quiet.\n  const SLOTS_PER_CELL = 3; // the database, its journal, and one spare\n  const STEP = 16; // slots per growth step, made in parallel\n  const AHEAD = 3; // the pool's size, in multiples of what it needs, kept by the background growth\n  const reserved = new Set<string>();\n  const opened = new Map<string, { path: string }>(); // the open cells' databases\n  let growing: Promise<void> | undefined;\n  /**\n   * One growth step toward `target` (one at a time: a second caller joins it). SQLite makes a\n   * pool's new slots one after another, two awaited OPFS calls each, and in a busy worker each\n   * await waits seconds for the event loop: the step asks for its slots in parallel instead,\n   * one `addCapacity(1)` each, so it costs about one slot's wait.\n   */\n  const step = (target: number): Promise<void> => {\n    const n = Math.min(target, pool.getCapacity() + STEP) - pool.getCapacity();\n    growing ??= (\n      pool.addCapacity && n > 0\n        ? Promise.all(Array.from({ length: n }, () => pool.addCapacity?.(1)))\n        : pool.reserveMinimumCapacity(pool.getCapacity() + Math.max(n, 0))\n    )\n      .then(() => {})\n      .finally(() => {\n        growing = undefined;\n      });\n    return growing;\n  };\n  const needed = () => {\n    // Journals not made yet. Without the pool's file names (older SQLite WASM builds) none\n    // is counted, as before: the files that exist are.\n    let journals = 0;\n    if (pool.getFileNames) {\n      const files = new Set(pool.getFileNames());\n      for (const { path } of opened.values()) if (!files.has(`${path}-journal`)) journals++;\n    }\n    return pool.getFileCount() + journals + SLOTS_PER_CELL * reserved.size;\n  };\n  /** Grows until `target()` fits; stops when a step of its own adds nothing (the open says why). */\n  const growTo = async (target: () => number): Promise<void> => {\n    while (target() > pool.getCapacity()) {\n      // A step already under way may have added its slots and not ended yet: joining it says\n      // nothing about whether the pool can grow.\n      const joined = growing !== undefined;\n      const before = pool.getCapacity();\n      await step(target());\n      if (!joined && pool.getCapacity() <= before) return;\n    }\n  };\n  const room = (cellKey: string): Promise<void> | undefined => {\n    reserved.add(cellKey);\n    const target = needed();\n    if (target <= pool.getCapacity()) return undefined;\n    return growTo(() => target);\n  };\n  let ahead: Promise<void> | undefined;\n  const keepRoom = () => {\n    if (ahead || pool.getCapacity() >= AHEAD * needed()) return;\n    ahead = growTo(() => AHEAD * needed())\n      .catch(() => {})\n      .finally(() => {\n        ahead = undefined;\n      });\n  };\n  // The rollback journal stays in the pool between transactions (PERSIST): DELETE gives its pool\n  // slot back and takes it again on every commit, which costs a header write each time. The\n  // database file is the same in both modes (only WAL marks it).\n  const openDb = (path: string) => {\n    const db = new pool.OpfsSAHPoolDb(path);\n    tuneCellConnection(sqlite3, db);\n    db.exec(\"PRAGMA journal_mode=PERSIST\");\n    return db;\n  };\n  const open: OpenCellSql = (cellKey) => {\n    const path = `/${cellKey.replace(/[^\\w.-]/g, \"_\")}.sqlite`;\n    reserved.delete(cellKey);\n    // Counted from now on, with its journal until it has one; no longer once it is closed.\n    const entry = { path };\n    opened.set(cellKey, entry);\n    keepRoom();\n    let driver: WasmSqliteDriver;\n    try {\n      driver = new WasmSqliteDriver(\n        openDb(path),\n        {\n          image: (db) => (sqlite3 as any).capi.sqlite3_js_db_export(db),\n          // Replace the file inside the pool, then reopen it.\n          restore(db, image) {\n            db.close();\n            (pool as any).importDb(path, image);\n            return openDb(path);\n          },\n        },\n        sqlite3 as never,\n      );\n    } catch (err) {\n      if (opened.get(cellKey) === entry) opened.delete(cellKey);\n      throw err;\n    }\n    const close = driver.close.bind(driver);\n    driver.close = () => {\n      // Only this driver's entry: the cell may have been opened again since.\n      if (opened.get(cellKey) === entry) opened.delete(cellKey);\n      close();\n    };\n    return driver;\n  };\n  return Object.assign(open, {\n    room,\n    reserve: (n: number) => pool.reserveMinimumCapacity(n),\n    /**\n     * Gives the pool's OPFS files back once every database is closed, so that another worker\n     * (another tab's) can open the pool at once instead of when this worker is gone.\n     */\n    release: () => void pool.pauseVfs?.(),\n  });\n}\n"]}

package/dist/core/storage.d.ts

@@ -56,10 +56,6 @@ export declare class DurableObjectStorage extends AsyncKvApi {
     constructor(sql: SqlStorage, kv: SyncKvStorage, gate: InputGate, sync: () => Promise<void>);
     deleteAll(): Promise<void>;
     transactionSync<T>(fn: () => T): T;
-    /**
-     * Async transaction spanning awaits: the input gate stays closed (no other
-     * event can interleave writes into the savepoint) and auto-commit is held.
-     */
     transaction<T>(closure: (txn: DurableObjectTransaction) => Promise<T>): Promise<T>;
     /** Resolves once all writes so far are durable (the output gate barrier). */
     sync(): Promise<void>;