@fett/sql-translator 0.0.1-beta

package/lib/types/config.js

@@ -0,0 +1,5 @@
+/**
+ * 连接配置类型（对外唯一入参）
+ */
+export {};
+//# sourceMappingURL=config.js.map

package/lib/types/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/types/config.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/lib/types/index.d.ts

@@ -0,0 +1,7 @@
+export * from './config.js';
+export * from './result.js';
+export * from './schema.js';
+export * from './task.js';
+export * from './queue.js';
+export * from './manager.js';
+//# sourceMappingURL=index.d.ts.map

package/lib/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC"}

package/lib/types/index.js

@@ -0,0 +1,7 @@
+export * from './config.js';
+export * from './result.js';
+export * from './schema.js';
+export * from './task.js';
+export * from './queue.js';
+export * from './manager.js';
+//# sourceMappingURL=index.js.map

package/lib/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC"}

package/lib/types/manager.d.ts

@@ -0,0 +1,37 @@
+/**
+ * ClientManager / 连接池注册表类型（多数据源平台）
+ */
+import type { PoolOptions } from './config.js';
+/** 每数据源池的实时状态 */
+export interface PoolStats {
+    active: number;
+    idle: number;
+    waiting: number;
+    createdTotal: number;
+    destroyedTotal: number;
+}
+/** 全局池指标（manager.metrics()） */
+export interface PoolMetrics {
+    /** 已登记 client 数 */
+    clients: number;
+    /** 存活的池数 */
+    pools: number;
+    active: number;
+    idle: number;
+    waiting: number;
+    createdTotal: number;
+    destroyedTotal: number;
+}
+export interface ClientManagerOptions {
+    /** 每数据源池默认参数 */
+    defaultPool?: PoolOptions;
+    /** 全局 client 数上限（防泄漏），默认 500 */
+    maxClients?: number;
+    /** 空闲池 LRU 淘汰 */
+    lru?: {
+        enabled?: boolean;
+        /** 空闲池数量上限，超过时淘汰最久未用的，默认 50 */
+        maxIdlePools?: number;
+    };
+}
+//# sourceMappingURL=manager.d.ts.map

package/lib/types/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/types/manager.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,iBAAiB;AACjB,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,+BAA+B;AAC/B,MAAM,WAAW,WAAW;IAC1B,mBAAmB;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,oBAAoB;IACnC,gBAAgB;IAChB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,gCAAgC;IAChC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iBAAiB;IACjB,GAAG,CAAC,EAAE;QACJ,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,+BAA+B;QAC/B,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC;CACH"}

package/lib/types/manager.js

@@ -0,0 +1,5 @@
+/**
+ * ClientManager / 连接池注册表类型（多数据源平台）
+ */
+export {};
+//# sourceMappingURL=manager.js.map

package/lib/types/manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.js","sourceRoot":"","sources":["../../src/types/manager.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/lib/types/queue.d.ts

@@ -0,0 +1,45 @@
+/**
+ * 任务队列类型（并发 / 优先级 / 超时 / 取消 / worker 多线程）
+ */
+import type { IntrospectTask, IntrospectRunner } from './task.js';
+/** 任务队列选项（config.queue 或 TaskQueue 构造参数） */
+export interface TaskQueueOptions {
+    /** 进程内异步并发，默认 = os.availableParallelism() */
+    concurrency?: number;
+    /** worker 线程数（CPU 密集任务池），默认 = min(4, cpu) */
+    workerCount?: number;
+    /** 是否启用 worker 线程，默认 true */
+    useWorkers?: boolean;
+    /** 任务默认超时（ms），默认不限制 */
+    timeoutMs?: number;
+}
+export interface EnqueueOptions {
+    /** 数值越大越先执行，默认 0 */
+    priority?: number;
+    /** true = offload 到 worker 线程池（CPU 密集任务）；需要任务可序列化（见 WorkerTaskSpec） */
+    worker?: boolean;
+    /** 取消排队中/执行中的任务 */
+    signal?: AbortSignal;
+    /** 单次任务超时覆盖（ms） */
+    timeoutMs?: number;
+}
+/** worker 任务规格：CPU 密集任务必须能以「模块 + 导出函数 + 参数」形式描述 */
+export interface WorkerTaskSpec {
+    /** 模块路径（绝对路径或可 import 的 specifier） */
+    module: string;
+    /** 模块导出的函数名 */
+    fn: string;
+    /** 序列化参数（structuredClone 兼容） */
+    args?: unknown[];
+}
+export interface TaskQueue {
+    enqueue<T>(fn: (() => T | Promise<T>) | WorkerTaskSpec, opts?: EnqueueOptions): Promise<T>;
+    /** 长任务形态：支持进度上报与取消（内部复用 core/task.ts 执行器） */
+    introspect<T>(runner: IntrospectRunner<T>): IntrospectTask<T>;
+    waitIdle(): Promise<void>;
+    /** 排队中任务数 */
+    size(): number;
+    /** 关闭队列与 worker 池；close 后 enqueue 报错 */
+    close(): Promise<void>;
+}
+//# sourceMappingURL=queue.d.ts.map

package/lib/types/queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue.d.ts","sourceRoot":"","sources":["../../src/types/queue.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAElE,4CAA4C;AAC5C,MAAM,WAAW,gBAAgB;IAC/B,6CAA6C;IAC7C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6CAA6C;IAC7C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6BAA6B;IAC7B,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,uBAAuB;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,oBAAoB;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uEAAuE;IACvE,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,mBAAmB;IACnB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,mBAAmB;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,mDAAmD;AACnD,MAAM,WAAW,cAAc;IAC7B,sCAAsC;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,eAAe;IACf,EAAE,EAAE,MAAM,CAAC;IACX,gCAAgC;IAChC,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,SAAS;IACxB,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,cAAc,EAAE,IAAI,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAC3F,6CAA6C;IAC7C,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC;IAC9D,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,aAAa;IACb,IAAI,IAAI,MAAM,CAAC;IACf,wCAAwC;IACxC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB"}

package/lib/types/queue.js

@@ -0,0 +1,5 @@
+/**
+ * 任务队列类型（并发 / 优先级 / 超时 / 取消 / worker 多线程）
+ */
+export {};
+//# sourceMappingURL=queue.js.map

package/lib/types/queue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue.js","sourceRoot":"","sources":["../../src/types/queue.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/lib/types/result.d.ts

@@ -0,0 +1,61 @@
+/**
+ * 统一查询/写操作结果类型
+ */
+/** 字段定义（统一展示结构） */
+export interface Field {
+    field_name: string;
+    custom_name: string;
+    field_desc?: string;
+    /** 方言原生类型（如 bigint / varchar(255) / int4） */
+    field_type: string;
+    /** 统一展示类型：string | number | boolean | date | json | binary | object | array */
+    display_type: string;
+    is_primary?: 0 | 1;
+}
+/** SELECT 查询结果 */
+export interface QueryResult {
+    rows: any[];
+    fields?: Field[];
+    /** 用户 SQL 自带 LIMIT 时为近似值（rows.length） */
+    total?: number;
+    offset?: number;
+    limit?: number;
+    /** SQL 执行耗时（ms），由 facade 挂载 */
+    duration?: number;
+}
+/** DML 写操作结果 */
+export interface WriteResult {
+    /** 受影响行数 */
+    affectedRows: number;
+    /** 单条插入的自增主键 / Mongo _id */
+    insertId?: number | string;
+    /** RETURNING 回读行 / Mongo 批量插入 _id 列表 */
+    returning?: any[];
+    duration?: number;
+}
+export type ExecResult = QueryResult | WriteResult;
+/** SQL 执行请求 */
+export interface RunSqlRequest {
+    sql: string;
+    offset?: number;
+    limit?: number;
+    /** 额外过滤，包装为 WITH __t AS (...) SELECT * FROM __t WHERE ... */
+    whereClause?: string;
+    /** 参数绑定占位符值（? / $1），与 sql 中的占位符一一对应 */
+    params?: unknown[];
+    /** DML 安全策略（client 层按自身配置注入；池共享时 handle.config.dml 不可靠） */
+    dml?: import('./config.js').DmlOptions;
+}
+/** 连接测试结果 */
+export interface TestResult {
+    success: boolean;
+    message: string;
+    version?: string;
+}
+/** 毫秒保留 2 位小数 */
+export declare function roundDuration(ms: number): number;
+/** 类型守卫：是否为写操作结果 */
+export declare function isWriteResult(result: ExecResult): result is WriteResult;
+/** 类型守卫：是否为查询结果 */
+export declare function isQueryResult(result: ExecResult): result is QueryResult;
+//# sourceMappingURL=result.d.ts.map

package/lib/types/result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.d.ts","sourceRoot":"","sources":["../../src/types/result.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,mBAAmB;AACnB,MAAM,WAAW,KAAK;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,6CAA6C;IAC7C,UAAU,EAAE,MAAM,CAAC;IACnB,+EAA+E;IAC/E,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;CACpB;AAED,kBAAkB;AAClB,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,GAAG,EAAE,CAAC;IACZ,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC;IACjB,yCAAyC;IACzC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+BAA+B;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,gBAAgB;AAChB,MAAM,WAAW,WAAW;IAC1B,YAAY;IACZ,YAAY,EAAE,MAAM,CAAC;IACrB,4BAA4B;IAC5B,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3B,wCAAwC;IACxC,SAAS,CAAC,EAAE,GAAG,EAAE,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,UAAU,GAAG,WAAW,GAAG,WAAW,CAAC;AAEnD,eAAe;AACf,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,6DAA6D;IAC7D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uCAAuC;IACvC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC;IACnB,2DAA2D;IAC3D,GAAG,CAAC,EAAE,OAAO,aAAa,EAAE,UAAU,CAAC;CACxC;AAED,aAAa;AACb,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,iBAAiB;AACjB,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED,oBAAoB;AACpB,wBAAgB,aAAa,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,IAAI,WAAW,CAEvE;AAED,mBAAmB;AACnB,wBAAgB,aAAa,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,IAAI,WAAW,CAEvE"}

package/lib/types/result.js

@@ -0,0 +1,16 @@
+/**
+ * 统一查询/写操作结果类型
+ */
+/** 毫秒保留 2 位小数 */
+export function roundDuration(ms) {
+    return Math.round(ms * 100) / 100;
+}
+/** 类型守卫：是否为写操作结果 */
+export function isWriteResult(result) {
+    return 'affectedRows' in result;
+}
+/** 类型守卫：是否为查询结果 */
+export function isQueryResult(result) {
+    return 'rows' in result;
+}
+//# sourceMappingURL=result.js.map

package/lib/types/result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.js","sourceRoot":"","sources":["../../src/types/result.ts"],"names":[],"mappings":"AAAA;;GAEG;AA2DH,iBAAiB;AACjB,MAAM,UAAU,aAAa,CAAC,EAAU;IACtC,OAAO,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC;AACpC,CAAC;AAED,oBAAoB;AACpB,MAAM,UAAU,aAAa,CAAC,MAAkB;IAC9C,OAAO,cAAc,IAAI,MAAM,CAAC;AAClC,CAAC;AAED,mBAAmB;AACnB,MAAM,UAAU,aAAa,CAAC,MAAkB;IAC9C,OAAO,MAAM,IAAI,MAAM,CAAC;AAC1B,CAAC"}

package/lib/types/schema.d.ts

@@ -0,0 +1,51 @@
+/**
+ * 表结构 JSON 导出类型（DDL 的结构化等价物）
+ */
+export interface TableSchema {
+    name: string;
+    /** PG schema / MySQL database / SQLite 主库 */
+    schema?: string;
+    kind: 'table' | 'view' | 'collection';
+    comment?: string;
+    columns: ColumnSchema[];
+    indexes?: IndexSchema[];
+    foreignKeys?: ForeignKeySchema[];
+    /** MySQL: InnoDB 等 */
+    engine?: string;
+    /** MySQL */
+    charset?: string;
+    /** 原始 DDL 字符串（与 JSON 双形态） */
+    ddl?: string;
+    /** 方言原生信息兜底 */
+    raw?: Record<string, unknown>;
+}
+export interface ColumnSchema {
+    name: string;
+    /** 原生类型（含长度/精度，如 varchar(255)、numeric(10,2)） */
+    type: string;
+    nullable: boolean;
+    default?: any;
+    comment?: string;
+    primaryKey: boolean;
+    autoIncrement?: boolean;
+    /** 列序号（从 1 开始） */
+    ordinal: number;
+}
+export interface IndexSchema {
+    name: string;
+    unique: boolean;
+    /** 按索引内列序 */
+    columns: string[];
+    /** btree / hash / fulltext / gin 等 */
+    type?: string;
+}
+export interface ForeignKeySchema {
+    name?: string;
+    columns: string[];
+    refTable: string;
+    refColumns: string[];
+    /** CASCADE / SET NULL / RESTRICT ... */
+    onDelete?: string;
+    onUpdate?: string;
+}
+//# sourceMappingURL=schema.d.ts.map

package/lib/types/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/types/schema.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,6CAA6C;IAC7C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,YAAY,CAAC;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,OAAO,CAAC,EAAE,WAAW,EAAE,CAAC;IACxB,WAAW,CAAC,EAAE,gBAAgB,EAAE,CAAC;IACjC,sBAAsB;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6BAA6B;IAC7B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,eAAe;IACf,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,gDAAgD;IAChD,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,GAAG,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,OAAO,CAAC;IACpB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,kBAAkB;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;IAChB,aAAa;IACb,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,sCAAsC;IACtC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,wCAAwC;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB"}

package/lib/types/schema.js

@@ -0,0 +1,5 @@
+/**
+ * 表结构 JSON 导出类型（DDL 的结构化等价物）
+ */
+export {};
+//# sourceMappingURL=schema.js.map

package/lib/types/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/types/schema.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/lib/types/task.d.ts

@@ -0,0 +1,48 @@
+/**
+ * 长任务类型（进度上报 / 取消 / 状态机）
+ */
+export type TaskStatus = 'pending' | 'running' | 'done' | 'failed' | 'cancelled';
+export interface TaskProgress {
+    /** 阶段名：如 'sampling' | 'analyzing' | 'building' */
+    stage: string;
+    /** 已处理数（已采样文档 / 已导出表数） */
+    processed: number;
+    /** 总量（未知时省略） */
+    total?: number;
+    message?: string;
+}
+/** 长任务执行上下文（runner 内部使用） */
+export interface IntrospectContext {
+    /** 上报进度 */
+    report(progress: TaskProgress): void;
+    /** 取消信号：取消时触发 abort */
+    signal: AbortSignal;
+    /** 是否已被取消 */
+    isCancelled(): boolean;
+}
+/** 长任务执行器 */
+export type IntrospectRunner<T> = (ctx: IntrospectContext) => Promise<T>;
+export interface IntrospectTask<T> {
+    readonly id: string;
+    readonly status: TaskStatus;
+    readonly progress: TaskProgress;
+    /** 等待完成；失败 reject SqlEngineError(TASK_CANCELLED / 其他) */
+    readonly promise: Promise<T>;
+    /** 订阅进度，返回退订函数 */
+    onProgress(cb: (p: TaskProgress) => void): () => void;
+    /** 取消；promise reject TASK_CANCELLED */
+    cancel(): Promise<void>;
+}
+/**
+ * 创建长任务
+ * @param runner 执行器（内部通过 ctx.report 上报进度、ctx.signal 感知取消）
+ */
+export declare function createTask<T>(runner: IntrospectRunner<T>): IntrospectTask<T>;
+/** 构造 TASK_CANCELLED 错误（避免循环依赖 errors.ts，直接导出构造器） */
+export declare function newTaskCancelledError(id: string): Error;
+/**
+ * 任务包装：inner 任务异步创建（如先等连接池就绪）时，保证进度事件不丢失
+ * - 事件先入缓冲，订阅时立即重放已缓冲进度，再实时转发
+ */
+export declare function wrapTask<T>(createInner: () => Promise<IntrospectTask<T>>): IntrospectTask<T>;
+//# sourceMappingURL=task.d.ts.map

package/lib/types/task.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task.d.ts","sourceRoot":"","sources":["../../src/types/task.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,SAAS,GAAG,MAAM,GAAG,QAAQ,GAAG,WAAW,CAAC;AAEjF,MAAM,WAAW,YAAY;IAC3B,kDAAkD;IAClD,KAAK,EAAE,MAAM,CAAC;IACd,0BAA0B;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,4BAA4B;AAC5B,MAAM,WAAW,iBAAiB;IAChC,WAAW;IACX,MAAM,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI,CAAC;IACrC,uBAAuB;IACvB,MAAM,EAAE,WAAW,CAAC;IACpB,aAAa;IACb,WAAW,IAAI,OAAO,CAAC;CACxB;AAED,aAAa;AACb,MAAM,MAAM,gBAAgB,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,iBAAiB,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;AAEzE,MAAM,WAAW,cAAc,CAAC,CAAC;IAC/B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC;IAChC,yDAAyD;IACzD,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IAC7B,kBAAkB;IAClB,UAAU,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,YAAY,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IACtD,uCAAuC;IACvC,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACzB;AAID;;;GAGG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC,CA6E5E;AAED,qDAAqD;AACrD,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,MAAM,GAAG,KAAK,CAIvD;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC,CAuC5F"}

package/lib/types/task.js

@@ -0,0 +1,136 @@
+/**
+ * 长任务类型（进度上报 / 取消 / 状态机）
+ */
+let taskSeq = 0;
+/**
+ * 创建长任务
+ * @param runner 执行器（内部通过 ctx.report 上报进度、ctx.signal 感知取消）
+ */
+export function createTask(runner) {
+    const id = `task-${++taskSeq}-${Date.now().toString(36)}`;
+    let status = 'pending';
+    let progress = { stage: 'pending', processed: 0 };
+    const listeners = new Set();
+    let cancelRequested = false;
+    const abort = new AbortController();
+    const emit = (p) => {
+        progress = p;
+        for (const cb of listeners)
+            cb(p);
+    };
+    const promise = new Promise((resolve, reject) => {
+        const run = async () => {
+            status = 'running';
+            emit({ ...progress, stage: 'running' });
+            try {
+                const result = await runner({
+                    report: (p) => {
+                        if (!cancelRequested)
+                            emit(p);
+                    },
+                    signal: abort.signal,
+                    isCancelled: () => cancelRequested,
+                });
+                if (cancelRequested) {
+                    status = 'cancelled';
+                    emit({ ...progress, stage: 'cancelled' });
+                    reject(newTaskCancelledError(id));
+                    return;
+                }
+                status = 'done';
+                emit({ ...progress, stage: 'done' });
+                resolve(result);
+            }
+            catch (err) {
+                if (cancelRequested || abort.signal.aborted) {
+                    status = 'cancelled';
+                    emit({ ...progress, stage: 'cancelled' });
+                    reject(newTaskCancelledError(id));
+                }
+                else {
+                    status = 'failed';
+                    emit({ ...progress, stage: 'failed' });
+                    reject(err);
+                }
+            }
+        };
+        // 延迟到微任务执行，保证 pending 状态可观测（订阅者先注册再运行）
+        void Promise.resolve().then(run);
+    });
+    const cancel = async () => {
+        if (status === 'done' || status === 'failed' || status === 'cancelled')
+            return;
+        cancelRequested = true;
+        // 延迟到微任务再触发 abort，让 runner 先完成监听器注册
+        queueMicrotask(() => abort.abort());
+        status = 'cancelled';
+        emit({ ...progress, stage: 'cancelled' });
+        // 等待 runner 收尾（signal 触发后 runner 应尽快返回）
+        await promise.catch(() => undefined);
+    };
+    return {
+        id,
+        get status() {
+            return status;
+        },
+        get progress() {
+            return progress;
+        },
+        promise,
+        onProgress(cb) {
+            listeners.add(cb);
+            return () => listeners.delete(cb);
+        },
+        cancel,
+    };
+}
+/** 构造 TASK_CANCELLED 错误（避免循环依赖 errors.ts，直接导出构造器） */
+export function newTaskCancelledError(id) {
+    const err = new Error(`Task ${id} cancelled`);
+    err.code = 'TASK_CANCELLED';
+    return err;
+}
+/**
+ * 任务包装：inner 任务异步创建（如先等连接池就绪）时，保证进度事件不丢失
+ * - 事件先入缓冲，订阅时立即重放已缓冲进度，再实时转发
+ */
+export function wrapTask(createInner) {
+    let inner = null;
+    let cancelled = false;
+    const buffer = [];
+    const live = new Set();
+    const push = (p) => {
+        buffer.push(p);
+        for (const cb of live)
+            cb(p);
+    };
+    const promise = createInner().then((task) => {
+        inner = task;
+        const unsub = task.onProgress(push);
+        task.promise.finally(() => unsub());
+        // 快照当前进度（含已完成状态），确保订阅者能拿到
+        push(task.progress);
+        return task.promise;
+    });
+    return {
+        id: `wrapped-${Date.now().toString(36)}`,
+        get status() {
+            return inner?.status ?? (cancelled ? 'cancelled' : 'pending');
+        },
+        get progress() {
+            return inner?.progress ?? { stage: 'pending', processed: 0 };
+        },
+        promise,
+        onProgress(cb) {
+            for (const p of buffer)
+                cb(p);
+            live.add(cb);
+            return () => live.delete(cb);
+        },
+        cancel() {
+            cancelled = true;
+            return inner?.cancel() ?? Promise.resolve();
+        },
+    };
+}
+//# sourceMappingURL=task.js.map

package/lib/types/task.js.map

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

package/lib/types/transaction.d.ts

@@ -0,0 +1,13 @@
+/**
+ * 事务句柄：内部所有查询在同一个事务/连接内执行
+ */
+import type { ExecResult, QueryResult, RunSqlRequest, WriteResult } from './result.js';
+export interface TransactionHandle {
+    /** 执行 SQL（SELECT → QueryResult，DML → WriteResult） */
+    runSql(request: RunSqlRequest): Promise<ExecResult>;
+    query<T = any>(sql: string, params?: unknown[]): Promise<QueryResult>;
+    execute(sql: string, params?: unknown[]): Promise<WriteResult>;
+    commit(): Promise<void>;
+    rollback(): Promise<void>;
+}
+//# sourceMappingURL=transaction.d.ts.map

package/lib/types/transaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transaction.d.ts","sourceRoot":"","sources":["../../src/types/transaction.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAEvF,MAAM,WAAW,iBAAiB;IAChC,qDAAqD;IACrD,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IACpD,KAAK,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IACtE,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAC/D,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACxB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B"}

package/lib/types/transaction.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=transaction.js.map

package/lib/types/transaction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transaction.js","sourceRoot":"","sources":["../../src/types/transaction.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,93 @@
+{
+  "name": "@fett/sql-translator",
+  "version": "0.0.1-beta",
+  "description": "SQL 兼容层：以 SQL 为统一查询语言的数据库兼容层（MySQL 5/8 / PostgreSQL / SQLite / MongoDB），支持 Node ≥ 22.5 与 Bun，内置连接池、任务队列（多线程）、结构检出",
+  "license": "ISC",
+  "author": "chrissong1994 <18557511748@163.com>",
+  "type": "module",
+  "main": "./lib/index.js",
+  "types": "./lib/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "import": "./lib/index.js",
+      "default": "./lib/index.js"
+    }
+  },
+  "files": [
+    "lib",
+    "patches",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=22.5.0",
+    "bun": ">=1.1.0"
+  },
+  "peerDependencies": {
+    "@synatic/noql": ">=5",
+    "knex": ">=3",
+    "mongodb": ">=6",
+    "mysql2": ">=3",
+    "node-sql-parser": ">=5",
+    "pg": ">=8"
+  },
+  "peerDependenciesMeta": {
+    "@synatic/noql": {
+      "optional": true
+    },
+    "knex": {
+      "optional": true
+    },
+    "mongodb": {
+      "optional": true
+    },
+    "mysql2": {
+      "optional": true
+    },
+    "node-sql-parser": {
+      "optional": true
+    },
+    "pg": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/node": "^24.0.0",
+    "typescript": "^5.8.3",
+    "vitest": "^4.1.11"
+  },
+  "devEngines": {
+    "packageManager": {
+      "name": "pnpm",
+      "version": "^11.5.1",
+      "onFail": "download"
+    }
+  },
+  "keywords": [
+    "sql",
+    "database",
+    "mysql",
+    "postgresql",
+    "sqlite",
+    "mongodb",
+    "compatibility-layer"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:unit": "vitest run test/unit",
+    "test:integration": "vitest run test/integration",
+    "test:mysql": "vitest run test/integration/mysql.spec.ts",
+    "test:bun": "bun test --timeout 30000 test/unit test/integration",
+    "db:up": "docker compose up -d --wait",
+    "db:down": "docker compose down",
+    "db:init": "node scripts/init-fixtures.mjs",
+    "release": "pnpm test && pnpm build && pnpm publish --access public"
+  }
+}