@ryanstark24/sfgraph-core 1.1.0

package/dist/storage/__tests__/perf-50k.test.js

@@ -0,0 +1,67 @@
+import { mkdtempSync, rmSync } from "node:fs";
+import { tmpdir } from "node:os";
+import path from "node:path";
+import { performance } from "node:perf_hooks";
+import { asOrgId, asQualifiedName, asSha256 } from "@ryanstark24/sfgraph-shared";
+import { afterEach, beforeEach, describe, expect, it } from "vitest";
+import { SqliteGraphStore } from "../sqlite/graph-store.js";
+import { SqliteSnapshotStore } from "../sqlite/snapshot-store.js";
+let workDir;
+beforeEach(() => {
+    workDir = mkdtempSync(path.join(tmpdir(), "sfg-perf-"));
+});
+afterEach(() => {
+    rmSync(workDir, { recursive: true, force: true });
+});
+describe("perf: 50k ingest + snapshot + diff", () => {
+    it.skipIf(process.env.CI)("completes in under 5000ms", async () => {
+        const dbPath = path.join(workDir, "perf.sqlite");
+        const graph = new SqliteGraphStore({ dbPath, backupDir: path.join(workDir, "bkp") });
+        await graph.init();
+        const snap = new SqliteSnapshotStore({ dbPath, db: graph.db, skipMigrations: true });
+        await snap.init();
+        const labels = ["ApexClass", "Flow", "LWC", "CustomObject", "CustomField"];
+        const relTypes = ["CALLS", "READS_FIELD", "WRITES_FIELD", "CONTAINS", "REFERENCES"];
+        const total = 50_000;
+        const nodes = new Array(total);
+        for (let i = 0; i < total; i += 1) {
+            const lbl = labels[i % labels.length];
+            nodes[i] = {
+                orgId: asOrgId("org1"),
+                qualifiedName: asQualifiedName(`${lbl}.N${i}`),
+                label: lbl,
+                attributes: { i },
+                sourceHash: asSha256(`h${i}`),
+                firstSeenAt: i,
+                lastSeenAt: i,
+                lastModifiedAt: i,
+            };
+        }
+        const edges = new Array(total);
+        for (let i = 0; i < total; i += 1) {
+            const rt = relTypes[i % relTypes.length];
+            const srcL = labels[i % labels.length];
+            const dstL = labels[(i + 1) % labels.length];
+            edges[i] = {
+                orgId: asOrgId("org1"),
+                srcQualifiedName: asQualifiedName(`${srcL}.N${i}`),
+                dstQualifiedName: asQualifiedName(`${dstL}.N${(i + 1) % total}`),
+                relType: rt,
+                attributes: {},
+                firstSeenAt: i,
+                lastSeenAt: i,
+            };
+        }
+        const t0 = performance.now();
+        graph.mergeNodes(nodes);
+        graph.mergeEdges(edges);
+        const s = snap.createSnapshot(asOrgId("org1"), "perf", true);
+        snap.diffNodes(asOrgId("org1"), s.id, "current");
+        const elapsed = performance.now() - t0;
+        // eslint-disable-next-line no-console
+        console.log(`perf-50k: ${elapsed.toFixed(0)}ms`);
+        expect(elapsed).toBeLessThan(5000);
+        await graph.close();
+    }, 30_000);
+});
+//# sourceMappingURL=perf-50k.test.js.map

package/dist/storage/__tests__/perf-50k.test.js.map

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

package/dist/storage/__tests__/snapshot-store.test.d.ts

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

package/dist/storage/__tests__/snapshot-store.test.d.ts.map

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

package/dist/storage/__tests__/snapshot-store.test.js

@@ -0,0 +1,117 @@
+import { mkdtempSync, rmSync } from "node:fs";
+import { tmpdir } from "node:os";
+import path from "node:path";
+import { asOrgId, asQualifiedName, asSha256 } from "@ryanstark24/sfgraph-shared";
+import { afterEach, beforeEach, describe, expect, it } from "vitest";
+import { SqliteGraphStore } from "../sqlite/graph-store.js";
+import { SqliteSnapshotStore } from "../sqlite/snapshot-store.js";
+let workDir;
+let graph;
+let snap;
+beforeEach(async () => {
+    workDir = mkdtempSync(path.join(tmpdir(), "sfg-snap-"));
+    const dbPath = path.join(workDir, "s.sqlite");
+    graph = new SqliteGraphStore({ dbPath, backupDir: path.join(workDir, "bkp") });
+    await graph.init();
+    snap = new SqliteSnapshotStore({ dbPath, db: graph.db, skipMigrations: true });
+    await snap.init();
+});
+afterEach(async () => {
+    await graph.close();
+    rmSync(workDir, { recursive: true, force: true });
+});
+function n(label, qname, hash, t = 1) {
+    return {
+        orgId: asOrgId("org1"),
+        qualifiedName: asQualifiedName(qname),
+        label,
+        attributes: {},
+        sourceHash: asSha256(hash),
+        firstSeenAt: t,
+        lastSeenAt: t,
+        lastModifiedAt: t,
+    };
+}
+function e(rt, src, dst) {
+    return {
+        orgId: asOrgId("org1"),
+        srcQualifiedName: asQualifiedName(src),
+        dstQualifiedName: asQualifiedName(dst),
+        relType: rt,
+        attributes: {},
+        firstSeenAt: 1,
+        lastSeenAt: 1,
+    };
+}
+describe("SqliteSnapshotStore", () => {
+    it("createSnapshot captures current state", () => {
+        graph.mergeNodes([n("ApexClass", "Foo", "h1")]);
+        const s = snap.createSnapshot(asOrgId("org1"), "v1", false);
+        expect(s.id).toMatch(/^snap_/);
+        expect(snap.getSnapshot(s.id)?.label).toBe("v1");
+        const list = snap.listSnapshots(asOrgId("org1"));
+        expect(list).toHaveLength(1);
+    });
+    it("diffNodes(snap, 'current') detects changes", () => {
+        graph.mergeNodes([n("ApexClass", "Foo", "h1")]);
+        const s = snap.createSnapshot(asOrgId("org1"), "v1", false);
+        graph.mergeNodes([n("ApexClass", "Foo", "h2", 5), n("ApexClass", "Bar", "h3", 5)]);
+        const diff = snap.diffNodes(asOrgId("org1"), s.id, "current");
+        expect(diff.added.map((x) => x.qualifiedName)).toEqual(["Bar"]);
+        expect(diff.removed).toHaveLength(0);
+        expect(diff.changed).toHaveLength(1);
+        expect(diff.changed[0]?.before.sourceHash).toBe("h1");
+        expect(diff.changed[0]?.after.sourceHash).toBe("h2");
+    });
+    it("diff reports removed nodes", () => {
+        graph.mergeNodes([n("ApexClass", "Foo", "h1"), n("ApexClass", "Bar", "h2")]);
+        const s = snap.createSnapshot(asOrgId("org1"), "v1", false);
+        // emulate deletion by clearing the table for Bar manually
+        graph.db.prepare("DELETE FROM _sfg_n_apexclass WHERE qualified_name = ?").run("Bar");
+        const diff = snap.diffNodes(asOrgId("org1"), s.id, "current");
+        expect(diff.removed.map((x) => x.qualifiedName)).toEqual(["Bar"]);
+    });
+    it("diff between two snapshots", () => {
+        graph.mergeNodes([n("ApexClass", "Foo", "h1")]);
+        const s1 = snap.createSnapshot(asOrgId("org1"), "v1", false);
+        graph.mergeNodes([n("ApexClass", "Bar", "h2")]);
+        const s2 = snap.createSnapshot(asOrgId("org1"), "v2", false);
+        const diff = snap.diffNodes(asOrgId("org1"), s1.id, s2.id);
+        expect(diff.added).toHaveLength(1);
+        expect(diff.added[0]?.qualifiedName).toBe("Bar");
+    });
+    it("diffEdges reports added/removed only", () => {
+        graph.mergeEdges([e("CALLS", "A", "B")]);
+        const s1 = snap.createSnapshot(asOrgId("org1"), "v1", false);
+        graph.mergeEdges([e("CALLS", "A", "C")]);
+        const d = snap.diffEdges(asOrgId("org1"), s1.id, "current");
+        expect(d.added).toHaveLength(1);
+        expect(d.added[0]?.dstQualifiedName).toBe("C");
+        expect(d.removed).toHaveLength(0);
+    });
+    it("prune deletes old auto snapshots only; manual survives", () => {
+        graph.mergeNodes([n("ApexClass", "Foo", "h1")]);
+        const auto = snap.createSnapshot(asOrgId("org1"), "auto-old", true);
+        const manual = snap.createSnapshot(asOrgId("org1"), "manual-old", false);
+        // Backdate both
+        const old = Date.now() - 60 * 86_400_000;
+        graph.db
+            .prepare("UPDATE _sfgraph_snapshots SET created_at = ? WHERE id IN (?, ?)")
+            .run(old, auto.id, manual.id);
+        const deleted = snap.prune(asOrgId("org1"), 30);
+        expect(deleted).toBe(1);
+        expect(snap.getSnapshot(auto.id)).toBeNull();
+        expect(snap.getSnapshot(manual.id)).not.toBeNull();
+    });
+    it("deleteSnapshot removes child rows", () => {
+        graph.mergeNodes([n("ApexClass", "Foo", "h1")]);
+        const s = snap.createSnapshot(asOrgId("org1"), "v1", false);
+        snap.deleteSnapshot(s.id);
+        expect(snap.getSnapshot(s.id)).toBeNull();
+        const rows = graph.db
+            .prepare("SELECT COUNT(*) AS c FROM _sfgraph_node_snapshots WHERE snapshot_id = ?")
+            .get(s.id);
+        expect(rows.c).toBe(0);
+    });
+});
+//# sourceMappingURL=snapshot-store.test.js.map

package/dist/storage/__tests__/snapshot-store.test.js.map

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

package/dist/storage/__tests__/snippets.test.d.ts

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

package/dist/storage/__tests__/snippets.test.d.ts.map

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

package/dist/storage/__tests__/snippets.test.js

@@ -0,0 +1,88 @@
+import { mkdtempSync, rmSync } from "node:fs";
+import { tmpdir } from "node:os";
+import path from "node:path";
+import { asOrgId, asQualifiedName, asSha256 } from "@ryanstark24/sfgraph-shared";
+import { afterEach, beforeEach, describe, expect, it } from "vitest";
+import { SqliteGraphStore } from "../sqlite/graph-store.js";
+let workDir;
+let store;
+beforeEach(async () => {
+    workDir = mkdtempSync(path.join(tmpdir(), "sfg-snip-"));
+    store = new SqliteGraphStore({
+        dbPath: path.join(workDir, "g.sqlite"),
+        backupDir: path.join(workDir, "bkp"),
+    });
+    await store.init();
+});
+afterEach(async () => {
+    await store.close();
+    rmSync(workDir, { recursive: true, force: true });
+});
+function rec(qname, body, hash) {
+    return {
+        orgId: asOrgId("org1"),
+        qualifiedName: asQualifiedName(qname),
+        sourceFormat: "apex",
+        sourceText: body,
+        sourceHash: asSha256(hash),
+        startLine: 1,
+        endLine: body.split("\n").length,
+    };
+}
+describe("snippet store", () => {
+    it("first upsert inserts", () => {
+        const r = store.upsertSnippet(rec("ApexMethod:Foo.bar(0)", "return 1;", "h1"));
+        expect(r).toEqual({ inserted: true, updated: false, unchanged: false });
+    });
+    it("second upsert with same hash returns unchanged", () => {
+        const s = rec("ApexMethod:Foo.bar(0)", "return 1;", "h1");
+        store.upsertSnippet(s);
+        const r = store.upsertSnippet(s);
+        expect(r).toEqual({ inserted: false, updated: false, unchanged: true });
+    });
+    it("modified text returns updated and clears prior explanation", () => {
+        const s1 = rec("ApexMethod:Foo.bar(0)", "return 1;", "h1");
+        store.upsertSnippet(s1);
+        store.updateSnippetExplanation(s1.orgId, s1.qualifiedName, "older expl", 123);
+        const r = store.upsertSnippet(rec("ApexMethod:Foo.bar(0)", "return 2;", "h2"));
+        expect(r).toEqual({ inserted: false, updated: true, unchanged: false });
+        const got = store.getSnippet(s1.orgId, s1.qualifiedName);
+        expect(got?.sourceText).toBe("return 2;");
+        expect(got?.llmExplanation).toBeUndefined();
+    });
+    it("getSnippet round-trips fields", () => {
+        const s = rec("ApexMethod:Foo.bar(0)", "x;\ny;", "h3");
+        store.upsertSnippet(s);
+        const got = store.getSnippet(s.orgId, s.qualifiedName);
+        expect(got).not.toBeNull();
+        expect(got?.sourceFormat).toBe("apex");
+        expect(got?.sourceText).toBe("x;\ny;");
+        expect(got?.startLine).toBe(1);
+        expect(got?.endLine).toBe(2);
+        expect(got?.sourceHash).toBe("h3");
+    });
+    it("updateSnippetExplanation flips the column", () => {
+        const s = rec("ApexMethod:Foo.bar(0)", "return 1;", "h4");
+        store.upsertSnippet(s);
+        const ok = store.updateSnippetExplanation(s.orgId, s.qualifiedName, "does the thing", 777);
+        expect(ok).toBe(true);
+        const got = store.getSnippet(s.orgId, s.qualifiedName);
+        expect(got?.llmExplanation).toBe("does the thing");
+        expect(got?.explainedAt).toBe(777);
+    });
+    it("listSnippetsMissingExplanation filters correctly", () => {
+        const a = rec("ApexMethod:A.m(0)", "a", "ha");
+        const b = rec("ApexMethod:B.m(0)", "b", "hb");
+        const c = rec("ApexMethod:C.m(0)", "c", "hc");
+        store.upsertSnippet(a);
+        store.upsertSnippet(b);
+        store.upsertSnippet(c);
+        store.updateSnippetExplanation(b.orgId, b.qualifiedName, "expl", 1);
+        const missing = store.listSnippetsMissingExplanation(asOrgId("org1"));
+        const names = missing.map((m) => m.qualifiedName).sort();
+        expect(names).toEqual(["ApexMethod:A.m(0)", "ApexMethod:C.m(0)"]);
+        const limited = store.listSnippetsMissingExplanation(asOrgId("org1"), 1);
+        expect(limited).toHaveLength(1);
+    });
+});
+//# sourceMappingURL=snippets.test.js.map

package/dist/storage/__tests__/snippets.test.js.map

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

package/dist/storage/__tests__/vector-store-load-failure.test.d.ts

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

package/dist/storage/__tests__/vector-store-load-failure.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vector-store-load-failure.test.d.ts","sourceRoot":"","sources":["../../../src/storage/__tests__/vector-store-load-failure.test.ts"],"names":[],"mappings":""}

package/dist/storage/__tests__/vector-store-load-failure.test.js

@@ -0,0 +1,42 @@
+import { mkdtempSync, rmSync } from "node:fs";
+import { tmpdir } from "node:os";
+import path from "node:path";
+import { ErrorCode, SfgraphError } from "@ryanstark24/sfgraph-shared";
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+// Mock sqlite-vec so load() throws a real (non-"already loaded") error.
+vi.mock("sqlite-vec", async () => {
+    return {
+        load: (_db) => {
+            throw new Error("simulated extension load failure: cannot open shared object");
+        },
+    };
+});
+import { SqliteVectorStore } from "../sqlite/vector-store.js";
+let workDir;
+beforeEach(() => {
+    workDir = mkdtempSync(path.join(tmpdir(), "sfg-vec-fail-"));
+});
+afterEach(() => {
+    rmSync(workDir, { recursive: true, force: true });
+});
+describe("SqliteVectorStore extension-load failure", () => {
+    it("throws E_VECTOR_EXTENSION when sqlite-vec cannot be loaded", async () => {
+        const store = new SqliteVectorStore({
+            dbPath: path.join(workDir, "v.sqlite"),
+            backupDir: path.join(workDir, "bkp"),
+            // skipMigrations so we don't try to create vec0 tables (which would
+            // already fail). We're testing that init() rethrows the load error.
+            skipMigrations: true,
+        });
+        let caught;
+        try {
+            await store.init();
+        }
+        catch (e) {
+            caught = e;
+        }
+        expect(caught).toBeInstanceOf(SfgraphError);
+        expect(caught.code).toBe(ErrorCode.E_VECTOR_EXTENSION);
+    });
+});
+//# sourceMappingURL=vector-store-load-failure.test.js.map

package/dist/storage/__tests__/vector-store-load-failure.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vector-store-load-failure.test.js","sourceRoot":"","sources":["../../../src/storage/__tests__/vector-store-load-failure.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AACtE,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAEzE,wEAAwE;AACxE,EAAE,CAAC,IAAI,CAAC,YAAY,EAAE,KAAK,IAAI,EAAE;IAC/B,OAAO;QACL,IAAI,EAAE,CAAC,GAAY,EAAE,EAAE;YACrB,MAAM,IAAI,KAAK,CAAC,6DAA6D,CAAC,CAAC;QACjF,CAAC;KACF,CAAC;AACJ,CAAC,CAAC,CAAC;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAE9D,IAAI,OAAe,CAAC;AAEpB,UAAU,CAAC,GAAG,EAAE;IACd,OAAO,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,eAAe,CAAC,CAAC,CAAC;AAC9D,CAAC,CAAC,CAAC;AAEH,SAAS,CAAC,GAAG,EAAE;IACb,MAAM,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;AACpD,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,0CAA0C,EAAE,GAAG,EAAE;IACxD,EAAE,CAAC,4DAA4D,EAAE,KAAK,IAAI,EAAE;QAC1E,MAAM,KAAK,GAAG,IAAI,iBAAiB,CAAC;YAClC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC;YACtC,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC;YACpC,oEAAoE;YACpE,oEAAoE;YACpE,cAAc,EAAE,IAAI;SACrB,CAAC,CAAC;QACH,IAAI,MAAe,CAAC;QACpB,IAAI,CAAC;YACH,MAAM,KAAK,CAAC,IAAI,EAAE,CAAC;QACrB,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,MAAM,GAAG,CAAC,CAAC;QACb,CAAC;QACD,MAAM,CAAC,MAAM,CAAC,CAAC,cAAc,CAAC,YAAY,CAAC,CAAC;QAC5C,MAAM,CAAE,MAAuB,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,kBAAkB,CAAC,CAAC;IAC3E,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/storage/__tests__/vector-store.test.d.ts

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

package/dist/storage/__tests__/vector-store.test.d.ts.map

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

package/dist/storage/__tests__/vector-store.test.js

@@ -0,0 +1,87 @@
+import { mkdtempSync, rmSync } from "node:fs";
+import { tmpdir } from "node:os";
+import path from "node:path";
+import { asOrgId, asQualifiedName, asSha256 } from "@ryanstark24/sfgraph-shared";
+import { afterEach, beforeEach, describe, expect, it } from "vitest";
+import { SqliteVectorStore } from "../sqlite/vector-store.js";
+const DIM = 384;
+function vec(seed) {
+    const v = new Float32Array(DIM);
+    for (let i = 0; i < DIM; i += 1) {
+        v[i] = Math.sin(seed * 0.01 + i * 0.001);
+    }
+    return v;
+}
+let workDir;
+let store;
+beforeEach(async () => {
+    workDir = mkdtempSync(path.join(tmpdir(), "sfg-vec-"));
+    store = new SqliteVectorStore({
+        dbPath: path.join(workDir, "v.sqlite"),
+        backupDir: path.join(workDir, "bkp"),
+    });
+    await store.init();
+});
+afterEach(async () => {
+    await store.close();
+    rmSync(workDir, { recursive: true, force: true });
+});
+describe("SqliteVectorStore", () => {
+    it("loads sqlite-vec extension and initializes vec0 tables", () => {
+        // If init worked, querying vec0 metadata succeeds.
+        const row = store.db
+            .prepare("SELECT name FROM sqlite_master WHERE name = '_sfgraph_node_vectors'")
+            .get();
+        expect(row).toBeTruthy();
+    });
+    it("upsertNodeVector inserts a new vector", () => {
+        const r = store.upsertNodeVector(asOrgId("orgA"), asQualifiedName("Foo"), "ApexClass", vec(1), asSha256("h1"));
+        expect(r).toEqual({ inserted: true, deduped: false });
+        expect(store.countNodeVectors(asOrgId("orgA"))).toBe(1);
+    });
+    it("dedups when content_hash matches", () => {
+        store.upsertNodeVector(asOrgId("orgA"), asQualifiedName("Foo"), "ApexClass", vec(1), asSha256("h1"));
+        const r = store.upsertNodeVector(asOrgId("orgA"), asQualifiedName("Foo"), "ApexClass", vec(2), asSha256("h1"));
+        expect(r).toEqual({ inserted: false, deduped: true });
+    });
+    it("KNN returns results ordered by distance", () => {
+        for (let i = 0; i < 5; i += 1) {
+            store.upsertNodeVector(asOrgId("orgA"), asQualifiedName(`Q${i}`), "ApexClass", vec(i), asSha256(`h${i}`));
+        }
+        const hits = store.searchNodes(asOrgId("orgA"), vec(0), 3);
+        expect(hits).toHaveLength(3);
+        for (let i = 1; i < hits.length; i += 1) {
+            const prev = hits[i - 1];
+            const cur = hits[i];
+            if (prev && cur)
+                expect(prev.distance).toBeLessThanOrEqual(cur.distance);
+        }
+        expect(hits[0]?.qname).toBe("Q0");
+    });
+    it("label filter narrows results", () => {
+        store.upsertNodeVector(asOrgId("orgA"), asQualifiedName("A"), "ApexClass", vec(1), asSha256("h1"));
+        store.upsertNodeVector(asOrgId("orgA"), asQualifiedName("F"), "Flow", vec(1), asSha256("h2"));
+        const apex = store.searchNodes(asOrgId("orgA"), vec(1), 10, { label: "ApexClass" });
+        expect(apex.every((h) => h.label === "ApexClass")).toBe(true);
+        expect(apex.find((h) => h.qname === "F")).toBeUndefined();
+    });
+    it("partition prune: query for orgA returns no orgB results", () => {
+        const sameVec = vec(42);
+        store.upsertNodeVector(asOrgId("orgA"), asQualifiedName("AOnly"), "ApexClass", sameVec, asSha256("hA"));
+        store.upsertNodeVector(asOrgId("orgB"), asQualifiedName("BOnly"), "ApexClass", sameVec, asSha256("hB"));
+        const hitsA = store.searchNodes(asOrgId("orgA"), sameVec, 10);
+        expect(hitsA.some((h) => h.qname === "BOnly")).toBe(false);
+        expect(hitsA.some((h) => h.qname === "AOnly")).toBe(true);
+        const hitsB = store.searchNodes(asOrgId("orgB"), sameVec, 10);
+        expect(hitsB.some((h) => h.qname === "AOnly")).toBe(false);
+        expect(hitsB.some((h) => h.qname === "BOnly")).toBe(true);
+    });
+    it("countNodeVectors per org", () => {
+        store.upsertNodeVector(asOrgId("orgA"), asQualifiedName("A1"), "ApexClass", vec(1), asSha256("h1"));
+        store.upsertNodeVector(asOrgId("orgA"), asQualifiedName("A2"), "ApexClass", vec(2), asSha256("h2"));
+        store.upsertNodeVector(asOrgId("orgB"), asQualifiedName("B1"), "ApexClass", vec(3), asSha256("h3"));
+        expect(store.countNodeVectors(asOrgId("orgA"))).toBe(2);
+        expect(store.countNodeVectors(asOrgId("orgB"))).toBe(1);
+    });
+});
+//# sourceMappingURL=vector-store.test.js.map

package/dist/storage/__tests__/vector-store.test.js.map

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

package/dist/storage/identifier.d.ts

@@ -0,0 +1,5 @@
+export declare function validateLabel(label: string): string;
+export declare function validateRelType(relType: string): string;
+export declare function nodeTableName(label: string): string;
+export declare function edgeTableName(relType: string): string;
+//# sourceMappingURL=identifier.d.ts.map

package/dist/storage/identifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identifier.d.ts","sourceRoot":"","sources":["../../src/storage/identifier.ts"],"names":[],"mappings":"AAIA,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAKnD;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAKvD;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAErD"}

package/dist/storage/identifier.js

@@ -0,0 +1,21 @@
+import { StorageError } from "@ryanstark24/sfgraph-shared";
+const IDENT_RE = /^[A-Za-z][A-Za-z0-9_]{0,63}$/;
+export function validateLabel(label) {
+    if (typeof label !== "string" || !IDENT_RE.test(label)) {
+        throw new StorageError(`SF_INVALID_IDENTIFIER: invalid label ${JSON.stringify(label)}`);
+    }
+    return label;
+}
+export function validateRelType(relType) {
+    if (typeof relType !== "string" || !IDENT_RE.test(relType)) {
+        throw new StorageError(`SF_INVALID_IDENTIFIER: invalid relType ${JSON.stringify(relType)}`);
+    }
+    return relType;
+}
+export function nodeTableName(label) {
+    return `_sfg_n_${validateLabel(label).toLowerCase()}`;
+}
+export function edgeTableName(relType) {
+    return `_sfg_e_${validateRelType(relType).toLowerCase()}`;
+}
+//# sourceMappingURL=identifier.js.map

package/dist/storage/identifier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"identifier.js","sourceRoot":"","sources":["../../src/storage/identifier.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAE3D,MAAM,QAAQ,GAAG,8BAA8B,CAAC;AAEhD,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACvD,MAAM,IAAI,YAAY,CAAC,wCAAwC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAC1F,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,OAAe;IAC7C,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3D,MAAM,IAAI,YAAY,CAAC,0CAA0C,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAC9F,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,OAAO,UAAU,aAAa,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,OAAe;IAC3C,OAAO,UAAU,eAAe,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;AAC5D,CAAC"}

package/dist/storage/index.d.ts

@@ -0,0 +1,12 @@
+export * from "./interfaces.js";
+export * from "./identifier.js";
+export { MIGRATIONS, MigrationRunner } from "./sqlite/migrations.js";
+export type { MigrationRunnerOpts } from "./sqlite/migrations.js";
+export { SqliteGraphStore } from "./sqlite/graph-store.js";
+export type { SqliteGraphStoreOptions } from "./sqlite/graph-store.js";
+export { SqliteVectorStore } from "./sqlite/vector-store.js";
+export type { SqliteVectorStoreOptions } from "./sqlite/vector-store.js";
+export { SqliteSnapshotStore } from "./sqlite/snapshot-store.js";
+export type { SqliteSnapshotStoreOptions } from "./sqlite/snapshot-store.js";
+export { isAbiMismatch, loadBetterSqlite3, wrapAbiError, } from "./sqlite/load-better-sqlite3.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/storage/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACrE,YAAY,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,YAAY,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AACvE,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,YAAY,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AACzE,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,YAAY,EAAE,0BAA0B,EAAE,MAAM,4BAA4B,CAAC;AAC7E,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,YAAY,GACb,MAAM,iCAAiC,CAAC"}

package/dist/storage/index.js

@@ -0,0 +1,8 @@
+export * from "./interfaces.js";
+export * from "./identifier.js";
+export { MIGRATIONS, MigrationRunner } from "./sqlite/migrations.js";
+export { SqliteGraphStore } from "./sqlite/graph-store.js";
+export { SqliteVectorStore } from "./sqlite/vector-store.js";
+export { SqliteSnapshotStore } from "./sqlite/snapshot-store.js";
+export { isAbiMismatch, loadBetterSqlite3, wrapAbiError, } from "./sqlite/load-better-sqlite3.js";
+//# sourceMappingURL=index.js.map

package/dist/storage/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAErE,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAE3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAEjE,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,YAAY,GACb,MAAM,iCAAiC,CAAC"}