@statewalker/cellb 0.0.0-stage → 0.1.0

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

@@ -0,0 +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\n// Loaded via require: bundlers (vite/vitest) strip the \"node:\" prefix of the\n// still-experimental node:sqlite builtin and fail to resolve \"sqlite\".\nconst { DatabaseSync } = createRequire(import.meta.url)(\n  \"node:sqlite\",\n) as typeof import(\"node:sqlite\");\n\nimport { splitSqlStatements } from \"../core/sql-split.js\";\nimport type { OpenCellSql, SqlResult, SyncSqlDriver } from \"../ports.js\";\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"]}

package/dist/adapters/wasm-page-hook.d.ts

@@ -0,0 +1,26 @@
+/**
+ * The page hook for SQLite WASM: wraps the io methods of a connection's MAIN database file
+ * (whatever VFS opened it — opfs-sahpool in browsers, memdb, unix) so every page SQLite
+ * writes is recorded. After a commit the recorded pages ARE the transaction's changed pages:
+ * an LTX file costs O(changed pages) instead of a whole-database image.
+ *
+ * How: SQLITE_FCNTL_FILE_POINTER gives the sqlite3_file; a copy of its sqlite3_io_methods
+ * gets a JS xWrite (wasm.installFunction, signature "i(ppij)") that records (offset → bytes)
+ * and calls the original xWrite (wasm.functionEntry); the file's pMethods then points to the
+ * copy. No new VFS is registered. A connection whose main database has no file (":memory:")
+ * cannot be hooked: callers fall back to images.
+ */
+export interface DirtyPages {
+    pageSize: number;
+    pageCount: number;
+    pages: Map<number, Uint8Array>;
+}
+export declare function installPageHook(sqlite3: {
+    capi: any;
+    wasm: any;
+}, dbPointer: number): {
+    /** The pages written since the last call (whole pages: SQLite writes the main file page by page). */
+    take(pageSize: number, pageCount: number): DirtyPages;
+    discard(): void;
+    uninstall(): void;
+} | undefined;

package/dist/adapters/wasm-page-hook.js

@@ -0,0 +1,55 @@
+export function installPageHook(sqlite3, dbPointer) {
+    const { capi, wasm } = sqlite3;
+    const stack = wasm.pstack.pointer;
+    let pFile = 0;
+    try {
+        const pp = wasm.pstack.allocPtr();
+        if (capi.sqlite3_file_control(dbPointer, "main", capi.SQLITE_FCNTL_FILE_POINTER, pp) !== 0)
+            return undefined;
+        pFile = wasm.peekPtr(pp);
+    }
+    finally {
+        wasm.pstack.restore(stack);
+    }
+    if (!pFile)
+        return undefined;
+    const file = new capi.sqlite3_file(pFile);
+    if (!file.$pMethods)
+        return undefined; // no real file behind the database
+    const orig = new capi.sqlite3_io_methods(file.$pMethods);
+    const mine = new capi.sqlite3_io_methods();
+    for (const m of Object.keys(capi.sqlite3_io_methods.structInfo.members))
+        mine[`$${m}`] = orig[`$${m}`];
+    const xWrite = wasm.functionEntry(orig.$xWrite);
+    const written = new Map(); // byte offset → last bytes written there
+    const fnPtr = wasm.installFunction("i(ppij)", (pF, pBuf, iAmt, iOfst) => {
+        if (pF === pFile)
+            written.set(Number(iOfst), wasm.heap8u().slice(pBuf, pBuf + iAmt));
+        return xWrite(pF, pBuf, iAmt, iOfst);
+    });
+    mine.$xWrite = fnPtr;
+    file.$pMethods = mine.pointer;
+    return {
+        /** The pages written since the last call (whole pages: SQLite writes the main file page by page). */
+        take(pageSize, pageCount) {
+            const pages = new Map();
+            for (const [offset, bytes] of written)
+                for (let o = 0; o + pageSize <= bytes.length; o += pageSize) {
+                    const pgno = (offset + o) / pageSize + 1;
+                    if (Number.isInteger(pgno) && pgno <= pageCount)
+                        pages.set(pgno, bytes.subarray(o, o + pageSize));
+                }
+            written.clear();
+            return { pageSize, pageCount, pages };
+        },
+        discard() {
+            written.clear();
+        },
+        uninstall() {
+            file.$pMethods = orig.pointer;
+            wasm.uninstallFunction(fnPtr);
+            mine.dispose();
+        },
+    };
+}
+//# sourceMappingURL=wasm-page-hook.js.map

package/dist/adapters/wasm-page-hook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wasm-page-hook.js","sourceRoot":"","sources":["../../src/adapters/wasm-page-hook.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * The page hook for SQLite WASM: wraps the io methods of a connection's MAIN database file\n * (whatever VFS opened it — opfs-sahpool in browsers, memdb, unix) so every page SQLite\n * writes is recorded. After a commit the recorded pages ARE the transaction's changed pages:\n * an LTX file costs O(changed pages) instead of a whole-database image.\n *\n * How: SQLITE_FCNTL_FILE_POINTER gives the sqlite3_file; a copy of its sqlite3_io_methods\n * gets a JS xWrite (wasm.installFunction, signature \"i(ppij)\") that records (offset → bytes)\n * and calls the original xWrite (wasm.functionEntry); the file's pMethods then points to the\n * copy. No new VFS is registered. A connection whose main database has no file (\":memory:\")\n * cannot be hooked: callers fall back to images.\n */\nexport interface DirtyPages {\n  pageSize: number;\n  pageCount: number;\n  pages: Map<number, Uint8Array>;\n}\n\nexport function installPageHook(sqlite3: { capi: any; wasm: any }, dbPointer: number) {\n  const { capi, wasm } = sqlite3;\n  const stack = wasm.pstack.pointer;\n  let pFile = 0;\n  try {\n    const pp = wasm.pstack.allocPtr();\n    if (capi.sqlite3_file_control(dbPointer, \"main\", capi.SQLITE_FCNTL_FILE_POINTER, pp) !== 0)\n      return undefined;\n    pFile = wasm.peekPtr(pp);\n  } finally {\n    wasm.pstack.restore(stack);\n  }\n  if (!pFile) return undefined;\n  const file = new capi.sqlite3_file(pFile);\n  if (!file.$pMethods) return undefined; // no real file behind the database\n  const orig = new capi.sqlite3_io_methods(file.$pMethods);\n  const mine = new capi.sqlite3_io_methods();\n  for (const m of Object.keys(capi.sqlite3_io_methods.structInfo.members))\n    mine[`$${m}`] = orig[`$${m}`];\n  const xWrite = wasm.functionEntry(orig.$xWrite);\n  const written = new Map<number, Uint8Array>(); // byte offset → last bytes written there\n  const fnPtr = wasm.installFunction(\n    \"i(ppij)\",\n    (pF: number, pBuf: number, iAmt: number, iOfst: bigint) => {\n      if (pF === pFile) written.set(Number(iOfst), wasm.heap8u().slice(pBuf, pBuf + iAmt));\n      return xWrite(pF, pBuf, iAmt, iOfst);\n    },\n  );\n  mine.$xWrite = fnPtr;\n  file.$pMethods = mine.pointer;\n  return {\n    /** The pages written since the last call (whole pages: SQLite writes the main file page by page). */\n    take(pageSize: number, pageCount: number): DirtyPages {\n      const pages = new Map<number, Uint8Array>();\n      for (const [offset, bytes] of written)\n        for (let o = 0; o + pageSize <= bytes.length; o += pageSize) {\n          const pgno = (offset + o) / pageSize + 1;\n          if (Number.isInteger(pgno) && pgno <= pageCount)\n            pages.set(pgno, bytes.subarray(o, o + pageSize));\n        }\n      written.clear();\n      return { pageSize, pageCount, pages };\n    },\n    discard(): void {\n      written.clear();\n    },\n    uninstall(): void {\n      file.$pMethods = orig.pointer;\n      wasm.uninstallFunction(fnPtr);\n      mine.dispose();\n    },\n  };\n}\n"]}

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

@@ -0,0 +1,11 @@
+export interface WasmSqlite3 {
+    capi: any;
+    wasm: any;
+}
+export declare function wasmSessionCapture(sqlite3: WasmSqlite3, getDbPointer: () => number): {
+    captureCoversRowidTables: true;
+    captureStart(): void;
+    captureTake(): Uint8Array;
+    captureDiscard(): void;
+    applyChangeset(changeset: Uint8Array): void;
+};

package/dist/adapters/wasm-session.js

@@ -0,0 +1,76 @@
+/**
+ * SQLite session extension over the official WASM build (C API through `sqlite3.capi`):
+ * the change capture behind transaction logs. With SQLITE_SESSION_OBJCONFIG_ROWID, tables
+ * without a PRIMARY KEY are captured too (node:sqlite cannot do this).
+ */
+const SESSION_OBJCONFIG_ROWID = 2; // not exported as a constant by the JS bindings
+const CHANGESET_REPLACE = 1;
+export function wasmSessionCapture(sqlite3, getDbPointer) {
+    const { capi, wasm } = sqlite3;
+    let session = 0;
+    const free = () => {
+        if (session)
+            capi.sqlite3session_delete(session);
+        session = 0;
+    };
+    return {
+        captureCoversRowidTables: true,
+        captureStart() {
+            free();
+            const stack = wasm.pstack.pointer;
+            try {
+                const pp = wasm.pstack.allocPtr();
+                const rc = capi.sqlite3session_create(getDbPointer(), "main", pp);
+                if (rc)
+                    throw new Error(`sqlite3session_create failed: ${rc}`);
+                session = wasm.peekPtr(pp);
+                const pInt = wasm.pstack.alloc(4);
+                wasm.poke32(pInt, 1);
+                capi.sqlite3session_object_config(session, SESSION_OBJCONFIG_ROWID, pInt);
+                capi.sqlite3session_attach(session, null);
+            }
+            finally {
+                wasm.pstack.restore(stack);
+            }
+        },
+        captureTake() {
+            if (!session)
+                return new Uint8Array();
+            const stack = wasm.pstack.pointer;
+            try {
+                const pN = wasm.pstack.alloc(4);
+                const pBuf = wasm.pstack.allocPtr();
+                const rc = capi.sqlite3session_changeset(session, pN, pBuf);
+                if (rc)
+                    throw new Error(`sqlite3session_changeset failed: ${rc}`);
+                const n = wasm.peek32(pN);
+                const buf = wasm.peekPtr(pBuf);
+                const bytes = n ? wasm.heap8u().slice(buf, buf + n) : new Uint8Array();
+                if (buf)
+                    capi.sqlite3_free(buf);
+                return bytes;
+            }
+            finally {
+                wasm.pstack.restore(stack);
+                free();
+            }
+        },
+        captureDiscard() {
+            free();
+        },
+        applyChangeset(changeset) {
+            if (!changeset.byteLength)
+                return;
+            const p = wasm.allocFromTypedArray(changeset);
+            try {
+                const rc = capi.sqlite3changeset_apply(getDbPointer(), changeset.byteLength, p, 0, () => CHANGESET_REPLACE, 0);
+                if (rc)
+                    throw new Error(`sqlite3changeset_apply failed: ${rc}`);
+            }
+            finally {
+                wasm.dealloc(p);
+            }
+        },
+    };
+}
+//# sourceMappingURL=wasm-session.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"wasm-session.js","sourceRoot":"","sources":["../../src/adapters/wasm-session.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * SQLite session extension over the official WASM build (C API through `sqlite3.capi`):\n * the change capture behind transaction logs. With SQLITE_SESSION_OBJCONFIG_ROWID, tables\n * without a PRIMARY KEY are captured too (node:sqlite cannot do this).\n */\nconst SESSION_OBJCONFIG_ROWID = 2; // not exported as a constant by the JS bindings\nconst CHANGESET_REPLACE = 1;\n\nexport interface WasmSqlite3 {\n  capi: any;\n  wasm: any;\n}\n\nexport function wasmSessionCapture(sqlite3: WasmSqlite3, getDbPointer: () => number) {\n  const { capi, wasm } = sqlite3;\n  let session = 0;\n  const free = () => {\n    if (session) capi.sqlite3session_delete(session);\n    session = 0;\n  };\n  return {\n    captureCoversRowidTables: true as const,\n    captureStart(): void {\n      free();\n      const stack = wasm.pstack.pointer;\n      try {\n        const pp = wasm.pstack.allocPtr();\n        const rc = capi.sqlite3session_create(getDbPointer(), \"main\", pp);\n        if (rc) throw new Error(`sqlite3session_create failed: ${rc}`);\n        session = wasm.peekPtr(pp);\n        const pInt = wasm.pstack.alloc(4);\n        wasm.poke32(pInt, 1);\n        capi.sqlite3session_object_config(session, SESSION_OBJCONFIG_ROWID, pInt);\n        capi.sqlite3session_attach(session, null);\n      } finally {\n        wasm.pstack.restore(stack);\n      }\n    },\n    captureTake(): Uint8Array {\n      if (!session) return new Uint8Array();\n      const stack = wasm.pstack.pointer;\n      try {\n        const pN = wasm.pstack.alloc(4);\n        const pBuf = wasm.pstack.allocPtr();\n        const rc = capi.sqlite3session_changeset(session, pN, pBuf);\n        if (rc) throw new Error(`sqlite3session_changeset failed: ${rc}`);\n        const n = wasm.peek32(pN);\n        const buf = wasm.peekPtr(pBuf);\n        const bytes = n ? wasm.heap8u().slice(buf, buf + n) : new Uint8Array();\n        if (buf) capi.sqlite3_free(buf);\n        return bytes;\n      } finally {\n        wasm.pstack.restore(stack);\n        free();\n      }\n    },\n    captureDiscard(): void {\n      free();\n    },\n    applyChangeset(changeset: Uint8Array): void {\n      if (!changeset.byteLength) return;\n      const p = wasm.allocFromTypedArray(changeset);\n      try {\n        const rc = capi.sqlite3changeset_apply(\n          getDbPointer(),\n          changeset.byteLength,\n          p,\n          0,\n          () => CHANGESET_REPLACE,\n          0,\n        );\n        if (rc) throw new Error(`sqlite3changeset_apply failed: ${rc}`);\n      } finally {\n        wasm.dealloc(p);\n      }\n    },\n  };\n}\n"]}

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

@@ -0,0 +1,89 @@
+import type { OpenCellSql, SqlResult, SyncSqlDriver } from "../ports.js";
+import { type DirtyPages } from "./wasm-page-hook.js";
+import { type WasmSqlite3 } from "./wasm-session.js";
+/** Minimal slice of the @sqlite.org/sqlite-wasm `oo1.DB` API we rely on. */
+export interface Oo1Db {
+    prepare(sql: string): Oo1Stmt;
+    exec(sql: string): unknown;
+    changes(): number;
+    close(): void;
+}
+interface Oo1Stmt {
+    bind(values: unknown[]): Oo1Stmt;
+    getColumnNames(): string[];
+    columnCount: number;
+    step(): boolean;
+    get(target: unknown[]): unknown[];
+    finalize(): void;
+}
+/**
+ * SyncSqlDriver over the official SQLite WASM build (oo1 API). Synchronous,
+ * so it satisfies `ctx.storage.sql`. Works in Node (in-memory, for tests) and
+ * in browsers; persistence comes from the VFS behind the DB (see sahpoolOpener).
+ */
+/** Backup hooks: how to export an image of the DB and how to replace it (returns the reopened DB). */
+export interface WasmImageHooks {
+    image(db: Oo1Db): Uint8Array;
+    restore(db: Oo1Db, image: Uint8Array): Oo1Db;
+}
+export declare class WasmSqliteDriver implements SyncSqlDriver {
+    #private;
+    captureStart?: () => void;
+    captureTake?: () => Uint8Array;
+    captureDiscard?: () => void;
+    applyChangeset?: (changeset: Uint8Array) => void;
+    captureCoversRowidTables?: boolean;
+    constructor(db: Oo1Db, hooks?: WasmImageHooks, sqlite3?: WasmSqlite3, 
+    /** SQLite's C API, for `inTransaction()` alone (when `sqlite3` is not given). */
+    capi?: {
+        sqlite3_get_autocommit(db: number): number;
+    });
+    image(): Uint8Array;
+    /** Pages written since the previous call — a committed transaction's changed pages. */
+    takeDirtyPages(): DirtyPages | undefined;
+    discardDirtyPages(): void;
+    /**
+     * WASM builds cannot load extensions at run time; an extension must be compiled into the
+     * build (e.g. the `sqlite-vec-wasm-demo` package for "sqlite_vec"). This only checks it is.
+     */
+    loadExtension(name: string): void;
+    restore(image: Uint8Array): void;
+    exec(sql: string, params: unknown[]): SqlResult;
+    inTransaction(): boolean;
+    databaseSize(): number;
+    close(): void;
+}
+/** In-memory WASM databases (tests, ephemeral cells). `sqlite3` = await sqlite3InitModule(). */
+/** Image hooks for an in-memory DB: `sqlite3_js_db_export` / `sqlite3_deserialize`. */
+export declare function memoryImageHooks(sqlite3: any): WasmImageHooks;
+export declare function wasmMemoryOpener(sqlite3: {
+    oo1: {
+        DB: new (path: string, mode?: string) => Oo1Db;
+    };
+}): OpenCellSql;
+/**
+ * Browser persistence: one OPFS "SyncAccessHandle pool" database per cell.
+ * Must run in a Dedicated Worker; needs neither COOP/COEP nor SharedArrayBuffer.
+ * Not runnable in Node (installOpfsSAHPoolVfs is browser-only) — covered by P04's Playwright spec.
+ */
+export declare function sahpoolOpener(sqlite3: {
+    installOpfsSAHPoolVfs(opts: {
+        name?: string;
+        initialCapacity?: number;
+    }): Promise<{
+        OpfsSAHPoolDb: new (path: string) => Oo1Db;
+        reserveMinimumCapacity(n: number): Promise<number>;
+        getCapacity(): number;
+        getFileCount(): number;
+        pauseVfs?(): unknown;
+        isPaused?(): boolean;
+        unpauseVfs?(): Promise<unknown>;
+    }>;
+}, opts?: {
+    name?: string;
+    initialCapacity?: number;
+}): Promise<OpenCellSql & {
+    reserve(n: number): Promise<number>;
+    release(): void;
+}>;
+export {};

package/dist/adapters/wasm-sqlite.js

@@ -0,0 +1,258 @@
+import { splitSqlStatements } from "../core/sql-split.js";
+import { installPageHook } from "./wasm-page-hook.js";
+import { wasmSessionCapture } from "./wasm-session.js";
+export class WasmSqliteDriver {
+    captureStart;
+    captureTake;
+    captureDiscard;
+    applyChangeset;
+    captureCoversRowidTables;
+    #db;
+    #hooks;
+    #sqlite3;
+    #capi;
+    #pageHook;
+    constructor(db, hooks, sqlite3, 
+    /** SQLite's C API, for `inTransaction()` alone (when `sqlite3` is not given). */
+    capi) {
+        this.#db = db;
+        this.#hooks = hooks;
+        this.#sqlite3 = sqlite3;
+        this.#capi = capi ?? sqlite3?.capi;
+        if (!this.#capi?.sqlite3_get_autocommit)
+            this.inTransaction = undefined;
+        this.#enableDqs();
+        this.#hookPages();
+        if (sqlite3?.capi?.sqlite3session_create) {
+            // Transaction-log capture (session extension), following the current DB handle.
+            Object.assign(this, wasmSessionCapture(sqlite3, () => this.#db.pointer));
+        }
+        if (!hooks) {
+            // No image support for this driver: hide the optional port methods.
+            this.image = undefined;
+            this.restore = undefined;
+        }
+    }
+    image() {
+        return this.#hooks.image(this.#db);
+    }
+    /**
+     * As celld and workerd: a double-quoted name that is no column is a string literal (SQLite's
+     * DQS misfeature, off in this build).
+     */
+    #enableDqs() {
+        const capi = this.#sqlite3?.capi;
+        if (!capi?.sqlite3_db_config)
+            return;
+        const db = this.#db.pointer;
+        capi.sqlite3_db_config(db, capi.SQLITE_DBCONFIG_DQS_DML, 1, 0);
+        capi.sqlite3_db_config(db, capi.SQLITE_DBCONFIG_DQS_DDL, 1, 0);
+    }
+    /** Installs the page hook on the current main database file (see wasm-page-hook.ts). */
+    #hookPages() {
+        this.#pageHook = undefined;
+        if (!this.#sqlite3?.capi?.sqlite3_file_control)
+            return;
+        try {
+            this.#pageHook = installPageHook(this.#sqlite3, this.#db.pointer);
+        }
+        catch {
+            this.#pageHook = undefined;
+        }
+    }
+    /** Pages written since the previous call — a committed transaction's changed pages. */
+    takeDirtyPages() {
+        if (!this.#pageHook)
+            return undefined;
+        const pageSize = Number(this.exec("PRAGMA page_size", []).rows[0][0]);
+        const pageCount = Number(this.exec("PRAGMA page_count", []).rows[0][0]);
+        return this.#pageHook.take(pageSize, pageCount);
+    }
+    discardDirtyPages() {
+        this.#pageHook?.discard();
+    }
+    /**
+     * WASM builds cannot load extensions at run time; an extension must be compiled into the
+     * build (e.g. the `sqlite-vec-wasm-demo` package for "sqlite_vec"). This only checks it is.
+     */
+    loadExtension(name) {
+        const probe = { sqlite_vec: "SELECT vec_version()" };
+        if (!probe[name])
+            throw new Error(`Unknown SQLite extension "${name}"`);
+        try {
+            this.exec(probe[name], []);
+        }
+        catch {
+            throw new Error(`SQLite extension "${name}" is not compiled into this SQLite WASM build`);
+        }
+    }
+    restore(image) {
+        // celld's databases are in WAL mode (header bytes 18–19 = 2); the WASM VFSes (memdb,
+        // opfs-sahpool) have no shared memory for WAL and refuse to open such a file. The pages
+        // are the same in rollback-journal mode: switch the header to 1 (celld sets WAL again
+        // when it opens the database).
+        if (image.length > 19 && image[18] === 2 && image[19] === 2) {
+            image = image.slice();
+            image[18] = 1;
+            image[19] = 1;
+        }
+        this.#db = this.#hooks.restore(this.#db, image);
+        this.#enableDqs();
+        this.#hookPages(); // a new database file behind the connection
+    }
+    exec(sql, params) {
+        const statements = params.length === 0 ? splitSqlStatements(sql) : [sql];
+        // Several statements: the result of the last one, with the rows written by all of them.
+        let last = { columnNames: [], rows: [], rowsWritten: 0 };
+        let written = 0;
+        for (const text of statements) {
+            last = this.#one(text, params);
+            written += last.rowsWritten;
+        }
+        return { ...last, rowsWritten: written };
+    }
+    #one(sql, params) {
+        const st = this.#db.prepare(sql);
+        try {
+            if (params.length)
+                st.bind(params.map(toSqlite));
+            const columnNames = st.columnCount ? st.getColumnNames() : [];
+            const rows = [];
+            while (st.step())
+                if (columnNames.length)
+                    rows.push(st.get([]).map(fromSqlite));
+            return { columnNames, rows, rowsWritten: columnNames.length ? 0 : this.#db.changes() };
+        }
+        finally {
+            st.finalize();
+        }
+    }
+    inTransaction() {
+        const pointer = this.#db.pointer;
+        return this.#capi.sqlite3_get_autocommit(pointer) === 0;
+    }
+    databaseSize() {
+        const pc = this.exec("PRAGMA page_count", []).rows[0][0];
+        const ps = this.exec("PRAGMA page_size", []).rows[0][0];
+        return Number(pc) * Number(ps);
+    }
+    close() {
+        this.#db.close();
+    }
+}
+function toSqlite(v) {
+    if (v instanceof ArrayBuffer)
+        return new Uint8Array(v);
+    if (typeof v === "boolean")
+        return v ? 1 : 0;
+    return v === undefined ? null : v;
+}
+function fromSqlite(v) {
+    if (v instanceof Uint8Array)
+        return v.buffer.slice(v.byteOffset, v.byteOffset + v.byteLength);
+    return v;
+}
+/** In-memory WASM databases (tests, ephemeral cells). `sqlite3` = await sqlite3InitModule(). */
+/** Image hooks for an in-memory DB: `sqlite3_js_db_export` / `sqlite3_deserialize`. */
+export function memoryImageHooks(sqlite3) {
+    const { capi, wasm } = sqlite3;
+    return {
+        image: (db) => sqlite3.capi.sqlite3_js_db_export(db),
+        restore(db, image) {
+            const p = wasm.allocFromTypedArray(image);
+            const rc = capi.sqlite3_deserialize(db.pointer, "main", p, image.byteLength, image.byteLength, capi.SQLITE_DESERIALIZE_FREEONCLOSE | capi.SQLITE_DESERIALIZE_RESIZEABLE);
+            if (rc)
+                throw new Error(`sqlite3_deserialize failed: ${capi.sqlite3_js_rc_str?.(rc) ?? rc}`);
+            return db;
+        },
+    };
+}
+let memdbCounter = 0;
+export function wasmMemoryOpener(sqlite3) {
+    return () => new WasmSqliteDriver(
+    // memdb (not ":memory:"): an in-memory database that IS a VFS file, so the page hook works.
+    new sqlite3.oo1.DB(`file:/cells-mem-${++memdbCounter}?vfs=memdb`, "c"), memoryImageHooks(sqlite3), sqlite3);
+}
+/**
+ * Browser persistence: one OPFS "SyncAccessHandle pool" database per cell.
+ * Must run in a Dedicated Worker; needs neither COOP/COEP nor SharedArrayBuffer.
+ * Not runnable in Node (installOpfsSAHPoolVfs is browser-only) — covered by P04's Playwright spec.
+ */
+export async function sahpoolOpener(sqlite3, opts = {}) {
+    const pool = await sqlite3.installOpfsSAHPoolVfs({
+        name: opts.name ?? "cellb",
+        initialCapacity: opts.initialCapacity ?? 16,
+    });
+    // The same pool again in this worker (SQLite WASM keeps one per name), after a `release()`.
+    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.
+    const SLOTS_PER_CELL = 3; // the database, its journal, and one spare
+    const reserved = new Set();
+    let growing;
+    const grow = (min) => {
+        growing ??= pool
+            .reserveMinimumCapacity(Math.max(min, pool.getCapacity() * 2))
+            .then(() => { })
+            .finally(() => {
+            growing = undefined;
+        });
+        return growing;
+    };
+    const needed = () => pool.getFileCount() + SLOTS_PER_CELL * reserved.size;
+    const room = (cellKey) => {
+        reserved.add(cellKey);
+        if (needed() <= 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();
+    };
+    const keepRoom = () => {
+        const capacity = pool.getCapacity();
+        if (!growing && capacity - needed() < capacity / 2)
+            grow(capacity * 2).catch(() => { });
+    };
+    // 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
+    // database file is the same in both modes (only WAL marks it).
+    const openDb = (path) => {
+        const db = new pool.OpfsSAHPoolDb(path);
+        db.exec("PRAGMA journal_mode=PERSIST");
+        return db;
+    };
+    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);
+    };
+    return Object.assign(open, {
+        room,
+        reserve: (n) => pool.reserveMinimumCapacity(n),
+        /**
+         * Gives the pool's OPFS files back once every database is closed, so that another worker
+         * (another tab's) can open the pool at once instead of when this worker is gone.
+         */
+        release: () => void pool.pauseVfs?.(),
+    });
+}
+//# sourceMappingURL=wasm-sqlite.js.map

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

@@ -0,0 +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\nlet memdbCounter = 0;\nexport function wasmMemoryOpener(sqlite3: {\n  oo1: { DB: new (path: string, mode?: string) => Oo1Db };\n}): OpenCellSql {\n  return () =>\n    new WasmSqliteDriver(\n      // memdb (not \":memory:\"): an in-memory database that IS a VFS file, so the page hook works.\n      new sqlite3.oo1.DB(`file:/cells-mem-${++memdbCounter}?vfs=memdb`, \"c\"),\n      memoryImageHooks(sqlite3),\n      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    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"]}