@askdb/mysql 0.1.0-beta.2 → 0.1.0-beta.20

package/NOTICE

@@ -0,0 +1,10 @@
+AskDB
+Copyright 2026 Yahya Gilany
+
+This product includes software developed by Yahya Gilany and contributors.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0

package/README.md

@@ -9,15 +9,24 @@ MySQL / MariaDB integration for AskDB. Bundles three pieces:
 ## Install
 
 ```bash
-pnpm add @askdb/core @askdb/introspect @askdb/mysql
+pnpm add @askdb/core @askdb/introspect @askdb/mysql ai
 ```
 
+`ai` (Vercel AI SDK 6 or 7) is a required peer dependency of `@askdb/core`; your app owns its version.
+
 `mysql2` is an **optional peer dependency** — install it only when using live introspection mode:
 
 ```bash
 pnpm add mysql2
 ```
 
+For one-off CLI introspection, include the driver in the same ephemeral command:
+
+```bash
+pnpm dlx -p askdb -p mysql2 askdb introspect --engine mysql --url "$MYSQL_URL"
+npx -p askdb -p mysql2 askdb introspect --engine mysql --url "$MYSQL_URL"
+```
+
 ## Usage
 
 ### NL→SQL
@@ -51,10 +60,28 @@ const result = await introspect(
 );
 ```
 
+By default the connector reads the connection URL's database and renders it under the `public` namespace. In that mode the connection string must name a database (`mysql://user:pass@host:3306/<database>`); introspection throws a clear error when the connection has no default database instead of returning an empty schema. To introspect several databases, list them in `filters.schemas`. Each database then becomes its own namespace, and foreign keys into another listed database keep the referenced database:
+
+```ts
+await introspect(
+  {
+    mode: "live",
+    runner: createMysqlCatalogQueryRunner(process.env.DATABASE_URL!),
+    filters: { schemas: ["app", "sales", "analytics"] },
+  },
+  { outDir: "./my-app.schema", schemaId: "my-app" },
+  { connector: createMysqlConnector() },
+);
+```
+
+With the `askdb` CLI, set `introspection.schemas` in `askdb.config.ts`, or pass `--schemas app,sales`.
+
+`mysqlConnectorProvider` parses a connection into display-safe parts, so a connector registry's `connectionLabel()` (and the `sourceLabel` from `resolveConnection()`) shows only the host, port and database of a `mysql://` URL, read the way `mysql2` reads it (WHATWG `URL`; `mysql://root:S3cret@db:3306/shop` → `mysql://db:3306/shop`). Anything else becomes `configured mysql connection`.
+
 ## Captured metadata
 
-Tables, views, columns (MySQL-native type strings), primary keys, unique constraints, foreign keys (with referential actions), and indexes.
+Tables, views, columns (MySQL-native type strings), primary keys, unique constraints, foreign keys (with referential actions), and indexes. Only the connection's database, or the databases listed in `filters.schemas`, is introspected: foreign keys that reference a table in any other database are omitted and reported as a `cross_database_fk` warning.
 
 ## License
 
-Apache-2.0
+Apache-2.0 © [Yahya Gilany](https://yahyagilany.io). See [LICENSE](./LICENSE) and [NOTICE](./NOTICE).

package/dist/connector/describe.d.ts

@@ -1,78 +1,90 @@
 import type { CatalogQueryRunner, IntrospectionFilters, IntrospectionResult } from "@askdb/introspect";
-import { compileTableFilters } from "./glob.js";
 export type DescribeMysqlInput = {
     runner: CatalogQueryRunner;
     filters?: IntrospectionFilters;
     /** Optional `schemaId` for the resulting `SqlSchema`. Defaults to `"introspected"`. */
     schemaId?: string;
 };
-/** Internal: the catalog SQL strings, exposed for snapshot-based tests. */
+/** The default (connection-database) catalog SQL strings the connector issues, keyed by query name. */
 export declare const MYSQL_CATALOG_SQL: {
-    readonly tables: "SELECT\n  table_name AS table_name,\n  table_type AS table_type,\n  table_comment AS table_comment\nFROM information_schema.tables\nWHERE table_schema = DATABASE()\n  AND table_type IN ('BASE TABLE', 'VIEW')\nORDER BY table_name";
-    readonly columns: "SELECT\n  table_name AS table_name,\n  column_name AS column_name,\n  ordinal_position AS ordinal_position,\n  column_default AS column_default,\n  is_nullable AS is_nullable,\n  data_type AS data_type,\n  column_type AS column_type,\n  column_key AS column_key,\n  extra AS extra,\n  column_comment AS column_comment\nFROM information_schema.columns\nWHERE table_schema = DATABASE()\nORDER BY table_name, ordinal_position";
-    readonly constraints: "SELECT\n  tc.constraint_name AS constraint_name,\n  tc.table_name AS table_name,\n  kcu.column_name AS column_name,\n  kcu.ordinal_position AS ordinal_position,\n  tc.constraint_type AS constraint_type\nFROM information_schema.table_constraints tc\nJOIN information_schema.key_column_usage kcu\n  ON kcu.constraint_schema = tc.constraint_schema\n AND kcu.constraint_name = tc.constraint_name\n AND kcu.table_name = tc.table_name\nWHERE tc.table_schema = DATABASE()\n  AND tc.constraint_type IN ('PRIMARY KEY', 'UNIQUE')\nORDER BY tc.table_name, tc.constraint_name, kcu.ordinal_position";
-    readonly foreign_keys: "SELECT\n  kcu.constraint_name AS constraint_name,\n  kcu.table_name AS table_name,\n  kcu.column_name AS column_name,\n  kcu.referenced_table_name AS referenced_table_name,\n  kcu.referenced_column_name AS referenced_column_name,\n  kcu.ordinal_position AS ordinal_position,\n  rc.update_rule AS update_rule,\n  rc.delete_rule AS delete_rule\nFROM information_schema.key_column_usage kcu\nJOIN information_schema.referential_constraints rc\n  ON rc.constraint_schema = kcu.constraint_schema\n AND rc.constraint_name = kcu.constraint_name\nWHERE kcu.table_schema = DATABASE()\n  AND kcu.referenced_table_name IS NOT NULL\nORDER BY kcu.table_name, kcu.constraint_name, kcu.ordinal_position";
-    readonly indexes: "SELECT\n  table_name AS table_name,\n  index_name AS index_name,\n  column_name AS column_name,\n  seq_in_index AS seq_in_index,\n  non_unique AS non_unique,\n  index_type AS index_type\nFROM information_schema.statistics\nWHERE table_schema = DATABASE()\n  AND index_name <> 'PRIMARY'\nORDER BY table_name, index_name, seq_in_index";
-    readonly views: "SELECT\n  table_name AS table_name,\n  view_definition AS view_definition\nFROM information_schema.views\nWHERE table_schema = DATABASE()\nORDER BY table_name";
-};
-type TableRow = {
-    table_name: string;
-    table_type: "BASE TABLE" | "VIEW" | string;
-    table_comment: string | null;
-};
-type ColumnRow = {
-    table_name: string;
-    column_name: string;
-    ordinal_position: number;
-    column_default: string | null;
-    is_nullable: "YES" | "NO" | string;
-    data_type: string;
-    column_type: string;
-    column_key: "PRI" | "UNI" | "MUL" | "" | string;
-    extra: string | null;
-    column_comment: string | null;
-};
-type ConstraintRow = {
-    constraint_name: string;
-    table_name: string;
-    column_name: string;
-    ordinal_position: number;
-    constraint_type: "PRIMARY KEY" | "UNIQUE" | string;
-};
-type ForeignKeyRow = {
-    constraint_name: string;
-    table_name: string;
-    column_name: string;
-    referenced_table_name: string;
-    referenced_column_name: string;
-    ordinal_position: number;
-    update_rule: string | null;
-    delete_rule: string | null;
-};
-type IndexRow = {
-    table_name: string;
-    index_name: string;
-    column_name: string | null;
-    seq_in_index: number;
-    non_unique: number;
-    index_type: string;
-};
-type ViewRow = {
-    table_name: string;
-    view_definition: string | null;
+    readonly tables: `SELECT
+  table_schema AS table_schema,
+  table_name AS table_name,
+  table_type AS table_type,
+  table_comment AS table_comment
+FROM information_schema.tables
+WHERE ${string}
+  AND table_type IN ('BASE TABLE', 'VIEW')
+ORDER BY table_schema, table_name`;
+    readonly columns: `SELECT
+  table_schema AS table_schema,
+  table_name AS table_name,
+  column_name AS column_name,
+  ordinal_position AS ordinal_position,
+  column_default AS column_default,
+  is_nullable AS is_nullable,
+  data_type AS data_type,
+  column_type AS column_type,
+  column_key AS column_key,
+  extra AS extra,
+  column_comment AS column_comment
+FROM information_schema.columns
+WHERE ${string}
+ORDER BY table_schema, table_name, ordinal_position`;
+    readonly constraints: `SELECT
+  tc.table_schema AS table_schema,
+  tc.constraint_name AS constraint_name,
+  tc.table_name AS table_name,
+  kcu.column_name AS column_name,
+  kcu.ordinal_position AS ordinal_position,
+  tc.constraint_type AS constraint_type
+FROM information_schema.table_constraints tc
+JOIN information_schema.key_column_usage kcu
+  ON kcu.constraint_schema = tc.constraint_schema
+ AND kcu.constraint_name = tc.constraint_name
+ AND kcu.table_schema = tc.table_schema
+ AND kcu.table_name = tc.table_name
+WHERE ${string}
+  AND tc.constraint_type IN ('PRIMARY KEY', 'UNIQUE')
+ORDER BY tc.table_schema, tc.table_name, tc.constraint_name, kcu.ordinal_position`;
+    readonly foreign_keys: `SELECT
+  kcu.table_schema AS table_schema,
+  kcu.constraint_name AS constraint_name,
+  kcu.table_name AS table_name,
+  kcu.column_name AS column_name,
+  kcu.referenced_table_schema AS referenced_table_schema,
+  kcu.referenced_table_name AS referenced_table_name,
+  kcu.referenced_column_name AS referenced_column_name,
+  kcu.ordinal_position AS ordinal_position,
+  rc.update_rule AS update_rule,
+  rc.delete_rule AS delete_rule
+FROM information_schema.key_column_usage kcu
+JOIN information_schema.referential_constraints rc
+  ON rc.constraint_schema = kcu.constraint_schema
+ AND rc.constraint_name = kcu.constraint_name
+WHERE ${string}
+  AND kcu.referenced_table_name IS NOT NULL
+ORDER BY kcu.table_schema, kcu.table_name, kcu.constraint_name, kcu.ordinal_position`;
+    readonly indexes: `SELECT
+  table_schema AS table_schema,
+  table_name AS table_name,
+  index_name AS index_name,
+  column_name AS column_name,
+  seq_in_index AS seq_in_index,
+  non_unique AS non_unique,
+  index_type AS index_type
+FROM information_schema.statistics
+WHERE ${string}
+  AND index_name <> 'PRIMARY'
+ORDER BY table_schema, table_name, index_name, seq_in_index`;
+    readonly views: `SELECT
+  table_schema AS table_schema,
+  table_name AS table_name,
+  view_definition AS view_definition
+FROM information_schema.views
+WHERE ${string}
+ORDER BY table_schema, table_name`;
+    readonly current_database: "SELECT DATABASE() AS database_name";
 };
 export declare function describeMysql(input: DescribeMysqlInput): Promise<IntrospectionResult>;
-type FoldInput = {
-    schemaId: string;
-    tableFilter: ReturnType<typeof compileTableFilters>;
-    tableRows: TableRow[];
-    columnRows: ColumnRow[];
-    constraintRows: ConstraintRow[];
-    fkRows: ForeignKeyRow[];
-    indexRows: IndexRow[];
-    viewRows: ViewRow[];
-    declaredFilters: ReadonlyArray<string>;
-};
-export declare function foldMysqlResult(input: FoldInput): IntrospectionResult;
-export {};
 //# sourceMappingURL=describe.d.ts.map

package/dist/connector/describe.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"describe.d.ts","sourceRoot":"","sources":["../../src/connector/describe.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"describe.d.ts","sourceRoot":"","sources":["../../src/connector/describe.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kBAAkB,EAClB,oBAAoB,EACpB,mBAAmB,EAUpB,MAAM,mBAAmB,CAAC;AAkC3B,MAAM,MAAM,kBAAkB,GAAG;IAC/B,MAAM,EAAE,kBAAkB,CAAC;IAC3B,OAAO,CAAC,EAAE,oBAAoB,CAAC;IAC/B,uFAAuF;IACvF,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AA4GF,uGAAuG;AACvG,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAGpB,CAAC;AAyDX,wBAAsB,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAsD3F"}

package/dist/connector/describe.js

@@ -1,24 +1,51 @@
-import { compileTableFilters } from "./glob.js";
-import { makeColumnId, makeTableId } from "./ids.js";
+import { AskDbError, SINGLE_NAMESPACE_LABEL } from "@askdb/core";
+import { ambiguousFilterWarnings, buildOrderedGroups, byName, compileTableFilters, groupBy, makeColumnId, makeTableId, mapFkAction, rowsToRecords, } from "@askdb/introspect/kit";
 /**
  * MySQL doesn't have Postgres-style schemas (each "schema" is a database).
- * Hosts pick a database via the connection string; the connector emits its
- * contents under a single namespace named `"public"` to match `@askdb/prisma`'s
- * convention and keep table ids cross-engine stable.
+ *
+ * - **Default (no `filters.schemas`)**: the connector reads the connection's
+ *   database (`DATABASE()`) and emits it under a single namespace named
+ *   `"public"`, matching `@askdb/prisma`'s convention so table ids stay stable
+ *   across engines.
+ * - **Database list (`filters.schemas`)**: the connector reads every listed
+ *   database (`table_schema IN (…)`) and each becomes its own namespace, named
+ *   after the database. Foreign keys into another listed database keep the
+ *   referenced database. `filters.excludeSchemas` removes entries from the list.
+ *   `introspection.schemas` (askdb.config.ts) and
+ *   `askdb introspect --schemas` both feed this list.
+ *
+ * In both modes a foreign key into a database that wasn't introspected has no
+ * target in the artifact; it is skipped and reported as a `cross_database_fk`
+ * warning.
  */
-const NAMESPACE = "public";
+const DEFAULT_NAMESPACE = SINGLE_NAMESPACE_LABEL;
 // information_schema is well-documented; pinning the SQL inside the package
-// keeps the surface stable. Each query restricts to `DATABASE()` so the runner's
-// connection-bound database is the implicit filter.
-const SQL_TABLES = `SELECT
+// keeps the surface stable. Every query is scoped by one predicate on the
+// schema column: `= DATABASE()` by default, or `IN (?, …)` for a database list.
+//
+// In the default mode `DATABASE()` is NULL when the connection has no default
+// database (e.g. `mysql://host:3306` with no path) — every catalog query would
+// then silently match nothing, so we check it up front and fail loudly instead
+// of emitting an empty schema.
+const SQL_CURRENT_DATABASE = `SELECT DATABASE() AS database_name`;
+const connectionDatabase = (column) => `${column} = DATABASE()`;
+function listedDatabases(count) {
+    const markers = Array.from({ length: count }, () => "?").join(", ");
+    return (column) => `${column} IN (${markers})`;
+}
+function catalogSql(scope) {
+    return {
+        tables: `SELECT
+  table_schema AS table_schema,
   table_name AS table_name,
   table_type AS table_type,
   table_comment AS table_comment
 FROM information_schema.tables
-WHERE table_schema = DATABASE()
+WHERE ${scope("table_schema")}
   AND table_type IN ('BASE TABLE', 'VIEW')
-ORDER BY table_name`;
-const SQL_COLUMNS = `SELECT
+ORDER BY table_schema, table_name`,
+        columns: `SELECT
+  table_schema AS table_schema,
   table_name AS table_name,
   column_name AS column_name,
   ordinal_position AS ordinal_position,
@@ -30,9 +57,10 @@ const SQL_COLUMNS = `SELECT
   extra AS extra,
   column_comment AS column_comment
 FROM information_schema.columns
-WHERE table_schema = DATABASE()
-ORDER BY table_name, ordinal_position`;
-const SQL_CONSTRAINTS = `SELECT
+WHERE ${scope("table_schema")}
+ORDER BY table_schema, table_name, ordinal_position`,
+        constraints: `SELECT
+  tc.table_schema AS table_schema,
   tc.constraint_name AS constraint_name,
   tc.table_name AS table_name,
   kcu.column_name AS column_name,
@@ -42,14 +70,17 @@ FROM information_schema.table_constraints tc
 JOIN information_schema.key_column_usage kcu
   ON kcu.constraint_schema = tc.constraint_schema
  AND kcu.constraint_name = tc.constraint_name
+ AND kcu.table_schema = tc.table_schema
  AND kcu.table_name = tc.table_name
-WHERE tc.table_schema = DATABASE()
+WHERE ${scope("tc.table_schema")}
   AND tc.constraint_type IN ('PRIMARY KEY', 'UNIQUE')
-ORDER BY tc.table_name, tc.constraint_name, kcu.ordinal_position`;
-const SQL_FOREIGN_KEYS = `SELECT
+ORDER BY tc.table_schema, tc.table_name, tc.constraint_name, kcu.ordinal_position`,
+        foreign_keys: `SELECT
+  kcu.table_schema AS table_schema,
   kcu.constraint_name AS constraint_name,
   kcu.table_name AS table_name,
   kcu.column_name AS column_name,
+  kcu.referenced_table_schema AS referenced_table_schema,
   kcu.referenced_table_name AS referenced_table_name,
   kcu.referenced_column_name AS referenced_column_name,
   kcu.ordinal_position AS ordinal_position,
@@ -59,10 +90,11 @@ FROM information_schema.key_column_usage kcu
 JOIN information_schema.referential_constraints rc
   ON rc.constraint_schema = kcu.constraint_schema
  AND rc.constraint_name = kcu.constraint_name
-WHERE kcu.table_schema = DATABASE()
+WHERE ${scope("kcu.table_schema")}
   AND kcu.referenced_table_name IS NOT NULL
-ORDER BY kcu.table_name, kcu.constraint_name, kcu.ordinal_position`;
-const SQL_INDEXES = `SELECT
+ORDER BY kcu.table_schema, kcu.table_name, kcu.constraint_name, kcu.ordinal_position`,
+        indexes: `SELECT
+  table_schema AS table_schema,
   table_name AS table_name,
   index_name AS index_name,
   column_name AS column_name,
@@ -70,51 +102,63 @@ const SQL_INDEXES = `SELECT
   non_unique AS non_unique,
   index_type AS index_type
 FROM information_schema.statistics
-WHERE table_schema = DATABASE()
+WHERE ${scope("table_schema")}
   AND index_name <> 'PRIMARY'
-ORDER BY table_name, index_name, seq_in_index`;
-const SQL_VIEWS = `SELECT
+ORDER BY table_schema, table_name, index_name, seq_in_index`,
+        views: `SELECT
+  table_schema AS table_schema,
   table_name AS table_name,
   view_definition AS view_definition
 FROM information_schema.views
-WHERE table_schema = DATABASE()
-ORDER BY table_name`;
-/** Internal: the catalog SQL strings, exposed for snapshot-based tests. */
+WHERE ${scope("table_schema")}
+ORDER BY table_schema, table_name`,
+    };
+}
+/** The default (connection-database) catalog SQL strings the connector issues, keyed by query name. */
 export const MYSQL_CATALOG_SQL = {
-    tables: SQL_TABLES,
-    columns: SQL_COLUMNS,
-    constraints: SQL_CONSTRAINTS,
-    foreign_keys: SQL_FOREIGN_KEYS,
-    indexes: SQL_INDEXES,
-    views: SQL_VIEWS,
+    current_database: SQL_CURRENT_DATABASE,
+    ...catalogSql(connectionDatabase),
 };
 export async function describeMysql(input) {
     const runner = input.runner;
     const tableFilter = compileTableFilters(input.filters?.tables);
-    const run = async (sql) => {
-        const result = await runner(sql);
-        if (result.rows.length === 0)
+    const excluded = new Set(input.filters?.excludeSchemas ?? []);
+    const databases = [...new Set(input.filters?.schemas ?? [])].filter((d) => d && !excluded.has(d));
+    const listed = (input.filters?.schemas?.length ?? 0) > 0;
+    const sql = listed ? catalogSql(listedDatabases(databases.length)) : MYSQL_CATALOG_SQL;
+    const params = listed ? databases : undefined;
+    const run = async (query) => {
+        // Every listed database was excluded: nothing to read.
+        if (listed && databases.length === 0)
             return [];
-        const idx = new Map();
-        for (let i = 0; i < result.columns.length; i++)
-            idx.set(result.columns[i], i);
-        return result.rows.map((row) => {
-            const record = {};
-            for (const [name, i] of idx)
-                record[name] = row[i];
-            return record;
-        });
+        return rowsToRecords(await runner(query, params));
     };
+    // The default mode reads the connection's database; a database list names its own.
+    if (!listed) {
+        const [current] = await run(SQL_CURRENT_DATABASE);
+        if (!current?.database_name) {
+            throw new AskDbError("MySQL introspection needs a target database, but the connection has none selected " +
+                "(DATABASE() is NULL). Put the database name in the connection URL path, e.g. " +
+                "mysql://user:password@host:3306/<database>, or list databases with " +
+                "`introspection.schemas` / `--schemas`.");
+        }
+    }
     const [tableRows, columnRows, constraintRows, fkRows, indexRows, viewRows] = await Promise.all([
-        run(SQL_TABLES),
-        run(SQL_COLUMNS),
-        run(SQL_CONSTRAINTS),
-        run(SQL_FOREIGN_KEYS),
-        run(SQL_INDEXES),
-        run(SQL_VIEWS),
+        run(sql.tables),
+        run(sql.columns),
+        run(sql.constraints),
+        run(sql.foreign_keys),
+        run(sql.indexes),
+        run(sql.views),
     ]);
+    const readDatabases = new Set(tableRows.map((row) => row.table_schema));
     return foldMysqlResult({
         schemaId: input.schemaId ?? "introspected",
+        namespaceOf: listed ? (database) => database : () => DEFAULT_NAMESPACE,
+        // The databases the catalog returned rows for, spelled as the catalog spells
+        // them: with case-insensitive names (lower_case_table_names 1 or 2),
+        // `--schemas Shop` reads the database stored as `shop`.
+        isIntrospected: listed ? (database) => readDatabases.has(database) : undefined,
         tableFilter,
         tableRows,
         columnRows,
@@ -125,89 +169,88 @@ export async function describeMysql(input) {
         declaredFilters: input.filters?.tables ?? [],
     });
 }
-export function foldMysqlResult(input) {
+/** Grouping key for a table: database + name, so equal table names in two databases stay apart. */
+function tableKey(row) {
+    return `${row.table_schema}\u0000${row.table_name}`;
+}
+function foldMysqlResult(input) {
     const warnings = [];
-    const columnsByTable = groupBy(input.columnRows, (r) => r.table_name);
-    const constraintsByTable = groupBy(input.constraintRows, (r) => r.table_name);
-    const fksByTable = groupBy(input.fkRows, (r) => r.table_name);
-    const indexesByTable = groupBy(input.indexRows, (r) => r.table_name);
-    const viewDefByName = new Map();
+    const columnsByTable = groupBy(input.columnRows, tableKey);
+    const constraintsByTable = groupBy(input.constraintRows, tableKey);
+    const fksByTable = groupBy(input.fkRows, tableKey);
+    const indexesByTable = groupBy(input.indexRows, tableKey);
+    const viewDefByTable = new Map();
     for (const v of input.viewRows) {
         if (v.view_definition)
-            viewDefByName.set(v.table_name, v.view_definition);
+            viewDefByTable.set(tableKey(v), v.view_definition);
     }
-    const tables = [];
-    const views = [];
+    const namespaces = new Map();
+    const namespaceFor = (name) => {
+        let ns = namespaces.get(name);
+        if (!ns) {
+            ns = { name, tables: [], views: [], enums: [], sequences: [] };
+            namespaces.set(name, ns);
+        }
+        return ns;
+    };
     const viewDefinitions = {};
     for (const t of input.tableRows) {
-        const qualified = `${NAMESPACE}.${t.table_name}`;
-        if (!input.tableFilter(qualified))
+        const namespace = input.namespaceOf(t.table_schema);
+        if (!input.tableFilter(`${namespace}.${t.table_name}`))
             continue;
-        const cols = (columnsByTable.get(t.table_name) ?? [])
+        const key = tableKey(t);
+        const cols = (columnsByTable.get(key) ?? [])
             .slice()
             .sort((a, b) => a.ordinal_position - b.ordinal_position);
-        const constraints = constraintsByTable.get(t.table_name) ?? [];
+        const constraints = constraintsByTable.get(key) ?? [];
         const pkRows = constraints
             .filter((c) => c.constraint_type === "PRIMARY KEY")
             .sort((a, b) => a.ordinal_position - b.ordinal_position);
         const pkColumns = pkRows.map((r) => r.column_name);
         const pkSet = new Set(pkColumns);
-        const columns = cols.map((c) => buildColumn(t.table_name, c, pkSet));
+        const columns = cols.map((c) => buildColumn(namespace, t.table_name, c, pkSet));
         if (t.table_type === "VIEW") {
-            const def = viewDefByName.get(t.table_name) ?? "";
-            const view = {
-                schema: NAMESPACE,
-                name: t.table_name,
-                definition: def,
-                columns,
-            };
-            views.push(view);
-            viewDefinitions[makeTableId(NAMESPACE, t.table_name)] = def;
+            const def = viewDefByTable.get(key) ?? "";
+            namespaceFor(namespace).views.push({ schema: namespace, name: t.table_name, definition: def, columns });
+            viewDefinitions[makeTableId(namespace, t.table_name)] = def;
             continue;
         }
-        tables.push({
-            id: makeTableId(NAMESPACE, t.table_name),
-            schema: NAMESPACE,
+        namespaceFor(namespace).tables.push({
+            id: makeTableId(namespace, t.table_name),
+            schema: namespace,
             name: t.table_name,
             comment: t.table_comment ?? undefined,
             columns,
             primaryKey: pkColumns.length > 0 ? { columns: pkColumns } : undefined,
-            foreignKeys: buildForeignKeys(fksByTable.get(t.table_name) ?? []),
+            foreignKeys: buildForeignKeys(fksByTable.get(key) ?? [], input, warnings),
             uniqueConstraints: buildUniques(constraints),
-            indexes: buildIndexes(indexesByTable.get(t.table_name) ?? []),
+            indexes: buildIndexes(indexesByTable.get(key) ?? []),
             checkConstraints: [],
         });
     }
     // Sort for deterministic output.
-    tables.sort(byName);
-    views.sort(byName);
-    const namespace = {
-        name: NAMESPACE,
-        tables,
-        views,
-        enums: [],
-        sequences: [],
-    };
-    const isEmpty = tables.length === 0 && views.length === 0;
-    for (const pattern of input.declaredFilters) {
-        const matched = tables.some((t) => compileTableFilters([pattern])(`${NAMESPACE}.${t.name}`)) ||
-            views.some((v) => compileTableFilters([pattern])(`${NAMESPACE}.${v.name}`));
-        if (!matched)
-            warnings.push({ code: "ambiguous_filter", filter: pattern });
+    const sortedNamespaces = [...namespaces.values()].sort(byName);
+    for (const ns of sortedNamespaces) {
+        ns.tables.sort(byName);
+        ns.views.sort(byName);
     }
+    const allTables = sortedNamespaces.flatMap((ns) => ns.tables);
+    const allViews = sortedNamespaces.flatMap((ns) => ns.views);
+    const isEmpty = allTables.length === 0 && allViews.length === 0;
+    warnings.push(...ambiguousFilterWarnings(input.declaredFilters, [...allTables, ...allViews].map((t) => `${t.schema}.${t.name}`)));
     const schema = {
         schemaId: input.schemaId,
-        schemas: isEmpty ? [] : [namespace],
+        schemas: isEmpty ? [] : sortedNamespaces,
     };
     return { schema, warnings, isEmpty, viewDefinitions, provider: "mysql" };
 }
-function buildColumn(table, c, pkSet) {
+function buildColumn(namespace, table, c, pkSet) {
     // `column_type` carries width/unsigned/enum-values info (e.g. `enum('a','b')`,
     // `int(10) unsigned`); `data_type` is the bare type. Prefer `column_type` for
     // accuracy in the NL→SQL prompt, fall back to `data_type`.
     const dataType = c.column_type ?? c.data_type;
     return {
-        id: makeColumnId(NAMESPACE, table, c.column_name),
+        id: makeColumnId(namespace, table, c.column_name),
         name: c.column_name,
         ordinalPosition: c.ordinal_position,
         dataType,
@@ -219,72 +262,44 @@ function buildColumn(table, c, pkSet) {
     };
 }
 function buildUniques(constraints) {
-    const byName = new Map();
-    for (const c of constraints) {
-        if (c.constraint_type !== "UNIQUE")
-            continue;
-        const list = byName.get(c.constraint_name) ?? [];
-        list.push(c);
-        byName.set(c.constraint_name, list);
-    }
-    return Array.from(byName, ([name, list]) => ({
-        name,
-        columns: list
-            .slice()
-            .sort((a, b) => a.ordinal_position - b.ordinal_position)
-            .map((r) => r.column_name),
-    })).sort((a, b) => a.name.localeCompare(b.name));
+    return buildOrderedGroups(constraints.filter((c) => c.constraint_type === "UNIQUE"), (c) => c.constraint_name, (c) => c.ordinal_position, (name, ordered) => ({ name, columns: ordered.map((r) => r.column_name) }));
 }
-function buildForeignKeys(rows) {
-    const byName = new Map();
-    for (const r of rows) {
-        const list = byName.get(r.constraint_name) ?? [];
-        list.push(r);
-        byName.set(r.constraint_name, list);
-    }
-    const fks = [];
-    for (const [name, list] of byName) {
-        const ordered = list.slice().sort((a, b) => a.ordinal_position - b.ordinal_position);
+function buildForeignKeys(rows, input, warnings) {
+    return buildOrderedGroups(rows, (r) => r.constraint_name, (r) => r.ordinal_position, (name, ordered) => {
         const sample = ordered[0];
-        fks.push({
+        const referencedDatabase = sample.referenced_table_schema ?? sample.table_schema;
+        const introspected = input.isIntrospected
+            ? input.isIntrospected(referencedDatabase)
+            : referencedDatabase === sample.table_schema;
+        // A FK into a database that wasn't introspected has no target in the
+        // artifact. Rendering it (e.g. as `public.<table>` in the default mode)
+        // would point at the wrong (or a missing) table — skip it and say so.
+        if (!introspected) {
+            warnings.push({
+                code: "cross_database_fk",
+                table: makeTableId(input.namespaceOf(sample.table_schema), sample.table_name),
+                constraint: name,
+                referencedDatabase,
+                referencedTable: sample.referenced_table_name,
+            });
+            return undefined;
+        }
+        return {
             name,
             columns: ordered.map((r) => r.column_name),
             references: {
-                schema: NAMESPACE,
+                // A FK into another listed database keeps that database as its namespace.
+                schema: input.namespaceOf(referencedDatabase),
                 table: sample.referenced_table_name,
                 columns: ordered.map((r) => r.referenced_column_name),
             },
-            onDelete: mapAction(sample.delete_rule),
-            onUpdate: mapAction(sample.update_rule),
-        });
-    }
-    return fks.sort((a, b) => a.name.localeCompare(b.name));
-}
-function mapAction(rule) {
-    if (!rule)
-        return undefined;
-    const r = rule.toLowerCase();
-    if (r === "cascade")
-        return "cascade";
-    if (r === "restrict")
-        return "restrict";
-    if (r === "set null")
-        return "set null";
-    if (r === "set default")
-        return "set default";
-    if (r === "no action")
-        return "no action";
-    return undefined;
+            onDelete: mapFkAction(sample.delete_rule),
+            onUpdate: mapFkAction(sample.update_rule),
+        };
+    });
 }
 function buildIndexes(rows) {
-    const byName = new Map();
-    for (const r of rows) {
-        const list = byName.get(r.index_name) ?? [];
-        list.push(r);
-        byName.set(r.index_name, list);
-    }
-    return Array.from(byName, ([name, list]) => {
-        const ordered = list.slice().sort((a, b) => a.seq_in_index - b.seq_in_index);
+    return buildOrderedGroups(rows, (r) => r.index_name, (r) => r.seq_in_index, (name, ordered) => {
         const sample = ordered[0];
         return {
             name,
@@ -292,19 +307,6 @@ function buildIndexes(rows) {
             unique: sample.non_unique === 0,
             method: sample.index_type,
         };
-    }).sort((a, b) => a.name.localeCompare(b.name));
-}
-function groupBy(rows, key) {
-    const out = new Map();
-    for (const row of rows) {
-        const k = key(row);
-        const list = out.get(k) ?? [];
-        list.push(row);
-        out.set(k, list);
-    }
-    return out;
-}
-function byName(a, b) {
-    return a.name.localeCompare(b.name);
+    });
 }
 //# sourceMappingURL=describe.js.map

package/dist/connector/describe.js.map

@@ -1 +1 @@
-{"version":3,"file":"describe.js","sourceRoot":"","sources":["../../src/connector/describe.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAErD;;;;;GAKG;AACH,MAAM,SAAS,GAAG,QAAQ,CAAC;AAS3B,4EAA4E;AAC5E,iFAAiF;AACjF,oDAAoD;AACpD,MAAM,UAAU,GAAG;;;;;;;oBAOC,CAAC;AAErB,MAAM,WAAW,GAAG;;;;;;;;;;;;;sCAakB,CAAC;AAEvC,MAAM,eAAe,GAAG;;;;;;;;;;;;;iEAayC,CAAC;AAElE,MAAM,gBAAgB,GAAG;;;;;;;;;;;;;;;mEAe0C,CAAC;AAEpE,MAAM,WAAW,GAAG;;;;;;;;;;8CAU0B,CAAC;AAE/C,MAAM,SAAS,GAAG;;;;;oBAKE,CAAC;AAErB,2EAA2E;AAC3E,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,MAAM,EAAE,UAAU;IAClB,OAAO,EAAE,WAAW;IACpB,WAAW,EAAE,eAAe;IAC5B,YAAY,EAAE,gBAAgB;IAC9B,OAAO,EAAE,WAAW;IACpB,KAAK,EAAE,SAAS;CACR,CAAC;AAiDX,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,KAAyB;IAC3D,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;IAC5B,MAAM,WAAW,GAAG,mBAAmB,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAE/D,MAAM,GAAG,GAAG,KAAK,EAAK,GAAW,EAAgB,EAAE;QACjD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,CAAC;QACjC,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QACxC,MAAM,GAAG,GAAG,IAAI,GAAG,EAAkB,CAAC;QACtC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE;YAAE,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAE,EAAE,CAAC,CAAC,CAAC;QAC/E,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;YAC7B,MAAM,MAAM,GAA4B,EAAE,CAAC;YAC3C,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,GAAG;gBAAE,MAAM,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;YACnD,OAAO,MAAW,CAAC;QACrB,CAAC,CAAC,CAAC;IACL,CAAC,CAAC;IAEF,MAAM,CAAC,SAAS,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QAC7F,GAAG,CAAW,UAAU,CAAC;QACzB,GAAG,CAAY,WAAW,CAAC;QAC3B,GAAG,CAAgB,eAAe,CAAC;QACnC,GAAG,CAAgB,gBAAgB,CAAC;QACpC,GAAG,CAAW,WAAW,CAAC;QAC1B,GAAG,CAAU,SAAS,CAAC;KACxB,CAAC,CAAC;IAEH,OAAO,eAAe,CAAC;QACrB,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,cAAc;QAC1C,WAAW;QACX,SAAS;QACT,UAAU;QACV,cAAc;QACd,MAAM;QACN,SAAS;QACT,QAAQ;QACR,eAAe,EAAE,KAAK,CAAC,OAAO,EAAE,MAAM,IAAI,EAAE;KAC7C,CAAC,CAAC;AACL,CAAC;AAcD,MAAM,UAAU,eAAe,CAAC,KAAgB;IAC9C,MAAM,QAAQ,GAA2B,EAAE,CAAC;IAE5C,MAAM,cAAc,GAAG,OAAO,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;IACtE,MAAM,kBAAkB,GAAG,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;IAC9E,MAAM,UAAU,GAAG,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;IAC9D,MAAM,cAAc,GAAG,OAAO,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;IACrE,MAAM,aAAa,GAAG,IAAI,GAAG,EAAkB,CAAC;IAChD,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;QAC/B,IAAI,CAAC,CAAC,eAAe;YAAE,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC,eAAe,CAAC,CAAC;IAC5E,CAAC;IAED,MAAM,MAAM,GAAe,EAAE,CAAC;IAC9B,MAAM,KAAK,GAAc,EAAE,CAAC;IAC5B,MAAM,eAAe,GAA2B,EAAE,CAAC;IAEnD,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;QAChC,MAAM,SAAS,GAAG,GAAG,SAAS,IAAI,CAAC,CAAC,UAAU,EAAE,CAAC;QACjD,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,SAAS,CAAC;YAAE,SAAS;QAE5C,MAAM,IAAI,GAAG,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC;aAClD,KAAK,EAAE;aACP,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,gBAAgB,GAAG,CAAC,CAAC,gBAAgB,CAAC,CAAC;QAE3D,MAAM,WAAW,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC;QAC/D,MAAM,MAAM,GAAG,WAAW;aACvB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,eAAe,KAAK,aAAa,CAAC;aAClD,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,gBAAgB,GAAG,CAAC,CAAC,gBAAgB,CAAC,CAAC;QAC3D,MAAM,SAAS,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;QACnD,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,CAAC;QAEjC,MAAM,OAAO,GAAgB,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;QAElF,IAAI,CAAC,CAAC,UAAU,KAAK,MAAM,EAAE,CAAC;YAC5B,MAAM,GAAG,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC;YAClD,MAAM,IAAI,GAAY;gBACpB,MAAM,EAAE,SAAS;gBACjB,IAAI,EAAE,CAAC,CAAC,UAAU;gBAClB,UAAU,EAAE,GAAG;gBACf,OAAO;aACR,CAAC;YACF,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACjB,eAAe,CAAC,WAAW,CAAC,SAAS,EAAE,CAAC,CAAC,UAAU,CAAC,CAAC,GAAG,GAAG,CAAC;YAC5D,SAAS;QACX,CAAC;QAED,MAAM,CAAC,IAAI,CAAC;YACV,EAAE,EAAE,WAAW,CAAC,SAAS,EAAE,CAAC,CAAC,UAAU,CAAC;YACxC,MAAM,EAAE,SAAS;YACjB,IAAI,EAAE,CAAC,CAAC,UAAU;YAClB,OAAO,EAAE,CAAC,CAAC,aAAa,IAAI,SAAS;YACrC,OAAO;YACP,UAAU,EAAE,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,SAAS;YACrE,WAAW,EAAE,gBAAgB,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC;YACjE,iBAAiB,EAAE,YAAY,CAAC,WAAW,CAAC;YAC5C,OAAO,EAAE,YAAY,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC;YAC7D,gBAAgB,EAAE,EAAE;SACrB,CAAC,CAAC;IACL,CAAC;IAED,iCAAiC;IACjC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACpB,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAEnB,MAAM,SAAS,GAAiB;QAC9B,IAAI,EAAE,SAAS;QACf,MAAM;QACN,KAAK;QACL,KAAK,EAAE,EAAE;QACT,SAAS,EAAE,EAAE;KACd,CAAC;IAEF,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC;IAC1D,KAAK,MAAM,OAAO,IAAI,KAAK,CAAC,eAAe,EAAE,CAAC;QAC5C,MAAM,OAAO,GACX,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,mBAAmB,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,SAAS,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;YAC5E,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,mBAAmB,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,SAAS,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QAC9E,IAAI,CAAC,OAAO;YAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,kBAAkB,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;IAC7E,CAAC;IAED,MAAM,MAAM,GAAc;QACxB,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;KACpC,CAAC;IACF,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;AAC3E,CAAC;AAED,SAAS,WAAW,CAAC,KAAa,EAAE,CAAY,EAAE,KAAkB;IAClE,+EAA+E;IAC/E,8EAA8E;IAC9E,2DAA2D;IAC3D,MAAM,QAAQ,GAAG,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC,SAAS,CAAC;IAC9C,OAAO;QACL,EAAE,EAAE,YAAY,CAAC,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC,WAAW,CAAC;QACjD,IAAI,EAAE,CAAC,CAAC,WAAW;QACnB,eAAe,EAAE,CAAC,CAAC,gBAAgB;QACnC,QAAQ;QACR,OAAO,EAAE,CAAC,CAAC,SAAS;QACpB,QAAQ,EAAE,CAAC,CAAC,WAAW,KAAK,KAAK;QACjC,UAAU,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,UAAU,KAAK,KAAK;QAC9D,iBAAiB,EAAE,CAAC,CAAC,cAAc,IAAI,SAAS;QAChD,OAAO,EAAE,CAAC,CAAC,cAAc,IAAI,SAAS;KACvC,CAAC;AACJ,CAAC;AAED,SAAS,YAAY,CAAC,WAA4B;IAChD,MAAM,MAAM,GAAG,IAAI,GAAG,EAA2B,CAAC;IAClD,KAAK,MAAM,CAAC,IAAI,WAAW,EAAE,CAAC;QAC5B,IAAI,CAAC,CAAC,eAAe,KAAK,QAAQ;YAAE,SAAS;QAC7C,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,eAAe,CAAC,IAAI,EAAE,CAAC;QACjD,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACb,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,eAAe,EAAE,IAAI,CAAC,CAAC;IACtC,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;QAC3C,IAAI;QACJ,OAAO,EAAE,IAAI;aACV,KAAK,EAAE;aACP,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,gBAAgB,GAAG,CAAC,CAAC,gBAAgB,CAAC;aACvD,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC;KAC7B,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;AACnD,CAAC;AAED,SAAS,gBAAgB,CAAC,IAAqB;IAC7C,MAAM,MAAM,GAAG,IAAI,GAAG,EAA2B,CAAC;IAClD,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;QACrB,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,eAAe,CAAC,IAAI,EAAE,CAAC;QACjD,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACb,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,eAAe,EAAE,IAAI,CAAC,CAAC;IACtC,CAAC;IACD,MAAM,GAAG,GAAoB,EAAE,CAAC;IAChC,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,MAAM,EAAE,CAAC;QAClC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,gBAAgB,GAAG,CAAC,CAAC,gBAAgB,CAAC,CAAC;QACrF,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,CAAE,CAAC;QAC3B,GAAG,CAAC,IAAI,CAAC;YACP,IAAI;YACJ,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC;YAC1C,UAAU,EAAE;gBACV,MAAM,EAAE,SAAS;gBACjB,KAAK,EAAE,MAAM,CAAC,qBAAqB;gBACnC,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,sBAAsB,CAAC;aACtD;YACD,QAAQ,EAAE,SAAS,CAAC,MAAM,CAAC,WAAW,CAAC;YACvC,QAAQ,EAAE,SAAS,CAAC,MAAM,CAAC,WAAW,CAAC;SACxC,CAAC,CAAC;IACL,CAAC;IACD,OAAO,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;AAC1D,CAAC;AAED,SAAS,SAAS,CAAC,IAAmB;IACpC,IAAI,CAAC,IAAI;QAAE,OAAO,SAAS,CAAC;IAC5B,MAAM,CAAC,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IAC7B,IAAI,CAAC,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IACtC,IAAI,CAAC,KAAK,UAAU;QAAE,OAAO,UAAU,CAAC;IACxC,IAAI,CAAC,KAAK,UAAU;QAAE,OAAO,UAAU,CAAC;IACxC,IAAI,CAAC,KAAK,aAAa;QAAE,OAAO,aAAa,CAAC;IAC9C,IAAI,CAAC,KAAK,WAAW;QAAE,OAAO,WAAW,CAAC;IAC1C,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,YAAY,CAAC,IAAgB;IACpC,MAAM,MAAM,GAAG,IAAI,GAAG,EAAsB,CAAC;IAC7C,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;QACrB,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC;QAC5C,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACb,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;IACjC,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE;QACzC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,GAAG,CAAC,CAAC,YAAY,CAAC,CAAC;QAC7E,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,CAAE,CAAC;QAC3B,OAAO;YACL,IAAI;YACJ,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,IAAI,EAAE,CAAC;YAChD,MAAM,EAAE,MAAM,CAAC,UAAU,KAAK,CAAC;YAC/B,MAAM,EAAE,MAAM,CAAC,UAAU;SACP,CAAC;IACvB,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;AAClD,CAAC;AAED,SAAS,OAAO,CAAO,IAAS,EAAE,GAAkB;IAClD,MAAM,GAAG,GAAG,IAAI,GAAG,EAAU,CAAC;IAC9B,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;QACnB,MAAM,IAAI,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC9B,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACf,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;IACnB,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,MAAM,CAA6B,CAAI,EAAE,CAAI;IACpD,OAAO,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;AACtC,CAAC"}
+{"version":3,"file":"describe.js","sourceRoot":"","sources":["../../src/connector/describe.ts"],"names":[],"mappings":"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"}

package/dist/connector/provider.d.ts

@@ -0,0 +1,2 @@
+export declare const mysqlConnectorProvider: import("@askdb/introspect").ConnectorProviderAdapter;
+//# sourceMappingURL=provider.d.ts.map

package/dist/connector/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../src/connector/provider.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,sBAAsB,sDAcjC,CAAC"}

package/dist/connector/provider.js

@@ -0,0 +1,19 @@
+import { defineLiveConnectorProvider } from "@askdb/introspect/kit";
+import { createMysqlConnector } from "./index.js";
+import { createMysqlCatalogQueryRunner } from "../exec/mysql.js";
+import { parseMysqlConnection } from "../label.js";
+export const mysqlConnectorProvider = defineLiveConnectorProvider({
+    provider: "mysql",
+    displayName: "MySQL",
+    runtimeKey: "mysqlDatabaseUrl",
+    connectionNoun: "a connection URL",
+    missingConnection: {
+        cli: "Provide --url <mysql-url> (or set introspection.providerConfig.mysql.databaseUrl / ASKDB_INTROSPECT_MYSQL_URL / DATABASE_URL).",
+        config: "No MySQL connection configured. Set introspection.providerConfig.mysql.databaseUrl in askdb.config.ts (bound to an env var in .env).",
+    },
+    fromExportUnsupported: "--from-export is currently supported only for --engine postgres (got mysql).",
+    createConnector: createMysqlConnector,
+    createRunner: (url) => createMysqlCatalogQueryRunner(url),
+    connectionLabelParts: parseMysqlConnection,
+});
+//# sourceMappingURL=provider.js.map

package/dist/connector/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../../src/connector/provider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,2BAA2B,EAAE,MAAM,uBAAuB,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAE,6BAA6B,EAAE,MAAM,kBAAkB,CAAC;AACjE,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAEnD,MAAM,CAAC,MAAM,sBAAsB,GAAG,2BAA2B,CAAC;IAChE,QAAQ,EAAE,OAAO;IACjB,WAAW,EAAE,OAAO;IACpB,UAAU,EAAE,kBAAkB;IAC9B,cAAc,EAAE,kBAAkB;IAClC,iBAAiB,EAAE;QACjB,GAAG,EAAE,gIAAgI;QACrI,MAAM,EACJ,sIAAsI;KACzI;IACD,qBAAqB,EAAE,8EAA8E;IACrG,eAAe,EAAE,oBAAoB;IACrC,YAAY,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,6BAA6B,CAAC,GAAG,CAAC;IACzD,oBAAoB,EAAE,oBAAoB;CAC3C,CAAC,CAAC"}

package/dist/exec/mysql.d.ts

@@ -1,12 +1,18 @@
 import type { CatalogQueryRunner } from "@askdb/introspect";
+import { type DriverLoadOptions } from "@askdb/introspect/kit";
 export type { CatalogQueryResult, CatalogQueryRunner } from "@askdb/introspect";
-/** @internal exposed for tests that need to reset the lazy `mysql2` cache. */
-export declare function __resetMysql2ModuleCacheForTests(): void;
+type Mysql2DriverModule = typeof import("mysql2/promise");
+/**
+ * Resolve and cache the optional `mysql2` peer driver, with the same lazy-import
+ * + project-root fallback behavior as the catalog runner.
+ */
+export declare function loadMysql2Driver(options?: DriverLoadOptions): Promise<Mysql2DriverModule>;
+export declare function isMysql2DriverInstalled(options?: DriverLoadOptions): boolean;
 /**
  * Build the built-in `mysql2`-backed catalog query runner used by live MySQL
  * introspection. The connection string follows the standard MySQL URI form
  * (`mysql://user:pass@host:port/database`); the named database is the target
  * namespace for introspection.
  */
-export declare function createMysqlCatalogQueryRunner(connectionString: string): CatalogQueryRunner;
+export declare function createMysqlCatalogQueryRunner(connectionString: string, options?: DriverLoadOptions): CatalogQueryRunner;
 //# sourceMappingURL=mysql.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"mysql.d.ts","sourceRoot":"","sources":["../../src/exec/mysql.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAsB,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAEhF,YAAY,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAuBhF,8EAA8E;AAC9E,wBAAgB,gCAAgC,IAAI,IAAI,CAEvD;AA8BD;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAAC,gBAAgB,EAAE,MAAM,GAAG,kBAAkB,CAE1F"}
+{"version":3,"file":"mysql.d.ts","sourceRoot":"","sources":["../../src/exec/mysql.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAsB,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAChF,OAAO,EAKL,KAAK,iBAAiB,EACvB,MAAM,uBAAuB,CAAC;AAE/B,YAAY,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAchF,KAAK,kBAAkB,GAAG,cAAc,gBAAgB,CAAC,CAAC;AAE1D;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAG/F;AAED,wBAAgB,uBAAuB,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAE5E;AA+BD;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAC3C,gBAAgB,EAAE,MAAM,EACxB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,kBAAkB,CAEpB"}

package/dist/exec/mysql.js

@@ -1,26 +1,29 @@
 import { AskDbError } from "@askdb/core";
+import { createOptionalDriverLoader, rethrowDriverImportError, isDriverInstalled, missingDriverMessage, } from "@askdb/introspect/kit";
 /**
  * Lazily resolve the optional `mysql2` peer dependency. Mirrors the pattern in
  * `@askdb/postgres` so consumers with a custom `CatalogQueryRunner` can use
  * `@askdb/mysql` without installing `mysql2`.
  */
-let mysql2ModulePromise;
-async function loadMysql2OrThrow() {
-    if (!mysql2ModulePromise) {
-        mysql2ModulePromise = import("mysql2/promise").catch((cause) => {
-            mysql2ModulePromise = undefined;
-            throw new AskDbError("The built-in MySQL catalog query runner requires the optional `mysql2` peer dependency. " +
-                "Install it (e.g. `pnpm add mysql2`) or pass a custom catalog query runner to the MySQL connector.", cause);
-        });
-    }
-    return mysql2ModulePromise;
+const mysql2Loader = createOptionalDriverLoader({
+    packageName: "mysql2",
+    specifier: "mysql2/promise",
+    importDriver: () => import("mysql2/promise").catch(rethrowDriverImportError),
+    missingMessage: missingDriverMessage({ engine: "MySQL", packageName: "mysql2" }),
+});
+/**
+ * Resolve and cache the optional `mysql2` peer driver, with the same lazy-import
+ * + project-root fallback behavior as the catalog runner.
+ */
+export async function loadMysql2Driver(options) {
+    const mod = await mysql2Loader.load(options);
+    return mod.default ?? mod;
 }
-/** @internal exposed for tests that need to reset the lazy `mysql2` cache. */
-export function __resetMysql2ModuleCacheForTests() {
-    mysql2ModulePromise = undefined;
+export function isMysql2DriverInstalled(options) {
+    return isDriverInstalled("mysql2", options);
 }
-async function runMysqlCatalogQuery(connectionString, sql, params) {
-    const mod = await loadMysql2OrThrow();
+async function runMysqlCatalogQuery(connectionString, sql, params, options) {
+    const mod = await mysql2Loader.load(options);
     const mysql = mod.default ?? mod;
     const connection = await mysql.createConnection(connectionString);
     try {
@@ -48,7 +51,7 @@ async function runMysqlCatalogQuery(connectionString, sql, params) {
  * (`mysql://user:pass@host:port/database`); the named database is the target
  * namespace for introspection.
  */
-export function createMysqlCatalogQueryRunner(connectionString) {
-    return (sql, params) => runMysqlCatalogQuery(connectionString, sql, params);
+export function createMysqlCatalogQueryRunner(connectionString, options) {
+    return (sql, params) => runMysqlCatalogQuery(connectionString, sql, params, options);
 }
 //# sourceMappingURL=mysql.js.map

package/dist/exec/mysql.js.map

@@ -1 +1 @@
-{"version":3,"file":"mysql.js","sourceRoot":"","sources":["../../src/exec/mysql.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAKzC;;;;GAIG;AACH,IAAI,mBAAyE,CAAC;AAE9E,KAAK,UAAU,iBAAiB;IAC9B,IAAI,CAAC,mBAAmB,EAAE,CAAC;QACzB,mBAAmB,GAAG,MAAM,CAAC,gBAAgB,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;YAC7D,mBAAmB,GAAG,SAAS,CAAC;YAChC,MAAM,IAAI,UAAU,CAClB,0FAA0F;gBACxF,mGAAmG,EACrG,KAAK,CACN,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC;IACD,OAAO,mBAAmB,CAAC;AAC7B,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,gCAAgC;IAC9C,mBAAmB,GAAG,SAAS,CAAC;AAClC,CAAC;AAED,KAAK,UAAU,oBAAoB,CACjC,gBAAwB,EACxB,GAAW,EACX,MAA+B;IAE/B,MAAM,GAAG,GAAG,MAAM,iBAAiB,EAAE,CAAC;IACtC,MAAM,KAAK,GAAI,GAA2C,CAAC,OAAO,IAAI,GAAG,CAAC;IAC1E,MAAM,UAAU,GAAG,MAAM,KAAK,CAAC,gBAAgB,CAAC,gBAAgB,CAAC,CAAC;IAClE,IAAI,CAAC;QACH,0EAA0E;QAC1E,wEAAwE;QACxE,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,UAAU,CAAC,KAAK,CAC5C,GAAG,EACH,MAAM,CAAC,CAAC,CAAE,MAAoB,CAAC,CAAC,CAAC,SAAS,CAC3C,CAA8D,CAAC;QAChE,MAAM,OAAO,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAClD,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QAChD,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC;QACtE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IACjC,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,IAAI,CAAC,YAAY,UAAU;YAAE,MAAM,CAAC,CAAC;QACrC,MAAM,OAAO,GAAG,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QAC3D,MAAM,IAAI,UAAU,CAAC,+BAA+B,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;IACpE,CAAC;YAAS,CAAC;QACT,MAAM,UAAU,CAAC,GAAG,EAAE,CAAC;IACzB,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,6BAA6B,CAAC,gBAAwB;IACpE,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,CAAC,oBAAoB,CAAC,gBAAgB,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;AAC9E,CAAC"}
+{"version":3,"file":"mysql.js","sourceRoot":"","sources":["../../src/exec/mysql.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -7,5 +7,6 @@
  */
 export { MYSQL_DIALECT, MARIADB_DIALECT, type DialectSpec as MysqlDialect, } from "@askdb/core";
 export { createMysqlConnector, describeMysql, MYSQL_CATALOG_SQL, type DescribeMysqlInput, type MysqlIntrospectionInput, } from "./connector/index.js";
-export { createMysqlCatalogQueryRunner, type CatalogQueryResult, type CatalogQueryRunner, } from "./exec/mysql.js";
+export { createMysqlCatalogQueryRunner, loadMysql2Driver, isMysql2DriverInstalled, type CatalogQueryResult, type CatalogQueryRunner, } from "./exec/mysql.js";
+export { mysqlConnectorProvider } from "./connector/provider.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,aAAa,EACb,eAAe,EACf,KAAK,WAAW,IAAI,YAAY,GACjC,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,oBAAoB,EACpB,aAAa,EACb,iBAAiB,EACjB,KAAK,kBAAkB,EACvB,KAAK,uBAAuB,GAC7B,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,6BAA6B,EAC7B,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,GACxB,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,aAAa,EACb,eAAe,EACf,KAAK,WAAW,IAAI,YAAY,GACjC,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,oBAAoB,EACpB,aAAa,EACb,iBAAiB,EACjB,KAAK,kBAAkB,EACvB,KAAK,uBAAuB,GAC7B,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,6BAA6B,EAC7B,gBAAgB,EAChB,uBAAuB,EACvB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,GACxB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/index.js

@@ -7,5 +7,6 @@
  */
 export { MYSQL_DIALECT, MARIADB_DIALECT, } from "@askdb/core";
 export { createMysqlConnector, describeMysql, MYSQL_CATALOG_SQL, } from "./connector/index.js";
-export { createMysqlCatalogQueryRunner, } from "./exec/mysql.js";
+export { createMysqlCatalogQueryRunner, loadMysql2Driver, isMysql2DriverInstalled, } from "./exec/mysql.js";
+export { mysqlConnectorProvider } from "./connector/provider.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,aAAa,EACb,eAAe,GAEhB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,oBAAoB,EACpB,aAAa,EACb,iBAAiB,GAGlB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,6BAA6B,GAG9B,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,aAAa,EACb,eAAe,GAEhB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,oBAAoB,EACpB,aAAa,EACb,iBAAiB,GAGlB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,6BAA6B,EAC7B,gBAAgB,EAChB,uBAAuB,GAGxB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/label.d.ts

@@ -0,0 +1,17 @@
+import type { ConnectionLabelParts } from "@askdb/introspect/kit";
+/**
+ * The display-safe parts of a MySQL connection string, read the way `mysql2`
+ * reads it: `ConnectionConfig.parseUrl` is WHATWG `new URL(url)` with
+ * `host = decodeURIComponent(hostname)`, `port = port`, and
+ * `database = decodeURIComponent(pathname.slice(1))`. `mysql2` itself isn't a
+ * dependency here (it is ~630 KB with seven dependencies, and an optional
+ * peer), so this uses the same built-in parser and mapping; a differential test
+ * checks it against `mysql2`'s own `parseUrl` (ADR 0011).
+ *
+ * Returns `undefined` (the registry labels it `configured mysql connection`)
+ * when `new URL` throws, when the scheme isn't `mysql:`, or when an `@` or `#`
+ * sits after the host: a password containing `/`, `?` or `#` is split there.
+ * `formatConnectionLabel`'s allowlist is the second check.
+ */
+export declare function parseMysqlConnection(input: string): ConnectionLabelParts | undefined;
+//# sourceMappingURL=label.d.ts.map

package/dist/label.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"label.d.ts","sourceRoot":"","sources":["../src/label.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAElE;;;;;;;;;;;;;GAaG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,oBAAoB,GAAG,SAAS,CAkBpF"}

package/dist/label.js

@@ -0,0 +1,37 @@
+/**
+ * The display-safe parts of a MySQL connection string, read the way `mysql2`
+ * reads it: `ConnectionConfig.parseUrl` is WHATWG `new URL(url)` with
+ * `host = decodeURIComponent(hostname)`, `port = port`, and
+ * `database = decodeURIComponent(pathname.slice(1))`. `mysql2` itself isn't a
+ * dependency here (it is ~630 KB with seven dependencies, and an optional
+ * peer), so this uses the same built-in parser and mapping; a differential test
+ * checks it against `mysql2`'s own `parseUrl` (ADR 0011).
+ *
+ * Returns `undefined` (the registry labels it `configured mysql connection`)
+ * when `new URL` throws, when the scheme isn't `mysql:`, or when an `@` or `#`
+ * sits after the host: a password containing `/`, `?` or `#` is split there.
+ * `formatConnectionLabel`'s allowlist is the second check.
+ */
+export function parseMysqlConnection(input) {
+    let url;
+    let host;
+    let database;
+    try {
+        url = new URL(input);
+        host = decodeURIComponent(url.hostname);
+        database = decodeURIComponent(url.pathname.slice(1));
+    }
+    catch {
+        return undefined;
+    }
+    if (url.protocol !== "mysql:")
+        return undefined;
+    if (url.hash !== "" || `${url.pathname}${url.search}`.includes("@"))
+        return undefined;
+    return {
+        ...(host !== "" ? { host } : {}),
+        ...(url.port !== "" ? { port: url.port } : {}),
+        ...(database !== "" ? { database } : {}),
+    };
+}
+//# sourceMappingURL=label.js.map

package/dist/label.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"label.js","sourceRoot":"","sources":["../src/label.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAa;IAChD,IAAI,GAAQ,CAAC;IACb,IAAI,IAAY,CAAC;IACjB,IAAI,QAAgB,CAAC;IACrB,IAAI,CAAC;QACH,GAAG,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC;QACrB,IAAI,GAAG,kBAAkB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACxC,QAAQ,GAAG,kBAAkB,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACvD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,IAAI,GAAG,CAAC,QAAQ,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IAChD,IAAI,GAAG,CAAC,IAAI,KAAK,EAAE,IAAI,GAAG,GAAG,CAAC,QAAQ,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,SAAS,CAAC;IACtF,OAAO;QACL,GAAG,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAChC,GAAG,CAAC,GAAG,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9C,GAAG,CAAC,QAAQ,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACzC,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@askdb/mysql",
-  "version": "0.1.0-beta.2",
+  "version": "0.1.0-beta.20",
   "description": "AskDB MySQL integration: introspection connector via information_schema and a mysql2-backed catalog query runner. Pairs with @askdb/core's MYSQL_DIALECT.",
   "keywords": [
     "askdb",
@@ -12,7 +12,7 @@
     "introspection",
     "information-schema"
   ],
-  "homepage": "https://github.com/Ygilany/AskDB#readme",
+  "homepage": "https://askdb.tools/guides/switch-engines/",
   "bugs": {
     "url": "https://github.com/Ygilany/AskDB/issues"
   },
@@ -24,12 +24,14 @@
   "license": "Apache-2.0",
   "author": "Yahya Gilany",
   "type": "module",
+  "sideEffects": false,
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
-      "import": "./dist/index.js"
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
     }
   },
   "files": [
@@ -39,11 +41,11 @@
     "NOTICE"
   ],
   "engines": {
-    "node": ">=20"
+    "node": ">=22.23.4"
   },
   "dependencies": {
-    "@askdb/introspect": "0.3.0-beta.3",
-    "@askdb/core": "0.5.0-beta.10"
+    "@askdb/core": "1.0.0-beta.45",
+    "@askdb/introspect": "0.3.0-beta.19"
   },
   "peerDependencies": {
     "mysql2": ">=3"
@@ -54,9 +56,9 @@
     }
   },
   "devDependencies": {
-    "mysql2": "^3.11.5",
-    "typescript": "^5.7.3",
-    "vitest": "^3.0.9"
+    "mysql2": "^3.24.6",
+    "typescript": "^6.0.3",
+    "vitest": "^5.0.5"
   },
   "scripts": {
     "build": "tsc -p tsconfig.build.json",

package/dist/connector/glob.d.ts

@@ -1,3 +0,0 @@
-export type GlobMatcher = (qualifiedName: string) => boolean;
-export declare function compileTableFilters(patterns: ReadonlyArray<string> | undefined): GlobMatcher;
-//# sourceMappingURL=glob.d.ts.map

package/dist/connector/glob.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"glob.d.ts","sourceRoot":"","sources":["../../src/connector/glob.ts"],"names":[],"mappings":"AAiBA,MAAM,MAAM,WAAW,GAAG,CAAC,aAAa,EAAE,MAAM,KAAK,OAAO,CAAC;AAE7D,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,SAAS,GAC1C,WAAW,CAIb"}

package/dist/connector/glob.js

@@ -1,27 +0,0 @@
-/**
- * Minimal glob matcher for `IntrospectionFilters.tables`. Matches against
- * `"<schema>.<name>"` strings; supports `*` (any run) and `?` (single char).
- * Identical to the postgres connector's matcher.
- */
-function compileGlob(pattern) {
-    let out = "^";
-    for (const ch of pattern) {
-        if (ch === "*")
-            out += ".*";
-        else if (ch === "?")
-            out += ".";
-        else if (/[.+^${}()|[\]\\]/.test(ch))
-            out += "\\" + ch;
-        else
-            out += ch;
-    }
-    out += "$";
-    return new RegExp(out);
-}
-export function compileTableFilters(patterns) {
-    if (!patterns || patterns.length === 0)
-        return () => true;
-    const compiled = patterns.map(compileGlob);
-    return (qualifiedName) => compiled.some((re) => re.test(qualifiedName));
-}
-//# sourceMappingURL=glob.js.map

package/dist/connector/glob.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"glob.js","sourceRoot":"","sources":["../../src/connector/glob.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,SAAS,WAAW,CAAC,OAAe;IAClC,IAAI,GAAG,GAAG,GAAG,CAAC;IACd,KAAK,MAAM,EAAE,IAAI,OAAO,EAAE,CAAC;QACzB,IAAI,EAAE,KAAK,GAAG;YAAE,GAAG,IAAI,IAAI,CAAC;aACvB,IAAI,EAAE,KAAK,GAAG;YAAE,GAAG,IAAI,GAAG,CAAC;aAC3B,IAAI,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAAC;YAAE,GAAG,IAAI,IAAI,GAAG,EAAE,CAAC;;YAClD,GAAG,IAAI,EAAE,CAAC;IACjB,CAAC;IACD,GAAG,IAAI,GAAG,CAAC;IACX,OAAO,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC;AACzB,CAAC;AAID,MAAM,UAAU,mBAAmB,CACjC,QAA2C;IAE3C,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC;IAC1D,MAAM,QAAQ,GAAG,QAAQ,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IAC3C,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC;AAC1E,CAAC"}

package/dist/connector/ids.d.ts

@@ -1,9 +0,0 @@
-/**
- * Schema v2 ID conventions — kept aligned with `@askdb/postgres/connector/ids.ts`.
- * MySQL doesn't have Postgres-style schemas, but to keep IDs stable and
- * cross-engine queryable we always use the namespace `"public"` (the same
- * convention `@askdb/prisma` uses for MySQL).
- */
-export declare function makeTableId(schemaName: string, tableName: string): string;
-export declare function makeColumnId(schemaName: string, tableName: string, columnName: string): string;
-//# sourceMappingURL=ids.d.ts.map

package/dist/connector/ids.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ids.d.ts","sourceRoot":"","sources":["../../src/connector/ids.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAEzE;AAED,wBAAgB,YAAY,CAC1B,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,GACjB,MAAM,CAER"}

package/dist/connector/ids.js

@@ -1,13 +0,0 @@
-/**
- * Schema v2 ID conventions — kept aligned with `@askdb/postgres/connector/ids.ts`.
- * MySQL doesn't have Postgres-style schemas, but to keep IDs stable and
- * cross-engine queryable we always use the namespace `"public"` (the same
- * convention `@askdb/prisma` uses for MySQL).
- */
-export function makeTableId(schemaName, tableName) {
-    return `table:${schemaName}.${tableName}`;
-}
-export function makeColumnId(schemaName, tableName, columnName) {
-    return `table:${schemaName}.${tableName}#${columnName}`;
-}
-//# sourceMappingURL=ids.js.map

package/dist/connector/ids.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ids.js","sourceRoot":"","sources":["../../src/connector/ids.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,UAAkB,EAAE,SAAiB;IAC/D,OAAO,SAAS,UAAU,IAAI,SAAS,EAAE,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,YAAY,CAC1B,UAAkB,EAClB,SAAiB,EACjB,UAAkB;IAElB,OAAO,SAAS,UAAU,IAAI,SAAS,IAAI,UAAU,EAAE,CAAC;AAC1D,CAAC"}