@procedures/sqlite 0.3.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

@@ -10,8 +10,8 @@
  *
  * const client = new Client(...);
  *
- * // Execute a query
- * const result = await client.call(["db", "query"], {
+ * // Execute a query (sqlite.query: the old name db.query is a deprecated alias)
+ * const result = await client.call(["sqlite", "query"], {
  *   sql: "SELECT * FROM logs WHERE level = ?",
  *   params: ["error"]
  * });
@@ -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

@@ -10,8 +10,8 @@
  *
  * const client = new Client(...);
  *
- * // Execute a query
- * const result = await client.call(["db", "query"], {
+ * // Execute a query (sqlite.query: the old name db.query is a deprecated alias)
+ * const result = await client.call(["sqlite", "query"], {
  *   sql: "SELECT * FROM logs WHERE level = ?",
  *   params: ["error"]
  * });
@@ -34,7 +34,7 @@
  * ```
  */
 export { DEFAULT_DB_PATH, LOG_LEVELS } from "./types.js";
-// The db.* procedures of roadmap R44, for direct use
+// The sqlite.* procedures of roadmap R44, for direct use
 export { dbTables, dbSchema, dbTransaction, dbMigrate, dbBackup } from "./procedures/db/index.js";
 // =============================================================================
 // Registration
@@ -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,qDAAqD;AACrD,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/module.d.ts

@@ -3,11 +3,21 @@
  *
  * Procedure Registration for SQLite
  *
- * Registers database and logging procedures with the client system: db.query, db.execute,
- * db.tables, db.schema, db.transaction, db.migrate, db.backup, logs.store and logs.query.
+ * The module has the database and logging procedures: sqlite.query, sqlite.execute,
+ * sqlite.tables, sqlite.schema, sqlite.transaction, sqlite.migrate, sqlite.backup, logs.store
+ * and logs.query. The old names db.* stay for one release as deprecated aliases (refer to
+ * `deprecatedDbAlias`).
  * This file is referenced by package.json's client.procedures field.
  */
-import { type ProcedureModule, type ProcedureRegistry } from "@procedures/client";
+import { type AnyProcedure, type ProcedureModule, type ProcedureRegistry } from "@procedures/client";
+/**
+ * This function gives the deprecated alias `db.<name>` of the procedure `sqlite.<name>`. The alias
+ * has the same schemas, handler and effects. Its description names the new procedure. The aliases
+ * go away in the next release. The MCP server does not expose them (`bundle-mcp`).
+ */
+export declare function deprecatedDbAlias(procedure: AnyProcedure): AnyProcedure;
+/** The deprecated aliases `db.query`, `db.execute`, `db.tables`, `db.schema`, `db.transaction`, `db.migrate` and `db.backup`. */
+export declare const dbAliasProcedures: readonly AnyProcedure[];
 /**
  * The module of this package, for `createRegistry()`: its procedures as data. Importing this
  * file registers nothing. (`register.ts` registers the same procedures in the global registry.)

package/dist/module.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"module.d.ts","sourceRoot":"","sources":["../src/module.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAA6C,KAAK,eAAe,EAAuC,KAAK,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAoelK;;;GAGG;AACH,eAAO,MAAM,YAAY,EAAE,eAUvB,CAAC;eAEU,YAAY;AAE3B;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,GAAE,iBAAsC,GAAG,IAAI,CAE/F"}
+{"version":3,"file":"module.d.ts","sourceRoot":"","sources":["../src/module.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAA6C,KAAK,YAAY,EAAE,KAAK,eAAe,EAAuC,KAAK,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAgfrL;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,YAAY,GAAG,YAAY,CAavE;AAED,iIAAiI;AACjI,eAAO,MAAM,iBAAiB,EAAE,SAAS,YAAY,EAA4C,CAAC;AAMlG;;;GAGG;AACH,eAAO,MAAM,YAAY,EAAE,eAMvB,CAAC;eAEU,YAAY;AAE3B;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,GAAE,iBAAsC,GAAG,IAAI,CAE/F"}

package/dist/module.js

@@ -3,8 +3,10 @@
  *
  * Procedure Registration for SQLite
  *
- * Registers database and logging procedures with the client system: db.query, db.execute,
- * db.tables, db.schema, db.transaction, db.migrate, db.backup, logs.store and logs.query.
+ * The module has the database and logging procedures: sqlite.query, sqlite.execute,
+ * sqlite.tables, sqlite.schema, sqlite.transaction, sqlite.migrate, sqlite.backup, logs.store
+ * and logs.query. The old names db.* stay for one release as deprecated aliases (refer to
+ * `deprecatedDbAlias`).
  * This file is referenced by package.json's client.procedures field.
  */
 import { createProcedure, zodAdapter, defineModule, PROCEDURE_REGISTRY, registerModules } from "@procedures/client";
@@ -18,10 +20,11 @@ import { DbTablesInputSchema, DbTablesOutputSchema, DbSchemaInputSchema, DbSchem
 // =============================================================================
 // Real schemas (roadmap 2.1): the input is validated before the handler, and the MCP tool list
 // and the help of mark describe each field. zodAdapter<T> checks each schema against its type.
+// The description is the same on each computer: it does not show the home folder of this one
 const dbPathField = z
     .string()
     .optional()
-    .describe(`The SQLite database file (default: ${DEFAULT_DB_PATH}). A query does not make a missing file.`);
+    .describe("The SQLite database file (default: the CLI log database, ~/logs/cli/cli.db). A query does not make a missing file.");
 const paramsField = z
     .array(z.unknown())
     .optional()
@@ -120,10 +123,10 @@ async function ensureLogsTable(dbPath) {
     });
 }
 // =============================================================================
-// db.query Procedure
+// sqlite.query Procedure
 // =============================================================================
-const dbQueryProcedure = createProcedure()
-    .path(["db", "query"])
+const sqliteQueryProcedure = createProcedure()
+    .path(["sqlite", "query"])
     .input(dbQueryInputSchema)
     .output(dbQueryOutputSchema)
     .meta({
@@ -146,10 +149,10 @@ const dbQueryProcedure = createProcedure()
 })
     .build();
 // =============================================================================
-// db.execute Procedure
+// sqlite.execute Procedure
 // =============================================================================
-const dbExecuteProcedure = createProcedure()
-    .path(["db", "execute"])
+const sqliteExecuteProcedure = createProcedure()
+    .path(["sqlite", "execute"])
     .input(dbExecuteInputSchema)
     .output(dbExecuteOutputSchema)
     .meta({
@@ -294,10 +297,10 @@ const logsQueryProcedure = createProcedure()
 })
     .build();
 // =============================================================================
-// db.tables, db.schema, db.transaction, db.migrate and db.backup (roadmap R44)
+// sqlite.tables, sqlite.schema, sqlite.transaction, sqlite.migrate and sqlite.backup (roadmap R44)
 // =============================================================================
-const dbTablesProcedure = createProcedure()
-    .path(["db", "tables"])
+const sqliteTablesProcedure = createProcedure()
+    .path(["sqlite", "tables"])
     .input(zodAdapter(DbTablesInputSchema))
     .output(zodAdapter(DbTablesOutputSchema))
     .meta({
@@ -309,8 +312,8 @@ const dbTablesProcedure = createProcedure()
 })
     .handler(async (input) => dbTables(input))
     .build();
-const dbSchemaProcedure = createProcedure()
-    .path(["db", "schema"])
+const sqliteSchemaProcedure = createProcedure()
+    .path(["sqlite", "schema"])
     .input(zodAdapter(DbSchemaInputSchema))
     .output(zodAdapter(DbSchemaOutputSchema))
     .meta({
@@ -322,8 +325,8 @@ const dbSchemaProcedure = createProcedure()
 })
     .handler(async (input) => dbSchema(input))
     .build();
-const dbTransactionProcedure = createProcedure()
-    .path(["db", "transaction"])
+const sqliteTransactionProcedure = createProcedure()
+    .path(["sqlite", "transaction"])
     .input(zodAdapter(DbTransactionInputSchema))
     .output(zodAdapter(DbTransactionOutputSchema))
     .meta({
@@ -336,8 +339,8 @@ const dbTransactionProcedure = createProcedure()
 })
     .handler(async (input) => dbTransaction(input))
     .build();
-const dbMigrateProcedure = createProcedure()
-    .path(["db", "migrate"])
+const sqliteMigrateProcedure = createProcedure()
+    .path(["sqlite", "migrate"])
     .input(zodAdapter(DbMigrateInputSchema))
     .output(zodAdapter(DbMigrateOutputSchema))
     .meta({
@@ -350,8 +353,8 @@ const dbMigrateProcedure = createProcedure()
 })
     .handler(async (input) => dbMigrate(input))
     .build();
-const dbBackupProcedure = createProcedure()
-    .path(["db", "backup"])
+const sqliteBackupProcedure = createProcedure()
+    .path(["sqlite", "backup"])
     .input(zodAdapter(DbBackupInputSchema))
     .output(zodAdapter(DbBackupOutputSchema))
     .meta({
@@ -365,6 +368,40 @@ const dbBackupProcedure = createProcedure()
     .handler(async (input) => dbBackup(input))
     .build();
 // =============================================================================
+// The deprecated db.* aliases (one release)
+// =============================================================================
+/** The procedures of the `sqlite` namespace. Each one has a deprecated alias in `db`. */
+const sqliteProcedures = [
+    sqliteQueryProcedure,
+    sqliteExecuteProcedure,
+    sqliteTablesProcedure,
+    sqliteSchemaProcedure,
+    sqliteTransactionProcedure,
+    sqliteMigrateProcedure,
+    sqliteBackupProcedure,
+];
+/**
+ * This function gives the deprecated alias `db.<name>` of the procedure `sqlite.<name>`. The alias
+ * has the same schemas, handler and effects. Its description names the new procedure. The aliases
+ * go away in the next release. The MCP server does not expose them (`bundle-mcp`).
+ */
+export function deprecatedDbAlias(procedure) {
+    const name = procedure.path.slice(1).join(".");
+    const description = typeof procedure.metadata.description === "string" ? ` ${procedure.metadata.description}` : "";
+    return {
+        ...procedure,
+        path: ["db", ...procedure.path.slice(1)],
+        metadata: {
+            ...procedure.metadata,
+            description: `Deprecated: use sqlite.${name}.${description}`,
+            deprecated: true,
+            deprecationMessage: `Use sqlite.${name}. The alias db.${name} goes away in the next release.`,
+        },
+    };
+}
+/** The deprecated aliases `db.query`, `db.execute`, `db.tables`, `db.schema`, `db.transaction`, `db.migrate` and `db.backup`. */
+export const dbAliasProcedures = sqliteProcedures.map(deprecatedDbAlias);
+// =============================================================================
 // Registration
 // =============================================================================
 /**
@@ -372,15 +409,11 @@ const dbBackupProcedure = createProcedure()
  * file registers nothing. (`register.ts` registers the same procedures in the global registry.)
  */
 export const sqliteModule = defineModule("@procedures/sqlite", [
-    dbQueryProcedure,
-    dbExecuteProcedure,
+    ...sqliteProcedures,
     logsStoreProcedure,
     logsQueryProcedure,
-    dbTablesProcedure,
-    dbSchemaProcedure,
-    dbTransactionProcedure,
-    dbMigrateProcedure,
-    dbBackupProcedure,
+    // The old names, for one release
+    ...dbAliasProcedures,
 ]);
 export default sqliteModule;
 /**