@ryanstark24/sfgraph-core 1.1.0

package/dist/storage/sqlite/graph-store.js

@@ -0,0 +1,533 @@
+import { mkdirSync } from "node:fs";
+import path from "node:path";
+import { StorageError, asOrgId, asQualifiedName, asSha256 } from "@ryanstark24/sfgraph-shared";
+import Database from "better-sqlite3";
+import { edgeTableName, nodeTableName, validateLabel, validateRelType } from "../identifier.js";
+import { wrapAbiError } from "./load-better-sqlite3.js";
+import { MIGRATIONS, MigrationRunner } from "./migrations.js";
+function rowToNode(row, label) {
+    return {
+        orgId: asOrgId(row.org_id),
+        qualifiedName: asQualifiedName(row.qualified_name),
+        label,
+        attributes: JSON.parse(row.attributes),
+        sourceHash: asSha256(row.source_hash),
+        firstSeenAt: row.first_seen_at,
+        lastSeenAt: row.last_seen_at,
+        lastModifiedAt: row.last_modified_at,
+    };
+}
+function rowToEdge(row, relType) {
+    return {
+        orgId: asOrgId(row.org_id),
+        srcQualifiedName: asQualifiedName(row.src_qname),
+        dstQualifiedName: asQualifiedName(row.dst_qname),
+        relType,
+        attributes: JSON.parse(row.attributes),
+        firstSeenAt: row.first_seen_at,
+        lastSeenAt: row.last_seen_at,
+    };
+}
+export class SqliteGraphStore {
+    db;
+    ownsDb;
+    opts;
+    nodeLabelCache = new Map();
+    edgeRelCache = new Map();
+    initialized = false;
+    closed = false;
+    constructor(opts) {
+        this.opts = opts;
+        if (opts.db) {
+            this.db = opts.db;
+            this.ownsDb = false;
+        }
+        else {
+            if (opts.dbPath !== ":memory:") {
+                const dir = path.dirname(opts.dbPath);
+                if (dir && dir !== ".")
+                    mkdirSync(dir, { recursive: true });
+            }
+            try {
+                this.db = new Database(opts.dbPath);
+            }
+            catch (e) {
+                const wrapped = wrapAbiError(e);
+                if (wrapped)
+                    throw wrapped;
+                throw e;
+            }
+            this.ownsDb = true;
+        }
+    }
+    async init() {
+        if (this.initialized)
+            return;
+        this.db.pragma("journal_mode = WAL");
+        this.db.pragma("synchronous = NORMAL");
+        this.db.pragma("foreign_keys = ON");
+        this.db.pragma("temp_store = MEMORY");
+        this.db.pragma("mmap_size = 268435456");
+        this.db.pragma("cache_size = -200000");
+        // Smaller WAL auto-checkpoint threshold (default 1000 pages = ~4MB).
+        // With large ingests producing 10-20K inserts during the object phase,
+        // the WAL hits the default threshold right around the 30-second mark
+        // and triggers one big checkpoint inside the native binding. Under
+        // sustained write pressure that checkpoint has been observed to
+        // silently abort the process on macOS 26+ (no JS handler can intercept
+        // — the binding terminates natively). 256 pages = ~1MB per checkpoint:
+        // each checkpoint completes in <50ms, runs more frequently, and never
+        // accumulates the page-lock pressure of a single multi-MB flush.
+        this.db.pragma("wal_autocheckpoint = 256");
+        const backupDir = this.opts.backupDir ??
+            (this.opts.dbPath === ":memory:"
+                ? path.join(process.cwd(), ".sfgraph-backups")
+                : path.join(path.dirname(this.opts.dbPath), ".sfgraph-backups"));
+        const runner = new MigrationRunner(this.db, MIGRATIONS, {
+            backupDir,
+            retainBackups: this.opts.retainBackups ?? 5,
+        });
+        runner.applyPending();
+        this.loadCaches();
+        this.initialized = true;
+    }
+    /**
+     * Flush WAL to the main DB file with a PASSIVE checkpoint. Cheap (no
+     * locking against readers) and lets the auto-checkpoint mechanism stay
+     * ahead of write pressure. Callers should invoke this at major phase
+     * boundaries (between extractors, before long-running parses) so the
+     * WAL never grows beyond a few hundred pages.
+     *
+     * Returns true if checkpoint succeeded, false on any error (best-effort).
+     */
+    checkpoint() {
+        if (this.closed)
+            return false;
+        try {
+            this.db.pragma("wal_checkpoint(PASSIVE)");
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    async close() {
+        if (this.closed)
+            return;
+        this.closed = true;
+        if (this.ownsDb) {
+            try {
+                // Final TRUNCATE checkpoint on close: flushes WAL fully and
+                // truncates the WAL file to zero. Without this the .sqlite-wal
+                // sidecar can persist between runs at multi-MB size.
+                try {
+                    this.db.pragma("wal_checkpoint(TRUNCATE)");
+                }
+                catch {
+                    /* ignore — close still proceeds */
+                }
+                this.db.close();
+            }
+            catch {
+                // already closed by another path — idempotent
+            }
+        }
+    }
+    loadCaches() {
+        const labels = this.db
+            .prepare("SELECT label, table_name FROM _sfgraph_node_labels")
+            .all();
+        for (const row of labels)
+            this.nodeLabelCache.set(row.label, row.table_name);
+        const edges = this.db
+            .prepare("SELECT rel_type, table_name FROM _sfgraph_edge_types")
+            .all();
+        for (const row of edges)
+            this.edgeRelCache.set(row.rel_type, row.table_name);
+    }
+    ensureNodeTable(label) {
+        const cached = this.nodeLabelCache.get(label);
+        if (cached)
+            return cached;
+        const tbl = nodeTableName(label);
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS ${tbl} (
+        org_id TEXT NOT NULL,
+        qualified_name TEXT NOT NULL,
+        attributes TEXT NOT NULL,
+        source_hash TEXT NOT NULL,
+        first_seen_at INTEGER NOT NULL,
+        last_seen_at INTEGER NOT NULL,
+        last_modified_at INTEGER NOT NULL,
+        PRIMARY KEY(org_id, qualified_name)
+      );
+      CREATE INDEX IF NOT EXISTS ${tbl}_org ON ${tbl}(org_id);
+    `);
+        this.db
+            .prepare("INSERT OR IGNORE INTO _sfgraph_node_labels(label, table_name, created_at) VALUES (?, ?, ?)")
+            .run(label, tbl, Date.now());
+        this.nodeLabelCache.set(label, tbl);
+        return tbl;
+    }
+    ensureEdgeTable(relType) {
+        const cached = this.edgeRelCache.get(relType);
+        if (cached)
+            return cached;
+        const tbl = edgeTableName(relType);
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS ${tbl} (
+        org_id TEXT NOT NULL,
+        src_qname TEXT NOT NULL,
+        dst_qname TEXT NOT NULL,
+        attributes TEXT NOT NULL,
+        first_seen_at INTEGER NOT NULL,
+        last_seen_at INTEGER NOT NULL,
+        PRIMARY KEY(org_id, src_qname, dst_qname)
+      );
+      CREATE INDEX IF NOT EXISTS ${tbl}_rev ON ${tbl}(org_id, dst_qname);
+    `);
+        this.db
+            .prepare("INSERT OR IGNORE INTO _sfgraph_edge_types(rel_type, table_name, created_at) VALUES (?, ?, ?)")
+            .run(relType, tbl, Date.now());
+        this.edgeRelCache.set(relType, tbl);
+        return tbl;
+    }
+    upsertOrg(org) {
+        this.db
+            .prepare(`INSERT INTO _sfgraph_orgs(id, alias, instance_url, api_version, created_at, last_synced_at)
+         VALUES (?, ?, ?, ?, ?, ?)
+         ON CONFLICT(id) DO UPDATE SET alias=excluded.alias, instance_url=excluded.instance_url, api_version=excluded.api_version`)
+            .run(org.id, org.alias, org.instanceUrl, org.apiVersion, org.createdAt, org.lastSyncedAt ?? null);
+    }
+    getOrg(id) {
+        const row = this.db
+            .prepare("SELECT id, alias, instance_url, api_version, created_at, last_synced_at FROM _sfgraph_orgs WHERE id = ?")
+            .get(id);
+        if (!row)
+            return null;
+        const org = {
+            id: asOrgId(row.id),
+            alias: row.alias,
+            instanceUrl: row.instance_url,
+            apiVersion: row.api_version,
+            createdAt: row.created_at,
+        };
+        if (row.last_synced_at != null) {
+            org.lastSyncedAt = row.last_synced_at;
+        }
+        return org;
+    }
+    touchSync(orgId, iso) {
+        const ts = Date.parse(iso);
+        if (!Number.isFinite(ts)) {
+            throw new StorageError(`touchSync: invalid ISO timestamp ${JSON.stringify(iso)}`);
+        }
+        this.db.prepare("UPDATE _sfgraph_orgs SET last_synced_at = ? WHERE id = ?").run(ts, orgId);
+    }
+    deleteNode(orgId, qname) {
+        const apply = this.db.transaction(() => {
+            const idx = this.db
+                .prepare("SELECT label FROM _sfgraph_node_index WHERE org_id = ? AND qualified_name = ?")
+                .get(orgId, qname);
+            if (idx) {
+                const tbl = this.nodeLabelCache.get(idx.label);
+                if (tbl) {
+                    this.db
+                        .prepare(`DELETE FROM ${tbl} WHERE org_id = ? AND qualified_name = ?`)
+                        .run(orgId, qname);
+                }
+                this.db
+                    .prepare("DELETE FROM _sfgraph_node_index WHERE org_id = ? AND qualified_name = ?")
+                    .run(orgId, qname);
+            }
+        });
+        apply();
+    }
+    deleteEdgesFor(orgId, qname) {
+        const apply = this.db.transaction(() => {
+            for (const tbl of this.edgeRelCache.values()) {
+                this.db
+                    .prepare(`DELETE FROM ${tbl} WHERE org_id = ? AND (src_qname = ? OR dst_qname = ?)`)
+                    .run(orgId, qname, qname);
+            }
+        });
+        apply();
+    }
+    mergeNodes(facts) {
+        if (facts.length === 0)
+            return { inserted: 0, updated: 0, unchanged: 0 };
+        const buckets = new Map();
+        for (const f of facts) {
+            validateLabel(f.label);
+            const arr = buckets.get(f.label) ?? [];
+            arr.push(f);
+            buckets.set(f.label, arr);
+        }
+        let inserted = 0;
+        let updated = 0;
+        let unchanged = 0;
+        const apply = this.db.transaction(() => {
+            for (const [label, bucket] of buckets) {
+                const tbl = this.ensureNodeTable(label);
+                const selectStmt = this.db.prepare(`SELECT source_hash, first_seen_at FROM ${tbl} WHERE org_id = ? AND qualified_name = ?`);
+                const insertStmt = this.db.prepare(`INSERT INTO ${tbl}(org_id, qualified_name, attributes, source_hash, first_seen_at, last_seen_at, last_modified_at)
+           VALUES (?, ?, ?, ?, ?, ?, ?)`);
+                const updateChangedStmt = this.db.prepare(`UPDATE ${tbl} SET attributes = ?, source_hash = ?, last_seen_at = ?, last_modified_at = ? WHERE org_id = ? AND qualified_name = ?`);
+                const updateUnchangedStmt = this.db.prepare(`UPDATE ${tbl} SET last_seen_at = ? WHERE org_id = ? AND qualified_name = ?`);
+                const indexStmt = this.db.prepare(`INSERT INTO _sfgraph_node_index(org_id, qualified_name, label) VALUES (?, ?, ?)
+           ON CONFLICT(org_id, qualified_name) DO UPDATE SET label=excluded.label`);
+                for (const fact of bucket) {
+                    const existing = selectStmt.get(fact.orgId, fact.qualifiedName);
+                    const attrsJson = JSON.stringify(fact.attributes);
+                    if (!existing) {
+                        insertStmt.run(fact.orgId, fact.qualifiedName, attrsJson, fact.sourceHash, fact.firstSeenAt, fact.lastSeenAt, fact.lastModifiedAt);
+                        indexStmt.run(fact.orgId, fact.qualifiedName, label);
+                        inserted += 1;
+                    }
+                    else if (existing.source_hash !== fact.sourceHash) {
+                        updateChangedStmt.run(attrsJson, fact.sourceHash, fact.lastSeenAt, fact.lastModifiedAt, fact.orgId, fact.qualifiedName);
+                        updated += 1;
+                    }
+                    else {
+                        updateUnchangedStmt.run(fact.lastSeenAt, fact.orgId, fact.qualifiedName);
+                        unchanged += 1;
+                    }
+                }
+            }
+        });
+        apply();
+        return { inserted, updated, unchanged };
+    }
+    mergeEdges(facts) {
+        if (facts.length === 0)
+            return { inserted: 0, updated: 0, unchanged: 0 };
+        const buckets = new Map();
+        for (const f of facts) {
+            validateRelType(f.relType);
+            const arr = buckets.get(f.relType) ?? [];
+            arr.push(f);
+            buckets.set(f.relType, arr);
+        }
+        let inserted = 0;
+        let updated = 0;
+        let unchanged = 0;
+        const apply = this.db.transaction(() => {
+            for (const [relType, bucket] of buckets) {
+                const tbl = this.ensureEdgeTable(relType);
+                const selectStmt = this.db.prepare(`SELECT attributes, first_seen_at FROM ${tbl} WHERE org_id = ? AND src_qname = ? AND dst_qname = ?`);
+                const insertStmt = this.db.prepare(`INSERT INTO ${tbl}(org_id, src_qname, dst_qname, attributes, first_seen_at, last_seen_at) VALUES (?, ?, ?, ?, ?, ?)`);
+                const updateChangedStmt = this.db.prepare(`UPDATE ${tbl} SET attributes = ?, last_seen_at = ? WHERE org_id = ? AND src_qname = ? AND dst_qname = ?`);
+                const updateSeenStmt = this.db.prepare(`UPDATE ${tbl} SET last_seen_at = ? WHERE org_id = ? AND src_qname = ? AND dst_qname = ?`);
+                for (const fact of bucket) {
+                    const existing = selectStmt.get(fact.orgId, fact.srcQualifiedName, fact.dstQualifiedName);
+                    const attrsJson = JSON.stringify(fact.attributes);
+                    if (!existing) {
+                        insertStmt.run(fact.orgId, fact.srcQualifiedName, fact.dstQualifiedName, attrsJson, fact.firstSeenAt, fact.lastSeenAt);
+                        inserted += 1;
+                    }
+                    else if (existing.attributes !== attrsJson) {
+                        updateChangedStmt.run(attrsJson, fact.lastSeenAt, fact.orgId, fact.srcQualifiedName, fact.dstQualifiedName);
+                        updated += 1;
+                    }
+                    else {
+                        updateSeenStmt.run(fact.lastSeenAt, fact.orgId, fact.srcQualifiedName, fact.dstQualifiedName);
+                        unchanged += 1;
+                    }
+                }
+            }
+        });
+        apply();
+        return { inserted, updated, unchanged };
+    }
+    getNode(orgId, qname) {
+        const idx = this.db
+            .prepare("SELECT label FROM _sfgraph_node_index WHERE org_id = ? AND qualified_name = ?")
+            .get(orgId, qname);
+        if (!idx)
+            return null;
+        const tbl = this.nodeLabelCache.get(idx.label);
+        if (!tbl)
+            return null;
+        const row = this.db
+            .prepare(`SELECT org_id, qualified_name, attributes, source_hash, first_seen_at, last_seen_at, last_modified_at FROM ${tbl} WHERE org_id = ? AND qualified_name = ?`)
+            .get(orgId, qname);
+        if (!row)
+            return null;
+        return rowToNode(row, idx.label);
+    }
+    listNodesByLabel(orgId, label, limit) {
+        validateLabel(label);
+        const tbl = this.nodeLabelCache.get(label);
+        if (!tbl)
+            return [];
+        const sql = `SELECT org_id, qualified_name, attributes, source_hash, first_seen_at, last_seen_at, last_modified_at FROM ${tbl} WHERE org_id = ?${typeof limit === "number" ? " LIMIT ?" : ""}`;
+        const params = [orgId];
+        if (typeof limit === "number")
+            params.push(limit);
+        const rows = this.db.prepare(sql).all(...params);
+        return rows.map((r) => rowToNode(r, label));
+    }
+    listEdgesFrom(orgId, src, relType) {
+        const out = [];
+        const types = relType ? [relType] : Array.from(this.edgeRelCache.keys());
+        for (const t of types) {
+            const tbl = this.edgeRelCache.get(t);
+            if (!tbl)
+                continue;
+            const rows = this.db
+                .prepare(`SELECT org_id, src_qname, dst_qname, attributes, first_seen_at, last_seen_at FROM ${tbl} WHERE org_id = ? AND src_qname = ?`)
+                .all(orgId, src);
+            for (const r of rows)
+                out.push(rowToEdge(r, t));
+        }
+        return out;
+    }
+    listEdgesTo(orgId, dst, relType) {
+        const out = [];
+        const types = relType ? [relType] : Array.from(this.edgeRelCache.keys());
+        for (const t of types) {
+            const tbl = this.edgeRelCache.get(t);
+            if (!tbl)
+                continue;
+            const rows = this.db
+                .prepare(`SELECT org_id, src_qname, dst_qname, attributes, first_seen_at, last_seen_at FROM ${tbl} WHERE org_id = ? AND dst_qname = ?`)
+                .all(orgId, dst);
+            for (const r of rows)
+                out.push(rowToEdge(r, t));
+        }
+        return out;
+    }
+    /**
+     * Return every qualified name persisted for `orgId` across all label tables.
+     * Used by full-sync deletion detection to compute the difference between
+     * what was previously known and what the current sync touched.
+     */
+    listAllQnames(orgId) {
+        const out = [];
+        for (const tbl of this.nodeLabelCache.values()) {
+            const rows = this.db
+                .prepare(`SELECT qualified_name FROM ${tbl} WHERE org_id = ?`)
+                .all(orgId);
+            for (const r of rows)
+                out.push(r.qualified_name);
+        }
+        return out;
+    }
+    countNodes(orgId) {
+        let total = 0;
+        for (const tbl of this.nodeLabelCache.values()) {
+            const row = this.db.prepare(`SELECT COUNT(*) AS c FROM ${tbl} WHERE org_id = ?`).get(orgId);
+            total += row?.c ?? 0;
+        }
+        return total;
+    }
+    countEdges(orgId) {
+        let total = 0;
+        for (const tbl of this.edgeRelCache.values()) {
+            const row = this.db.prepare(`SELECT COUNT(*) AS c FROM ${tbl} WHERE org_id = ?`).get(orgId);
+            total += row?.c ?? 0;
+        }
+        return total;
+    }
+    transaction(fn) {
+        return this.db.transaction(fn)();
+    }
+    upsertSnippet(rec) {
+        const existing = this.db
+            .prepare("SELECT source_hash FROM _sfgraph_snippets WHERE org_id = ? AND qualified_name = ?")
+            .get(rec.orgId, rec.qualifiedName);
+        if (existing && existing.source_hash === rec.sourceHash) {
+            return { inserted: false, updated: false, unchanged: true };
+        }
+        if (existing) {
+            this.db
+                .prepare(`UPDATE _sfgraph_snippets
+             SET source_format = ?, source_text = ?, start_line = ?, end_line = ?,
+                 source_hash = ?, llm_explanation = NULL, explained_at = NULL
+           WHERE org_id = ? AND qualified_name = ?`)
+                .run(rec.sourceFormat, rec.sourceText, rec.startLine ?? null, rec.endLine ?? null, rec.sourceHash, rec.orgId, rec.qualifiedName);
+            return { inserted: false, updated: true, unchanged: false };
+        }
+        this.db
+            .prepare(`INSERT INTO _sfgraph_snippets
+           (org_id, qualified_name, source_format, source_text, start_line, end_line, source_hash, llm_explanation, explained_at)
+         VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`)
+            .run(rec.orgId, rec.qualifiedName, rec.sourceFormat, rec.sourceText, rec.startLine ?? null, rec.endLine ?? null, rec.sourceHash, rec.llmExplanation ?? null, rec.explainedAt ?? null);
+        return { inserted: true, updated: false, unchanged: false };
+    }
+    getSnippet(orgId, qname) {
+        const row = this.db
+            .prepare(`SELECT org_id, qualified_name, source_format, source_text, start_line, end_line,
+                source_hash, llm_explanation, explained_at
+           FROM _sfgraph_snippets WHERE org_id = ? AND qualified_name = ?`)
+            .get(orgId, qname);
+        if (!row)
+            return null;
+        const rec = {
+            orgId: asOrgId(row.org_id),
+            qualifiedName: asQualifiedName(row.qualified_name),
+            sourceFormat: row.source_format,
+            sourceText: row.source_text,
+            sourceHash: asSha256(row.source_hash),
+        };
+        if (row.start_line != null)
+            rec.startLine = row.start_line;
+        if (row.end_line != null)
+            rec.endLine = row.end_line;
+        if (row.llm_explanation != null)
+            rec.llmExplanation = row.llm_explanation;
+        if (row.explained_at != null)
+            rec.explainedAt = row.explained_at;
+        return rec;
+    }
+    updateSnippetExplanation(orgId, qname, llmExplanation, explainedAt) {
+        const r = this.db
+            .prepare(`UPDATE _sfgraph_snippets
+            SET llm_explanation = ?, explained_at = ?
+          WHERE org_id = ? AND qualified_name = ?`)
+            .run(llmExplanation, explainedAt, orgId, qname);
+        return r.changes > 0;
+    }
+    listSnippetsMissingExplanation(orgId, limit) {
+        const sql = `SELECT org_id, qualified_name, source_format, source_text, start_line, end_line,
+                        source_hash, llm_explanation, explained_at
+                   FROM _sfgraph_snippets
+                  WHERE org_id = ? AND llm_explanation IS NULL${typeof limit === "number" ? " LIMIT ?" : ""}`;
+        const params = [orgId];
+        if (typeof limit === "number")
+            params.push(limit);
+        const rows = this.db.prepare(sql).all(...params);
+        return rows.map((row) => {
+            const rec = {
+                orgId: asOrgId(row.org_id),
+                qualifiedName: asQualifiedName(row.qualified_name),
+                sourceFormat: row.source_format,
+                sourceText: row.source_text,
+                sourceHash: asSha256(row.source_hash),
+            };
+            if (row.start_line != null)
+                rec.startLine = row.start_line;
+            if (row.end_line != null)
+                rec.endLine = row.end_line;
+            return rec;
+        });
+    }
+    // Helpers for shared usage
+    getNodeLabelTables() {
+        return new Map(this.nodeLabelCache);
+    }
+    getEdgeRelTables() {
+        return new Map(this.edgeRelCache);
+    }
+    // For tests/diagnostics
+    _explainReverseEdgeQuery(relType) {
+        const tbl = this.edgeRelCache.get(relType);
+        if (!tbl)
+            throw new StorageError(`unknown rel type ${relType}`);
+        const rows = this.db
+            .prepare(`EXPLAIN QUERY PLAN SELECT * FROM ${tbl} WHERE org_id = ? AND dst_qname = ?`)
+            .all("o", "x");
+        return rows.map((r) => r.detail).join(" | ");
+    }
+}
+//# sourceMappingURL=graph-store.js.map

package/dist/storage/sqlite/graph-store.js.map

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

package/dist/storage/sqlite/load-better-sqlite3.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Centralized loader for `better-sqlite3` that converts the cryptic native
+ * "NODE_MODULE_VERSION X / was compiled against Y" runtime error into a
+ * `SfgraphError(E_NATIVE_ABI_MISMATCH, ...)` with actionable, copy-paste
+ * recovery commands.
+ *
+ * The most common cause is an IDE-spawned MCP child running a different Node
+ * binary than the shell that did `pnpm install` / `pnpm rebuild`. Cursor and
+ * VS Code ship their own Node; if the shell Node ABI differs, the prebuilt
+ * binding loaded into the IDE child fails to dlopen.
+ */
+import { SfgraphError } from "@ryanstark24/sfgraph-shared";
+type Loader = ((id: string) => unknown) & {
+    resolve?: (id: string) => string;
+    cache?: Record<string, unknown>;
+};
+/** ABI mismatch detection heuristic. Matches the V8 / Node-API messages
+ *  produced when the loaded `.node` file was compiled against a different
+ *  NODE_MODULE_VERSION than the running process. */
+export declare function isAbiMismatch(message: string): boolean;
+/**
+ * If `err` is a native-binding ABI mismatch (matched by `isAbiMismatch`),
+ * convert it to a `SfgraphError(E_NATIVE_ABI_MISMATCH, ...)` with the
+ * full diagnostic message and recovery commands. Otherwise return null
+ * (caller should rethrow the original).
+ *
+ * Use this around `new Database(...)` calls or in `catch` blocks where
+ * `import Database from "better-sqlite3"` was used statically (the binding
+ * load is deferred until the first construction in some Node versions).
+ */
+export declare function wrapAbiError(err: unknown): SfgraphError | null;
+export interface LoadOpts {
+    /** When true, on ABI mismatch attempt `npm run build-release` against the
+     *  currently-running Node, then retry once. Default false (preserves the
+     *  library-callable behaviour for test fixtures). */
+    autoRebuild?: boolean;
+}
+/**
+ * Load `better-sqlite3` via the provided `require` (or one we synthesize from
+ * import.meta.url). On ABI mismatch:
+ *   - if `autoRebuild` is true, attempt a from-source rebuild against the
+ *     currently-running Node and retry the load. This eliminates the
+ *     "two Nodes on PATH" foot-gun for nvm + Homebrew users.
+ *   - otherwise (or if the rebuild fails), throw
+ *     `SfgraphError(E_NATIVE_ABI_MISMATCH)` with copy-paste recovery.
+ * On any other failure, rethrow as-is.
+ */
+export declare function loadBetterSqlite3<T = unknown>(requireFn?: Loader, opts?: LoadOpts): T;
+export {};
+//# sourceMappingURL=load-better-sqlite3.d.ts.map

package/dist/storage/sqlite/load-better-sqlite3.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-better-sqlite3.d.ts","sourceRoot":"","sources":["../../../src/storage/sqlite/load-better-sqlite3.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAMH,OAAO,EAAa,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAEtE,KAAK,MAAM,GAAG,CAAC,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,GAAG;IACxC,OAAO,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,MAAM,CAAC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC,CAAC;AAEF;;oDAEoD;AACpD,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAMtD;AA6DD;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,GAAG,YAAY,GAAG,IAAI,CAS9D;AA6DD,MAAM,WAAW,QAAQ;IACvB;;yDAEqD;IACrD,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,GAAG,OAAO,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,IAAI,GAAE,QAAa,GAAG,CAAC,CAuCzF"}