dbgraph 0.1.0

package/dist/introspect/postgres.js

@@ -0,0 +1,372 @@
+"use strict";
+/**
+ * PostgreSQL Introspector
+ *
+ * Extracts schemas, tables, columns, primary keys, foreign keys,
+ * indexes, and views from a PostgreSQL database using
+ * `information_schema` + `pg_catalog` queries.
+ *
+ * Connection: uses `connection.ts` which wraps the `pg` package.
+ * The driver import is guarded so a missing `pg` is reported at
+ * connect() time, not at module load time.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PostgresIntrospector = void 0;
+const base_1 = require("./base");
+const connection_1 = require("./connection");
+// =============================================================================
+// PostgresIntrospector
+// =============================================================================
+class PostgresIntrospector extends base_1.BaseIntrospector {
+    constructor(config) {
+        super(config);
+    }
+    /**
+     * Full schema introspection pipeline.
+     *
+     * 1. Connect to DB
+     * 2. Query schemas, tables, columns, PKs, FKs, indexes, views in batch
+     * 3. Build Node[] and Edge[] from the raw data
+     * 4. Close connection and return IntrospectResult
+     */
+    async extractAll() {
+        const startTime = Date.now();
+        const errors = [];
+        const nodes = [];
+        const edges = [];
+        let conn;
+        try {
+            conn = await (0, connection_1.createConnection)(this.config);
+        }
+        catch (err) {
+            return {
+                nodes: [],
+                edges: [],
+                durationMs: Date.now() - startTime,
+                errors: [err.message],
+            };
+        }
+        try {
+            // ----- 1. Determine which schemas to introspect -----
+            const hasFilter = this.config.schemas !== undefined && this.config.schemas.length > 0;
+            const schemaFilter = new Set(this.config.schemas ?? []);
+            const schemas = await this.querySchemas(conn);
+            // Apply user-configured schema filter
+            const targetSchemas = hasFilter
+                ? schemas.filter((r) => schemaFilter.has(r.schema_name))
+                : schemas;
+            if (targetSchemas.length === 0) {
+                errors.push(hasFilter
+                    ? `No matching schemas found. Filter: ${this.config.schemas.join(', ')}`
+                    : 'No non-system schemas found');
+                return { nodes, edges, durationMs: Date.now() - startTime, errors };
+            }
+            const schemaNames = targetSchemas.map((r) => r.schema_name);
+            // ----- 2. Fetch all raw metadata in parallel -----
+            const [tables, columns, pks, fks, indexes, views] = await Promise.all([
+                this.queryTables(conn, schemaNames),
+                this.queryColumns(conn, schemaNames),
+                this.queryPrimaryKeys(conn, schemaNames),
+                this.queryForeignKeys(conn, schemaNames),
+                this.queryIndexes(conn, schemaNames),
+                this.queryViews(conn, schemaNames),
+            ]);
+            // ----- 3. Build schema nodes -----
+            const schemaNodeById = new Map(); // key = schema name
+            for (const s of targetSchemas) {
+                const qual = this.qn(s.schema_name);
+                const fp = this.schemaFilePath(s.schema_name);
+                const node = this.makeNode('schema', s.schema_name, qual, fp);
+                nodes.push(node);
+                schemaNodeById.set(s.schema_name, node);
+            }
+            // ----- 4. Build table nodes + contains edges (schema → table) -----
+            const tableNodeByKey = new Map(); // key = schema.table
+            for (const t of tables) {
+                const schemaNode = schemaNodeById.get(t.schema_name);
+                if (!schemaNode)
+                    continue;
+                const key = this.tableKey(t.schema_name, t.table_name);
+                const kind = t.table_type === 'VIEW' ? 'view' : 'table';
+                const qual = this.qn(t.schema_name, t.table_name);
+                const fp = this.schemaFilePath(t.schema_name);
+                const node = this.makeNode(kind, t.table_name, qual, fp, {
+                    docstring: t.comment ?? undefined,
+                });
+                nodes.push(node);
+                tableNodeByKey.set(key, node);
+                edges.push(this.containEdge(schemaNode.id, node.id));
+            }
+            // ----- 5. Build column nodes + contains edges (table → column) -----
+            const columnNodeByKey = new Map(); // key = schema.table.column
+            for (const c of columns) {
+                const tableKey = this.tableKey(c.schema_name, c.table_name);
+                const tableNode = tableNodeByKey.get(tableKey);
+                if (!tableNode)
+                    continue;
+                const colKey = this.columnKey(c.schema_name, c.table_name, c.column_name);
+                const qual = this.qn(c.schema_name, c.table_name, c.column_name);
+                const fp = this.schemaFilePath(c.schema_name);
+                const node = this.makeNode('column', c.column_name, qual, fp, {
+                    startLine: c.ordinal_position ?? 0,
+                    metadata: {
+                        dataType: c.data_type,
+                        isNullable: c.is_nullable === 'YES',
+                        defaultValue: c.column_default ?? null,
+                        maxLength: c.character_maximum_length ?? null,
+                        numericPrecision: c.numeric_precision ?? null,
+                        numericScale: c.numeric_scale ?? null,
+                        udtName: c.udt_name ?? null,
+                        collation: c.collation_name ?? null,
+                    },
+                    docstring: c.description ?? undefined,
+                });
+                nodes.push(node);
+                columnNodeByKey.set(colKey, node);
+                edges.push(this.containEdge(tableNode.id, node.id));
+            }
+            // ----- 6. Primary key edges (table → column) -----
+            for (const pk of pks) {
+                const colKey = this.columnKey(pk.schema_name, pk.table_name, pk.column_name);
+                const colNode = columnNodeByKey.get(colKey);
+                const tableKey = this.tableKey(pk.schema_name, pk.table_name);
+                const tableNode = tableNodeByKey.get(tableKey);
+                if (colNode && tableNode) {
+                    edges.push(this.makeEdge(tableNode.id, colNode.id, 'primary_key', {
+                        constraintName: pk.constraint_name,
+                    }));
+                }
+            }
+            // ----- 7. Foreign key references edges (column → referenced column) -----
+            for (const fk of fks) {
+                const fromKey = this.columnKey(fk.schema_name, fk.table_name, fk.column_name);
+                const toKey = this.columnKey(fk.ref_table_schema, fk.ref_table_name, fk.ref_column_name);
+                const fromNode = columnNodeByKey.get(fromKey);
+                const toNode = columnNodeByKey.get(toKey);
+                if (fromNode && toNode) {
+                    edges.push(this.makeEdge(fromNode.id, toNode.id, 'references', {
+                        constraintName: fk.constraint_name,
+                        onUpdate: fk.update_rule,
+                        onDelete: fk.delete_rule,
+                    }));
+                }
+            }
+            // ----- 8. Index nodes + indexed_by edges (table → index, column → index) -----
+            // Group index rows by index name to get column lists
+            const indexGroups = new Map();
+            for (const idx of indexes) {
+                const indexKey = `${idx.schema_name}.${idx.table_name}.${idx.indexname}`;
+                if (!indexGroups.has(indexKey)) {
+                    indexGroups.set(indexKey, {
+                        schema: idx.schema_name,
+                        table: idx.table_name,
+                        indexdef: idx.indexdef,
+                        columns: [],
+                    });
+                }
+            }
+            // Parse column list from indexdef (simplified — extracts first parenthesized group)
+            for (const [key, grp] of indexGroups) {
+                const match = grp.indexdef.match(/\(([^)]+)\)/);
+                if (match && match[1]) {
+                    grp.columns = match[1].split(',').map((s) => s.trim().replace(/^"|"$/g, ''));
+                }
+            }
+            for (const [_key, grp] of indexGroups) {
+                const tableKey = this.tableKey(grp.schema, grp.table);
+                const tableNode = tableNodeByKey.get(tableKey);
+                if (!tableNode)
+                    continue;
+                // Extract a short index name from the DEFINE for the node name
+                const idxName = _key.split('.').pop();
+                const qual = this.qn(grp.schema, grp.table, idxName);
+                const fp = this.schemaFilePath(grp.schema);
+                const unique = grp.indexdef.toUpperCase().includes('UNIQUE');
+                const node = this.makeNode('index', idxName, qual, fp, {
+                    signature: grp.indexdef,
+                    metadata: { unique, columns: grp.columns },
+                });
+                nodes.push(node);
+                edges.push(this.containEdge(tableNode.id, node.id));
+                edges.push(this.makeEdge(tableNode.id, node.id, 'indexed_by'));
+            }
+            // ----- 9. View nodes — attach their definitions as signatures -----
+            // viewDefMap keys match the tableKey(schema, viewName) we used
+            // during table/view node creation in step 4.
+            const viewDefMap = new Map();
+            for (const v of views) {
+                const key = this.tableKey(v.schema_name, v.table_name);
+                if (v.view_definition)
+                    viewDefMap.set(key, v.view_definition);
+            }
+            for (const node of nodes) {
+                if (node.kind !== 'view')
+                    continue;
+                // qualifiedName = alias.schema.viewname → extract last two parts
+                const parts = node.qualifiedName.split('.');
+                if (parts.length < 3)
+                    continue;
+                const schema = parts[parts.length - 2];
+                const viewName = parts[parts.length - 1];
+                const def = viewDefMap.get(this.tableKey(schema, viewName));
+                if (def)
+                    node.signature = def;
+            }
+        }
+        catch (err) {
+            errors.push(`Introspection error: ${err.message}`);
+        }
+        finally {
+            await conn.close();
+        }
+        return {
+            nodes,
+            edges,
+            durationMs: Date.now() - startTime,
+            errors,
+        };
+    }
+    // ===========================================================================
+    // Query Methods
+    //
+    // Each method includes the schema_name in its result set so callers can
+    // group by schema at build time.
+    // ===========================================================================
+    /**
+     * Query: non-system schemas.
+     */
+    async querySchemas(conn) {
+        return (await conn.query(`-- Schemas
+       SELECT schema_name
+       FROM information_schema.schemata
+       WHERE schema_name NOT IN ('pg_catalog', 'information_schema', 'pg_toast')
+         AND schema_name NOT LIKE 'pg_%'
+       ORDER BY schema_name`));
+    }
+    /**
+     * Query: tables and views (BASE TABLE or VIEW) with optional pg_catalog
+     * comment.
+     */
+    async queryTables(conn, schemaNames) {
+        if (schemaNames.length === 0)
+            return [];
+        return (await conn.query(`SELECT t.table_schema AS schema_name,
+              t.table_name,
+              t.table_type,
+              pg_catalog.obj_description(
+                (quote_ident(t.table_schema) || '.' || quote_ident(t.table_name))::regclass,
+                'pg_class'
+              ) AS comment
+       FROM information_schema.tables t
+       WHERE t.table_schema = ANY($1)
+         AND t.table_type IN ('BASE TABLE', 'VIEW')
+       ORDER BY t.table_name`, [schemaNames]));
+    }
+    /**
+     * Query: column metadata + pg_catalog column description.
+     */
+    async queryColumns(conn, schemaNames) {
+        if (schemaNames.length === 0)
+            return [];
+        return (await conn.query(`SELECT c.table_schema AS schema_name,
+              c.table_name,
+              c.column_name,
+              c.data_type,
+              c.is_nullable,
+              c.column_default,
+              c.character_maximum_length,
+              c.numeric_precision,
+              c.numeric_scale,
+              c.datetime_precision,
+              c.ordinal_position,
+              c.udt_name,
+              c.collation_name,
+              pg_catalog.col_description(
+                (quote_ident(c.table_schema) || '.' || quote_ident(c.table_name))::regclass,
+                c.ordinal_position::integer
+              ) AS description
+       FROM information_schema.columns c
+       WHERE c.table_schema = ANY($1)
+       ORDER BY c.table_name, c.ordinal_position`, [schemaNames]));
+    }
+    /**
+     * Query: columns that are part of a PRIMARY KEY constraint.
+     */
+    async queryPrimaryKeys(conn, schemaNames) {
+        if (schemaNames.length === 0)
+            return [];
+        return (await conn.query(`SELECT tc.table_schema AS schema_name,
+              tc.table_name,
+              tc.constraint_name,
+              kcu.column_name
+       FROM information_schema.table_constraints tc
+       JOIN information_schema.key_column_usage kcu
+         ON tc.constraint_catalog = kcu.constraint_catalog
+        AND tc.constraint_schema  = kcu.constraint_schema
+        AND tc.constraint_name    = kcu.constraint_name
+       WHERE tc.table_schema = ANY($1)
+         AND tc.constraint_type = 'PRIMARY KEY'
+       ORDER BY tc.table_name, kcu.ordinal_position`, [schemaNames]));
+    }
+    /**
+     * Query: foreign key columns + referenced table/column + referential actions.
+     */
+    async queryForeignKeys(conn, schemaNames) {
+        if (schemaNames.length === 0)
+            return [];
+        return (await conn.query(`SELECT tc.table_schema AS schema_name,
+              tc.table_name,
+              tc.constraint_name,
+              kcu.column_name,
+              ccu.table_schema  AS ref_table_schema,
+              ccu.table_name    AS ref_table_name,
+              ccu.column_name   AS ref_column_name,
+              rc.update_rule,
+              rc.delete_rule
+       FROM information_schema.table_constraints tc
+       JOIN information_schema.key_column_usage kcu
+         ON tc.constraint_catalog = kcu.constraint_catalog
+        AND tc.constraint_schema  = kcu.constraint_schema
+        AND tc.constraint_name    = kcu.constraint_name
+       JOIN information_schema.constraint_column_usage ccu
+         ON ccu.constraint_catalog = tc.constraint_catalog
+        AND ccu.constraint_schema  = tc.constraint_schema
+        AND ccu.constraint_name    = tc.constraint_name
+       JOIN information_schema.referential_constraints rc
+         ON rc.constraint_catalog = tc.constraint_catalog
+        AND rc.constraint_schema  = tc.constraint_schema
+        AND rc.constraint_name    = tc.constraint_name
+       WHERE tc.table_schema = ANY($1)
+         AND tc.constraint_type = 'FOREIGN KEY'
+       ORDER BY tc.table_name, tc.constraint_name, kcu.ordinal_position`, [schemaNames]));
+    }
+    /**
+     * Query: index definitions from pg_indexes.
+     */
+    async queryIndexes(conn, schemaNames) {
+        if (schemaNames.length === 0)
+            return [];
+        return (await conn.query(`SELECT pi.schemaname AS schema_name,
+              pi.tablename AS table_name,
+              pi.indexname,
+              pi.indexdef
+       FROM pg_indexes pi
+       WHERE pi.schemaname = ANY($1)
+       ORDER BY pi.tablename, pi.indexname`, [schemaNames]));
+    }
+    /**
+     * Query: view definitions.
+     */
+    async queryViews(conn, schemaNames) {
+        if (schemaNames.length === 0)
+            return [];
+        return (await conn.query(`SELECT v.table_schema AS schema_name,
+              v.table_name,
+              v.view_definition
+       FROM information_schema.views v
+       WHERE v.table_schema = ANY($1)
+       ORDER BY v.table_name`, [schemaNames]));
+    }
+}
+exports.PostgresIntrospector = PostgresIntrospector;
+//# sourceMappingURL=postgres.js.map

package/dist/introspect/postgres.js.map

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

package/dist/introspect/sqlite.d.ts

@@ -0,0 +1,33 @@
+/**
+ * SQLite Introspector
+ *
+ * Extracts tables, columns, primary keys, foreign keys, indexes,
+ * and views from a SQLite database using `sqlite_master` and
+ * `PRAGMA` queries (accessed via table-valued functions).
+ *
+ * Connection: uses `connection.ts` which wraps the built-in
+ * `node:sqlite` module (Node >= 22.5). No external driver needed.
+ *
+ * Schema model:
+ *  - SQLite has a flat namespace — the "schema" concept is modeled
+ *    as a single node named "main".
+ *  - Virtual tables (FTS, etc.) are included; they appear in
+ *    sqlite_master alongside regular tables.
+ */
+import { IntrospectResult, DbConnectionConfig } from '../types';
+import { BaseIntrospector } from './base';
+export declare class SQLiteIntrospector extends BaseIntrospector {
+    constructor(config: DbConnectionConfig);
+    /**
+     * Full schema introspection pipeline for a SQLite database.
+     *
+     * 1. Open the SQLite file
+     * 2. Query `sqlite_master` for tables/views
+     * 3. For each table: columns (PRAGMA table_info), FKs, indexes
+     * 4. For each index: index columns (PRAGMA index_info)
+     * 5. Build Node[] + Edge[]
+     * 6. Close and return result
+     */
+    extractAll(): Promise<IntrospectResult>;
+}
+//# sourceMappingURL=sqlite.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite.d.ts","sourceRoot":"","sources":["../../src/introspect/sqlite.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAKnB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,gBAAgB,EAAE,MAAM,QAAQ,CAAC;AA2D1C,qBAAa,kBAAmB,SAAQ,gBAAgB;gBAC1C,MAAM,EAAE,kBAAkB;IAItC;;;;;;;;;OASG;IACG,UAAU,IAAI,OAAO,CAAC,gBAAgB,CAAC;CAyM9C"}

package/dist/introspect/sqlite.js

@@ -0,0 +1,207 @@
+"use strict";
+/**
+ * SQLite Introspector
+ *
+ * Extracts tables, columns, primary keys, foreign keys, indexes,
+ * and views from a SQLite database using `sqlite_master` and
+ * `PRAGMA` queries (accessed via table-valued functions).
+ *
+ * Connection: uses `connection.ts` which wraps the built-in
+ * `node:sqlite` module (Node >= 22.5). No external driver needed.
+ *
+ * Schema model:
+ *  - SQLite has a flat namespace — the "schema" concept is modeled
+ *    as a single node named "main".
+ *  - Virtual tables (FTS, etc.) are included; they appear in
+ *    sqlite_master alongside regular tables.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SQLiteIntrospector = void 0;
+const base_1 = require("./base");
+const connection_1 = require("./connection");
+// =============================================================================
+// Constants
+// =============================================================================
+/** The implicit schema name for the main SQLite database */
+const MAIN_SCHEMA = 'main';
+// =============================================================================
+// SQLiteIntrospector
+// =============================================================================
+class SQLiteIntrospector extends base_1.BaseIntrospector {
+    constructor(config) {
+        super(config);
+    }
+    /**
+     * Full schema introspection pipeline for a SQLite database.
+     *
+     * 1. Open the SQLite file
+     * 2. Query `sqlite_master` for tables/views
+     * 3. For each table: columns (PRAGMA table_info), FKs, indexes
+     * 4. For each index: index columns (PRAGMA index_info)
+     * 5. Build Node[] + Edge[]
+     * 6. Close and return result
+     */
+    async extractAll() {
+        const startTime = Date.now();
+        const errors = [];
+        const nodes = [];
+        const edges = [];
+        let conn;
+        try {
+            conn = await (0, connection_1.createConnection)(this.config);
+        }
+        catch (err) {
+            return {
+                nodes: [],
+                edges: [],
+                durationMs: Date.now() - startTime,
+                errors: [err.message],
+            };
+        }
+        try {
+            // ----- 1. Fetch all objects from sqlite_master -----
+            const masterRows = (await conn.query(`SELECT type, name, tbl_name, sql
+         FROM sqlite_master
+         WHERE type IN ('table', 'view')
+           AND name NOT LIKE 'sqlite_%'
+         ORDER BY type, name`));
+            if (masterRows.length === 0) {
+                errors.push('No user tables or views found in the database');
+                return { nodes, edges, durationMs: Date.now() - startTime, errors };
+            }
+            // Separate tables and views
+            const tables = masterRows.filter((r) => r.type === 'table');
+            const views = masterRows.filter((r) => r.type === 'view');
+            // ----- 2. Build a single "schema" node for this database -----
+            const schemaQual = this.qn(MAIN_SCHEMA);
+            const schemaFp = this.schemaFilePath(MAIN_SCHEMA);
+            const schemaNode = this.makeNode('schema', MAIN_SCHEMA, schemaQual, schemaFp);
+            nodes.push(schemaNode);
+            // ----- 3. Build table nodes + contains edges (schema → table) -----
+            const tableNodeByKey = new Map(); // key = table_name
+            for (const t of tables) {
+                const qual = this.qn(MAIN_SCHEMA, t.name);
+                const fp = this.schemaFilePath(MAIN_SCHEMA);
+                const node = this.makeNode('table', t.name, qual, fp, {
+                    signature: t.sql ?? undefined,
+                });
+                nodes.push(node);
+                tableNodeByKey.set(t.name, node);
+                edges.push(this.containEdge(schemaNode.id, node.id));
+            }
+            // ----- 4. For each table: columns, PKs, FKs, indexes -----
+            const columnNodeByKey = new Map(); // key = table.column
+            const pkEdges = [];
+            const fkEdges = [];
+            const indexNodes = [];
+            for (const t of tables) {
+                const tableNode = tableNodeByKey.get(t.name);
+                if (!tableNode)
+                    continue;
+                // ----- 4a. Columns via pragma_table_info -----
+                const colRows = (await conn.query(`SELECT cid, name, type, notnull, dflt_value, pk
+           FROM pragma_table_info(?)`, [t.name]));
+                for (const col of colRows) {
+                    const colKey = `${t.name}.${col.name}`;
+                    const qual = this.qn(MAIN_SCHEMA, t.name, col.name);
+                    const fp = this.schemaFilePath(MAIN_SCHEMA);
+                    const node = this.makeNode('column', col.name, qual, fp, {
+                        startLine: col.cid + 1,
+                        metadata: {
+                            dataType: col.type || 'TEXT',
+                            isNullable: col.notnull === 0,
+                            defaultValue: col.dflt_value ?? null,
+                            isPrimaryKey: col.pk === 1,
+                            // SQLite types don't have precision/scale/length in the
+                            // traditional sense, but we report what's in the DDL type
+                            collation: null,
+                        },
+                    });
+                    nodes.push(node);
+                    columnNodeByKey.set(colKey, node);
+                    edges.push(this.containEdge(tableNode.id, node.id));
+                    // Primary key flag from pragma result
+                    if (col.pk === 1) {
+                        pkEdges.push(this.makeEdge(tableNode.id, node.id, 'primary_key', {
+                            constraintName: `pk_${t.name}`,
+                            pkOrdinal: col.pk,
+                        }));
+                    }
+                }
+                // ----- 4b. Foreign keys via pragma_foreign_key_list -----
+                const fkRows = (await conn.query(`SELECT id, seq, "table", "from", "to", on_update, on_delete, match
+           FROM pragma_foreign_key_list(?)`, [t.name]));
+                for (const fk of fkRows) {
+                    const fromKey = `${t.name}.${fk.from}`;
+                    const toKey = `${fk.table}.${fk.to}`;
+                    const fromNode = columnNodeByKey.get(fromKey);
+                    const toNode = columnNodeByKey.get(toKey);
+                    if (fromNode && toNode) {
+                        fkEdges.push(this.makeEdge(fromNode.id, toNode.id, 'references', {
+                            constraintName: `fk_${t.name}_${fk.from}`,
+                            onUpdate: fk.on_update,
+                            onDelete: fk.on_delete,
+                        }));
+                    }
+                }
+                // ----- 4c. Index list via pragma_index_list -----
+                const idxListRows = (await conn.query(`SELECT seq, name, unique, origin, partial
+           FROM pragma_index_list(?)`, [t.name]));
+                for (const idx of idxListRows) {
+                    // Skip auto-generated indexes for UNIQUE / PK constraints
+                    if (idx.origin === 'pk')
+                        continue;
+                    if (idx.origin === 'u' && idx.name.startsWith('sqlite_autoindex_'))
+                        continue;
+                    // Get index columns
+                    const idxColRows = (await conn.query(`SELECT seqno, cid, name
+             FROM pragma_index_info(?)`, [idx.name]));
+                    const colNames = idxColRows
+                        .sort((a, b) => a.seqno - b.seqno)
+                        .map((r) => r.name);
+                    const qual = this.qn(MAIN_SCHEMA, t.name, idx.name);
+                    const fp = this.schemaFilePath(MAIN_SCHEMA);
+                    const node = this.makeNode('index', idx.name, qual, fp, {
+                        metadata: {
+                            unique: idx.unique === 1,
+                            columns: colNames,
+                            origin: idx.origin,
+                            partial: idx.partial === 1,
+                        },
+                    });
+                    indexNodes.push(node);
+                    edges.push(this.containEdge(tableNode.id, node.id));
+                    edges.push(this.makeEdge(tableNode.id, node.id, 'indexed_by'));
+                }
+            }
+            // Add all deferred edges and index nodes
+            edges.push(...pkEdges);
+            edges.push(...fkEdges);
+            nodes.push(...indexNodes);
+            // ----- 5. Build view nodes + contains edges -----
+            for (const v of views) {
+                const qual = this.qn(MAIN_SCHEMA, v.name);
+                const fp = this.schemaFilePath(MAIN_SCHEMA);
+                const node = this.makeNode('view', v.name, qual, fp, {
+                    signature: v.sql ?? undefined,
+                });
+                nodes.push(node);
+                edges.push(this.containEdge(schemaNode.id, node.id));
+            }
+        }
+        catch (err) {
+            errors.push(`Introspection error: ${err.message}`);
+        }
+        finally {
+            await conn.close();
+        }
+        return {
+            nodes,
+            edges,
+            durationMs: Date.now() - startTime,
+            errors,
+        };
+    }
+}
+exports.SQLiteIntrospector = SQLiteIntrospector;
+//# sourceMappingURL=sqlite.js.map

package/dist/introspect/sqlite.js.map

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