@mcp-b/do-runtime 0.1.0

package/dist/backends/node-sqlite.js

@@ -0,0 +1,335 @@
+import { d as requireValidSqlDatabaseSnapshot, l as requireSafeDatabaseName, n as SQL_WRONG_BINDINGS_MESSAGE, u as requireSqliteLength } from "../chunks/sqlite-DFg92Tgt.js";
+import { randomUUID } from "node:crypto";
+import { rmSync } from "node:fs";
+import { readFile, readdir, rename, rm, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import { DatabaseSync } from "node:sqlite";
+//#region backends/node-sqlite.ts
+/**
+* ← workerd `NO upstream correspondence (storage-backend adaptation)`
+*
+* `SqlDatabaseProvider` over `node:sqlite`. Promoted out of
+* `host/fixtures/storage-node.ts`, which is already this adapter.
+*
+* Upstream's equivalent is `SqliteDatabase`'s binding to the SQLite C API plus
+* its kj-filesystem VFS — 3,768 lines this package deliberately does not port,
+* because `node:sqlite` and sqlite-wasm play that role underneath us. What has
+* to match is the layer above: the SQL that `sqlite-kv` and `sqlite-metadata`
+* write, and the four operations they need from a database.
+*
+* This is the substrate the unit lane runs on. It is also decision 11's Node
+* conformance lane, and `fixtures/storage-node.ts` already proves the seam
+* across 20 of the extension's 24 Node-lane test files.
+*/
+function createNodeSqlProvider(options = {}) {
+	const directory = options.directory;
+	const openDatabases = /* @__PURE__ */ new Set();
+	return {
+		async open(name) {
+			requireSafeDatabaseName(name);
+			const path = directory === void 0 ? ":memory:" : join(directory, `${name}.sqlite`);
+			let database;
+			database = new NodeSqlDatabase(path, () => openDatabases.delete(database));
+			openDatabases.add(database);
+			return database;
+		},
+		close() {
+			for (const database of [...openDatabases]) database.close();
+		},
+		async exportSnapshot() {
+			const path = requireSnapshotDirectory(directory);
+			requireClosed(openDatabases);
+			const files = await readdir(path);
+			requireNoRecoverySidecars(files);
+			const names = files.filter((file) => file.endsWith(".sqlite")).map((file) => file.slice(0, -7)).sort();
+			names.forEach(requireSafeDatabaseName);
+			const snapshot = {
+				version: 1,
+				databases: await Promise.all(names.map(async (name) => ({
+					name,
+					image: new Uint8Array(await readFile(join(path, `${name}.sqlite`)))
+				})))
+			};
+			requireValidSqlDatabaseSnapshot(snapshot);
+			return snapshot;
+		},
+		async importSnapshot(snapshot) {
+			const path = requireSnapshotDirectory(directory);
+			requireClosed(openDatabases);
+			requireValidSqlDatabaseSnapshot(snapshot);
+			const databases = snapshot.databases.map(({ name, image }) => ({
+				name,
+				image: new Uint8Array(image)
+			}));
+			const temporary = [];
+			try {
+				for (const { name, image } of databases) {
+					const file = join(path, `.${name}.${randomUUID()}.restore`);
+					await writeFile(file, image);
+					temporary.push({
+						name,
+						file
+					});
+				}
+				const existing = await readdir(path);
+				existing.filter((file) => file.endsWith(".sqlite")).map((file) => file.slice(0, -7)).forEach(requireSafeDatabaseName);
+				for (const file of existing) if (/\.sqlite-(?:journal|wal|shm)$/.test(file)) await rm(join(path, file), { force: true });
+				for (const { name, file } of temporary) await rename(file, join(path, `${name}.sqlite`));
+				const restored = new Set(databases.map(({ name }) => `${name}.sqlite`));
+				for (const file of existing) if (file.endsWith(".sqlite") && !restored.has(file)) await rm(join(path, file), { force: true });
+			} finally {
+				await Promise.all(temporary.map(({ file }) => rm(file, { force: true })));
+			}
+		}
+	};
+}
+var NodeSqlDatabase = class {
+	onClose;
+	#path;
+	#database;
+	#closed = false;
+	constructor(path, onClose = () => {}) {
+		this.onClose = onClose;
+		this.#path = path;
+		this.#database = new DatabaseSync(path);
+	}
+	prepare(sql) {
+		const statement = this.#database.prepare(sql);
+		const source = statement.sourceSQL;
+		return new NodeSqlStatement(statement, source, parameterLayout(source), () => this.#totalChanges());
+	}
+	exec(sql, params) {
+		const statement = this.prepare(sql);
+		try {
+			return statement.execute(params);
+		} finally {
+			statement.close();
+		}
+	}
+	get databaseSize() {
+		return this.#pragma("page_count") * this.#pragma("page_size");
+	}
+	/** `node:sqlite`'s own name for `sqlite3_get_autocommit(db) == 0`. */
+	get inTransaction() {
+		return this.#database.isTransaction;
+	}
+	reset() {
+		this.#database.close();
+		if (this.#path !== ":memory:") for (const suffix of [
+			"",
+			"-journal",
+			"-wal",
+			"-shm"
+		]) rmSync(`${this.#path}${suffix}`, { force: true });
+		this.#database = new DatabaseSync(this.#path);
+	}
+	close() {
+		if (this.#closed) return;
+		this.#database.close();
+		this.#closed = true;
+		this.onClose();
+	}
+	#pragma(name) {
+		const value = this.#database.prepare(`PRAGMA ${name}`).get()?.[name];
+		if (typeof value !== "number") throw new Error(`PRAGMA ${name} did not return a number.`);
+		return value;
+	}
+	#totalChanges() {
+		const value = this.#database.prepare("SELECT total_changes() AS value").get()?.value;
+		if (typeof value !== "number" && typeof value !== "bigint") throw new Error("total_changes() did not return a number.");
+		return Number(value);
+	}
+};
+var NodeSqlStatement = class {
+	sql;
+	totalChanges;
+	#statement;
+	#layout;
+	constructor(statement, sql, layout, totalChanges) {
+		this.sql = sql;
+		this.totalChanges = totalChanges;
+		this.#statement = statement;
+		this.#layout = layout;
+	}
+	get parameterCount() {
+		return this.#layout.count;
+	}
+	execute(params) {
+		if (params.length !== this.parameterCount) throw new Error(SQL_WRONG_BINDINGS_MESSAGE);
+		params.forEach(requireSqliteLength);
+		const { named, anonymous } = bindParameters(params, this.#layout);
+		const statement = this.#statement;
+		const columns = statement.columns();
+		if (columns.length === 0) {
+			const { changes } = named === void 0 ? statement.run(...anonymous) : statement.run(named, ...anonymous);
+			return {
+				columnNames: [],
+				rawRows: [],
+				rowsWritten: Number(changes)
+			};
+		}
+		statement.setReadBigInts(true);
+		statement.setReturnArrays(true);
+		const changesBefore = this.totalChanges();
+		const rows = named === void 0 ? statement.all(...anonymous) : statement.all(named, ...anonymous);
+		return {
+			columnNames: columns.map((column) => column.name),
+			rawRows: rows.map(asRow),
+			rowsWritten: this.totalChanges() - changesBefore
+		};
+	}
+	close() {}
+};
+function bindParameters(params, layout) {
+	let named;
+	const anonymous = [];
+	for (let index = 1; index <= layout.count; index += 1) {
+		const value = params[index - 1];
+		if (value === void 0) throw new Error(SQL_WRONG_BINDINGS_MESSAGE);
+		const name = layout.namesByIndex.get(index);
+		if (name === void 0) anonymous.push(value);
+		else {
+			named ??= {};
+			named[name] = value;
+		}
+	}
+	return {
+		named,
+		anonymous
+	};
+}
+/**
+* `StatementSync` does not expose `sqlite3_bind_parameter_count()`. This is the
+* one lexical adaptation left in the Node backend: it recognizes only SQLite
+* parameter tokens and lets `DatabaseSync.prepare()` validate every other bit
+* of SQL, including statement boundaries.
+*/
+function parameterLayout(sql) {
+	let nextIndex = 1;
+	const indexByName = /* @__PURE__ */ new Map();
+	const namesByIndex = /* @__PURE__ */ new Map();
+	for (let index = 0; index < sql.length;) {
+		const char = sql.charAt(index);
+		if (char === "'" || char === "\"" || char === "`") {
+			index = skipQuoted(sql, index, char, true);
+			continue;
+		}
+		if (char === "[") {
+			index = skipQuoted(sql, index, "]", false);
+			continue;
+		}
+		if (char === "-" && sql[index + 1] === "-") {
+			const newline = sql.indexOf("\n", index + 2);
+			index = newline === -1 ? sql.length : newline + 1;
+			continue;
+		}
+		if (char === "/" && sql[index + 1] === "*") {
+			const close = sql.indexOf("*/", index + 2);
+			index = close === -1 ? sql.length : close + 2;
+			continue;
+		}
+		if (char === "?") {
+			let end = index + 1;
+			while (isAsciiDigit(sql.charAt(end))) end += 1;
+			if (end === index + 1) nextIndex += 1;
+			else {
+				const explicit = Number(sql.slice(index + 1, end));
+				nextIndex = Math.max(nextIndex, explicit + 1);
+			}
+			index = end;
+			continue;
+		}
+		if ((char === ":" || char === "@" || char === "$") && isParameterChar(sql.charAt(index + 1))) {
+			const end = parameterNameEnd(sql, index);
+			const name = sql.slice(index, end);
+			let parameterIndex = indexByName.get(name);
+			if (parameterIndex === void 0) {
+				parameterIndex = nextIndex;
+				nextIndex += 1;
+				indexByName.set(name, parameterIndex);
+				namesByIndex.set(parameterIndex, name);
+			}
+			index = end;
+			continue;
+		}
+		index += 1;
+	}
+	return {
+		count: nextIndex - 1,
+		namesByIndex
+	};
+}
+function parameterNameEnd(sql, start) {
+	let index = start + 1;
+	while (isParameterChar(sql.charAt(index))) index += 1;
+	if (sql[start] === "$") {
+		while (sql.slice(index, index + 2) === "::" && isParameterChar(sql.charAt(index + 2))) {
+			index += 2;
+			while (isParameterChar(sql.charAt(index))) index += 1;
+		}
+		if (sql[index] === "(") {
+			const close = sql.indexOf(")", index + 1);
+			if (close !== -1) index = close + 1;
+		}
+	}
+	return index;
+}
+function isAsciiDigit(char) {
+	return char >= "0" && char <= "9";
+}
+function isParameterChar(char) {
+	return char >= "A" && char <= "Z" || char >= "a" && char <= "z" || isAsciiDigit(char) || char === "_" || char.charCodeAt(0) >= 128;
+}
+function skipQuoted(sql, open, close, doubled) {
+	let index = open + 1;
+	while (index < sql.length) {
+		if (sql[index] === close) {
+			if (doubled && sql[index + 1] === close) {
+				index += 2;
+				continue;
+			}
+			return index + 1;
+		}
+		index += 1;
+	}
+	return sql.length;
+}
+/**
+* `setReturnArrays(true)` is what makes a row a `rawRow`, and the driver's types
+* describe the object shape either way. Checking rather than asserting keeps a
+* future driver that ignores the flag from handing objects to `getText`.
+*/
+function asRow(row) {
+	if (Array.isArray(row)) {
+		row.forEach(requireSqliteLength);
+		return row.map(normalizeInteger);
+	}
+	throw new Error("node:sqlite returned a non-array row despite setReturnArrays(true).");
+}
+/** Preserve ordinary numeric rows while keeping the full int64 range until the public API. */
+function normalizeInteger(value) {
+	if (typeof value !== "bigint") return value;
+	const number = Number(value);
+	return Number.isSafeInteger(number) && BigInt(number) === value ? number : value;
+}
+/**
+* Names come from inside the package (`"root"`, `` `facet-${facetId}` ``), so
+* this is defence in depth rather than input validation — but it is the one
+* place a name becomes a path, and a silent traversal here writes an actor's
+* storage somewhere nobody will look for it.
+*/
+function requireSnapshotDirectory(directory) {
+	if (directory === void 0) throw new Error("SQLite snapshots require a directory-backed Node provider.");
+	return directory;
+}
+function requireClosed(openDatabases) {
+	if (openDatabases.size > 0) throw new Error("Cannot snapshot or restore while database handles are open.");
+}
+function requireNoRecoverySidecars(files) {
+	const sidecar = files.find((file) => /\.sqlite-(?:journal|wal|shm)$/.test(file));
+	if (sidecar !== void 0) throw new Error(`Cannot export a snapshot with a SQLite recovery sidecar: ${sidecar}`);
+}
+//#endregion
+export { NodeSqlDatabase, createNodeSqlProvider };
+
+//# sourceMappingURL=node-sqlite.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"node-sqlite.js","names":["#path","#database","#totalChanges","#pragma","#closed","#statement","#layout"],"sources":["../../backends/node-sqlite.ts"],"sourcesContent":["/**\n * ← workerd `NO upstream correspondence (storage-backend adaptation)`\n *\n * `SqlDatabaseProvider` over `node:sqlite`. Promoted out of\n * `host/fixtures/storage-node.ts`, which is already this adapter.\n *\n * Upstream's equivalent is `SqliteDatabase`'s binding to the SQLite C API plus\n * its kj-filesystem VFS — 3,768 lines this package deliberately does not port,\n * because `node:sqlite` and sqlite-wasm play that role underneath us. What has\n * to match is the layer above: the SQL that `sqlite-kv` and `sqlite-metadata`\n * write, and the four operations they need from a database.\n *\n * This is the substrate the unit lane runs on. It is also decision 11's Node\n * conformance lane, and `fixtures/storage-node.ts` already proves the seam\n * across 20 of the extension's 24 Node-lane test files.\n */\n\nimport { randomUUID } from \"node:crypto\";\nimport { rmSync } from \"node:fs\";\nimport { readFile, readdir, rename, rm, writeFile } from \"node:fs/promises\";\nimport { join } from \"node:path\";\nimport { DatabaseSync } from \"node:sqlite\";\nimport type { SQLInputValue, StatementSync } from \"node:sqlite\";\nimport {\n  requireSqliteLength,\n  requireSafeDatabaseName,\n  requireValidSqlDatabaseSnapshot,\n  SQL_WRONG_BINDINGS_MESSAGE,\n  type SqlDatabase,\n  type SqlDatabaseSnapshot,\n  type SqlDatabaseSnapshotProvider,\n  type SqlDatabaseStatement,\n  type SqlResult,\n  type SqlValue,\n} from \"../src/util/sqlite\";\n\nexport type NodeSqlProviderOptions = {\n  /**\n   * Dedicated directory for one actor's database files. Omit for in-memory\n   * databases, which cannot be snapshotted and are what the unit lane and\n   * upstream's own tests get from `kj::newInMemoryDirectory`.\n   */\n  directory?: string;\n};\n\nexport function createNodeSqlProvider(\n  options: NodeSqlProviderOptions = {},\n): SqlDatabaseSnapshotProvider {\n  const directory = options.directory;\n  const openDatabases = new Set<NodeSqlDatabase>();\n  return {\n    async open(name: string): Promise<SqlDatabase> {\n      requireSafeDatabaseName(name);\n      const path = directory === undefined ? \":memory:\" : join(directory, `${name}.sqlite`);\n      let database: NodeSqlDatabase;\n      database = new NodeSqlDatabase(path, () => openDatabases.delete(database));\n      openDatabases.add(database);\n      return database;\n    },\n    close(): void {\n      for (const database of [...openDatabases]) database.close();\n    },\n    async exportSnapshot(): Promise<SqlDatabaseSnapshot> {\n      const path = requireSnapshotDirectory(directory);\n      requireClosed(openDatabases);\n      const files = await readdir(path);\n      requireNoRecoverySidecars(files);\n      const names = files\n        .filter((file) => file.endsWith(\".sqlite\"))\n        .map((file) => file.slice(0, -\".sqlite\".length))\n        .sort();\n      names.forEach(requireSafeDatabaseName);\n      const snapshot: SqlDatabaseSnapshot = {\n        version: 1,\n        databases: await Promise.all(\n          names.map(async (name) => ({\n            name,\n            image: new Uint8Array(await readFile(join(path, `${name}.sqlite`))),\n          })),\n        ),\n      };\n      requireValidSqlDatabaseSnapshot(snapshot);\n      return snapshot;\n    },\n    async importSnapshot(snapshot: SqlDatabaseSnapshot): Promise<void> {\n      const path = requireSnapshotDirectory(directory);\n      requireClosed(openDatabases);\n      requireValidSqlDatabaseSnapshot(snapshot);\n\n      const databases = snapshot.databases.map(({ name, image }) => ({\n        name,\n        image: new Uint8Array(image),\n      }));\n      const temporary: { name: string; file: string }[] = [];\n      try {\n        for (const { name, image } of databases) {\n          const file = join(path, `.${name}.${randomUUID()}.restore`);\n          await writeFile(file, image);\n          temporary.push({ name, file });\n        }\n        const existing = await readdir(path);\n        existing\n          .filter((file) => file.endsWith(\".sqlite\"))\n          .map((file) => file.slice(0, -\".sqlite\".length))\n          .forEach(requireSafeDatabaseName);\n        for (const file of existing) {\n          if (/\\.sqlite-(?:journal|wal|shm)$/.test(file)) await rm(join(path, file), { force: true });\n        }\n        for (const { name, file } of temporary) {\n          await rename(file, join(path, `${name}.sqlite`));\n        }\n        const restored = new Set(databases.map(({ name }) => `${name}.sqlite`));\n        for (const file of existing) {\n          if (file.endsWith(\".sqlite\") && !restored.has(file)) {\n            await rm(join(path, file), { force: true });\n          }\n        }\n      } finally {\n        await Promise.all(temporary.map(({ file }) => rm(file, { force: true })));\n      }\n    },\n  };\n}\n\nexport class NodeSqlDatabase implements SqlDatabase {\n  readonly #path: string;\n  #database: DatabaseSync;\n\n  #closed = false;\n\n  constructor(path: string, private readonly onClose: () => void = () => {}) {\n    this.#path = path;\n    this.#database = new DatabaseSync(path);\n  }\n\n  prepare(sql: string): SqlDatabaseStatement {\n    const statement = this.#database.prepare(sql);\n    const source = statement.sourceSQL;\n    return new NodeSqlStatement(statement, source, parameterLayout(source), () =>\n      this.#totalChanges(),\n    );\n  }\n\n  exec(sql: string, params: readonly SqlValue[]): SqlResult {\n    const statement = this.prepare(sql);\n    try {\n      return statement.execute(params);\n    } finally {\n      statement.close();\n    }\n  }\n\n  get databaseSize(): number {\n    const pageCount = this.#pragma(\"page_count\");\n    const pageSize = this.#pragma(\"page_size\");\n    return pageCount * pageSize;\n  }\n\n  /** `node:sqlite`'s own name for `sqlite3_get_autocommit(db) == 0`. */\n  get inTransaction(): boolean {\n    return this.#database.isTransaction;\n  }\n\n  reset(): void {\n    this.#database.close();\n    if (this.#path !== \":memory:\") {\n      // The journal and WAL sidecars are part of the database; leaving one\n      // behind would have the reopened file replay a transaction from the\n      // database that was just deleted.\n      for (const suffix of [\"\", \"-journal\", \"-wal\", \"-shm\"]) {\n        rmSync(`${this.#path}${suffix}`, { force: true });\n      }\n    }\n    this.#database = new DatabaseSync(this.#path);\n  }\n\n  close(): void {\n    if (this.#closed) return;\n    this.#database.close();\n    this.#closed = true;\n    this.onClose();\n  }\n\n  #pragma(name: string): number {\n    const row = this.#database.prepare(`PRAGMA ${name}`).get();\n    const value = row?.[name];\n    if (typeof value !== \"number\") {\n      throw new Error(`PRAGMA ${name} did not return a number.`);\n    }\n    return value;\n  }\n\n  #totalChanges(): number {\n    const row = this.#database.prepare(\"SELECT total_changes() AS value\").get();\n    const value = row?.value;\n    if (typeof value !== \"number\" && typeof value !== \"bigint\") {\n      throw new Error(\"total_changes() did not return a number.\");\n    }\n    return Number(value);\n  }\n}\n\ntype ParameterLayout = {\n  readonly count: number;\n  readonly namesByIndex: ReadonlyMap<number, string>;\n};\n\nclass NodeSqlStatement implements SqlDatabaseStatement {\n  readonly #statement: StatementSync;\n  readonly #layout: ParameterLayout;\n\n  constructor(\n    statement: StatementSync,\n    readonly sql: string,\n    layout: ParameterLayout,\n    private readonly totalChanges: () => number,\n  ) {\n    this.#statement = statement;\n    this.#layout = layout;\n  }\n\n  get parameterCount(): number {\n    return this.#layout.count;\n  }\n\n  execute(params: readonly SqlValue[]): SqlResult {\n    if (params.length !== this.parameterCount) throw new Error(SQL_WRONG_BINDINGS_MESSAGE);\n    // ponytail: node:sqlite exposes no sqlite3_limit(); guard JS inputs and outputs here,\n    // and replace this with the native limit if Node exposes it.\n    params.forEach(requireSqliteLength);\n\n    const { named, anonymous } = bindParameters(params, this.#layout);\n    const statement = this.#statement;\n    const columns = statement.columns();\n\n    if (columns.length === 0) {\n      const { changes } =\n        named === undefined ? statement.run(...anonymous) : statement.run(named, ...anonymous);\n      return { columnNames: [], rawRows: [], rowsWritten: Number(changes) };\n    }\n\n    statement.setReadBigInts(true);\n    statement.setReturnArrays(true);\n    const changesBefore = this.totalChanges();\n    const rows: unknown[] =\n      named === undefined ? statement.all(...anonymous) : statement.all(named, ...anonymous);\n    return {\n      columnNames: columns.map((column) => column.name),\n      rawRows: rows.map(asRow),\n      // `node:sqlite` exposes no sqlite3_stmt_readonly() or per-statement write\n      // counter. The total-change delta distinguishes SELECT from DML RETURNING\n      // without parsing SQL or executing the statement twice.\n      rowsWritten: this.totalChanges() - changesBefore,\n    };\n  }\n\n  close(): void {\n    // `StatementSync` exposes no finalize operation. Its native handle follows\n    // the lifetime of this short-lived object instead.\n  }\n}\n\nfunction bindParameters(\n  params: readonly SqlValue[],\n  layout: ParameterLayout,\n): {\n  named: Record<string, SQLInputValue> | undefined;\n  anonymous: SQLInputValue[];\n} {\n  let named: Record<string, SQLInputValue> | undefined;\n  const anonymous: SQLInputValue[] = [];\n  for (let index = 1; index <= layout.count; index += 1) {\n    const value = params[index - 1];\n    if (value === undefined) throw new Error(SQL_WRONG_BINDINGS_MESSAGE);\n    const name = layout.namesByIndex.get(index);\n    if (name === undefined) {\n      anonymous.push(value);\n    } else {\n      named ??= {};\n      named[name] = value;\n    }\n  }\n  return { named, anonymous };\n}\n\n/**\n * `StatementSync` does not expose `sqlite3_bind_parameter_count()`. This is the\n * one lexical adaptation left in the Node backend: it recognizes only SQLite\n * parameter tokens and lets `DatabaseSync.prepare()` validate every other bit\n * of SQL, including statement boundaries.\n */\nfunction parameterLayout(sql: string): ParameterLayout {\n  let nextIndex = 1;\n  const indexByName = new Map<string, number>();\n  const namesByIndex = new Map<number, string>();\n\n  for (let index = 0; index < sql.length; ) {\n    const char = sql.charAt(index);\n    if (char === \"'\" || char === '\"' || char === \"`\") {\n      index = skipQuoted(sql, index, char, true);\n      continue;\n    }\n    if (char === \"[\") {\n      index = skipQuoted(sql, index, \"]\", false);\n      continue;\n    }\n    if (char === \"-\" && sql[index + 1] === \"-\") {\n      const newline = sql.indexOf(\"\\n\", index + 2);\n      index = newline === -1 ? sql.length : newline + 1;\n      continue;\n    }\n    if (char === \"/\" && sql[index + 1] === \"*\") {\n      const close = sql.indexOf(\"*/\", index + 2);\n      index = close === -1 ? sql.length : close + 2;\n      continue;\n    }\n    if (char === \"?\") {\n      let end = index + 1;\n      while (isAsciiDigit(sql.charAt(end))) end += 1;\n      if (end === index + 1) {\n        nextIndex += 1;\n      } else {\n        const explicit = Number(sql.slice(index + 1, end));\n        nextIndex = Math.max(nextIndex, explicit + 1);\n      }\n      index = end;\n      continue;\n    }\n    if ((char === \":\" || char === \"@\" || char === \"$\") && isParameterChar(sql.charAt(index + 1))) {\n      const end = parameterNameEnd(sql, index);\n      const name = sql.slice(index, end);\n      let parameterIndex = indexByName.get(name);\n      if (parameterIndex === undefined) {\n        parameterIndex = nextIndex;\n        nextIndex += 1;\n        indexByName.set(name, parameterIndex);\n        namesByIndex.set(parameterIndex, name);\n      }\n      index = end;\n      continue;\n    }\n    index += 1;\n  }\n\n  return { count: nextIndex - 1, namesByIndex };\n}\n\nfunction parameterNameEnd(sql: string, start: number): number {\n  let index = start + 1;\n  while (isParameterChar(sql.charAt(index))) index += 1;\n\n  // SQLite's `$name` form also accepts Tcl-style `::suffix` and `(suffix)`.\n  if (sql[start] === \"$\") {\n    while (sql.slice(index, index + 2) === \"::\" && isParameterChar(sql.charAt(index + 2))) {\n      index += 2;\n      while (isParameterChar(sql.charAt(index))) index += 1;\n    }\n    if (sql[index] === \"(\") {\n      const close = sql.indexOf(\")\", index + 1);\n      if (close !== -1) index = close + 1;\n    }\n  }\n  return index;\n}\n\nfunction isAsciiDigit(char: string): boolean {\n  return char >= \"0\" && char <= \"9\";\n}\n\nfunction isParameterChar(char: string): boolean {\n  return (\n    (char >= \"A\" && char <= \"Z\") ||\n    (char >= \"a\" && char <= \"z\") ||\n    isAsciiDigit(char) ||\n    char === \"_\" ||\n    char.charCodeAt(0) >= 0x80\n  );\n}\n\nfunction skipQuoted(sql: string, open: number, close: string, doubled: boolean): number {\n  let index = open + 1;\n  while (index < sql.length) {\n    if (sql[index] === close) {\n      if (doubled && sql[index + 1] === close) {\n        index += 2;\n        continue;\n      }\n      return index + 1;\n    }\n    index += 1;\n  }\n  return sql.length;\n}\n\n/**\n * `setReturnArrays(true)` is what makes a row a `rawRow`, and the driver's types\n * describe the object shape either way. Checking rather than asserting keeps a\n * future driver that ignores the flag from handing objects to `getText`.\n */\nfunction asRow(row: unknown): readonly unknown[] {\n  if (Array.isArray(row)) {\n    row.forEach(requireSqliteLength);\n    return row.map(normalizeInteger);\n  }\n  throw new Error(\"node:sqlite returned a non-array row despite setReturnArrays(true).\");\n}\n\n/** Preserve ordinary numeric rows while keeping the full int64 range until the public API. */\nfunction normalizeInteger(value: unknown): unknown {\n  if (typeof value !== \"bigint\") return value;\n  const number = Number(value);\n  return Number.isSafeInteger(number) && BigInt(number) === value ? number : value;\n}\n\n/**\n * Names come from inside the package (`\"root\"`, `` `facet-${facetId}` ``), so\n * this is defence in depth rather than input validation — but it is the one\n * place a name becomes a path, and a silent traversal here writes an actor's\n * storage somewhere nobody will look for it.\n */\nfunction requireSnapshotDirectory(directory: string | undefined): string {\n  if (directory === undefined) {\n    throw new Error(\"SQLite snapshots require a directory-backed Node provider.\");\n  }\n  return directory;\n}\n\nfunction requireClosed(openDatabases: ReadonlySet<NodeSqlDatabase>): void {\n  if (openDatabases.size > 0) {\n    throw new Error(\"Cannot snapshot or restore while database handles are open.\");\n  }\n}\n\nfunction requireNoRecoverySidecars(files: readonly string[]): void {\n  const sidecar = files.find((file) => /\\.sqlite-(?:journal|wal|shm)$/.test(file));\n  if (sidecar !== undefined) {\n    throw new Error(`Cannot export a snapshot with a SQLite recovery sidecar: ${sidecar}`);\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AA6CA,SAAgB,sBACd,UAAkC,CAAC,GACN;CAC7B,MAAM,YAAY,QAAQ;CAC1B,MAAM,gCAAgB,IAAI,IAAqB;CAC/C,OAAO;EACL,MAAM,KAAK,MAAoC;GAC7C,wBAAwB,IAAI;GAC5B,MAAM,OAAO,cAAc,KAAA,IAAY,aAAa,KAAK,WAAW,GAAG,KAAK,QAAQ;GACpF,IAAI;GACJ,WAAW,IAAI,gBAAgB,YAAY,cAAc,OAAO,QAAQ,CAAC;GACzE,cAAc,IAAI,QAAQ;GAC1B,OAAO;EACT;EACA,QAAc;GACZ,KAAK,MAAM,YAAY,CAAC,GAAG,aAAa,GAAG,SAAS,MAAM;EAC5D;EACA,MAAM,iBAA+C;GACnD,MAAM,OAAO,yBAAyB,SAAS;GAC/C,cAAc,aAAa;GAC3B,MAAM,QAAQ,MAAM,QAAQ,IAAI;GAChC,0BAA0B,KAAK;GAC/B,MAAM,QAAQ,MACX,QAAQ,SAAS,KAAK,SAAS,SAAS,CAAC,CAAC,CAC1C,KAAK,SAAS,KAAK,MAAM,GAAG,EAAiB,CAAC,CAAC,CAC/C,KAAK;GACR,MAAM,QAAQ,uBAAuB;GACrC,MAAM,WAAgC;IACpC,SAAS;IACT,WAAW,MAAM,QAAQ,IACvB,MAAM,IAAI,OAAO,UAAU;KACzB;KACA,OAAO,IAAI,WAAW,MAAM,SAAS,KAAK,MAAM,GAAG,KAAK,QAAQ,CAAC,CAAC;IACpE,EAAE,CACJ;GACF;GACA,gCAAgC,QAAQ;GACxC,OAAO;EACT;EACA,MAAM,eAAe,UAA8C;GACjE,MAAM,OAAO,yBAAyB,SAAS;GAC/C,cAAc,aAAa;GAC3B,gCAAgC,QAAQ;GAExC,MAAM,YAAY,SAAS,UAAU,KAAK,EAAE,MAAM,aAAa;IAC7D;IACA,OAAO,IAAI,WAAW,KAAK;GAC7B,EAAE;GACF,MAAM,YAA8C,CAAC;GACrD,IAAI;IACF,KAAK,MAAM,EAAE,MAAM,WAAW,WAAW;KACvC,MAAM,OAAO,KAAK,MAAM,IAAI,KAAK,GAAG,WAAW,EAAE,SAAS;KAC1D,MAAM,UAAU,MAAM,KAAK;KAC3B,UAAU,KAAK;MAAE;MAAM;KAAK,CAAC;IAC/B;IACA,MAAM,WAAW,MAAM,QAAQ,IAAI;IACnC,SACG,QAAQ,SAAS,KAAK,SAAS,SAAS,CAAC,CAAC,CAC1C,KAAK,SAAS,KAAK,MAAM,GAAG,EAAiB,CAAC,CAAC,CAC/C,QAAQ,uBAAuB;IAClC,KAAK,MAAM,QAAQ,UACjB,IAAI,gCAAgC,KAAK,IAAI,GAAG,MAAM,GAAG,KAAK,MAAM,IAAI,GAAG,EAAE,OAAO,KAAK,CAAC;IAE5F,KAAK,MAAM,EAAE,MAAM,UAAU,WAC3B,MAAM,OAAO,MAAM,KAAK,MAAM,GAAG,KAAK,QAAQ,CAAC;IAEjD,MAAM,WAAW,IAAI,IAAI,UAAU,KAAK,EAAE,WAAW,GAAG,KAAK,QAAQ,CAAC;IACtE,KAAK,MAAM,QAAQ,UACjB,IAAI,KAAK,SAAS,SAAS,KAAK,CAAC,SAAS,IAAI,IAAI,GAChD,MAAM,GAAG,KAAK,MAAM,IAAI,GAAG,EAAE,OAAO,KAAK,CAAC;GAGhD,UAAU;IACR,MAAM,QAAQ,IAAI,UAAU,KAAK,EAAE,WAAW,GAAG,MAAM,EAAE,OAAO,KAAK,CAAC,CAAC,CAAC;GAC1E;EACF;CACF;AACF;AAEA,IAAa,kBAAb,MAAoD;CAMP;CAL3C;CACA;CAEA,UAAU;CAEV,YAAY,MAAc,gBAA6C,CAAC,GAAG;EAAhC,KAAA,UAAA;EACzC,KAAKA,QAAQ;EACb,KAAKC,YAAY,IAAI,aAAa,IAAI;CACxC;CAEA,QAAQ,KAAmC;EACzC,MAAM,YAAY,KAAKA,UAAU,QAAQ,GAAG;EAC5C,MAAM,SAAS,UAAU;EACzB,OAAO,IAAI,iBAAiB,WAAW,QAAQ,gBAAgB,MAAM,SACnE,KAAKC,cAAc,CACrB;CACF;CAEA,KAAK,KAAa,QAAwC;EACxD,MAAM,YAAY,KAAK,QAAQ,GAAG;EAClC,IAAI;GACF,OAAO,UAAU,QAAQ,MAAM;EACjC,UAAU;GACR,UAAU,MAAM;EAClB;CACF;CAEA,IAAI,eAAuB;EAGzB,OAFkB,KAAKC,QAAQ,YAExB,IADU,KAAKA,QAAQ,WACX;CACrB;;CAGA,IAAI,gBAAyB;EAC3B,OAAO,KAAKF,UAAU;CACxB;CAEA,QAAc;EACZ,KAAKA,UAAU,MAAM;EACrB,IAAI,KAAKD,UAAU,YAIjB,KAAK,MAAM,UAAU;GAAC;GAAI;GAAY;GAAQ;EAAM,GAClD,OAAO,GAAG,KAAKA,QAAQ,UAAU,EAAE,OAAO,KAAK,CAAC;EAGpD,KAAKC,YAAY,IAAI,aAAa,KAAKD,KAAK;CAC9C;CAEA,QAAc;EACZ,IAAI,KAAKI,SAAS;EAClB,KAAKH,UAAU,MAAM;EACrB,KAAKG,UAAU;EACf,KAAK,QAAQ;CACf;CAEA,QAAQ,MAAsB;EAE5B,MAAM,QADM,KAAKH,UAAU,QAAQ,UAAU,MAAM,CAAC,CAAC,IACvC,CAAA,GAAM;EACpB,IAAI,OAAO,UAAU,UACnB,MAAM,IAAI,MAAM,UAAU,KAAK,0BAA0B;EAE3D,OAAO;CACT;CAEA,gBAAwB;EAEtB,MAAM,QADM,KAAKA,UAAU,QAAQ,iCAAiC,CAAC,CAAC,IACxD,CAAA,EAAK;EACnB,IAAI,OAAO,UAAU,YAAY,OAAO,UAAU,UAChD,MAAM,IAAI,MAAM,0CAA0C;EAE5D,OAAO,OAAO,KAAK;CACrB;AACF;AAOA,IAAM,mBAAN,MAAuD;CAM1C;CAEQ;CAPnB;CACA;CAEA,YACE,WACA,KACA,QACA,cACA;EAHS,KAAA,MAAA;EAEQ,KAAA,eAAA;EAEjB,KAAKI,aAAa;EAClB,KAAKC,UAAU;CACjB;CAEA,IAAI,iBAAyB;EAC3B,OAAO,KAAKA,QAAQ;CACtB;CAEA,QAAQ,QAAwC;EAC9C,IAAI,OAAO,WAAW,KAAK,gBAAgB,MAAM,IAAI,MAAM,0BAA0B;EAGrF,OAAO,QAAQ,mBAAmB;EAElC,MAAM,EAAE,OAAO,cAAc,eAAe,QAAQ,KAAKA,OAAO;EAChE,MAAM,YAAY,KAAKD;EACvB,MAAM,UAAU,UAAU,QAAQ;EAElC,IAAI,QAAQ,WAAW,GAAG;GACxB,MAAM,EAAE,YACN,UAAU,KAAA,IAAY,UAAU,IAAI,GAAG,SAAS,IAAI,UAAU,IAAI,OAAO,GAAG,SAAS;GACvF,OAAO;IAAE,aAAa,CAAC;IAAG,SAAS,CAAC;IAAG,aAAa,OAAO,OAAO;GAAE;EACtE;EAEA,UAAU,eAAe,IAAI;EAC7B,UAAU,gBAAgB,IAAI;EAC9B,MAAM,gBAAgB,KAAK,aAAa;EACxC,MAAM,OACJ,UAAU,KAAA,IAAY,UAAU,IAAI,GAAG,SAAS,IAAI,UAAU,IAAI,OAAO,GAAG,SAAS;EACvF,OAAO;GACL,aAAa,QAAQ,KAAK,WAAW,OAAO,IAAI;GAChD,SAAS,KAAK,IAAI,KAAK;GAIvB,aAAa,KAAK,aAAa,IAAI;EACrC;CACF;CAEA,QAAc,CAGd;AACF;AAEA,SAAS,eACP,QACA,QAIA;CACA,IAAI;CACJ,MAAM,YAA6B,CAAC;CACpC,KAAK,IAAI,QAAQ,GAAG,SAAS,OAAO,OAAO,SAAS,GAAG;EACrD,MAAM,QAAQ,OAAO,QAAQ;EAC7B,IAAI,UAAU,KAAA,GAAW,MAAM,IAAI,MAAM,0BAA0B;EACnE,MAAM,OAAO,OAAO,aAAa,IAAI,KAAK;EAC1C,IAAI,SAAS,KAAA,GACX,UAAU,KAAK,KAAK;OACf;GACL,UAAU,CAAC;GACX,MAAM,QAAQ;EAChB;CACF;CACA,OAAO;EAAE;EAAO;CAAU;AAC5B;;;;;;;AAQA,SAAS,gBAAgB,KAA8B;CACrD,IAAI,YAAY;CAChB,MAAM,8BAAc,IAAI,IAAoB;CAC5C,MAAM,+BAAe,IAAI,IAAoB;CAE7C,KAAK,IAAI,QAAQ,GAAG,QAAQ,IAAI,SAAU;EACxC,MAAM,OAAO,IAAI,OAAO,KAAK;EAC7B,IAAI,SAAS,OAAO,SAAS,QAAO,SAAS,KAAK;GAChD,QAAQ,WAAW,KAAK,OAAO,MAAM,IAAI;GACzC;EACF;EACA,IAAI,SAAS,KAAK;GAChB,QAAQ,WAAW,KAAK,OAAO,KAAK,KAAK;GACzC;EACF;EACA,IAAI,SAAS,OAAO,IAAI,QAAQ,OAAO,KAAK;GAC1C,MAAM,UAAU,IAAI,QAAQ,MAAM,QAAQ,CAAC;GAC3C,QAAQ,YAAY,KAAK,IAAI,SAAS,UAAU;GAChD;EACF;EACA,IAAI,SAAS,OAAO,IAAI,QAAQ,OAAO,KAAK;GAC1C,MAAM,QAAQ,IAAI,QAAQ,MAAM,QAAQ,CAAC;GACzC,QAAQ,UAAU,KAAK,IAAI,SAAS,QAAQ;GAC5C;EACF;EACA,IAAI,SAAS,KAAK;GAChB,IAAI,MAAM,QAAQ;GAClB,OAAO,aAAa,IAAI,OAAO,GAAG,CAAC,GAAG,OAAO;GAC7C,IAAI,QAAQ,QAAQ,GAClB,aAAa;QACR;IACL,MAAM,WAAW,OAAO,IAAI,MAAM,QAAQ,GAAG,GAAG,CAAC;IACjD,YAAY,KAAK,IAAI,WAAW,WAAW,CAAC;GAC9C;GACA,QAAQ;GACR;EACF;EACA,KAAK,SAAS,OAAO,SAAS,OAAO,SAAS,QAAQ,gBAAgB,IAAI,OAAO,QAAQ,CAAC,CAAC,GAAG;GAC5F,MAAM,MAAM,iBAAiB,KAAK,KAAK;GACvC,MAAM,OAAO,IAAI,MAAM,OAAO,GAAG;GACjC,IAAI,iBAAiB,YAAY,IAAI,IAAI;GACzC,IAAI,mBAAmB,KAAA,GAAW;IAChC,iBAAiB;IACjB,aAAa;IACb,YAAY,IAAI,MAAM,cAAc;IACpC,aAAa,IAAI,gBAAgB,IAAI;GACvC;GACA,QAAQ;GACR;EACF;EACA,SAAS;CACX;CAEA,OAAO;EAAE,OAAO,YAAY;EAAG;CAAa;AAC9C;AAEA,SAAS,iBAAiB,KAAa,OAAuB;CAC5D,IAAI,QAAQ,QAAQ;CACpB,OAAO,gBAAgB,IAAI,OAAO,KAAK,CAAC,GAAG,SAAS;CAGpD,IAAI,IAAI,WAAW,KAAK;EACtB,OAAO,IAAI,MAAM,OAAO,QAAQ,CAAC,MAAM,QAAQ,gBAAgB,IAAI,OAAO,QAAQ,CAAC,CAAC,GAAG;GACrF,SAAS;GACT,OAAO,gBAAgB,IAAI,OAAO,KAAK,CAAC,GAAG,SAAS;EACtD;EACA,IAAI,IAAI,WAAW,KAAK;GACtB,MAAM,QAAQ,IAAI,QAAQ,KAAK,QAAQ,CAAC;GACxC,IAAI,UAAU,IAAI,QAAQ,QAAQ;EACpC;CACF;CACA,OAAO;AACT;AAEA,SAAS,aAAa,MAAuB;CAC3C,OAAO,QAAQ,OAAO,QAAQ;AAChC;AAEA,SAAS,gBAAgB,MAAuB;CAC9C,OACG,QAAQ,OAAO,QAAQ,OACvB,QAAQ,OAAO,QAAQ,OACxB,aAAa,IAAI,KACjB,SAAS,OACT,KAAK,WAAW,CAAC,KAAK;AAE1B;AAEA,SAAS,WAAW,KAAa,MAAc,OAAe,SAA0B;CACtF,IAAI,QAAQ,OAAO;CACnB,OAAO,QAAQ,IAAI,QAAQ;EACzB,IAAI,IAAI,WAAW,OAAO;GACxB,IAAI,WAAW,IAAI,QAAQ,OAAO,OAAO;IACvC,SAAS;IACT;GACF;GACA,OAAO,QAAQ;EACjB;EACA,SAAS;CACX;CACA,OAAO,IAAI;AACb;;;;;;AAOA,SAAS,MAAM,KAAkC;CAC/C,IAAI,MAAM,QAAQ,GAAG,GAAG;EACtB,IAAI,QAAQ,mBAAmB;EAC/B,OAAO,IAAI,IAAI,gBAAgB;CACjC;CACA,MAAM,IAAI,MAAM,qEAAqE;AACvF;;AAGA,SAAS,iBAAiB,OAAyB;CACjD,IAAI,OAAO,UAAU,UAAU,OAAO;CACtC,MAAM,SAAS,OAAO,KAAK;CAC3B,OAAO,OAAO,cAAc,MAAM,KAAK,OAAO,MAAM,MAAM,QAAQ,SAAS;AAC7E;;;;;;;AAQA,SAAS,yBAAyB,WAAuC;CACvE,IAAI,cAAc,KAAA,GAChB,MAAM,IAAI,MAAM,4DAA4D;CAE9E,OAAO;AACT;AAEA,SAAS,cAAc,eAAmD;CACxE,IAAI,cAAc,OAAO,GACvB,MAAM,IAAI,MAAM,6DAA6D;AAEjF;AAEA,SAAS,0BAA0B,OAAgC;CACjE,MAAM,UAAU,MAAM,MAAM,SAAS,gCAAgC,KAAK,IAAI,CAAC;CAC/E,IAAI,YAAY,KAAA,GACd,MAAM,IAAI,MAAM,4DAA4D,SAAS;AAEzF"}

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

@@ -0,0 +1,130 @@
+/**
+ * ← workerd `NO upstream correspondence (storage-backend adaptation)`
+ *
+ * `SqlDatabaseProvider` over the browser's OPFS SAH pool.
+ *
+ * The pool is a parameter, not something this module goes and gets. Installing
+ * the VFS is the host's job — `installOpfsSAHPoolVfs` decides the OPFS
+ * directory, the pool capacity and whether to clear on init, all of which are
+ * layout questions this package deliberately knows nothing about. What arrives
+ * here is the already-installed pool, and with it the two things a backend
+ * needs that a bare `sqlite3` module cannot give: a database constructor bound
+ * to that VFS, plus the pool's file export/import/unlink operations used by
+ * snapshots and `reset()`.
+ *
+ * The pool is structurally typed rather than imported from
+ * `@sqlite.org/sqlite-wasm`, so this package takes no dependency on the driver
+ * and the caller is free to pass a pool from any build of it. The shape below
+ * is the subset of `SAHPoolUtil` and `oo1.DB` that is used, copied from the
+ * driver's own `.d.mts`.
+ *
+ * NOT exercised by the unit lane: it needs OPFS, which means a browser. It is
+ * exercised twice in the browser lane — by `sqlite-wasm.smoke.spec.ts`, which
+ * drives this file directly, and by the conformance suite, which runs the whole
+ * package over it.
+ */
+import { type SqlDatabase, type SqlDatabaseProvider, type SqlDatabaseSnapshotProvider, type SqlDatabaseStatement, type SqlResult, type SqlValue } from "../src/util/sqlite.js";
+/** ← `PreparedStatement`, the members used here. */
+export interface SqliteWasmStatement {
+    readonly columnCount: number;
+    readonly parameterCount: number;
+    bind(bindings: readonly (string | number | bigint | null | Uint8Array)[]): unknown;
+    step(): boolean;
+    get(index: number): unknown;
+    getColumnNames(target?: string[]): string[];
+    finalize(): number | undefined;
+}
+/** ← `oo1.DB` / `OpfsSAHPoolDatabase`, the members used here. */
+export interface SqliteWasmDatabaseHandle {
+    /** ← `oo1.DB.pointer`, which is absent once the handle is closed. */
+    readonly pointer?: number | undefined;
+    prepare(sql: string): SqliteWasmStatement;
+    changes(total?: boolean, sixtyFour?: false): number;
+    close(): void;
+}
+/** ← `SAHPoolUtil`, the members used here. */
+export interface OpfsSahPool {
+    /** Constructs a database inside this pool's VFS. Names are absolute, so they start with "/". */
+    readonly OpfsSAHPoolDb: new (filename: string) => SqliteWasmDatabaseHandle;
+    exportFile(filename: string): Uint8Array | Promise<Uint8Array>;
+    importDb(filename: string, image: Uint8Array): number | Promise<number>;
+    getFileNames(): string[];
+    /** Disassociates a virtual file from the pool. Results are undefined if it is in active use. */
+    unlink(filename: string): boolean;
+}
+/**
+ * ← `Sqlite3Static["capi"]`, restricted to the one C function `oo1.DB` does not
+ * wrap.
+ *
+ * Takes the pointer rather than the handle, even though upstream's `DbPtr`
+ * accepts either: a structural subset of `oo1.DB` is not assignable to the
+ * `Database` class, so asking for the handle would make the real `capi` fail to
+ * satisfy this interface.
+ */
+export interface SqliteWasmCapi {
+    readonly SQLITE_LIMIT_LENGTH: number;
+    sqlite3_complete(sql: string): 0 | 1;
+    sqlite3_get_autocommit(db: number): number;
+    sqlite3_limit(db: number, id: number, newValue: number): number;
+}
+/**
+ * What the host hands over: the pool it installed, and the C-API namespace it
+ * already holds. Both come off the same `sqlite3` object the caller used to
+ * call `installOpfsSAHPoolVfs`, so this asks for nothing it does not have.
+ */
+export interface SqliteWasmHost {
+    readonly pool: OpfsSahPool;
+    readonly capi: SqliteWasmCapi;
+}
+export type SqliteWasmProviderOptions = {
+    /** Absolute path prefix inside the pool, e.g. `/actor-<id>`. Must start with "/". */
+    prefix: string;
+};
+/**
+ * One actor's named databases and their file lifecycle inside an OPFS SAH pool.
+ *
+ * A root or facet container only needs the `SqlDatabaseProvider` surface. Its
+ * host also has to close every connection when that placement dies, remove the
+ * prefix on delete, and copy every database on clone. Those file operations
+ * belong here because SAH-pool files are virtual and can only be reached through
+ * the pool that owns them.
+ */
+export declare class SqliteWasmActorStorage implements SqlDatabaseProvider {
+    #private;
+    constructor(host: SqliteWasmHost, prefix: string);
+    open(name: string): Promise<SqlDatabase>;
+    /**
+     * Drop every handle. Leaving one behind per respawn or facet abort would
+     * accumulate concurrent writers inside a VFS that expects to own its files.
+     */
+    close(): void;
+    /** Close every handle, then physically remove every database under this prefix. */
+    deleteAll(): void;
+    /**
+     * Replace this prefix with every database under `source`, including files
+     * from an earlier placement that this session never opened.
+     *
+     * The source may still be running, so this uses the pool's file operations
+     * rather than the snapshot API, which correctly refuses open handles. A
+     * recovery sidecar means the bytes are not a stable database image and is
+     * refused before the destination is touched. Every source image is also
+     * exported before replacement starts, so a failed read preserves the target.
+     */
+    copyFrom(source: SqliteWasmActorStorage): Promise<void>;
+}
+export declare function createSqliteWasmProvider(host: SqliteWasmHost, options: SqliteWasmProviderOptions): SqlDatabaseSnapshotProvider;
+export declare class SqliteWasmDatabase implements SqlDatabase {
+    #private;
+    private readonly onClose;
+    constructor(host: SqliteWasmHost, filename: string, onClose?: () => void);
+    prepare(sql: string): SqlDatabaseStatement;
+    exec(sql: string, params: readonly SqlValue[]): SqlResult;
+    get databaseSize(): number;
+    /**
+     * `oo1.DB` wraps no equivalent, so this is the one place the backend reaches
+     * past it into the C API. `DbPtr` accepts the database object itself.
+     */
+    get inTransaction(): boolean;
+    reset(): void;
+    close(): void;
+}