@statewalker/webrun-files-sqlite 0.10.3 → 0.11.0

package/dist/esm/index.js

@@ -1,3 +1,18 @@
+//#region ../../node_modules/.pnpm/@statewalker+db-sqlite@0.1.0/node_modules/@statewalker/db-sqlite/dist/index.mjs
+/** Key under which a SQLite Db carries its transaction hook. Shared across bundles via Symbol.for. */
+const SQLITE_TRANSACTION = Symbol.for("@statewalker/db-sqlite:transaction");
+const NO_HOOK = "inTransaction: this Db has no SQLite transaction hook. It is not a @statewalker/db-sqlite* Db, or it wraps one (a wrapper object loses the hook - pass the driver's Db itself), or it is the handle of a running transaction (nesting is not supported).";
+/**
+* Run `cb` in one SQLite transaction: every statement issued through `tx` commits together, or
+* none does if `cb` throws. Other calls on `db` wait until the transaction ends. `cb` must not do
+* external I/O and must be idempotent: a Durable Object may run it more than once.
+*/
+function inTransaction(db, cb) {
+	const hook = db[SQLITE_TRANSACTION];
+	if (typeof hook !== "function") return Promise.reject(/* @__PURE__ */ new Error(NO_HOOK));
+	return hook(cb);
+}
+//#endregion
 //#region ../webrun-files/dist/esm/index.js
 /**
 * The order every `FilesApi.list()` yields: paths compared by Unicode code
@@ -37,15 +52,31 @@ function normalizePath(filePath) {
 }
 //#endregion
 //#region src/bytes.ts
-/** Blobs arrive as Uint8Array (node:sqlite), ArrayBuffer (Durable Objects) or number[] (D1). */
+/** BLOBs arrive as Uint8Array from every @statewalker/db-sqlite driver; SQLAR may hold TEXT. */
 function toBytes(value) {
 	if (value instanceof Uint8Array) return value;
-	if (value instanceof ArrayBuffer) return new Uint8Array(value);
-	if (Array.isArray(value)) return Uint8Array.from(value);
 	if (typeof value === "string") return new TextEncoder().encode(value);
 	return /* @__PURE__ */ new Uint8Array(0);
 }
 //#endregion
+//#region src/run-statements.ts
+/**
+* Runs the statements in order on a transaction's Db and returns, per
+* statement, the rows it changed — zero exactly when it changed nothing. The
+* count is SQLite's `changes()` on the same connection, so index writes are
+* not counted. Call it only inside `inTransaction`; it does nothing but SQL,
+* so a retried transaction callback is safe.
+*/
+async function runStatements(tx, statements) {
+	const counts = [];
+	for (const { sql, params = [] } of statements) {
+		await tx.query(sql, params);
+		const [row] = await tx.query("SELECT changes() AS n");
+		counts.push(Number(row.n));
+	}
+	return counts;
+}
+//#endregion
 //#region src/blocks/byte-reader.ts
 /**
 * Pull bytes from a chunk source in bounded pieces.
@@ -352,33 +383,33 @@ async function* iterate(stream) {
 //#endregion
 //#region src/blocks/sqlite-files-api.ts
 const MiB = 1048576;
-/** Rows on Durable Objects and D1 are capped at 2 MB; leave room for deflate's worst case. */
+/** Rows on Durable Objects are capped at 2 MB; leave room for deflate's worst case. */
 const MAX_BLOCK_SIZE_LIMIT = 1.5 * MiB;
 const LIST_PAGE = 256;
 /**
 * A FilesApi over three SQLite tables: paths point at immutable contents, and
 * a content is a sequence of bounded, optionally compressed blocks. Reads and
 * writes stream one block at a time, so no file is ever held whole and no row
-* outgrows the 2 MB limit of Durable Objects and D1.
+* outgrows the 2 MB row limit of Durable Objects.
 *
 * Streaming happens outside transactions; every step that changes what a path
 * shows is one transaction, so an interruption leaves at most an unreferenced
 * content, which {@link sweep} removes.
 */
 var SqliteFilesApi = class {
-	#sql;
+	#db;
 	#codec;
 	#blockSize;
 	#paths;
 	#files;
 	#blocks;
 	#prefix;
-	constructor(sql, opts = {}) {
+	constructor(db, opts = {}) {
 		const prefix = opts.tablePrefix ?? "fs_";
 		if (!/^[A-Za-z_][A-Za-z0-9_]*$/.test(prefix)) throw new Error(`SqliteFilesApi: tablePrefix must be a plain SQL identifier, got ${prefix}`);
 		this.#blockSize = opts.blockSize ?? MiB;
 		if (!Number.isInteger(this.#blockSize) || this.#blockSize < 1 || this.#blockSize > MAX_BLOCK_SIZE_LIMIT) throw new Error(`SqliteFilesApi: blockSize must be an integer from 1 to ${MAX_BLOCK_SIZE_LIMIT}, got ${this.#blockSize}`);
-		this.#sql = sql;
+		this.#db = db;
 		this.#codec = opts.compression === void 0 ? availableWebCodec() : opts.compression;
 		this.#prefix = prefix;
 		this.#paths = `${prefix}paths`;
@@ -411,7 +442,7 @@ var SqliteFilesApi = class {
 			`CREATE INDEX IF NOT EXISTS ${this.#prefix}paths_fid ON ${this.#paths}(fid)`,
 			`CREATE INDEX IF NOT EXISTS ${this.#prefix}files_hash ON ${this.#files}(hash, size)`
 		];
-		for (const statement of statements) await this.#sql.run(statement);
+		for (const statement of statements) await this.#db.query(statement);
 	}
 	async *read(path, options = {}) {
 		options.signal?.throwIfAborted();
@@ -455,8 +486,12 @@ var SqliteFilesApi = class {
 	async write(path, content) {
 		const name = normalizePath(path);
 		const compression = this.#codec?.name ?? "none";
-		const fid = (await this.#sql.all(`INSERT INTO ${this.#files}(size, compression, block_size, hash, updated)
-       VALUES (NULL, ?, ?, NULL, ?) RETURNING fid`, compression, this.#blockSize, Date.now()))[0].fid;
+		const fid = await inTransaction(this.#db, async (tx) => (await tx.query(`INSERT INTO ${this.#files}(size, compression, block_size, hash, updated)
+             VALUES (NULL, ?, ?, NULL, ?) RETURNING fid`, [
+			compression,
+			this.#blockSize,
+			Date.now()
+		]))[0].fid);
 		const limit = this.#blockSize;
 		const reader = new ByteReader(content);
 		const hash = new Sha256();
@@ -477,7 +512,7 @@ var SqliteFilesApi = class {
 					}
 				};
 				const block = await collectBlock(this.#codec ? this.#codec.compress(pieces()) : pieces());
-				const [alive] = await this.#sql.transaction([{
+				const [alive] = await this.#transaction([{
 					sql: `UPDATE ${this.#files} SET updated = ? WHERE fid = ? AND size IS NULL`,
 					params: [Date.now(), fid]
 				}, {
@@ -494,14 +529,14 @@ var SqliteFilesApi = class {
 				size += raw;
 			}
 			const previous = await this.#entry(name);
-			const [finished] = await this.#sql.transaction(this.#finishWrite(name, fid, size, hash.digestHex(), compression, previous?.fid ?? null));
+			const [finished] = await this.#transaction(this.#finishWrite(name, fid, size, hash.digestHex(), compression, previous?.fid ?? null));
 			if (finished === 0) throw sweptDuringWrite(name);
 		} catch (error) {
 			try {
 				await reader.close();
 			} catch {}
 			try {
-				await this.#sql.transaction([{
+				await this.#transaction([{
 					sql: `DELETE FROM ${this.#files} WHERE fid = ? AND size IS NULL`,
 					params: [fid]
 				}, ...this.#deleteBlocksOfMissing(fid)]);
@@ -566,7 +601,7 @@ var SqliteFilesApi = class {
 	}
 	async mkdir(path) {
 		const now = Date.now();
-		for (const dir of ancestorsAndSelf$1(normalizePath(path))) await this.#sql.run(`INSERT INTO ${this.#paths}(path, fid, mtime) VALUES (?, NULL, ?) ON CONFLICT(path) DO NOTHING`, dir, now);
+		for (const dir of ancestorsAndSelf$1(normalizePath(path))) await this.#db.query(`INSERT INTO ${this.#paths}(path, fid, mtime) VALUES (?, NULL, ?) ON CONFLICT(path) DO NOTHING`, [dir, now]);
 	}
 	async stats(path) {
 		const name = normalizePath(path);
@@ -587,10 +622,10 @@ var SqliteFilesApi = class {
 		for (;;) {
 			const params = [...range.params, cursor];
 			if (!options.recursive) params.push(prefixLength + 1);
-			const rows = await this.#sql.all(`SELECT p.path, p.fid, p.mtime, f.size, f.compression, f.block_size
+			const rows = await this.#db.query(`SELECT p.path, p.fid, p.mtime, f.size, f.compression, f.block_size
          FROM ${this.#paths} p LEFT JOIN ${this.#files} f ON f.fid = p.fid
          WHERE ${range.where} AND p.path > ? ${directOnly}
-         ORDER BY p.path LIMIT ${LIST_PAGE}`, ...params);
+         ORDER BY p.path LIMIT ${LIST_PAGE}`, params);
 			for (const row of rows) {
 				const stats = toStats$1(row);
 				if (stats) yield {
@@ -604,7 +639,7 @@ var SqliteFilesApi = class {
 		}
 	}
 	async remove(path) {
-		const counts = await this.#sql.transaction(this.#removeTree(normalizePath(path)));
+		const counts = await this.#transaction(this.#removeTree(normalizePath(path)));
 		return counts[counts.length - 1] > 0;
 	}
 	/**
@@ -694,7 +729,7 @@ var SqliteFilesApi = class {
 				]
 			}
 		];
-		const counts = await this.#sql.transaction(statements);
+		const counts = await this.#transaction(statements);
 		return counts[counts.length - 1] > 0;
 	}
 	/**
@@ -713,7 +748,7 @@ var SqliteFilesApi = class {
 		const eligible = `f.updated < ? AND NOT EXISTS (
       SELECT 1 FROM ${this.#paths} p WHERE p.fid = f.fid
     )`;
-		const [, contents] = await this.#sql.transaction([{
+		const [, contents] = await this.#transaction([{
 			sql: `DELETE FROM ${this.#blocks} WHERE fid IN (SELECT f.fid FROM ${this.#files} f WHERE ${eligible})`,
 			params: [cutoff]
 		}, {
@@ -722,10 +757,14 @@ var SqliteFilesApi = class {
 		}]);
 		return contents;
 	}
+	/** The statements as one transaction; per statement, the rows it changed. */
+	#transaction(statements) {
+		return inTransaction(this.#db, (tx) => runStatements(tx, statements));
+	}
 	async #entry(name) {
-		return (await this.#sql.all(`SELECT p.fid, p.mtime, f.size, f.compression, f.block_size
+		return (await this.#db.query(`SELECT p.fid, p.mtime, f.size, f.compression, f.block_size
        FROM ${this.#paths} p LEFT JOIN ${this.#files} f ON f.fid = p.fid
-       WHERE p.path = ?`, name))[0];
+       WHERE p.path = ?`, [name]))[0];
 	}
 	#decoder(name, compression) {
 		if (compression === "none") return null;
@@ -737,7 +776,7 @@ var SqliteFilesApi = class {
 		throw new Error(`sqlite-files: ${name} is compressed with ${compression}, and no codec reads it`);
 	}
 	async #block(fid, shift) {
-		return (await this.#sql.all(`SELECT shift, block FROM ${this.#blocks} WHERE fid = ? AND shift = ?`, fid, shift))[0];
+		return (await this.#db.query(`SELECT shift, block FROM ${this.#blocks} WHERE fid = ? AND shift = ?`, [fid, shift]))[0];
 	}
 	/** A subquery selecting the content `fid` while it is still pending. */
 	#pending(fid) {
@@ -871,79 +910,6 @@ async function pipe(bytes, transform) {
 	return new Uint8Array(await new Response(stream).arrayBuffer());
 }
 //#endregion
-//#region src/drivers.ts
-/** node:sqlite — local development, tests and any Node deployment. */
-var NodeSqlDriver = class {
-	#db;
-	constructor(db) {
-		this.#db = db;
-	}
-	all(sql, ...params) {
-		return this.#db.prepare(sql).all(...params);
-	}
-	run(sql, ...params) {
-		this.#db.prepare(sql).run(...params);
-	}
-	/** Synchronous from BEGIN to COMMIT, so no other call can interleave on the connection. */
-	transaction(statements) {
-		this.#db.exec("BEGIN IMMEDIATE");
-		try {
-			const counts = statements.map(({ sql, params = [] }) => Number(this.#db.prepare(sql).run(...params).changes));
-			this.#db.exec("COMMIT");
-			return counts;
-		} catch (error) {
-			this.#db.exec("ROLLBACK");
-			throw error;
-		}
-	}
-};
-/**
-* Durable Object SQLite storage: pass `ctx.storage`. Synchronous; BLOBs come
-* back as ArrayBuffer. Transactions use `transactionSync`, since `sql.exec`
-* rejects `BEGIN`.
-*/
-var DoSqlDriver = class {
-	#storage;
-	constructor(storage) {
-		this.#storage = storage;
-	}
-	all(sql, ...params) {
-		return this.#storage.sql.exec(sql, ...params).toArray();
-	}
-	run(sql, ...params) {
-		this.#storage.sql.exec(sql, ...params).toArray();
-	}
-	/**
-	* Counts come from SQLite's `changes()` on the same connection, not from the
-	* cursor's `rowsWritten`, which also counts every index row a write touches.
-	*/
-	transaction(statements) {
-		return this.#storage.transactionSync(() => statements.map(({ sql, params = [] }) => {
-			this.#storage.sql.exec(sql, ...params).toArray();
-			const [row] = this.#storage.sql.exec("SELECT changes() AS n").toArray();
-			return row.n;
-		}));
-	}
-};
-/** Cloudflare D1. Asynchronous; BLOBs come back as number[]; transactions are `batch()`. */
-var D1SqlDriver = class {
-	#db;
-	constructor(db) {
-		this.#db = db;
-	}
-	async all(sql, ...params) {
-		const { results } = await this.#db.prepare(sql).bind(...params).all();
-		return results;
-	}
-	async run(sql, ...params) {
-		await this.#db.prepare(sql).bind(...params).run();
-	}
-	async transaction(statements) {
-		if (statements.length === 0) return [];
-		return (await this.#db.batch(statements.map(({ sql, params = [] }) => this.#db.prepare(sql).bind(...params)))).map((result) => result.meta.changes);
-	}
-};
-//#endregion
 //#region src/sqlar-files-api.ts
 /**
 * The table, verbatim from the SQLite Archive specification. Five columns,
@@ -970,22 +936,22 @@ const MAX_SYMLINK_HOPS = 8;
 * missing path — and {@link symlink} / {@link readlink} expose the link itself.
 */
 var SqlarFilesApi = class {
-	#sql;
+	#db;
 	#codec;
-	constructor(sql, opts = {}) {
-		this.#sql = sql;
+	constructor(db, opts = {}) {
+		this.#db = db;
 		this.#codec = opts.codec ?? defaultCodec();
 	}
 	/** Creates the table if it is missing. Await it before any other call. */
 	async init() {
-		await this.#sql.run(SCHEMA);
+		await this.#db.query(SCHEMA);
 	}
 	/** A missing path or a directory yields nothing; a file yields one chunk. */
 	async *read(path, options = {}) {
 		options.signal?.throwIfAborted();
 		const resolved = await this.#resolve(toName(path));
 		if (resolved?.stats.kind !== "file") return;
-		const rows = await this.#sql.all("SELECT data FROM sqlar WHERE name = ?", resolved.name);
+		const rows = await this.#db.query("SELECT data FROM sqlar WHERE name = ?", [resolved.name]);
 		const content = await this.#content(resolved.name, resolved.stats.size, toBytes(rows[0]?.data));
 		options.signal?.throwIfAborted();
 		const start = options.start ?? 0;
@@ -1050,7 +1016,7 @@ var SqlarFilesApi = class {
 		if (resolved?.stats.kind !== "directory") return;
 		const base = resolved.name;
 		const range = descendants(base);
-		const rows = await this.#sql.all(`SELECT ${ROW_COLUMNS} FROM sqlar WHERE ${range.where} ORDER BY name`, ...range.params);
+		const rows = await this.#db.query(`SELECT ${ROW_COLUMNS} FROM sqlar WHERE ${range.where} ORDER BY name`, range.params);
 		const prefixLength = base === "" ? 0 : base.length + 1;
 		const seen = /* @__PURE__ */ new Set();
 		for (const row of rows) {
@@ -1080,8 +1046,8 @@ var SqlarFilesApi = class {
 	}
 	async remove(path) {
 		const range = selfAndDescendants(toName(path));
-		if ((await this.#sql.all(`SELECT 1 FROM sqlar WHERE ${range.where} LIMIT 1`, ...range.params)).length === 0) return false;
-		await this.#sql.run(`DELETE FROM sqlar WHERE ${range.where}`, ...range.params);
+		if ((await this.#db.query(`SELECT 1 FROM sqlar WHERE ${range.where} LIMIT 1`, range.params)).length === 0) return false;
+		await this.#db.query(`DELETE FROM sqlar WHERE ${range.where}`, range.params);
 		return true;
 	}
 	/**
@@ -1092,7 +1058,7 @@ var SqlarFilesApi = class {
 		const from = toName(source);
 		const to = toName(target);
 		const range = selfAndDescendants(from);
-		const rows = await this.#sql.all(`SELECT name, mode, sz, typeof(data) AS dtype, data FROM sqlar WHERE ${range.where}`, ...range.params);
+		const rows = await this.#db.query(`SELECT name, mode, sz, typeof(data) AS dtype, data FROM sqlar WHERE ${range.where}`, range.params);
 		if (rows.length === 0) return false;
 		await this.mkdir(parentName(to));
 		for (const row of rows) {
@@ -1146,16 +1112,22 @@ var SqlarFilesApi = class {
 		}
 	}
 	async #row(name) {
-		return (await this.#sql.all(`SELECT ${ROW_COLUMNS} FROM sqlar WHERE name = ?`, name))[0];
+		return (await this.#db.query(`SELECT ${ROW_COLUMNS} FROM sqlar WHERE name = ?`, [name]))[0];
 	}
 	async #hasDescendants(name) {
 		const range = descendants(name);
-		return (await this.#sql.all(`SELECT 1 FROM sqlar WHERE ${range.where} LIMIT 1`, ...range.params)).length > 0;
+		return (await this.#db.query(`SELECT 1 FROM sqlar WHERE ${range.where} LIMIT 1`, range.params)).length > 0;
 	}
 	async #put(name, mode, sz, data) {
-		await this.#sql.run(`INSERT INTO sqlar (name, mode, mtime, sz, data) VALUES (?, ?, ?, ?, ?)
+		await this.#db.query(`INSERT INTO sqlar (name, mode, mtime, sz, data) VALUES (?, ?, ?, ?, ?)
        ON CONFLICT(name) DO UPDATE SET
-         mode = excluded.mode, mtime = excluded.mtime, sz = excluded.sz, data = excluded.data`, name, mode, Math.floor(Date.now() / 1e3), sz, data);
+         mode = excluded.mode, mtime = excluded.mtime, sz = excluded.sz, data = excluded.data`, [
+			name,
+			mode,
+			Math.floor(Date.now() / 1e3),
+			sz,
+			data
+		]);
 	}
 };
 const ROW_COLUMNS = "name, mode, mtime, sz, typeof(data) AS dtype, CASE WHEN sz = -1 THEN data END AS target";
@@ -1250,4 +1222,4 @@ async function concat(content) {
 	return out;
 }
 //#endregion
-export { D1SqlDriver, DoSqlDriver, NodeSqlDriver, SqlarFilesApi, SqliteFilesApi, defaultCodec, pakoCodec, pakoDeflateCodec, rawCodec, webCodec, webDeflateCodec };
+export { SqlarFilesApi, SqliteFilesApi, defaultCodec, pakoCodec, pakoDeflateCodec, rawCodec, webCodec, webDeflateCodec };

package/dist/index.d.ts

@@ -1,7 +1,5 @@
 export { SqliteFilesApi, type SqliteFilesApiOptions } from "./blocks/sqlite-files-api.js";
 export { type PakoStreamModule, pakoDeflateCodec, type StreamCodec, webDeflateCodec, } from "./blocks/stream-codec.js";
 export { type Codec, defaultCodec, type PakoModule, pakoCodec, rawCodec, webCodec, } from "./codec.js";
-export { type D1Database, D1SqlDriver, DoSqlDriver, type DoStorage, NodeSqlDriver, type NodeSqliteDatabase, } from "./drivers.js";
-export type { SqlDriver, SqlStatement } from "./sql.types.js";
 export { SqlarFilesApi, type SqlarFilesApiOptions } from "./sqlar-files-api.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,KAAK,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAC1F,OAAO,EACL,KAAK,gBAAgB,EACrB,gBAAgB,EAChB,KAAK,WAAW,EAChB,eAAe,GAChB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,KAAK,KAAK,EACV,YAAY,EACZ,KAAK,UAAU,EACf,SAAS,EACT,QAAQ,EACR,QAAQ,GACT,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,KAAK,UAAU,EACf,WAAW,EACX,WAAW,EACX,KAAK,SAAS,EACd,aAAa,EACb,KAAK,kBAAkB,GACxB,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,KAAK,oBAAoB,EAAE,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,KAAK,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAC1F,OAAO,EACL,KAAK,gBAAgB,EACrB,gBAAgB,EAChB,KAAK,WAAW,EAChB,eAAe,GAChB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,KAAK,KAAK,EACV,YAAY,EACZ,KAAK,UAAU,EACf,SAAS,EACT,QAAQ,EACR,QAAQ,GACT,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,aAAa,EAAE,KAAK,oBAAoB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/run-statements.d.ts

@@ -0,0 +1,15 @@
+import type { Db } from "@statewalker/db-api";
+/** One statement of a transaction. */
+export interface SqlStatement {
+    sql: string;
+    params?: unknown[];
+}
+/**
+ * Runs the statements in order on a transaction's Db and returns, per
+ * statement, the rows it changed — zero exactly when it changed nothing. The
+ * count is SQLite's `changes()` on the same connection, so index writes are
+ * not counted. Call it only inside `inTransaction`; it does nothing but SQL,
+ * so a retried transaction callback is safe.
+ */
+export declare function runStatements(tx: Db, statements: SqlStatement[]): Promise<number[]>;
+//# sourceMappingURL=run-statements.d.ts.map

package/dist/run-statements.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-statements.d.ts","sourceRoot":"","sources":["../src/run-statements.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,qBAAqB,CAAC;AAE9C,sCAAsC;AACtC,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC;CACpB;AAED;;;;;;GAMG;AACH,wBAAsB,aAAa,CAAC,EAAE,EAAE,EAAE,EAAE,UAAU,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAQzF"}

package/dist/sqlar-files-api.d.ts

@@ -1,6 +1,6 @@
+import type { Db } from "@statewalker/db-api";
 import type { FileInfo, FileStats, FilesApi, ListOptions, ReadOptions } from "@statewalker/webrun-files";
 import { type Codec } from "./codec.js";
-import type { SqlDriver } from "./sql.types.js";
 export interface SqlarFilesApiOptions {
     /** Defaults to {@link defaultCodec}. */
     codec?: Codec;
@@ -14,7 +14,7 @@ export interface SqlarFilesApiOptions {
  */
 export declare class SqlarFilesApi implements FilesApi {
     #private;
-    constructor(sql: SqlDriver, opts?: SqlarFilesApiOptions);
+    constructor(db: Db, opts?: SqlarFilesApiOptions);
     /** Creates the table if it is missing. Await it before any other call. */
     init(): Promise<void>;
     /** A missing path or a directory yields nothing; a file yields one chunk. */

package/dist/sqlar-files-api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sqlar-files-api.d.ts","sourceRoot":"","sources":["../src/sqlar-files-api.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,QAAQ,EACR,SAAS,EACT,QAAQ,EACR,WAAW,EACX,WAAW,EACZ,MAAM,2BAA2B,CAAC;AAGnC,OAAO,EAAE,KAAK,KAAK,EAAgB,MAAM,YAAY,CAAC;AACtD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAuBhD,MAAM,WAAW,oBAAoB;IACnC,wCAAwC;IACxC,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAED;;;;;;GAMG;AACH,qBAAa,aAAc,YAAW,QAAQ;;IAI5C,YAAY,GAAG,EAAE,SAAS,EAAE,IAAI,GAAE,oBAAyB,EAG1D;IAED,0EAA0E;IACpE,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAE1B;IAED,6EAA6E;IACtE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,aAAa,CAAC,UAAU,CAAC,CAe9E;IAEK,KAAK,CACT,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,QAAQ,CAAC,UAAU,CAAC,GAAG,aAAa,CAAC,UAAU,CAAC,GACxD,OAAO,CAAC,IAAI,CAAC,CAYf;IAED,gFAAgF;IAC1E,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAKvC;IAED,oEAAoE;IAC9D,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAIzD;IAED,wEAAwE;IAClE,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAGxD;IAEK,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC,CAExD;IAEK,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAE3C;IAED;;;;;OAKG;IACH;;;;;OAKG;IACI,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,aAAa,CAAC,QAAQ,CAAC,CAO5E;IAwCK,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAU3C;IAED;;;OAGG;IACG,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAsB3D;IAEK,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAI3D;CAwEF"}
+{"version":3,"file":"sqlar-files-api.d.ts","sourceRoot":"","sources":["../src/sqlar-files-api.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,qBAAqB,CAAC;AAC9C,OAAO,KAAK,EACV,QAAQ,EACR,SAAS,EACT,QAAQ,EACR,WAAW,EACX,WAAW,EACZ,MAAM,2BAA2B,CAAC;AAGnC,OAAO,EAAE,KAAK,KAAK,EAAgB,MAAM,YAAY,CAAC;AAuBtD,MAAM,WAAW,oBAAoB;IACnC,wCAAwC;IACxC,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAED;;;;;;GAMG;AACH,qBAAa,aAAc,YAAW,QAAQ;;IAI5C,YAAY,EAAE,EAAE,EAAE,EAAE,IAAI,GAAE,oBAAyB,EAGlD;IAED,0EAA0E;IACpE,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAE1B;IAED,6EAA6E;IACtE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,aAAa,CAAC,UAAU,CAAC,CAc9E;IAEK,KAAK,CACT,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,QAAQ,CAAC,UAAU,CAAC,GAAG,aAAa,CAAC,UAAU,CAAC,GACxD,OAAO,CAAC,IAAI,CAAC,CAYf;IAED,gFAAgF;IAC1E,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAKvC;IAED,oEAAoE;IAC9D,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAIzD;IAED,wEAAwE;IAClE,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAGxD;IAEK,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC,CAExD;IAEK,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAE3C;IAED;;;;;OAKG;IACH;;;;;OAKG;IACI,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,aAAa,CAAC,QAAQ,CAAC,CAO5E;IAwCK,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAU3C;IAED;;;OAGG;IACG,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAsB3D;IAEK,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAI3D;CAoEF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@statewalker/webrun-files-sqlite",
-  "version": "0.10.3",
+  "version": "0.11.0",
   "private": false,
   "type": "module",
   "description": "SQLite-backed FilesApi implementations",
@@ -34,9 +34,13 @@
     "src"
   ],
   "dependencies": {
-    "@statewalker/webrun-files": "^0.10.2"
+    "@statewalker/db-api": "^0.1.3",
+    "@statewalker/db-sqlite": "^0.1.0",
+    "@statewalker/webrun-files": "^0.10.3"
   },
   "devDependencies": {
+    "@statewalker/db-sqlite-do": "^0.1.0",
+    "@statewalker/db-sqlite-node": "^0.3.0",
     "@types/node": "^26.6.4",
     "pako": "^3.0.2",
     "rimraf": "^6.1.3",