@fett/sql-translator 0.0.1-beta

package/lib/driver/mysql/index.js

@@ -0,0 +1,338 @@
+/**
+ * MySQL 驱动（5.7 / 8.x 双版本）
+ * 连接池懒创建；分页包装按版本能力矩阵选择 CTE / 派生表；
+ * DML 走 ResultSetHeader（affectedRows/insertId）；结构 JSON 检出
+ */
+import { createConnection } from 'mysql2/promise';
+import { SqlEngineError, wrapError } from '../../errors.js';
+import { normalizeSql } from '../../core/sql/normalize.js';
+import { hasPaginationClause, buildPagedSql, buildCountSql, wrapWithWhereClause, } from '../../core/sql/pagination.js';
+import { detectStatementType, isDmlStatement, hasDmlWhere, countInsertValueRows, } from '../../core/sql/statement.js';
+import { createTask } from '../../types/task.js';
+import { mapMysqlColumnsToFields, mapMysqlProtocolFields, } from '../../core/field-mapper/mysql.js';
+import { MysqlPoolHandle, buildSslConfig } from './pool.js';
+export class MysqlDriver {
+    dialect;
+    constructor(dialect = 'mysql') {
+        this.dialect = dialect;
+    }
+    async createPool(config) {
+        if (config.type !== this.dialect) {
+            throw new SqlEngineError('UNSUPPORTED_DIALECT', `${this.dialect} 驱动收到 ${config.type} 配置`);
+        }
+        return new MysqlPoolHandle(config, { isMariaDb: this.dialect === 'mariadb' });
+    }
+    // ==================== 连接测试 ====================
+    /** knex 参数绑定（RawBinding 类型限制，unknown[] → any[]） */
+    bind(params) {
+        return (params ?? []);
+    }
+    async testConnection(config) {
+        let connection = null;
+        try {
+            connection = await createConnection({
+                host: config.host,
+                port: Number(config.port ?? 3306),
+                user: config.user || config.username,
+                password: config.password,
+                database: config.database,
+                charset: 'utf8mb4',
+                ssl: buildSslConfig(config),
+                connectTimeout: 5000,
+            });
+            await connection.execute('SELECT 1');
+            return { success: true, message: 'MySQL connection test successful' };
+        }
+        catch (err) {
+            const e = err;
+            return { success: false, message: `MySQL connection test failed: ${e.message}` };
+        }
+        finally {
+            if (connection) {
+                try {
+                    await connection.end();
+                }
+                catch {
+                    // ignore
+                }
+            }
+        }
+    }
+    // ==================== 元信息 ====================
+    async getTableList(pool) {
+        const k = await pool.getKnex();
+        const res = (await k.raw('SHOW TABLES'));
+        const rows = (Array.isArray(res) ? res[0] : res);
+        const names = [];
+        for (const row of rows) {
+            const firstKey = Object.keys(row)[0];
+            if (firstKey)
+                names.push(String(row[firstKey]));
+        }
+        return names;
+    }
+    async getTableDDL(pool, table) {
+        const k = await pool.getKnex();
+        const res = (await k.raw('SHOW CREATE TABLE ??', [table]));
+        const rows = (Array.isArray(res) ? res[0] : res);
+        const row = rows[0];
+        return row?.['Create Table'] || row?.['Create View'] || '';
+    }
+    async getPreviewRows(pool, table, offset, limit, whereClause) {
+        const k = await pool.getKnex();
+        let query = k(table).select('*');
+        if (whereClause)
+            query = query.whereRaw(whereClause);
+        const rows = await query.limit(limit).offset(offset);
+        return rows;
+    }
+    async getColumns(pool, table) {
+        const k = await pool.getKnex();
+        const res = (await k.raw('SHOW FULL COLUMNS FROM ??', [table]));
+        const rows = (Array.isArray(res) ? res[0] : res);
+        return mapMysqlColumnsToFields(rows);
+    }
+    async getRowsCount(pool, table, whereClause) {
+        const k = await pool.getKnex();
+        let query = k(table).count({ total: '*' });
+        if (whereClause)
+            query = query.whereRaw(whereClause);
+        const row = await query.first();
+        const total = row ? Number(row.total) : 0;
+        return Number.isNaN(total) ? 0 : total;
+    }
+    // ==================== SQL 执行 ====================
+    async runSql(pool, request) {
+        const handle = pool;
+        const k = await handle.getKnex();
+        return this.runSqlWithKnex(k, handle, request);
+    }
+    /** 事务/常规共用执行核心（k 可指定为事务连接） */
+    runSqlWithKnex(k, handle, request) {
+        const sql = normalizeSql(request.sql);
+        const type = detectStatementType(sql);
+        try {
+            if (isDmlStatement(type)) {
+                return this.runDml(handle, k, sql, request.params, type, request.dml);
+            }
+            if (type === 'SELECT') {
+                return this.runSelect(handle, k, sql, request);
+            }
+            if (type === 'DDL' || type === 'TRANSACTION') {
+                return k.raw(sql, this.bind(request.params)).then((raw) => {
+                    const [result] = raw;
+                    const header = result;
+                    return { affectedRows: Number(header?.affectedRows ?? 0) };
+                });
+            }
+            throw new SqlEngineError('QUERY_FAILED', `暂不支持执行 ${type} 语句`);
+        }
+        catch (err) {
+            if (err instanceof SqlEngineError)
+                return Promise.reject(err);
+            return Promise.reject(wrapError('QUERY_FAILED', err));
+        }
+    }
+    /** 事务：knex.transaction（fn 抛错自动回滚，成功自动提交） */
+    async withTransaction(pool, fn) {
+        const handle = pool;
+        const k = await handle.getKnex();
+        const self = this;
+        return k.transaction(async (trx) => {
+            const tx = {
+                runSql: (req) => self.runSqlWithKnex(trx, handle, req),
+                query: (sql, params) => self.runSqlWithKnex(trx, handle, { sql, params }),
+                execute: (sql, params) => self.runSqlWithKnex(trx, handle, { sql, params }),
+                commit: async () => {
+                    await trx.commit();
+                },
+                rollback: async () => {
+                    await trx.rollback();
+                },
+            };
+            return fn(tx);
+        });
+    }
+    // ---- SELECT（分页包装按版本能力矩阵） ----
+    async runSelect(handle, k, sql, request) {
+        const offset = Math.max(Number(request.offset ?? 0), 0);
+        const limit = Math.max(Number(request.limit ?? 100), 0);
+        const params = request.params ?? [];
+        const caps = await handle.getCapabilities();
+        let baseSql = sql;
+        if (request.whereClause) {
+            baseSql = wrapWithWhereClause(sql, request.whereClause, { supportsCTE: caps.supportsCTE });
+        }
+        // 用户 SQL 自带分页 → 直接执行，不再二次包装
+        if (hasPaginationClause(baseSql, [/\bfetch\s+first\b/i, /\btop\b/i])) {
+            const [rows, fields] = (await k.raw(baseSql, this.bind(params)));
+            return {
+                rows: rows,
+                fields: mapMysqlProtocolFields(fields ?? []),
+            };
+        }
+        const countSql = buildCountSql(baseSql);
+        const [countRows] = (await k.raw(countSql, this.bind(params)));
+        const countArr = countRows;
+        const total = Number(countArr?.[0]?.total ?? 0);
+        const pageSql = buildPagedSql(baseSql, limit, offset);
+        const [rows, fields] = (await k.raw(pageSql, this.bind(params)));
+        return {
+            rows: rows,
+            fields: mapMysqlProtocolFields(fields ?? []),
+            total: Number.isNaN(total) ? 0 : total,
+            offset,
+            limit,
+        };
+    }
+    // ---- DML ----
+    async runDml(handle, k, sql, params, type, dmlOverride) {
+        const dml = dmlOverride ?? handle.config.dml ?? {};
+        const args = params ?? [];
+        // 安全护栏：无 WHERE 的 UPDATE/DELETE
+        if ((type === 'UPDATE' || type === 'DELETE') &&
+            dml.requireWhereForUpdateDelete !== false &&
+            !hasDmlWhere(sql)) {
+            throw new SqlEngineError('DML_BLOCKED', `禁止无 WHERE 的 ${type}（config.dml.requireWhereForUpdateDelete 可关闭）`);
+        }
+        // 批量插入上限
+        if (type === 'INSERT' && dml.maxInsertRows) {
+            const rows = countInsertValueRows(sql);
+            if (rows > dml.maxInsertRows) {
+                throw new SqlEngineError('DML_BLOCKED', `INSERT 行数 ${rows} 超过上限 ${dml.maxInsertRows}`);
+            }
+        }
+        const [result] = (await k.raw(sql, this.bind(args)));
+        const header = result;
+        const writeResult = { affectedRows: Number(header?.affectedRows ?? 0) };
+        if (type === 'INSERT' && header?.insertId !== undefined && header?.insertId !== 0) {
+            writeResult.insertId = header.insertId;
+            // returning=true：按自增主键回读插入行（仅限单自增主键表）
+            if (dml.returning) {
+                const table = extractInsertTable(sql);
+                if (table) {
+                    const pk = await handle.getPrimaryKeyColumn(table);
+                    if (pk) {
+                        const rows = await this.getPreviewRows(handle, table, 0, 1, `${pk} = ${Number(header.insertId)}`);
+                        writeResult.returning = rows;
+                    }
+                }
+            }
+        }
+        return writeResult;
+    }
+    // ==================== 结构 JSON 检出 ====================
+    async getTableSchema(pool, table) {
+        const handle = pool;
+        const k = await handle.getKnex();
+        // 字段
+        const colRes = (await k.raw('SHOW FULL COLUMNS FROM ??', [table]));
+        const columns = (Array.isArray(colRes) ? colRes[0] : colRes);
+        if (!columns.length) {
+            throw new SqlEngineError('TABLE_NOT_FOUND', `表 ${table} 不存在`);
+        }
+        // 索引
+        const idxRes = (await k.raw('SHOW INDEX FROM ??', [table]));
+        const idxRows = (Array.isArray(idxRes) ? idxRes[0] : idxRes);
+        const indexMap = new Map();
+        for (const r of idxRows) {
+            let idx = indexMap.get(r.Key_name);
+            if (!idx) {
+                idx = { name: r.Key_name, unique: r.Non_unique === 0, columns: [], type: r.Index_type };
+                indexMap.set(r.Key_name, idx);
+            }
+            if (r.Column_name)
+                idx.columns.push(r.Column_name);
+        }
+        // 外键
+        const fkRes = (await k.raw(`SELECT kcu.constraint_name AS constraint_name, kcu.column_name AS column_name,
+              kcu.referenced_table_name AS referenced_table_name, kcu.referenced_column_name AS referenced_column_name,
+              rc.delete_rule AS delete_rule, rc.update_rule AS update_rule
+       FROM information_schema.key_column_usage kcu
+       JOIN information_schema.referential_constraints rc
+         ON kcu.constraint_name = rc.constraint_name AND kcu.table_schema = rc.constraint_schema
+       WHERE kcu.table_schema = DATABASE() AND kcu.table_name = ? AND kcu.referenced_table_name IS NOT NULL
+       ORDER BY kcu.constraint_name, kcu.ordinal_position`, [table]));
+        const fkRows = (Array.isArray(fkRes) ? fkRes[0] : fkRes);
+        const fkMap = new Map();
+        for (const r of fkRows) {
+            let fk = fkMap.get(r.constraint_name);
+            if (!fk) {
+                fk = {
+                    name: r.constraint_name,
+                    columns: [],
+                    refTable: r.referenced_table_name,
+                    refColumns: [],
+                    onDelete: r.delete_rule || undefined,
+                    onUpdate: r.update_rule || undefined,
+                };
+                fkMap.set(r.constraint_name, fk);
+            }
+            fk.columns.push(r.column_name);
+            fk.refColumns.push(r.referenced_column_name);
+        }
+        // 引擎/字符集/表注释
+        const tblRes = (await k.raw(`SELECT engine AS engine, table_collation AS table_collation, table_comment AS table_comment
+       FROM information_schema.tables
+       WHERE table_schema = DATABASE() AND table_name = ?`, [table]));
+        const tblRows = (Array.isArray(tblRes) ? tblRes[0] : tblRes);
+        const tbl = tblRows[0];
+        // 原始 DDL
+        const ddl = await this.getTableDDL(handle, table);
+        const columnSchemas = columns.map((c, i) => ({
+            name: c.Field,
+            type: c.Type,
+            nullable: c.Null !== 'NO',
+            default: c.Default,
+            comment: c.Comment,
+            primaryKey: String(c.Key || '').toUpperCase() === 'PRI',
+            autoIncrement: /auto_increment/i.test(c.Extra || ''),
+            ordinal: i + 1,
+        }));
+        return {
+            name: table,
+            schema: handle.config.database,
+            kind: 'table',
+            comment: tbl?.table_comment || undefined,
+            columns: columnSchemas,
+            indexes: [...indexMap.values()],
+            foreignKeys: [...fkMap.values()],
+            engine: tbl?.engine,
+            charset: tbl?.table_collation,
+            ddl,
+            raw: {},
+        };
+    }
+    getAllTableSchemas(pool, opts) {
+        const handle = pool;
+        const self = this;
+        return createTask(async (ctx) => {
+            const tables = await self.getTableList(handle);
+            const total = tables.length;
+            const schemas = [];
+            for (let i = 0; i < tables.length; i++) {
+                if (ctx.isCancelled())
+                    break;
+                ctx.report({ stage: 'introspecting', processed: i, total, message: tables[i] });
+                try {
+                    schemas.push(await self.getTableSchema(handle, tables[i]));
+                }
+                catch {
+                    // 单表失败不中断整体导出
+                }
+            }
+            void opts;
+            return schemas;
+        });
+    }
+}
+/** 从 INSERT 语句提取目标表名（returning 回读用） */
+function extractInsertTable(sql) {
+    const m = sql.match(/\bINSERT\s+INTO\s+([`"\[]?[^\s`"\[(]+[`"\]]?)/i);
+    if (!m)
+        return null;
+    return String(m[1]).replace(/[`"[\]]/g, '');
+}
+export const mysqlDriver = new MysqlDriver('mysql');
+export const mariadbDriver = new MysqlDriver('mariadb');
+//# sourceMappingURL=index.js.map

package/lib/driver/mysql/index.js.map

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

package/lib/driver/mysql/pool.d.ts

@@ -0,0 +1,46 @@
+/**
+ * MySQL 连接池句柄（Knex/mysql2）
+ * 懒创建：首次操作才建立连接池；版本能力探测缓存
+ */
+import { type Knex } from 'knex';
+import type { PoolHandle } from '../interface.js';
+import type { MysqlConfig } from '../../types/config.js';
+import type { MysqlCapabilities } from './version.js';
+/** 构建 MySQL SSL 配置 */
+export declare function buildSslConfig(config: MysqlConfig): {
+    ca: string | undefined;
+    cert: string | undefined;
+    key: string | undefined;
+    rejectUnauthorized: boolean;
+    minVersion: string;
+} | undefined;
+export declare class MysqlPoolHandle implements PoolHandle {
+    readonly fingerprint: string;
+    readonly config: MysqlConfig;
+    readonly isMariaDb: boolean;
+    private knexInstance;
+    private caps;
+    private destroyedFlag;
+    /** 表主键列缓存（INSERT returning 回读用） */
+    private readonly pkCache;
+    constructor(config: MysqlConfig, options?: {
+        isMariaDb?: boolean;
+    });
+    get destroyed(): boolean;
+    /** 获取 Knex 实例（懒创建） */
+    getKnex(): Promise<Knex>;
+    /** 版本能力（config.version 强制时跳过探测；MariaDB 走独立解析） */
+    getCapabilities(): Promise<MysqlCapabilities>;
+    /** 主键列（返回空字符串表示无/多列主键） */
+    getPrimaryKeyColumn(table: string): Promise<string>;
+    get stats(): {
+        active: number;
+        idle: number;
+        waiting: number;
+        createdTotal: number;
+        destroyedTotal: number;
+    };
+    ping(): Promise<void>;
+    destroy(): Promise<void>;
+}
+//# sourceMappingURL=pool.d.ts.map

package/lib/driver/mysql/pool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pool.d.ts","sourceRoot":"","sources":["../../../src/driver/mysql/pool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAa,EAAE,KAAK,IAAI,EAAE,MAAM,MAAM,CAAC;AAGvC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAGtD,sBAAsB;AACtB,wBAAgB,cAAc,CAAC,MAAM,EAAE,WAAW;;;;;;cASjD;AAED,qBAAa,eAAgB,YAAW,UAAU;IAChD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,OAAO,CAAC,YAAY,CAAqB;IACzC,OAAO,CAAC,IAAI,CAAkC;IAC9C,OAAO,CAAC,aAAa,CAAS;IAC9B,mCAAmC;IACnC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA6B;gBAEzC,MAAM,EAAE,WAAW,EAAE,OAAO,GAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAA;KAAO;IAOtE,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,sBAAsB;IAChB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAwC9B,iDAAiD;IAC3C,eAAe,IAAI,OAAO,CAAC,iBAAiB,CAAC;IASnD,0BAA0B;IACpB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAgBzD,IAAI,KAAK;;;;;;MAsBR;IAEK,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAKrB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAY/B"}

package/lib/driver/mysql/pool.js

@@ -0,0 +1,141 @@
+/**
+ * MySQL 连接池句柄（Knex/mysql2）
+ * 懒创建：首次操作才建立连接池；版本能力探测缓存
+ */
+import knex, {} from 'knex';
+import { resolveRuntime } from '../../runtime.js';
+import { configKey } from '../../core/config.js';
+import { resolveMysqlCapabilities } from './version.js';
+/** 构建 MySQL SSL 配置 */
+export function buildSslConfig(config) {
+    if (!config.ssl?.enabled)
+        return undefined;
+    return {
+        ca: config.ssl.ca || undefined,
+        cert: config.ssl.cert || undefined,
+        key: config.ssl.key || undefined,
+        rejectUnauthorized: config.ssl.rejectUnauthorized ?? false,
+        minVersion: 'TLSv1.2',
+    };
+}
+export class MysqlPoolHandle {
+    fingerprint;
+    config;
+    isMariaDb;
+    knexInstance = null;
+    caps = null;
+    destroyedFlag = false;
+    /** 表主键列缓存（INSERT returning 回读用） */
+    pkCache = new Map();
+    constructor(config, options = {}) {
+        this.config = { ...config };
+        this.fingerprint = configKey(config);
+        this.isMariaDb = options.isMariaDb ?? config.type === 'mariadb';
+        void resolveRuntime; // runtime 兼容占位（mysql 驱动不依赖 runtime 差异）
+    }
+    get destroyed() {
+        return this.destroyedFlag;
+    }
+    /** 获取 Knex 实例（懒创建） */
+    async getKnex() {
+        if (!this.knexInstance) {
+            const cfg = this.config;
+            this.knexInstance = knex({
+                client: 'mysql2',
+                connection: {
+                    host: cfg.host,
+                    port: Number(cfg.port ?? 3306),
+                    user: cfg.user || cfg.username,
+                    password: cfg.password,
+                    database: cfg.database,
+                    ssl: buildSslConfig(cfg),
+                    enableKeepAlive: true,
+                    keepAliveInitialDelay: 10000,
+                    connectTimeout: 10000,
+                },
+                pool: {
+                    min: 0,
+                    max: 20,
+                    acquireTimeoutMillis: 20000,
+                    createTimeoutMillis: 15000,
+                    idleTimeoutMillis: 30000,
+                    reapIntervalMillis: 1000,
+                    createRetryIntervalMillis: 100,
+                    propagateCreateError: false,
+                    // 每条连接建立后设置慢查询兜底：MySQL 用 max_execution_time(ms)，MariaDB 用 max_statement_time(s)
+                    afterCreate: (conn, done) => {
+                        const setVar = this.isMariaDb
+                            ? 'SET SESSION max_statement_time = 30'
+                            : 'SET SESSION max_execution_time = 30000';
+                        conn.query(setVar, (err) => {
+                            done(err, conn);
+                        });
+                    },
+                },
+            });
+        }
+        return this.knexInstance;
+    }
+    /** 版本能力（config.version 强制时跳过探测；MariaDB 走独立解析） */
+    async getCapabilities() {
+        this.caps ??= await resolveMysqlCapabilities(await this.getKnex(), this.config.version, this.isMariaDb);
+        return this.caps;
+    }
+    /** 主键列（返回空字符串表示无/多列主键） */
+    async getPrimaryKeyColumn(table) {
+        const cached = this.pkCache.get(table);
+        if (cached !== undefined)
+            return cached;
+        const k = await this.getKnex();
+        const res = (await k.raw(`SELECT column_name AS column_name FROM information_schema.key_column_usage
+       WHERE table_schema = DATABASE() AND table_name = ? AND constraint_name = 'PRIMARY'
+       ORDER BY ordinal_position`, [table]));
+        const rows = (Array.isArray(res) ? res[0] : res);
+        const pk = rows?.length === 1 ? String(rows[0].column_name ?? '') : '';
+        this.pkCache.set(table, pk);
+        return pk;
+    }
+    get stats() {
+        // tarn 连接池统计（knex 3）
+        let active = 0;
+        let idle = 0;
+        let waiting = 0;
+        try {
+            const pool = this.knexInstance?.client?.pool;
+            if (pool && typeof pool.numUsed === 'function') {
+                active = pool.numUsed();
+                idle = pool.numFree();
+                waiting = pool.numPendingAcquires();
+            }
+        }
+        catch {
+            // 统计失败不影响主流程
+        }
+        return {
+            active,
+            idle,
+            waiting,
+            createdTotal: this.knexInstance ? 1 : 0,
+            destroyedTotal: this.destroyedFlag ? 1 : 0,
+        };
+    }
+    async ping() {
+        const k = await this.getKnex();
+        await k.raw('SELECT 1');
+    }
+    async destroy() {
+        if (this.destroyedFlag)
+            return;
+        this.destroyedFlag = true;
+        if (this.knexInstance) {
+            try {
+                await this.knexInstance.destroy();
+            }
+            catch {
+                // 销毁失败不阻塞
+            }
+            this.knexInstance = null;
+        }
+    }
+}
+//# sourceMappingURL=pool.js.map

package/lib/driver/mysql/pool.js.map

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

package/lib/driver/mysql/version.d.ts

@@ -0,0 +1,27 @@
+/**
+ * MySQL 版本探测与能力矩阵（5.7 / 8.x 双模式路由）
+ */
+import type { Knex } from 'knex';
+export interface MysqlCapabilities {
+    /** 主版本号（5 / 8 / 0=未知） */
+    major: number;
+    /** CTE（WITH ... AS），MySQL 8+ */
+    supportsCTE: boolean;
+    /** 窗口函数，MySQL 8+ */
+    supportsWindowFunctions: boolean;
+    /** JSON 类型，5.7.8+ */
+    supportsJson: boolean;
+}
+export declare const MYSQL5_CAPS: MysqlCapabilities;
+export declare const MYSQL8_CAPS: MysqlCapabilities;
+/** 解析 VERSION() 字符串 → 能力矩阵 */
+export declare function parseMysqlVersion(version: string): MysqlCapabilities;
+/** 通过 SELECT VERSION() 探测（knex raw 对 mysql2 返回 [rows, fields]） */
+export declare function detectMysqlVersion(k: Knex): Promise<MysqlCapabilities>;
+/** 解析 MariaDB VERSION() → 能力矩阵（10.2+ CTE / 10.3+ 窗口函数 / 10.2+ JSON） */
+export declare function parseMariaDbVersion(version: string): MysqlCapabilities;
+/** 探测 VERSION() 原始字符串 */
+export declare function detectVersionString(k: Knex): Promise<string>;
+/** 按 config.version 解析能力（强制模式 / auto 探测；isMariaDb 决定解析器） */
+export declare function resolveMysqlCapabilities(k: Knex, versionChoice: '5' | '8' | 'auto' | '10' | '11' | undefined, isMariaDb?: boolean): Promise<MysqlCapabilities>;
+//# sourceMappingURL=version.d.ts.map

package/lib/driver/mysql/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../../src/driver/mysql/version.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAEjC,MAAM,WAAW,iBAAiB;IAChC,yBAAyB;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,gCAAgC;IAChC,WAAW,EAAE,OAAO,CAAC;IACrB,oBAAoB;IACpB,uBAAuB,EAAE,OAAO,CAAC;IACjC,qBAAqB;IACrB,YAAY,EAAE,OAAO,CAAC;CACvB;AAED,eAAO,MAAM,WAAW,EAAE,iBAKzB,CAAC;AAEF,eAAO,MAAM,WAAW,EAAE,iBAKzB,CAAC;AAEF,8BAA8B;AAC9B,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,iBAAiB,CAYpE;AAED,kEAAkE;AAClE,wBAAsB,kBAAkB,CAAC,CAAC,EAAE,IAAI,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAK5E;AAED,uEAAuE;AACvE,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,iBAAiB,CAYtE;AAED,yBAAyB;AACzB,wBAAsB,mBAAmB,CAAC,CAAC,EAAE,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAIlE;AAED,4DAA4D;AAC5D,wBAAsB,wBAAwB,CAC5C,CAAC,EAAE,IAAI,EACP,aAAa,EAAE,GAAG,GAAG,GAAG,GAAG,MAAM,GAAG,IAAI,GAAG,IAAI,GAAG,SAAS,EAC3D,SAAS,UAAQ,GAChB,OAAO,CAAC,iBAAiB,CAAC,CAiB5B"}