@lzehrung/codegraph 2.1.0

package/dist/sqlite/query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.js","sourceRoot":"","sources":["../../src/sqlite/query.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAE5D,OAAO,EAAE,4BAA4B,EAAE,0BAA0B,EAAE,MAAM,eAAe,CAAC;AACzF,OAAO,EACL,wBAAwB,EACxB,yBAAyB,EACzB,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAQrD,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,UAAkB,EAClB,GAAW,EACX,SAAwC,EAAE,EAC1C,OAAoC;IAEpC,OAAO,MAAM,0BAA0B,CAAC,UAAU,EAAE,CAAC,EAAE,EAAE,EAAE;QACzD,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YAC7B,4BAA4B,CAAC,IAAI,CAAC,CAAC;YACnC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACtD,MAAM,aAAa,GAAG,OAAO,EAAE,OAAO,CAAC;YACvC,MAAM,OAAO,GACX,aAAa,KAAK,SAAS;gBACzB,CAAC,CAAC,oBAAoB;gBACtB,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,oBAAoB,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;YAC7E,MAAM,QAAQ,GAAG,OAAO,EAAE,QAAQ,IAAI,yBAAyB,CAAC;YAChE,MAAM,YAAY,GAAG,OAAO,EAAE,YAAY,IAAI,qBAAqB,CAAC;YAEpE,oFAAoF;YACpF,OAAO,wBAAwB,CAAC,OAAO,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,MAAM,CAA6B,EAAE;gBAC/F,OAAO;gBACP,QAAQ;gBACR,YAAY;aACb,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,qBAAqB,CAAC,KAAK,CAAC,EAAE,CAAC;gBACjC,MAAM,IAAI,KAAK,CAAC,4FAA4F,CAAC,CAAC;YAChH,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/sqlite/rowBounds.d.ts

@@ -0,0 +1,24 @@
+import type { RawSqlResult } from "./types.js";
+export declare const DEFAULT_SQLITE_ROW_LIMIT = 100;
+export declare const MAX_SQLITE_ROW_LIMIT = 500;
+export declare const DEFAULT_SQLITE_BYTE_LIMIT = 200000;
+export declare const MAX_SQLITE_CELL_BYTES = 8000;
+export declare const SQLITE_TRUNCATED_MARKER = "...[truncated]";
+export declare function normalizeSqliteRowLimit(limit: number | undefined): number;
+export type BoundRawSqlCollectOptions = {
+    maxRows: number;
+    maxBytes?: number | undefined;
+    maxCellBytes?: number | undefined;
+};
+/**
+ * Materialize rows from an already-open iterator while enforcing per-cell and
+ * cumulative byte budgets *before* each append. Callers must not buffer raw rows
+ * ahead of this helper.
+ */
+export declare function collectBoundedRawSqlRows(columns: string[], rowIterator: Iterable<Array<unknown>>, options: BoundRawSqlCollectOptions): RawSqlResult;
+export declare function boundRawSqlResult(result: RawSqlResult, byteLimit: number): RawSqlResult;
+export declare function normalizeSqliteValue(value: unknown, maxCellBytes?: number): {
+    value: unknown;
+    truncated: boolean;
+};
+//# sourceMappingURL=rowBounds.d.ts.map

package/dist/sqlite/rowBounds.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rowBounds.d.ts","sourceRoot":"","sources":["../../src/sqlite/rowBounds.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,eAAO,MAAM,wBAAwB,MAAM,CAAC;AAC5C,eAAO,MAAM,oBAAoB,MAAM,CAAC;AACxC,eAAO,MAAM,yBAAyB,SAAU,CAAC;AACjD,eAAO,MAAM,qBAAqB,OAAQ,CAAC;AAC3C,eAAO,MAAM,uBAAuB,mBAAmB,CAAC;AAExD,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAGzE;AAED,MAAM,MAAM,yBAAyB,GAAG;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACnC,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,MAAM,EAAE,EACjB,WAAW,EAAE,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,EACrC,OAAO,EAAE,yBAAyB,GACjC,YAAY,CAyCd;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,GAAG,YAAY,CAUvF;AAED,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,OAAO,EACd,YAAY,GAAE,MAA8B,GAC3C;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,CAUxC"}

package/dist/sqlite/rowBounds.js

@@ -0,0 +1,95 @@
+export const DEFAULT_SQLITE_ROW_LIMIT = 100;
+export const MAX_SQLITE_ROW_LIMIT = 500;
+export const DEFAULT_SQLITE_BYTE_LIMIT = 200_000;
+export const MAX_SQLITE_CELL_BYTES = 8_000;
+export const SQLITE_TRUNCATED_MARKER = "...[truncated]";
+export function normalizeSqliteRowLimit(limit) {
+    if (typeof limit !== "number" || !Number.isFinite(limit))
+        return DEFAULT_SQLITE_ROW_LIMIT;
+    return Math.min(MAX_SQLITE_ROW_LIMIT, Math.max(0, Math.floor(limit)));
+}
+/**
+ * Materialize rows from an already-open iterator while enforcing per-cell and
+ * cumulative byte budgets *before* each append. Callers must not buffer raw rows
+ * ahead of this helper.
+ */
+export function collectBoundedRawSqlRows(columns, rowIterator, options) {
+    const maxCellBytes = options.maxCellBytes ?? MAX_SQLITE_CELL_BYTES;
+    const maxRows = Math.max(0, Math.floor(options.maxRows));
+    const maxBytes = options.maxBytes;
+    const rows = [];
+    let bytes = Buffer.byteLength(JSON.stringify({ columns, rows: [] }), "utf8");
+    let truncated = false;
+    let sawExtraRow = false;
+    for (const rawRow of rowIterator) {
+        if (rows.length >= maxRows) {
+            sawExtraRow = true;
+            truncated = true;
+            break;
+        }
+        let cellTruncated = false;
+        const row = rawRow.map((value) => {
+            const normalized = normalizeSqliteValue(value, maxCellBytes);
+            if (normalized.truncated)
+                cellTruncated = true;
+            return normalized.value;
+        });
+        if (cellTruncated)
+            truncated = true;
+        const rowBytes = Buffer.byteLength(JSON.stringify(row), "utf8");
+        if (maxBytes !== undefined && bytes + rowBytes > maxBytes) {
+            truncated = true;
+            break;
+        }
+        rows.push(row);
+        bytes += rowBytes;
+    }
+    return {
+        columns,
+        rows,
+        rowLimit: maxRows,
+        ...(maxBytes !== undefined ? { byteLimit: maxBytes, bytes } : { bytes }),
+        ...(truncated || sawExtraRow ? { truncated: true } : {}),
+    };
+}
+export function boundRawSqlResult(result, byteLimit) {
+    const collected = collectBoundedRawSqlRows(result.columns, result.rows, {
+        maxRows: result.rowLimit ?? result.rows.length,
+        maxBytes: byteLimit,
+    });
+    return {
+        ...result,
+        ...collected,
+        truncated: Boolean(result.truncated || collected.truncated),
+    };
+}
+export function normalizeSqliteValue(value, maxCellBytes = MAX_SQLITE_CELL_BYTES) {
+    if (typeof value === "string") {
+        const truncated = Buffer.byteLength(value, "utf8") > maxCellBytes;
+        return { value: truncateUtf8(value, maxCellBytes), truncated };
+    }
+    if (typeof value === "bigint")
+        return { value: value.toString(), truncated: false };
+    if (value instanceof Uint8Array) {
+        return { value: `<${value.byteLength} bytes>`, truncated: true };
+    }
+    return { value, truncated: false };
+}
+function truncateUtf8(value, maxBytes) {
+    if (Buffer.byteLength(value, "utf8") <= maxBytes)
+        return value;
+    const marker = SQLITE_TRUNCATED_MARKER;
+    const markerBytes = Buffer.byteLength(marker, "utf8");
+    const budget = Math.max(0, maxBytes - markerBytes);
+    let output = "";
+    let bytes = 0;
+    for (const char of value) {
+        const charBytes = Buffer.byteLength(char, "utf8");
+        if (bytes + charBytes > budget)
+            break;
+        output += char;
+        bytes += charBytes;
+    }
+    return `${output}${marker}`;
+}
+//# sourceMappingURL=rowBounds.js.map

package/dist/sqlite/rowBounds.js.map

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

package/dist/sqlite/schema.d.ts

@@ -0,0 +1,5 @@
+import type { SqliteDatabase } from "../sqlite-driver.js";
+export declare const SQLITE_SCHEMA_VERSION = 2;
+export declare function readGraphSchemaVersion(db: SqliteDatabase): number;
+export declare const ensureSchema: (db: SqliteDatabase) => void;
+//# sourceMappingURL=schema.d.ts.map

package/dist/sqlite/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/sqlite/schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAG1D,eAAO,MAAM,qBAAqB,IAAI,CAAC;AAkBvC,wBAAgB,sBAAsB,CAAC,EAAE,EAAE,cAAc,GAAG,MAAM,CAWjE;AAmJD,eAAO,MAAM,YAAY,GAAI,IAAI,cAAc,SAuE9C,CAAC"}

package/dist/sqlite/schema.js

@@ -0,0 +1,243 @@
+import { toSqliteText } from "./common.js";
+export const SQLITE_SCHEMA_VERSION = 2;
+const GRAPH_SCHEMA_VERSION_KEY = "schema_version";
+const hasColumn = (db, table, column) => {
+    const rows = db.prepare(`PRAGMA table_info(${table});`).raw().all();
+    for (const row of rows) {
+        if (!Array.isArray(row))
+            continue;
+        const name = row[1] ? String(row[1]) : "";
+        if (name === column)
+            return true;
+    }
+    return false;
+};
+const ensureSymbolsVisibilityColumn = (db) => {
+    if (hasColumn(db, "symbols", "visibility"))
+        return;
+    db.exec("ALTER TABLE symbols ADD COLUMN visibility TEXT;");
+};
+export function readGraphSchemaVersion(db) {
+    try {
+        const row = db.prepare("SELECT value FROM graph_metadata WHERE key = ?").get(GRAPH_SCHEMA_VERSION_KEY);
+        if (!row?.value)
+            return 0;
+        const version = Number(String(row.value));
+        if (!Number.isInteger(version) || version < 0)
+            return 0;
+        return version;
+    }
+    catch {
+        return 0;
+    }
+}
+function writeGraphSchemaVersion(db, version) {
+    db.prepare("INSERT OR REPLACE INTO graph_metadata (key, value) VALUES (?, ?);").run([
+        GRAPH_SCHEMA_VERSION_KEY,
+        String(version),
+    ]);
+}
+function migrateGraphSchema(db, fromVersion) {
+    let version = fromVersion;
+    if (version < 1) {
+        version = 1;
+    }
+    if (version < 2) {
+        ensureSymbolsVisibilityColumn(db);
+        version = 2;
+    }
+    if (version !== fromVersion) {
+        writeGraphSchemaVersion(db, version);
+    }
+}
+const ensureGraphIndexes = (db) => {
+    const indexSpecs = [
+        {
+            name: "idx_files_external",
+            sql: "CREATE INDEX idx_files_external ON files(is_external);",
+        },
+        {
+            name: "idx_symbols_file",
+            sql: "CREATE INDEX idx_symbols_file ON symbols(file);",
+        },
+        {
+            name: "idx_symbols_name",
+            sql: "CREATE INDEX idx_symbols_name ON symbols(name);",
+        },
+        {
+            name: "idx_symbols_lower_name",
+            sql: "CREATE INDEX idx_symbols_lower_name ON symbols(lower(name));",
+        },
+        {
+            name: "idx_symbols_kind",
+            sql: "CREATE INDEX idx_symbols_kind ON symbols(kind);",
+        },
+        {
+            name: "idx_symbols_name_kind",
+            sql: "CREATE INDEX idx_symbols_name_kind ON symbols(name, kind);",
+        },
+        {
+            name: "idx_symbols_file_kind",
+            sql: "CREATE INDEX idx_symbols_file_kind ON symbols(file, kind);",
+        },
+        {
+            name: "idx_symbols_kind_file",
+            sql: "CREATE INDEX idx_symbols_kind_file ON symbols(kind, file);",
+        },
+        {
+            name: "idx_symbols_kind_id",
+            sql: "CREATE INDEX idx_symbols_kind_id ON symbols(kind, id);",
+        },
+        {
+            name: "idx_symbols_kind_complexity",
+            sql: "CREATE INDEX idx_symbols_kind_complexity ON symbols(kind, complexity DESC);",
+        },
+        {
+            name: "idx_file_edges_from",
+            sql: "CREATE INDEX idx_file_edges_from ON file_edges(from_path);",
+        },
+        {
+            name: "idx_file_edges_to",
+            sql: "CREATE INDEX idx_file_edges_to ON file_edges(to_path);",
+        },
+        {
+            name: "idx_file_edges_type",
+            sql: "CREATE INDEX idx_file_edges_type ON file_edges(to_type);",
+        },
+        {
+            name: "idx_file_edges_from_file",
+            sql: "CREATE INDEX idx_file_edges_from_file ON file_edges(from_path, to_path) WHERE to_type = 'file';",
+        },
+        {
+            name: "idx_file_edges_to_file",
+            sql: "CREATE INDEX idx_file_edges_to_file ON file_edges(to_path, from_path) WHERE to_type = 'file';",
+        },
+        {
+            name: "idx_symbol_edges_from",
+            sql: "CREATE INDEX idx_symbol_edges_from ON symbol_edges(from_id);",
+        },
+        {
+            name: "idx_symbol_edges_to",
+            sql: "CREATE INDEX idx_symbol_edges_to ON symbol_edges(to_id);",
+        },
+        {
+            name: "idx_symbol_edges_label",
+            sql: "CREATE INDEX idx_symbol_edges_label ON symbol_edges(label);",
+        },
+        {
+            name: "idx_symbol_edges_label_to",
+            sql: "CREATE INDEX idx_symbol_edges_label_to ON symbol_edges(label, to_id);",
+        },
+        {
+            name: "idx_symbol_edges_label_from",
+            sql: "CREATE INDEX idx_symbol_edges_label_from ON symbol_edges(label, from_id);",
+        },
+        {
+            name: "idx_symbol_edges_label_from_to",
+            sql: "CREATE INDEX idx_symbol_edges_label_from_to ON symbol_edges(label, from_id, to_id);",
+        },
+        {
+            name: "idx_graph_snapshots_created_at",
+            sql: "CREATE INDEX idx_graph_snapshots_created_at ON graph_snapshots(created_at DESC);",
+        },
+        {
+            name: "idx_graph_snapshot_files_snapshot",
+            sql: "CREATE INDEX idx_graph_snapshot_files_snapshot ON graph_snapshot_files(snapshot_id);",
+        },
+        {
+            name: "idx_graph_snapshot_files_path",
+            sql: "CREATE INDEX idx_graph_snapshot_files_path ON graph_snapshot_files(file_path);",
+        },
+    ];
+    const indexRows = db
+        .prepare("SELECT name FROM sqlite_master WHERE type = 'index' AND name NOT LIKE 'sqlite_%';")
+        .raw()
+        .all();
+    const existingIndexes = new Set();
+    for (const row of indexRows) {
+        if (!Array.isArray(row))
+            continue;
+        const name = toSqliteText(row[0]);
+        if (name)
+            existingIndexes.add(name);
+    }
+    let createdIndex = false;
+    for (const spec of indexSpecs) {
+        if (existingIndexes.has(spec.name))
+            continue;
+        db.exec(spec.sql);
+        createdIndex = true;
+    }
+    if (createdIndex) {
+        db.exec("ANALYZE;");
+    }
+    return createdIndex;
+};
+export const ensureSchema = (db) => {
+    const currentVersion = readGraphSchemaVersion(db);
+    if (currentVersion > SQLITE_SCHEMA_VERSION) {
+        throw new Error(`Unsupported codegraph SQLite schema version ${currentVersion}; this version supports up to ${SQLITE_SCHEMA_VERSION}.`);
+    }
+    db.pragma("journal_mode = WAL");
+    db.pragma("synchronous = NORMAL");
+    db.pragma("temp_store = MEMORY");
+    db.pragma("foreign_keys = ON");
+    db.exec(`
+    CREATE TABLE IF NOT EXISTS files (
+      path TEXT PRIMARY KEY,
+      is_external INTEGER NOT NULL DEFAULT 0
+    );
+    CREATE TABLE IF NOT EXISTS symbols (
+      id TEXT PRIMARY KEY,
+      file TEXT NOT NULL,
+      name TEXT NOT NULL,
+      kind TEXT,
+      docstring TEXT,
+      line_span INTEGER,
+      complexity INTEGER,
+      visibility TEXT,
+      FOREIGN KEY(file) REFERENCES files(path)
+    );
+    CREATE TABLE IF NOT EXISTS file_edges (
+      from_path TEXT NOT NULL,
+      to_path TEXT NOT NULL,
+      to_type TEXT NOT NULL,
+      raw TEXT,
+      type_only INTEGER,
+      FOREIGN KEY(from_path) REFERENCES files(path),
+      FOREIGN KEY(to_path) REFERENCES files(path)
+    );
+    CREATE TABLE IF NOT EXISTS symbol_edges (
+      from_id TEXT NOT NULL,
+      to_id TEXT NOT NULL,
+      label TEXT,
+      FOREIGN KEY(from_id) REFERENCES symbols(id),
+      FOREIGN KEY(to_id) REFERENCES symbols(id)
+    );
+    CREATE TABLE IF NOT EXISTS graph_metadata (
+      key TEXT PRIMARY KEY,
+      value TEXT NOT NULL
+    );
+    CREATE TABLE IF NOT EXISTS graph_snapshots (
+      id INTEGER PRIMARY KEY AUTOINCREMENT,
+      created_at INTEGER NOT NULL,
+      mode TEXT NOT NULL,
+      changed_files INTEGER NOT NULL,
+      deleted_files INTEGER NOT NULL,
+      file_nodes INTEGER NOT NULL,
+      file_edges INTEGER NOT NULL,
+      symbol_nodes INTEGER NOT NULL,
+      symbol_edges INTEGER NOT NULL
+    );
+    CREATE TABLE IF NOT EXISTS graph_snapshot_files (
+      snapshot_id INTEGER NOT NULL,
+      file_path TEXT NOT NULL,
+      change_kind TEXT NOT NULL,
+      FOREIGN KEY(snapshot_id) REFERENCES graph_snapshots(id)
+    );
+  `);
+    migrateGraphSchema(db, currentVersion);
+    ensureGraphIndexes(db);
+    writeGraphSchemaVersion(db, SQLITE_SCHEMA_VERSION);
+};
+//# sourceMappingURL=schema.js.map

package/dist/sqlite/schema.js.map

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

package/dist/sqlite/types.d.ts

@@ -0,0 +1,77 @@
+import type { Graph } from "../types.js";
+import { type SymbolGraph } from "../graphs/symbol-graph.js";
+export type SqliteGraphOptions = {
+    fileGraph: Graph;
+    symbolGraph: SymbolGraph;
+    outputPath: string;
+    fileSignatures?: Iterable<{
+        path: string;
+        size: number;
+        mtimeMs: number;
+    }>;
+};
+export type SqliteGraphUpdateOptions = {
+    fileGraph: Graph;
+    symbolGraph: SymbolGraph;
+    outputPath: string;
+    changedFiles: string[];
+    deletedFiles?: string[];
+    /**
+     * When true, reconcile DB rows against the provided full graph for changed/deleted files.
+     * Use this with full project graphs for accurate incremental CI patching.
+     */
+    fullGraphSync?: boolean;
+};
+export type GraphQueryResult = {
+    kind: "mostCalledMethods";
+    results: Array<{
+        name: string;
+        file: string;
+        count: number;
+    }>;
+} | {
+    kind: "dependencyChain";
+    results: string[];
+} | {
+    kind: "controllersMostEndpoints";
+    results: Array<{
+        name: string;
+        file: string;
+        count: number;
+    }>;
+} | {
+    kind: "classesImplementing";
+    results: Array<{
+        name: string;
+        file: string;
+    }>;
+} | {
+    kind: "affectedFunctionsForModule";
+    results: Array<{
+        name: string;
+        file: string;
+    }>;
+} | {
+    kind: "highestComplexityClasses";
+    results: Array<{
+        name: string;
+        file: string;
+        complexity: number;
+    }>;
+} | {
+    kind: "highestComplexityFunctions";
+    results: Array<{
+        name: string;
+        file: string;
+        complexity: number;
+    }>;
+};
+export type RawSqlResult = {
+    columns: string[];
+    rows: Array<Array<unknown>>;
+    rowLimit?: number;
+    byteLimit?: number;
+    bytes?: number;
+    truncated?: boolean;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/sqlite/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/sqlite/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAE7D,MAAM,MAAM,kBAAkB,GAAG;IAC/B,SAAS,EAAE,KAAK,CAAC;IACjB,WAAW,EAAE,WAAW,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,QAAQ,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC5E,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACrC,SAAS,EAAE,KAAK,CAAC;IACjB,WAAW,EAAE,WAAW,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GACxB;IACE,IAAI,EAAE,mBAAmB,CAAC;IAC1B,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC/D,GACD;IAAE,IAAI,EAAE,iBAAiB,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,GAC9C;IACE,IAAI,EAAE,0BAA0B,CAAC;IACjC,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC/D,GACD;IACE,IAAI,EAAE,qBAAqB,CAAC;IAC5B,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAChD,GACD;IACE,IAAI,EAAE,4BAA4B,CAAC;IACnC,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAChD,GACD;IACE,IAAI,EAAE,0BAA0B,CAAC;IACjC,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACpE,GACD;IACE,IAAI,EAAE,4BAA4B,CAAC;IACnC,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACpE,CAAC;AAEN,MAAM,MAAM,YAAY,GAAG;IACzB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB,CAAC"}

package/dist/sqlite/types.js

@@ -0,0 +1,2 @@
+import {} from "../graphs/symbol-graph.js";
+//# sourceMappingURL=types.js.map

package/dist/sqlite/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/sqlite/types.ts"],"names":[],"mappings":"AACA,OAAO,EAAoB,MAAM,2BAA2B,CAAC"}

package/dist/sqlite/write.d.ts

@@ -0,0 +1,5 @@
+import type { SqliteGraphOptions, SqliteGraphUpdateOptions } from "./types.js";
+export declare const SQLITE_ARTIFACT_FILE_SIGNATURES_METADATA_KEY = "artifact_file_signatures_v1";
+export declare function writeGraphSqlite(options: SqliteGraphOptions): Promise<void>;
+export declare function updateGraphSqlite(options: SqliteGraphUpdateOptions): Promise<void>;
+//# sourceMappingURL=write.d.ts.map

package/dist/sqlite/write.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write.d.ts","sourceRoot":"","sources":["../../src/sqlite/write.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAI/E,eAAO,MAAM,4CAA4C,gCAAgC,CAAC;AA6O1F,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAwCjF;AAED,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC,CAoExF"}