@optave/codegraph 3.2.0 → 3.3.0

package/dist/db/query-builder.js

@@ -0,0 +1,313 @@
+import { DbError } from '../shared/errors.js';
+import { DEAD_ROLE_PREFIX, EVERY_EDGE_KIND } from '../shared/kinds.js';
+// ─── Validation Helpers ─────────────────────────────────────────────
+const SAFE_ALIAS_RE = /^[a-z_][a-z0-9_]*$/i;
+const SAFE_COLUMN_RE = /^[a-z_][a-z0-9_]*(?:\.[a-z_][a-z0-9_]*)?$/i;
+// Matches: column, table.column, column ASC, table.column DESC
+const SAFE_ORDER_TERM_RE = /^[a-z_][a-z0-9_]*(?:\.[a-z_][a-z0-9_]*)?\s*(?:asc|desc)?$/i;
+// Matches safe SELECT expressions: column refs, *, table.*, COALESCE(...) AS alias
+const SAFE_SELECT_TOKEN_RE = /^(?:[a-z_][a-z0-9_]*(?:\.[a-z_*][a-z0-9_]*)?\s*(?:as\s+[a-z_][a-z0-9_]*)?|[a-z_]+\([^)]*\)\s*(?:as\s+[a-z_][a-z0-9_]*)?)$/i;
+function validateAlias(alias) {
+    if (!SAFE_ALIAS_RE.test(alias)) {
+        throw new DbError(`Invalid SQL alias: ${alias}`);
+    }
+}
+function validateColumn(column) {
+    if (!SAFE_COLUMN_RE.test(column)) {
+        throw new DbError(`Invalid SQL column: ${column}`);
+    }
+}
+function validateOrderBy(clause) {
+    const terms = clause.split(',').map((t) => t.trim());
+    for (const term of terms) {
+        if (!SAFE_ORDER_TERM_RE.test(term)) {
+            throw new DbError(`Invalid ORDER BY term: ${term}`);
+        }
+    }
+}
+function splitTopLevelCommas(str) {
+    const parts = [];
+    let depth = 0;
+    let start = 0;
+    for (let i = 0; i < str.length; i++) {
+        if (str[i] === '(')
+            depth++;
+        else if (str[i] === ')')
+            depth--;
+        else if (str[i] === ',' && depth === 0) {
+            parts.push(str.slice(start, i).trim());
+            start = i + 1;
+        }
+    }
+    parts.push(str.slice(start).trim());
+    return parts;
+}
+function validateSelectCols(cols) {
+    const tokens = splitTopLevelCommas(cols);
+    for (const token of tokens) {
+        if (!SAFE_SELECT_TOKEN_RE.test(token)) {
+            throw new DbError(`Invalid SELECT expression: ${token}`);
+        }
+    }
+}
+function validateEdgeKind(edgeKind) {
+    if (!EVERY_EDGE_KIND.includes(edgeKind)) {
+        throw new DbError(`Invalid edge kind: ${edgeKind} (expected one of ${EVERY_EDGE_KIND.join(', ')})`);
+    }
+}
+// ─── LIKE Escaping ──────────────────────────────────────────────────
+/** Escape LIKE wildcards in a literal string segment. */
+export function escapeLike(s) {
+    return s.replace(/[%_\\]/g, '\\$&');
+}
+/**
+ * Normalize a file filter value (string, string[], or falsy) into a flat array.
+ * Returns an empty array when the input is falsy.
+ * @param {string|string[]|undefined|null} file
+ * @returns {string[]}
+ */
+export function normalizeFileFilter(file) {
+    if (!file)
+        return [];
+    return Array.isArray(file) ? file : [file];
+}
+/**
+ * Build a SQL condition + params for a multi-value file LIKE filter.
+ * Returns `{ sql: '', params: [] }` when the filter is empty.
+ *
+ * @param {string|string[]} file - One or more partial file paths
+ * @param {string} [column='file'] - The column name to filter on (e.g. 'n.file', 'a.file')
+ * @returns {{ sql: string, params: string[] }}
+ */
+export function buildFileConditionSQL(file, column = 'file') {
+    validateColumn(column);
+    const files = normalizeFileFilter(file);
+    if (files.length === 0)
+        return { sql: '', params: [] };
+    if (files.length === 1) {
+        return {
+            sql: ` AND ${column} LIKE ? ESCAPE '\\'`,
+            params: [`%${escapeLike(files[0])}%`],
+        };
+    }
+    const clauses = files.map(() => `${column} LIKE ? ESCAPE '\\'`);
+    return {
+        sql: ` AND (${clauses.join(' OR ')})`,
+        params: files.map((f) => `%${escapeLike(f)}%`),
+    };
+}
+/**
+ * Commander option accumulator for repeatable `--file` flag.
+ * Use as: `['-f, --file <path>', 'Scope to file (partial match, repeatable)', collectFile]`
+ * @param {string} val - New value from Commander
+ * @param {string[]} acc - Accumulated values (undefined on first call)
+ * @returns {string[]}
+ */
+export function collectFile(val, acc) {
+    acc = acc || [];
+    acc.push(val);
+    return acc;
+}
+// ─── Standalone Helpers ──────────────────────────────────────────────
+/**
+ * Return a SQL AND clause that excludes test/spec/stories files.
+ * Returns empty string when disabled.
+ * @param {string} [column='n.file'] - Column to filter on
+ * @param {boolean} [enabled=true] - No-op when false
+ */
+export function testFilterSQL(column = 'n.file', enabled = true) {
+    if (!enabled)
+        return '';
+    validateColumn(column);
+    return `AND ${column} NOT LIKE '%.test.%'
+       AND ${column} NOT LIKE '%.spec.%'
+       AND ${column} NOT LIKE '%__test__%'
+       AND ${column} NOT LIKE '%__tests__%'
+       AND ${column} NOT LIKE '%.stories.%'`;
+}
+/**
+ * Build IN (?, ?, ?) placeholders and params array for a kind filter.
+ * @param {string[]} kinds
+ * @returns {{ placeholders: string, params: string[] }}
+ */
+export function kindInClause(kinds) {
+    return {
+        placeholders: kinds.map(() => '?').join(', '),
+        params: [...kinds],
+    };
+}
+/**
+ * Return a LEFT JOIN subquery for fan-in (incoming edge count).
+ * @param {string} [edgeKind='calls'] - Edge kind to count
+ * @param {string} [alias='fi'] - Subquery alias
+ */
+export function fanInJoinSQL(edgeKind = 'calls', alias = 'fi') {
+    validateEdgeKind(edgeKind);
+    validateAlias(alias);
+    return `LEFT JOIN (
+    SELECT target_id, COUNT(*) AS cnt FROM edges WHERE kind = '${edgeKind}' GROUP BY target_id
+  ) ${alias} ON ${alias}.target_id = n.id`;
+}
+/**
+ * Return a LEFT JOIN subquery for fan-out (outgoing edge count).
+ * @param {string} [edgeKind='calls'] - Edge kind to count
+ * @param {string} [alias='fo'] - Subquery alias
+ */
+export function fanOutJoinSQL(edgeKind = 'calls', alias = 'fo') {
+    validateEdgeKind(edgeKind);
+    validateAlias(alias);
+    return `LEFT JOIN (
+    SELECT source_id, COUNT(*) AS cnt FROM edges WHERE kind = '${edgeKind}' GROUP BY source_id
+  ) ${alias} ON ${alias}.source_id = n.id`;
+}
+// ─── NodeQuery Fluent Builder ────────────────────────────────────────
+/**
+ * Fluent builder for the common `SELECT ... FROM nodes n WHERE ...` pattern.
+ * Not an ORM — complex queries (BFS, correlated subqueries) stay as raw SQL.
+ */
+export class NodeQuery {
+    #selectCols = 'n.*';
+    #joins = [];
+    #conditions = [];
+    #params = [];
+    #orderByClause = '';
+    #limitValue = null;
+    /** Set SELECT columns (default: `n.*`). */
+    select(cols) {
+        validateSelectCols(cols);
+        this.#selectCols = cols;
+        return this;
+    }
+    /** WHERE n.kind IN (?, ?, ...) */
+    kinds(kindArray) {
+        if (!kindArray || kindArray.length === 0)
+            return this;
+        const { placeholders, params } = kindInClause(kindArray);
+        this.#conditions.push(`n.kind IN (${placeholders})`);
+        this.#params.push(...params);
+        return this;
+    }
+    /** Add 5 NOT LIKE conditions to exclude test files. No-op when enabled is falsy. */
+    excludeTests(enabled) {
+        if (!enabled)
+            return this;
+        this.#conditions.push(`n.file NOT LIKE '%.test.%'`, `n.file NOT LIKE '%.spec.%'`, `n.file NOT LIKE '%__test__%'`, `n.file NOT LIKE '%__tests__%'`, `n.file NOT LIKE '%.stories.%'`);
+        return this;
+    }
+    /** WHERE n.file LIKE ? (no-op if falsy). Accepts a single string or string[]. */
+    fileFilter(file) {
+        const files = normalizeFileFilter(file);
+        if (files.length === 0)
+            return this;
+        if (files.length === 1) {
+            this.#conditions.push("n.file LIKE ? ESCAPE '\\'");
+            this.#params.push(`%${escapeLike(files[0])}%`);
+        }
+        else {
+            const clauses = files.map(() => "n.file LIKE ? ESCAPE '\\'");
+            this.#conditions.push(`(${clauses.join(' OR ')})`);
+            this.#params.push(...files.map((f) => `%${escapeLike(f)}%`));
+        }
+        return this;
+    }
+    /** WHERE n.kind = ? (no-op if falsy). */
+    kindFilter(kind) {
+        if (!kind)
+            return this;
+        this.#conditions.push('n.kind = ?');
+        this.#params.push(kind);
+        return this;
+    }
+    /** WHERE n.role = ? (no-op if falsy). 'dead' matches all dead-* sub-roles. */
+    roleFilter(role) {
+        if (!role)
+            return this;
+        if (role === DEAD_ROLE_PREFIX) {
+            this.#conditions.push('n.role LIKE ?');
+            this.#params.push(`${DEAD_ROLE_PREFIX}%`);
+        }
+        else {
+            this.#conditions.push('n.role = ?');
+            this.#params.push(role);
+        }
+        return this;
+    }
+    /** WHERE n.name LIKE ? (no-op if falsy). Escapes LIKE wildcards in the value. */
+    nameLike(pattern) {
+        if (!pattern)
+            return this;
+        this.#conditions.push("n.name LIKE ? ESCAPE '\\'");
+        this.#params.push(`%${escapeLike(pattern)}%`);
+        return this;
+    }
+    /** Raw WHERE condition escape hatch. */
+    where(sql, ...params) {
+        this.#conditions.push(sql);
+        this.#params.push(...params);
+        return this;
+    }
+    /** Add fan-in LEFT JOIN subquery. */
+    withFanIn(edgeKind = 'calls') {
+        return this._join(fanInJoinSQL(edgeKind));
+    }
+    /** Add fan-out LEFT JOIN subquery. */
+    withFanOut(edgeKind = 'calls') {
+        return this._join(fanOutJoinSQL(edgeKind));
+    }
+    /** LEFT JOIN function_complexity. */
+    withComplexity() {
+        return this._join('LEFT JOIN function_complexity fc ON fc.node_id = n.id');
+    }
+    /** LEFT JOIN file_commit_counts. */
+    withChurn() {
+        return this._join('LEFT JOIN file_commit_counts fcc ON n.file = fcc.file');
+    }
+    /** @private Raw JOIN — internal use only; external callers should use withFanIn/withFanOut/withComplexity/withChurn. */
+    _join(sql) {
+        this.#joins.push(sql);
+        return this;
+    }
+    /** ORDER BY clause. */
+    orderBy(clause) {
+        validateOrderBy(clause);
+        this.#orderByClause = clause;
+        return this;
+    }
+    /** LIMIT ?. */
+    limit(n) {
+        if (n == null)
+            return this;
+        this.#limitValue = n;
+        return this;
+    }
+    /** Build the SQL and params without executing. */
+    build() {
+        const joins = this.#joins.length > 0 ? `\n       ${this.#joins.join('\n       ')}` : '';
+        const where = this.#conditions.length > 0 ? `\n       WHERE ${this.#conditions.join(' AND ')}` : '';
+        const orderBy = this.#orderByClause ? `\n       ORDER BY ${this.#orderByClause}` : '';
+        let limitClause = '';
+        const params = [...this.#params];
+        if (this.#limitValue != null) {
+            limitClause = '\n       LIMIT ?';
+            params.push(this.#limitValue);
+        }
+        const sql = `SELECT ${this.#selectCols}\n       FROM nodes n${joins}${where}${orderBy}${limitClause}`;
+        return { sql, params };
+    }
+    /** Execute and return all rows. */
+    all(db) {
+        const { sql, params } = this.build();
+        return db.prepare(sql).all(...params);
+    }
+    /** Execute and return first row. */
+    get(db) {
+        const { sql, params } = this.build();
+        return db.prepare(sql).get(...params);
+    }
+    /** Execute and return an iterator. */
+    iterate(db) {
+        const { sql, params } = this.build();
+        return db.prepare(sql).iterate(...params);
+    }
+}
+//# sourceMappingURL=query-builder.js.map

package/dist/db/query-builder.js.map

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

package/dist/db/repository/base.d.ts

@@ -0,0 +1,115 @@
+/**
+ * Abstract Repository base class.
+ *
+ * Defines the contract for all graph data access. Every method throws
+ * "not implemented" by default — concrete subclasses override what they support.
+ */
+export class Repository {
+    /** @param {number} id @returns {object|undefined} */
+    findNodeById(_id: any): object | undefined;
+    /** @param {string} file @returns {object[]} */
+    findNodesByFile(_file: any): object[];
+    /** @param {string} fileLike @returns {object[]} */
+    findFileNodes(_fileLike: any): object[];
+    /** @param {string} namePattern @param {object} [opts] @returns {object[]} */
+    findNodesWithFanIn(_namePattern: any, _opts: any): object[];
+    /** @returns {number} */
+    countNodes(): number;
+    /** @returns {number} */
+    countEdges(): number;
+    /** @returns {number} */
+    countFiles(): number;
+    /** @param {string} name @param {string} kind @param {string} file @param {number} line @returns {number|undefined} */
+    getNodeId(_name: any, _kind: any, _file: any, _line: any): number | undefined;
+    /** @param {string} name @param {string} file @param {number} line @returns {number|undefined} */
+    getFunctionNodeId(_name: any, _file: any, _line: any): number | undefined;
+    /** @param {string} file @returns {{ id: number, name: string, kind: string, line: number }[]} */
+    bulkNodeIdsByFile(_file: any): {
+        id: number;
+        name: string;
+        kind: string;
+        line: number;
+    }[];
+    /** @param {number} parentId @returns {object[]} */
+    findNodeChildren(_parentId: any): object[];
+    /** @param {string} scopeName @param {object} [opts] @returns {object[]} */
+    findNodesByScope(_scopeName: any, _opts: any): object[];
+    /** @param {string} qualifiedName @param {object} [opts] @returns {object[]} */
+    findNodeByQualifiedName(_qualifiedName: any, _opts: any): object[];
+    /** @param {object} [opts] @returns {object[]} */
+    listFunctionNodes(_opts: any): object[];
+    /** @param {object} [opts] @returns {IterableIterator} */
+    iterateFunctionNodes(_opts: any): IterableIterator<any>;
+    /** @param {object} [opts] @returns {object[]} */
+    findNodesForTriage(_opts: any): object[];
+    /** @param {number} nodeId @returns {object[]} */
+    findCallees(_nodeId: any): object[];
+    /** @param {number} nodeId @returns {object[]} */
+    findCallers(_nodeId: any): object[];
+    /** @param {number} nodeId @returns {object[]} */
+    findDistinctCallers(_nodeId: any): object[];
+    /** @param {number} nodeId @returns {object[]} */
+    findAllOutgoingEdges(_nodeId: any): object[];
+    /** @param {number} nodeId @returns {object[]} */
+    findAllIncomingEdges(_nodeId: any): object[];
+    /** @param {number} nodeId @returns {string[]} */
+    findCalleeNames(_nodeId: any): string[];
+    /** @param {number} nodeId @returns {string[]} */
+    findCallerNames(_nodeId: any): string[];
+    /** @param {number} nodeId @returns {{ file: string, edge_kind: string }[]} */
+    findImportTargets(_nodeId: any): {
+        file: string;
+        edge_kind: string;
+    }[];
+    /** @param {number} nodeId @returns {{ file: string, edge_kind: string }[]} */
+    findImportSources(_nodeId: any): {
+        file: string;
+        edge_kind: string;
+    }[];
+    /** @param {number} nodeId @returns {object[]} */
+    findImportDependents(_nodeId: any): object[];
+    /** @param {string} file @returns {Set<number>} */
+    findCrossFileCallTargets(_file: any): Set<number>;
+    /** @param {number} nodeId @param {string} file @returns {number} */
+    countCrossFileCallers(_nodeId: any, _file: any): number;
+    /** @param {number} classNodeId @returns {Set<number>} */
+    getClassHierarchy(_classNodeId: any): Set<number>;
+    /** @param {string} file @returns {{ caller_name: string, callee_name: string }[]} */
+    findIntraFileCallEdges(_file: any): {
+        caller_name: string;
+        callee_name: string;
+    }[];
+    /** @returns {{ id: number, name: string, kind: string, file: string }[]} */
+    getCallableNodes(): {
+        id: number;
+        name: string;
+        kind: string;
+        file: string;
+    }[];
+    /** @returns {{ source_id: number, target_id: number, confidence: number|null }[]} */
+    getCallEdges(): {
+        source_id: number;
+        target_id: number;
+        confidence: number | null;
+    }[];
+    /** @returns {{ id: number, name: string, file: string }[]} */
+    getFileNodesAll(): {
+        id: number;
+        name: string;
+        file: string;
+    }[];
+    /** @returns {{ source_id: number, target_id: number }[]} */
+    getImportEdges(): {
+        source_id: number;
+        target_id: number;
+    }[];
+    /** @returns {boolean} */
+    hasCfgTables(): boolean;
+    /** @returns {boolean} */
+    hasEmbeddings(): boolean;
+    /** @returns {boolean} */
+    hasDataflowTable(): boolean;
+    /** @param {number} nodeId @returns {object|undefined} */
+    getComplexityForNode(_nodeId: any): object | undefined;
+}
+//# sourceMappingURL=base.d.ts.map

package/dist/db/repository/base.d.ts.map

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

package/dist/db/repository/base.js

@@ -0,0 +1,165 @@
+/**
+ * Abstract Repository base class.
+ *
+ * Defines the contract for all graph data access. Every method throws
+ * "not implemented" by default — concrete subclasses override what they support.
+ */
+export class Repository {
+    // ── Node lookups ────────────────────────────────────────────────────
+    /** @param {number} id @returns {object|undefined} */
+    findNodeById(_id) {
+        throw new Error('not implemented');
+    }
+    /** @param {string} file @returns {object[]} */
+    findNodesByFile(_file) {
+        throw new Error('not implemented');
+    }
+    /** @param {string} fileLike @returns {object[]} */
+    findFileNodes(_fileLike) {
+        throw new Error('not implemented');
+    }
+    /** @param {string} namePattern @param {object} [opts] @returns {object[]} */
+    findNodesWithFanIn(_namePattern, _opts) {
+        throw new Error('not implemented');
+    }
+    /** @returns {number} */
+    countNodes() {
+        throw new Error('not implemented');
+    }
+    /** @returns {number} */
+    countEdges() {
+        throw new Error('not implemented');
+    }
+    /** @returns {number} */
+    countFiles() {
+        throw new Error('not implemented');
+    }
+    /** @param {string} name @param {string} kind @param {string} file @param {number} line @returns {number|undefined} */
+    getNodeId(_name, _kind, _file, _line) {
+        throw new Error('not implemented');
+    }
+    /** @param {string} name @param {string} file @param {number} line @returns {number|undefined} */
+    getFunctionNodeId(_name, _file, _line) {
+        throw new Error('not implemented');
+    }
+    /** @param {string} file @returns {{ id: number, name: string, kind: string, line: number }[]} */
+    bulkNodeIdsByFile(_file) {
+        throw new Error('not implemented');
+    }
+    /** @param {number} parentId @returns {object[]} */
+    findNodeChildren(_parentId) {
+        throw new Error('not implemented');
+    }
+    /** @param {string} scopeName @param {object} [opts] @returns {object[]} */
+    findNodesByScope(_scopeName, _opts) {
+        throw new Error('not implemented');
+    }
+    /** @param {string} qualifiedName @param {object} [opts] @returns {object[]} */
+    findNodeByQualifiedName(_qualifiedName, _opts) {
+        throw new Error('not implemented');
+    }
+    /** @param {object} [opts] @returns {object[]} */
+    listFunctionNodes(_opts) {
+        throw new Error('not implemented');
+    }
+    /** @param {object} [opts] @returns {IterableIterator} */
+    iterateFunctionNodes(_opts) {
+        throw new Error('not implemented');
+    }
+    /** @param {object} [opts] @returns {object[]} */
+    findNodesForTriage(_opts) {
+        throw new Error('not implemented');
+    }
+    // ── Edge queries ────────────────────────────────────────────────────
+    /** @param {number} nodeId @returns {object[]} */
+    findCallees(_nodeId) {
+        throw new Error('not implemented');
+    }
+    /** @param {number} nodeId @returns {object[]} */
+    findCallers(_nodeId) {
+        throw new Error('not implemented');
+    }
+    /** @param {number} nodeId @returns {object[]} */
+    findDistinctCallers(_nodeId) {
+        throw new Error('not implemented');
+    }
+    /** @param {number} nodeId @returns {object[]} */
+    findAllOutgoingEdges(_nodeId) {
+        throw new Error('not implemented');
+    }
+    /** @param {number} nodeId @returns {object[]} */
+    findAllIncomingEdges(_nodeId) {
+        throw new Error('not implemented');
+    }
+    /** @param {number} nodeId @returns {string[]} */
+    findCalleeNames(_nodeId) {
+        throw new Error('not implemented');
+    }
+    /** @param {number} nodeId @returns {string[]} */
+    findCallerNames(_nodeId) {
+        throw new Error('not implemented');
+    }
+    /** @param {number} nodeId @returns {{ file: string, edge_kind: string }[]} */
+    findImportTargets(_nodeId) {
+        throw new Error('not implemented');
+    }
+    /** @param {number} nodeId @returns {{ file: string, edge_kind: string }[]} */
+    findImportSources(_nodeId) {
+        throw new Error('not implemented');
+    }
+    /** @param {number} nodeId @returns {object[]} */
+    findImportDependents(_nodeId) {
+        throw new Error('not implemented');
+    }
+    /** @param {string} file @returns {Set<number>} */
+    findCrossFileCallTargets(_file) {
+        throw new Error('not implemented');
+    }
+    /** @param {number} nodeId @param {string} file @returns {number} */
+    countCrossFileCallers(_nodeId, _file) {
+        throw new Error('not implemented');
+    }
+    /** @param {number} classNodeId @returns {Set<number>} */
+    getClassHierarchy(_classNodeId) {
+        throw new Error('not implemented');
+    }
+    /** @param {string} file @returns {{ caller_name: string, callee_name: string }[]} */
+    findIntraFileCallEdges(_file) {
+        throw new Error('not implemented');
+    }
+    // ── Graph-read queries ──────────────────────────────────────────────
+    /** @returns {{ id: number, name: string, kind: string, file: string }[]} */
+    getCallableNodes() {
+        throw new Error('not implemented');
+    }
+    /** @returns {{ source_id: number, target_id: number, confidence: number|null }[]} */
+    getCallEdges() {
+        throw new Error('not implemented');
+    }
+    /** @returns {{ id: number, name: string, file: string }[]} */
+    getFileNodesAll() {
+        throw new Error('not implemented');
+    }
+    /** @returns {{ source_id: number, target_id: number }[]} */
+    getImportEdges() {
+        throw new Error('not implemented');
+    }
+    // ── Optional table checks (default: false/undefined) ────────────────
+    /** @returns {boolean} */
+    hasCfgTables() {
+        throw new Error('not implemented');
+    }
+    /** @returns {boolean} */
+    hasEmbeddings() {
+        throw new Error('not implemented');
+    }
+    /** @returns {boolean} */
+    hasDataflowTable() {
+        throw new Error('not implemented');
+    }
+    /** @param {number} nodeId @returns {object|undefined} */
+    getComplexityForNode(_nodeId) {
+        throw new Error('not implemented');
+    }
+}
+//# sourceMappingURL=base.js.map

package/dist/db/repository/base.js.map

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

package/dist/db/repository/build-stmts.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Cascade-delete all graph data for a single file across all tables.
+ * Order: dependent tables first, then edges, then nodes, then hashes.
+ *
+ * @param {object} db - Open read-write database handle
+ * @param {string} file - Relative file path to purge
+ * @param {object} [opts]
+ * @param {boolean} [opts.purgeHashes=true] - Also delete file_hashes entry
+ */
+export function purgeFileData(db: object, file: string, opts?: {
+    purgeHashes?: boolean | undefined;
+}): void;
+/**
+ * Purge all graph data for multiple files.
+ * Prepares statements once and loops over files for efficiency.
+ *
+ * @param {object} db - Open read-write database handle
+ * @param {string[]} files - Relative file paths to purge
+ * @param {object} [opts]
+ * @param {boolean} [opts.purgeHashes=true]
+ */
+export function purgeFilesData(db: object, files: string[], opts?: {
+    purgeHashes?: boolean | undefined;
+}): void;
+//# sourceMappingURL=build-stmts.d.ts.map

package/dist/db/repository/build-stmts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-stmts.d.ts","sourceRoot":"","sources":["../../../src/db/repository/build-stmts.js"],"names":[],"mappings":"AA8CA;;;;;;;;GAQG;AACH,kCALW,MAAM,QACN,MAAM,SAEd;IAAuB,WAAW;CACpC,QAIA;AA8BD;;;;;;;;GAQG;AACH,mCALW,MAAM,SACN,MAAM,EAAE,SAEhB;IAAuB,WAAW;CAAM,QAQ1C"}