@lzehrung/codegraph 2.1.0

package/dist/sqlite/write.js

@@ -0,0 +1,306 @@
+import {} from "../graphs/symbol-graph.js";
+import { execRowsParams } from "./common.js";
+import { withSqliteDatabase } from "./database.js";
+export const SQLITE_ARTIFACT_FILE_SIGNATURES_METADATA_KEY = "artifact_file_signatures_v1";
+function normalizeSqliteArtifactFileSignatures(signatures) {
+    const normalized = [...signatures].map((signature) => ({
+        path: signature.path,
+        size: signature.size,
+        mtimeMs: signature.mtimeMs,
+    }));
+    normalized.sort((left, right) => left.path.localeCompare(right.path));
+    return normalized;
+}
+function writeArtifactFileSignatures(db, signatures) {
+    db.prepare("INSERT OR REPLACE INTO graph_metadata (key, value) VALUES (?, ?);").run([
+        SQLITE_ARTIFACT_FILE_SIGNATURES_METADATA_KEY,
+        JSON.stringify(signatures),
+    ]);
+}
+function clearArtifactFileSignatures(db) {
+    db.prepare("DELETE FROM graph_metadata WHERE key = ?;").run([SQLITE_ARTIFACT_FILE_SIGNATURES_METADATA_KEY]);
+}
+const collectSymbolIdsForFiles = (symbolGraph, changedSet) => {
+    const ids = new Set();
+    for (const [id, node] of symbolGraph.nodes.entries()) {
+        if (changedSet.has(node.file))
+            ids.add(id);
+    }
+    return ids;
+};
+const symbolGraphEdgesForFiles = (symbolGraph, changedSet) => {
+    const edgeList = [];
+    for (const edge of symbolGraph.edges) {
+        const fromNode = symbolGraph.nodes.get(edge.from);
+        const toNode = symbolGraph.nodes.get(edge.to);
+        if (!fromNode || !toNode)
+            continue;
+        if (changedSet.has(fromNode.file) || changedSet.has(toNode.file)) {
+            edgeList.push(edge);
+        }
+    }
+    return edgeList;
+};
+const fileGraphEdgesForFiles = (fileGraph, changedSet) => fileGraph.edges.filter((edge) => changedSet.has(edge.from));
+const symbolGraphEdgesForSymbolIds = (symbolGraph, symbolIds) => {
+    const edgeList = [];
+    for (const edge of symbolGraph.edges) {
+        if (symbolIds.has(edge.from) || symbolIds.has(edge.to)) {
+            edgeList.push(edge);
+        }
+    }
+    return edgeList;
+};
+const insertFiles = (db, files) => {
+    const stmt = db.prepare("INSERT OR REPLACE INTO files (path, is_external) VALUES (?, ?);");
+    for (const file of files) {
+        stmt.run([file.path, file.isExternal ? 1 : 0]);
+    }
+};
+const dedupeFileEntries = (entries) => {
+    const unique = new Map();
+    for (const entry of entries) {
+        const existing = unique.get(entry.path);
+        if (existing === undefined) {
+            unique.set(entry.path, entry.isExternal);
+        }
+        else if (entry.isExternal) {
+            unique.set(entry.path, true);
+        }
+    }
+    return [...unique.entries()].map(([path, isExternal]) => ({
+        path,
+        isExternal,
+    }));
+};
+const insertSymbols = (db, nodes) => {
+    const stmt = db.prepare("INSERT OR REPLACE INTO symbols (id, file, name, kind, docstring, line_span, complexity, visibility) VALUES (?, ?, ?, ?, ?, ?, ?, ?);");
+    for (const node of nodes) {
+        stmt.run([
+            node.id,
+            node.file,
+            node.name,
+            node.kind,
+            node.docstring ?? null,
+            node.lineSpan ?? null,
+            node.complexity ?? null,
+            node.visibility ?? null,
+        ]);
+    }
+};
+const insertFileEdges = (db, edges) => {
+    const stmt = db.prepare("INSERT INTO file_edges (from_path, to_path, to_type, raw, type_only) VALUES (?, ?, ?, ?, ?);");
+    for (const edge of edges) {
+        const toPath = edge.to.type === "file" ? edge.to.path : edge.to.name;
+        stmt.run([edge.from, toPath, edge.to.type, edge.raw, edge.typeOnly ? 1 : 0]);
+    }
+};
+const insertSymbolEdges = (db, edges) => {
+    const stmt = db.prepare("INSERT INTO symbol_edges (from_id, to_id, label) VALUES (?, ?, ?);");
+    for (const edge of edges) {
+        stmt.run([edge.from, edge.to, edge.label ?? null]);
+    }
+};
+const clearCurrentGraphState = (db) => {
+    db.exec(`
+    DELETE FROM symbol_edges;
+    DELETE FROM file_edges;
+    DELETE FROM symbols;
+    DELETE FROM files;
+  `);
+};
+const readSymbolIdsForFiles = (db, files) => {
+    if (!files.length)
+        return [];
+    const placeholders = files.map(() => "?").join(", ");
+    const sql = `SELECT id FROM symbols WHERE file IN (${placeholders});`;
+    const values = execRowsParams(db, sql, files);
+    return values
+        .map((row) => {
+        const id = typeof row[0] === "string" ? row[0] : "";
+        return id || null;
+    })
+        .filter((id) => !!id);
+};
+const deleteBySymbolIds = (db, ids) => {
+    if (!ids.length)
+        return;
+    const placeholders = ids.map(() => "?").join(", ");
+    db.prepare(`DELETE FROM symbol_edges WHERE from_id IN (${placeholders});`).run(ids);
+    db.prepare(`DELETE FROM symbol_edges WHERE to_id IN (${placeholders});`).run(ids);
+    db.prepare(`DELETE FROM symbols WHERE id IN (${placeholders});`).run(ids);
+};
+const deleteFileEdgesForFiles = (db, files) => {
+    if (!files.length)
+        return;
+    const placeholders = files.map(() => "?").join(", ");
+    db.prepare(`DELETE FROM file_edges WHERE from_path IN (${placeholders});`).run(files);
+};
+const deleteFileEdgesToFiles = (db, files) => {
+    if (!files.length)
+        return;
+    const placeholders = files.map(() => "?").join(", ");
+    db.prepare(`DELETE FROM file_edges WHERE to_type = 'file' AND to_path IN (${placeholders});`).run(files);
+};
+const deleteFilesByPath = (db, files) => {
+    if (!files.length)
+        return;
+    const placeholders = files.map(() => "?").join(", ");
+    db.prepare(`DELETE FROM files WHERE path IN (${placeholders});`).run(files);
+};
+const recordGraphSnapshot = (db, options) => {
+    const snapshotStmt = db.prepare(`INSERT INTO graph_snapshots (
+      created_at,
+      mode,
+      changed_files,
+      deleted_files,
+      file_nodes,
+      file_edges,
+      symbol_nodes,
+      symbol_edges
+    ) VALUES (?, ?, ?, ?, ?, ?, ?, ?);`);
+    const result = snapshotStmt.run([
+        Date.now(),
+        options.mode,
+        options.changedFiles.length,
+        options.deletedFiles.length,
+        options.fileNodes,
+        options.fileEdges,
+        options.symbolNodes,
+        options.symbolEdges,
+    ]);
+    const snapshotId = Number(result.lastInsertRowid);
+    const fileRows = [
+        ...options.changedFiles.map((file) => ({
+            file,
+            kind: "changed",
+        })),
+        ...options.deletedFiles.map((file) => ({
+            file,
+            kind: "deleted",
+        })),
+    ];
+    if (!fileRows.length)
+        return;
+    const fileStmt = db.prepare("INSERT INTO graph_snapshot_files (snapshot_id, file_path, change_kind) VALUES (?, ?, ?);");
+    for (const row of fileRows) {
+        fileStmt.run([snapshotId, row.file, row.kind]);
+    }
+};
+const deleteUnreferencedExternalFiles = (db) => {
+    db.exec(`
+    DELETE FROM files
+    WHERE is_external = 1
+      AND path NOT IN (
+        SELECT DISTINCT to_path
+        FROM file_edges
+        WHERE to_type = 'external'
+      );
+  `);
+};
+export async function writeGraphSqlite(options) {
+    const fileSignatures = options.fileSignatures
+        ? normalizeSqliteArtifactFileSignatures(options.fileSignatures)
+        : undefined;
+    await withSqliteDatabase(options.outputPath, (db) => {
+        const runInsert = db.transaction(() => {
+            clearCurrentGraphState(db);
+            const fileEntries = [];
+            for (const file of options.fileGraph.nodes) {
+                fileEntries.push({ path: file, isExternal: false });
+            }
+            for (const edge of options.fileGraph.edges) {
+                if (edge.to.type === "external") {
+                    fileEntries.push({ path: edge.to.name, isExternal: true });
+                }
+                else {
+                    fileEntries.push({ path: edge.to.path, isExternal: false });
+                }
+            }
+            insertFiles(db, dedupeFileEntries(fileEntries));
+            insertFileEdges(db, options.fileGraph.edges);
+            insertSymbols(db, [...options.symbolGraph.nodes.values()]);
+            insertSymbolEdges(db, options.symbolGraph.edges);
+            recordGraphSnapshot(db, {
+                mode: "full",
+                changedFiles: [],
+                deletedFiles: [],
+                fileNodes: options.fileGraph.nodes.size,
+                fileEdges: options.fileGraph.edges.length,
+                symbolNodes: options.symbolGraph.nodes.size,
+                symbolEdges: options.symbolGraph.edges.length,
+            });
+            if (fileSignatures) {
+                writeArtifactFileSignatures(db, fileSignatures);
+            }
+            else {
+                clearArtifactFileSignatures(db);
+            }
+        });
+        runInsert();
+        db.exec("ANALYZE;");
+    });
+}
+export async function updateGraphSqlite(options) {
+    await withSqliteDatabase(options.outputPath, (db) => {
+        const runUpdate = db.transaction(() => {
+            const changedSet = new Set(options.changedFiles);
+            const deletedSet = new Set(options.deletedFiles ?? []);
+            const touchedSet = new Set([...changedSet, ...deletedSet]);
+            const touchedFiles = [...touchedSet];
+            const removedSymbolIds = readSymbolIdsForFiles(db, touchedFiles);
+            deleteBySymbolIds(db, removedSymbolIds);
+            deleteFileEdgesForFiles(db, touchedFiles);
+            deleteFileEdgesToFiles(db, [...deletedSet]);
+            deleteFilesByPath(db, [...deletedSet]);
+            const fileEntries = [];
+            for (const file of changedSet) {
+                fileEntries.push({ path: file, isExternal: false });
+            }
+            for (const edge of options.fileGraph.edges) {
+                if (!changedSet.has(edge.from))
+                    continue;
+                if (edge.to.type === "external") {
+                    fileEntries.push({ path: edge.to.name, isExternal: true });
+                }
+                else {
+                    fileEntries.push({ path: edge.to.path, isExternal: false });
+                }
+            }
+            if (fileEntries.length) {
+                insertFiles(db, dedupeFileEntries(fileEntries));
+            }
+            const changedSymbolIds = collectSymbolIdsForFiles(options.symbolGraph, changedSet);
+            const changedSymbolNodes = [...changedSymbolIds]
+                .map((id) => options.symbolGraph.nodes.get(id))
+                .filter((node) => !!node);
+            if (changedSymbolNodes.length) {
+                insertSymbols(db, changedSymbolNodes);
+            }
+            const fileEdges = fileGraphEdgesForFiles(options.fileGraph, changedSet);
+            if (fileEdges.length) {
+                insertFileEdges(db, fileEdges);
+            }
+            const symbolEdges = options.fullGraphSync
+                ? symbolGraphEdgesForSymbolIds(options.symbolGraph, changedSymbolIds)
+                : symbolGraphEdgesForFiles(options.symbolGraph, changedSet);
+            if (symbolEdges.length) {
+                insertSymbolEdges(db, symbolEdges);
+            }
+            deleteUnreferencedExternalFiles(db);
+            clearArtifactFileSignatures(db);
+            recordGraphSnapshot(db, {
+                mode: "incremental",
+                changedFiles: [...changedSet],
+                deletedFiles: [...deletedSet],
+                fileNodes: changedSet.size,
+                fileEdges: fileEdges.length,
+                symbolNodes: changedSymbolNodes.length,
+                symbolEdges: symbolEdges.length,
+            });
+        });
+        runUpdate();
+        db.exec("ANALYZE;");
+    });
+}
+//# sourceMappingURL=write.js.map

package/dist/sqlite/write.js.map

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

package/dist/sqlite-driver.d.ts

@@ -0,0 +1,41 @@
+import type { PathLike } from "node:fs";
+import type { StatementColumnMetadata, StatementResultingChanges, StatementSync } from "node:sqlite";
+export type SqliteValue = null | number | bigint | string | NodeJS.ArrayBufferView;
+export type SqliteRow = Record<string, unknown>;
+export type SqliteRawRow = unknown[];
+export type SqliteRunResult = StatementResultingChanges;
+export type SqliteColumn = StatementColumnMetadata;
+type SqliteParameterInput = SqliteValue | readonly SqliteValue[];
+type NodeSqliteStatement = StatementSync & {
+    columns: () => StatementColumnMetadata[];
+    setReturnArrays: (enabled: boolean) => void;
+};
+export declare function getNodeSqliteLoadError(): Error | undefined;
+export declare function isNodeSqliteUnavailableError(error: unknown): boolean;
+export declare class SqliteStatement {
+    private readonly statement;
+    private readonly returnArrays;
+    constructor(statement: NodeSqliteStatement, returnArrays?: boolean);
+    raw(): SqliteStatement;
+    all(...params: SqliteParameterInput[]): SqliteRow[] | SqliteRawRow[];
+    get(...params: SqliteParameterInput[]): SqliteRow | SqliteRawRow | undefined;
+    iterate(...params: SqliteParameterInput[]): Iterable<SqliteRow> | Iterable<SqliteRawRow>;
+    run(...params: SqliteParameterInput[]): SqliteRunResult;
+    columns(): SqliteColumn[];
+}
+export declare class SqliteDatabase {
+    private readonly db;
+    private readonly statements;
+    constructor(filePath: PathLike, options?: {
+        readonly?: boolean;
+        timeout?: number;
+    });
+    exec(sql: string): void;
+    pragma(sql: string): void;
+    prepare(sql: string): SqliteStatement;
+    transaction<T>(fn: () => T): () => T;
+    close(): void;
+}
+export declare function isReadOnlySqliteError(error: unknown): boolean;
+export {};
+//# sourceMappingURL=sqlite-driver.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-driver.d.ts","sourceRoot":"","sources":["../src/sqlite-driver.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACxC,OAAO,KAAK,EAAgB,uBAAuB,EAAE,yBAAyB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAGnH,MAAM,MAAM,WAAW,GAAG,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC,eAAe,CAAC;AACnF,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAChD,MAAM,MAAM,YAAY,GAAG,OAAO,EAAE,CAAC;AACrC,MAAM,MAAM,eAAe,GAAG,yBAAyB,CAAC;AACxD,MAAM,MAAM,YAAY,GAAG,uBAAuB,CAAC;AAmBnD,KAAK,oBAAoB,GAAG,WAAW,GAAG,SAAS,WAAW,EAAE,CAAC;AAIjE,KAAK,mBAAmB,GAAG,aAAa,GAAG;IACzC,OAAO,EAAE,MAAM,uBAAuB,EAAE,CAAC;IACzC,eAAe,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;CAC7C,CAAC;AAmBF,wBAAgB,sBAAsB,IAAI,KAAK,GAAG,SAAS,CAQ1D;AAED,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAKpE;AA6BD,qBAAa,eAAe;IAExB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,YAAY;gBADZ,SAAS,EAAE,mBAAmB,EAC9B,YAAY,UAAQ;IAKvC,GAAG,IAAI,eAAe;IAItB,GAAG,CAAC,GAAG,MAAM,EAAE,oBAAoB,EAAE,GAAG,SAAS,EAAE,GAAG,YAAY,EAAE;IAIpE,GAAG,CAAC,GAAG,MAAM,EAAE,oBAAoB,EAAE,GAAG,SAAS,GAAG,YAAY,GAAG,SAAS;IAI5E,OAAO,CAAC,GAAG,MAAM,EAAE,oBAAoB,EAAE,GAAG,QAAQ,CAAC,SAAS,CAAC,GAAG,QAAQ,CAAC,YAAY,CAAC;IAIxF,GAAG,CAAC,GAAG,MAAM,EAAE,oBAAoB,EAAE,GAAG,eAAe;IAIvD,OAAO,IAAI,YAAY,EAAE;CAG1B;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,EAAE,CAA6B;IAChD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAsC;gBAErD,QAAQ,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE;IAclF,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAMvB,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAIzB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe;IAQrC,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC;IAcpC,KAAK,IAAI,IAAI;CAId;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAS7D"}

package/dist/sqlite-driver.js

@@ -0,0 +1,144 @@
+import { createRequire } from "node:module";
+import { errorMessage } from "./util/errors.js";
+const requireNodeModule = createRequire(import.meta.url);
+let sqliteModule;
+let sqliteLoadError;
+function loadNodeSqlite() {
+    if (sqliteModule)
+        return sqliteModule;
+    if (sqliteLoadError)
+        throw sqliteLoadError;
+    try {
+        const loaded = requireNodeModule("node:sqlite");
+        sqliteModule = loaded;
+        return loaded;
+    }
+    catch (error) {
+        sqliteLoadError = error instanceof Error ? error : new Error(String(error));
+        throw sqliteLoadError;
+    }
+}
+export function getNodeSqliteLoadError() {
+    if (sqliteModule)
+        return undefined;
+    try {
+        loadNodeSqlite();
+        return undefined;
+    }
+    catch {
+        return sqliteLoadError;
+    }
+}
+export function isNodeSqliteUnavailableError(error) {
+    const message = errorMessage(error);
+    return /node:sqlite|No such built-in module:\s*node:sqlite|setReturnArrays is not a function|columns is not a function/i.test(message);
+}
+function isReadOnlyAllowedAction(actionCode, constants) {
+    return (actionCode === constants.SQLITE_FUNCTION ||
+        actionCode === constants.SQLITE_PRAGMA ||
+        actionCode === constants.SQLITE_READ ||
+        actionCode === constants.SQLITE_SELECT ||
+        actionCode === constants.SQLITE_TRANSACTION);
+}
+const isSqliteValueArray = (value) => Array.isArray(value);
+const normalizeParams = (params) => {
+    if (params.length === 1) {
+        const [only] = params;
+        if (only !== undefined && isSqliteValueArray(only))
+            return [...only];
+    }
+    const normalized = [];
+    for (const param of params) {
+        if (isSqliteValueArray(param)) {
+            throw new Error("SQLite parameters must be passed as a single array or as positional values.");
+        }
+        normalized.push(param);
+    }
+    return normalized;
+};
+export class SqliteStatement {
+    statement;
+    returnArrays;
+    constructor(statement, returnArrays = false) {
+        this.statement = statement;
+        this.returnArrays = returnArrays;
+        this.statement.setReturnArrays(returnArrays);
+    }
+    raw() {
+        return new SqliteStatement(this.statement, true);
+    }
+    all(...params) {
+        return this.statement.all(...normalizeParams(params));
+    }
+    get(...params) {
+        return this.statement.get(...normalizeParams(params));
+    }
+    iterate(...params) {
+        return this.statement.iterate(...normalizeParams(params));
+    }
+    run(...params) {
+        return this.statement.run(...normalizeParams(params));
+    }
+    columns() {
+        return this.statement.columns();
+    }
+}
+export class SqliteDatabase {
+    db;
+    statements = new Map();
+    constructor(filePath, options) {
+        const sqlite = loadNodeSqlite();
+        this.db = new sqlite.DatabaseSync(filePath, {
+            readOnly: options?.readonly,
+            timeout: options?.timeout ?? 5000,
+        });
+        if (options?.readonly) {
+            const { constants } = sqlite;
+            this.db.setAuthorizer?.((actionCode) => isReadOnlyAllowedAction(actionCode, constants) ? constants.SQLITE_OK : constants.SQLITE_DENY);
+        }
+    }
+    exec(sql) {
+        // DDL/schema changes invalidate prepared statements; drop the cache.
+        this.statements.clear();
+        this.db.exec(sql);
+    }
+    pragma(sql) {
+        this.exec(`PRAGMA ${sql};`);
+    }
+    prepare(sql) {
+        const cached = this.statements.get(sql);
+        if (cached)
+            return cached;
+        const statement = new SqliteStatement(this.db.prepare(sql));
+        this.statements.set(sql, statement);
+        return statement;
+    }
+    transaction(fn) {
+        return () => {
+            this.exec("BEGIN;");
+            try {
+                const result = fn();
+                this.exec("COMMIT;");
+                return result;
+            }
+            catch (error) {
+                this.exec("ROLLBACK;");
+                throw error;
+            }
+        };
+    }
+    close() {
+        this.statements.clear();
+        this.db.close();
+    }
+}
+export function isReadOnlySqliteError(error) {
+    if (!(error instanceof Error))
+        return false;
+    const message = error.message.toLowerCase();
+    return (message.includes("not authorized") ||
+        message.includes("read-only") ||
+        message.includes("readonly") ||
+        message.includes("attempt to write"));
+}
+//# sourceMappingURL=sqlite-driver.js.map

package/dist/sqlite-driver.js.map

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

package/dist/sqlite.d.ts

@@ -0,0 +1,4 @@
+export type { GraphQueryResult, RawSqlResult, SqliteGraphOptions, SqliteGraphUpdateOptions } from "./sqlite/types.js";
+export { SQLITE_ARTIFACT_FILE_SIGNATURES_METADATA_KEY, writeGraphSqlite, updateGraphSqlite } from "./sqlite/write.js";
+export { queryGraphSqlite, queryGraphSqliteRaw } from "./sqlite/query.js";
+//# sourceMappingURL=sqlite.d.ts.map

package/dist/sqlite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite.d.ts","sourceRoot":"","sources":["../src/sqlite.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,gBAAgB,EAAE,YAAY,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AACtH,OAAO,EAAE,4CAA4C,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtH,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/sqlite.js

@@ -0,0 +1,3 @@
+export { SQLITE_ARTIFACT_FILE_SIGNATURES_METADATA_KEY, writeGraphSqlite, updateGraphSqlite } from "./sqlite/write.js";
+export { queryGraphSqlite, queryGraphSqliteRaw } from "./sqlite/query.js";
+//# sourceMappingURL=sqlite.js.map

package/dist/sqlite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite.js","sourceRoot":"","sources":["../src/sqlite.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,4CAA4C,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtH,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/triples.d.ts

@@ -0,0 +1,27 @@
+import type { Graph } from "./types.js";
+import { type SymbolGraph, type SymbolNodeKind } from "./graphs/symbol-graph.js";
+export type TripleNode = {
+    type: "file";
+    id: string;
+    path: string;
+} | {
+    type: "external";
+    id: string;
+    name: string;
+} | {
+    type: "symbol";
+    id: string;
+    name: string;
+    kind: SymbolNodeKind;
+    file: string;
+    docstring?: string;
+    lineSpan?: number;
+    complexity?: number;
+};
+export type Triple = {
+    subject: TripleNode;
+    predicate: string;
+    object: TripleNode;
+};
+export declare function graphToTriples(fileGraph: Graph, symbolGraph: SymbolGraph): Triple[];
+//# sourceMappingURL=triples.d.ts.map

package/dist/triples.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"triples.d.ts","sourceRoot":"","sources":["../src/triples.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,KAAK,WAAW,EAAmB,KAAK,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAElG,MAAM,MAAM,UAAU,GAClB;IACE,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;CACd,GACD;IACE,IAAI,EAAE,UAAU,CAAC;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;CACd,GACD;IACE,IAAI,EAAE,QAAQ,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,cAAc,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEN,MAAM,MAAM,MAAM,GAAG;IACnB,OAAO,EAAE,UAAU,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,UAAU,CAAC;CACpB,CAAC;AAyBF,wBAAgB,cAAc,CAAC,SAAS,EAAE,KAAK,EAAE,WAAW,EAAE,WAAW,GAAG,MAAM,EAAE,CAyBnF"}

package/dist/triples.js

@@ -0,0 +1,46 @@
+import {} from "./graphs/symbol-graph.js";
+const symbolNodeToTripleNode = (node) => ({
+    type: "symbol",
+    id: node.id,
+    name: node.name,
+    kind: node.kind,
+    file: node.file,
+    ...(node.docstring ? { docstring: node.docstring } : {}),
+    ...(node.lineSpan ? { lineSpan: node.lineSpan } : {}),
+    ...(typeof node.complexity === "number" ? { complexity: node.complexity } : {}),
+});
+const fileNode = (path) => ({
+    type: "file",
+    id: path,
+    path,
+});
+const externalNode = (name) => ({
+    type: "external",
+    id: `external:${name}`,
+    name,
+});
+export function graphToTriples(fileGraph, symbolGraph) {
+    const triples = [];
+    for (const edge of fileGraph.edges) {
+        const subject = fileNode(edge.from);
+        const object = edge.to.type === "file" ? fileNode(edge.to.path) : externalNode(edge.to.name);
+        triples.push({
+            subject,
+            predicate: "imports",
+            object,
+        });
+    }
+    for (const edge of symbolGraph.edges) {
+        const fromNode = symbolGraph.nodes.get(edge.from);
+        const toNode = symbolGraph.nodes.get(edge.to);
+        if (!fromNode || !toNode)
+            continue;
+        triples.push({
+            subject: symbolNodeToTripleNode(fromNode),
+            predicate: edge.label ?? "uses",
+            object: symbolNodeToTripleNode(toNode),
+        });
+    }
+    return triples;
+}
+//# sourceMappingURL=triples.js.map

package/dist/triples.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"triples.js","sourceRoot":"","sources":["../src/triples.ts"],"names":[],"mappings":"AACA,OAAO,EAA0D,MAAM,0BAA0B,CAAC;AA8BlG,MAAM,sBAAsB,GAAG,CAAC,IAAgB,EAAc,EAAE,CAAC,CAAC;IAChE,IAAI,EAAE,QAAQ;IACd,EAAE,EAAE,IAAI,CAAC,EAAE;IACX,IAAI,EAAE,IAAI,CAAC,IAAI;IACf,IAAI,EAAE,IAAI,CAAC,IAAI;IACf,IAAI,EAAE,IAAI,CAAC,IAAI;IACf,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACxD,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACrD,GAAG,CAAC,OAAO,IAAI,CAAC,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;CAChF,CAAC,CAAC;AAEH,MAAM,QAAQ,GAAG,CAAC,IAAY,EAAc,EAAE,CAAC,CAAC;IAC9C,IAAI,EAAE,MAAM;IACZ,EAAE,EAAE,IAAI;IACR,IAAI;CACL,CAAC,CAAC;AAEH,MAAM,YAAY,GAAG,CAAC,IAAY,EAAc,EAAE,CAAC,CAAC;IAClD,IAAI,EAAE,UAAU;IAChB,EAAE,EAAE,YAAY,IAAI,EAAE;IACtB,IAAI;CACL,CAAC,CAAC;AAEH,MAAM,UAAU,cAAc,CAAC,SAAgB,EAAE,WAAwB;IACvE,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,KAAK,MAAM,IAAI,IAAI,SAAS,CAAC,KAAK,EAAE,CAAC;QACnC,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACpC,MAAM,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC;QAC7F,OAAO,CAAC,IAAI,CAAC;YACX,OAAO;YACP,SAAS,EAAE,SAAS;YACpB,MAAM;SACP,CAAC,CAAC;IACL,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,WAAW,CAAC,KAAK,EAAE,CAAC;QACrC,MAAM,QAAQ,GAAG,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClD,MAAM,MAAM,GAAG,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC9C,IAAI,CAAC,QAAQ,IAAI,CAAC,MAAM;YAAE,SAAS;QACnC,OAAO,CAAC,IAAI,CAAC;YACX,OAAO,EAAE,sBAAsB,CAAC,QAAQ,CAAC;YACzC,SAAS,EAAE,IAAI,CAAC,KAAK,IAAI,MAAM;YAC/B,MAAM,EAAE,sBAAsB,CAAC,MAAM,CAAC;SACvC,CAAC,CAAC;IACL,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}