dbgraph 0.1.0

package/dist/introspect/mysql.js

@@ -0,0 +1,360 @@
+"use strict";
+/**
+ * MySQL / MariaDB Introspector
+ *
+ * Extracts schemas (databases), tables, columns, primary keys,
+ * foreign keys, indexes, and views from a MySQL or MariaDB
+ * database using `information_schema` queries.
+ *
+ * Connection: uses `connection.ts` which wraps the `mysql2` package.
+ * The driver import is guarded so a missing `mysql2` is reported at
+ * connect() time, not at module load time.
+ *
+ * MySQL-specific metadata extracted:
+ *  - ENGINE (InnoDB, MyISAM, …)
+ *  - AUTO_INCREMENT value
+ *  - CHARACTER_SET_NAME / COLLATION_NAME
+ *  - COLUMN_TYPE (full type string, e.g. "varchar(255)")
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MySQLIntrospector = void 0;
+const base_1 = require("./base");
+const connection_1 = require("./connection");
+const utils_1 = require("../utils");
+// =============================================================================
+// MySQLIntrospector
+// =============================================================================
+class MySQLIntrospector extends base_1.BaseIntrospector {
+    /** The database/schema name to introspect */
+    dbName;
+    constructor(config) {
+        super(config);
+        this.dbName = config.database;
+    }
+    /**
+     * Full schema introspection pipeline.
+     *
+     * 1. Connect to the MySQL database
+     * 2. Query all structural metadata
+     * 3. Build Node[] + Edge[]
+     * 4. Close connection and return the 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 {
+            // MySQL's "schema" == "database". We always introspect the connected
+            // database. The `schemas` config filter is applied as a TABLE_SCHEMA
+            // filter if the user specified one; otherwise we use `DATABASE()`.
+            // ----- 1. Fetch all raw metadata in parallel -----
+            const [tables, columns, pks, fks, indexes, views] = await Promise.all([
+                this.queryTables(conn),
+                this.queryColumns(conn),
+                this.queryPrimaryKeys(conn),
+                this.queryForeignKeys(conn),
+                this.queryIndexes(conn),
+                this.queryViews(conn),
+            ]);
+            // ----- 2. Build a single "schema" node for this database -----
+            const schemaName = this.dbName;
+            const schemaQual = this.qn(schemaName);
+            const schemaFp = this.schemaFilePath(schemaName);
+            const schemaNode = this.makeNode('schema', schemaName, 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 kind = t.table_type === 'VIEW' ? 'view' : 'table';
+                const qual = this.qn(schemaName, t.table_name);
+                const fp = this.schemaFilePath(schemaName);
+                const node = this.makeNode(kind, t.table_name, qual, fp, {
+                    docstring: t.table_comment || undefined,
+                    metadata: {
+                        engine: t.engine,
+                        autoIncrement: t.auto_increment ?? null,
+                        collation: t.table_collation ?? null,
+                    },
+                });
+                nodes.push(node);
+                tableNodeByKey.set(t.table_name, node);
+                edges.push(this.containEdge(schemaNode.id, node.id));
+            }
+            // ----- 4. Build column nodes + contains edges (table → column) -----
+            const columnNodeByKey = new Map(); // key = table.column
+            for (const c of columns) {
+                const tableNode = tableNodeByKey.get(c.table_name);
+                if (!tableNode)
+                    continue;
+                const colKey = `${c.table_name}.${c.column_name}`;
+                const qual = this.qn(schemaName, c.table_name, c.column_name);
+                const fp = this.schemaFilePath(schemaName);
+                const autoIncrement = c.extra?.toLowerCase().includes('auto_increment');
+                const node = this.makeNode('column', c.column_name, qual, fp, {
+                    startLine: c.ordinal_position ?? 0,
+                    metadata: {
+                        dataType: c.data_type,
+                        columnType: c.column_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,
+                        charSet: c.character_set_name ?? null,
+                        collation: c.collation_name ?? null,
+                        autoIncrement: autoIncrement ?? false,
+                    },
+                    docstring: c.column_comment || undefined,
+                });
+                nodes.push(node);
+                columnNodeByKey.set(colKey, node);
+                edges.push(this.containEdge(tableNode.id, node.id));
+            }
+            // ----- 5. Primary key edges (table → column) -----
+            for (const pk of pks) {
+                const colKey = `${pk.table_name}.${pk.column_name}`;
+                const colNode = columnNodeByKey.get(colKey);
+                const tableNode = tableNodeByKey.get(pk.table_name);
+                if (colNode && tableNode) {
+                    edges.push(this.makeEdge(tableNode.id, colNode.id, 'primary_key', {
+                        constraintName: pk.constraint_name,
+                    }));
+                }
+            }
+            // ----- 6. Foreign key references edges (column → referenced column) -----
+            // Note: for cross-database FKs, the ref_table_schema may differ.
+            // We still create the edge if we have both nodes; cross-DB refs
+            // where the target isn't introspected will have a dangling target
+            // (the edge's target still exists as a node id, but the node may
+            // not be present in this result).
+            for (const fk of fks) {
+                // MySQL KEY_COLUMN_USAGE has REFERENCED_TABLE_SCHEMA
+                const fromKey = `${fk.table_name}.${fk.column_name}`;
+                const toKey = fk.ref_table_schema === this.dbName
+                    ? `${fk.ref_table_name}.${fk.ref_column_name}`
+                    : null;
+                const fromNode = columnNodeByKey.get(fromKey);
+                const toNode = toKey ? columnNodeByKey.get(toKey) : undefined;
+                if (fromNode && toNode) {
+                    edges.push(this.makeEdge(fromNode.id, toNode.id, 'references', {
+                        constraintName: fk.constraint_name,
+                        onUpdate: fk.update_rule,
+                        onDelete: fk.delete_rule,
+                    }));
+                }
+                else if (fromNode) {
+                    // Cross-database FK reference — still emit the edge but note in metadata
+                    edges.push(this.makeEdge(fromNode.id, (0, utils_1.hashString)(`${fk.ref_table_schema}.${fk.ref_table_name}.${fk.ref_column_name}`), 'references', {
+                        constraintName: fk.constraint_name,
+                        onUpdate: fk.update_rule,
+                        onDelete: fk.delete_rule,
+                        refDatabase: fk.ref_table_schema,
+                        refTable: fk.ref_table_name,
+                        refColumn: fk.ref_column_name,
+                        unresolved: true,
+                    }));
+                }
+            }
+            // ----- 7. Index nodes + indexed_by edges -----
+            // Group index rows to collect column lists
+            const indexGroups = new Map();
+            for (const idx of indexes) {
+                const indexKey = `${idx.table_name}.${idx.index_name}`;
+                if (!indexGroups.has(indexKey)) {
+                    indexGroups.set(indexKey, {
+                        table: idx.table_name,
+                        indexName: idx.index_name,
+                        unique: idx.non_unique === 0,
+                        indexType: idx.index_type,
+                        columns: [],
+                    });
+                }
+                indexGroups.get(indexKey).columns.push(idx.column_name);
+            }
+            for (const [, grp] of indexGroups) {
+                const tableNode = tableNodeByKey.get(grp.table);
+                if (!tableNode)
+                    continue;
+                if (grp.indexName === 'PRIMARY')
+                    continue; // PK already handled
+                const qual = this.qn(schemaName, grp.table, grp.indexName);
+                const fp = this.schemaFilePath(schemaName);
+                const node = this.makeNode('index', grp.indexName, qual, fp, {
+                    metadata: {
+                        unique: grp.unique,
+                        indexType: grp.indexType,
+                        columns: grp.columns,
+                    },
+                });
+                nodes.push(node);
+                edges.push(this.containEdge(tableNode.id, node.id));
+                edges.push(this.makeEdge(tableNode.id, node.id, 'indexed_by'));
+            }
+            // ----- 8. Attach view definitions -----
+            const viewDefs = new Map();
+            for (const v of views) {
+                if (v.view_definition)
+                    viewDefs.set(v.table_name, v.view_definition);
+            }
+            for (const node of nodes) {
+                if (node.kind === 'view') {
+                    const def = viewDefs.get(node.name);
+                    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
+    //
+    // MySQL information_schema uses uppercase column names by convention.
+    // All queries filter by TABLE_SCHEMA = the connected database name.
+    // ===========================================================================
+    /**
+     * Query: tables and views in the current database.
+     */
+    async queryTables(conn) {
+        return (await conn.query(`-- Tables & views with MySQL-specific metadata
+       SELECT t.TABLE_NAME                                            AS table_name,
+              t.TABLE_TYPE                                             AS table_type,
+              t.TABLE_COMMENT                                          AS table_comment,
+              t.ENGINE                                                 AS engine,
+              t.AUTO_INCREMENT                                         AS auto_increment,
+              t.TABLE_COLLATION                                        AS table_collation
+       FROM information_schema.TABLES t
+       WHERE t.TABLE_SCHEMA = ?
+         AND t.TABLE_TYPE IN ('BASE TABLE', 'VIEW')
+       ORDER BY t.TABLE_NAME`, [this.dbName]));
+    }
+    /**
+     * Query: columns with MySQL-specific type info.
+     */
+    async queryColumns(conn) {
+        return (await conn.query(`-- Columns with MySQL-specific metadata
+       SELECT c.TABLE_NAME                AS table_name,
+              c.COLUMN_NAME               AS column_name,
+              c.DATA_TYPE                 AS data_type,
+              c.COLUMN_TYPE               AS column_type,
+              c.IS_NULLABLE               AS is_nullable,
+              c.COLUMN_DEFAULT            AS column_default,
+              c.CHARACTER_MAXIMUM_LENGTH  AS character_maximum_length,
+              c.NUMERIC_PRECISION         AS numeric_precision,
+              c.NUMERIC_SCALE             AS numeric_scale,
+              c.ORDINAL_POSITION          AS ordinal_position,
+              c.EXTRA                     AS extra,
+              c.COLUMN_COMMENT            AS column_comment,
+              c.CHARACTER_SET_NAME        AS character_set_name,
+              c.COLLATION_NAME            AS collation_name
+       FROM information_schema.COLUMNS c
+       WHERE c.TABLE_SCHEMA = ?
+       ORDER BY c.TABLE_NAME, c.ORDINAL_POSITION`, [this.dbName]));
+    }
+    /**
+     * Query: primary key columns.
+     */
+    async queryPrimaryKeys(conn) {
+        return (await conn.query(`-- Primary key columns
+       SELECT tc.TABLE_NAME        AS table_name,
+              tc.CONSTRAINT_NAME   AS constraint_name,
+              kcu.COLUMN_NAME      AS 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
+        AND tc.TABLE_SCHEMA       = kcu.TABLE_SCHEMA
+        AND tc.TABLE_NAME         = kcu.TABLE_NAME
+       WHERE tc.TABLE_SCHEMA = ?
+         AND tc.CONSTRAINT_TYPE = 'PRIMARY KEY'
+       ORDER BY tc.TABLE_NAME, kcu.ORDINAL_POSITION`, [this.dbName]));
+    }
+    /**
+     * Query: foreign key columns with referential actions.
+     *
+     * MySQL's KEY_COLUMN_USAGE table directly exposes the referenced
+     * schema/table/column columns, making it simpler than Postgres.
+     */
+    async queryForeignKeys(conn) {
+        return (await conn.query(`-- Foreign keys (MySQL's KEY_COLUMN_USAGE has REFERENCED_* columns directly)
+       SELECT tc.TABLE_NAME                       AS table_name,
+              tc.CONSTRAINT_NAME                  AS constraint_name,
+              kcu.COLUMN_NAME                     AS column_name,
+              kcu.REFERENCED_TABLE_SCHEMA         AS ref_table_schema,
+              kcu.REFERENCED_TABLE_NAME           AS ref_table_name,
+              kcu.REFERENCED_COLUMN_NAME          AS ref_column_name,
+              rc.UPDATE_RULE                      AS update_rule,
+              rc.DELETE_RULE                      AS 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
+        AND tc.TABLE_SCHEMA       = kcu.TABLE_SCHEMA
+        AND tc.TABLE_NAME         = kcu.TABLE_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 = ?
+         AND tc.CONSTRAINT_TYPE = 'FOREIGN KEY'
+       ORDER BY tc.TABLE_NAME, tc.CONSTRAINT_NAME, kcu.ORDINAL_POSITION`, [this.dbName]));
+    }
+    /**
+     * Query: index columns from STATISTICS table.
+     *
+     * STATISTICS has one row per (index, column), so we group by
+     * index_name + seq_in_index to build the column list later.
+     */
+    async queryIndexes(conn) {
+        return (await conn.query(`-- Index columns (one row per index × column)
+       SELECT s.TABLE_NAME    AS table_name,
+              s.INDEX_NAME    AS index_name,
+              s.COLUMN_NAME   AS column_name,
+              s.NON_UNIQUE    AS non_unique,
+              s.INDEX_TYPE    AS index_type,
+              s.SEQ_IN_INDEX  AS seq_in_index
+       FROM information_schema.STATISTICS s
+       WHERE s.TABLE_SCHEMA = ?
+       ORDER BY s.TABLE_NAME, s.INDEX_NAME, s.SEQ_IN_INDEX`, [this.dbName]));
+    }
+    /**
+     * Query: view definitions.
+     */
+    async queryViews(conn) {
+        return (await conn.query(`-- View definitions
+       SELECT v.TABLE_NAME       AS table_name,
+              v.VIEW_DEFINITION  AS view_definition
+       FROM information_schema.VIEWS v
+       WHERE v.TABLE_SCHEMA = ?
+       ORDER BY v.TABLE_NAME`, [this.dbName]));
+    }
+}
+exports.MySQLIntrospector = MySQLIntrospector;
+// =============================================================================
+//# sourceMappingURL=mysql.js.map

package/dist/introspect/mysql.js.map

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

package/dist/introspect/postgres.d.ts

@@ -0,0 +1,55 @@
+/**
+ * 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.
+ */
+import { IntrospectResult, DbConnectionConfig } from '../types';
+import { BaseIntrospector } from './base';
+export declare class PostgresIntrospector extends BaseIntrospector {
+    constructor(config: DbConnectionConfig);
+    /**
+     * 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
+     */
+    extractAll(): Promise<IntrospectResult>;
+    /**
+     * Query: non-system schemas.
+     */
+    private querySchemas;
+    /**
+     * Query: tables and views (BASE TABLE or VIEW) with optional pg_catalog
+     * comment.
+     */
+    private queryTables;
+    /**
+     * Query: column metadata + pg_catalog column description.
+     */
+    private queryColumns;
+    /**
+     * Query: columns that are part of a PRIMARY KEY constraint.
+     */
+    private queryPrimaryKeys;
+    /**
+     * Query: foreign key columns + referenced table/column + referential actions.
+     */
+    private queryForeignKeys;
+    /**
+     * Query: index definitions from pg_indexes.
+     */
+    private queryIndexes;
+    /**
+     * Query: view definitions.
+     */
+    private queryViews;
+}
+//# sourceMappingURL=postgres.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"postgres.d.ts","sourceRoot":"","sources":["../../src/introspect/postgres.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAKnB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,gBAAgB,EAAE,MAAM,QAAQ,CAAC;AAuE1C,qBAAa,oBAAqB,SAAQ,gBAAgB;gBAC5C,MAAM,EAAE,kBAAkB;IAItC;;;;;;;OAOG;IACG,UAAU,IAAI,OAAO,CAAC,gBAAgB,CAAC;IAwO7C;;OAEG;YACW,YAAY;IAW1B;;;OAGG;YACW,WAAW;IAqBzB;;OAEG;YACW,YAAY;IA8B1B;;OAEG;YACW,gBAAgB;IAsB9B;;OAEG;YACW,gBAAgB;IAmC9B;;OAEG;YACW,YAAY;IAiB1B;;OAEG;YACW,UAAU;CAezB"}