dirsql 0.3.17 → 0.3.19

package/dist/cli/die.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=die.test.d.ts.map

package/dist/cli/die.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"die.test.d.ts","sourceRoot":"","sources":["../../src/cli/die.test.ts"],"names":[],"mappings":""}

package/dist/cli/die.test.js

@@ -0,0 +1,29 @@
+// Unit tests for `die`.
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+import { die } from "./die.js";
+describe("die", () => {
+    let stderrWrite;
+    let exit;
+    beforeEach(() => {
+        stderrWrite = vi.fn();
+        exit = vi.fn().mockImplementation((code) => {
+            throw new Error(`EXIT_${code}`);
+        });
+        vi.stubGlobal("process", {
+            ...process,
+            stderr: { write: stderrWrite },
+            exit,
+        });
+    });
+    afterEach(() => vi.unstubAllGlobals());
+    it("writes a 'dirsql: ' prefixed message to stderr and exits with the given code", () => {
+        expect(() => die("boom", 2)).toThrow("EXIT_2");
+        expect(stderrWrite).toHaveBeenCalledWith("dirsql: boom\n");
+        expect(exit).toHaveBeenCalledWith(2);
+    });
+    it("defaults the exit code to 1", () => {
+        expect(() => die("boom")).toThrow("EXIT_1");
+        expect(exit).toHaveBeenCalledWith(1);
+    });
+});
+//# sourceMappingURL=die.test.js.map

package/dist/cli/die.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"die.test.js","sourceRoot":"","sources":["../../src/cli/die.test.ts"],"names":[],"mappings":"AAAA,wBAAwB;AAExB,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AACzE,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAE/B,QAAQ,CAAC,KAAK,EAAE,GAAG,EAAE;IACnB,IAAI,WAAqC,CAAC;IAC1C,IAAI,IAA8B,CAAC;IAEnC,UAAU,CAAC,GAAG,EAAE;QACd,WAAW,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;QACtB,IAAI,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,kBAAkB,CAAC,CAAC,IAAY,EAAE,EAAE;YACjD,MAAM,IAAI,KAAK,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;QAClC,CAAC,CAAC,CAAC;QACH,EAAE,CAAC,UAAU,CAAC,SAAS,EAAE;YACvB,GAAG,OAAO;YACV,MAAM,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE;YAC9B,IAAI;SACL,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,gBAAgB,EAAE,CAAC,CAAC;IAEvC,EAAE,CAAC,8EAA8E,EAAE,GAAG,EAAE;QACtF,MAAM,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QAC/C,MAAM,CAAC,WAAW,CAAC,CAAC,oBAAoB,CAAC,gBAAgB,CAAC,CAAC;QAC3D,MAAM,CAAC,IAAI,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6BAA6B,EAAE,GAAG,EAAE;QACrC,MAAM,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QAC5C,MAAM,CAAC,IAAI,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/cli/dirsql.js

@@ -10,5 +10,8 @@
 // guard silently skipped main() so `dirsql --version` produced no
 // output (caught by the pack-install build-CI smoke test).
 import { main } from "./main.js";
-main();
+main().catch((e) => {
+    process.stderr.write(`dirsql: ${e instanceof Error ? e.message : String(e)}\n`);
+    process.exit(1);
+});
 //# sourceMappingURL=dirsql.js.map

package/dist/cli/dirsql.js.map

@@ -1 +1 @@
-{"version":3,"file":"dirsql.js","sourceRoot":"","sources":["../../src/cli/dirsql.ts"],"names":[],"mappings":";AACA,uEAAuE;AACvE,6EAA6E;AAC7E,qEAAqE;AACrE,qEAAqE;AACrE,EAAE;AACF,oEAAoE;AACpE,oEAAoE;AACpE,oEAAoE;AACpE,kEAAkE;AAClE,2DAA2D;AAE3D,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,IAAI,EAAE,CAAC"}
+{"version":3,"file":"dirsql.js","sourceRoot":"","sources":["../../src/cli/dirsql.ts"],"names":[],"mappings":";AACA,uEAAuE;AACvE,6EAA6E;AAC7E,qEAAqE;AACrE,qEAAqE;AACrE,EAAE;AACF,oEAAoE;AACpE,oEAAoE;AACpE,oEAAoE;AACpE,kEAAkE;AAClE,2DAA2D;AAE3D,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,CAAU,EAAE,EAAE;IAC1B,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,WAAW,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAC1D,CAAC;IACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/cli/interpret/buildTables.d.ts

@@ -0,0 +1,3 @@
+import { type DirSQL, type TableDef } from "../../index.js";
+export declare function buildTables(app: DirSQL): Map<string, TableDef>;
+//# sourceMappingURL=buildTables.d.ts.map

package/dist/cli/interpret/buildTables.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildTables.d.ts","sourceRoot":"","sources":["../../../src/cli/interpret/buildTables.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,KAAK,MAAM,EAAE,KAAK,QAAQ,EAAkB,MAAM,gBAAgB,CAAC;AAE5E,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAU9D"}

package/dist/cli/interpret/buildTables.js

@@ -0,0 +1,18 @@
+// Build a `name -> TableDef` lookup the dispatcher can index by the
+// `table` field on each extract request. Table name comes from the
+// core's canonical `parseTableName` (Rust-side
+// `dirsql::db::parse_table_name`) so the JS side and the orchestrator
+// agree without a duplicate regex.
+import { parseTableName } from "../../index.js";
+export function buildTables(app) {
+    const out = new Map();
+    for (const t of app._options.tables ?? []) {
+        const name = parseTableName(t.ddl);
+        if (name === null) {
+            throw new Error(`could not parse table name from DDL: ${t.ddl}`);
+        }
+        out.set(name, t);
+    }
+    return out;
+}
+//# sourceMappingURL=buildTables.js.map

package/dist/cli/interpret/buildTables.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildTables.js","sourceRoot":"","sources":["../../../src/cli/interpret/buildTables.ts"],"names":[],"mappings":"AAAA,oEAAoE;AACpE,mEAAmE;AACnE,+CAA+C;AAC/C,sEAAsE;AACtE,mCAAmC;AAEnC,OAAO,EAA8B,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAE5E,MAAM,UAAU,WAAW,CAAC,GAAW;IACrC,MAAM,GAAG,GAAG,IAAI,GAAG,EAAoB,CAAC;IACxC,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,MAAM,IAAI,EAAE,EAAE,CAAC;QAC1C,MAAM,IAAI,GAAG,cAAc,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QACnC,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;YAClB,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;QACnE,CAAC;QACD,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IACnB,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/cli/interpret/buildTables.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=buildTables.test.d.ts.map

package/dist/cli/interpret/buildTables.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildTables.test.d.ts","sourceRoot":"","sources":["../../../src/cli/interpret/buildTables.test.ts"],"names":[],"mappings":""}

package/dist/cli/interpret/buildTables.test.js

@@ -0,0 +1,62 @@
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+import { __setCoreForTesting, } from "../../index.js";
+import { buildTables } from "./buildTables.js";
+const noopExtract = () => [];
+function fakeApp(tables) {
+    return { _options: { tables } };
+}
+describe("buildTables", () => {
+    beforeEach(() => {
+        __setCoreForTesting({
+            // biome-ignore lint/suspicious/noExplicitAny: minimal core stub
+            DirSQL: {},
+            parseTableName: vi
+                .fn()
+                .mockImplementation((ddl) => /CREATE\s+TABLE\s+(\w+)/i.exec(ddl)?.[1] ?? null),
+        });
+    });
+    afterEach(() => {
+        __setCoreForTesting(null);
+    });
+    it("returns an empty map when the app has no tables", () => {
+        expect(buildTables(fakeApp([]))).toEqual(new Map());
+    });
+    it("treats undefined tables as empty", () => {
+        expect(buildTables(fakeApp(undefined))).toEqual(new Map());
+    });
+    it("keys the lookup by the SQL identifier parsed from each DDL", () => {
+        const t = {
+            ddl: "CREATE TABLE papers (title TEXT)",
+            glob: "**/*.json",
+            extract: noopExtract,
+        };
+        const tables = buildTables(fakeApp([t]));
+        expect(tables.get("papers")).toBe(t);
+    });
+    it("preserves multiple tables under their respective names", () => {
+        const a = {
+            ddl: "CREATE TABLE a (x TEXT)",
+            glob: "a/*",
+            extract: noopExtract,
+        };
+        const b = {
+            ddl: "CREATE TABLE b (y TEXT)",
+            glob: "b/*",
+            extract: noopExtract,
+        };
+        const tables = buildTables(fakeApp([a, b]));
+        expect(tables.get("a")).toBe(a);
+        expect(tables.get("b")).toBe(b);
+        expect(tables.size).toBe(2);
+    });
+    it("throws when parseTableName returns null for a DDL", () => {
+        const t = {
+            // DDL the fake regex won't match -- no `CREATE TABLE` prefix at all.
+            ddl: "DROP TABLE old_papers",
+            glob: "*.json",
+            extract: noopExtract,
+        };
+        expect(() => buildTables(fakeApp([t]))).toThrow(/could not parse table name/);
+    });
+});
+//# sourceMappingURL=buildTables.test.js.map

package/dist/cli/interpret/buildTables.test.js.map

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

package/dist/cli/interpret/dispatchExtract.d.ts

@@ -0,0 +1,16 @@
+import type { TableDef } from "../../index.js";
+export interface ExtractRequest {
+    type?: string;
+    id?: unknown;
+    table?: string;
+    path?: string;
+}
+export interface ResultMessage {
+    type: "result";
+    id: unknown;
+    ok: boolean;
+    rows?: unknown[];
+    error?: string;
+}
+export declare function dispatchExtract(req: ExtractRequest, tables: Map<string, TableDef>): Promise<ResultMessage>;
+//# sourceMappingURL=dispatchExtract.d.ts.map

package/dist/cli/interpret/dispatchExtract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatchExtract.d.ts","sourceRoot":"","sources":["../../../src/cli/interpret/dispatchExtract.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAG/C,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,OAAO,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,QAAQ,CAAC;IACf,EAAE,EAAE,OAAO,CAAC;IACZ,EAAE,EAAE,OAAO,CAAC;IACZ,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAsB,eAAe,CACnC,GAAG,EAAE,cAAc,EACnB,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,GAC5B,OAAO,CAAC,aAAa,CAAC,CAiBxB"}

package/dist/cli/interpret/dispatchExtract.js

@@ -0,0 +1,25 @@
+// Single-request handler. Given a parsed extract request and the
+// `name -> TableDef` map, call the user's extract callback (which may
+// be sync or async) and build the NDJSON response payload the loop
+// will write back.
+import { errMessage } from "./errMessage.js";
+export async function dispatchExtract(req, tables) {
+    const { id, table: name, path } = req;
+    const table = name === undefined ? undefined : tables.get(name);
+    if (!table) {
+        return {
+            type: "result",
+            id,
+            ok: false,
+            error: `unknown table: ${JSON.stringify(name)}`,
+        };
+    }
+    try {
+        const rows = await table.extract(path);
+        return { type: "result", id, ok: true, rows };
+    }
+    catch (e) {
+        return { type: "result", id, ok: false, error: errMessage(e) };
+    }
+}
+//# sourceMappingURL=dispatchExtract.js.map

package/dist/cli/interpret/dispatchExtract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatchExtract.js","sourceRoot":"","sources":["../../../src/cli/interpret/dispatchExtract.ts"],"names":[],"mappings":"AAAA,iEAAiE;AACjE,sEAAsE;AACtE,mEAAmE;AACnE,mBAAmB;AAGnB,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAiB7C,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,GAAmB,EACnB,MAA6B;IAE7B,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,GAAG,CAAC;IACtC,MAAM,KAAK,GAAG,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAChE,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO;YACL,IAAI,EAAE,QAAQ;YACd,EAAE;YACF,EAAE,EAAE,KAAK;YACT,KAAK,EAAE,kBAAkB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE;SAChD,CAAC;IACJ,CAAC;IACD,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,IAAc,CAAC,CAAC;QACjD,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IAChD,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;IACjE,CAAC;AACH,CAAC"}

package/dist/cli/interpret/dispatchExtract.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=dispatchExtract.test.d.ts.map

package/dist/cli/interpret/dispatchExtract.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatchExtract.test.d.ts","sourceRoot":"","sources":["../../../src/cli/interpret/dispatchExtract.test.ts"],"names":[],"mappings":""}

package/dist/cli/interpret/dispatchExtract.test.js

@@ -0,0 +1,75 @@
+import { describe, expect, it } from "vitest";
+import { dispatchExtract } from "./dispatchExtract.js";
+function tableMap(entries) {
+    return new Map(entries.map(([n, extract]) => [
+        n,
+        {
+            ddl: `CREATE TABLE ${n} (x TEXT)`,
+            glob: "*",
+            extract,
+        },
+    ]));
+}
+describe("dispatchExtract", () => {
+    it("returns ok=true with the rows the sync extract returned", async () => {
+        const tables = tableMap([["papers", (p) => [{ row: p }]]]);
+        const out = await dispatchExtract({ type: "extract", id: 1, table: "papers", path: "/a" }, tables);
+        expect(out).toEqual({
+            type: "result",
+            id: 1,
+            ok: true,
+            rows: [{ row: "/a" }],
+        });
+    });
+    it("echoes the request id verbatim on success", async () => {
+        const tables = tableMap([["t", () => []]]);
+        const out = await dispatchExtract({ type: "extract", id: 99, table: "t", path: "/" }, tables);
+        expect(out.id).toBe(99);
+    });
+    it("returns ok=false with a JSON-encoded name when the table is unknown", async () => {
+        const out = await dispatchExtract({ type: "extract", id: 5, table: "ghost", path: "/" }, tableMap([]));
+        expect(out.ok).toBe(false);
+        expect(out.error).toContain('"ghost"');
+    });
+    it("echoes the request id verbatim on unknown-table failure", async () => {
+        const out = await dispatchExtract({ type: "extract", id: 17, table: "ghost", path: "/" }, tableMap([]));
+        expect(out.id).toBe(17);
+    });
+    it("returns ok=false with the message when a sync extract throws", async () => {
+        const tables = tableMap([
+            [
+                "papers",
+                () => {
+                    throw new Error("synthetic");
+                },
+            ],
+        ]);
+        const out = await dispatchExtract({ type: "extract", id: 7, table: "papers", path: "/" }, tables);
+        expect(out).toEqual({
+            type: "result",
+            id: 7,
+            ok: false,
+            error: "synthetic",
+        });
+    });
+    it("treats a missing table field as unknown table", async () => {
+        const out = await dispatchExtract({ type: "extract", id: 1, path: "/" }, tableMap([["t", () => []]]));
+        expect(out.ok).toBe(false);
+        expect(out.error).toMatch(/unknown table/);
+    });
+    it("passes the request path to the extract callback", async () => {
+        const seen = [];
+        const tables = tableMap([
+            [
+                "t",
+                (p) => {
+                    seen.push(p);
+                    return [];
+                },
+            ],
+        ]);
+        await dispatchExtract({ type: "extract", id: 1, table: "t", path: "/abs/x.json" }, tables);
+        expect(seen).toEqual(["/abs/x.json"]);
+    });
+});
+//# sourceMappingURL=dispatchExtract.test.js.map

package/dist/cli/interpret/dispatchExtract.test.js.map

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

package/dist/cli/interpret/errMessage.d.ts

@@ -0,0 +1,2 @@
+export declare function errMessage(e: unknown): string;
+//# sourceMappingURL=errMessage.d.ts.map

package/dist/cli/interpret/errMessage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errMessage.d.ts","sourceRoot":"","sources":["../../../src/cli/interpret/errMessage.ts"],"names":[],"mappings":"AAIA,wBAAgB,UAAU,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,CAE7C"}

package/dist/cli/interpret/errMessage.js

@@ -0,0 +1,7 @@
+// Coerce an unknown thrown value into a human-readable string for
+// stderr / NDJSON `error` fields. `Error.message` when available,
+// `String(e)` otherwise.
+export function errMessage(e) {
+    return e instanceof Error ? e.message : String(e);
+}
+//# sourceMappingURL=errMessage.js.map

package/dist/cli/interpret/errMessage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errMessage.js","sourceRoot":"","sources":["../../../src/cli/interpret/errMessage.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,kEAAkE;AAClE,yBAAyB;AAEzB,MAAM,UAAU,UAAU,CAAC,CAAU;IACnC,OAAO,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;AACpD,CAAC"}

package/dist/cli/interpret/errMessage.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=errMessage.test.d.ts.map

package/dist/cli/interpret/errMessage.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errMessage.test.d.ts","sourceRoot":"","sources":["../../../src/cli/interpret/errMessage.test.ts"],"names":[],"mappings":""}

package/dist/cli/interpret/errMessage.test.js

@@ -0,0 +1,23 @@
+import { describe, expect, it } from "vitest";
+import { errMessage } from "./errMessage.js";
+describe("errMessage", () => {
+    it("returns Error.message when the value is an Error", () => {
+        expect(errMessage(new Error("boom"))).toBe("boom");
+    });
+    it("returns Error.message for a subclassed Error", () => {
+        expect(errMessage(new TypeError("bad type"))).toBe("bad type");
+    });
+    it("coerces a string to itself", () => {
+        expect(errMessage("plain")).toBe("plain");
+    });
+    it("coerces null to 'null'", () => {
+        expect(errMessage(null)).toBe("null");
+    });
+    it("coerces a number via String()", () => {
+        expect(errMessage(42)).toBe("42");
+    });
+    it("coerces a plain object via String()", () => {
+        expect(errMessage({})).toBe("[object Object]");
+    });
+});
+//# sourceMappingURL=errMessage.test.js.map

package/dist/cli/interpret/errMessage.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errMessage.test.js","sourceRoot":"","sources":["../../../src/cli/interpret/errMessage.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,QAAQ,CAAC,YAAY,EAAE,GAAG,EAAE;IAC1B,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;QAC1D,MAAM,CAAC,UAAU,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACrD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8CAA8C,EAAE,GAAG,EAAE;QACtD,MAAM,CAAC,UAAU,CAAC,IAAI,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACjE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4BAA4B,EAAE,GAAG,EAAE;QACpC,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wBAAwB,EAAE,GAAG,EAAE;QAChC,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;QACvC,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;QAC7C,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IACjD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/cli/interpret/index.d.ts

@@ -0,0 +1,2 @@
+export { interpret } from "./interpret.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/interpret/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cli/interpret/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/cli/interpret/index.js

@@ -0,0 +1,7 @@
+// Re-export the `interpret` entry point so callers (the launcher's
+// `main`) can `import { interpret } from "./interpret/index.js"`.
+//
+// Each helper lives in its own module so unit tests can exercise it in
+// isolation without spawning a subprocess.
+export { interpret } from "./interpret.js";
+//# sourceMappingURL=index.js.map

package/dist/cli/interpret/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/cli/interpret/index.ts"],"names":[],"mappings":"AAAA,mEAAmE;AACnE,kEAAkE;AAClE,EAAE;AACF,uEAAuE;AACvE,2CAA2C;AAE3C,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/cli/interpret/interpret.d.ts

@@ -0,0 +1,2 @@
+export declare function interpret(configPath: string): Promise<number>;
+//# sourceMappingURL=interpret.d.ts.map

package/dist/cli/interpret/interpret.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interpret.d.ts","sourceRoot":"","sources":["../../../src/cli/interpret/interpret.ts"],"names":[],"mappings":"AA2BA,wBAAsB,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CA4CnE"}

package/dist/cli/interpret/interpret.js

@@ -0,0 +1,66 @@
+// Subcommand entry point for `dirsql interpret <config>`.
+//
+// Glues the per-purpose helpers (`loadApp`, `buildTables`,
+// `dispatchExtract`, `writeMessage`) into the long-running NDJSON
+// loop:
+//
+//   handshake (helper -> caller, once on startup):
+//     {"type": "config", "state": <app.toJSON()>}
+//
+//   extract request (caller -> helper):
+//     {"type": "extract", "id": <int>, "table": "<name>", "path": "<abs>"}
+//
+//   extract response (helper -> caller):
+//     {"type": "result", "id": <int>, "ok": true,  "rows": [...]}
+//     {"type": "result", "id": <int>, "ok": false, "error": "<msg>"}
+//
+// Exits 0 when stdin closes; non-zero with a single `dirsql interpret:`
+// line on stderr if the config can't be loaded.
+import { createInterface } from "node:readline";
+import { buildTables } from "./buildTables.js";
+import { dispatchExtract } from "./dispatchExtract.js";
+import { errMessage } from "./errMessage.js";
+import { loadApp } from "./loadApp.js";
+import { writeMessage } from "./writeMessage.js";
+export async function interpret(configPath) {
+    if (!configPath) {
+        process.stderr.write("dirsql interpret: expected one config path, got 0\n");
+        return 1;
+    }
+    let app;
+    try {
+        app = await loadApp(configPath);
+    }
+    catch (e) {
+        process.stderr.write(`dirsql interpret: ${errMessage(e)}\n`);
+        return 1;
+    }
+    // The SDK constructor kicks off a background scan that calls each
+    // table's `extract` for every matched file. If a user `extract`
+    // throws, the scan rejects -- and since interpret never awaits the
+    // scan (it dispatches to `extract` itself per request), the rejection
+    // would surface as an unhandled promise rejection and crash Node.
+    // Swallow it here; per-request errors are still reported to the
+    // caller in the extract-response.
+    app.ready.catch(() => { });
+    const tables = buildTables(app);
+    writeMessage({ type: "config", state: app.toJSON() });
+    for await (const line of createInterface({ input: process.stdin })) {
+        if (!line.trim()) {
+            continue;
+        }
+        let req;
+        try {
+            req = JSON.parse(line);
+        }
+        catch {
+            continue;
+        }
+        if (!req || typeof req !== "object" || req.type !== "extract") {
+            continue;
+        }
+        writeMessage(await dispatchExtract(req, tables));
+    }
+    return 0;
+}
+//# sourceMappingURL=interpret.js.map

package/dist/cli/interpret/interpret.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interpret.js","sourceRoot":"","sources":["../../../src/cli/interpret/interpret.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAC1D,EAAE;AACF,2DAA2D;AAC3D,kEAAkE;AAClE,QAAQ;AACR,EAAE;AACF,mDAAmD;AACnD,kDAAkD;AAClD,EAAE;AACF,wCAAwC;AACxC,2EAA2E;AAC3E,EAAE;AACF,yCAAyC;AACzC,kEAAkE;AAClE,qEAAqE;AACrE,EAAE;AACF,wEAAwE;AACxE,gDAAgD;AAEhD,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEhD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,UAAkB;IAChD,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,qDAAqD,CAAC,CAAC;QAC5E,OAAO,CAAC,CAAC;IACX,CAAC;IAED,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QACH,GAAG,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC,CAAC;IAClC,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,qBAAqB,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAC7D,OAAO,CAAC,CAAC;IACX,CAAC;IAED,kEAAkE;IAClE,gEAAgE;IAChE,mEAAmE;IACnE,sEAAsE;IACtE,kEAAkE;IAClE,gEAAgE;IAChE,kCAAkC;IAClC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IAE1B,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;IAEhC,YAAY,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAEtD,IAAI,KAAK,EAAE,MAAM,IAAI,IAAI,eAAe,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC;QACnE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;YACjB,SAAS;QACX,CAAC;QACD,IAAI,GAAmE,CAAC;QACxE,IAAI,CAAC;YACH,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACzB,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;QACD,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC9D,SAAS;QACX,CAAC;QACD,YAAY,CAAC,MAAM,eAAe,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC;IACnD,CAAC;IAED,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/cli/interpret/interpret.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=interpret.test.d.ts.map

package/dist/cli/interpret/interpret.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interpret.test.d.ts","sourceRoot":"","sources":["../../../src/cli/interpret/interpret.test.ts"],"names":[],"mappings":""}

package/dist/cli/interpret/interpret.test.js

@@ -0,0 +1,153 @@
+import { Readable } from "node:stream";
+import { afterEach, beforeEach, describe, expect, it, vi, } from "vitest";
+import * as buildTablesMod from "./buildTables.js";
+import * as dispatchMod from "./dispatchExtract.js";
+import { interpret } from "./interpret.js";
+import * as loadAppMod from "./loadApp.js";
+import * as writeMod from "./writeMessage.js";
+function fakeApp(overrides = {}) {
+    const app = {
+        ready: Promise.resolve(),
+        toJSON: () => ({ root: "/x" }),
+        _options: { tables: [] },
+        ...overrides,
+    };
+    return app;
+}
+function asLines(lines) {
+    return Readable.from(lines.map((l) => `${l}\n`));
+}
+describe("interpret", () => {
+    let stderrWrite;
+    beforeEach(() => {
+        stderrWrite = vi.fn();
+        vi.stubGlobal("process", {
+            ...process,
+            stdin: asLines([]),
+            stderr: { write: stderrWrite },
+        });
+        vi.spyOn(writeMod, "writeMessage").mockImplementation(() => { });
+        vi.spyOn(buildTablesMod, "buildTables").mockReturnValue(new Map());
+        vi.spyOn(dispatchMod, "dispatchExtract").mockResolvedValue({
+            type: "result",
+            id: 1,
+            ok: true,
+            rows: [],
+        });
+    });
+    afterEach(() => {
+        vi.unstubAllGlobals();
+        vi.restoreAllMocks();
+    });
+    describe("startup", () => {
+        it("returns 1 and writes to stderr when configPath is empty", async () => {
+            expect(await interpret("")).toBe(1);
+            expect(stderrWrite).toHaveBeenCalledExactlyOnceWith("dirsql interpret: expected one config path, got 0\n");
+        });
+        it("returns 1 and writes a dirsql-prefixed line when loadApp throws", async () => {
+            vi.spyOn(loadAppMod, "loadApp").mockRejectedValue(new Error("no app"));
+            expect(await interpret("bad.mjs")).toBe(1);
+            expect(stderrWrite).toHaveBeenCalledExactlyOnceWith("dirsql interpret: no app\n");
+        });
+        it("coerces non-Error throws via String() in the stderr message", async () => {
+            vi.spyOn(loadAppMod, "loadApp").mockRejectedValue("plain string");
+            expect(await interpret("bad.mjs")).toBe(1);
+            expect(stderrWrite).toHaveBeenCalledExactlyOnceWith("dirsql interpret: plain string\n");
+        });
+    });
+    describe("handshake", () => {
+        it("writes one config message with app.toJSON() as state", async () => {
+            const app = fakeApp({
+                toJSON: () => ({ root: "/here", tables: [], ignore: [], persist: false }),
+            });
+            vi.spyOn(loadAppMod, "loadApp").mockResolvedValue(app);
+            await interpret("good.mjs");
+            expect(writeMod.writeMessage).toHaveBeenCalledWith({
+                type: "config",
+                state: { root: "/here", tables: [], ignore: [], persist: false },
+            });
+        });
+        it("attaches a no-op catch to app.ready to swallow background-scan failures", async () => {
+            // Verify the structural property -- interpret CALLS `.catch` on
+            // `app.ready` -- without exercising the runtime side effect
+            // (which fights vitest's own unhandled-rejection handling).
+            const catchSpy = vi.fn(() => Promise.resolve());
+            const app = fakeApp({
+                ready: { catch: catchSpy },
+            });
+            vi.spyOn(loadAppMod, "loadApp").mockResolvedValue(app);
+            await interpret("good.mjs");
+            expect(catchSpy).toHaveBeenCalledOnce();
+        });
+    });
+    describe("extract loop", () => {
+        it("dispatches one extract request and writes the response", async () => {
+            vi.spyOn(loadAppMod, "loadApp").mockResolvedValue(fakeApp());
+            const req = { type: "extract", id: 1, table: "t", path: "/a" };
+            vi.stubGlobal("process", {
+                ...process,
+                stdin: asLines([JSON.stringify(req)]),
+                stderr: { write: stderrWrite },
+            });
+            const expected = {
+                type: "result",
+                id: 1,
+                ok: true,
+                rows: [{ row: "/a" }],
+            };
+            vi.mocked(dispatchMod.dispatchExtract).mockResolvedValue(expected);
+            expect(await interpret("good.mjs")).toBe(0);
+            expect(dispatchMod.dispatchExtract).toHaveBeenCalledWith(req, new Map());
+            // handshake first, then response
+            expect(writeMod.writeMessage).toHaveBeenCalledTimes(2);
+            expect(writeMod.writeMessage).toHaveBeenLastCalledWith(expected);
+        });
+        it("skips blank lines silently", async () => {
+            vi.spyOn(loadAppMod, "loadApp").mockResolvedValue(fakeApp());
+            vi.stubGlobal("process", {
+                ...process,
+                stdin: asLines(["", "   "]),
+                stderr: { write: stderrWrite },
+            });
+            expect(await interpret("good.mjs")).toBe(0);
+            expect(dispatchMod.dispatchExtract).not.toHaveBeenCalled();
+            // handshake only
+            expect(writeMod.writeMessage).toHaveBeenCalledOnce();
+        });
+        it("skips malformed JSON silently", async () => {
+            vi.spyOn(loadAppMod, "loadApp").mockResolvedValue(fakeApp());
+            vi.stubGlobal("process", {
+                ...process,
+                stdin: asLines(["not json", "{also bad"]),
+                stderr: { write: stderrWrite },
+            });
+            expect(await interpret("good.mjs")).toBe(0);
+            expect(dispatchMod.dispatchExtract).not.toHaveBeenCalled();
+        });
+        it("skips non-extract messages silently", async () => {
+            vi.spyOn(loadAppMod, "loadApp").mockResolvedValue(fakeApp());
+            vi.stubGlobal("process", {
+                ...process,
+                stdin: asLines([JSON.stringify({ type: "ping" })]),
+                stderr: { write: stderrWrite },
+            });
+            expect(await interpret("good.mjs")).toBe(0);
+            expect(dispatchMod.dispatchExtract).not.toHaveBeenCalled();
+        });
+        it("skips a null / non-object JSON payload silently", async () => {
+            vi.spyOn(loadAppMod, "loadApp").mockResolvedValue(fakeApp());
+            vi.stubGlobal("process", {
+                ...process,
+                stdin: asLines(["null", "42", "[]"]),
+                stderr: { write: stderrWrite },
+            });
+            expect(await interpret("good.mjs")).toBe(0);
+            expect(dispatchMod.dispatchExtract).not.toHaveBeenCalled();
+        });
+        it("returns 0 when stdin closes", async () => {
+            vi.spyOn(loadAppMod, "loadApp").mockResolvedValue(fakeApp());
+            expect(await interpret("good.mjs")).toBe(0);
+        });
+    });
+});
+//# sourceMappingURL=interpret.test.js.map