@lzehrung/codegraph 2.1.0

package/dist/sql/sourceGraph.d.ts

@@ -0,0 +1,19 @@
+import type { ModuleIndex } from "../indexer/types.js";
+import type { Edge } from "../types.js";
+import { type LanguageExtensionMap } from "../languages.js";
+import type { SqlStatementFact } from "./types.js";
+export type SqlFactCache = {
+    factsByFile: Map<string, SqlStatementFact[]>;
+    definitionsByExactName: Map<string, SqlStatementFact[]>;
+    definitionsByBaseName: Map<string, SqlStatementFact[]>;
+};
+export type SqlFileSignature = {
+    sig: string;
+    gitSig?: string;
+    cacheSig?: string;
+};
+export declare function sqlCorpusSignature(sqlFiles: readonly string[], fileSignatures: Map<string, SqlFileSignature> | undefined): string | undefined;
+export declare function buildSqlModuleIndex(filePath: string, source: string): ModuleIndex;
+export declare function buildSqlFactCache(allFiles: readonly string[], languageExtensions?: LanguageExtensionMap): Promise<SqlFactCache>;
+export declare function collectSqlEdgesForFile(filePath: string, allFiles: readonly string[], factCache?: SqlFactCache, languageExtensions?: LanguageExtensionMap): Promise<Edge[]>;
+//# sourceMappingURL=sourceGraph.d.ts.map

package/dist/sql/sourceGraph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sourceGraph.d.ts","sourceRoot":"","sources":["../../src/sql/sourceGraph.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAa,MAAM,qBAAqB,CAAC;AAElE,OAAO,KAAK,EAAE,IAAI,EAAS,MAAM,aAAa,CAAC;AAG/C,OAAO,EAAkB,KAAK,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAG5E,OAAO,KAAK,EAAe,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAqBhE,MAAM,MAAM,YAAY,GAAG;IACzB,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,gBAAgB,EAAE,CAAC,CAAC;IAC7C,sBAAsB,EAAE,GAAG,CAAC,MAAM,EAAE,gBAAgB,EAAE,CAAC,CAAC;IACxD,qBAAqB,EAAE,GAAG,CAAC,MAAM,EAAE,gBAAgB,EAAE,CAAC,CAAC;CACxD,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAYF,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,SAAS,MAAM,EAAE,EAC3B,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,GAAG,SAAS,GACxD,MAAM,GAAG,SAAS,CAapB;AA8FD,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,WAAW,CA6BjF;AAMD,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,SAAS,MAAM,EAAE,EAC3B,kBAAkB,CAAC,EAAE,oBAAoB,GACxC,OAAO,CAAC,YAAY,CAAC,CAqBvB;AAED,wBAAsB,sBAAsB,CAC1C,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,SAAS,MAAM,EAAE,EAC3B,SAAS,CAAC,EAAE,YAAY,EACxB,kBAAkB,CAAC,EAAE,oBAAoB,GACxC,OAAO,CAAC,IAAI,EAAE,CAAC,CAoBjB"}

package/dist/sql/sourceGraph.js

@@ -0,0 +1,195 @@
+import crypto from "node:crypto";
+import fsp from "node:fs/promises";
+import { uniqueByKey } from "../util/collections.js";
+import { SymbolKind } from "../indexer/types.js";
+import { normalizePath } from "../util/paths.js";
+import { mapLimit } from "../util/concurrency.js";
+import { supportForFile } from "../languages.js";
+import { extractSqlFactsFromSource, sqlObjectBaseName } from "./extractFacts.js";
+import { pushSqlLookupValue } from "./lookup.js";
+const SQL_FACT_READ_CONCURRENCY = 32;
+const SQL_DEFINITION_KINDS = new Set([
+    "defines_table",
+    "defines_view",
+    "defines_index",
+    "defines_routine",
+]);
+const SQL_REFERENCE_KINDS = new Set([
+    "alters_table",
+    "drops_object",
+    "reads_from",
+    "writes_to",
+    "joins",
+    "references_object",
+    "renames_object",
+]);
+function isSqlFile(filePath, languageExtensions) {
+    return supportForFile(filePath, languageExtensions)?.id === "sql";
+}
+export function sqlCorpusSignature(sqlFiles, fileSignatures) {
+    if (!sqlFiles.length || !fileSignatures)
+        return undefined;
+    const hash = crypto.createHash("sha1");
+    hash.update("sql-corpus-v1\0");
+    for (const file of sqlFiles) {
+        const signature = fileSignatures.get(file);
+        if (!signature)
+            return undefined;
+        hash.update(file);
+        hash.update("\0");
+        hash.update(signature.cacheSig ?? signature.gitSig ?? signature.sig);
+        hash.update("\0");
+    }
+    return hash.digest("hex");
+}
+function rangeForFact(fact) {
+    return {
+        start: { line: fact.startLine, column: fact.startColumn, index: fact.startIndex },
+        end: { line: fact.endLine, column: fact.endColumn, index: fact.endIndex },
+    };
+}
+function symbolKindForFact(fact) {
+    if (fact.kind === "defines_table")
+        return SymbolKind.Table;
+    if (fact.kind === "defines_view")
+        return SymbolKind.View;
+    if (fact.kind === "defines_index")
+        return SymbolKind.Index;
+    if (fact.kind === "defines_routine")
+        return SymbolKind.Routine;
+    return SymbolKind.Variable;
+}
+function isDefinitionFact(fact) {
+    return SQL_DEFINITION_KINDS.has(fact.kind) && !!fact.objectName;
+}
+function referenceObjectNames(fact) {
+    const names = [];
+    if (SQL_REFERENCE_KINDS.has(fact.kind) && fact.objectName) {
+        names.push(fact.objectName);
+    }
+    if (fact.kind !== "renames_object" && fact.kind !== "joins" && fact.relatedObjectName) {
+        names.push(fact.relatedObjectName);
+    }
+    return Array.from(new Set(names));
+}
+function uniqueFacts(candidates) {
+    return uniqueByKey(candidates, (candidate) => `${candidate.filePath}:${candidate.startLine}:${candidate.kind}:${candidate.objectName ?? ""}`);
+}
+function sqlDefinitionCandidates(cache, objectName) {
+    const normalized = objectName.toLowerCase();
+    const baseName = sqlObjectBaseName(objectName).toLowerCase();
+    const exactCandidates = uniqueFacts(cache.definitionsByExactName.get(normalized) ?? []);
+    if (exactCandidates.length) {
+        return {
+            candidates: exactCandidates,
+            resolved: exactCandidates.length === 1 ? "precise" : "heuristic",
+            confidence: exactCandidates.length === 1 ? 1 : 0.8,
+        };
+    }
+    const basenameCandidates = uniqueFacts(cache.definitionsByBaseName.get(baseName) ?? []);
+    if (basenameCandidates.length !== 1)
+        return { candidates: [], resolved: "heuristic", confidence: 0.7 };
+    return {
+        candidates: basenameCandidates,
+        resolved: "heuristic",
+        confidence: 0.7,
+    };
+}
+function definitionKeys(name) {
+    const exact = name.toLowerCase();
+    return { exact, base: sqlObjectBaseName(name).toLowerCase() };
+}
+function addDefinition(definitionsByExactName, definitionsByBaseName, fact) {
+    if (!fact.objectName)
+        return;
+    const keys = definitionKeys(fact.objectName);
+    pushSqlLookupValue(definitionsByExactName, keys.exact, fact);
+    pushSqlLookupValue(definitionsByBaseName, keys.base, fact);
+}
+function sqlEdgesForCandidates(normalizedFile, fact, objectName, match) {
+    const candidates = [];
+    for (const candidate of match.candidates) {
+        if (candidate.filePath !== normalizedFile)
+            candidates.push(candidate);
+    }
+    return candidates.map((candidate) => ({
+        from: normalizedFile,
+        to: { type: "file", path: candidate.filePath },
+        raw: `sql:${fact.kind}:${objectName}`,
+        resolved: match.resolved,
+        confidence: match.confidence,
+    }));
+}
+export function buildSqlModuleIndex(filePath, source) {
+    const normalizedFile = normalizePath(filePath);
+    const facts = extractSqlFactsFromSource(normalizedFile, source);
+    const locals = [];
+    const exports = [];
+    const seen = new Set();
+    for (const fact of facts) {
+        if (!isDefinitionFact(fact) || !fact.objectName)
+            continue;
+        const key = `${fact.objectName}:${fact.startLine}:${fact.kind}`;
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        const symbol = {
+            file: normalizedFile,
+            localName: fact.objectName,
+            kind: symbolKindForFact(fact),
+            range: rangeForFact(fact),
+            lineSpan: Math.max(1, fact.endLine - fact.startLine + 1),
+        };
+        locals.push(symbol);
+        exports.push({ type: "local", exportedAs: fact.objectName, target: symbol });
+    }
+    return {
+        file: normalizedFile,
+        exports,
+        imports: [],
+        locals,
+    };
+}
+async function readSqlFacts(filePath) {
+    return extractSqlFactsFromSource(filePath, await fsp.readFile(filePath, "utf8"));
+}
+export async function buildSqlFactCache(allFiles, languageExtensions) {
+    const sqlFiles = Array.from(new Set(allFiles.map(normalizePath).filter((file) => isSqlFile(file, languageExtensions)))).sort((left, right) => left.localeCompare(right));
+    const factGroups = await mapLimit(sqlFiles, SQL_FACT_READ_CONCURRENCY, async (file) => [file, await readSqlFacts(file)]);
+    const factsByFile = new Map();
+    const definitionsByExactName = new Map();
+    const definitionsByBaseName = new Map();
+    for (const [file, facts] of factGroups) {
+        factsByFile.set(file, facts);
+        for (const fact of facts) {
+            if (!isDefinitionFact(fact) || !fact.objectName)
+                continue;
+            addDefinition(definitionsByExactName, definitionsByBaseName, fact);
+        }
+    }
+    return { factsByFile, definitionsByExactName, definitionsByBaseName };
+}
+export async function collectSqlEdgesForFile(filePath, allFiles, factCache, languageExtensions) {
+    const normalizedFile = normalizePath(filePath);
+    if (!isSqlFile(normalizedFile, languageExtensions))
+        return [];
+    const cache = factCache ?? (await buildSqlFactCache(allFiles, languageExtensions));
+    const currentFacts = cache.factsByFile.get(normalizedFile) ?? [];
+    const edges = [];
+    const seen = new Set();
+    for (const fact of currentFacts) {
+        for (const objectName of referenceObjectNames(fact)) {
+            const match = sqlDefinitionCandidates(cache, objectName);
+            for (const edge of sqlEdgesForCandidates(normalizedFile, fact, objectName, match)) {
+                const targetPath = edge.to.type === "file" ? edge.to.path : "";
+                const key = `${edge.from}:${targetPath}:${edge.raw}`;
+                if (seen.has(key))
+                    continue;
+                seen.add(key);
+                edges.push(edge);
+            }
+        }
+    }
+    return edges;
+}
+//# sourceMappingURL=sourceGraph.js.map

package/dist/sql/sourceGraph.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sourceGraph.js","sourceRoot":"","sources":["../../src/sql/sourceGraph.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,aAAa,CAAC;AACjC,OAAO,GAAG,MAAM,kBAAkB,CAAC;AAEnC,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAErD,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAClD,OAAO,EAAE,cAAc,EAA6B,MAAM,iBAAiB,CAAC;AAC5E,OAAO,EAAE,yBAAyB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACjF,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAGjD,MAAM,yBAAyB,GAAG,EAAE,CAAC;AAErC,MAAM,oBAAoB,GAAG,IAAI,GAAG,CAAc;IAChD,eAAe;IACf,cAAc;IACd,eAAe;IACf,iBAAiB;CAClB,CAAC,CAAC;AAEH,MAAM,mBAAmB,GAAG,IAAI,GAAG,CAAc;IAC/C,cAAc;IACd,cAAc;IACd,YAAY;IACZ,WAAW;IACX,OAAO;IACP,mBAAmB;IACnB,gBAAgB;CACjB,CAAC,CAAC;AAoBH,SAAS,SAAS,CAAC,QAAgB,EAAE,kBAAyC;IAC5E,OAAO,cAAc,CAAC,QAAQ,EAAE,kBAAkB,CAAC,EAAE,EAAE,KAAK,KAAK,CAAC;AACpE,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,QAA2B,EAC3B,cAAyD;IAEzD,IAAI,CAAC,QAAQ,CAAC,MAAM,IAAI,CAAC,cAAc;QAAE,OAAO,SAAS,CAAC;IAC1D,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;IACvC,IAAI,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC;IAC/B,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;QAC5B,MAAM,SAAS,GAAG,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC3C,IAAI,CAAC,SAAS;YAAE,OAAO,SAAS,CAAC;QACjC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAClB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAClB,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,IAAI,SAAS,CAAC,MAAM,IAAI,SAAS,CAAC,GAAG,CAAC,CAAC;QACrE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACpB,CAAC;IACD,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC5B,CAAC;AAED,SAAS,YAAY,CAAC,IAAsB;IAC1C,OAAO;QACL,KAAK,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,WAAW,EAAE,KAAK,EAAE,IAAI,CAAC,UAAU,EAAE;QACjF,GAAG,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,SAAS,EAAE,KAAK,EAAE,IAAI,CAAC,QAAQ,EAAE;KAC1E,CAAC;AACJ,CAAC;AAED,SAAS,iBAAiB,CAAC,IAAsB;IAC/C,IAAI,IAAI,CAAC,IAAI,KAAK,eAAe;QAAE,OAAO,UAAU,CAAC,KAAK,CAAC;IAC3D,IAAI,IAAI,CAAC,IAAI,KAAK,cAAc;QAAE,OAAO,UAAU,CAAC,IAAI,CAAC;IACzD,IAAI,IAAI,CAAC,IAAI,KAAK,eAAe;QAAE,OAAO,UAAU,CAAC,KAAK,CAAC;IAC3D,IAAI,IAAI,CAAC,IAAI,KAAK,iBAAiB;QAAE,OAAO,UAAU,CAAC,OAAO,CAAC;IAC/D,OAAO,UAAU,CAAC,QAAQ,CAAC;AAC7B,CAAC;AAED,SAAS,gBAAgB,CAAC,IAAsB;IAC9C,OAAO,oBAAoB,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC;AAClE,CAAC;AAED,SAAS,oBAAoB,CAAC,IAAsB;IAClD,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,mBAAmB,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;QAC1D,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC9B,CAAC;IACD,IAAI,IAAI,CAAC,IAAI,KAAK,gBAAgB,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO,IAAI,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACtF,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IACrC,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;AACpC,CAAC;AAED,SAAS,WAAW,CAAC,UAAuC;IAC1D,OAAO,WAAW,CAChB,UAAU,EACV,CAAC,SAAS,EAAE,EAAE,CAAC,GAAG,SAAS,CAAC,QAAQ,IAAI,SAAS,CAAC,SAAS,IAAI,SAAS,CAAC,IAAI,IAAI,SAAS,CAAC,UAAU,IAAI,EAAE,EAAE,CAC9G,CAAC;AACJ,CAAC;AAED,SAAS,uBAAuB,CAAC,KAAmB,EAAE,UAAkB;IACtE,MAAM,UAAU,GAAG,UAAU,CAAC,WAAW,EAAE,CAAC;IAC5C,MAAM,QAAQ,GAAG,iBAAiB,CAAC,UAAU,CAAC,CAAC,WAAW,EAAE,CAAC;IAC7D,MAAM,eAAe,GAAG,WAAW,CAAC,KAAK,CAAC,sBAAsB,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC;IACxF,IAAI,eAAe,CAAC,MAAM,EAAE,CAAC;QAC3B,OAAO;YACL,UAAU,EAAE,eAAe;YAC3B,QAAQ,EAAE,eAAe,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW;YAChE,UAAU,EAAE,eAAe,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG;SACnD,CAAC;IACJ,CAAC;IACD,MAAM,kBAAkB,GAAG,WAAW,CAAC,KAAK,CAAC,qBAAqB,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;IACxF,IAAI,kBAAkB,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,UAAU,EAAE,EAAE,EAAE,QAAQ,EAAE,WAAW,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC;IACvG,OAAO;QACL,UAAU,EAAE,kBAAkB;QAC9B,QAAQ,EAAE,WAAW;QACrB,UAAU,EAAE,GAAG;KAChB,CAAC;AACJ,CAAC;AAED,SAAS,cAAc,CAAC,IAAY;IAClC,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IACjC,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,iBAAiB,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;AAChE,CAAC;AAED,SAAS,aAAa,CACpB,sBAAuD,EACvD,qBAAsD,EACtD,IAAsB;IAEtB,IAAI,CAAC,IAAI,CAAC,UAAU;QAAE,OAAO;IAC7B,MAAM,IAAI,GAAG,cAAc,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC7C,kBAAkB,CAAC,sBAAsB,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IAC7D,kBAAkB,CAAC,qBAAqB,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;AAC7D,CAAC;AAED,SAAS,qBAAqB,CAC5B,cAAsB,EACtB,IAAsB,EACtB,UAAkB,EAClB,KAAkC;IAElC,MAAM,UAAU,GAAuB,EAAE,CAAC;IAC1C,KAAK,MAAM,SAAS,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;QACzC,IAAI,SAAS,CAAC,QAAQ,KAAK,cAAc;YAAE,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACxE,CAAC;IACD,OAAO,UAAU,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;QACpC,IAAI,EAAE,cAAc;QACpB,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,CAAC,QAAQ,EAAE;QAC9C,GAAG,EAAE,OAAO,IAAI,CAAC,IAAI,IAAI,UAAU,EAAE;QACrC,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,UAAU,EAAE,KAAK,CAAC,UAAU;KAC7B,CAAC,CAAC,CAAC;AACN,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,QAAgB,EAAE,MAAc;IAClE,MAAM,cAAc,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;IAC/C,MAAM,KAAK,GAAG,yBAAyB,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;IAChE,MAAM,MAAM,GAAgB,EAAE,CAAC;IAC/B,MAAM,OAAO,GAA2B,EAAE,CAAC;IAC3C,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAE/B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU;YAAE,SAAS;QAC1D,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QAChE,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,SAAS;QAC5B,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACd,MAAM,MAAM,GAAc;YACxB,IAAI,EAAE,cAAc;YACpB,SAAS,EAAE,IAAI,CAAC,UAAU;YAC1B,IAAI,EAAE,iBAAiB,CAAC,IAAI,CAAC;YAC7B,KAAK,EAAE,YAAY,CAAC,IAAI,CAAC;YACzB,QAAQ,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC;SACzD,CAAC;QACF,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACpB,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAC/E,CAAC;IAED,OAAO;QACL,IAAI,EAAE,cAAc;QACpB,OAAO;QACP,OAAO,EAAE,EAAE;QACX,MAAM;KACP,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,YAAY,CAAC,QAAgB;IAC1C,OAAO,yBAAyB,CAAC,QAAQ,EAAE,MAAM,GAAG,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC;AACnF,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,QAA2B,EAC3B,kBAAyC;IAEzC,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CACzB,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,EAAE,kBAAkB,CAAC,CAAC,CAAC,CAC3F,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC;IACnD,MAAM,UAAU,GAAG,MAAM,QAAQ,CAC/B,QAAQ,EACR,yBAAyB,EACzB,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,YAAY,CAAC,IAAI,CAAC,CAAU,CAC1D,CAAC;IACF,MAAM,WAAW,GAAG,IAAI,GAAG,EAA8B,CAAC;IAC1D,MAAM,sBAAsB,GAAG,IAAI,GAAG,EAA8B,CAAC;IACrE,MAAM,qBAAqB,GAAG,IAAI,GAAG,EAA8B,CAAC;IAEpE,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,UAAU,EAAE,CAAC;QACvC,WAAW,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAC7B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU;gBAAE,SAAS;YAC1D,aAAa,CAAC,sBAAsB,EAAE,qBAAqB,EAAE,IAAI,CAAC,CAAC;QACrE,CAAC;IACH,CAAC;IACD,OAAO,EAAE,WAAW,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,CAAC;AACxE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,QAAgB,EAChB,QAA2B,EAC3B,SAAwB,EACxB,kBAAyC;IAEzC,MAAM,cAAc,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;IAC/C,IAAI,CAAC,SAAS,CAAC,cAAc,EAAE,kBAAkB,CAAC;QAAE,OAAO,EAAE,CAAC;IAC9D,MAAM,KAAK,GAAG,SAAS,IAAI,CAAC,MAAM,iBAAiB,CAAC,QAAQ,EAAE,kBAAkB,CAAC,CAAC,CAAC;IACnF,MAAM,YAAY,GAAG,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC;IACjE,MAAM,KAAK,GAAW,EAAE,CAAC;IACzB,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,KAAK,MAAM,IAAI,IAAI,YAAY,EAAE,CAAC;QAChC,KAAK,MAAM,UAAU,IAAI,oBAAoB,CAAC,IAAI,CAAC,EAAE,CAAC;YACpD,MAAM,KAAK,GAAG,uBAAuB,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;YACzD,KAAK,MAAM,IAAI,IAAI,qBAAqB,CAAC,cAAc,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,CAAC,EAAE,CAAC;gBAClF,MAAM,UAAU,GAAG,IAAI,CAAC,EAAE,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC/D,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,IAAI,IAAI,UAAU,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;gBACrD,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;oBAAE,SAAS;gBAC5B,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;gBACd,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACnB,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/sql/types.d.ts

@@ -0,0 +1,21 @@
+export type SqlFileRole = "schema_snapshot" | "migration" | "seed" | "query" | "routine" | "fixture" | "dump" | "unknown";
+export type SqlFactKind = "defines_table" | "defines_view" | "defines_index" | "defines_constraint" | "alters_table" | "drops_object" | "renames_object" | "reads_from" | "writes_to" | "joins" | "references_object" | "defines_routine" | "unknown_statement";
+export type SqlTruthTier = "sql_statement_fact" | "sql_schema_candidate";
+export type SqlBridgeReason = "changed_sql_file" | "changed_sql_literal" | "explicit_orm_mapping" | "same_pr_object_name";
+export interface SqlStatementFact {
+    readonly id: string;
+    readonly filePath: string;
+    readonly startLine: number;
+    readonly startColumn: number;
+    readonly startIndex: number;
+    readonly endLine: number;
+    readonly endColumn: number;
+    readonly endIndex: number;
+    readonly role: SqlFileRole;
+    readonly kind: SqlFactKind;
+    readonly objectName: string | null;
+    readonly relatedObjectName: string | null;
+    readonly statementText: string;
+    readonly truthTier: SqlTruthTier;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/sql/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,GACrB,iBAAiB,GAAG,WAAW,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAAC;AAElG,MAAM,MAAM,WAAW,GACnB,eAAe,GACf,cAAc,GACd,eAAe,GACf,oBAAoB,GACpB,cAAc,GACd,cAAc,GACd,gBAAgB,GAChB,YAAY,GACZ,WAAW,GACX,OAAO,GACP,mBAAmB,GACnB,iBAAiB,GACjB,mBAAmB,CAAC;AAExB,MAAM,MAAM,YAAY,GAAG,oBAAoB,GAAG,sBAAsB,CAAC;AAEzE,MAAM,MAAM,eAAe,GACzB,kBAAkB,GAAG,qBAAqB,GAAG,sBAAsB,GAAG,qBAAqB,CAAC;AAE9F,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1C,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,SAAS,EAAE,YAAY,CAAC;CAClC"}

package/dist/sql/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/sql/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/sql/types.ts"],"names":[],"mappings":""}

package/dist/sqlite/canned-query.d.ts

@@ -0,0 +1,3 @@
+import type { GraphQueryResult } from "./types.js";
+export declare function queryGraphSqlite(outputPath: string, queryText: string): Promise<GraphQueryResult>;
+//# sourceMappingURL=canned-query.d.ts.map

package/dist/sqlite/canned-query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canned-query.d.ts","sourceRoot":"","sources":["../../src/sqlite/canned-query.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAsDnD,wBAAsB,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA2KvG"}

package/dist/sqlite/canned-query.js

@@ -0,0 +1,192 @@
+import { parseGraphQuery } from "../query.js";
+import { dedupePreservingOrder, execRowsParams, toSqliteText } from "./common.js";
+import { withReadOnlySqliteDatabase } from "./database.js";
+const loadDirectFileEdges = (db, filePath, direction) => {
+    // Use a literal to_type = 'file' so SQLite can apply the partial indexes
+    // idx_file_edges_from_file / idx_file_edges_to_file.
+    let sql = `
+      SELECT to_path
+      FROM file_edges
+      WHERE to_type = 'file' AND from_path = ?
+      ORDER BY rowid;
+    `;
+    if (direction === "dependents") {
+        sql = `
+      SELECT from_path
+      FROM file_edges
+      WHERE to_type = 'file' AND to_path = ?
+      ORDER BY rowid;
+    `;
+    }
+    return execRowsParams(db, sql, [filePath])
+        .map((row) => toSqliteText(row[0]))
+        .filter(Boolean);
+};
+const loadDirectFileDependencies = (db, fromPath) => loadDirectFileEdges(db, fromPath, "dependencies");
+const loadDirectFileDependents = (db, toPath) => loadDirectFileEdges(db, toPath, "dependents");
+const bfsFileTraversal = (start, loadNeighbors) => {
+    const visited = new Set();
+    const queue = [start];
+    let head = 0;
+    visited.add(start);
+    const result = [];
+    while (head < queue.length) {
+        const current = queue[head];
+        head += 1;
+        if (!current)
+            continue;
+        for (const next of loadNeighbors(current)) {
+            if (visited.has(next))
+                continue;
+            visited.add(next);
+            result.push(next);
+            queue.push(next);
+        }
+    }
+    return result;
+};
+export async function queryGraphSqlite(outputPath, queryText) {
+    const parsed = parseGraphQuery(queryText);
+    if (!parsed) {
+        throw new Error("Unsupported query text.");
+    }
+    return await withReadOnlySqliteDatabase(outputPath, (db) => {
+        switch (parsed.kind) {
+            case "mostCalledMethods": {
+                const rows = execRowsParams(db, `
+            SELECT s.name, s.file, COUNT(*) as cnt
+            FROM symbol_edges e
+            JOIN symbols s ON s.id = e.to_id
+            WHERE e.label = ? AND s.kind = ?
+            GROUP BY s.id
+            ORDER BY cnt DESC
+            LIMIT ?;
+          `, ["calls", "function", parsed.limit]);
+                return {
+                    kind: parsed.kind,
+                    results: rows.map((row) => ({
+                        name: String(row[0]),
+                        file: String(row[1]),
+                        count: Number(row[2]),
+                    })),
+                };
+            }
+            case "dependencyChain": {
+                const rows = execRowsParams(db, `SELECT file FROM symbols WHERE name = ? AND kind = ? ORDER BY file;`, [
+                    parsed.className,
+                    "class",
+                ]);
+                const startFiles = rows.map((row) => toSqliteText(row[0])).filter(Boolean);
+                if (!startFiles.length) {
+                    return { kind: parsed.kind, results: [] };
+                }
+                const chain = dedupePreservingOrder(startFiles.flatMap((startFile) => bfsFileTraversal(startFile, (file) => loadDirectFileDependencies(db, file))));
+                return { kind: parsed.kind, results: chain };
+            }
+            case "controllersMostEndpoints": {
+                // Avoid lower() + leading-wildcard LIKE on both sides. Prefix matches on
+                // endpoint names stay sargable; controller suffix uses GLOB (case-sensitive
+                // variants) instead of lower(name) LIKE '%controller'.
+                const rows = execRowsParams(db, `
+            SELECT c.name, c.file, COUNT(f.id) as cnt
+            FROM symbols c
+            LEFT JOIN symbols f
+              ON f.file = c.file
+              AND f.kind = 'function'
+              AND (
+                f.name GLOB 'get*' OR f.name GLOB 'Get*' OR f.name GLOB 'GET*' OR
+                f.name GLOB 'post*' OR f.name GLOB 'Post*' OR f.name GLOB 'POST*' OR
+                f.name GLOB 'put*' OR f.name GLOB 'Put*' OR f.name GLOB 'PUT*' OR
+                f.name GLOB 'delete*' OR f.name GLOB 'Delete*' OR f.name GLOB 'DELETE*' OR
+                f.name GLOB 'patch*' OR f.name GLOB 'Patch*' OR f.name GLOB 'PATCH*'
+              )
+            WHERE c.kind = 'class'
+              AND (c.name GLOB '*Controller' OR c.name GLOB '*controller')
+            GROUP BY c.id
+            ORDER BY cnt DESC
+            LIMIT ?;
+          `, [parsed.limit]);
+                return {
+                    kind: parsed.kind,
+                    results: rows.map((row) => ({
+                        name: String(row[0]),
+                        file: String(row[1]),
+                        count: Number(row[2]),
+                    })),
+                };
+            }
+            case "classesImplementing": {
+                const rows = execRowsParams(db, `
+            SELECT DISTINCT s.name, s.file
+            FROM symbol_edges e
+            JOIN symbols s ON s.id = e.from_id
+            JOIN symbols t ON t.id = e.to_id
+            WHERE e.label = ? AND t.name = ?;
+          `, ["implements", parsed.interfaceName]);
+                return {
+                    kind: parsed.kind,
+                    results: rows.map((row) => ({
+                        name: String(row[0]),
+                        file: String(row[1]),
+                    })),
+                };
+            }
+            case "affectedFunctionsForModule": {
+                const reverseDeps = bfsFileTraversal(parsed.modulePath, (file) => loadDirectFileDependents(db, file));
+                const impactedFiles = [parsed.modulePath, ...reverseDeps];
+                if (!impactedFiles.length) {
+                    return { kind: parsed.kind, results: [] };
+                }
+                const placeholders = impactedFiles.map(() => "?").join(", ");
+                const rows = execRowsParams(db, `
+            SELECT name, file
+            FROM symbols
+            WHERE kind = ?
+              AND file IN (${placeholders});
+          `, ["function", ...impactedFiles]);
+                return {
+                    kind: parsed.kind,
+                    results: rows.map((row) => ({
+                        name: String(row[0]),
+                        file: String(row[1]),
+                    })),
+                };
+            }
+            case "highestComplexityClasses": {
+                const rows = execRowsParams(db, `
+            SELECT name, file, COALESCE(complexity, 0) as score
+            FROM symbols
+            WHERE kind = ?
+            ORDER BY complexity DESC NULLS LAST
+            LIMIT ?;
+          `, ["class", parsed.limit]);
+                return {
+                    kind: parsed.kind,
+                    results: rows.map((row) => ({
+                        name: String(row[0]),
+                        file: String(row[1]),
+                        complexity: Number(row[2]),
+                    })),
+                };
+            }
+            case "highestComplexityFunctions": {
+                const rows = execRowsParams(db, `
+            SELECT name, file, COALESCE(complexity, 0) as score
+            FROM symbols
+            WHERE kind = ?
+            ORDER BY complexity DESC NULLS LAST
+            LIMIT ?;
+          `, ["function", parsed.limit]);
+                return {
+                    kind: parsed.kind,
+                    results: rows.map((row) => ({
+                        name: String(row[0]),
+                        file: String(row[1]),
+                        complexity: Number(row[2]),
+                    })),
+                };
+            }
+        }
+    });
+}
+//# sourceMappingURL=canned-query.js.map

package/dist/sqlite/canned-query.js.map

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

package/dist/sqlite/common.d.ts

@@ -0,0 +1,6 @@
+import type { SqliteDatabase } from "../sqlite-driver.js";
+export declare const toSqliteText: (value: unknown) => string;
+export declare const execRows: (db: SqliteDatabase, sql: string) => Array<Array<unknown>>;
+export declare const execRowsParams: (db: SqliteDatabase, sql: string, params: Array<string | number | null>) => Array<Array<unknown>>;
+export declare const dedupePreservingOrder: (values: string[]) => string[];
+//# sourceMappingURL=common.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../src/sqlite/common.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D,eAAO,MAAM,YAAY,GAAI,OAAO,OAAO,KAAG,MAM7C,CAAC;AAEF,eAAO,MAAM,QAAQ,GAAI,IAAI,cAAc,EAAE,KAAK,MAAM,KAAG,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAU9E,CAAC;AAEF,eAAO,MAAM,cAAc,GACzB,IAAI,cAAc,EAClB,KAAK,MAAM,EACX,QAAQ,KAAK,CAAC,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC,KACpC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAUtB,CAAC;AAEF,eAAO,MAAM,qBAAqB,GAAI,QAAQ,MAAM,EAAE,KAAG,MAAM,EAS9D,CAAC"}

package/dist/sqlite/common.js

@@ -0,0 +1,42 @@
+export const toSqliteText = (value) => {
+    if (typeof value === "string")
+        return value;
+    if (typeof value === "number" || typeof value === "boolean") {
+        return String(value);
+    }
+    return "";
+};
+export const execRows = (db, sql) => {
+    const rows = db.prepare(sql).raw().all();
+    const normalized = [];
+    for (const row of rows) {
+        if (!Array.isArray(row)) {
+            throw new Error("Expected sqlite raw() results to be row arrays.");
+        }
+        normalized.push(row);
+    }
+    return normalized;
+};
+export const execRowsParams = (db, sql, params) => {
+    const rows = db.prepare(sql).raw().all(params);
+    const normalized = [];
+    for (const row of rows) {
+        if (!Array.isArray(row)) {
+            throw new Error("Expected sqlite raw() results to be row arrays.");
+        }
+        normalized.push(row);
+    }
+    return normalized;
+};
+export const dedupePreservingOrder = (values) => {
+    const seen = new Set();
+    const deduped = [];
+    for (const value of values) {
+        if (seen.has(value))
+            continue;
+        seen.add(value);
+        deduped.push(value);
+    }
+    return deduped;
+};
+//# sourceMappingURL=common.js.map

package/dist/sqlite/common.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.js","sourceRoot":"","sources":["../../src/sqlite/common.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,KAAc,EAAU,EAAE;IACrD,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,SAAS,EAAE,CAAC;QAC5D,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,EAAkB,EAAE,GAAW,EAAyB,EAAE;IACjF,MAAM,IAAI,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,CAAC;IACzC,MAAM,UAAU,GAA0B,EAAE,CAAC;IAC7C,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;QACrE,CAAC;QACD,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACvB,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAG,CAC5B,EAAkB,EAClB,GAAW,EACX,MAAqC,EACd,EAAE;IACzB,MAAM,IAAI,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC/C,MAAM,UAAU,GAA0B,EAAE,CAAC;IAC7C,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;QACrE,CAAC;QACD,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACvB,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,MAAgB,EAAY,EAAE;IAClE,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC;YAAE,SAAS;QAC9B,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAChB,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACtB,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC"}

package/dist/sqlite/database.d.ts

@@ -0,0 +1,5 @@
+import { SqliteDatabase, type SqliteStatement } from "../sqlite-driver.js";
+export declare function withSqliteDatabase<T>(outputPath: string, callback: (db: SqliteDatabase) => T | Promise<T>): Promise<T>;
+export declare function withReadOnlySqliteDatabase<T>(outputPath: string, callback: (db: SqliteDatabase) => T | Promise<T>): Promise<T>;
+export declare function assertReadOnlyQueryStatement(stmt: SqliteStatement): void;
+//# sourceMappingURL=database.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"database.d.ts","sourceRoot":"","sources":["../../src/sqlite/database.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,KAAK,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAe3E,wBAAsB,kBAAkB,CAAC,CAAC,EACxC,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,CAAC,EAAE,EAAE,cAAc,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GAC/C,OAAO,CAAC,CAAC,CAAC,CAQZ;AAED,wBAAsB,0BAA0B,CAAC,CAAC,EAChD,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,CAAC,EAAE,EAAE,cAAc,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GAC/C,OAAO,CAAC,CAAC,CAAC,CAOZ;AAED,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,eAAe,GAAG,IAAI,CAGxE"}

package/dist/sqlite/database.js

@@ -0,0 +1,40 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import { SqliteDatabase } from "../sqlite-driver.js";
+import { ensureSchema } from "./schema.js";
+const readOrCreateDb = async (outputPath, options) => {
+    const readonly = options?.readonly ?? false;
+    const dir = path.dirname(outputPath);
+    if (dir && !readonly) {
+        await fs.mkdir(dir, { recursive: true });
+    }
+    const db = new SqliteDatabase(outputPath, {
+        readonly,
+    });
+    return { db };
+};
+export async function withSqliteDatabase(outputPath, callback) {
+    const { db } = await readOrCreateDb(outputPath);
+    try {
+        ensureSchema(db);
+        return await callback(db);
+    }
+    finally {
+        db.close();
+    }
+}
+export async function withReadOnlySqliteDatabase(outputPath, callback) {
+    const { db } = await readOrCreateDb(outputPath, { readonly: true });
+    try {
+        return await callback(db);
+    }
+    finally {
+        db.close();
+    }
+}
+export function assertReadOnlyQueryStatement(stmt) {
+    if (stmt.columns().length)
+        return;
+    throw new Error("Raw SQLite queries must be read-only result-producing statements such as SELECT or PRAGMA.");
+}
+//# sourceMappingURL=database.js.map

package/dist/sqlite/database.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"database.js","sourceRoot":"","sources":["../../src/sqlite/database.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,cAAc,EAAwB,MAAM,qBAAqB,CAAC;AAC3E,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,MAAM,cAAc,GAAG,KAAK,EAAE,UAAkB,EAAE,OAAgC,EAAE,EAAE;IACpF,MAAM,QAAQ,GAAG,OAAO,EAAE,QAAQ,IAAI,KAAK,CAAC;IAC5C,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IACrC,IAAI,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;QACrB,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3C,CAAC;IACD,MAAM,EAAE,GAAG,IAAI,cAAc,CAAC,UAAU,EAAE;QACxC,QAAQ;KACT,CAAC,CAAC;IACH,OAAO,EAAE,EAAE,EAAE,CAAC;AAChB,CAAC,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,UAAkB,EAClB,QAAgD;IAEhD,MAAM,EAAE,EAAE,EAAE,GAAG,MAAM,cAAc,CAAC,UAAU,CAAC,CAAC;IAChD,IAAI,CAAC;QACH,YAAY,CAAC,EAAE,CAAC,CAAC;QACjB,OAAO,MAAM,QAAQ,CAAC,EAAE,CAAC,CAAC;IAC5B,CAAC;YAAS,CAAC;QACT,EAAE,CAAC,KAAK,EAAE,CAAC;IACb,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,UAAkB,EAClB,QAAgD;IAEhD,MAAM,EAAE,EAAE,EAAE,GAAG,MAAM,cAAc,CAAC,UAAU,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IACpE,IAAI,CAAC;QACH,OAAO,MAAM,QAAQ,CAAC,EAAE,CAAC,CAAC;IAC5B,CAAC;YAAS,CAAC;QACT,EAAE,CAAC,KAAK,EAAE,CAAC;IACb,CAAC;AACH,CAAC;AAED,MAAM,UAAU,4BAA4B,CAAC,IAAqB;IAChE,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC,MAAM;QAAE,OAAO;IAClC,MAAM,IAAI,KAAK,CAAC,4FAA4F,CAAC,CAAC;AAChH,CAAC"}

package/dist/sqlite/query.d.ts

@@ -0,0 +1,9 @@
+import type { RawSqlResult } from "./types.js";
+export { queryGraphSqlite } from "./canned-query.js";
+export type QueryGraphSqliteRawOptions = {
+    maxRows?: number | undefined;
+    maxBytes?: number | undefined;
+    maxCellBytes?: number | undefined;
+};
+export declare function queryGraphSqliteRaw(outputPath: string, sql: string, params?: Array<string | number | null>, options?: QueryGraphSqliteRawOptions): Promise<RawSqlResult>;
+//# sourceMappingURL=query.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../src/sqlite/query.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAS/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAErD,MAAM,MAAM,0BAA0B,GAAG;IACvC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACnC,CAAC;AAEF,wBAAsB,mBAAmB,CACvC,UAAU,EAAE,MAAM,EAClB,GAAG,EAAE,MAAM,EACX,MAAM,GAAE,KAAK,CAAC,MAAM,GAAG,MAAM,GAAG,IAAI,CAAM,EAC1C,OAAO,CAAC,EAAE,0BAA0B,GACnC,OAAO,CAAC,YAAY,CAAC,CA2BvB"}

package/dist/sqlite/query.js

@@ -0,0 +1,32 @@
+import { isReadOnlySqliteError } from "../sqlite-driver.js";
+import { assertReadOnlyQueryStatement, withReadOnlySqliteDatabase } from "./database.js";
+import { collectBoundedRawSqlRows, DEFAULT_SQLITE_BYTE_LIMIT, MAX_SQLITE_CELL_BYTES, MAX_SQLITE_ROW_LIMIT, } from "./rowBounds.js";
+export { queryGraphSqlite } from "./canned-query.js";
+export async function queryGraphSqliteRaw(outputPath, sql, params = [], options) {
+    return await withReadOnlySqliteDatabase(outputPath, (db) => {
+        try {
+            const stmt = db.prepare(sql);
+            assertReadOnlyQueryStatement(stmt);
+            const columns = stmt.columns().map((col) => col.name);
+            const requestedRows = options?.maxRows;
+            const maxRows = requestedRows === undefined
+                ? MAX_SQLITE_ROW_LIMIT
+                : Math.min(MAX_SQLITE_ROW_LIMIT, Math.max(0, Math.floor(requestedRows)));
+            const maxBytes = options?.maxBytes ?? DEFAULT_SQLITE_BYTE_LIMIT;
+            const maxCellBytes = options?.maxCellBytes ?? MAX_SQLITE_CELL_BYTES;
+            // Always stream via iterate so per-cell and cumulative budgets apply before append.
+            return collectBoundedRawSqlRows(columns, stmt.raw().iterate(params), {
+                maxRows,
+                maxBytes,
+                maxCellBytes,
+            });
+        }
+        catch (error) {
+            if (isReadOnlySqliteError(error)) {
+                throw new Error("Raw SQLite queries must be read-only result-producing statements such as SELECT or PRAGMA.");
+            }
+            throw error;
+        }
+    });
+}
+//# sourceMappingURL=query.js.map