@optave/codegraph 3.1.5 → 3.3.0

package/dist/db/index.js

@@ -0,0 +1,6 @@
+// Barrel re-export — keeps all existing `import { ... } from '…/db/index.js'` working.
+export { closeDb, findDbPath, findRepoRoot, openDb, openReadonlyOrFail, openRepo, } from './connection.js';
+export { getBuildMeta, initSchema, MIGRATIONS, setBuildMeta } from './migrations.js';
+export { fanInJoinSQL, fanOutJoinSQL, kindInClause, NodeQuery, testFilterSQL, } from './query-builder.js';
+export { bulkNodeIdsByFile, countCrossFileCallers, countEdges, countFiles, countNodes, deleteCfgForNode, findAllIncomingEdges, findAllOutgoingEdges, findCalleeNames, findCallees, findCallerNames, findCallers, findCrossFileCallTargets, findDistinctCallers, findFileNodes, findImplementors, findImportDependents, findImportSources, findImportTargets, findInterfaces, findIntraFileCallEdges, findNodeById, findNodeByQualifiedName, findNodeChildren, findNodesByFile, findNodesByScope, findNodesForTriage, findNodesWithFanIn, getCallableNodes, getCallEdges, getCfgBlocks, getCfgEdges, getClassHierarchy, getCoChangeMeta, getComplexityForNode, getEmbeddingCount, getEmbeddingMeta, getFileNodesAll, getFunctionNodeId, getImportEdges, getNodeId, hasCfgTables, hasCoChanges, hasDataflowTable, hasEmbeddings, InMemoryRepository, iterateFunctionNodes, listFunctionNodes, purgeFileData, purgeFilesData, Repository, SqliteRepository, upsertCoChangeMeta, } from './repository/index.js';
+//# sourceMappingURL=index.js.map

package/dist/db/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/db/index.js"],"names":[],"mappings":"AAAA,uFAAuF;AACvF,OAAO,EACL,OAAO,EACP,UAAU,EACV,YAAY,EACZ,MAAM,EACN,kBAAkB,EAClB,QAAQ,GACT,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACrF,OAAO,EACL,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,SAAS,EACT,aAAa,GACd,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,UAAU,EACV,UAAU,EACV,UAAU,EACV,gBAAgB,EAChB,oBAAoB,EACpB,oBAAoB,EACpB,eAAe,EACf,WAAW,EACX,eAAe,EACf,WAAW,EACX,wBAAwB,EACxB,mBAAmB,EACnB,aAAa,EACb,gBAAgB,EAChB,oBAAoB,EACpB,iBAAiB,EACjB,iBAAiB,EACjB,cAAc,EACd,sBAAsB,EACtB,YAAY,EACZ,uBAAuB,EACvB,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,EAChB,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,iBAAiB,EACjB,eAAe,EACf,oBAAoB,EACpB,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,EACf,iBAAiB,EACjB,cAAc,EACd,SAAS,EACT,YAAY,EACZ,YAAY,EACZ,gBAAgB,EAChB,aAAa,EACb,kBAAkB,EAClB,oBAAoB,EACpB,iBAAiB,EACjB,aAAa,EACb,cAAc,EACd,UAAU,EACV,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,uBAAuB,CAAC"}

package/dist/db/migrations.d.ts

@@ -0,0 +1,8 @@
+export function getBuildMeta(db: any, key: any): any;
+export function setBuildMeta(db: any, entries: any): void;
+export function initSchema(db: any): void;
+export const MIGRATIONS: {
+    version: number;
+    up: string;
+}[];
+//# sourceMappingURL=migrations.d.ts.map

package/dist/db/migrations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrations.d.ts","sourceRoot":"","sources":["../../src/db/migrations.js"],"names":[],"mappings":"AA8PA,qDASC;AAED,0DAQC;AAED,0CAsDC;AAtUD;;;IA+OE"}

package/dist/db/migrations.js

@@ -0,0 +1,323 @@
+import { debug } from '../infrastructure/logger.js';
+// ─── Schema Migrations ─────────────────────────────────────────────────
+export const MIGRATIONS = [
+    {
+        version: 1,
+        up: `
+      CREATE TABLE IF NOT EXISTS nodes (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        name TEXT NOT NULL,
+        kind TEXT NOT NULL,
+        file TEXT NOT NULL,
+        line INTEGER,
+        end_line INTEGER,
+        UNIQUE(name, kind, file, line)
+      );
+      CREATE TABLE IF NOT EXISTS edges (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        source_id INTEGER NOT NULL,
+        target_id INTEGER NOT NULL,
+        kind TEXT NOT NULL,
+        confidence REAL DEFAULT 1.0,
+        dynamic INTEGER DEFAULT 0,
+        FOREIGN KEY(source_id) REFERENCES nodes(id),
+        FOREIGN KEY(target_id) REFERENCES nodes(id)
+      );
+      CREATE INDEX IF NOT EXISTS idx_nodes_name ON nodes(name);
+      CREATE INDEX IF NOT EXISTS idx_nodes_file ON nodes(file);
+      CREATE INDEX IF NOT EXISTS idx_nodes_kind ON nodes(kind);
+      CREATE INDEX IF NOT EXISTS idx_edges_source ON edges(source_id);
+      CREATE INDEX IF NOT EXISTS idx_edges_target ON edges(target_id);
+      CREATE INDEX IF NOT EXISTS idx_edges_kind ON edges(kind);
+      CREATE TABLE IF NOT EXISTS node_metrics (
+        node_id INTEGER PRIMARY KEY,
+        line_count INTEGER,
+        symbol_count INTEGER,
+        import_count INTEGER,
+        export_count INTEGER,
+        fan_in INTEGER,
+        fan_out INTEGER,
+        cohesion REAL,
+        file_count INTEGER,
+        FOREIGN KEY(node_id) REFERENCES nodes(id)
+      );
+      CREATE INDEX IF NOT EXISTS idx_node_metrics_node ON node_metrics(node_id);
+    `,
+    },
+    {
+        version: 2,
+        up: `
+      CREATE INDEX IF NOT EXISTS idx_nodes_name_kind_file ON nodes(name, kind, file);
+      CREATE INDEX IF NOT EXISTS idx_nodes_file_kind ON nodes(file, kind);
+      CREATE INDEX IF NOT EXISTS idx_edges_source_kind ON edges(source_id, kind);
+      CREATE INDEX IF NOT EXISTS idx_edges_target_kind ON edges(target_id, kind);
+    `,
+    },
+    {
+        version: 3,
+        up: `
+      CREATE TABLE IF NOT EXISTS file_hashes (
+        file TEXT PRIMARY KEY,
+        hash TEXT NOT NULL,
+        mtime INTEGER NOT NULL
+      );
+    `,
+    },
+    {
+        version: 4,
+        up: `ALTER TABLE file_hashes ADD COLUMN size INTEGER DEFAULT 0;`,
+    },
+    {
+        version: 5,
+        up: `
+      CREATE TABLE IF NOT EXISTS co_changes (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        file_a TEXT NOT NULL,
+        file_b TEXT NOT NULL,
+        commit_count INTEGER NOT NULL,
+        jaccard REAL NOT NULL,
+        last_commit_epoch INTEGER,
+        UNIQUE(file_a, file_b)
+      );
+      CREATE INDEX IF NOT EXISTS idx_co_changes_file_a ON co_changes(file_a);
+      CREATE INDEX IF NOT EXISTS idx_co_changes_file_b ON co_changes(file_b);
+      CREATE INDEX IF NOT EXISTS idx_co_changes_jaccard ON co_changes(jaccard DESC);
+      CREATE TABLE IF NOT EXISTS co_change_meta (
+        key TEXT PRIMARY KEY,
+        value TEXT NOT NULL
+      );
+    `,
+    },
+    {
+        version: 6,
+        up: `
+      CREATE TABLE IF NOT EXISTS file_commit_counts (
+        file TEXT PRIMARY KEY,
+        commit_count INTEGER NOT NULL DEFAULT 0
+      );
+    `,
+    },
+    {
+        version: 7,
+        up: `
+      CREATE TABLE IF NOT EXISTS build_meta (
+        key TEXT PRIMARY KEY,
+        value TEXT NOT NULL
+      );
+    `,
+    },
+    {
+        version: 8,
+        up: `
+      CREATE TABLE IF NOT EXISTS function_complexity (
+        node_id INTEGER PRIMARY KEY,
+        cognitive INTEGER NOT NULL,
+        cyclomatic INTEGER NOT NULL,
+        max_nesting INTEGER NOT NULL,
+        FOREIGN KEY(node_id) REFERENCES nodes(id)
+      );
+      CREATE INDEX IF NOT EXISTS idx_fc_cognitive ON function_complexity(cognitive DESC);
+      CREATE INDEX IF NOT EXISTS idx_fc_cyclomatic ON function_complexity(cyclomatic DESC);
+    `,
+    },
+    {
+        version: 9,
+        up: `
+      ALTER TABLE function_complexity ADD COLUMN loc INTEGER DEFAULT 0;
+      ALTER TABLE function_complexity ADD COLUMN sloc INTEGER DEFAULT 0;
+      ALTER TABLE function_complexity ADD COLUMN comment_lines INTEGER DEFAULT 0;
+      ALTER TABLE function_complexity ADD COLUMN halstead_n1 INTEGER DEFAULT 0;
+      ALTER TABLE function_complexity ADD COLUMN halstead_n2 INTEGER DEFAULT 0;
+      ALTER TABLE function_complexity ADD COLUMN halstead_big_n1 INTEGER DEFAULT 0;
+      ALTER TABLE function_complexity ADD COLUMN halstead_big_n2 INTEGER DEFAULT 0;
+      ALTER TABLE function_complexity ADD COLUMN halstead_vocabulary INTEGER DEFAULT 0;
+      ALTER TABLE function_complexity ADD COLUMN halstead_length INTEGER DEFAULT 0;
+      ALTER TABLE function_complexity ADD COLUMN halstead_volume REAL DEFAULT 0;
+      ALTER TABLE function_complexity ADD COLUMN halstead_difficulty REAL DEFAULT 0;
+      ALTER TABLE function_complexity ADD COLUMN halstead_effort REAL DEFAULT 0;
+      ALTER TABLE function_complexity ADD COLUMN halstead_bugs REAL DEFAULT 0;
+      ALTER TABLE function_complexity ADD COLUMN maintainability_index REAL DEFAULT 0;
+      CREATE INDEX IF NOT EXISTS idx_fc_mi ON function_complexity(maintainability_index ASC);
+    `,
+    },
+    {
+        version: 10,
+        up: `
+      CREATE TABLE IF NOT EXISTS dataflow (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        source_id INTEGER NOT NULL,
+        target_id INTEGER NOT NULL,
+        kind TEXT NOT NULL,
+        param_index INTEGER,
+        expression TEXT,
+        line INTEGER,
+        confidence REAL DEFAULT 1.0,
+        FOREIGN KEY(source_id) REFERENCES nodes(id),
+        FOREIGN KEY(target_id) REFERENCES nodes(id)
+      );
+      CREATE INDEX IF NOT EXISTS idx_dataflow_source ON dataflow(source_id);
+      CREATE INDEX IF NOT EXISTS idx_dataflow_target ON dataflow(target_id);
+      CREATE INDEX IF NOT EXISTS idx_dataflow_kind ON dataflow(kind);
+      CREATE INDEX IF NOT EXISTS idx_dataflow_source_kind ON dataflow(source_id, kind);
+    `,
+    },
+    {
+        version: 11,
+        up: `
+      ALTER TABLE nodes ADD COLUMN parent_id INTEGER REFERENCES nodes(id);
+      CREATE INDEX IF NOT EXISTS idx_nodes_parent ON nodes(parent_id);
+      CREATE INDEX IF NOT EXISTS idx_nodes_kind_parent ON nodes(kind, parent_id);
+    `,
+    },
+    {
+        version: 12,
+        up: `
+      CREATE TABLE IF NOT EXISTS cfg_blocks (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        function_node_id INTEGER NOT NULL,
+        block_index INTEGER NOT NULL,
+        block_type TEXT NOT NULL,
+        start_line INTEGER,
+        end_line INTEGER,
+        label TEXT,
+        FOREIGN KEY(function_node_id) REFERENCES nodes(id),
+        UNIQUE(function_node_id, block_index)
+      );
+      CREATE INDEX IF NOT EXISTS idx_cfg_blocks_fn ON cfg_blocks(function_node_id);
+
+      CREATE TABLE IF NOT EXISTS cfg_edges (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        function_node_id INTEGER NOT NULL,
+        source_block_id INTEGER NOT NULL,
+        target_block_id INTEGER NOT NULL,
+        kind TEXT NOT NULL,
+        FOREIGN KEY(function_node_id) REFERENCES nodes(id),
+        FOREIGN KEY(source_block_id) REFERENCES cfg_blocks(id),
+        FOREIGN KEY(target_block_id) REFERENCES cfg_blocks(id)
+      );
+      CREATE INDEX IF NOT EXISTS idx_cfg_edges_fn ON cfg_edges(function_node_id);
+      CREATE INDEX IF NOT EXISTS idx_cfg_edges_src ON cfg_edges(source_block_id);
+      CREATE INDEX IF NOT EXISTS idx_cfg_edges_tgt ON cfg_edges(target_block_id);
+    `,
+    },
+    {
+        version: 13,
+        up: `
+      CREATE TABLE IF NOT EXISTS ast_nodes (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        file TEXT NOT NULL,
+        line INTEGER NOT NULL,
+        kind TEXT NOT NULL,
+        name TEXT NOT NULL,
+        text TEXT,
+        receiver TEXT,
+        parent_node_id INTEGER,
+        FOREIGN KEY(parent_node_id) REFERENCES nodes(id)
+      );
+      CREATE INDEX IF NOT EXISTS idx_ast_kind ON ast_nodes(kind);
+      CREATE INDEX IF NOT EXISTS idx_ast_name ON ast_nodes(name);
+      CREATE INDEX IF NOT EXISTS idx_ast_file ON ast_nodes(file);
+      CREATE INDEX IF NOT EXISTS idx_ast_parent ON ast_nodes(parent_node_id);
+      CREATE INDEX IF NOT EXISTS idx_ast_kind_name ON ast_nodes(kind, name);
+    `,
+    },
+    {
+        version: 14,
+        up: `
+      ALTER TABLE nodes ADD COLUMN exported INTEGER DEFAULT 0;
+      CREATE INDEX IF NOT EXISTS idx_nodes_exported ON nodes(exported);
+    `,
+    },
+    {
+        version: 15,
+        up: `
+      ALTER TABLE nodes ADD COLUMN qualified_name TEXT;
+      ALTER TABLE nodes ADD COLUMN scope TEXT;
+      ALTER TABLE nodes ADD COLUMN visibility TEXT;
+      UPDATE nodes SET qualified_name = name WHERE qualified_name IS NULL;
+      CREATE INDEX IF NOT EXISTS idx_nodes_qualified_name ON nodes(qualified_name);
+      CREATE INDEX IF NOT EXISTS idx_nodes_scope ON nodes(scope);
+    `,
+    },
+];
+function hasColumn(db, table, column) {
+    const cols = db.pragma(`table_info(${table})`);
+    return cols.some((c) => c.name === column);
+}
+function hasTable(db, table) {
+    const row = db.prepare("SELECT 1 FROM sqlite_master WHERE type='table' AND name=?").get(table);
+    return !!row;
+}
+export function getBuildMeta(db, key) {
+    if (!hasTable(db, 'build_meta'))
+        return null;
+    try {
+        const row = db.prepare('SELECT value FROM build_meta WHERE key = ?').get(key);
+        return row ? row.value : null;
+    }
+    catch (e) {
+        debug(`getBuildMeta failed for key "${key}": ${e.message}`);
+        return null;
+    }
+}
+export function setBuildMeta(db, entries) {
+    const upsert = db.prepare('INSERT OR REPLACE INTO build_meta (key, value) VALUES (?, ?)');
+    const tx = db.transaction(() => {
+        for (const [key, value] of Object.entries(entries)) {
+            upsert.run(key, String(value));
+        }
+    });
+    tx();
+}
+export function initSchema(db) {
+    db.exec(`CREATE TABLE IF NOT EXISTS schema_version (version INTEGER NOT NULL DEFAULT 0)`);
+    const row = db.prepare('SELECT version FROM schema_version').get();
+    let currentVersion = row ? row.version : 0;
+    if (!row) {
+        db.prepare('INSERT INTO schema_version (version) VALUES (0)').run();
+    }
+    for (const migration of MIGRATIONS) {
+        if (migration.version > currentVersion) {
+            debug(`Running migration v${migration.version}`);
+            db.exec(migration.up);
+            db.prepare('UPDATE schema_version SET version = ?').run(migration.version);
+            currentVersion = migration.version;
+        }
+    }
+    // Legacy column compat — add columns that may be missing from pre-migration DBs
+    if (hasTable(db, 'nodes')) {
+        if (!hasColumn(db, 'nodes', 'end_line')) {
+            db.exec('ALTER TABLE nodes ADD COLUMN end_line INTEGER');
+        }
+        if (!hasColumn(db, 'nodes', 'role')) {
+            db.exec('ALTER TABLE nodes ADD COLUMN role TEXT');
+        }
+        db.exec('CREATE INDEX IF NOT EXISTS idx_nodes_role ON nodes(role)');
+        if (!hasColumn(db, 'nodes', 'parent_id')) {
+            db.exec('ALTER TABLE nodes ADD COLUMN parent_id INTEGER REFERENCES nodes(id)');
+        }
+        db.exec('CREATE INDEX IF NOT EXISTS idx_nodes_parent ON nodes(parent_id)');
+        db.exec('CREATE INDEX IF NOT EXISTS idx_nodes_kind_parent ON nodes(kind, parent_id)');
+        if (!hasColumn(db, 'nodes', 'qualified_name')) {
+            db.exec('ALTER TABLE nodes ADD COLUMN qualified_name TEXT');
+        }
+        if (!hasColumn(db, 'nodes', 'scope')) {
+            db.exec('ALTER TABLE nodes ADD COLUMN scope TEXT');
+        }
+        if (!hasColumn(db, 'nodes', 'visibility')) {
+            db.exec('ALTER TABLE nodes ADD COLUMN visibility TEXT');
+        }
+        db.exec('UPDATE nodes SET qualified_name = name WHERE qualified_name IS NULL');
+        db.exec('CREATE INDEX IF NOT EXISTS idx_nodes_qualified_name ON nodes(qualified_name)');
+        db.exec('CREATE INDEX IF NOT EXISTS idx_nodes_scope ON nodes(scope)');
+    }
+    if (hasTable(db, 'edges')) {
+        if (!hasColumn(db, 'edges', 'confidence')) {
+            db.exec('ALTER TABLE edges ADD COLUMN confidence REAL DEFAULT 1.0');
+        }
+        if (!hasColumn(db, 'edges', 'dynamic')) {
+            db.exec('ALTER TABLE edges ADD COLUMN dynamic INTEGER DEFAULT 0');
+        }
+    }
+}
+//# sourceMappingURL=migrations.js.map

package/dist/db/migrations.js.map

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

package/dist/db/query-builder.d.ts

@@ -0,0 +1,106 @@
+/** Escape LIKE wildcards in a literal string segment. */
+export function escapeLike(s: any): any;
+/**
+ * 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: string | string[] | undefined | null): string[];
+/**
+ * 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: string | string[], column?: string): {
+    sql: string;
+    params: string[];
+};
+/**
+ * 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: string, acc: string[]): string[];
+/**
+ * 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?: string, enabled?: boolean): string;
+/**
+ * Build IN (?, ?, ?) placeholders and params array for a kind filter.
+ * @param {string[]} kinds
+ * @returns {{ placeholders: string, params: string[] }}
+ */
+export function kindInClause(kinds: string[]): {
+    placeholders: string;
+    params: string[];
+};
+/**
+ * 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?: string, alias?: string): string;
+/**
+ * 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?: string, alias?: string): string;
+/**
+ * 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 {
+    /** Set SELECT columns (default: `n.*`). */
+    select(cols: any): this;
+    /** WHERE n.kind IN (?, ?, ...) */
+    kinds(kindArray: any): this;
+    /** Add 5 NOT LIKE conditions to exclude test files. No-op when enabled is falsy. */
+    excludeTests(enabled: any): this;
+    /** WHERE n.file LIKE ? (no-op if falsy). Accepts a single string or string[]. */
+    fileFilter(file: any): this;
+    /** WHERE n.kind = ? (no-op if falsy). */
+    kindFilter(kind: any): this;
+    /** WHERE n.role = ? (no-op if falsy). 'dead' matches all dead-* sub-roles. */
+    roleFilter(role: any): this;
+    /** WHERE n.name LIKE ? (no-op if falsy). Escapes LIKE wildcards in the value. */
+    nameLike(pattern: any): this;
+    /** Raw WHERE condition escape hatch. */
+    where(sql: any, ...params: any[]): this;
+    /** Add fan-in LEFT JOIN subquery. */
+    withFanIn(edgeKind?: string): this;
+    /** Add fan-out LEFT JOIN subquery. */
+    withFanOut(edgeKind?: string): this;
+    /** LEFT JOIN function_complexity. */
+    withComplexity(): this;
+    /** LEFT JOIN file_commit_counts. */
+    withChurn(): this;
+    /** @private Raw JOIN — internal use only; external callers should use withFanIn/withFanOut/withComplexity/withChurn. */
+    private _join;
+    /** ORDER BY clause. */
+    orderBy(clause: any): this;
+    /** LIMIT ?. */
+    limit(n: any): this;
+    /** Build the SQL and params without executing. */
+    build(): {
+        sql: string;
+        params: any[];
+    };
+    /** Execute and return all rows. */
+    all(db: any): any;
+    /** Execute and return first row. */
+    get(db: any): any;
+    /** Execute and return an iterator. */
+    iterate(db: any): any;
+    #private;
+}
+//# sourceMappingURL=query-builder.d.ts.map

package/dist/db/query-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-builder.d.ts","sourceRoot":"","sources":["../../src/db/query-builder.js"],"names":[],"mappings":"AAqEA,yDAAyD;AACzD,wCAEC;AAED;;;;;GAKG;AACH,0CAHW,MAAM,GAAC,MAAM,EAAE,GAAC,SAAS,GAAC,IAAI,GAC5B,MAAM,EAAE,CAKpB;AAED;;;;;;;GAOG;AACH,4CAJW,MAAM,GAAC,MAAM,EAAE,WACf,MAAM,GACJ;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAiB7C;AAED;;;;;;GAMG;AACH,iCAJW,MAAM,OACN,MAAM,EAAE,GACN,MAAM,EAAE,CAMpB;AAID;;;;;GAKG;AACH,uCAHW,MAAM,YACN,OAAO,UAUjB;AAED;;;;GAIG;AACH,oCAHW,MAAM,EAAE,GACN;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAOtD;AAED;;;;GAIG;AACH,wCAHW,MAAM,UACN,MAAM,UAQhB;AAED;;;;GAIG;AACH,yCAHW,MAAM,UACN,MAAM,UAQhB;AAID;;;GAGG;AACH;IAQE,2CAA2C;IAC3C,wBAIC;IAED,kCAAkC;IAClC,4BAMC;IAED,oFAAoF;IACpF,iCAUC;IAED,iFAAiF;IACjF,4BAYC;IAED,yCAAyC;IACzC,4BAKC;IAED,8EAA8E;IAC9E,4BAUC;IAED,iFAAiF;IACjF,6BAKC;IAED,wCAAwC;IACxC,wCAIC;IAED,qCAAqC;IACrC,mCAEC;IAED,sCAAsC;IACtC,oCAEC;IAED,qCAAqC;IACrC,uBAEC;IAED,oCAAoC;IACpC,kBAEC;IAED,wHAAwH;IACxH,cAGC;IAED,uBAAuB;IACvB,2BAIC;IAED,eAAe;IACf,oBAIC;IAED,kDAAkD;IAClD;;;MAeC;IAED,mCAAmC;IACnC,kBAGC;IAED,oCAAoC;IACpC,kBAGC;IAED,sCAAsC;IACtC,sBAGC;;CACF"}