@askdb/mysql 0.1.0-beta.1

package/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for describing the origin of the Work and
+      reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may accept and charge a
+      fee for, the acceptance of support, warranty, indemnity, or
+      other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright 2026 Yahya Gilany
+
+   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
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+   implied. See the License for the specific language governing
+   permissions and limitations under the License.

package/README.md

@@ -0,0 +1,60 @@
+# `@askdb/mysql`
+
+MySQL / MariaDB integration for AskDB. Bundles three pieces:
+
+1. **Dialect** — re-exports `MYSQL_DIALECT` and `MARIADB_DIALECT` from `@askdb/core`. Pass `dialect: MYSQL_DIALECT` (or `MARIADB_DIALECT`) to `ask()` to target MySQL or MariaDB.
+2. **Connector** — `createMysqlConnector()` implements the `Connector` contract from `@askdb/introspect` for live introspection mode.
+3. **Catalog runner** — `createMysqlCatalogQueryRunner(connectionString)` returns an introspection-only `CatalogQueryRunner` backed by `mysql2` (peer dependency, lazy-loaded).
+
+## Install
+
+```bash
+pnpm add @askdb/core @askdb/introspect @askdb/mysql
+```
+
+`mysql2` is an **optional peer dependency** — install it only when using live introspection mode:
+
+```bash
+pnpm add mysql2
+```
+
+## Usage
+
+### NL→SQL
+
+```ts
+import { ask, loadSchema } from "@askdb/core";
+import { MYSQL_DIALECT } from "@askdb/mysql";
+
+const schema = loadSchema("./my-app.schema");
+
+const { sql } = await ask({
+  question: "How many paid orders were created last month?",
+  schema,
+  model,
+  dialect: MYSQL_DIALECT,
+});
+```
+
+Use `MARIADB_DIALECT` instead when your runtime engine is MariaDB.
+
+### Introspection
+
+```ts
+import { introspect } from "@askdb/introspect";
+import { createMysqlConnector, createMysqlCatalogQueryRunner } from "@askdb/mysql";
+
+const result = await introspect(
+  { mode: "live", runner: createMysqlCatalogQueryRunner(process.env.DATABASE_URL!) },
+  { outDir: "./my-app.schema", schemaId: "my-app" },
+  { connector: createMysqlConnector() },
+);
+```
+
+## Captured metadata
+
+Tables, views, columns (MySQL-native type strings), primary keys, unique constraints, foreign keys (with referential actions), and indexes.
+
+## License
+
+Apache-2.0

package/dist/connector/describe.d.ts

@@ -0,0 +1,78 @@
+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. */
+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;
+};
+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

@@ -0,0 +1 @@
+{"version":3,"file":"describe.d.ts","sourceRoot":"","sources":["../../src/connector/describe.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kBAAkB,EAClB,oBAAoB,EACpB,mBAAmB,EAWpB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAWhD,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;AAgFF,2EAA2E;AAC3E,eAAO,MAAM,iBAAiB;;;;;;;CAOpB,CAAC;AAEX,KAAK,QAAQ,GAAG;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,YAAY,GAAG,MAAM,GAAG,MAAM,CAAC;IAC3C,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B,CAAC;AACF,KAAK,SAAS,GAAG;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,WAAW,EAAE,KAAK,GAAG,IAAI,GAAG,MAAM,CAAC;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,EAAE,GAAG,MAAM,CAAC;IAChD,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B,CAAC;AACF,KAAK,aAAa,GAAG;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,aAAa,GAAG,QAAQ,GAAG,MAAM,CAAC;CACpD,CAAC;AACF,KAAK,aAAa,GAAG;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,sBAAsB,EAAE,MAAM,CAAC;IAC/B,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B,CAAC;AACF,KAAK,QAAQ,GAAG;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AACF,KAAK,OAAO,GAAG;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC,CAAC;AAEF,wBAAsB,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAoC3F;AAED,KAAK,SAAS,GAAG;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC;IACpD,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,UAAU,EAAE,SAAS,EAAE,CAAC;IACxB,cAAc,EAAE,aAAa,EAAE,CAAC;IAChC,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,eAAe,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CACxC,CAAC;AAEF,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,GAAG,mBAAmB,CAqFrE"}

package/dist/connector/describe.js

@@ -0,0 +1,310 @@
+import { compileTableFilters } from "./glob.js";
+import { makeColumnId, makeTableId } from "./ids.js";
+/**
+ * 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.
+ */
+const NAMESPACE = "public";
+// 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
+  table_name AS table_name,
+  table_type AS table_type,
+  table_comment AS table_comment
+FROM information_schema.tables
+WHERE table_schema = DATABASE()
+  AND table_type IN ('BASE TABLE', 'VIEW')
+ORDER BY table_name`;
+const SQL_COLUMNS = `SELECT
+  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 table_schema = DATABASE()
+ORDER BY table_name, ordinal_position`;
+const SQL_CONSTRAINTS = `SELECT
+  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_name = tc.table_name
+WHERE tc.table_schema = DATABASE()
+  AND tc.constraint_type IN ('PRIMARY KEY', 'UNIQUE')
+ORDER BY tc.table_name, tc.constraint_name, kcu.ordinal_position`;
+const SQL_FOREIGN_KEYS = `SELECT
+  kcu.constraint_name AS constraint_name,
+  kcu.table_name AS table_name,
+  kcu.column_name AS column_name,
+  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 kcu.table_schema = DATABASE()
+  AND kcu.referenced_table_name IS NOT NULL
+ORDER BY kcu.table_name, kcu.constraint_name, kcu.ordinal_position`;
+const SQL_INDEXES = `SELECT
+  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 table_schema = DATABASE()
+  AND index_name <> 'PRIMARY'
+ORDER BY table_name, index_name, seq_in_index`;
+const SQL_VIEWS = `SELECT
+  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. */
+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,
+};
+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)
+            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;
+        });
+    };
+    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),
+    ]);
+    return foldMysqlResult({
+        schemaId: input.schemaId ?? "introspected",
+        tableFilter,
+        tableRows,
+        columnRows,
+        constraintRows,
+        fkRows,
+        indexRows,
+        viewRows,
+        declaredFilters: input.filters?.tables ?? [],
+    });
+}
+export 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();
+    for (const v of input.viewRows) {
+        if (v.view_definition)
+            viewDefByName.set(v.table_name, v.view_definition);
+    }
+    const tables = [];
+    const views = [];
+    const viewDefinitions = {};
+    for (const t of input.tableRows) {
+        const qualified = `${NAMESPACE}.${t.table_name}`;
+        if (!input.tableFilter(qualified))
+            continue;
+        const cols = (columnsByTable.get(t.table_name) ?? [])
+            .slice()
+            .sort((a, b) => a.ordinal_position - b.ordinal_position);
+        const constraints = constraintsByTable.get(t.table_name) ?? [];
+        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));
+        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;
+            continue;
+        }
+        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) ?? []),
+            uniqueConstraints: buildUniques(constraints),
+            indexes: buildIndexes(indexesByTable.get(t.table_name) ?? []),
+            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 schema = {
+        schemaId: input.schemaId,
+        schemas: isEmpty ? [] : [namespace],
+    };
+    return { schema, warnings, isEmpty, viewDefinitions, provider: "mysql" };
+}
+function buildColumn(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),
+        name: c.column_name,
+        ordinalPosition: c.ordinal_position,
+        dataType,
+        udtName: c.data_type,
+        nullable: c.is_nullable === "YES",
+        primaryKey: pkSet.has(c.column_name) || c.column_key === "PRI",
+        defaultExpression: c.column_default ?? undefined,
+        comment: c.column_comment || undefined,
+    };
+}
+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));
+}
+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);
+        const sample = ordered[0];
+        fks.push({
+            name,
+            columns: ordered.map((r) => r.column_name),
+            references: {
+                schema: NAMESPACE,
+                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;
+}
+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);
+        const sample = ordered[0];
+        return {
+            name,
+            columns: ordered.map((r) => r.column_name ?? ""),
+            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

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

package/dist/connector/glob.d.ts

@@ -0,0 +1,3 @@
+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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,27 @@
+/**
+ * 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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,9 @@
+/**
+ * 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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,13 @@
+/**
+ * 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

@@ -0,0 +1 @@
+{"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"}

package/dist/connector/index.d.ts

@@ -0,0 +1,15 @@
+import type { CatalogQueryRunner, Connector, IntrospectionFilters } from "@askdb/introspect";
+/**
+ * Connector input for `@askdb/mysql`. Live introspection only — supply a
+ * `CatalogQueryRunner` (e.g. from {@link createMysqlCatalogQueryRunner}).
+ * From-export bundle mode (à la `@askdb/postgres`) is not implemented here yet.
+ */
+export type MysqlIntrospectionInput = {
+    mode: "live";
+    runner: CatalogQueryRunner;
+    filters?: IntrospectionFilters;
+};
+export declare function createMysqlConnector(): Connector<MysqlIntrospectionInput>;
+export { describeMysql, MYSQL_CATALOG_SQL } from "./describe.js";
+export type { DescribeMysqlInput } from "./describe.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/connector/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kBAAkB,EAClB,SAAS,EACT,oBAAoB,EAErB,MAAM,mBAAmB,CAAC;AAG3B;;;;GAIG;AACH,MAAM,MAAM,uBAAuB,GAAG;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,kBAAkB,CAAC;IAC3B,OAAO,CAAC,EAAE,oBAAoB,CAAC;CAChC,CAAC;AAEF,wBAAgB,oBAAoB,IAAI,SAAS,CAAC,uBAAuB,CAAC,CAMzE;AAED,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AACjE,YAAY,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC"}

package/dist/connector/index.js

@@ -0,0 +1,10 @@
+import { describeMysql } from "./describe.js";
+export function createMysqlConnector() {
+    return {
+        async describe(input) {
+            return describeMysql({ runner: input.runner, filters: input.filters });
+        },
+    };
+}
+export { describeMysql, MYSQL_CATALOG_SQL } from "./describe.js";
+//# sourceMappingURL=index.js.map

package/dist/connector/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/connector/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAa9C,MAAM,UAAU,oBAAoB;IAClC,OAAO;QACL,KAAK,CAAC,QAAQ,CAAC,KAA8B;YAC3C,OAAO,aAAa,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QACzE,CAAC;KACF,CAAC;AACJ,CAAC;AAED,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC"}

package/dist/exec/mysql.d.ts

@@ -0,0 +1,12 @@
+import type { CatalogQueryRunner } from "@askdb/introspect";
+export type { CatalogQueryResult, CatalogQueryRunner } from "@askdb/introspect";
+/** @internal exposed for tests that need to reset the lazy `mysql2` cache. */
+export declare function __resetMysql2ModuleCacheForTests(): void;
+/**
+ * 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;
+//# sourceMappingURL=mysql.d.ts.map

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

@@ -0,0 +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"}

package/dist/exec/mysql.js

@@ -0,0 +1,54 @@
+import { AskDbError } from "@askdb/core";
+/**
+ * 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;
+}
+/** @internal exposed for tests that need to reset the lazy `mysql2` cache. */
+export function __resetMysql2ModuleCacheForTests() {
+    mysql2ModulePromise = undefined;
+}
+async function runMysqlCatalogQuery(connectionString, sql, params) {
+    const mod = await loadMysql2OrThrow();
+    const mysql = mod.default ?? mod;
+    const connection = await mysql.createConnection(connectionString);
+    try {
+        // information_schema is read-only by construction; we still force-disable
+        // the multi-statement protocol via mysql2 defaults and don't open a tx.
+        const [rows, fields] = (await connection.query(sql, params ? params : undefined));
+        const columns = (fields ?? []).map((f) => f.name);
+        const rowList = Array.isArray(rows) ? rows : [];
+        const data = rowList.map((row) => columns.map((c) => row[c] ?? null));
+        return { columns, rows: data };
+    }
+    catch (e) {
+        if (e instanceof AskDbError)
+            throw e;
+        const message = e instanceof Error ? e.message : String(e);
+        throw new AskDbError(`MySQL catalog query failed: ${message}`, e);
+    }
+    finally {
+        await connection.end();
+    }
+}
+/**
+ * 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 function createMysqlCatalogQueryRunner(connectionString) {
+    return (sql, params) => runMysqlCatalogQuery(connectionString, sql, params);
+}
+//# sourceMappingURL=mysql.js.map

package/dist/exec/mysql.js.map

@@ -0,0 +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"}

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * `@askdb/mysql` — MySQL/MariaDB integration for AskDB.
+ *
+ * Pairs with `MYSQL_DIALECT` (or `MARIADB_DIALECT`) from `@askdb/core`. This
+ * package ships only the introspection connector and the `mysql2`-backed
+ * catalog runner; the NL→SQL prompt + validator live in `@askdb/core`.
+ */
+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";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +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"}

package/dist/index.js

@@ -0,0 +1,11 @@
+/**
+ * `@askdb/mysql` — MySQL/MariaDB integration for AskDB.
+ *
+ * Pairs with `MYSQL_DIALECT` (or `MARIADB_DIALECT`) from `@askdb/core`. This
+ * package ships only the introspection connector and the `mysql2`-backed
+ * catalog runner; the NL→SQL prompt + validator live in `@askdb/core`.
+ */
+export { MYSQL_DIALECT, MARIADB_DIALECT, } from "@askdb/core";
+export { createMysqlConnector, describeMysql, MYSQL_CATALOG_SQL, } from "./connector/index.js";
+export { createMysqlCatalogQueryRunner, } from "./exec/mysql.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +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"}

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "@askdb/mysql",
+  "version": "0.1.0-beta.1",
+  "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",
+    "mysql",
+    "mariadb",
+    "nl-to-sql",
+    "natural-language-to-sql",
+    "schema-v2",
+    "introspection",
+    "information-schema"
+  ],
+  "homepage": "https://github.com/Ygilany/AskDB#readme",
+  "bugs": {
+    "url": "https://github.com/Ygilany/AskDB/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Ygilany/AskDB.git",
+    "directory": "packages/mysql"
+  },
+  "license": "Apache-2.0",
+  "author": "Yahya Gilany",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "NOTICE"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {
+    "@askdb/core": "0.5.0-beta.4",
+    "@askdb/introspect": "0.3.0-beta.2"
+  },
+  "peerDependencies": {
+    "mysql2": ">=3"
+  },
+  "peerDependenciesMeta": {
+    "mysql2": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "mysql2": "^3.11.5",
+    "typescript": "^5.7.3",
+    "vitest": "^3.0.9"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "lint": "tsc -p tsconfig.build.json --noEmit",
+    "test": "vitest run --config ../../vitest.config.ts"
+  }
+}