dbgraph 0.1.0

package/dist/introspect/base.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Base Introspector — shared helpers for all database engines
+ *
+ * Provides:
+ *  - URI / naming helpers
+ *  - testConnection() implementation
+ *  - Generic Node/Edge factories with deterministic IDs
+ */
+import { IntrospectResult, DbEngine, DbConnectionConfig, Node, NodeKind, Edge, EdgeKind } from '../types';
+/**
+ * Introspector Interface
+ */
+export interface Introspector {
+    /** Extract all schema objects into nodes/edges */
+    extractAll(): Promise<IntrospectResult>;
+    /** Test connectivity (open + close) */
+    testConnection(): Promise<boolean>;
+    /** Human-readable connection URI (no credentials) */
+    getDisplayUri(): string;
+    /** Database name from config */
+    getDatabase(): string;
+    /** Engine type (e.g. 'postgresql') */
+    getEngine(): DbEngine;
+}
+/**
+ * Abstract base class providing:
+ *  - URI / naming helpers
+ *  - testConnection() implementation
+ *  - Generic Node/Edge factories
+ *
+ * Subclass responsibilities:
+ *  - implement extractAll() with engine-specific information_schema queries
+ *  - call the protected factories to produce Node[] + Edge[]
+ */
+export declare abstract class BaseIntrospector implements Introspector {
+    protected config: DbConnectionConfig;
+    constructor(config: DbConnectionConfig);
+    abstract extractAll(): Promise<IntrospectResult>;
+    getEngine(): DbEngine;
+    getDatabase(): string;
+    getDisplayUri(): string;
+    testConnection(): Promise<boolean>;
+    /** Build a filePath URI for objects in a given schema: `db://@alias/schema` */
+    protected schemaFilePath(schema: string): string;
+    /** Dot-separated qualified name: `@alias.schema.table.column` */
+    protected qn(...parts: string[]): string;
+    /** Map from (schema, table) to a stable lookup key */
+    protected tableKey(schema: string, table: string): string;
+    /** Map from (schema, table, column) to a stable lookup key */
+    protected columnKey(schema: string, table: string, column: string): string;
+    /**
+     * Create a Node with a deterministic ID derived from its qualified name.
+     */
+    protected makeNode(kind: NodeKind, name: string, qualifiedName: string, filePath: string, extra?: Partial<Node>): Node;
+    /**
+     * Create an Edge with deterministic provenance = 'introspect'.
+     */
+    protected makeEdge(source: string, target: string, kind: EdgeKind, metadata?: Record<string, unknown>): Edge;
+    /** Shorthand: contains edge (parent → child) */
+    protected containEdge(parentId: string, childId: string): Edge;
+}
+//# sourceMappingURL=base.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/introspect/base.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACL,gBAAgB,EAChB,QAAQ,EACR,kBAAkB,EAClB,IAAI,EACJ,QAAQ,EACR,IAAI,EACJ,QAAQ,EACT,MAAM,UAAU,CAAC;AAIlB;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,kDAAkD;IAClD,UAAU,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAExC,uCAAuC;IACvC,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAEnC,qDAAqD;IACrD,aAAa,IAAI,MAAM,CAAC;IAExB,gCAAgC;IAChC,WAAW,IAAI,MAAM,CAAC;IAEtB,sCAAsC;IACtC,SAAS,IAAI,QAAQ,CAAC;CACvB;AAED;;;;;;;;;GASG;AACH,8BAAsB,gBAAiB,YAAW,YAAY;IAChD,SAAS,CAAC,MAAM,EAAE,kBAAkB;gBAA1B,MAAM,EAAE,kBAAkB;IAIhD,QAAQ,CAAC,UAAU,IAAI,OAAO,CAAC,gBAAgB,CAAC;IAEhD,SAAS,IAAI,QAAQ;IAIrB,WAAW,IAAI,MAAM;IAIrB,aAAa,IAAI,MAAM;IAUjB,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC;IAYxC,+EAA+E;IAC/E,SAAS,CAAC,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAIhD,iEAAiE;IACjE,SAAS,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM;IAIxC,sDAAsD;IACtD,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM;IAIzD,8DAA8D;IAC9D,SAAS,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM;IAM1E;;OAEG;IACH,SAAS,CAAC,QAAQ,CAChB,IAAI,EAAE,QAAQ,EACd,IAAI,EAAE,MAAM,EACZ,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,MAAM,EAChB,KAAK,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,GACpB,IAAI;IAeP;;OAEG;IACH,SAAS,CAAC,QAAQ,CAChB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,QAAQ,EACd,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,IAAI;IAUP,gDAAgD;IAChD,SAAS,CAAC,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;CAG/D"}

package/dist/introspect/base.js

@@ -0,0 +1,107 @@
+"use strict";
+/**
+ * Base Introspector — shared helpers for all database engines
+ *
+ * Provides:
+ *  - URI / naming helpers
+ *  - testConnection() implementation
+ *  - Generic Node/Edge factories with deterministic IDs
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseIntrospector = void 0;
+const connection_1 = require("./connection");
+const utils_1 = require("../utils");
+/**
+ * Abstract base class providing:
+ *  - URI / naming helpers
+ *  - testConnection() implementation
+ *  - Generic Node/Edge factories
+ *
+ * Subclass responsibilities:
+ *  - implement extractAll() with engine-specific information_schema queries
+ *  - call the protected factories to produce Node[] + Edge[]
+ */
+class BaseIntrospector {
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    getEngine() {
+        return this.config.engine;
+    }
+    getDatabase() {
+        return this.config.database;
+    }
+    getDisplayUri() {
+        if (this.config.path) {
+            return `${this.config.engine}:${this.config.path}`;
+        }
+        const h = this.config.host || 'localhost';
+        const defaultPort = this.config.engine === 'postgresql' ? 5432 : 3306;
+        const p = this.config.port || defaultPort;
+        return `${this.config.engine}://${h}:${p}/${this.config.database}`;
+    }
+    async testConnection() {
+        try {
+            const conn = await (0, connection_1.createConnection)(this.config);
+            await conn.close();
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    // ---- URI / naming helpers ----
+    /** Build a filePath URI for objects in a given schema: `db://@alias/schema` */
+    schemaFilePath(schema) {
+        return `db://@${this.config.alias}/${schema}`;
+    }
+    /** Dot-separated qualified name: `@alias.schema.table.column` */
+    qn(...parts) {
+        return `${this.config.alias}.${parts.join('.')}`;
+    }
+    /** Map from (schema, table) to a stable lookup key */
+    tableKey(schema, table) {
+        return `${schema}.${table}`;
+    }
+    /** Map from (schema, table, column) to a stable lookup key */
+    columnKey(schema, table, column) {
+        return `${schema}.${table}.${column}`;
+    }
+    // ---- Generic Node / Edge factories ----
+    /**
+     * Create a Node with a deterministic ID derived from its qualified name.
+     */
+    makeNode(kind, name, qualifiedName, filePath, extra) {
+        return {
+            id: (0, utils_1.hashString)(qualifiedName),
+            kind,
+            name,
+            qualifiedName,
+            filePath,
+            language: this.config.engine,
+            startLine: 0,
+            endLine: 0,
+            updatedAt: Date.now(),
+            ...extra,
+        };
+    }
+    /**
+     * Create an Edge with deterministic provenance = 'introspect'.
+     */
+    makeEdge(source, target, kind, metadata) {
+        return {
+            source,
+            target,
+            kind,
+            metadata,
+            provenance: 'introspect',
+        };
+    }
+    /** Shorthand: contains edge (parent → child) */
+    containEdge(parentId, childId) {
+        return this.makeEdge(parentId, childId, 'contains');
+    }
+}
+exports.BaseIntrospector = BaseIntrospector;
+//# sourceMappingURL=base.js.map

package/dist/introspect/base.js.map

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

package/dist/introspect/connection.d.ts

@@ -0,0 +1,30 @@
+/**
+ * DB Connection Management
+ *
+ * Adapter pattern over pg, mysql2, and node:sqlite drivers.
+ * Driver packages are lazy-imported with try/catch so missing
+ * deps fail at connect() time, not at module load time.
+ */
+import { DbConnectionConfig } from '../types';
+export interface DBConnection {
+    /** Execute a SQL query and return all result rows */
+    query(sql: string, params?: any[]): Promise<any[]>;
+    /** Close the connection / release pool resources */
+    close(): Promise<void>;
+}
+/**
+ * Create a DBConnection for the given config.
+ *
+ * Supported engines:
+ *  - `postgresql` — via the `pg` package
+ *  - `mysql` / `mariadb` — via the `mysql2` package
+ *  - `sqlite` — via built-in `node:sqlite` (Node >= 22.5)
+ *
+ * @throws ConnectionError if the driver is unavailable or the connection fails.
+ */
+export declare function createConnection(config: DbConnectionConfig): Promise<DBConnection>;
+/**
+ * Quick connectivity check — returns true if a full connection cycle succeeds.
+ */
+export declare function tryConnect(config: DbConnectionConfig): Promise<boolean>;
+//# sourceMappingURL=connection.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../../src/introspect/connection.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAO9C,MAAM,WAAW,YAAY;IAC3B,qDAAqD;IACrD,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IACnD,oDAAoD;IACpD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AA+OD;;;;;;;;;GASG;AACH,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,YAAY,CAAC,CAexF;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,OAAO,CAAC,CAQ7E"}

package/dist/introspect/connection.js

@@ -0,0 +1,232 @@
+"use strict";
+/**
+ * DB Connection Management
+ *
+ * Adapter pattern over pg, mysql2, and node:sqlite drivers.
+ * Driver packages are lazy-imported with try/catch so missing
+ * deps fail at connect() time, not at module load time.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createConnection = createConnection;
+exports.tryConnect = tryConnect;
+const errors_1 = require("../errors");
+// =============================================================================
+// Helpers
+// =============================================================================
+function parseAuth(auth) {
+    if (!auth || auth.length === 0)
+        return {};
+    const idx = auth.indexOf(':');
+    if (idx === -1)
+        return { user: auth };
+    return { user: auth.substring(0, idx), password: auth.substring(idx + 1) };
+}
+// =============================================================================
+// PostgreSQL Connection (pg)
+// =============================================================================
+let pgModule;
+try {
+    pgModule = require('pg');
+}
+catch {
+    /* handled at connect() time */
+}
+class PgConnection {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    static async create(config) {
+        if (!pgModule) {
+            throw new errors_1.ConnectionError(`pg package is not installed.\n` +
+                `Connect to ${config.alias} (${config.engine}) by running: npm install pg`, config.alias);
+        }
+        const auth = parseAuth(config.auth);
+        const client = new pgModule.Client({
+            host: config.host || 'localhost',
+            port: config.port || 5432,
+            database: config.database,
+            user: auth.user,
+            password: auth.password,
+            ssl: config.ssl || false,
+            connectionTimeoutMillis: 10_000,
+        });
+        try {
+            await client.connect();
+        }
+        catch (err) {
+            throw new errors_1.ConnectionError(`Failed to connect to PostgreSQL at ${config.host || 'localhost'}:${config.port || 5432}/${config.database}: ${err.message}`, config.alias, err);
+        }
+        return new PgConnection(client);
+    }
+    async query(sql, params) {
+        try {
+            const result = await this.client.query(sql, params);
+            return result.rows;
+        }
+        catch (err) {
+            throw new errors_1.ConnectionError(`Query failed: ${err.message}\nSQL: ${sql.substring(0, 200)}`, 'query', err);
+        }
+    }
+    async close() {
+        try {
+            await this.client.end();
+        }
+        catch {
+            /* closing a closed connection is harmless */
+        }
+    }
+}
+// =============================================================================
+// MySQL / MariaDB Connection (mysql2)
+// =============================================================================
+let mysqlModule;
+try {
+    mysqlModule = require('mysql2/promise');
+}
+catch {
+    /* handled at connect() time */
+}
+class MySQLConnection {
+    pool;
+    constructor(pool) {
+        this.pool = pool;
+    }
+    static async create(config) {
+        if (!mysqlModule) {
+            throw new errors_1.ConnectionError(`mysql2 package is not installed.\n` +
+                `Connect to ${config.alias} (${config.engine}) by running: npm install mysql2`, config.alias);
+        }
+        const auth = parseAuth(config.auth);
+        const pool = mysqlModule.createPool({
+            host: config.host || 'localhost',
+            port: config.port || 3306,
+            database: config.database,
+            user: auth.user,
+            password: auth.password,
+            ssl: config.ssl || undefined,
+            waitForConnections: true,
+            connectionLimit: 5,
+            queueLimit: 0,
+        });
+        // Verify the connection works before returning
+        try {
+            const conn = await pool.getConnection();
+            conn.release();
+        }
+        catch (err) {
+            await pool.end().catch(() => { });
+            throw new errors_1.ConnectionError(`Failed to connect to MySQL at ${config.host || 'localhost'}:${config.port || 3306}/${config.database}: ${err.message}`, config.alias, err);
+        }
+        return new MySQLConnection(pool);
+    }
+    async query(sql, params) {
+        try {
+            const [rows] = await this.pool.query(sql, params);
+            return rows;
+        }
+        catch (err) {
+            throw new errors_1.ConnectionError(`Query failed: ${err.message}\nSQL: ${sql.substring(0, 200)}`, 'query', err);
+        }
+    }
+    async close() {
+        try {
+            await this.pool.end();
+        }
+        catch {
+            /* harmless */
+        }
+    }
+}
+// =============================================================================
+// SQLite Connection (node:sqlite — built-in Node 22.5+)
+// =============================================================================
+let sqliteModule;
+try {
+    sqliteModule = require('node:sqlite');
+}
+catch {
+    /* handled at connect() time */
+}
+class SQLiteConnection {
+    db;
+    constructor(db) {
+        this.db = db;
+    }
+    static create(config) {
+        if (!sqliteModule) {
+            throw new errors_1.ConnectionError(`node:sqlite is not available. DBGraph requires Node.js 22.5+`, config.alias);
+        }
+        if (!config.path) {
+            throw new errors_1.ConnectionError(`SQLite connection requires a path to the database file in config.\n` +
+                `Example: { engine: 'sqlite', alias: 'myapp', path: '/data/mydb.sqlite' }`, config.alias);
+        }
+        try {
+            const db = new sqliteModule.DatabaseSync(config.path);
+            // Use WAL mode for read performance during introspection
+            db.exec('PRAGMA journal_mode = WAL');
+            db.exec('PRAGMA foreign_keys = ON');
+            return new SQLiteConnection(db);
+        }
+        catch (err) {
+            throw new errors_1.ConnectionError(`Failed to open SQLite database at ${config.path}: ${err.message}`, config.alias, err);
+        }
+    }
+    async query(sql, params) {
+        try {
+            const stmt = this.db.prepare(sql);
+            return params ? stmt.all(...params) : stmt.all();
+        }
+        catch (err) {
+            throw new errors_1.ConnectionError(`Query failed: ${err.message}\nSQL: ${sql.substring(0, 200)}`, 'query', err);
+        }
+    }
+    async close() {
+        try {
+            this.db.close();
+        }
+        catch {
+            /* harmless */
+        }
+    }
+}
+// =============================================================================
+// Factory
+// =============================================================================
+/**
+ * Create a DBConnection for the given config.
+ *
+ * Supported engines:
+ *  - `postgresql` — via the `pg` package
+ *  - `mysql` / `mariadb` — via the `mysql2` package
+ *  - `sqlite` — via built-in `node:sqlite` (Node >= 22.5)
+ *
+ * @throws ConnectionError if the driver is unavailable or the connection fails.
+ */
+async function createConnection(config) {
+    switch (config.engine) {
+        case 'postgresql':
+            return await PgConnection.create(config);
+        case 'mysql':
+        case 'mariadb':
+            return await MySQLConnection.create(config);
+        case 'sqlite':
+            return SQLiteConnection.create(config);
+        default:
+            throw new errors_1.ConnectionError(`Unsupported engine: "${config.engine}". Supported engines: postgresql, mysql, mariadb, sqlite`, config.alias);
+    }
+}
+/**
+ * Quick connectivity check — returns true if a full connection cycle succeeds.
+ */
+async function tryConnect(config) {
+    try {
+        const conn = await createConnection(config);
+        await conn.close();
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=connection.js.map

package/dist/introspect/connection.js.map

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

package/dist/introspect/index.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Introspector Interface & Factory
+ *
+ * An Introspector connects to a live database and extracts its schema as
+ * a knowledge graph of Node[] + Edge[] (the same format used by DBGraph's
+ * query engine and MCP tools).
+ *
+ * Concrete implementations:
+ *  - PostgresIntrospector  (postgres.ts)
+ *  - MySQLIntrospector     (mysql.ts)
+ *  - SQLiteIntrospector    (sqlite.ts)
+ */
+import { DbConnectionConfig } from '../types';
+import { Introspector } from './base';
+export { Introspector, BaseIntrospector } from './base';
+/**
+ * Create the appropriate Introspector for the given config.
+ *
+ * Throws if the engine is not supported.
+ * Does _not_ open a connection — call .extractAll() or .testConnection().
+ */
+export declare function createIntrospector(config: DbConnectionConfig): Introspector;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/introspect/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAI9C,OAAO,EAAE,YAAY,EAAoB,MAAM,QAAQ,CAAC;AAGxD,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,QAAQ,CAAC;AAMxD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,kBAAkB,GAAG,YAAY,CAe3E"}

package/dist/introspect/index.js

@@ -0,0 +1,46 @@
+"use strict";
+/**
+ * Introspector Interface & Factory
+ *
+ * An Introspector connects to a live database and extracts its schema as
+ * a knowledge graph of Node[] + Edge[] (the same format used by DBGraph's
+ * query engine and MCP tools).
+ *
+ * Concrete implementations:
+ *  - PostgresIntrospector  (postgres.ts)
+ *  - MySQLIntrospector     (mysql.ts)
+ *  - SQLiteIntrospector    (sqlite.ts)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseIntrospector = void 0;
+exports.createIntrospector = createIntrospector;
+const postgres_1 = require("./postgres");
+const mysql_1 = require("./mysql");
+const sqlite_1 = require("./sqlite");
+// Re-export base types
+var base_1 = require("./base");
+Object.defineProperty(exports, "BaseIntrospector", { enumerable: true, get: function () { return base_1.BaseIntrospector; } });
+// =============================================================================
+// Factory
+// =============================================================================
+/**
+ * Create the appropriate Introspector for the given config.
+ *
+ * Throws if the engine is not supported.
+ * Does _not_ open a connection — call .extractAll() or .testConnection().
+ */
+function createIntrospector(config) {
+    switch (config.engine) {
+        case 'postgresql':
+            return new postgres_1.PostgresIntrospector(config);
+        case 'mysql':
+        case 'mariadb':
+            return new mysql_1.MySQLIntrospector(config);
+        case 'sqlite':
+            return new sqlite_1.SQLiteIntrospector(config);
+        default:
+            throw new Error(`Unsupported database engine: "${config.engine}". ` +
+                `Supported engines: postgresql, mysql, mariadb, sqlite`);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/introspect/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/introspect/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;GAWG;;;AAqBH,gDAeC;AAjCD,yCAAkD;AAClD,mCAA4C;AAC5C,qCAA8C;AAG9C,uBAAuB;AACvB,+BAAwD;AAAjC,wGAAA,gBAAgB,OAAA;AAEvC,gFAAgF;AAChF,UAAU;AACV,gFAAgF;AAEhF;;;;;GAKG;AACH,SAAgB,kBAAkB,CAAC,MAA0B;IAC3D,QAAQ,MAAM,CAAC,MAAM,EAAE,CAAC;QACtB,KAAK,YAAY;YACf,OAAO,IAAI,+BAAoB,CAAC,MAAM,CAAC,CAAC;QAC1C,KAAK,OAAO,CAAC;QACb,KAAK,SAAS;YACZ,OAAO,IAAI,yBAAiB,CAAC,MAAM,CAAC,CAAC;QACvC,KAAK,QAAQ;YACX,OAAO,IAAI,2BAAkB,CAAC,MAAM,CAAC,CAAC;QACxC;YACE,MAAM,IAAI,KAAK,CACb,iCAAiC,MAAM,CAAC,MAAM,KAAK;gBACnD,uDAAuD,CACxD,CAAC;IACN,CAAC;AACH,CAAC"}

package/dist/introspect/mysql.d.ts

@@ -0,0 +1,64 @@
+/**
+ * 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)")
+ */
+import { IntrospectResult, DbConnectionConfig } from '../types';
+import { BaseIntrospector } from './base';
+export declare class MySQLIntrospector extends BaseIntrospector {
+    /** The database/schema name to introspect */
+    private dbName;
+    constructor(config: DbConnectionConfig);
+    /**
+     * 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
+     */
+    extractAll(): Promise<IntrospectResult>;
+    /**
+     * Query: tables and views in the current database.
+     */
+    private queryTables;
+    /**
+     * Query: columns with MySQL-specific type info.
+     */
+    private queryColumns;
+    /**
+     * Query: primary key columns.
+     */
+    private queryPrimaryKeys;
+    /**
+     * 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.
+     */
+    private queryForeignKeys;
+    /**
+     * 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.
+     */
+    private queryIndexes;
+    /**
+     * Query: view definitions.
+     */
+    private queryViews;
+}
+//# sourceMappingURL=mysql.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mysql.d.ts","sourceRoot":"","sources":["../../src/introspect/mysql.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAKnB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,gBAAgB,EAAE,MAAM,QAAQ,CAAC;AAqE1C,qBAAa,iBAAkB,SAAQ,gBAAgB;IACrD,6CAA6C;IAC7C,OAAO,CAAC,MAAM,CAAS;gBAEX,MAAM,EAAE,kBAAkB;IAKtC;;;;;;;OAOG;IACG,UAAU,IAAI,OAAO,CAAC,gBAAgB,CAAC;IA8N7C;;OAEG;YACW,WAAW;IAiBzB;;OAEG;YACW,YAAY;IAwB1B;;OAEG;YACW,gBAAgB;IAoB9B;;;;;OAKG;YACW,gBAAgB;IA6B9B;;;;;OAKG;YACW,YAAY;IAgB1B;;OAEG;YACW,UAAU;CAWzB"}