@fett/sql-translator 0.0.1-beta

package/lib/client/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/client/registry.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,KAAK,EAAE,oBAAoB,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAW7E,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAAiC;IAC9C,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,UAAU,CAAU;IAC5B,OAAO,CAAC,YAAY,CAAS;gBAEjB,OAAO,GAAE,oBAAyB;IAM9C;;;OAGG;IACG,OAAO,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,UAAU,CAAC;IAqC5D,kCAAkC;IAClC,OAAO,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IASlC,mCAAmC;IAC7B,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAUpD,iBAAiB;IACX,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAWjC,mBAAmB;IACnB,OAAO,IAAI,WAAW;IA0BtB,iDAAiD;IACjD,OAAO,CAAC,gBAAgB;IAexB,iBAAiB;IACX,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7B;AAED,uBAAuB;AACvB,eAAO,MAAM,eAAe,cAAqB,CAAC"}

package/lib/client/registry.js

@@ -0,0 +1,128 @@
+/**
+ * 全局连接池注册表（模块级单例）
+ * 所有入口共享：createClient / ClientManager / SqlEngine / 函数式 API
+ * 职责：按 config 指纹缓存池、引用计数、LRU 空闲淘汰、指标统计
+ */
+import { configKey } from '../core/config.js';
+import { SqlEngineError } from '../errors.js';
+import { getDriver, hasDriver } from '../driver/registry.js';
+export class PoolRegistry {
+    pools = new Map();
+    totalRefs = 0;
+    maxClients;
+    lruEnabled;
+    maxIdlePools;
+    constructor(options = {}) {
+        this.maxClients = options.maxClients ?? 500;
+        this.lruEnabled = options.lru?.enabled ?? true;
+        this.maxIdlePools = options.lru?.maxIdlePools ?? 50;
+    }
+    /**
+     * 获取/创建连接池并 +1 引用
+     * 首次遇到某指纹时懒创建池；之后复用（不按请求建池）
+     */
+    async getPool(config) {
+        if (!hasDriver(config.type)) {
+            throw new SqlEngineError('UNSUPPORTED_DIALECT', `方言 "${config.type}" 驱动未注册（M2+ 提供 mysql/postgresql/mongodb，当前可用: sqlite）`, { dialect: config.type });
+        }
+        if (this.totalRefs >= this.maxClients) {
+            throw new SqlEngineError('CLIENT_LIMIT_EXCEEDED', `全局 client 数达到上限 ${this.maxClients}（ClientManagerOptions.maxClients 可调）`);
+        }
+        const fingerprint = configKey(config);
+        let record = this.pools.get(fingerprint);
+        if (!record) {
+            record = { fingerprint, config, handle: null, creating: null, refs: 0, lastUsedAt: Date.now() };
+            this.pools.set(fingerprint, record);
+        }
+        if (!record.handle) {
+            record.creating ??= getDriver(config.type).createPool(config);
+            try {
+                record.handle = await record.creating;
+            }
+            finally {
+                record.creating = null;
+            }
+        }
+        record.refs++;
+        record.lastUsedAt = Date.now();
+        this.totalRefs++;
+        return record.handle;
+    }
+    /** -1 引用；归零的池进入空闲集合（LRU 超限时回收） */
+    release(fingerprint) {
+        const record = this.pools.get(fingerprint);
+        if (!record)
+            return;
+        record.refs = Math.max(0, record.refs - 1);
+        this.totalRefs = Math.max(0, this.totalRefs - 1);
+        record.lastUsedAt = Date.now();
+        this.maybeCollectIdle();
+    }
+    /** 强制销毁池（数据源 update/remove 时调用） */
+    async invalidate(fingerprint) {
+        const record = this.pools.get(fingerprint);
+        if (!record)
+            return;
+        this.pools.delete(fingerprint);
+        this.totalRefs = Math.max(0, this.totalRefs - record.refs);
+        if (record.handle) {
+            await record.handle.destroy().catch(() => undefined);
+        }
+    }
+    /** 全局清理（应用退出） */
+    async destroyAll() {
+        const records = [...this.pools.values()];
+        this.pools.clear();
+        this.totalRefs = 0;
+        await Promise.all(records.map((r) => r.handle ? r.handle.destroy().catch(() => undefined) : Promise.resolve()));
+    }
+    /** 池指标（监控/容量规划） */
+    metrics() {
+        let active = 0;
+        let idle = 0;
+        let waiting = 0;
+        let createdTotal = 0;
+        let destroyedTotal = 0;
+        for (const r of this.pools.values()) {
+            if (!r.handle)
+                continue;
+            const s = r.handle.stats;
+            active += s.active;
+            idle += s.idle;
+            waiting += s.waiting;
+            createdTotal += s.createdTotal;
+            destroyedTotal += s.destroyedTotal;
+        }
+        return {
+            clients: this.totalRefs,
+            pools: this.pools.size,
+            active,
+            idle,
+            waiting,
+            createdTotal,
+            destroyedTotal,
+        };
+    }
+    /** 空闲池 LRU 淘汰：引用归零的池超过 maxIdlePools 时，回收最久未用者 */
+    maybeCollectIdle() {
+        if (!this.lruEnabled)
+            return;
+        const idleRecords = [...this.pools.values()]
+            .filter((r) => r.refs === 0 && r.handle)
+            .sort((a, b) => a.lastUsedAt - b.lastUsedAt);
+        const over = idleRecords.length - this.maxIdlePools;
+        if (over <= 0)
+            return;
+        for (const record of idleRecords.slice(0, over)) {
+            this.pools.delete(record.fingerprint);
+            void record.handle.destroy().catch(() => undefined);
+        }
+    }
+    /** 测试辅助：清空注册表 */
+    async reset() {
+        await this.destroyAll();
+    }
+}
+/** 模块级默认注册表（所有入口共享） */
+export const defaultRegistry = new PoolRegistry();
+//# sourceMappingURL=registry.js.map

package/lib/client/registry.js.map

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

package/lib/core/cache.d.ts

@@ -0,0 +1,28 @@
+/**
+ * TTL + LRU 缓存（查询结果缓存用）
+ */
+export interface CacheEntry<V> {
+    value: V;
+    expiresAt: number;
+    /** 最近使用时间戳（LRU 淘汰） */
+    lastUsedAt: number;
+}
+export declare class TtlCache<K, V> {
+    private ttlMs;
+    private maxEntries;
+    private map;
+    constructor(ttlMs: number, maxEntries?: number);
+    get(key: K): V | undefined;
+    set(key: K, value: V): void;
+    delete(key: K): void;
+    clear(): void;
+    get size(): number;
+}
+/** 查询缓存 key：config 指纹 + 请求参数序列化 */
+export declare function queryCacheKey(fingerprint: string, sql: string, request: {
+    offset?: number;
+    limit?: number;
+    whereClause?: string;
+    params?: unknown[];
+}): string;
+//# sourceMappingURL=cache.d.ts.map

package/lib/core/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/core/cache.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,UAAU,CAAC,CAAC;IAC3B,KAAK,EAAE,CAAC,CAAC;IACT,SAAS,EAAE,MAAM,CAAC;IAClB,sBAAsB;IACtB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,QAAQ,CAAC,CAAC,EAAE,CAAC;IAItB,OAAO,CAAC,KAAK;IACb,OAAO,CAAC,UAAU;IAJpB,OAAO,CAAC,GAAG,CAA+B;gBAGhC,KAAK,EAAE,MAAM,EACb,UAAU,SAAO;IAG3B,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,SAAS;IAW1B,GAAG,CAAC,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI;IAc3B,MAAM,CAAC,GAAG,EAAE,CAAC,GAAG,IAAI;IAIpB,KAAK,IAAI,IAAI;IAIb,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF;AAED,mCAAmC;AACnC,wBAAgB,aAAa,CAC3B,WAAW,EAAE,MAAM,EACnB,GAAG,EAAE,MAAM,EACX,OAAO,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAA;CAAE,GACrF,MAAM,CAYR"}

package/lib/core/cache.js

@@ -0,0 +1,58 @@
+export class TtlCache {
+    ttlMs;
+    maxEntries;
+    map = new Map();
+    constructor(ttlMs, maxEntries = 1000) {
+        this.ttlMs = ttlMs;
+        this.maxEntries = maxEntries;
+    }
+    get(key) {
+        const entry = this.map.get(key);
+        if (!entry)
+            return undefined;
+        if (Date.now() > entry.expiresAt) {
+            this.map.delete(key);
+            return undefined;
+        }
+        entry.lastUsedAt = Date.now();
+        return entry.value;
+    }
+    set(key, value) {
+        const now = Date.now();
+        if (this.map.has(key)) {
+            this.map.delete(key); // 保持插入序 = 使用序（LRU）
+        }
+        this.map.set(key, { value, expiresAt: now + this.ttlMs, lastUsedAt: now });
+        // 容量超限：淘汰最旧（Map 插入序第一个）
+        while (this.map.size > this.maxEntries) {
+            const oldestKey = this.map.keys().next().value;
+            if (oldestKey === undefined)
+                break;
+            this.map.delete(oldestKey);
+        }
+    }
+    delete(key) {
+        this.map.delete(key);
+    }
+    clear() {
+        this.map.clear();
+    }
+    get size() {
+        return this.map.size;
+    }
+}
+/** 查询缓存 key：config 指纹 + 请求参数序列化 */
+export function queryCacheKey(fingerprint, sql, request) {
+    const parts = [
+        fingerprint,
+        String(sql),
+        String(request.offset ?? ''),
+        String(request.limit ?? ''),
+        String(request.whereClause ?? ''),
+    ];
+    if (request.params?.length) {
+        parts.push(JSON.stringify(request.params));
+    }
+    return parts.join('|');
+}
+//# sourceMappingURL=cache.js.map

package/lib/core/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../src/core/cache.ts"],"names":[],"mappings":"AAUA,MAAM,OAAO,QAAQ;IAIT;IACA;IAJF,GAAG,GAAG,IAAI,GAAG,EAAoB,CAAC;IAE1C,YACU,KAAa,EACb,aAAa,IAAI;QADjB,UAAK,GAAL,KAAK,CAAQ;QACb,eAAU,GAAV,UAAU,CAAO;IACxB,CAAC;IAEJ,GAAG,CAAC,GAAM;QACR,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAChC,IAAI,CAAC,KAAK;YAAE,OAAO,SAAS,CAAC;QAC7B,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,SAAS,EAAE,CAAC;YACjC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACrB,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,KAAK,CAAC,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC,KAAK,CAAC;IACrB,CAAC;IAED,GAAG,CAAC,GAAM,EAAE,KAAQ;QAClB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACtB,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,mBAAmB;QAC3C,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,GAAG,IAAI,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC,CAAC;QAC3E,wBAAwB;QACxB,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;YACvC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC;YAC/C,IAAI,SAAS,KAAK,SAAS;gBAAE,MAAM;YACnC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;IAED,MAAM,CAAC,GAAM;QACX,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACvB,CAAC;IAED,KAAK;QACH,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC;IACnB,CAAC;IAED,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC;IACvB,CAAC;CACF;AAED,mCAAmC;AACnC,MAAM,UAAU,aAAa,CAC3B,WAAmB,EACnB,GAAW,EACX,OAAsF;IAEtF,MAAM,KAAK,GAAG;QACZ,WAAW;QACX,MAAM,CAAC,GAAG,CAAC;QACX,MAAM,CAAC,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC;QAC5B,MAAM,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC;QAC3B,MAAM,CAAC,OAAO,CAAC,WAAW,IAAI,EAAE,CAAC;KAClC,CAAC;IACF,IAAI,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;QAC3B,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;IAC7C,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACzB,CAAC"}

package/lib/core/config.d.ts

@@ -0,0 +1,16 @@
+/**
+ * 连接配置归一化与指纹计算
+ */
+import type { ConnectionConfig } from '../types/config.js';
+/** 默认端口 */
+export declare const DEFAULT_PORTS: Record<string, number>;
+/** 归一化配置：填充默认值（端口、用户名别名等），不修改入参 */
+export declare function normalizeConfig(config: ConnectionConfig): ConnectionConfig;
+/**
+ * 计算连接配置指纹（连接池注册表 key）
+ * 密码变更 → 指纹变化 → 不复用旧池；用 \x00 作分隔符防止字段值拼接碰撞
+ */
+export declare function fingerprintConfig(config: ConnectionConfig): string;
+/** 规范化 + 指纹一步完成 */
+export declare function configKey(config: ConnectionConfig): string;
+//# sourceMappingURL=config.d.ts.map

package/lib/core/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/core/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAc,MAAM,oBAAoB,CAAC;AAEvE,WAAW;AACX,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAMhD,CAAC;AAEF,mCAAmC;AACnC,wBAAgB,eAAe,CAAC,MAAM,EAAE,gBAAgB,GAAG,gBAAgB,CAiB1E;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAsBlE;AAED,mBAAmB;AACnB,wBAAgB,SAAS,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAE1D"}

package/lib/core/config.js

@@ -0,0 +1,47 @@
+/**
+ * 连接配置归一化与指纹计算
+ */
+/** 默认端口 */
+export const DEFAULT_PORTS = {
+    mysql: 3306,
+    mariadb: 3306,
+    postgresql: 5432,
+    sqlite: 0,
+    mongodb: 27017,
+};
+/** 归一化配置：填充默认值（端口、用户名别名等），不修改入参 */
+export function normalizeConfig(config) {
+    const out = { ...config };
+    // 兼容 user / username 字段名差异
+    if (out.user && !out.username)
+        out.username = out.user;
+    if (out.username && !out.user)
+        out.user = out.username;
+    if (out.port === undefined && DEFAULT_PORTS[config.type] !== undefined) {
+        out.port = DEFAULT_PORTS[config.type];
+    }
+    // 归一化 SSL
+    if (out.ssl && typeof out.ssl === 'object' && out.ssl.enabled === undefined) {
+        out.ssl = { enabled: true, ...out.ssl };
+    }
+    return out;
+}
+/**
+ * 计算连接配置指纹（连接池注册表 key）
+ * 密码变更 → 指纹变化 → 不复用旧池；用 \x00 作分隔符防止字段值拼接碰撞
+ */
+export function fingerprintConfig(config) {
+    const c = config;
+    const ssl = c.ssl;
+    const parts = [];
+    if (config.type === 'sqlite') {
+        return ['sqlite', String(c.database)].join('\x00');
+    }
+    parts.push(config.type, String(c.host ?? (config.type === 'mongodb' ? 'localhost' : '')), String(c.port ?? DEFAULT_PORTS[config.type] ?? ''), String(c.database ?? ''), String(c.user ?? c.username ?? ''), String(c.password ?? ''), String(c.schema ?? (config.type === 'postgresql' ? 'public' : '')), config.type === 'mariadb' ? 'mariadb' : '', ssl?.enabled ? `ssl:${ssl.mode ?? 'default'}` : 'nossl');
+    return parts.join('\x00');
+}
+/** 规范化 + 指纹一步完成 */
+export function configKey(config) {
+    return fingerprintConfig(normalizeConfig(config));
+}
+//# sourceMappingURL=config.js.map

package/lib/core/config.js.map

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

package/lib/core/field-mapper/mysql.d.ts

@@ -0,0 +1,42 @@
+/**
+ * MySQL/MariaDB 字段映射
+ * 统一展示：协议类型 ID / SHOW FULL COLUMNS 类型 → Field[]
+ */
+export interface MysqlColumn {
+    Field: string;
+    Type: string;
+    Null?: 'YES' | 'NO';
+    Key?: string;
+    Default?: any;
+    Extra?: string;
+    Comment?: string;
+}
+/** mysql2 wire protocol 字段类型 ID → 类型名 */
+export declare const MYSQL_PROTOCOL_TYPES: Record<number, string>;
+/** 将 MySQL/MariaDB 协议类型名映射为 SHOW FULL COLUMNS 风格的类型名 */
+export declare function normalizeMysqlFieldType(type: string): string;
+/** MySQL 类型 → 统一展示类型 */
+export declare function mysqlToDisplayType(mysqlType: string): string;
+/** 将 SHOW FULL COLUMNS 行 → Field[] */
+export declare function mapMysqlColumnsToFields(columns: MysqlColumn[]): {
+    field_name: string;
+    custom_name: string;
+    field_desc: string;
+    field_type: string;
+    display_type: string;
+    is_primary: 0 | 1;
+}[];
+/** 将 mysql2 wire protocol 元数据（fields[]）→ Field[] */
+export declare function mapMysqlProtocolFields(rawFields: Array<{
+    name: string;
+    type: number;
+    default?: unknown;
+}>): {
+    field_name: string;
+    custom_name: string;
+    field_desc: string;
+    field_type: string;
+    display_type: string;
+    is_primary: 0 | 1;
+}[];
+//# sourceMappingURL=mysql.d.ts.map

package/lib/core/field-mapper/mysql.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mysql.d.ts","sourceRoot":"","sources":["../../../src/core/field-mapper/mysql.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,GAAG,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,yCAAyC;AACzC,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CA6BvD,CAAC;AAkCF,wDAAwD;AACxD,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE5D;AAED,wBAAwB;AACxB,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CA6B5D;AAED,sCAAsC;AACtC,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,WAAW,EAAE;;;;;;;IAgB7D;AAED,oDAAoD;AACpD,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;;;;;;;IAQpE"}

package/lib/core/field-mapper/mysql.js

@@ -0,0 +1,129 @@
+/**
+ * MySQL/MariaDB 字段映射
+ * 统一展示：协议类型 ID / SHOW FULL COLUMNS 类型 → Field[]
+ */
+/** mysql2 wire protocol 字段类型 ID → 类型名 */
+export const MYSQL_PROTOCOL_TYPES = {
+    0: 'DECIMAL',
+    1: 'TINY',
+    2: 'SHORT',
+    3: 'LONG',
+    4: 'FLOAT',
+    5: 'DOUBLE',
+    6: 'NULL',
+    7: 'TIMESTAMP',
+    8: 'LONGLONG',
+    9: 'INT24',
+    10: 'DATE',
+    11: 'TIME',
+    12: 'DATETIME',
+    13: 'YEAR',
+    14: 'NEWDATE',
+    15: 'VARCHAR',
+    16: 'BIT',
+    245: 'JSON',
+    246: 'NEWDECIMAL',
+    247: 'ENUM',
+    248: 'SET',
+    249: 'TINY_BLOB',
+    250: 'MEDIUM_BLOB',
+    251: 'LONG_BLOB',
+    252: 'BLOB',
+    253: 'VAR_STRING',
+    254: 'STRING',
+    255: 'GEOMETRY',
+};
+/** 协议类型名 → SHOW FULL COLUMNS 风格类型名 */
+const MYSQL_PROTOCOL_TYPE_MAP = {
+    DECIMAL: 'decimal',
+    TINY: 'tinyint',
+    SHORT: 'smallint',
+    LONG: 'int',
+    FLOAT: 'float',
+    DOUBLE: 'double',
+    LONGLONG: 'bigint',
+    INT24: 'mediumint',
+    DATE: 'date',
+    TIME: 'time',
+    DATETIME: 'datetime',
+    TIMESTAMP: 'timestamp',
+    YEAR: 'year',
+    NEWDATE: 'date',
+    VARCHAR: 'varchar',
+    BIT: 'bit',
+    JSON: 'json',
+    NEWDECIMAL: 'decimal',
+    ENUM: 'enum',
+    SET: 'set',
+    TINY_BLOB: 'tinyblob',
+    MEDIUM_BLOB: 'mediumblob',
+    LONG_BLOB: 'longblob',
+    BLOB: 'blob',
+    VAR_STRING: 'varchar',
+    STRING: 'char',
+    GEOMETRY: 'geometry',
+    NULL: 'null',
+};
+/** 将 MySQL/MariaDB 协议类型名映射为 SHOW FULL COLUMNS 风格的类型名 */
+export function normalizeMysqlFieldType(type) {
+    return MYSQL_PROTOCOL_TYPE_MAP[type] || type;
+}
+/** MySQL 类型 → 统一展示类型 */
+export function mysqlToDisplayType(mysqlType) {
+    const t = String(mysqlType).toLowerCase();
+    if (t.startsWith('varchar') || t.startsWith('char'))
+        return 'string';
+    if (t.includes('text') || t.startsWith('enum') || t.startsWith('set'))
+        return 'string';
+    if (t.startsWith('int') ||
+        t.startsWith('integer') ||
+        t.startsWith('tinyint') ||
+        t.startsWith('smallint') ||
+        t.startsWith('mediumint') ||
+        t.startsWith('bigint') ||
+        t.startsWith('decimal') ||
+        t.startsWith('numeric') ||
+        t.startsWith('float') ||
+        t.startsWith('double') ||
+        t.startsWith('bit'))
+        return t.startsWith('tinyint(1)') ? 'boolean' : 'number';
+    if (t.startsWith('date') ||
+        t.startsWith('datetime') ||
+        t.startsWith('timestamp') ||
+        t.startsWith('time') ||
+        t.startsWith('year'))
+        return 'date';
+    if (t.startsWith('json'))
+        return 'json';
+    if (t.includes('blob') || t.startsWith('binary') || t.startsWith('varbinary'))
+        return 'binary';
+    return 'string';
+}
+/** 将 SHOW FULL COLUMNS 行 → Field[] */
+export function mapMysqlColumnsToFields(columns) {
+    return (columns || []).map((col) => {
+        const fieldName = col.Field;
+        const fieldType = normalizeMysqlFieldType(col.Type);
+        const displayType = mysqlToDisplayType(fieldType);
+        const isPrimary = String(col.Key || '').toUpperCase() === 'PRI' ? 1 : 0;
+        const desc = col.Comment ?? '';
+        return {
+            field_name: fieldName,
+            custom_name: fieldName,
+            field_desc: desc,
+            field_type: fieldType,
+            display_type: displayType,
+            is_primary: isPrimary,
+        };
+    });
+}
+/** 将 mysql2 wire protocol 元数据（fields[]）→ Field[] */
+export function mapMysqlProtocolFields(rawFields) {
+    const columns = (rawFields || []).map((field) => ({
+        Field: field.name,
+        Type: MYSQL_PROTOCOL_TYPES[field.type] ?? 'text',
+        Default: field.default,
+    }));
+    return mapMysqlColumnsToFields(columns);
+}
+//# sourceMappingURL=mysql.js.map

package/lib/core/field-mapper/mysql.js.map

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

package/lib/core/field-mapper/postgresql.d.ts

@@ -0,0 +1,25 @@
+/**
+ * PostgreSQL 字段映射（迁移自 WizBuild postgresql-analyzer.ts）
+ */
+export interface PostgresColumn {
+    Field: string;
+    Type: string;
+    Null?: 'YES' | 'NO';
+    Key?: string;
+    Default?: any;
+    Comment?: string;
+}
+/** PostgreSQL 类型 → 统一展示类型 */
+export declare function postgresToDisplayType(pgType: string): string;
+/** 将 pg_type.typname 映射为 information_schema 风格的 data_type */
+export declare function normalizePostgresFieldType(typname: string): string;
+/** information_schema.columns 行 → Field[] */
+export declare function mapPostgresColumnsToFields(columns: PostgresColumn[]): {
+    field_name: string;
+    custom_name: string;
+    field_desc: string;
+    field_type: string;
+    display_type: string;
+    is_primary: 0 | 1;
+}[];
+//# sourceMappingURL=postgresql.d.ts.map

package/lib/core/field-mapper/postgresql.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgresql.d.ts","sourceRoot":"","sources":["../../../src/core/field-mapper/postgresql.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,GAAG,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,6BAA6B;AAC7B,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CA6D5D;AA6BD,6DAA6D;AAC7D,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAQlE;AAED,6CAA6C;AAC7C,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,cAAc,EAAE;;;;;;;IAgBnE"}

package/lib/core/field-mapper/postgresql.js

@@ -0,0 +1,121 @@
+/** PostgreSQL 类型 → 统一展示类型 */
+export function postgresToDisplayType(pgType) {
+    const t = String(pgType).toLowerCase();
+    // 字符类型
+    if (t.startsWith('character varying') ||
+        t.startsWith('varchar') ||
+        t.startsWith('char') ||
+        t.startsWith('character') ||
+        t === 'text')
+        return 'string';
+    // 整数类型（含 pg_type.typname 内部名称）
+    if (t === 'smallint' ||
+        t === 'integer' ||
+        t === 'int' ||
+        t === 'bigint' ||
+        t === 'smallserial' ||
+        t === 'serial' ||
+        t === 'bigserial' ||
+        t === 'int2' ||
+        t === 'int4' ||
+        t === 'int8' ||
+        t === 'serial2' ||
+        t === 'serial4' ||
+        t === 'serial8')
+        return 'number';
+    // 浮点/定点类型
+    if (t.startsWith('decimal') ||
+        t.startsWith('numeric') ||
+        t === 'real' ||
+        t === 'double precision' ||
+        t.startsWith('float') ||
+        t === 'float4' ||
+        t === 'float8')
+        return 'number';
+    // 布尔类型
+    if (t === 'boolean' || t === 'bool')
+        return 'boolean';
+    // 日期时间类型
+    if (t === 'date' ||
+        t.startsWith('timestamp') ||
+        t.startsWith('time') ||
+        t === 'interval' ||
+        t === 'timestamptz' ||
+        t === 'timetz')
+        return 'date';
+    // JSON 类型
+    if (t === 'json' || t === 'jsonb')
+        return 'json';
+    // 二进制类型
+    if (t === 'bytea')
+        return 'binary';
+    // UUID、数组、复合类型等
+    if (t === 'uuid')
+        return 'string';
+    if (t.startsWith('array'))
+        return 'string';
+    // 枚举类型（typname 通常自定义名）
+    if (t.endsWith('_enum') || t === 'user-defined')
+        return 'string';
+    return 'string';
+}
+/** pg_type.typname（内部名称）→ information_schema.data_type 格式 */
+const PG_INTERNAL_TYPE_MAP = {
+    int2: 'smallint',
+    int4: 'integer',
+    int8: 'bigint',
+    serial2: 'smallserial',
+    serial4: 'serial',
+    serial8: 'bigserial',
+    float4: 'real',
+    float8: 'double precision',
+    bool: 'boolean',
+    varchar: 'character varying',
+    bpchar: 'character',
+    text: 'text',
+    timestamptz: 'timestamp with time zone',
+    timestamp: 'timestamp without time zone',
+    timetz: 'time with time zone',
+    time: 'time without time zone',
+    date: 'date',
+    numeric: 'numeric',
+    json: 'json',
+    jsonb: 'jsonb',
+    bytea: 'bytea',
+    uuid: 'uuid',
+    interval: 'interval',
+};
+/** 将 pg_type.typname 映射为 information_schema 风格的 data_type */
+export function normalizePostgresFieldType(typname) {
+    const lower = typname.toLowerCase();
+    if (PG_INTERNAL_TYPE_MAP[lower])
+        return PG_INTERNAL_TYPE_MAP[lower];
+    if (lower.startsWith('varchar'))
+        return 'character varying';
+    if (lower.startsWith('bpchar'))
+        return 'character';
+    if (lower.startsWith('numeric'))
+        return 'numeric';
+    if (lower.startsWith('_'))
+        return 'ARRAY';
+    return typname;
+}
+/** information_schema.columns 行 → Field[] */
+export function mapPostgresColumnsToFields(columns) {
+    return (columns || []).map((col) => {
+        const fieldName = col.Field;
+        const fieldType = normalizePostgresFieldType(col.Type);
+        const displayType = postgresToDisplayType(fieldType);
+        const isPrimary = String(col.Key || '').toUpperCase() === 'PRI' ? 1 : 0;
+        const desc = col.Comment ?? '';
+        return {
+            field_name: fieldName,
+            custom_name: fieldName,
+            field_desc: desc,
+            field_type: fieldType,
+            display_type: displayType,
+            is_primary: isPrimary,
+        };
+    });
+}
+//# sourceMappingURL=postgresql.js.map

package/lib/core/field-mapper/postgresql.js.map

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