@descryy/core 0.1.0

package/dist/sources/workspace/workspace.js

@@ -0,0 +1,294 @@
+/**
+ * The workspace declaration — DEC-075 §7.
+ *
+ * A multi-repo or monorepo run needs two facts a graph cannot supply on its
+ * own: which package roots exist, and which of them are meant to talk to
+ * each other. `descry.json` at the repository root is where both are
+ * declared, with an optional `descry` key inside `package.json` or
+ * `pyproject.toml` for a project that would rather not add a file. The root
+ * file wins where more than one location is present — it is the one
+ * location that works for a locally installed tool with no hosted backend,
+ * and it is greppable.
+ *
+ * ## Nx, Turborepo, pnpm and npm workspaces are read for the package LIST,
+ * ## and never for a pairing
+ *
+ * Enumerating packages from a workspace manifest is reading a declaration —
+ * the manifest states which directories are packages, so there is nothing to
+ * infer. Deciding that `apps/web` talks to `apps/api` is a name inference,
+ * and the correct mechanism already exists one layer up: a pairing is either
+ * declared here, in `descry.json`, or it falls out of a real
+ * `USES_API`/`SERVES_API` join at R3. This module supplies the declared half
+ * only; it does not guess a pairing from two directory names that sound
+ * related, for the same reason a Python `Company` must not join a
+ * TypeScript `Company` on a shared word.
+ *
+ * ## Precision over recall in the glob reader
+ *
+ * `workspaces` in `package.json` and `packages:` in `pnpm-workspace.yaml`
+ * hold globs, not paths. Only the one shape actually used across real
+ * monorepos in this project's own reference set — `dir/*`, one segment of
+ * wildcard at the end — is expanded, by listing `dir`'s subdirectories that
+ * themselves contain a `package.json`. A more elaborate glob (`**`, a
+ * mid-path wildcard, a negation) is left unexpanded and disclosed on
+ * `unexpandedGlobs` rather than approximated — an approximated package list
+ * silently mis-scopes every check that follows it.
+ */
+import { existsSync, readFileSync, readdirSync, statSync } from "node:fs";
+import { join } from "node:path";
+const toForwardSlash = (p) => p.replace(/\\/g, "/");
+function readJson(path) {
+    try {
+        return JSON.parse(readFileSync(path, "utf8"));
+    }
+    catch {
+        return undefined;
+    }
+}
+/** A pairing entry as `descry.json` or `package.json#descry` may spell it. */
+function readPairings(value) {
+    if (!Array.isArray(value))
+        return [];
+    const pairings = [];
+    for (const entry of value) {
+        if (entry === null || typeof entry !== "object")
+            continue;
+        const from = entry.from;
+        const to = entry.to;
+        if (typeof from === "string" && typeof to === "string")
+            pairings.push({ from, to });
+    }
+    return pairings;
+}
+function readPackages(value) {
+    if (!Array.isArray(value))
+        return undefined;
+    return value.filter((p) => typeof p === "string").map(toForwardSlash);
+}
+/**
+ * `[tool.descry]` inside `pyproject.toml`, read narrowly. This is not a TOML
+ * parser: it recognises exactly `packages = [...]` and a `pairings` array of
+ * inline `{ from = "...", to = "..." }` tables, both on lines belonging to
+ * the `[tool.descry]` table, and refuses (returns `undefined`) on anything
+ * it is not confident it read correctly — a wrong read here silently
+ * mis-scopes a whole run, so guessing is the wrong trade.
+ */
+function readPyprojectDescry(root) {
+    const path = join(root, "pyproject.toml");
+    if (!existsSync(path))
+        return undefined;
+    let text;
+    try {
+        text = readFileSync(path, "utf8");
+    }
+    catch {
+        return undefined;
+    }
+    const lines = text.split("\n");
+    let inTable = false;
+    let packages;
+    const pairings = [];
+    for (const raw of lines) {
+        const line = raw.trim();
+        if (/^\[.*\]$/.test(line)) {
+            inTable = line === "[tool.descry]";
+            continue;
+        }
+        if (!inTable)
+            continue;
+        const packagesMatch = /^packages\s*=\s*(\[.*\])\s*$/.exec(line);
+        const packagesGroup = packagesMatch?.[1];
+        if (packagesGroup !== undefined) {
+            const arr = tryParseJsonArray(packagesGroup);
+            if (arr !== undefined)
+                packages = readPackages(arr);
+            continue;
+        }
+        const pairingsMatch = /^pairings\s*=\s*\[(.*)\]\s*$/.exec(line);
+        const pairingsGroup = pairingsMatch?.[1];
+        if (pairingsGroup !== undefined) {
+            // `{ from = "a", to = "b" }, { from = "c", to = "d" }` — TOML inline
+            // tables use `=`, JSON uses `:`; translate the narrow shape this
+            // reader accepts rather than reaching for a general parser.
+            const asJson = `[${pairingsGroup.replace(/(\bfrom\s*=|\bto\s*=)/g, (m) => (m.startsWith("from") ? '"from":' : '"to":'))}]`;
+            const arr = tryParseJsonArray(asJson);
+            if (arr !== undefined)
+                pairings.push(...readPairings(arr));
+        }
+    }
+    if (packages === undefined && pairings.length === 0)
+        return undefined;
+    return { packages, pairings };
+}
+function tryParseJsonArray(text) {
+    try {
+        const parsed = JSON.parse(text.replace(/'/g, '"'));
+        return Array.isArray(parsed) ? parsed : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+function readDescryJson(root) {
+    const path = join(root, "descry.json");
+    if (!existsSync(path))
+        return undefined;
+    const parsed = readJson(path);
+    if (parsed === undefined || typeof parsed !== "object" || parsed === null)
+        return undefined;
+    const obj = parsed;
+    return { packages: readPackages(obj.packages), pairings: readPairings(obj.pairings) };
+}
+function readPackageJsonDescry(root) {
+    const path = join(root, "package.json");
+    if (!existsSync(path))
+        return undefined;
+    const parsed = readJson(path);
+    if (parsed === undefined || typeof parsed !== "object" || parsed === null)
+        return undefined;
+    const descry = parsed.descry;
+    if (descry === undefined || typeof descry !== "object" || descry === null)
+        return undefined;
+    const obj = descry;
+    return { packages: readPackages(obj.packages), pairings: readPairings(obj.pairings) };
+}
+/** `dir/*` only — the one glob shape this project's own reference monorepos actually use. */
+function expandSingleStarGlob(root, glob) {
+    if (!glob.endsWith("/*") || glob.slice(0, -2).includes("*"))
+        return { unexpanded: true };
+    const dir = glob.slice(0, -2);
+    const abs = join(root, dir);
+    if (!existsSync(abs) || !statSync(abs).isDirectory())
+        return { expanded: [] };
+    const expanded = [];
+    for (const entry of readdirSync(abs, { withFileTypes: true })) {
+        if (!entry.isDirectory())
+            continue;
+        if (existsSync(join(abs, entry.name, "package.json")))
+            expanded.push(toForwardSlash(join(dir, entry.name)));
+    }
+    return { expanded };
+}
+function readPackageListFromManifests(root) {
+    const pkgJsonPath = join(root, "package.json");
+    if (existsSync(pkgJsonPath)) {
+        const parsed = readJson(pkgJsonPath);
+        if (parsed !== undefined && typeof parsed === "object" && parsed !== null) {
+            const ws = parsed.workspaces;
+            const globs = Array.isArray(ws)
+                ? ws.filter((g) => typeof g === "string")
+                : ws !== null && typeof ws === "object" && Array.isArray(ws.packages)
+                    ? ws.packages.filter((g) => typeof g === "string")
+                    : undefined;
+            if (globs !== undefined) {
+                const packages = [];
+                const unexpanded = [];
+                for (const g of globs) {
+                    if (!g.includes("*")) {
+                        packages.push(toForwardSlash(g));
+                        continue;
+                    }
+                    const r = expandSingleStarGlob(root, g);
+                    if ("unexpanded" in r)
+                        unexpanded.push(g);
+                    else
+                        packages.push(...r.expanded);
+                }
+                return { packages, source: "package.json#workspaces", unexpandedGlobs: unexpanded };
+            }
+        }
+    }
+    const pnpmPath = join(root, "pnpm-workspace.yaml");
+    if (existsSync(pnpmPath)) {
+        let text;
+        try {
+            text = readFileSync(pnpmPath, "utf8");
+        }
+        catch {
+            text = "";
+        }
+        const lines = text.split("\n");
+        let inPackages = false;
+        const globs = [];
+        for (const raw of lines) {
+            if (/^packages\s*:\s*$/.test(raw.trim())) {
+                inPackages = true;
+                continue;
+            }
+            if (inPackages) {
+                const m = /^\s*-\s*['"]?([^'"]+?)['"]?\s*$/.exec(raw);
+                const glob = m?.[1];
+                if (glob !== undefined) {
+                    globs.push(glob);
+                    continue;
+                }
+                if (raw.trim() !== "")
+                    inPackages = false; // a dedented, non-list line ends the block
+            }
+        }
+        const packages = [];
+        const unexpanded = [];
+        for (const g of globs) {
+            if (!g.includes("*")) {
+                packages.push(toForwardSlash(g));
+                continue;
+            }
+            const r = expandSingleStarGlob(root, g);
+            if ("unexpanded" in r)
+                unexpanded.push(g);
+            else
+                packages.push(...r.expanded);
+        }
+        return { packages, source: "pnpm-workspace.yaml", unexpandedGlobs: unexpanded };
+    }
+    return { packages: [], source: "none", unexpandedGlobs: [] };
+}
+/**
+ * Resolve `root`'s workspace declaration: which packages it holds and which
+ * of them are declared as talking to each other. `descry.json` wins over a
+ * `package.json#descry` key, which wins over `pyproject.toml`'s
+ * `[tool.descry]` table; the first one found is used whole, never merged
+ * across locations — a package list assembled from two files is a package
+ * list nobody wrote down.
+ */
+export function resolveWorkspace(root) {
+    let raw;
+    let declarationSource;
+    const fromDescryJson = readDescryJson(root);
+    if (fromDescryJson !== undefined) {
+        raw = fromDescryJson;
+        declarationSource = "descry.json";
+    }
+    else {
+        const fromPackageJson = readPackageJsonDescry(root);
+        if (fromPackageJson !== undefined) {
+            raw = fromPackageJson;
+            declarationSource = "package.json#descry";
+        }
+        else {
+            const fromPyproject = readPyprojectDescry(root);
+            raw = fromPyproject;
+            declarationSource = fromPyproject !== undefined ? "pyproject.toml#tool.descry" : "none";
+        }
+    }
+    if (raw?.packages !== undefined) {
+        return {
+            root,
+            declarationSource,
+            packages: raw.packages,
+            packagesSource: "declared",
+            pairings: raw.pairings,
+            unexpandedGlobs: [],
+        };
+    }
+    const fromManifests = readPackageListFromManifests(root);
+    return {
+        root,
+        declarationSource,
+        packages: fromManifests.packages,
+        packagesSource: fromManifests.source,
+        pairings: raw?.pairings ?? [],
+        unexpandedGlobs: fromManifests.unexpandedGlobs,
+    };
+}
+//# sourceMappingURL=workspace.js.map

package/dist/sources/workspace/workspace.js.map

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

package/dist/store/driver/driver.d.ts

@@ -0,0 +1,82 @@
+/**
+ * The SQL driver interface — DEC-018.
+ *
+ * `node:sqlite` is an experimental API on an LTS runtime: it landed in 22.5 and
+ * its surface has moved across 22.x minors. That is an acceptable risk *behind
+ * an interface* and an unacceptable one spread through the engine, which is the
+ * only reason this file exists. A later swap to `better-sqlite3`, `libsql` or a
+ * Postgres-backed driver should be a day's work, and `driver.contract.test.ts`
+ * is what makes that estimate real rather than hopeful.
+ *
+ * Three of the nine methods are NOT thin delegations, verified against Node
+ * v22.23.1: `DatabaseSync` has no `transaction`, no `pragma` and no `backup`.
+ * Those are better-sqlite3 idioms. They are part of this interface anyway
+ * because every engine caller needs them and every driver can implement them —
+ * putting them here is what stops `BEGIN`/`COMMIT` string handling leaking into
+ * the writer.
+ */
+/** Everything SQLite can bind. Deliberately narrow — no implicit coercion. */
+export type SqlParam = null | number | bigint | string | Uint8Array;
+export interface RunResult {
+    readonly changes: number;
+    readonly lastInsertRowid: number | bigint;
+}
+export interface SqlStatement<Row = Record<string, unknown>> {
+    all(...params: SqlParam[]): Row[];
+    get(...params: SqlParam[]): Row | undefined;
+    run(...params: SqlParam[]): RunResult;
+    /** Streams rows. Use for large result sets so a traversal never materialises a whole table. */
+    iterate(...params: SqlParam[]): IterableIterator<Row>;
+}
+export interface OpenOptions {
+    /**
+     * Write-ahead logging. On by default: the traversal worker holds a read-only
+     * handle (the plan's Step 10), and without WAL a writer blocks every reader,
+     * which is exactly the stall that breaks streaming-first.
+     *
+     * Ignored for `:memory:`, where SQLite has no journal to write ahead to.
+     */
+    readonly wal?: boolean;
+    readonly readOnly?: boolean;
+}
+export interface DriverVersion {
+    /** Which implementation is behind the interface, e.g. `node-sqlite`. */
+    readonly driver: string;
+    /** The underlying engine version, e.g. `3.51.3`. */
+    readonly engine: string;
+}
+export interface SqlDriver {
+    open(path: string, options?: OpenOptions): void;
+    close(): void;
+    exec(sql: string): void;
+    prepare<Row = Record<string, unknown>>(sql: string): SqlStatement<Row>;
+    /**
+     * Run `fn` inside a transaction, committing on return and rolling back on
+     * throw. Nesting uses SAVEPOINT, so a nested failure unwinds to its own entry
+     * point rather than aborting the outer transaction.
+     *
+     * Synchronous on purpose. `node:sqlite` is a synchronous API, and an `async`
+     * callback here would let unrelated work interleave inside the transaction
+     * while still looking atomic.
+     */
+    transaction<T>(fn: () => T): T;
+    /** `pragma("journal_mode")` reads; `pragma("journal_mode = WAL")` sets. */
+    pragma<T = unknown>(statement: string): T | undefined;
+    loadExtension(path: string): void;
+    backup(destinationPath: string): Promise<void>;
+    version(): DriverVersion;
+}
+/**
+ * Thrown for driver-layer failures so callers never have to match on engine text.
+ *
+ * Declared as a field plus a constructor-body assignment rather than a parameter
+ * property: parameter properties are not erasable syntax, so Node's type
+ * stripping cannot run them (tsconfig `erasableSyntaxOnly`, echoed by the lint).
+ */
+export declare class DriverError extends Error {
+    readonly name = "DriverError";
+    constructor(message: string, options?: {
+        cause?: unknown;
+    });
+}
+//# sourceMappingURL=driver.d.ts.map

package/dist/store/driver/driver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"driver.d.ts","sourceRoot":"","sources":["../../../src/store/driver/driver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,8EAA8E;AAC9E,MAAM,MAAM,QAAQ,GAAG,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,UAAU,CAAC;AAEpE,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,eAAe,EAAE,MAAM,GAAG,MAAM,CAAC;CAC3C;AAED,MAAM,WAAW,YAAY,CAAC,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACzD,GAAG,CAAC,GAAG,MAAM,EAAE,QAAQ,EAAE,GAAG,GAAG,EAAE,CAAC;IAClC,GAAG,CAAC,GAAG,MAAM,EAAE,QAAQ,EAAE,GAAG,GAAG,GAAG,SAAS,CAAC;IAC5C,GAAG,CAAC,GAAG,MAAM,EAAE,QAAQ,EAAE,GAAG,SAAS,CAAC;IACtC,+FAA+F;IAC/F,OAAO,CAAC,GAAG,MAAM,EAAE,QAAQ,EAAE,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC;CACvD;AAED,MAAM,WAAW,WAAW;IAC1B;;;;;;OAMG;IACH,QAAQ,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,WAAW,aAAa;IAC5B,wEAAwE;IACxE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,oDAAoD;IACpD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;IAChD,KAAK,IAAI,IAAI,CAAC;IACd,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,OAAO,CAAC,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;IAEvE;;;;;;;;OAQG;IACH,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;IAE/B,2EAA2E;IAC3E,MAAM,CAAC,CAAC,GAAG,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAAC;IAEtD,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,MAAM,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/C,OAAO,IAAI,aAAa,CAAC;CAC1B;AAED;;;;;;GAMG;AACH,qBAAa,WAAY,SAAQ,KAAK;IACpC,SAAkB,IAAI,iBAAiB;gBAE3B,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAG3D"}

package/dist/store/driver/driver.js

@@ -0,0 +1,31 @@
+/**
+ * The SQL driver interface — DEC-018.
+ *
+ * `node:sqlite` is an experimental API on an LTS runtime: it landed in 22.5 and
+ * its surface has moved across 22.x minors. That is an acceptable risk *behind
+ * an interface* and an unacceptable one spread through the engine, which is the
+ * only reason this file exists. A later swap to `better-sqlite3`, `libsql` or a
+ * Postgres-backed driver should be a day's work, and `driver.contract.test.ts`
+ * is what makes that estimate real rather than hopeful.
+ *
+ * Three of the nine methods are NOT thin delegations, verified against Node
+ * v22.23.1: `DatabaseSync` has no `transaction`, no `pragma` and no `backup`.
+ * Those are better-sqlite3 idioms. They are part of this interface anyway
+ * because every engine caller needs them and every driver can implement them —
+ * putting them here is what stops `BEGIN`/`COMMIT` string handling leaking into
+ * the writer.
+ */
+/**
+ * Thrown for driver-layer failures so callers never have to match on engine text.
+ *
+ * Declared as a field plus a constructor-body assignment rather than a parameter
+ * property: parameter properties are not erasable syntax, so Node's type
+ * stripping cannot run them (tsconfig `erasableSyntaxOnly`, echoed by the lint).
+ */
+export class DriverError extends Error {
+    name = "DriverError";
+    constructor(message, options) {
+        super(message, options);
+    }
+}
+//# sourceMappingURL=driver.js.map

package/dist/store/driver/driver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"driver.js","sourceRoot":"","sources":["../../../src/store/driver/driver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AA8DH;;;;;;GAMG;AACH,MAAM,OAAO,WAAY,SAAQ,KAAK;IAClB,IAAI,GAAG,aAAa,CAAC;IAEvC,YAAY,OAAe,EAAE,OAA6B;QACxD,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC1B,CAAC;CACF"}

package/dist/store/driver/node-sqlite.d.ts

@@ -0,0 +1,28 @@
+/**
+ * The `node:sqlite` driver — the only file in the engine that imports it.
+ *
+ * Two hazards live here and nowhere else, both verified on Node v22.23.1:
+ *
+ *  1. **Rows come back with a null prototype.** `hasOwnProperty`, `instanceof`
+ *     and anything walking the prototype chain break on them, and the failure
+ *     is remote from the cause. Every row is copied into an ordinary object
+ *     before it leaves this file. DEC-018 states the rule; the contract suite
+ *     enforces it.
+ *  2. **`DatabaseSync` has no `transaction`, `pragma` or `backup`.** Those are
+ *     better-sqlite3 idioms. They are synthesised below so that no caller ever
+ *     writes `BEGIN` as a string.
+ */
+import { type DriverVersion, type OpenOptions, type SqlDriver, type SqlStatement } from "./driver.ts";
+export declare class NodeSqliteDriver implements SqlDriver {
+    #private;
+    open(path: string, options?: OpenOptions): void;
+    close(): void;
+    exec(sql: string): void;
+    prepare<Row = Record<string, unknown>>(sql: string): SqlStatement<Row>;
+    transaction<T>(fn: () => T): T;
+    pragma<T = unknown>(statement: string): T | undefined;
+    loadExtension(path: string): void;
+    backup(destinationPath: string): Promise<void>;
+    version(): DriverVersion;
+}
+//# sourceMappingURL=node-sqlite.d.ts.map

package/dist/store/driver/node-sqlite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-sqlite.d.ts","sourceRoot":"","sources":["../../../src/store/driver/node-sqlite.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,WAAW,EAEhB,KAAK,SAAS,EAEd,KAAK,YAAY,EAClB,MAAM,aAAa,CAAC;AAwCrB,qBAAa,gBAAiB,YAAW,SAAS;;IAUhD,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,IAAI;IAsBnD,KAAK,IAAI,IAAI;IAOb,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAQvB,OAAO,CAAC,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,YAAY,CAAC,GAAG,CAAC;IAQtE,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC;IA0B9B,MAAM,CAAC,CAAC,GAAG,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAqBrD,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAgB3B,MAAM,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQpD,OAAO,IAAI,aAAa;CAKzB"}

package/dist/store/driver/node-sqlite.js

@@ -0,0 +1,188 @@
+/**
+ * The `node:sqlite` driver — the only file in the engine that imports it.
+ *
+ * Two hazards live here and nowhere else, both verified on Node v22.23.1:
+ *
+ *  1. **Rows come back with a null prototype.** `hasOwnProperty`, `instanceof`
+ *     and anything walking the prototype chain break on them, and the failure
+ *     is remote from the cause. Every row is copied into an ordinary object
+ *     before it leaves this file. DEC-018 states the rule; the contract suite
+ *     enforces it.
+ *  2. **`DatabaseSync` has no `transaction`, `pragma` or `backup`.** Those are
+ *     better-sqlite3 idioms. They are synthesised below so that no caller ever
+ *     writes `BEGIN` as a string.
+ */
+import { DatabaseSync, backup as sqliteBackup } from "node:sqlite";
+import { DriverError, } from "./driver.js";
+/**
+ * Copy a null-prototype row into an ordinary object.
+ *
+ * Shallow on purpose: SQLite returns flat rows of primitives, so there is no
+ * nesting to walk, and a deep clone would silently copy `Uint8Array` blobs.
+ */
+function rehydrate(row) {
+    return { ...row };
+}
+class NodeSqliteStatement {
+    #statement;
+    constructor(statement) {
+        this.#statement = statement;
+    }
+    all(...params) {
+        return this.#statement.all(...params).map((r) => rehydrate(r));
+    }
+    get(...params) {
+        const row = this.#statement.get(...params);
+        return row === undefined ? undefined : rehydrate(row);
+    }
+    run(...params) {
+        const result = this.#statement.run(...params);
+        return { changes: Number(result.changes), lastInsertRowid: result.lastInsertRowid };
+    }
+    *iterate(...params) {
+        for (const row of this.#statement.iterate(...params)) {
+            yield rehydrate(row);
+        }
+    }
+}
+export class NodeSqliteDriver {
+    #db = null;
+    /** SAVEPOINT depth, so nested transactions unwind to their own entry point. */
+    #depth = 0;
+    #require() {
+        if (this.#db === null)
+            throw new DriverError("driver is not open");
+        return this.#db;
+    }
+    open(path, options = {}) {
+        if (this.#db !== null)
+            throw new DriverError("driver is already open");
+        try {
+            this.#db = new DatabaseSync(path, { readOnly: options.readOnly ?? false });
+        }
+        catch (cause) {
+            throw new DriverError(`could not open database at ${path}`, { cause });
+        }
+        if (options.readOnly === true)
+            return;
+        // An in-memory database has no journal to write ahead to; asking for WAL
+        // there is silently ignored by SQLite, so skip it rather than pretend.
+        if ((options.wal ?? true) && path !== ":memory:") {
+            this.pragma("journal_mode = WAL");
+        }
+        // Without this, a concurrent reader gets SQLITE_BUSY immediately instead of
+        // waiting — which surfaces as a flaky failure the moment the traversal
+        // worker of Step 10 exists.
+        this.pragma("busy_timeout = 5000");
+        this.pragma("foreign_keys = ON");
+    }
+    close() {
+        if (this.#db === null)
+            return;
+        this.#db.close();
+        this.#db = null;
+        this.#depth = 0;
+    }
+    exec(sql) {
+        try {
+            this.#require().exec(sql);
+        }
+        catch (cause) {
+            throw new DriverError(`exec failed: ${firstLine(sql)}`, { cause });
+        }
+    }
+    prepare(sql) {
+        try {
+            return new NodeSqliteStatement(this.#require().prepare(sql));
+        }
+        catch (cause) {
+            throw new DriverError(`prepare failed: ${firstLine(sql)}`, { cause });
+        }
+    }
+    transaction(fn) {
+        const db = this.#require();
+        const nested = this.#depth > 0;
+        const name = `descry_sp_${this.#depth}`;
+        db.exec(nested ? `SAVEPOINT ${name}` : "BEGIN");
+        this.#depth += 1;
+        try {
+            const result = fn();
+            db.exec(nested ? `RELEASE ${name}` : "COMMIT");
+            return result;
+        }
+        catch (error) {
+            // If the rollback itself fails the connection is unusable; surfacing the
+            // original error is still the right call, because the rollback failure is
+            // a consequence of it rather than an independent fact.
+            try {
+                db.exec(nested ? `ROLLBACK TO ${name}; RELEASE ${name}` : "ROLLBACK");
+            }
+            catch {
+                /* deliberately swallowed — see above */
+            }
+            throw error;
+        }
+        finally {
+            this.#depth -= 1;
+        }
+    }
+    pragma(statement) {
+        const db = this.#require();
+        const sql = `PRAGMA ${statement}`;
+        // A setting pragma returns no rows; a reading one returns exactly one.
+        // `prepare().get()` covers both, but SQLite rejects some setting pragmas
+        // through the statement API, so fall back to exec.
+        try {
+            const row = db.prepare(sql).get();
+            if (row === undefined)
+                return undefined;
+            const values = Object.values(rehydrate(row));
+            return values[0];
+        }
+        catch {
+            try {
+                db.exec(sql);
+                return undefined;
+            }
+            catch (cause) {
+                throw new DriverError(`pragma failed: ${statement}`, { cause });
+            }
+        }
+    }
+    loadExtension(path) {
+        const db = this.#require();
+        try {
+            db.enableLoadExtension(true);
+            db.loadExtension(path);
+        }
+        catch (cause) {
+            throw new DriverError(`could not load extension ${path}`, { cause });
+        }
+        finally {
+            try {
+                db.enableLoadExtension(false);
+            }
+            catch {
+                /* the handle is already unusable if this throws */
+            }
+        }
+    }
+    async backup(destinationPath) {
+        try {
+            await sqliteBackup(this.#require(), destinationPath);
+        }
+        catch (cause) {
+            throw new DriverError(`backup to ${destinationPath} failed`, { cause });
+        }
+    }
+    version() {
+        const row = this.#require().prepare("SELECT sqlite_version() AS v").get();
+        const engine = rehydrate(row).v;
+        return { driver: "node-sqlite", engine: typeof engine === "string" ? engine : "unknown" };
+    }
+}
+function firstLine(sql) {
+    const line = sql.trim().split("\n", 1)[0] ?? "";
+    return line.length > 120 ? `${line.slice(0, 117)}...` : line;
+}
+//# sourceMappingURL=node-sqlite.js.map

package/dist/store/driver/node-sqlite.js.map

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