@fett/sql-translator 0.0.1-beta

package/lib/core/sql/normalize.d.ts

@@ -0,0 +1,10 @@
+/**
+ * SQL 标准化工具
+ */
+/** 去除末尾分号序列和空白字符 */
+export declare function normalizeSql(sql: string): string;
+/**
+ * 剥离 SQL 中的注释和字符串常量，用于分析 SQL 结构（如查找关键词）
+ */
+export declare function stripSqlForSearch(sql: string): string;
+//# sourceMappingURL=normalize.d.ts.map

package/lib/core/sql/normalize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.d.ts","sourceRoot":"","sources":["../../../src/core/sql/normalize.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,oBAAoB;AACpB,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAKhD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAsHrD"}

package/lib/core/sql/normalize.js

@@ -0,0 +1,121 @@
+/**
+ * SQL 标准化工具
+ */
+/** 去除末尾分号序列和空白字符 */
+export function normalizeSql(sql) {
+    return String(sql ?? '')
+        .trim()
+        .replace(/(?:\s*;+\s*)+$/, '')
+        .trim();
+}
+/**
+ * 剥离 SQL 中的注释和字符串常量，用于分析 SQL 结构（如查找关键词）
+ */
+export function stripSqlForSearch(sql) {
+    let out = '';
+    let inSingle = false;
+    let inDouble = false;
+    let inBacktick = false;
+    let inLineComment = false;
+    let inBlockComment = false;
+    let escape = false;
+    let prev = '';
+    for (let i = 0; i < sql.length; i++) {
+        const ch = sql[i];
+        const next = i + 1 < sql.length ? sql[i + 1] : '';
+        if (inLineComment) {
+            if (ch === '\n') {
+                inLineComment = false;
+                out += '\n';
+                prev = '\n';
+            }
+            else {
+                out += ' ';
+                prev = ch;
+            }
+            continue;
+        }
+        if (inBlockComment) {
+            if (ch === '*' && next === '/') {
+                inBlockComment = false;
+                out += '  ';
+                i++;
+                prev = '/';
+            }
+            else {
+                out += ch === '\n' ? '\n' : ' ';
+                prev = ch;
+            }
+            continue;
+        }
+        if (inSingle) {
+            if (!escape && ch === "'")
+                inSingle = false;
+            escape = !escape && ch === '\\';
+            out += ch === '\n' ? '\n' : ' ';
+            prev = ch;
+            continue;
+        }
+        if (inDouble) {
+            if (!escape && ch === '"')
+                inDouble = false;
+            escape = !escape && ch === '\\';
+            out += ch === '\n' ? '\n' : ' ';
+            prev = ch;
+            continue;
+        }
+        if (inBacktick) {
+            if (ch === '`')
+                inBacktick = false;
+            out += ch === '\n' ? '\n' : ' ';
+            prev = ch;
+            continue;
+        }
+        escape = false;
+        if (ch === '-' &&
+            next === '-' &&
+            (prev === '' || /\s/.test(prev)) &&
+            (i + 2 >= sql.length || /\s/.test(sql[i + 2]))) {
+            inLineComment = true;
+            out += '  ';
+            i++;
+            prev = '-';
+            continue;
+        }
+        if (ch === '#') {
+            inLineComment = true;
+            out += ' ';
+            prev = '#';
+            continue;
+        }
+        if (ch === '/' && next === '*') {
+            inBlockComment = true;
+            out += '  ';
+            i++;
+            prev = '*';
+            continue;
+        }
+        if (ch === "'") {
+            inSingle = true;
+            out += ' ';
+            prev = "'";
+            continue;
+        }
+        if (ch === '"') {
+            inDouble = true;
+            out += ' ';
+            prev = '"';
+            continue;
+        }
+        if (ch === '`') {
+            inBacktick = true;
+            out += ' ';
+            prev = '`';
+            continue;
+        }
+        out += ch;
+        prev = ch;
+    }
+    return out;
+}
+//# sourceMappingURL=normalize.js.map

package/lib/core/sql/normalize.js.map

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

package/lib/core/sql/pagination.d.ts

@@ -0,0 +1,22 @@
+/**
+ * 分页工具：分页子句检测、LIMIT/OFFSET 提取、分页 SQL 包装
+ */
+/** 从 SQL 中提取 LIMIT 和 OFFSET 的值（兼容 LIMIT a,b 与 LIMIT a OFFSET b） */
+export declare function extractLimitOffset(sql: string): {
+    limit?: number;
+    offset?: number;
+};
+/** 检查 SQL 是否包含分页子句 */
+export declare function hasPaginationClause(sql: string, extraPatterns?: RegExp[]): boolean;
+/**
+ * 用 whereClause 包装 SQL
+ * MySQL 5.7 无 CTE：走派生表；否则用 CTE（语义等价，CTE 可读性更好）
+ */
+export declare function wrapWithWhereClause(sql: string, whereClause: string, opts?: {
+    supportsCTE?: boolean;
+}): string;
+/** 生成分页 SQL（LIMIT/OFFSET，MySQL/PG/SQLite 通用） */
+export declare function buildPagedSql(baseSql: string, limit: number, offset: number): string;
+/** 生成总数 SQL */
+export declare function buildCountSql(baseSql: string): string;
+//# sourceMappingURL=pagination.d.ts.map

package/lib/core/sql/pagination.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.d.ts","sourceRoot":"","sources":["../../../src/core/sql/pagination.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,mEAAmE;AACnE,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CA0BnF;AAED,sBAAsB;AACtB,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,aAAa,GAAE,MAAM,EAAO,GAAG,OAAO,CAItF;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,MAAM,EACX,WAAW,EAAE,MAAM,EACnB,IAAI,GAAE;IAAE,WAAW,CAAC,EAAE,OAAO,CAAA;CAAO,GACnC,MAAM,CAMR;AAED,gDAAgD;AAChD,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAEpF;AAED,eAAe;AACf,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAErD"}

package/lib/core/sql/pagination.js

@@ -0,0 +1,61 @@
+/**
+ * 分页工具：分页子句检测、LIMIT/OFFSET 提取、分页 SQL 包装
+ */
+import { stripSqlForSearch } from './normalize.js';
+/** 从 SQL 中提取 LIMIT 和 OFFSET 的值（兼容 LIMIT a,b 与 LIMIT a OFFSET b） */
+export function extractLimitOffset(sql) {
+    const s = stripSqlForSearch(sql);
+    let limit;
+    let offset;
+    // LIMIT a, b（MySQL 逗号语法）优先；命中后不再解析 LIMIT n OFFSET m
+    const commaMatches = Array.from(s.matchAll(/\blimit\s+(\d+)\s*,\s*(\d+)/gi));
+    if (commaMatches.length) {
+        const m = commaMatches[commaMatches.length - 1];
+        offset = Number(m[1]);
+        limit = Number(m[2]);
+    }
+    else {
+        const offsetMatches = Array.from(s.matchAll(/\blimit\s+(\d+)(?:\s+offset\s+(\d+))?/gi));
+        if (offsetMatches.length) {
+            const m = offsetMatches[offsetMatches.length - 1];
+            const l = Number(m[1]);
+            const o = m[2] !== undefined ? Number(m[2]) : undefined;
+            if (!Number.isNaN(l))
+                limit = l;
+            if (o !== undefined && !Number.isNaN(o))
+                offset = o;
+        }
+    }
+    if (limit !== undefined && Number.isNaN(limit))
+        limit = undefined;
+    if (offset !== undefined && Number.isNaN(offset))
+        offset = undefined;
+    return { limit, offset };
+}
+/** 检查 SQL 是否包含分页子句 */
+export function hasPaginationClause(sql, extraPatterns = []) {
+    const s = stripSqlForSearch(sql);
+    const patterns = [/\blimit\b/i, /\boffset\b/i, ...extraPatterns];
+    return patterns.some((p) => p.test(s));
+}
+/**
+ * 用 whereClause 包装 SQL
+ * MySQL 5.7 无 CTE：走派生表；否则用 CTE（语义等价，CTE 可读性更好）
+ */
+export function wrapWithWhereClause(sql, whereClause, opts = {}) {
+    if (!whereClause)
+        return sql;
+    if (opts.supportsCTE === false) {
+        return `SELECT * FROM (${sql}) AS __t WHERE ${whereClause}`;
+    }
+    return `WITH __t AS (${sql}) SELECT * FROM __t WHERE ${whereClause}`;
+}
+/** 生成分页 SQL（LIMIT/OFFSET，MySQL/PG/SQLite 通用） */
+export function buildPagedSql(baseSql, limit, offset) {
+    return `${baseSql} LIMIT ${Math.max(limit, 0)} OFFSET ${Math.max(offset, 0)}`;
+}
+/** 生成总数 SQL */
+export function buildCountSql(baseSql) {
+    return `SELECT COUNT(1) AS total FROM (${baseSql}) AS __t2`;
+}
+//# sourceMappingURL=pagination.js.map

package/lib/core/sql/pagination.js.map

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

package/lib/core/sql/statement.d.ts

@@ -0,0 +1,28 @@
+/**
+ * 语句类型识别与 DML 安全检测
+ */
+export type StatementType = 'SELECT' | 'INSERT' | 'UPDATE' | 'DELETE' | 'DDL' | 'TRANSACTION' | 'OTHER' | 'UNKNOWN';
+/** 识别 SQL 语句类型（基于剥离注释/字符串后的首关键字） */
+export declare function detectStatementType(sql: string): StatementType;
+export type DmlStatementType = 'INSERT' | 'UPDATE' | 'DELETE';
+export declare function isDmlStatement(type: StatementType): type is DmlStatementType;
+/**
+ * 提取 UPDATE / DELETE 语句的 WHERE 子句原文（保留字符串字面量）
+ * 在剥离版上定位 WHERE 位置，再从原始 SQL 截取到末尾（两版字符位置一致）
+ * 返回 null 表示无 WHERE（用于 DML 安全护栏）
+ */
+export declare function extractDmlWhere(sql: string): string | null;
+/** UPDATE/DELETE 是否有 WHERE 子句 */
+export declare function hasDmlWhere(sql: string): boolean;
+/**
+ * 从 SQL 中提取引用的表名（含 schema-qualified）
+ * 注意：在原始 SQL 上做正则（不剥离字符串），与引号标识符/中文表名兼容；
+ * 字符串字面量内误匹配的风险
+ * */
+export declare function extractTableNamesFromSql(sql: string): Set<string>;
+/**
+ * 解析 INSERT VALUES 行数（DML 批量上限校验用）
+ * @returns 行数；无法解析（如 INSERT ... SELECT）返回 0
+ */
+export declare function countInsertValueRows(sql: string): number;
+//# sourceMappingURL=statement.d.ts.map

package/lib/core/sql/statement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"statement.d.ts","sourceRoot":"","sources":["../../../src/core/sql/statement.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,MAAM,MAAM,aAAa,GACrB,QAAQ,GACR,QAAQ,GACR,QAAQ,GACR,QAAQ,GACR,KAAK,GACL,aAAa,GACb,OAAO,GACP,SAAS,CAAC;AAEd,oCAAoC;AACpC,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,CAgC9D;AAED,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE9D,wBAAgB,cAAc,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI,IAAI,gBAAgB,CAE5E;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAQ1D;AAED,iCAAiC;AACjC,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAEhD;AAOD;;;;KAIK;AACL,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAiEjE;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CA6BxD"}

package/lib/core/sql/statement.js

@@ -0,0 +1,155 @@
+/**
+ * 语句类型识别与 DML 安全检测
+ */
+import { stripSqlForSearch } from './normalize.js';
+/** 识别 SQL 语句类型（基于剥离注释/字符串后的首关键字） */
+export function detectStatementType(sql) {
+    const s = stripSqlForSearch(sql).trimStart();
+    if (!s)
+        return 'UNKNOWN';
+    const m = s.match(/^[a-zA-Z]+/);
+    if (!m)
+        return 'UNKNOWN';
+    const kw = m[0].toUpperCase();
+    switch (kw) {
+        case 'SELECT':
+        case 'WITH':
+            return 'SELECT';
+        case 'INSERT':
+        case 'REPLACE':
+            return 'INSERT';
+        case 'UPDATE':
+            return 'UPDATE';
+        case 'DELETE':
+            return 'DELETE';
+        case 'CREATE':
+        case 'ALTER':
+        case 'DROP':
+        case 'TRUNCATE':
+        case 'RENAME':
+            return 'DDL';
+        case 'BEGIN':
+        case 'COMMIT':
+        case 'ROLLBACK':
+        case 'START':
+        case 'SAVEPOINT':
+            return 'TRANSACTION';
+        default:
+            return 'OTHER';
+    }
+}
+export function isDmlStatement(type) {
+    return type === 'INSERT' || type === 'UPDATE' || type === 'DELETE';
+}
+/**
+ * 提取 UPDATE / DELETE 语句的 WHERE 子句原文（保留字符串字面量）
+ * 在剥离版上定位 WHERE 位置，再从原始 SQL 截取到末尾（两版字符位置一致）
+ * 返回 null 表示无 WHERE（用于 DML 安全护栏）
+ */
+export function extractDmlWhere(sql) {
+    const stripped = stripSqlForSearch(sql);
+    const type = detectStatementType(sql);
+    if (type !== 'UPDATE' && type !== 'DELETE')
+        return null;
+    const m = stripped.match(/\bwhere\b/i);
+    if (!m || m.index === undefined)
+        return null;
+    return sql.slice(m.index);
+}
+/** UPDATE/DELETE 是否有 WHERE 子句 */
+export function hasDmlWhere(sql) {
+    return extractDmlWhere(sql) !== null;
+}
+const TABLE_KEYWORDS = 'FROM|JOIN|INNER\\s+JOIN|LEFT\\s+JOIN|RIGHT\\s+JOIN|FULL\\s+JOIN|CROSS\\s+JOIN';
+const ANY_QUOTED_IDENTIFIER = `(?:"[^"]+"|'[^']+'|\`[^\`]+\`)`;
+const BARE_IDENTIFIER = '[a-zA-Z_\\u4e00-\\u9fff][a-zA-Z0-9_\\u4e00-\\u9fff]*';
+const IDENTIFIER = `(?:${ANY_QUOTED_IDENTIFIER}|${BARE_IDENTIFIER})`;
+/**
+ * 从 SQL 中提取引用的表名（含 schema-qualified）
+ * 注意：在原始 SQL 上做正则（不剥离字符串），与引号标识符/中文表名兼容；
+ * 字符串字面量内误匹配的风险
+ * */
+export function extractTableNamesFromSql(sql) {
+    const tableNames = new Set();
+    const s = sql;
+    const stripQuotes = (identifier) => {
+        if ((identifier.startsWith('"') && identifier.endsWith('"')) ||
+            (identifier.startsWith("'") && identifier.endsWith("'")) ||
+            (identifier.startsWith('`') && identifier.endsWith('`'))) {
+            return identifier.slice(1, -1);
+        }
+        return identifier;
+    };
+    // 1. "schema"."table" 复合形式 → "schema.table"
+    const compoundQuoted = new RegExp(`\\b(?:${TABLE_KEYWORDS})\\s+(${ANY_QUOTED_IDENTIFIER})\\.(${ANY_QUOTED_IDENTIFIER})`, 'gi');
+    let match;
+    while ((match = compoundQuoted.exec(s)) !== null) {
+        tableNames.add(`${stripQuotes(match[1])}.${stripQuotes(match[2])}`);
+    }
+    // 2. schema.table 裸名复合形式
+    const compoundBare = new RegExp(`\\b(?:${TABLE_KEYWORDS})\\s+(${BARE_IDENTIFIER})\\.(${BARE_IDENTIFIER})`, 'gi');
+    while ((match = compoundBare.exec(s)) !== null) {
+        tableNames.add(`${match[1]}.${match[2]}`);
+    }
+    // 3. 简单表名（不带 schema 前缀）
+    const simpleNamePattern = new RegExp(`\\b(?:${TABLE_KEYWORDS})\\s+(${ANY_QUOTED_IDENTIFIER}|${BARE_IDENTIFIER})`, 'gi');
+    while ((match = simpleNamePattern.exec(s)) !== null) {
+        const name = stripQuotes(match[1]);
+        let isCompoundPart = false;
+        tableNames.forEach((existing) => {
+            if (existing.endsWith(`.${name}`))
+                isCompoundPart = true;
+        });
+        if (!isCompoundPart)
+            tableNames.add(name);
+    }
+    // 4. INSERT INTO / UPDATE / DELETE FROM 的目标表
+    const intoPattern = new RegExp(`\\b(?:INTO|UPDATE)\\s+(${ANY_QUOTED_IDENTIFIER}|${BARE_IDENTIFIER})`, 'gi');
+    while ((match = intoPattern.exec(s)) !== null) {
+        tableNames.add(stripQuotes(match[1]));
+    }
+    const deletePattern = new RegExp(`\\bDELETE\\s+FROM\\s+(${ANY_QUOTED_IDENTIFIER}|${BARE_IDENTIFIER})`, 'gi');
+    while ((match = deletePattern.exec(s)) !== null) {
+        tableNames.add(stripQuotes(match[1]));
+    }
+    return tableNames;
+}
+/**
+ * 解析 INSERT VALUES 行数（DML 批量上限校验用）
+ * @returns 行数；无法解析（如 INSERT ... SELECT）返回 0
+ */
+export function countInsertValueRows(sql) {
+    const s = stripSqlForSearch(sql);
+    const m = s.match(/\bINSERT\b[\s\S]*?\bVALUES\s*/i);
+    if (!m || m.index === undefined)
+        return 0;
+    const rest = s.slice(m.index + m[0].length);
+    // 取到第一个完整的括号组（VALUES (..),(..),...）
+    let depth = 0;
+    let groups = 0;
+    let inParen = false;
+    for (let i = 0; i < rest.length; i++) {
+        const ch = rest[i];
+        if (ch === '(') {
+            if (!inParen) {
+                inParen = true;
+                groups++;
+            }
+            depth++;
+        }
+        else if (ch === ')') {
+            depth--;
+            if (depth === 0) {
+                inParen = false;
+                // 括号组结束后，若下一非空字符不是逗号，说明 VALUES 结束
+                let j = i + 1;
+                while (j < rest.length && /\s/.test(rest[j]))
+                    j++;
+                if (rest[j] !== ',')
+                    break;
+            }
+        }
+    }
+    return groups;
+}
+//# sourceMappingURL=statement.js.map

package/lib/core/sql/statement.js.map

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

package/lib/core/sql/table-mapper.d.ts

@@ -0,0 +1,24 @@
+/**
+ * SQL 表名映射工具（迁移自 WizBuild sql-table-mapper.ts）
+ * 将用户 SQL 中的逻辑表名（可能带 schema 前缀）替换为物理表名（如 SQLite 表名）
+ *
+ * 支持格式：
+ * - 裸表名：FROM 表名 / FROM "表名" / FROM '表名' / FROM `表名`
+ * - Schema 限定：FROM "数据源名"."数据表名" / FROM 数据源名.数据表名
+ * - 带 alias：FROM "表名" AS t / FROM "表名" t
+ */
+/**
+ * 替换 SQL 中的表名为物理表名
+ * @param mapping 逻辑表名 → 物理表名；复合 key（"数据源名.表名"）优先于裸名
+ */
+export declare function replaceTableNamesInSql(sql: string, tableNameMapping: Map<string, string>): string;
+/** 去除标识符引号 */
+export declare function stripQuotes(identifier: string): string;
+/** 从 SQL 中提取用户引用的表名（裸名 + schema-qualified） */
+export declare function extractTableNamesFromSql(sql: string): Set<string>;
+/** 验证表名替换结果，返回警告列表 */
+export declare function validateTableNameReplacement(originalSql: string, replacedSql: string, tableNameMapping: Map<string, string>): {
+    valid: boolean;
+    warnings: string[];
+};
+//# sourceMappingURL=table-mapper.d.ts.map

package/lib/core/sql/table-mapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"table-mapper.d.ts","sourceRoot":"","sources":["../../../src/core/sql/table-mapper.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAcH;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,MAAM,EACX,gBAAgB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GACpC,MAAM,CAgER;AAED,cAAc;AACd,wBAAgB,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAStD;AAED,8CAA8C;AAC9C,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAkCjE;AAED,sBAAsB;AACtB,wBAAgB,4BAA4B,CAC1C,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,gBAAgB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GACpC;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,CAwBxC"}

package/lib/core/sql/table-mapper.js

@@ -0,0 +1,113 @@
+/**
+ * SQL 表名映射工具（迁移自 WizBuild sql-table-mapper.ts）
+ * 将用户 SQL 中的逻辑表名（可能带 schema 前缀）替换为物理表名（如 SQLite 表名）
+ *
+ * 支持格式：
+ * - 裸表名：FROM 表名 / FROM "表名" / FROM '表名' / FROM `表名`
+ * - Schema 限定：FROM "数据源名"."数据表名" / FROM 数据源名.数据表名
+ * - 带 alias：FROM "表名" AS t / FROM "表名" t
+ */
+const TABLE_KEYWORDS = 'FROM|JOIN|INNER\\s+JOIN|LEFT\\s+JOIN|RIGHT\\s+JOIN|FULL\\s+JOIN|CROSS\\s+JOIN';
+const ANY_QUOTED_IDENTIFIER = `(?:"[^"]+"|'[^']+'|\`[^\`]+\`)`;
+const BARE_IDENTIFIER = '[a-zA-Z_\\u4e00-\\u9fff][a-zA-Z0-9_\\u4e00-\\u9fff]*';
+const IDENTIFIER = `(?:${ANY_QUOTED_IDENTIFIER}|${BARE_IDENTIFIER})`;
+const SCHEMA_PREFIX = `(?:${IDENTIFIER}\\.)`;
+const ALIAS_PATTERN = '(?:\\s+(?:AS\\s+)?(?:' + IDENTIFIER + '))?';
+/** 将 tableNameMapping 的 entries 按 key 长度降序排序（复合 key 优先） */
+function sortMappingEntries(mapping) {
+    return [...mapping.entries()].sort((a, b) => b[0].length - a[0].length);
+}
+/**
+ * 替换 SQL 中的表名为物理表名
+ * @param mapping 逻辑表名 → 物理表名；复合 key（"数据源名.表名"）优先于裸名
+ */
+export function replaceTableNamesInSql(sql, tableNameMapping) {
+    let result = sql;
+    for (const [tableName, sqliteTableName] of sortMappingEntries(tableNameMapping)) {
+        const isCompoundKey = tableName.includes('.');
+        if (isCompoundKey) {
+            const [schemaPart, tablePart] = tableName.split('.', 2);
+            const escapedSchema = escapeRegExp(schemaPart);
+            const escapedTable = escapeRegExp(tablePart);
+            const doubleQuotedCompound = new RegExp(`(\\b(?:${TABLE_KEYWORDS})\\s+)"${escapedSchema}"\\."${escapedTable}"(${ALIAS_PATTERN})`, 'gi');
+            result = result.replace(doubleQuotedCompound, `$1"${sqliteTableName}"$2`);
+            const singleQuotedCompound = new RegExp(`(\\b(?:${TABLE_KEYWORDS})\\s+)'${escapedSchema}'\\.'${escapedTable}'(${ALIAS_PATTERN})`, 'gi');
+            result = result.replace(singleQuotedCompound, `$1"${sqliteTableName}"$2`);
+            const backtickQuotedCompound = new RegExp(`(\\b(?:${TABLE_KEYWORDS})\\s+)\`${escapedSchema}\`\\.\`${escapedTable}\`(${ALIAS_PATTERN})`, 'gi');
+            result = result.replace(backtickQuotedCompound, `$1"${sqliteTableName}"$2`);
+            const bareCompound = new RegExp(`(\\b(?:${TABLE_KEYWORDS})\\s+)${escapedSchema}\\.${escapedTable}(${ALIAS_PATTERN})`, 'gi');
+            result = result.replace(bareCompound, `$1"${sqliteTableName}"$2`);
+        }
+        else {
+            const escapedName = escapeRegExp(tableName);
+            const doubleQuoted = new RegExp(`(\\b(?:${TABLE_KEYWORDS})\\s+)(?:${SCHEMA_PREFIX})?"${escapedName}"(${ALIAS_PATTERN})`, 'gi');
+            result = result.replace(doubleQuoted, `$1"${sqliteTableName}"$2`);
+            const singleQuoted = new RegExp(`(\\b(?:${TABLE_KEYWORDS})\\s+)(?:${SCHEMA_PREFIX})?'${escapedName}'(${ALIAS_PATTERN})`, 'gi');
+            result = result.replace(singleQuoted, `$1"${sqliteTableName}"$2`);
+            const backtickQuoted = new RegExp(`(\\b(?:${TABLE_KEYWORDS})\\s+)(?:${SCHEMA_PREFIX})?\`${escapedName}\`(${ALIAS_PATTERN})`, 'gi');
+            result = result.replace(backtickQuoted, `$1"${sqliteTableName}"$2`);
+            const bareName = new RegExp(`(\\b(?:${TABLE_KEYWORDS})\\s+)(?:${SCHEMA_PREFIX})?${escapedName}(${ALIAS_PATTERN})`, 'gi');
+            result = result.replace(bareName, `$1"${sqliteTableName}"$2`);
+        }
+    }
+    return result;
+}
+/** 去除标识符引号 */
+export function stripQuotes(identifier) {
+    if ((identifier.startsWith('"') && identifier.endsWith('"')) ||
+        (identifier.startsWith("'") && identifier.endsWith("'")) ||
+        (identifier.startsWith('`') && identifier.endsWith('`'))) {
+        return identifier.slice(1, -1);
+    }
+    return identifier;
+}
+/** 从 SQL 中提取用户引用的表名（裸名 + schema-qualified） */
+export function extractTableNamesFromSql(sql) {
+    const tableNames = new Set();
+    const compoundDoubleQuoted = new RegExp(`\\b(?:${TABLE_KEYWORDS})\\s+(${ANY_QUOTED_IDENTIFIER})\\.(${ANY_QUOTED_IDENTIFIER})`, 'gi');
+    let match;
+    while ((match = compoundDoubleQuoted.exec(sql)) !== null) {
+        tableNames.add(`${stripQuotes(match[1])}.${stripQuotes(match[2])}`);
+    }
+    const compoundBare = new RegExp(`\\b(?:${TABLE_KEYWORDS})\\s+(${BARE_IDENTIFIER})\\.(${BARE_IDENTIFIER})`, 'gi');
+    while ((match = compoundBare.exec(sql)) !== null) {
+        tableNames.add(`${match[1]}.${match[2]}`);
+    }
+    const simpleNamePattern = new RegExp(`\\b(?:${TABLE_KEYWORDS})\\s+(${ANY_QUOTED_IDENTIFIER}|${BARE_IDENTIFIER})`, 'gi');
+    while ((match = simpleNamePattern.exec(sql)) !== null) {
+        const name = stripQuotes(match[1]);
+        let isCompoundPart = false;
+        tableNames.forEach((existing) => {
+            if (existing.endsWith(`.${name}`))
+                isCompoundPart = true;
+        });
+        if (!isCompoundPart)
+            tableNames.add(name);
+    }
+    return tableNames;
+}
+/** 验证表名替换结果，返回警告列表 */
+export function validateTableNameReplacement(originalSql, replacedSql, tableNameMapping) {
+    const warnings = [];
+    const originalTableNames = extractTableNamesFromSql(originalSql);
+    for (const name of originalTableNames) {
+        const bareName = name.includes('.') ? name.split('.').pop() : name;
+        const hasMapping = tableNameMapping.has(name) || tableNameMapping.has(bareName);
+        if (!hasMapping) {
+            warnings.push(`表 "${name}" 在映射中未找到对应的物理表名`);
+        }
+    }
+    for (const [logicalName] of tableNameMapping) {
+        const bareName = logicalName.includes('.') ? logicalName.split('.').pop() : logicalName;
+        const residualPattern = new RegExp(`\\b(?:${TABLE_KEYWORDS})\\s+(?:${SCHEMA_PREFIX})?"${escapeRegExp(bareName)}"`, 'gi');
+        if (residualPattern.test(replacedSql)) {
+            warnings.push(`表 "${bareName}" 可能未被替换`);
+        }
+    }
+    return { valid: warnings.length === 0, warnings };
+}
+/** 正则转义 */
+function escapeRegExp(str) {
+    return str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+//# sourceMappingURL=table-mapper.js.map

package/lib/core/sql/table-mapper.js.map

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

package/lib/core/task-queue.d.ts

@@ -0,0 +1,31 @@
+import type { IntrospectRunner, IntrospectTask } from '../types/task.js';
+import type { EnqueueOptions, TaskQueue, TaskQueueOptions, WorkerTaskSpec } from '../types/queue.js';
+export declare class TaskQueueImpl implements TaskQueue {
+    private options;
+    private queue;
+    private active;
+    private closed;
+    private seq;
+    private idleWaiters;
+    private workerBackend;
+    private workerBackendPromise;
+    constructor(options?: TaskQueueOptions);
+    /** 默认并发 = CPU 数 */
+    private get concurrency();
+    size(): number;
+    /**
+     * 入队执行
+     * - 传函数：进程内异步执行（I/O 密集任务默认方式）
+     * - 传 WorkerTaskSpec + opts.worker=true：offload 到 worker 线程（CPU 密集任务）
+     */
+    enqueue<T>(fn: (() => T | Promise<T>) | WorkerTaskSpec, opts?: EnqueueOptions): Promise<T>;
+    /** 长任务形态：支持进度上报与取消 */
+    introspect<T>(runner: IntrospectRunner<T>): IntrospectTask<T>;
+    waitIdle(): Promise<void>;
+    close(): Promise<void>;
+    private pump;
+    private execute;
+    private runInWorker;
+    private getWorkerBackend;
+}
+//# sourceMappingURL=task-queue.d.ts.map

package/lib/core/task-queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-queue.d.ts","sourceRoot":"","sources":["../../src/core/task-queue.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAqB,gBAAgB,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAC5F,OAAO,KAAK,EACV,cAAc,EACd,SAAS,EACT,gBAAgB,EAChB,cAAc,EACf,MAAM,mBAAmB,CAAC;AAY3B,qBAAa,aAAc,YAAW,SAAS;IASjC,OAAO,CAAC,OAAO;IAR3B,OAAO,CAAC,KAAK,CAAmB;IAChC,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,GAAG,CAAK;IAChB,OAAO,CAAC,WAAW,CAAsB;IACzC,OAAO,CAAC,aAAa,CAA8B;IACnD,OAAO,CAAC,oBAAoB,CAAuC;gBAE/C,OAAO,GAAE,gBAAqB;IAElD,mBAAmB;IACnB,OAAO,KAAK,WAAW,GAEtB;IAED,IAAI,IAAI,MAAM;IAId;;;;OAIG;IACH,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,cAAc,EAAE,IAAI,GAAE,cAAmB,GAAG,OAAO,CAAC,CAAC,CAAC;IA8C9F,sBAAsB;IACtB,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC;IAM7D,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAOnB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAgB5B,OAAO,CAAC,IAAI;YAeE,OAAO;IA6BrB,OAAO,CAAC,WAAW;IAInB,OAAO,CAAC,gBAAgB;CAqBzB"}