@flowot/nx-pn-storage-sqlite 0.3.0

package/lib/index.d.ts

@@ -0,0 +1,63 @@
+/**
+ * SQLite storage backend: one database file hosts every routed unit,
+ * document-per-row (`key TEXT` / `value TEXT` JSON). This is a PURE LIBRARY
+ * (no cordis): the nx-pn host owns assembly — `new SqliteStorageBackend({ path,
+ * journalMode })` registers the instance under backend name `sqlite` on the
+ * storage hub, and on teardown unregisters first, then calls `close()`.
+ * @module @flowot/nx-pn-storage-sqlite
+ */
+import type { KvFacet, StorageBackend } from '@flowot/nx-pn-storage';
+import { type JournalMode } from './schema.js';
+export { STORAGE_SQLITE_SCHEMA_VERSION, type JournalMode } from './schema.js';
+/**
+ * Backend configuration. In dsh this package was a cordis plugin whose
+ * `Config` was validated by schemastery at load time (with `journalMode`
+ * defaulting to `wal`); here validation/defaulting is the caller's
+ * responsibility and only the plain interface remains.
+ */
+export interface Config {
+    /**
+     * Filesystem path to the SQLite database file. The special value `:memory:`
+     * opens an in-process database (tests). On filesystems with POSIX modes,
+     * missing directories and databases are created owner-only; existing path
+     * modes are preserved. Filesystem setup errors other than an existing
+     * database fail the open. The backend does not protect confidentiality or
+     * integrity when another principal can replace the database entry in its
+     * parent directory.
+     */
+    path: string;
+    /**
+     * SQLite `journal_mode` pragma. `wal` (the default) suits local disks; pick
+     * a rollback-journal mode (`delete`/`truncate`/`persist`) on filesystems
+     * where WAL's shared-memory files do not work (network mounts). See
+     * {@link JournalMode}.
+     */
+    journalMode?: JournalMode;
+}
+/**
+ * The SQLite {@link StorageBackend}. Owns one `DatabaseSync` connection and
+ * the open-unit table; `kv.open` validates names, enforces the per-unit
+ * version stamp in `units`, and ensures the unit's record tables.
+ */
+export declare class SqliteStorageBackend implements StorageBackend {
+    /** The key-value facet; the only shape this backend serves. */
+    readonly kv: KvFacet;
+    private readonly ready;
+    /** Open (or still-opening) units by name; presence is the double-open guard. */
+    private readonly units;
+    private closing;
+    /**
+     * @param config - Backend configuration.
+     */
+    constructor(config: Config);
+    private openUnit;
+    private materializeUnit;
+    /**
+     * Close every open unit and release the database. Idempotent; concurrent
+     * and repeated calls resolve once teardown finishes.
+     * @returns resolution after the medium is released.
+     */
+    close(): Promise<void>;
+    private doClose;
+}
+//# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,OAAO,EAA4B,cAAc,EAAE,MAAM,uBAAuB,CAAA;AAC9F,OAAO,EAAiC,KAAK,WAAW,EAAE,MAAM,aAAa,CAAA;AAG7E,OAAO,EAAE,6BAA6B,EAAE,KAAK,WAAW,EAAE,MAAM,aAAa,CAAA;AAE7E;;;;;GAKG;AACH,MAAM,WAAW,MAAM;IACrB;;;;;;;;OAQG;IACH,IAAI,EAAE,MAAM,CAAA;IACZ;;;;;OAKG;IACH,WAAW,CAAC,EAAE,WAAW,CAAA;CAC1B;AAED;;;;GAIG;AACH,qBAAa,oBAAqB,YAAW,cAAc;IACzD,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAoD;IAExE,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAuB;IAC7C,gFAAgF;IAChF,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA2C;IACjE,OAAO,CAAC,OAAO,CAA2B;IAE1C;;OAEG;gBACS,MAAM,EAAE,MAAM;IAU1B,OAAO,CAAC,QAAQ;YAuBF,eAAe;IA2B7B;;;;OAIG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YAKR,OAAO;CAetB"}

package/lib/index.js

@@ -0,0 +1,107 @@
+/**
+ * SQLite storage backend: one database file hosts every routed unit,
+ * document-per-row (`key TEXT` / `value TEXT` JSON). This is a PURE LIBRARY
+ * (no cordis): the nx-pn host owns assembly — `new SqliteStorageBackend({ path,
+ * journalMode })` registers the instance under backend name `sqlite` on the
+ * storage hub, and on teardown unregisters first, then calls `close()`.
+ * @module @flowot/nx-pn-storage-sqlite
+ */
+import { StorageError, UNIT_NAME_RE } from '@flowot/nx-pn-storage';
+import { openDatabase, recordTableName } from './schema.js';
+import { SqliteKvUnit } from './unit.js';
+export { STORAGE_SQLITE_SCHEMA_VERSION } from './schema.js';
+/**
+ * The SQLite {@link StorageBackend}. Owns one `DatabaseSync` connection and
+ * the open-unit table; `kv.open` validates names, enforces the per-unit
+ * version stamp in `units`, and ensures the unit's record tables.
+ */
+export class SqliteStorageBackend {
+    /** The key-value facet; the only shape this backend serves. */
+    kv = { open: descriptor => this.openUnit(descriptor) };
+    ready;
+    /** Open (or still-opening) units by name; presence is the double-open guard. */
+    units = new Map();
+    closing;
+    /**
+     * @param config - Backend configuration.
+     */
+    constructor(config) {
+        // The dsh loader applied the schemastery `default('wal')` before the
+        // constructor ran; with that loader gone, the default is applied here.
+        this.ready = openDatabase(config.path, config.journalMode ?? 'wal');
+        // Mark the rejection handled: every primitive re-awaits `ready`, so an
+        // open failure still surfaces to each caller; this guard only prevents an
+        // unhandled-rejection crash when the failure precedes the first use.
+        this.ready.catch(() => { });
+    }
+    openUnit(descriptor) {
+        if (this.closing !== undefined) {
+            return Promise.reject(new StorageError('closed', 'sqlite storage backend is closed'));
+        }
+        if (!UNIT_NAME_RE.test(descriptor.name)) {
+            return Promise.reject(new Error(`kv unit name '${descriptor.name}' violates ${UNIT_NAME_RE}`));
+        }
+        for (const table of descriptor.tables) {
+            if (!UNIT_NAME_RE.test(table)) {
+                return Promise.reject(new Error(`kv table name '${table}' in unit '${descriptor.name}' violates ${UNIT_NAME_RE}`));
+            }
+        }
+        if (this.units.has(descriptor.name)) {
+            return Promise.reject(new Error(`kv unit '${descriptor.name}' is already open (double-open is a caller bug)`));
+        }
+        // Reserve the name synchronously so a concurrent second open of the same
+        // name rejects instead of racing past the guard during the awaits below.
+        const pending = this.materializeUnit(descriptor);
+        this.units.set(descriptor.name, pending);
+        pending.catch(() => this.units.delete(descriptor.name));
+        return pending;
+    }
+    async materializeUnit(descriptor) {
+        const db = await this.ready;
+        const row = db.prepare('SELECT version FROM units WHERE name = ?').get(descriptor.name);
+        if (row === undefined) {
+            db.prepare('INSERT INTO units (name, version) VALUES (?, ?)').run(descriptor.name, descriptor.version);
+        }
+        else if (row.version !== descriptor.version) {
+            throw new StorageError('version-mismatch', `kv unit '${descriptor.name}' is stamped version ${row.version} on the medium, incompatible with descriptor version ${descriptor.version}`);
+        }
+        for (const table of descriptor.tables) {
+            // Both segments passed UNIT_NAME_RE, so the identifier is safe in DDL.
+            db.exec(`
+        CREATE TABLE IF NOT EXISTS "${recordTableName(descriptor.name, table)}" (
+          key   TEXT PRIMARY KEY,
+          value TEXT NOT NULL
+        ) STRICT
+      `);
+        }
+        return new SqliteKvUnit(db, descriptor, () => {
+            this.units.delete(descriptor.name);
+        });
+    }
+    /**
+     * Close every open unit and release the database. Idempotent; concurrent
+     * and repeated calls resolve once teardown finishes.
+     * @returns resolution after the medium is released.
+     */
+    close() {
+        this.closing ??= this.doClose();
+        return this.closing;
+    }
+    async doClose() {
+        let db;
+        try {
+            db = await this.ready;
+        }
+        catch {
+            // The medium never opened; that failure already rejected the opener and
+            // every unit call, so there is nothing left to release here.
+            return;
+        }
+        for (const pending of [...this.units.values()]) {
+            const unit = await pending.catch(() => undefined);
+            await unit?.close();
+        }
+        db.close();
+    }
+}
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAA;AAElE,OAAO,EAAE,YAAY,EAAE,eAAe,EAAoB,MAAM,aAAa,CAAA;AAC7E,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AAExC,OAAO,EAAE,6BAA6B,EAAoB,MAAM,aAAa,CAAA;AA4B7E;;;;GAIG;AACH,MAAM,OAAO,oBAAoB;IAC/B,+DAA+D;IACtD,EAAE,GAAY,EAAE,IAAI,EAAE,UAAU,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAA;IAEvD,KAAK,CAAuB;IAC7C,gFAAgF;IAC/D,KAAK,GAAG,IAAI,GAAG,EAAiC,CAAA;IACzD,OAAO,CAA2B;IAE1C;;OAEG;IACH,YAAY,MAAc;QACxB,qEAAqE;QACrE,uEAAuE;QACvE,IAAI,CAAC,KAAK,GAAG,YAAY,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,WAAW,IAAI,KAAK,CAAC,CAAA;QACnE,uEAAuE;QACvE,0EAA0E;QAC1E,qEAAqE;QACrE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA;IAC5B,CAAC;IAEO,QAAQ,CAAC,UAA4B;QAC3C,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;YAC/B,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,YAAY,CAAC,QAAQ,EAAE,kCAAkC,CAAC,CAAC,CAAA;QACvF,CAAC;QACD,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACxC,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,iBAAiB,UAAU,CAAC,IAAI,cAAc,YAAY,EAAE,CAAC,CAAC,CAAA;QAChG,CAAC;QACD,KAAK,MAAM,KAAK,IAAI,UAAU,CAAC,MAAM,EAAE,CAAC;YACtC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC9B,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,kBAAkB,KAAK,cAAc,UAAU,CAAC,IAAI,cAAc,YAAY,EAAE,CAAC,CAAC,CAAA;YACpH,CAAC;QACH,CAAC;QACD,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACpC,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,YAAY,UAAU,CAAC,IAAI,iDAAiD,CAAC,CAAC,CAAA;QAChH,CAAC;QACD,yEAAyE;QACzE,yEAAyE;QACzE,MAAM,OAAO,GAAG,IAAI,CAAC,eAAe,CAAC,UAAU,CAAC,CAAA;QAChD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;QACxC,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAA;QACvD,OAAO,OAAO,CAAA;IAChB,CAAC;IAEO,KAAK,CAAC,eAAe,CAAC,UAA4B;QACxD,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAA;QAC3B,MAAM,GAAG,GAAG,EAAE,CAAC,OAAO,CAAC,0CAA0C,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAEzE,CAAA;QACb,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;YACtB,EAAE,CAAC,OAAO,CAAC,iDAAiD,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,EAAE,UAAU,CAAC,OAAO,CAAC,CAAA;QACxG,CAAC;aAAM,IAAI,GAAG,CAAC,OAAO,KAAK,UAAU,CAAC,OAAO,EAAE,CAAC;YAC9C,MAAM,IAAI,YAAY,CACpB,kBAAkB,EAClB,YAAY,UAAU,CAAC,IAAI,wBAAwB,GAAG,CAAC,OAAO,wDAAwD,UAAU,CAAC,OAAO,EAAE,CAC3I,CAAA;QACH,CAAC;QACD,KAAK,MAAM,KAAK,IAAI,UAAU,CAAC,MAAM,EAAE,CAAC;YACtC,uEAAuE;YACvE,EAAE,CAAC,IAAI,CAAC;sCACwB,eAAe,CAAC,UAAU,CAAC,IAAI,EAAE,KAAK,CAAC;;;;OAItE,CAAC,CAAA;QACJ,CAAC;QACD,OAAO,IAAI,YAAY,CAAC,EAAE,EAAE,UAAU,EAAE,GAAG,EAAE;YAC3C,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAA;QACpC,CAAC,CAAC,CAAA;IACJ,CAAC;IAED;;;;OAIG;IACH,KAAK;QACH,IAAI,CAAC,OAAO,KAAK,IAAI,CAAC,OAAO,EAAE,CAAA;QAC/B,OAAO,IAAI,CAAC,OAAO,CAAA;IACrB,CAAC;IAEO,KAAK,CAAC,OAAO;QACnB,IAAI,EAAgB,CAAA;QACpB,IAAI,CAAC;YACH,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAA;QACvB,CAAC;QAAC,MAAM,CAAC;YACP,wEAAwE;YACxE,6DAA6D;YAC7D,OAAM;QACR,CAAC;QACD,KAAK,MAAM,OAAO,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC;YAC/C,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAA;YACjD,MAAM,IAAI,EAAE,KAAK,EAAE,CAAA;QACrB,CAAC;QACD,EAAE,CAAC,KAAK,EAAE,CAAA;IACZ,CAAC;CACF"}

package/lib/schema.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Schema + open-time helpers for the SQLite storage backend: the physical
+ * layout version, the database open/configure sequence (permissions, pragmas,
+ * version stamp/reject), and the unit metadata tables. Unit record tables are
+ * created per descriptor in `unit.ts`.
+ * @module @flowot/nx-pn-storage-sqlite/schema
+ */
+import { DatabaseSync } from 'node:sqlite';
+/**
+ * The on-disk physical layout version, stored in `PRAGMA user_version`.
+ * Orthogonal to each unit's own `version` (stamped per unit in the `units`
+ * row). Bumped only on a breaking change to the table layout; any other
+ * stamped version rejects — this unreleased format has no migrations.
+ */
+export declare const STORAGE_SQLITE_SCHEMA_VERSION = 1;
+/**
+ * Journal modes the backend will run under. `wal` is the default; the
+ * rollback-journal modes (`delete`/`truncate`/`persist`) exist for
+ * filesystems where WAL's shared-memory files do not work (network mounts).
+ * `memory`/`off` are excluded: dropping journal durability silently
+ * contradicts the durability clause of the KV backend contract.
+ */
+export type JournalMode = 'wal' | 'delete' | 'truncate' | 'persist';
+/**
+ * Open the database and apply its schema and pragmas. Missing directories and
+ * database files are created owner-only (`:memory:` skips filesystem setup).
+ * A zero `user_version` is stamped with {@link STORAGE_SQLITE_SCHEMA_VERSION};
+ * every other non-current version rejects rather than being migrated in place.
+ * @param path - the SQLite database file to open, or `:memory:`.
+ * @param journalMode - validated journal pragma.
+ * @returns the open handle with pragmas applied and the unit metadata tables ensured.
+ */
+export declare function openDatabase(path: string, journalMode: JournalMode): Promise<DatabaseSync>;
+/**
+ * Physical table name for one unit table. Both segments are validated against
+ * `UNIT_NAME_RE` before reaching this, so the result is safe to interpolate
+ * into DDL and prepared-statement text.
+ * @param unit - Validated unit name.
+ * @param table - Validated table name.
+ * @returns the `u_<unit>_<table>` identifier.
+ */
+export declare function recordTableName(unit: string, table: string): string;
+//# sourceMappingURL=schema.d.ts.map

package/lib/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAK1C;;;;;GAKG;AACH,eAAO,MAAM,6BAA6B,IAAI,CAAA;AAE9C;;;;;;GAMG;AACH,MAAM,MAAM,WAAW,GAAG,KAAK,GAAG,QAAQ,GAAG,UAAU,GAAG,SAAS,CAAA;AAsBnE;;;;;;;;GAQG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,CAchG;AAmCD;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAEnE"}

package/lib/schema.js

@@ -0,0 +1,105 @@
+/**
+ * Schema + open-time helpers for the SQLite storage backend: the physical
+ * layout version, the database open/configure sequence (permissions, pragmas,
+ * version stamp/reject), and the unit metadata tables. Unit record tables are
+ * created per descriptor in `unit.ts`.
+ * @module @flowot/nx-pn-storage-sqlite/schema
+ */
+import { DatabaseSync } from 'node:sqlite';
+import { mkdir, open } from 'node:fs/promises';
+import { dirname, resolve } from 'node:path';
+import { StorageError } from '@flowot/nx-pn-storage';
+/**
+ * The on-disk physical layout version, stored in `PRAGMA user_version`.
+ * Orthogonal to each unit's own `version` (stamped per unit in the `units`
+ * row). Bumped only on a breaking change to the table layout; any other
+ * stamped version rejects — this unreleased format has no migrations.
+ */
+export const STORAGE_SQLITE_SCHEMA_VERSION = 1;
+/* jscpd:ignore-start -- deliberately mirrors the session-query-sqlite open
+   sequence. Each package owns a distinct database identity and schema, so a
+   shared helper would couple otherwise independent storage providers (see the
+   domain KV storage Agent Note's reuse audit). */
+/**
+ * Exclusively create a missing database file with owner-only permissions.
+ * Existing files retain their modes, and errors other than `EEXIST` propagate.
+ * `DatabaseSync` reopens by path, so this does not protect confidentiality or
+ * integrity when another principal can replace the database entry in its
+ * parent directory.
+ */
+async function createDatabaseFile(path) {
+    try {
+        const handle = await open(path, 'wx', 0o600);
+        await handle.close();
+    }
+    catch (error) {
+        if (error.code !== 'EEXIST')
+            throw error;
+    }
+}
+/**
+ * Open the database and apply its schema and pragmas. Missing directories and
+ * database files are created owner-only (`:memory:` skips filesystem setup).
+ * A zero `user_version` is stamped with {@link STORAGE_SQLITE_SCHEMA_VERSION};
+ * every other non-current version rejects rather than being migrated in place.
+ * @param path - the SQLite database file to open, or `:memory:`.
+ * @param journalMode - validated journal pragma.
+ * @returns the open handle with pragmas applied and the unit metadata tables ensured.
+ */
+export async function openDatabase(path, journalMode) {
+    const actual = path === ':memory:' ? path : resolve(path);
+    if (actual !== ':memory:') {
+        await mkdir(dirname(actual), { recursive: true, mode: 0o700 });
+        await createDatabaseFile(actual);
+    }
+    const db = new DatabaseSync(actual);
+    try {
+        configureDatabase(db, actual, journalMode);
+        return db;
+    }
+    catch (error) {
+        db.close();
+        throw error;
+    }
+}
+function configureDatabase(db, path, journalMode) {
+    db.exec('PRAGMA foreign_keys = ON');
+    // The validated union is safe to interpolate into a non-bindable PRAGMA.
+    db.exec(`PRAGMA journal_mode = ${journalMode.toUpperCase()}`);
+    // `PRAGMA user_version` always returns exactly one row { user_version }.
+    const { user_version: onDisk } = db.prepare('PRAGMA user_version').get();
+    if (onDisk !== 0 && onDisk !== STORAGE_SQLITE_SCHEMA_VERSION) {
+        throw new StorageError('version-mismatch', `storage database at "${path}" has schema version ${onDisk}, incompatible with this build (${STORAGE_SQLITE_SCHEMA_VERSION})`);
+    }
+    /* jscpd:ignore-end */
+    db.exec(`
+    CREATE TABLE IF NOT EXISTS units (
+      name    TEXT PRIMARY KEY,
+      version INTEGER NOT NULL
+    ) STRICT
+  `);
+    db.exec(`
+    CREATE TABLE IF NOT EXISTS unit_globals (
+      unit  TEXT PRIMARY KEY REFERENCES units(name),
+      value TEXT NOT NULL
+    ) STRICT
+  `);
+    if (onDisk === 0) {
+        // Stamp fresh databases LAST: the stamp asserts the layout is complete,
+        // so a failure above must leave the medium unstamped (a re-open after
+        // the obstruction is cleared retries materialization from scratch).
+        db.exec(`PRAGMA user_version = ${STORAGE_SQLITE_SCHEMA_VERSION}`);
+    }
+}
+/**
+ * Physical table name for one unit table. Both segments are validated against
+ * `UNIT_NAME_RE` before reaching this, so the result is safe to interpolate
+ * into DDL and prepared-statement text.
+ * @param unit - Validated unit name.
+ * @param table - Validated table name.
+ * @returns the `u_<unit>_<table>` identifier.
+ */
+export function recordTableName(unit, table) {
+    return `u_${unit}_${table}`;
+}
+//# sourceMappingURL=schema.js.map

package/lib/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC1C,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAA;AAC9C,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAA;AAEpD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC,CAAA;AAW9C;;;kDAGkD;AAClD;;;;;;GAMG;AACH,KAAK,UAAU,kBAAkB,CAAC,IAAY;IAC5C,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,CAAA;QAC5C,MAAM,MAAM,CAAC,KAAK,EAAE,CAAA;IACtB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ;YAAE,MAAM,KAAK,CAAA;IACrE,CAAC;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,IAAY,EAAE,WAAwB;IACvE,MAAM,MAAM,GAAG,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;IACzD,IAAI,MAAM,KAAK,UAAU,EAAE,CAAC;QAC1B,MAAM,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAA;QAC9D,MAAM,kBAAkB,CAAC,MAAM,CAAC,CAAA;IAClC,CAAC;IACD,MAAM,EAAE,GAAG,IAAI,YAAY,CAAC,MAAM,CAAC,CAAA;IACnC,IAAI,CAAC;QACH,iBAAiB,CAAC,EAAE,EAAE,MAAM,EAAE,WAAW,CAAC,CAAA;QAC1C,OAAO,EAAE,CAAA;IACX,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,EAAE,CAAC,KAAK,EAAE,CAAA;QACV,MAAM,KAAK,CAAA;IACb,CAAC;AACH,CAAC;AAED,SAAS,iBAAiB,CAAC,EAAgB,EAAE,IAAY,EAAE,WAAwB;IACjF,EAAE,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAA;IACnC,yEAAyE;IACzE,EAAE,CAAC,IAAI,CAAC,yBAAyB,WAAW,CAAC,WAAW,EAAE,EAAE,CAAC,CAAA;IAC7D,yEAAyE;IACzE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,qBAAqB,CAAC,CAAC,GAAG,EAA8B,CAAA;IACpG,IAAI,MAAM,KAAK,CAAC,IAAI,MAAM,KAAK,6BAA6B,EAAE,CAAC;QAC7D,MAAM,IAAI,YAAY,CACpB,kBAAkB,EAClB,wBAAwB,IAAI,wBAAwB,MAAM,mCAAmC,6BAA6B,GAAG,CAC9H,CAAA;IACH,CAAC;IACD,sBAAsB;IACtB,EAAE,CAAC,IAAI,CAAC;;;;;GAKP,CAAC,CAAA;IACF,EAAE,CAAC,IAAI,CAAC;;;;;GAKP,CAAC,CAAA;IACF,IAAI,MAAM,KAAK,CAAC,EAAE,CAAC;QACjB,wEAAwE;QACxE,sEAAsE;QACtE,oEAAoE;QACpE,EAAE,CAAC,IAAI,CAAC,yBAAyB,6BAA6B,EAAE,CAAC,CAAA;IACnE,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY,EAAE,KAAa;IACzD,OAAO,KAAK,IAAI,IAAI,KAAK,EAAE,CAAA;AAC7B,CAAC"}

package/lib/unit.d.ts

@@ -0,0 +1,47 @@
+/**
+ * One opened SQLite KV unit: prepared per-table statements over the
+ * `u_<unit>_<table>` record tables plus this unit's row in the shared
+ * `unit_globals` table. Each primitive is a single statement, so atomicity
+ * comes from SQLite itself — no explicit transactions, and no write queue
+ * (write ordering is the caller's responsibility per the KV contract).
+ * @module @flowot/nx-pn-storage-sqlite/unit
+ */
+import type { DatabaseSync } from 'node:sqlite';
+import type { KvUnit, KvUnitDescriptor } from '@flowot/nx-pn-storage';
+/**
+ * The SQLite {@link KvUnit}. Constructed by the backend AFTER the unit's
+ * record tables exist; statements are prepared once here and reused for every
+ * primitive. Values are stored as JSON text in the `value` column.
+ */
+export declare class SqliteKvUnit implements KvUnit {
+    private readonly descriptor;
+    private readonly onClose;
+    private readonly tables;
+    private readonly globalUpsert;
+    private readonly globalSelect;
+    private closed;
+    /**
+     * @param db - Open database handle owned by the backend (never closed here).
+     * @param descriptor - Validated descriptor whose record tables already exist.
+     * @param onClose - Backend callback releasing this unit's open-name slot.
+     */
+    constructor(db: DatabaseSync, descriptor: KvUnitDescriptor, onClose: () => void);
+    loadAll(): Promise<{
+        tables: Record<string, Record<string, unknown>>;
+        global: unknown;
+    }>;
+    /** Parse one stored value column, mapping bad JSON to `malformed-medium`. */
+    private parseValue;
+    putRecord(table: string, key: string, value: unknown): Promise<void>;
+    deleteRecord(table: string, key: string): Promise<void>;
+    setGlobal(value: unknown): Promise<void>;
+    close(): Promise<void>;
+    /**
+     * Run one synchronous primitive behind the closed guard, mapping a throw to
+     * a rejection so the Promise-returning contract never throws synchronously.
+     */
+    private settle;
+    private ensureOpen;
+    private statementsFor;
+}
+//# sourceMappingURL=unit.d.ts.map

package/lib/unit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unit.d.ts","sourceRoot":"","sources":["../src/unit.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAiB,MAAM,aAAa,CAAA;AAE9D,OAAO,KAAK,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AAUrE;;;;GAIG;AACH,qBAAa,YAAa,YAAW,MAAM;IAavC,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,OAAO;IAb1B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqC;IAC5D,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA2B;IACxD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA2B;IACxD,OAAO,CAAC,MAAM,CAAQ;IAEtB;;;;OAIG;gBAED,EAAE,EAAE,YAAY,EACC,UAAU,EAAE,gBAAgB,EAC5B,OAAO,EAAE,MAAM,IAAI;IAwBtC,OAAO,IAAI,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;QAAC,MAAM,EAAE,OAAO,CAAA;KAAE,CAAC;IAqBxF,6EAA6E;IAC7E,OAAO,CAAC,UAAU;IAYlB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAMpE,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMvD,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IASxC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAQtB;;;OAGG;IACH,OAAO,CAAC,MAAM;IAWd,OAAO,CAAC,UAAU;IAMlB,OAAO,CAAC,aAAa;CAOtB"}

package/lib/unit.js

@@ -0,0 +1,131 @@
+/**
+ * One opened SQLite KV unit: prepared per-table statements over the
+ * `u_<unit>_<table>` record tables plus this unit's row in the shared
+ * `unit_globals` table. Each primitive is a single statement, so atomicity
+ * comes from SQLite itself — no explicit transactions, and no write queue
+ * (write ordering is the caller's responsibility per the KV contract).
+ * @module @flowot/nx-pn-storage-sqlite/unit
+ */
+import { StorageError } from '@flowot/nx-pn-storage';
+import { recordTableName } from './schema.js';
+/**
+ * The SQLite {@link KvUnit}. Constructed by the backend AFTER the unit's
+ * record tables exist; statements are prepared once here and reused for every
+ * primitive. Values are stored as JSON text in the `value` column.
+ */
+export class SqliteKvUnit {
+    descriptor;
+    onClose;
+    tables = new Map();
+    globalUpsert;
+    globalSelect;
+    closed = false;
+    /**
+     * @param db - Open database handle owned by the backend (never closed here).
+     * @param descriptor - Validated descriptor whose record tables already exist.
+     * @param onClose - Backend callback releasing this unit's open-name slot.
+     */
+    constructor(db, descriptor, onClose) {
+        this.descriptor = descriptor;
+        this.onClose = onClose;
+        for (const table of descriptor.tables) {
+            // Both name segments are validated against UNIT_NAME_RE by the backend,
+            // so the physical identifier is safe to interpolate into statement text.
+            const physical = recordTableName(descriptor.name, table);
+            this.tables.set(table, {
+                upsert: db.prepare(`INSERT INTO "${physical}" (key, value) VALUES (?, ?) ON CONFLICT(key) DO UPDATE SET value = excluded.value`),
+                remove: db.prepare(`DELETE FROM "${physical}" WHERE key = ?`),
+                selectAll: db.prepare(`SELECT key, value FROM "${physical}"`),
+            });
+        }
+        this.globalUpsert = descriptor.hasGlobal
+            ? db.prepare('INSERT INTO unit_globals (unit, value) VALUES (?, ?) ON CONFLICT(unit) DO UPDATE SET value = excluded.value')
+            : undefined;
+        this.globalSelect = descriptor.hasGlobal
+            ? db.prepare('SELECT value FROM unit_globals WHERE unit = ?')
+            : undefined;
+    }
+    loadAll() {
+        return this.settle(() => {
+            const tables = {};
+            for (const [name, statements] of this.tables) {
+                // Null prototype: record keys are arbitrary strings, so '__proto__'
+                // must land as an own property instead of mutating the prototype.
+                const records = Object.create(null);
+                for (const row of statements.selectAll.all()) {
+                    records[row.key] = this.parseValue(row.value, `table '${name}' key '${row.key}'`);
+                }
+                tables[name] = records;
+            }
+            let global = null;
+            if (this.globalSelect !== undefined) {
+                const row = this.globalSelect.get(this.descriptor.name);
+                if (row !== undefined)
+                    global = this.parseValue(row.value, 'global slot');
+            }
+            return { tables, global };
+        });
+    }
+    /** Parse one stored value column, mapping bad JSON to `malformed-medium`. */
+    parseValue(text, slot) {
+        try {
+            return JSON.parse(text);
+        }
+        catch (error) {
+            throw new StorageError('malformed-medium', `kv unit '${this.descriptor.name}' holds unparsable JSON at ${slot}`, { cause: error });
+        }
+    }
+    putRecord(table, key, value) {
+        return this.settle(() => {
+            this.statementsFor(table).upsert.run(key, JSON.stringify(value));
+        });
+    }
+    deleteRecord(table, key) {
+        return this.settle(() => {
+            this.statementsFor(table).remove.run(key);
+        });
+    }
+    setGlobal(value) {
+        return this.settle(() => {
+            if (this.globalUpsert === undefined) {
+                throw new Error(`kv unit '${this.descriptor.name}' declared no global slot`);
+            }
+            this.globalUpsert.run(this.descriptor.name, JSON.stringify(value));
+        });
+    }
+    close() {
+        if (!this.closed) {
+            this.closed = true;
+            this.onClose();
+        }
+        return Promise.resolve();
+    }
+    /**
+     * Run one synchronous primitive behind the closed guard, mapping a throw to
+     * a rejection so the Promise-returning contract never throws synchronously.
+     */
+    settle(operation) {
+        try {
+            this.ensureOpen();
+            return Promise.resolve(operation());
+        }
+        catch (error) {
+            // Non-Error throws can only enter through JSON.stringify propagating a
+            // value's own toJSON throw; wrap those, preserve every real Error.
+            return Promise.reject(error instanceof Error ? error : new Error(String(error)));
+        }
+    }
+    ensureOpen() {
+        if (this.closed) {
+            throw new StorageError('closed', `kv unit '${this.descriptor.name}' is closed`);
+        }
+    }
+    statementsFor(table) {
+        const statements = this.tables.get(table);
+        if (statements === undefined) {
+            throw new Error(`kv unit '${this.descriptor.name}' declared no table '${table}'`);
+        }
+        return statements;
+    }
+}
+//# sourceMappingURL=unit.js.map

package/lib/unit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unit.js","sourceRoot":"","sources":["../src/unit.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAA;AAEpD,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAS7C;;;;GAIG;AACH,MAAM,OAAO,YAAY;IAaJ;IACA;IAbF,MAAM,GAAG,IAAI,GAAG,EAA2B,CAAA;IAC3C,YAAY,CAA2B;IACvC,YAAY,CAA2B;IAChD,MAAM,GAAG,KAAK,CAAA;IAEtB;;;;OAIG;IACH,YACE,EAAgB,EACC,UAA4B,EAC5B,OAAmB;QADnB,eAAU,GAAV,UAAU,CAAkB;QAC5B,YAAO,GAAP,OAAO,CAAY;QAEpC,KAAK,MAAM,KAAK,IAAI,UAAU,CAAC,MAAM,EAAE,CAAC;YACtC,wEAAwE;YACxE,yEAAyE;YACzE,MAAM,QAAQ,GAAG,eAAe,CAAC,UAAU,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;YACxD,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE;gBACrB,MAAM,EAAE,EAAE,CAAC,OAAO,CAChB,gBAAgB,QAAQ,oFAAoF,CAC7G;gBACD,MAAM,EAAE,EAAE,CAAC,OAAO,CAAC,gBAAgB,QAAQ,iBAAiB,CAAC;gBAC7D,SAAS,EAAE,EAAE,CAAC,OAAO,CAAC,2BAA2B,QAAQ,GAAG,CAAC;aAC9D,CAAC,CAAA;QACJ,CAAC;QACD,IAAI,CAAC,YAAY,GAAG,UAAU,CAAC,SAAS;YACtC,CAAC,CAAC,EAAE,CAAC,OAAO,CACV,6GAA6G,CAC9G;YACD,CAAC,CAAC,SAAS,CAAA;QACb,IAAI,CAAC,YAAY,GAAG,UAAU,CAAC,SAAS;YACtC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,+CAA+C,CAAC;YAC7D,CAAC,CAAC,SAAS,CAAA;IACf,CAAC;IAED,OAAO;QACL,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE;YACtB,MAAM,MAAM,GAA4C,EAAE,CAAA;YAC1D,KAAK,MAAM,CAAC,IAAI,EAAE,UAAU,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;gBAC7C,oEAAoE;gBACpE,kEAAkE;gBAClE,MAAM,OAAO,GAA4B,MAAM,CAAC,MAAM,CAAC,IAAI,CAA4B,CAAA;gBACvF,KAAK,MAAM,GAAG,IAAI,UAAU,CAAC,SAAS,CAAC,GAAG,EAAsD,EAAE,CAAC;oBACjG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,EAAE,UAAU,IAAI,UAAU,GAAG,CAAC,GAAG,GAAG,CAAC,CAAA;gBACnF,CAAC;gBACD,MAAM,CAAC,IAAI,CAAC,GAAG,OAAO,CAAA;YACxB,CAAC;YACD,IAAI,MAAM,GAAY,IAAI,CAAA;YAC1B,IAAI,IAAI,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;gBACpC,MAAM,GAAG,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAkC,CAAA;gBACxF,IAAI,GAAG,KAAK,SAAS;oBAAE,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,EAAE,aAAa,CAAC,CAAA;YAC3E,CAAC;YACD,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,CAAA;QAC3B,CAAC,CAAC,CAAA;IACJ,CAAC;IAED,6EAA6E;IACrE,UAAU,CAAC,IAAY,EAAE,IAAY;QAC3C,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;QACzB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,YAAY,CACpB,kBAAkB,EAClB,YAAY,IAAI,CAAC,UAAU,CAAC,IAAI,8BAA8B,IAAI,EAAE,EACpE,EAAE,KAAK,EAAE,KAAK,EAAE,CACjB,CAAA;QACH,CAAC;IACH,CAAC;IAED,SAAS,CAAC,KAAa,EAAE,GAAW,EAAE,KAAc;QAClD,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE;YACtB,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAA;QAClE,CAAC,CAAC,CAAA;IACJ,CAAC;IAED,YAAY,CAAC,KAAa,EAAE,GAAW;QACrC,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE;YACtB,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;QAC3C,CAAC,CAAC,CAAA;IACJ,CAAC;IAED,SAAS,CAAC,KAAc;QACtB,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE;YACtB,IAAI,IAAI,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;gBACpC,MAAM,IAAI,KAAK,CAAC,YAAY,IAAI,CAAC,UAAU,CAAC,IAAI,2BAA2B,CAAC,CAAA;YAC9E,CAAC;YACD,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAA;QACpE,CAAC,CAAC,CAAA;IACJ,CAAC;IAED,KAAK;QACH,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACjB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAA;YAClB,IAAI,CAAC,OAAO,EAAE,CAAA;QAChB,CAAC;QACD,OAAO,OAAO,CAAC,OAAO,EAAE,CAAA;IAC1B,CAAC;IAED;;;OAGG;IACK,MAAM,CAAI,SAAkB;QAClC,IAAI,CAAC;YACH,IAAI,CAAC,UAAU,EAAE,CAAA;YACjB,OAAO,OAAO,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC,CAAA;QACrC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,uEAAuE;YACvE,mEAAmE;YACnE,OAAO,OAAO,CAAC,MAAM,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;QAClF,CAAC;IACH,CAAC;IAEO,UAAU;QAChB,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,MAAM,IAAI,YAAY,CAAC,QAAQ,EAAE,YAAY,IAAI,CAAC,UAAU,CAAC,IAAI,aAAa,CAAC,CAAA;QACjF,CAAC;IACH,CAAC;IAEO,aAAa,CAAC,KAAa;QACjC,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;QACzC,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CAAC,YAAY,IAAI,CAAC,UAAU,CAAC,IAAI,wBAAwB,KAAK,GAAG,CAAC,CAAA;QACnF,CAAC;QACD,OAAO,UAAU,CAAA;IACnB,CAAC;CACF"}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@flowot/nx-pn-storage-sqlite",
+  "version": "0.3.0",
+  "description": "SQLite storage backend (document-per-row KV) for the nx-pn storage hub, via node:sqlite (dsh storage-family port)",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/On-DevPlan/nx-pn.git",
+    "directory": "packages/storage/storage-sqlite"
+  },
+  "type": "module",
+  "main": "./lib/index.js",
+  "types": "./lib/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib",
+    "!lib/*.tsbuildinfo"
+  ],
+  "dependencies": {
+    "@flowot/nx-pn-storage": "^0.3.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.7.0",
+    "typescript": "5.6.3",
+    "vitest": "^3.2.4",
+    "vite": "^6.0.0"
+  },
+  "scripts": {
+    "build": "tsc -b",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "tsc --noEmit"
+  }
+}