@mcp-b/do-runtime 0.1.0

package/dist/backends/sqlite-wasm.js

@@ -0,0 +1,259 @@
+import { d as requireValidSqlDatabaseSnapshot, l as requireSafeDatabaseName, n as SQL_WRONG_BINDINGS_MESSAGE, t as SQLITE_LENGTH_LIMIT, u as requireSqliteLength } from "../chunks/sqlite-DFg92Tgt.js";
+//#region backends/sqlite-wasm.ts
+/**
+* ← 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.
+*/
+/**
+* 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.
+*/
+var SqliteWasmActorStorage = class {
+	#host;
+	#prefix;
+	#provider;
+	constructor(host, prefix) {
+		this.#host = host;
+		this.#prefix = prefix;
+		this.#provider = createSqliteWasmProvider(host, { prefix });
+	}
+	open(name) {
+		return this.#provider.open(name);
+	}
+	/**
+	* 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() {
+		this.#provider.close();
+	}
+	/** Close every handle, then physically remove every database under this prefix. */
+	deleteAll() {
+		this.close();
+		for (const file of this.#ownedFiles()) if (!this.#host.pool.unlink(file)) throw new Error(`SAH pool did not unlink ${file}`);
+	}
+	/**
+	* 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.
+	*/
+	async copyFrom(source) {
+		const files = source.#ownedFiles();
+		const sidecar = files.find((file) => !file.endsWith(".sqlite"));
+		if (sidecar !== void 0) throw new Error(`Cannot clone actor storage with a SQLite recovery sidecar: ${sidecar}`);
+		const images = [];
+		for (const file of files) {
+			const name = file.slice(source.#prefix.length + 1, -7);
+			requireSafeDatabaseName(name);
+			images.push({
+				name,
+				bytes: new Uint8Array(await source.#host.pool.exportFile(file))
+			});
+		}
+		this.deleteAll();
+		for (const { name, bytes } of images) await this.#host.pool.importDb(`${this.#prefix}.${name}.sqlite`, bytes);
+	}
+	#ownedFiles() {
+		return this.#host.pool.getFileNames().filter((name) => name.startsWith(`${this.#prefix}.`));
+	}
+};
+function createSqliteWasmProvider(host, options) {
+	const { prefix } = options;
+	if (!prefix.startsWith("/")) throw new Error(`SAH pool names are absolute; prefix must start with "/": ${prefix}`);
+	const openDatabases = /* @__PURE__ */ new Set();
+	const ownedFiles = () => host.pool.getFileNames().filter((name) => name.startsWith(`${prefix}.`));
+	return {
+		async open(name) {
+			requireSafeDatabaseName(name);
+			let database;
+			database = new SqliteWasmDatabase(host, `${prefix}.${name}.sqlite`, () => openDatabases.delete(database));
+			openDatabases.add(database);
+			return database;
+		},
+		close() {
+			for (const database of [...openDatabases]) database.close();
+		},
+		async exportSnapshot() {
+			requireClosed(openDatabases);
+			const files = ownedFiles();
+			requireNoRecoverySidecars(files);
+			const snapshot = {
+				version: 1,
+				databases: await Promise.all(files.filter((file) => file.endsWith(".sqlite")).sort().map(async (file) => {
+					const name = file.slice(prefix.length + 1, -7);
+					requireSafeDatabaseName(name);
+					return {
+						name,
+						image: new Uint8Array(await host.pool.exportFile(file))
+					};
+				}))
+			};
+			requireValidSqlDatabaseSnapshot(snapshot);
+			return snapshot;
+		},
+		async importSnapshot(snapshot) {
+			requireClosed(openDatabases);
+			requireValidSqlDatabaseSnapshot(snapshot);
+			for (const file of ownedFiles()) host.pool.unlink(file);
+			for (const { name, image } of snapshot.databases) await host.pool.importDb(`${prefix}.${name}.sqlite`, new Uint8Array(image));
+		}
+	};
+}
+var SqliteWasmDatabase = class {
+	onClose;
+	#host;
+	#filename;
+	#database;
+	#closed = false;
+	constructor(host, filename, onClose = () => {}) {
+		this.onClose = onClose;
+		this.#host = host;
+		this.#filename = filename;
+		this.#database = new host.pool.OpfsSAHPoolDb(filename);
+		this.#setLengthLimit();
+	}
+	prepare(sql) {
+		const source = firstCompleteStatement(this.#host.capi, sql);
+		return new WasmSqlStatement(this.#database, this.#database.prepare(source), source);
+	}
+	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");
+	}
+	/**
+	* `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() {
+		const pointer = this.#database.pointer;
+		if (pointer === void 0) throw new Error("The database handle is closed.");
+		return this.#host.capi.sqlite3_get_autocommit(pointer) === 0;
+	}
+	reset() {
+		this.#database.close();
+		if (!this.#host.pool.unlink(this.#filename)) throw new Error(`SAH pool did not unlink ${this.#filename}`);
+		this.#database = new this.#host.pool.OpfsSAHPoolDb(this.#filename);
+		this.#setLengthLimit();
+	}
+	close() {
+		if (this.#closed) return;
+		this.#database.close();
+		this.#closed = true;
+		this.onClose();
+	}
+	#setLengthLimit() {
+		const pointer = this.#database.pointer;
+		if (pointer === void 0) throw new Error("The database handle is closed.");
+		this.#host.capi.sqlite3_limit(pointer, this.#host.capi.SQLITE_LIMIT_LENGTH, SQLITE_LENGTH_LIMIT);
+	}
+	#pragma(name) {
+		const value = this.exec(`PRAGMA ${name}`, []).rawRows[0]?.[0];
+		if (typeof value !== "number") throw new Error(`PRAGMA ${name} did not return a number.`);
+		return value;
+	}
+};
+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) => !file.endsWith(".sqlite"));
+	if (sidecar !== void 0) throw new Error(`Cannot export a snapshot with a SQLite recovery sidecar: ${sidecar}`);
+}
+var WasmSqlStatement = class {
+	sql;
+	#database;
+	#statement;
+	#closed = false;
+	constructor(database, statement, sql) {
+		this.sql = sql;
+		this.#database = database;
+		this.#statement = statement;
+	}
+	get parameterCount() {
+		return this.#statement.parameterCount;
+	}
+	execute(params) {
+		if (params.length !== this.parameterCount) throw new Error(SQL_WRONG_BINDINGS_MESSAGE);
+		params.forEach(requireSqliteLength);
+		if (params.length > 0) this.#statement.bind(params);
+		const columnCount = this.#statement.columnCount;
+		if (columnCount === 0) {
+			this.#statement.step();
+			return {
+				columnNames: [],
+				rawRows: [],
+				rowsWritten: this.#database.changes(false)
+			};
+		}
+		const changesBefore = this.#database.changes(true);
+		const columnNames = this.#statement.getColumnNames();
+		const rawRows = [];
+		while (this.#statement.step()) {
+			const row = [];
+			for (let column = 0; column < columnCount; column += 1) row.push(this.#statement.get(column));
+			rawRows.push(row);
+		}
+		return {
+			columnNames,
+			rawRows,
+			rowsWritten: this.#database.changes(true) - changesBefore
+		};
+	}
+	close() {
+		if (this.#closed) return;
+		this.#closed = true;
+		this.#statement.finalize();
+	}
+};
+/** Finds the first complete statement without reimplementing SQLite's trigger grammar. */
+function firstCompleteStatement(capi, sql) {
+	let semicolon = sql.indexOf(";");
+	while (semicolon !== -1) {
+		const candidate = sql.slice(0, semicolon + 1);
+		if (capi.sqlite3_complete(candidate) === 1) return candidate;
+		semicolon = sql.indexOf(";", semicolon + 1);
+	}
+	return sql;
+}
+//#endregion
+export { SqliteWasmActorStorage, SqliteWasmDatabase, createSqliteWasmProvider };
+
+//# sourceMappingURL=sqlite-wasm.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-wasm.js","names":["#host","#prefix","#provider","#ownedFiles","#filename","#database","#setLengthLimit","#pragma","#closed","#statement"],"sources":["../../backends/sqlite-wasm.ts"],"sourcesContent":["/**\n * ← workerd `NO upstream correspondence (storage-backend adaptation)`\n *\n * `SqlDatabaseProvider` over the browser's OPFS SAH pool.\n *\n * The pool is a parameter, not something this module goes and gets. Installing\n * the VFS is the host's job — `installOpfsSAHPoolVfs` decides the OPFS\n * directory, the pool capacity and whether to clear on init, all of which are\n * layout questions this package deliberately knows nothing about. What arrives\n * here is the already-installed pool, and with it the two things a backend\n * needs that a bare `sqlite3` module cannot give: a database constructor bound\n * to that VFS, plus the pool's file export/import/unlink operations used by\n * snapshots and `reset()`.\n *\n * The pool is structurally typed rather than imported from\n * `@sqlite.org/sqlite-wasm`, so this package takes no dependency on the driver\n * and the caller is free to pass a pool from any build of it. The shape below\n * is the subset of `SAHPoolUtil` and `oo1.DB` that is used, copied from the\n * driver's own `.d.mts`.\n *\n * NOT exercised by the unit lane: it needs OPFS, which means a browser. It is\n * exercised twice in the browser lane — by `sqlite-wasm.smoke.spec.ts`, which\n * drives this file directly, and by the conformance suite, which runs the whole\n * package over it.\n */\n\nimport {\n  requireSqliteLength,\n  requireSafeDatabaseName,\n  requireValidSqlDatabaseSnapshot,\n  SQLITE_LENGTH_LIMIT,\n  SQL_WRONG_BINDINGS_MESSAGE,\n  type SqlDatabase,\n  type SqlDatabaseProvider,\n  type SqlDatabaseSnapshot,\n  type SqlDatabaseSnapshotProvider,\n  type SqlDatabaseStatement,\n  type SqlResult,\n  type SqlValue,\n} from \"../src/util/sqlite\";\n\n/** ← `PreparedStatement`, the members used here. */\nexport interface SqliteWasmStatement {\n  readonly columnCount: number;\n  readonly parameterCount: number;\n  bind(bindings: readonly (string | number | bigint | null | Uint8Array)[]): unknown;\n  step(): boolean;\n  get(index: number): unknown;\n  getColumnNames(target?: string[]): string[];\n  finalize(): number | undefined;\n}\n\n/** ← `oo1.DB` / `OpfsSAHPoolDatabase`, the members used here. */\nexport interface SqliteWasmDatabaseHandle {\n  /** ← `oo1.DB.pointer`, which is absent once the handle is closed. */\n  readonly pointer?: number | undefined;\n  prepare(sql: string): SqliteWasmStatement;\n  changes(total?: boolean, sixtyFour?: false): number;\n  close(): void;\n}\n\n/** ← `SAHPoolUtil`, the members used here. */\nexport interface OpfsSahPool {\n  /** Constructs a database inside this pool's VFS. Names are absolute, so they start with \"/\". */\n  readonly OpfsSAHPoolDb: new (filename: string) => SqliteWasmDatabaseHandle;\n  exportFile(filename: string): Uint8Array | Promise<Uint8Array>;\n  importDb(filename: string, image: Uint8Array): number | Promise<number>;\n  getFileNames(): string[];\n  /** Disassociates a virtual file from the pool. Results are undefined if it is in active use. */\n  unlink(filename: string): boolean;\n}\n\n/**\n * ← `Sqlite3Static[\"capi\"]`, restricted to the one C function `oo1.DB` does not\n * wrap.\n *\n * Takes the pointer rather than the handle, even though upstream's `DbPtr`\n * accepts either: a structural subset of `oo1.DB` is not assignable to the\n * `Database` class, so asking for the handle would make the real `capi` fail to\n * satisfy this interface.\n */\nexport interface SqliteWasmCapi {\n  readonly SQLITE_LIMIT_LENGTH: number;\n  sqlite3_complete(sql: string): 0 | 1;\n  sqlite3_get_autocommit(db: number): number;\n  sqlite3_limit(db: number, id: number, newValue: number): number;\n}\n\n/**\n * What the host hands over: the pool it installed, and the C-API namespace it\n * already holds. Both come off the same `sqlite3` object the caller used to\n * call `installOpfsSAHPoolVfs`, so this asks for nothing it does not have.\n */\nexport interface SqliteWasmHost {\n  readonly pool: OpfsSahPool;\n  readonly capi: SqliteWasmCapi;\n}\n\nexport type SqliteWasmProviderOptions = {\n  /** Absolute path prefix inside the pool, e.g. `/actor-<id>`. Must start with \"/\". */\n  prefix: string;\n};\n\n/**\n * One actor's named databases and their file lifecycle inside an OPFS SAH pool.\n *\n * A root or facet container only needs the `SqlDatabaseProvider` surface. Its\n * host also has to close every connection when that placement dies, remove the\n * prefix on delete, and copy every database on clone. Those file operations\n * belong here because SAH-pool files are virtual and can only be reached through\n * the pool that owns them.\n */\nexport class SqliteWasmActorStorage implements SqlDatabaseProvider {\n  readonly #host: SqliteWasmHost;\n  readonly #prefix: string;\n  readonly #provider: SqlDatabaseSnapshotProvider;\n\n  constructor(host: SqliteWasmHost, prefix: string) {\n    this.#host = host;\n    this.#prefix = prefix;\n    this.#provider = createSqliteWasmProvider(host, { prefix });\n  }\n\n  open(name: string): Promise<SqlDatabase> {\n    return this.#provider.open(name);\n  }\n\n  /**\n   * Drop every handle. Leaving one behind per respawn or facet abort would\n   * accumulate concurrent writers inside a VFS that expects to own its files.\n   */\n  close(): void {\n    this.#provider.close();\n  }\n\n  /** Close every handle, then physically remove every database under this prefix. */\n  deleteAll(): void {\n    this.close();\n    for (const file of this.#ownedFiles()) {\n      if (!this.#host.pool.unlink(file)) throw new Error(`SAH pool did not unlink ${file}`);\n    }\n  }\n\n  /**\n   * Replace this prefix with every database under `source`, including files\n   * from an earlier placement that this session never opened.\n   *\n   * The source may still be running, so this uses the pool's file operations\n   * rather than the snapshot API, which correctly refuses open handles. A\n   * recovery sidecar means the bytes are not a stable database image and is\n   * refused before the destination is touched. Every source image is also\n   * exported before replacement starts, so a failed read preserves the target.\n   */\n  async copyFrom(source: SqliteWasmActorStorage): Promise<void> {\n    const files = source.#ownedFiles();\n    const sidecar = files.find((file) => !file.endsWith(\".sqlite\"));\n    if (sidecar !== undefined) {\n      throw new Error(`Cannot clone actor storage with a SQLite recovery sidecar: ${sidecar}`);\n    }\n    const images: Array<{ name: string; bytes: Uint8Array }> = [];\n    for (const file of files) {\n      const name = file.slice(source.#prefix.length + 1, -\".sqlite\".length);\n      requireSafeDatabaseName(name);\n      images.push({\n        name,\n        bytes: new Uint8Array(await source.#host.pool.exportFile(file)),\n      });\n    }\n    this.deleteAll();\n    for (const { name, bytes } of images) {\n      await this.#host.pool.importDb(\n        `${this.#prefix}.${name}.sqlite`,\n        bytes,\n      );\n    }\n  }\n\n  #ownedFiles(): string[] {\n    return this.#host.pool\n      .getFileNames()\n      .filter((name) => name.startsWith(`${this.#prefix}.`));\n  }\n}\n\nexport function createSqliteWasmProvider(\n  host: SqliteWasmHost,\n  options: SqliteWasmProviderOptions,\n): SqlDatabaseSnapshotProvider {\n  const { prefix } = options;\n  if (!prefix.startsWith(\"/\")) {\n    throw new Error(`SAH pool names are absolute; prefix must start with \"/\": ${prefix}`);\n  }\n  const openDatabases = new Set<SqliteWasmDatabase>();\n  const ownedFiles = (): string[] =>\n    host.pool.getFileNames().filter((name) => name.startsWith(`${prefix}.`));\n  return {\n    async open(name: string): Promise<SqlDatabase> {\n      // Names come from inside the package, so this is defence in depth — but\n      // it is the one place a name becomes a pool file name.\n      requireSafeDatabaseName(name);\n      let database: SqliteWasmDatabase;\n      database = new SqliteWasmDatabase(host, `${prefix}.${name}.sqlite`, () =>\n        openDatabases.delete(database),\n      );\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      requireClosed(openDatabases);\n      const files = ownedFiles();\n      requireNoRecoverySidecars(files);\n      const databases = await Promise.all(\n        files\n          .filter((file) => file.endsWith(\".sqlite\"))\n          .sort()\n          .map(async (file) => {\n            const name = file.slice(prefix.length + 1, -\".sqlite\".length);\n            requireSafeDatabaseName(name);\n            return { name, image: new Uint8Array(await host.pool.exportFile(file)) };\n          }),\n      );\n      const snapshot: SqlDatabaseSnapshot = { version: 1, databases };\n      requireValidSqlDatabaseSnapshot(snapshot);\n      return snapshot;\n    },\n    async importSnapshot(snapshot: SqlDatabaseSnapshot): Promise<void> {\n      requireClosed(openDatabases);\n      requireValidSqlDatabaseSnapshot(snapshot);\n      for (const file of ownedFiles()) host.pool.unlink(file);\n      for (const { name, image } of snapshot.databases) {\n        await host.pool.importDb(`${prefix}.${name}.sqlite`, new Uint8Array(image));\n      }\n    },\n  };\n}\n\nexport class SqliteWasmDatabase implements SqlDatabase {\n  readonly #host: SqliteWasmHost;\n  readonly #filename: string;\n  #database: SqliteWasmDatabaseHandle;\n  #closed = false;\n\n  constructor(\n    host: SqliteWasmHost,\n    filename: string,\n    private readonly onClose: () => void = () => {},\n  ) {\n    this.#host = host;\n    this.#filename = filename;\n    this.#database = new host.pool.OpfsSAHPoolDb(filename);\n    this.#setLengthLimit();\n  }\n\n  prepare(sql: string): SqlDatabaseStatement {\n    const source = firstCompleteStatement(this.#host.capi, sql);\n    return new WasmSqlStatement(this.#database, this.#database.prepare(source), source);\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  /**\n   * `oo1.DB` wraps no equivalent, so this is the one place the backend reaches\n   * past it into the C API. `DbPtr` accepts the database object itself.\n   */\n  get inTransaction(): boolean {\n    const pointer = this.#database.pointer;\n    if (pointer === undefined) throw new Error(\"The database handle is closed.\");\n    return this.#host.capi.sqlite3_get_autocommit(pointer) === 0;\n  }\n\n  reset(): void {\n    // The pool's files are not visible in OPFS under these names, so deleting\n    // one goes through the pool rather than through the filesystem. The handle\n    // has to be closed first: `unlink`'s results are undefined for a file in\n    // active use.\n    this.#database.close();\n    if (!this.#host.pool.unlink(this.#filename)) {\n      throw new Error(`SAH pool did not unlink ${this.#filename}`);\n    }\n    this.#database = new this.#host.pool.OpfsSAHPoolDb(this.#filename);\n    this.#setLengthLimit();\n  }\n\n  close(): void {\n    if (this.#closed) return;\n    this.#database.close();\n    this.#closed = true;\n    this.onClose();\n  }\n\n  #setLengthLimit(): void {\n    const pointer = this.#database.pointer;\n    if (pointer === undefined) throw new Error(\"The database handle is closed.\");\n    this.#host.capi.sqlite3_limit(\n      pointer,\n      this.#host.capi.SQLITE_LIMIT_LENGTH,\n      SQLITE_LENGTH_LIMIT,\n    );\n  }\n\n  #pragma(name: string): number {\n    const row = this.exec(`PRAGMA ${name}`, []).rawRows[0];\n    const value = row?.[0];\n    if (typeof value !== \"number\") {\n      throw new Error(`PRAGMA ${name} did not return a number.`);\n    }\n    return value;\n  }\n}\n\nfunction requireClosed(openDatabases: ReadonlySet<SqliteWasmDatabase>): 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) => !file.endsWith(\".sqlite\"));\n  if (sidecar !== undefined) {\n    throw new Error(`Cannot export a snapshot with a SQLite recovery sidecar: ${sidecar}`);\n  }\n}\n\nclass WasmSqlStatement implements SqlDatabaseStatement {\n  readonly #database: SqliteWasmDatabaseHandle;\n  readonly #statement: SqliteWasmStatement;\n  #closed = false;\n\n  constructor(\n    database: SqliteWasmDatabaseHandle,\n    statement: SqliteWasmStatement,\n    readonly sql: string,\n  ) {\n    this.#database = database;\n    this.#statement = statement;\n  }\n\n  get parameterCount(): number {\n    return this.#statement.parameterCount;\n  }\n\n  execute(params: readonly SqlValue[]): SqlResult {\n    if (params.length !== this.parameterCount) throw new Error(SQL_WRONG_BINDINGS_MESSAGE);\n    params.forEach(requireSqliteLength);\n    if (params.length > 0) this.#statement.bind(params);\n\n    const columnCount = this.#statement.columnCount;\n    if (columnCount === 0) {\n      this.#statement.step();\n      return { columnNames: [], rawRows: [], rowsWritten: this.#database.changes(false) };\n    }\n\n    const changesBefore = this.#database.changes(true);\n    const columnNames = this.#statement.getColumnNames();\n    const rawRows: unknown[][] = [];\n    while (this.#statement.step()) {\n      const row: unknown[] = [];\n      for (let column = 0; column < columnCount; column += 1) {\n        row.push(this.#statement.get(column));\n      }\n      rawRows.push(row);\n    }\n    // A SELECT leaves total_changes() untouched; DML RETURNING advances it.\n    // The delta avoids a SQL classifier and matches the public cursor contract.\n    return {\n      columnNames,\n      rawRows,\n      rowsWritten: this.#database.changes(true) - changesBefore,\n    };\n  }\n\n  close(): void {\n    if (this.#closed) return;\n    this.#closed = true;\n    this.#statement.finalize();\n  }\n}\n\n/** Finds the first complete statement without reimplementing SQLite's trigger grammar. */\nfunction firstCompleteStatement(capi: SqliteWasmCapi, sql: string): string {\n  let semicolon = sql.indexOf(\";\");\n  while (semicolon !== -1) {\n    const candidate = sql.slice(0, semicolon + 1);\n    if (capi.sqlite3_complete(candidate) === 1) return candidate;\n    semicolon = sql.indexOf(\";\", semicolon + 1);\n  }\n  return sql;\n}\n"],"mappings":"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"}