@procedures/sqlite 0.4.0 → 0.5.0

package/dist/engines.d.ts

@@ -0,0 +1,68 @@
+/**
+ * The two SQLite engines of `SqliteStorage`: `node:sqlite` and sql.js.
+ *
+ * - The engine `node` is the module `node:sqlite` of Node.js. It writes only the changed pages of
+ *   the file, and SQLite locks the file for each write.
+ * - The engine `sqljs` is sql.js (SQLite in WebAssembly), through `@mark1russell7/docker-sqlite`.
+ *   It keeps the database in memory and writes the whole file after a write.
+ * - The two engines read and write the same file format.
+ *
+ * This module imports `node:sqlite` only when a storage opens: an import of the package does not
+ * load it.
+ */
+/** The path of a database that is only in memory. */
+export declare const MEMORY_PATH = ":memory:";
+/** The engine of a database: `node:sqlite` (`node`) or sql.js (`sqljs`). */
+export type SqliteEngineName = "node" | "sqljs";
+/**
+ * The engine choice of a `SqliteStorage`. With `auto`, the storage uses `node` when Node.js has
+ * `node:sqlite`, and `sqljs` when it does not.
+ */
+export type SqliteEngine = "auto" | SqliteEngineName;
+/** This function gives the engine choice when it is known. Else it throws a `TypeError`. */
+export declare function checkEngine(engine: unknown): SqliteEngine;
+/** A value that a statement takes or gives. */
+export type SqlValue = string | number | null;
+/** The calls of an open database that a storage uses. Each call is synchronous. */
+export interface EngineDatabase {
+    /** The rows of a query, as objects. */
+    all<R>(sql: string, params?: SqlValue[]): R[];
+    /** The first row of a statement for each list of parameters, or undefined for no row. */
+    firstOfEach<R>(sql: string, params: SqlValue[][]): Array<R | undefined>;
+    /** This method runs one statement, and gives the number of rows that it changed. */
+    run(sql: string, params?: SqlValue[]): number;
+    /** This method runs SQL text that can have several statements. */
+    exec(sql: string): void;
+    close(): void;
+}
+/**
+ * This function gives true when this Node.js has `node:sqlite` without a flag (Node.js 22.13 or
+ * later). Then the engine `auto` uses it.
+ */
+export declare function isNodeSqliteAvailable(): Promise<boolean>;
+/**
+ * This function copies the schema of the storages from one database to another. The node engine
+ * calls it when it makes the file at the first write.
+ */
+export type CopySchema = (from: EngineDatabase, to: EngineDatabase) => void;
+/** An open database of a path, with the file work of its engine. */
+export interface OpenDatabase {
+    readonly engine: SqliteEngineName;
+    /** The current database. The node engine changes it when it opens the file. */
+    readonly db: EngineDatabase;
+    /**
+     * True when the node engine waits for the first write to make the file. Until then, the
+     * database is in memory, and it has the tables and no item.
+     */
+    readonly waiting: boolean;
+    /** This method opens the file and copies the schema to it. The node engine uses it before the first write. */
+    makeFile(copy: CopySchema): void;
+    /** This method opens a file that another process made after the open, before a read. */
+    refresh(copy: CopySchema): void;
+    /** This method writes the database to the file. Only sql.js has a write to do. */
+    saveFile(): Promise<void>;
+    close(): void;
+}
+/** This function opens the database of a path with an engine. `auto` uses `node` when it can. */
+export declare function openEngine(path: string, engine: SqliteEngine, busyTimeoutMs: number): Promise<OpenDatabase>;
+//# sourceMappingURL=engines.d.ts.map

package/dist/engines.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engines.d.ts","sourceRoot":"","sources":["../src/engines.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH,qDAAqD;AACrD,eAAO,MAAM,WAAW,aAAa,CAAC;AAEtC,4EAA4E;AAC5E,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,OAAO,CAAC;AAEhD;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,gBAAgB,CAAC;AAIrD,4FAA4F;AAC5F,wBAAgB,WAAW,CAAC,MAAM,EAAE,OAAO,GAAG,YAAY,CAKzD;AAED,+CAA+C;AAC/C,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;AAE9C,mFAAmF;AACnF,MAAM,WAAW,cAAc;IAC7B,uCAAuC;IACvC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,QAAQ,EAAE,GAAG,CAAC,EAAE,CAAC;IAC9C,yFAAyF;IACzF,WAAW,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,GAAG,KAAK,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC;IACxE,oFAAoF;IACpF,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAC;IAC9C,kEAAkE;IAClE,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,KAAK,IAAI,IAAI,CAAC;CACf;AAyCD;;;GAGG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,OAAO,CAAC,CAE9D;AAyHD;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,IAAI,EAAE,cAAc,EAAE,EAAE,EAAE,cAAc,KAAK,IAAI,CAAC;AAE5E,oEAAoE;AACpE,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC,+EAA+E;IAC/E,QAAQ,CAAC,EAAE,EAAE,cAAc,CAAC;IAC5B;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,8GAA8G;IAC9G,QAAQ,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,CAAC;IACjC,wFAAwF;IACxF,OAAO,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,CAAC;IAChC,kFAAkF;IAClF,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,KAAK,IAAI,IAAI,CAAC;CACf;AAyGD,iGAAiG;AACjG,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CASjH"}

package/dist/engines.js

@@ -0,0 +1,268 @@
+/**
+ * The two SQLite engines of `SqliteStorage`: `node:sqlite` and sql.js.
+ *
+ * - The engine `node` is the module `node:sqlite` of Node.js. It writes only the changed pages of
+ *   the file, and SQLite locks the file for each write.
+ * - The engine `sqljs` is sql.js (SQLite in WebAssembly), through `@mark1russell7/docker-sqlite`.
+ *   It keeps the database in memory and writes the whole file after a write.
+ * - The two engines read and write the same file format.
+ *
+ * This module imports `node:sqlite` only when a storage opens: an import of the package does not
+ * load it.
+ */
+import { existsSync, mkdirSync, statSync } from "node:fs";
+import { dirname } from "node:path";
+import { createConnection } from "@mark1russell7/docker-sqlite";
+/** The path of a database that is only in memory. */
+export const MEMORY_PATH = ":memory:";
+const ENGINES = new Set(["auto", "node", "sqljs"]);
+/** This function gives the engine choice when it is known. Else it throws a `TypeError`. */
+export function checkEngine(engine) {
+    if (typeof engine !== "string" || !ENGINES.has(engine)) {
+        throw new TypeError(`Unknown SQLite engine ${JSON.stringify(engine)}: use auto, node or sqljs`);
+    }
+    return engine;
+}
+let nodeModule;
+/**
+ * This function loads `node:sqlite` one time. The promise gives undefined when the import fails,
+ * or when the module has no database class. Node.js before 22.13 has the module only with the
+ * flag `--experimental-sqlite`.
+ */
+function loadNodeSqlite() {
+    nodeModule ??= import("node:sqlite")
+        .then((module) => {
+        const exports = module;
+        const found = "Database" in exports ? exports.Database : exports.DatabaseSync;
+        return typeof found === "function" ? found : undefined;
+    })
+        .catch(() => undefined);
+    return nodeModule;
+}
+/**
+ * This function gives true when this Node.js has `node:sqlite` without a flag (Node.js 22.13 or
+ * later). Then the engine `auto` uses it.
+ */
+export async function isNodeSqliteAvailable() {
+    return (await loadNodeSqlite()) !== undefined;
+}
+/** A database of `node:sqlite`. It keeps the prepared statements of the storage. */
+class NodeDatabase {
+    handle;
+    statements = new Map();
+    constructor(handle) {
+        this.handle = handle;
+    }
+    all(sql, params = []) {
+        return this.statement(sql).all(...params);
+    }
+    firstOfEach(sql, params) {
+        const statement = this.statement(sql);
+        return params.map((list) => statement.get(...list));
+    }
+    run(sql, params = []) {
+        return Number(this.statement(sql).run(...params).changes);
+    }
+    exec(sql) {
+        this.handle.exec(sql);
+    }
+    close() {
+        this.statements.clear();
+        this.handle.close();
+    }
+    statement(sql) {
+        let statement = this.statements.get(sql);
+        if (!statement) {
+            statement = this.handle.prepare(sql);
+            this.statements.set(sql, statement);
+        }
+        return statement;
+    }
+}
+/** The error code of SQLite for a write to a read-only database. */
+const SQLITE_READONLY = 8;
+/**
+ * This function opens a database file with `node:sqlite`, and makes the file when it is missing.
+ * The file gets WAL mode, so a read in another process does not wait for a write. The busy
+ * timeout makes a write wait for the lock of another process.
+ */
+function openNodeFile(Database, path, busyTimeoutMs) {
+    const handle = new Database(path);
+    try {
+        handle.exec(`PRAGMA busy_timeout = ${Math.max(0, Math.floor(busyTimeoutMs))}`);
+        try {
+            handle.prepare("PRAGMA journal_mode = WAL").get();
+        }
+        catch (error) {
+            // A read-only file keeps its journal mode: the reads work, and a write gives the error. An
+            // error of an older Node.js can have no `errcode`: then its message tells it.
+            const { errcode, message } = error;
+            if (errcode !== SQLITE_READONLY && !/readonly database/i.test(String(message)))
+                throw error;
+        }
+        // In WAL mode, NORMAL keeps the file consistent after a crash, with fewer disk syncs
+        handle.exec("PRAGMA synchronous = NORMAL");
+    }
+    catch (error) {
+        handle.close();
+        throw error;
+    }
+    return new NodeDatabase(handle);
+}
+// ---------------------------------------------------------------------------
+// sql.js
+// ---------------------------------------------------------------------------
+/** A database of sql.js. */
+class SqlJsDatabase {
+    raw;
+    constructor(raw) {
+        this.raw = raw;
+    }
+    all(sql, params = []) {
+        const statement = this.raw.prepare(sql);
+        try {
+            statement.bind(params);
+            const out = [];
+            while (statement.step())
+                out.push(statement.getAsObject());
+            return out;
+        }
+        finally {
+            statement.free();
+        }
+    }
+    firstOfEach(sql, params) {
+        const statement = this.raw.prepare(sql);
+        try {
+            return params.map((list) => {
+                statement.bind(list);
+                const row = statement.step() ? statement.getAsObject() : undefined;
+                statement.reset();
+                return row;
+            });
+        }
+        finally {
+            statement.free();
+        }
+    }
+    run(sql, params = []) {
+        this.raw.run(sql, params);
+        return this.raw.getRowsModified();
+    }
+    exec(sql) {
+        this.raw.exec(sql);
+    }
+    close() {
+        this.raw.close();
+    }
+}
+/**
+ * A database of `node:sqlite`. A missing file stays missing until the first write that changes
+ * an item: until then, the database is in memory.
+ */
+class NodeOpenDatabase {
+    Database;
+    path;
+    busyTimeoutMs;
+    engine = "node";
+    db;
+    waiting;
+    constructor(Database, path, busyTimeoutMs) {
+        this.Database = Database;
+        this.path = path;
+        this.busyTimeoutMs = busyTimeoutMs;
+        if (path === MEMORY_PATH) {
+            this.db = new NodeDatabase(new Database(MEMORY_PATH));
+            this.waiting = false;
+        }
+        else if (existsSync(path)) {
+            this.db = openNodeFile(Database, path, busyTimeoutMs);
+            this.waiting = false;
+        }
+        else {
+            this.db = new NodeDatabase(new Database(MEMORY_PATH));
+            this.waiting = true;
+        }
+    }
+    makeFile(copy) {
+        if (!this.waiting)
+            return;
+        mkdirSync(dirname(this.path), { recursive: true });
+        const file = openNodeFile(this.Database, this.path, this.busyTimeoutMs);
+        try {
+            copy(this.db, file);
+        }
+        catch (error) {
+            file.close();
+            throw error;
+        }
+        this.db.close();
+        this.db = file;
+        this.waiting = false;
+    }
+    refresh(copy) {
+        if (this.waiting && existsSync(this.path))
+            this.makeFile(copy);
+    }
+    saveFile() {
+        return Promise.resolve();
+    }
+    close() {
+        this.db.close();
+    }
+}
+/** A database of sql.js: the database is in memory, and `saveFile()` writes the whole file. */
+class SqlJsOpenDatabase {
+    db;
+    save;
+    engine = "sqljs";
+    waiting = false;
+    constructor(db, save) {
+        this.db = db;
+        this.save = save;
+    }
+    makeFile() { }
+    refresh() { }
+    saveFile() {
+        return this.save();
+    }
+    close() {
+        this.db.close();
+    }
+}
+/**
+ * sql.js reads only the main file. A write-ahead log of the node engine (`<file>-wal`) can hold
+ * changes that are not in the main file yet. A whole-file write of sql.js does not agree with the
+ * log. Thus sql.js refuses such a file.
+ */
+function checkNoWriteAheadLog(path) {
+    let size = 0;
+    try {
+        size = statSync(`${path}-wal`).size;
+    }
+    catch {
+        return;
+    }
+    if (size > 0) {
+        throw new Error(`The file ${path} has a write-ahead log (${path}-wal) of the engine node: open it with the engine node, or close the process that uses it`);
+    }
+}
+/** The error of the engine `node` when this Node.js has no `node:sqlite`. */
+function noNodeSqlite() {
+    return new Error(`The SQLite engine node needs node:sqlite, and this Node.js (${process.version}) does not have it without a flag: use Node.js 22.13 or later, or the engine sqljs or auto`);
+}
+/** This function opens the database of a path with an engine. `auto` uses `node` when it can. */
+export async function openEngine(path, engine, busyTimeoutMs) {
+    if (engine !== "sqljs") {
+        const Database = await loadNodeSqlite();
+        if (Database)
+            return new NodeOpenDatabase(Database, path, busyTimeoutMs);
+        if (engine === "node")
+            throw noNodeSqlite();
+    }
+    if (path !== MEMORY_PATH)
+        checkNoWriteAheadLog(path);
+    const { db, save } = await createConnection({ dbPath: path });
+    return new SqlJsOpenDatabase(new SqlJsDatabase(db), save);
+}
+//# sourceMappingURL=engines.js.map

package/dist/engines.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engines.js","sourceRoot":"","sources":["../src/engines.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -37,7 +37,7 @@ export type { DbQueryInput, DbQueryOutput, DbExecuteInput, DbExecuteOutput, Logs
 export { DEFAULT_DB_PATH, LOG_LEVELS } from "./types.js";
 export { dbTables, dbSchema, dbTransaction, dbMigrate, dbBackup } from "./procedures/db/index.js";
 export { registerSqliteProcedures } from "./module.js";
-export { SqliteStorage, checkTableName, MEMORY_PATH, type SqliteStorageOptions } from "./storage.js";
+export { SqliteStorage, checkTableName, isNodeSqliteAvailable, MEMORY_PATH, type SqliteEngine, type SqliteEngineName, type SqliteStorageOptions, } from "./storage.js";
 export { withConnection, createConnection, query, execute, execMultiple, lastInsertRowId, tableExists, getMigrationStatus, runMigrations, rollbackMigration, createMigration, } from "@mark1russell7/docker-sqlite";
 export type { ConnectionConfig, ConnectionCallback, QueryResult, ExecuteResult, Migration, MigrationStatus, Database, } from "@mark1russell7/docker-sqlite";
 //# 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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAMH,YAAY,EACV,YAAY,EACZ,aAAa,EACb,cAAc,EACd,eAAe,EACf,cAAc,EACd,eAAe,EACf,cAAc,EACd,eAAe,EACf,QAAQ,EACR,QAAQ,EACR,aAAa,EACb,cAAc,EACd,WAAW,EACX,aAAa,EACb,cAAc,EACd,YAAY,EACZ,WAAW,EACX,gBAAgB,EAChB,WAAW,EACX,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,WAAW,EACX,cAAc,EACd,eAAe,EACf,aAAa,EACb,cAAc,GACf,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAGzD,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,aAAa,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAMlG,OAAO,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAMvD,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,WAAW,EAAE,KAAK,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAMrG,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,KAAK,EACL,OAAO,EACP,YAAY,EACZ,eAAe,EACf,WAAW,EACX,kBAAkB,EAClB,aAAa,EACb,iBAAiB,EACjB,eAAe,GAChB,MAAM,8BAA8B,CAAC;AAEtC,YAAY,EACV,gBAAgB,EAChB,kBAAkB,EAClB,WAAW,EACX,aAAa,EACb,SAAS,EACT,eAAe,EACf,QAAQ,GACT,MAAM,8BAA8B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAMH,YAAY,EACV,YAAY,EACZ,aAAa,EACb,cAAc,EACd,eAAe,EACf,cAAc,EACd,eAAe,EACf,cAAc,EACd,eAAe,EACf,QAAQ,EACR,QAAQ,EACR,aAAa,EACb,cAAc,EACd,WAAW,EACX,aAAa,EACb,cAAc,EACd,YAAY,EACZ,WAAW,EACX,gBAAgB,EAChB,WAAW,EACX,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,WAAW,EACX,cAAc,EACd,eAAe,EACf,aAAa,EACb,cAAc,GACf,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAGzD,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,aAAa,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAMlG,OAAO,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAMvD,OAAO,EACL,aAAa,EACb,cAAc,EACd,qBAAqB,EACrB,WAAW,EACX,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,KAAK,oBAAoB,GAC1B,MAAM,cAAc,CAAC;AAMtB,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,KAAK,EACL,OAAO,EACP,YAAY,EACZ,eAAe,EACf,WAAW,EACX,kBAAkB,EAClB,aAAa,EACb,iBAAiB,EACjB,eAAe,GAChB,MAAM,8BAA8B,CAAC;AAEtC,YAAY,EACV,gBAAgB,EAChB,kBAAkB,EAClB,WAAW,EACX,aAAa,EACb,SAAS,EACT,eAAe,EACf,QAAQ,GACT,MAAM,8BAA8B,CAAC"}

package/dist/index.js

@@ -43,7 +43,7 @@ export { registerSqliteProcedures } from "./module.js";
 // =============================================================================
 // The collection storage (roadmap R45). The entry @procedures/sqlite/storage has it alone.
 // =============================================================================
-export { SqliteStorage, checkTableName, MEMORY_PATH } from "./storage.js";
+export { SqliteStorage, checkTableName, isNodeSqliteAvailable, MEMORY_PATH, } from "./storage.js";
 // =============================================================================
 // Re-export docker-sqlite utilities for direct use
 // =============================================================================

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAoCH,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAEzD,yDAAyD;AACzD,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,aAAa,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAElG,gFAAgF;AAChF,eAAe;AACf,gFAAgF;AAEhF,OAAO,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAEvD,gFAAgF;AAChF,2FAA2F;AAC3F,gFAAgF;AAEhF,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,WAAW,EAA6B,MAAM,cAAc,CAAC;AAErG,gFAAgF;AAChF,mDAAmD;AACnD,gFAAgF;AAEhF,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,KAAK,EACL,OAAO,EACP,YAAY,EACZ,eAAe,EACf,WAAW,EACX,kBAAkB,EAClB,aAAa,EACb,iBAAiB,EACjB,eAAe,GAChB,MAAM,8BAA8B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAoCH,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAEzD,yDAAyD;AACzD,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,aAAa,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAElG,gFAAgF;AAChF,eAAe;AACf,gFAAgF;AAEhF,OAAO,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAEvD,gFAAgF;AAChF,2FAA2F;AAC3F,gFAAgF;AAEhF,OAAO,EACL,aAAa,EACb,cAAc,EACd,qBAAqB,EACrB,WAAW,GAIZ,MAAM,cAAc,CAAC;AAEtB,gFAAgF;AAChF,mDAAmD;AACnD,gFAAgF;AAEhF,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,KAAK,EACL,OAAO,EACP,YAAY,EACZ,eAAe,EACf,WAAW,EACX,kBAAkB,EAClB,aAAa,EACb,iBAAiB,EACjB,eAAe,GAChB,MAAM,8BAA8B,CAAC"}

package/dist/storage.d.ts

@@ -3,28 +3,31 @@
  *
  * `SqliteStorage` keeps the items of one collection in one table of a SQLite database: a file,
  * or `:memory:`. It implements `CollectionStorage` of `@procedures/client`, so a
- * `ProcedureServer`, an `ApiStorage` server and a `HybridStorage` can use it. The engine is
- * sql.js (SQLite in WebAssembly), through `@mark1russell7/docker-sqlite`: no native build.
+ * `ProcedureServer`, an `ApiStorage` server and a `HybridStorage` can use it.
  *
+ * - The storage has two engines (the option `engine`). The engine `node` is `node:sqlite` of
+ *   Node.js: it writes only the changed pages of the file. The engine `sqljs` is sql.js (SQLite in
+ *   WebAssembly) through `@mark1russell7/docker-sqlite`: it keeps the database in memory and
+ *   writes the whole file after a write. The default `auto` uses `node` when Node.js has it.
+ * - The two engines use the same file format: a file of one engine opens with the other.
  * - The table of a collection has the columns `id` (the key) and `value` (the JSON text of the
  *   item). A value goes through `JSON.stringify` and `JSON.parse`.
  * - A change log gives `getChangesSince()`. The table `_storage_log` has the last change of each
  *   id, and `_storage_versions` has the version of each collection: `<epoch>:<seq>`, as
  *   `InMemoryStorage` has. The epoch stays in the file, so a version stays valid after a restart.
  * - Each write runs in a transaction. A batch that fails changes nothing.
- * - The storage keeps the database in memory and writes the file after each write. A write ends
- *   after its file write. One file write can hold the changes of several writes.
- * - The storages of one file in one process share one database, so the storages of two tables in
- *   one file do not write over the changes of each other.
+ * - The storages of one file in one process share one database. Thus the storages of two tables
+ *   in one file keep the changes of each other.
+ * - A storage that only reads does not make the file.
  */
-import type { CollectionStorage, StorageChanges, StorageMetadata } from "@procedures/client";
-/** The path of a database that is only in memory. */
-export declare const MEMORY_PATH = ":memory:";
+import { type CollectionStorage, type Duration, type StorageChanges, type StorageMetadata } from "@procedures/client";
+import { type SqliteEngine, type SqliteEngineName } from "./engines.js";
+export { MEMORY_PATH, isNodeSqliteAvailable, type SqliteEngine, type SqliteEngineName } from "./engines.js";
 /** The options of a `SqliteStorage`. */
 export interface SqliteStorageOptions {
     /**
      * The database file, or `:memory:` for a database that lives as long as the storage. The
-     * storage makes the file, and its folder, at the first write.
+     * storage makes the file, and its folder, at the first write that changes an item.
      */
     path: string;
     /**
@@ -38,6 +41,28 @@ export interface SqliteStorageOptions {
      * @default 10000
      */
     maxTombstones?: number;
+    /**
+     * The SQLite engine.
+     *
+     * - `node`: the module `node:sqlite` of Node.js 22.13 or later. It writes only the changes, and
+     *   the file is in WAL mode. Two processes can use one file.
+     * - `sqljs`: sql.js, SQLite in WebAssembly. It keeps the database in memory, and it writes the
+     *   whole file after a write.
+     * - `auto`: `node` when Node.js has `node:sqlite`, and else `sqljs`.
+     *
+     * The storages of one file in one process share one database, and thus one engine. The first
+     * storage of the file sets it. A storage with another engine than `auto` refuses a database
+     * of the other engine.
+     * @default "auto"
+     */
+    engine?: SqliteEngine;
+    /**
+     * The time that a write of the engine `node` waits for the lock of another process, for example
+     * `seconds(5)`. After it, the write fails with the error `database is locked`. The first
+     * storage of a file sets it.
+     * @default 5 seconds
+     */
+    busyTimeout?: Duration;
 }
 /**
  * This function gives the name when it is a permitted table name. Else it throws a `TypeError`. The name goes
@@ -53,6 +78,7 @@ export declare function checkTableName(name: unknown): string;
  * await users.set("123", { id: "123", name: "John" });
  * const user = await users.get("123"); // { id: "123", name: "John" }
  * const changes = await users.getChangesSince(); // { version, full: true, changed, deleted: [] }
+ * await users.getEngine(); // "node" on Node.js 22.13 or later, else "sqljs"
  * await users.close();
  * ```
  */
@@ -61,6 +87,8 @@ export declare class SqliteStorage<T> implements CollectionStorage<T> {
     readonly path: string;
     /** The table of the items. */
     readonly table: string;
+    /** The engine choice of the options. `getEngine()` gives the engine that the storage uses. */
+    readonly engine: SqliteEngine;
     private readonly maxTombstones;
     /** The quoted table name, for the SQL text. */
     private readonly quoted;
@@ -71,10 +99,13 @@ export declare class SqliteStorage<T> implements CollectionStorage<T> {
     getAll(): Promise<T[]>;
     /** Every item with its id, in the order of the first write of each id. */
     getEntries(): Promise<Array<[string, T]>>;
+    /** The ids of the items, in the order of the entries. The storage does not read the values. */
+    getIds(): Promise<string[]>;
     /**
      * The changes after a version (roadmap R28). A version of another storage, of another database
      * file, or older than the dropped deletes gives all items (`full: true`). A version stays valid
-     * after a restart, because the change log is in the file.
+     * after a restart, because the change log is in the file. The reads run in one read
+     * transaction, so a write of another process does not come between them.
      */
     getChangesSince(since?: string): Promise<StorageChanges<T>>;
     find(predicate: (item: T) => boolean): Promise<T[]>;
@@ -88,30 +119,40 @@ export declare class SqliteStorage<T> implements CollectionStorage<T> {
     /** This method deletes several items in one transaction. */
     deleteBatch(ids: string[]): Promise<number>;
     getBatch(ids: string[]): Promise<Map<string, T>>;
+    /** The engine that the storage uses: `node` or `sqljs`. With the option `auto`, the open decides it. */
+    getEngine(): Promise<SqliteEngineName>;
     /**
      * This method writes the database file. Each write ends after its file write already, so a
-     * caller needs it only after a failed file write.
+     * caller needs it only after a failed file write of the engine `sqljs`. The engine `node`
+     * writes each change at its commit.
      */
     flush(): Promise<void>;
     /**
      * This method writes the file and releases the database. The items stay in the file. A new
      * storage of the same file and table reads them, and the versions of this storage stay valid.
-     * After `close()`, each operation throws.
+     * After `close()`, each operation rejects, and a second `close()` does nothing.
      */
     close(): Promise<void>;
     getMetadata(): Promise<StorageMetadata>;
     /** This method opens the database, and makes the tables of the collection and of the change log. */
     private open;
-    /** The open database. It throws after `close()`. */
+    /** The open database. It throws after `close()`, so the promise of the operation rejects. */
     private database;
+    private sharedDatabase;
     private checkOpen;
     private entries;
     private counter;
     /**
-     * One write: the change in a transaction with the change log, then the file write. `next` gives
-     * the next number of the change log. A write that changes nothing writes no file.
+     * One write: the change in a transaction with the change log, then the file write of the engine
+     * `sqljs`. `next` gives the next number of the change log. A write that changes nothing writes
+     * no file.
+     *
+     * Before the first write, the engine `node` keeps the database of a missing file in memory, with
+     * no item. A write first tests its change there. When it changes an item, the storage makes the
+     * file and runs the write in it.
      */
     private write;
+    private runWrite;
     /** This method writes an item. An existing id keeps its place in the order. */
     private put;
     /** This method deletes an item. True when it existed. */

package/dist/storage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../src/storage.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../src/storage.ts"],"names":[],"mappings":"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"}