@fett/sql-translator 0.0.1-beta

package/lib/core/task-queue.js

@@ -0,0 +1,185 @@
+/**
+ * 任务队列：并发上限 / 优先级 / 超时 / 取消 / worker 多线程 offload
+ */
+import { SqlEngineError } from '../errors.js';
+import { availableParallelism } from 'node:os';
+import { createTask } from '../types/task.js';
+import { createWorkerBackend } from './worker/index.js';
+export class TaskQueueImpl {
+    options;
+    queue = [];
+    active = 0;
+    closed = false;
+    seq = 0;
+    idleWaiters = [];
+    workerBackend = null;
+    workerBackendPromise = null;
+    constructor(options = {}) {
+        this.options = options;
+    }
+    /** 默认并发 = CPU 数 */
+    get concurrency() {
+        return this.options.concurrency ?? defaultConcurrency();
+    }
+    size() {
+        return this.queue.length + this.active;
+    }
+    /**
+     * 入队执行
+     * - 传函数：进程内异步执行（I/O 密集任务默认方式）
+     * - 传 WorkerTaskSpec + opts.worker=true：offload 到 worker 线程（CPU 密集任务）
+     */
+    enqueue(fn, opts = {}) {
+        if (this.closed) {
+            return Promise.reject(new SqlEngineError('TASK_QUEUE_CLOSED', 'task queue has been closed'));
+        }
+        if (opts.worker && typeof fn === 'function') {
+            return Promise.reject(new SqlEngineError('WORKER_UNAVAILABLE', 'worker 任务必须是可序列化的 WorkerTaskSpec（{ module, fn, args }），闭包无法跨线程执行'));
+        }
+        if (opts.signal?.aborted) {
+            return Promise.reject(new SqlEngineError('TASK_CANCELLED', 'task cancelled before run'));
+        }
+        const priority = opts.priority ?? 0;
+        return new Promise((resolve, reject) => {
+            const item = {
+                id: ++this.seq,
+                fn: fn,
+                opts,
+                resolve: resolve,
+                reject,
+                priority,
+            };
+            // 按优先级降序插入（稳定排序：同优先级按入队顺序）
+            let lo = 0;
+            let hi = this.queue.length;
+            while (lo < hi) {
+                const mid = (lo + hi) >> 1;
+                if (this.queue[mid].priority < priority)
+                    hi = mid;
+                else
+                    lo = mid + 1;
+            }
+            this.queue.splice(lo, 0, item);
+            this.pump();
+        });
+    }
+    /** 长任务形态：支持进度上报与取消 */
+    introspect(runner) {
+        return createTask((ctx) => this.enqueue(() => runner(ctx), { signal: ctx.signal }));
+    }
+    waitIdle() {
+        if (this.active === 0 && this.queue.length === 0)
+            return Promise.resolve();
+        return new Promise((resolve) => {
+            this.idleWaiters.push(resolve);
+        });
+    }
+    async close() {
+        if (this.closed)
+            return;
+        this.closed = true;
+        // 拒绝所有排队任务
+        const pending = this.queue.splice(0);
+        for (const item of pending) {
+            item.reject(new SqlEngineError('TASK_QUEUE_CLOSED', 'task queue has been closed'));
+        }
+        await this.waitIdle();
+        if (this.workerBackend) {
+            await this.workerBackend.close();
+            this.workerBackend = null;
+            this.workerBackendPromise = null;
+        }
+    }
+    pump() {
+        while (this.active < this.concurrency && this.queue.length > 0 && !this.closed) {
+            const item = this.queue.shift();
+            this.active++;
+            void this.execute(item).finally(() => {
+                this.active--;
+                this.pump();
+                if (this.active === 0 && this.queue.length === 0) {
+                    const waiters = this.idleWaiters.splice(0);
+                    for (const w of waiters)
+                        w();
+                }
+            });
+        }
+    }
+    async execute(item) {
+        const { opts } = item;
+        if (opts?.signal?.aborted) {
+            item.reject(new SqlEngineError('TASK_CANCELLED', 'task cancelled'));
+            return;
+        }
+        // 排队期间被取消（signal 触发）
+        const abortHandler = () => {
+            item.reject(new SqlEngineError('TASK_CANCELLED', 'task cancelled'));
+        };
+        opts?.signal?.addEventListener('abort', abortHandler, { once: true });
+        try {
+            const exec = opts?.worker
+                ? this.runInWorker(item.fn)
+                : Promise.resolve().then(() => item.fn());
+            const timeoutMs = opts?.timeoutMs ?? this.options.timeoutMs;
+            const result = await withTimeout(exec, timeoutMs, item.id);
+            item.resolve(result);
+        }
+        catch (err) {
+            item.reject(err);
+        }
+        finally {
+            opts?.signal?.removeEventListener('abort', abortHandler);
+        }
+    }
+    runInWorker(spec) {
+        return this.getWorkerBackend().then((backend) => backend.run(spec));
+    }
+    getWorkerBackend() {
+        if (this.options.useWorkers === false) {
+            return Promise.reject(new SqlEngineError('WORKER_UNAVAILABLE', 'worker 已被禁用（useWorkers: false）'));
+        }
+        if (!this.workerBackend) {
+            this.workerBackendPromise ??= Promise.resolve().then(() => createWorkerBackend({ workerCount: this.options.workerCount }));
+            this.workerBackendPromise
+                .then((backend) => {
+                this.workerBackend = backend;
+            })
+                .catch(() => {
+                this.workerBackendPromise = null;
+            });
+            return this.workerBackendPromise;
+        }
+        return Promise.resolve(this.workerBackend);
+    }
+}
+function defaultConcurrency() {
+    if (typeof globalThis !== 'undefined' && 'navigator' in globalThis) {
+        const nav = globalThis.navigator;
+        const hw = nav?.hardwareConcurrency;
+        if (typeof hw === 'number' && hw > 0)
+            return hw;
+    }
+    try {
+        return Math.max(1, availableParallelism?.() ?? 4);
+    }
+    catch {
+        return 4;
+    }
+}
+function withTimeout(promise, timeoutMs, id) {
+    if (!timeoutMs || timeoutMs <= 0)
+        return promise;
+    return new Promise((resolve, reject) => {
+        const timer = setTimeout(() => {
+            reject(new SqlEngineError('QUERY_FAILED', `task #${id} timed out after ${timeoutMs}ms`));
+        }, timeoutMs);
+        promise.then((v) => {
+            clearTimeout(timer);
+            resolve(v);
+        }, (e) => {
+            clearTimeout(timer);
+            reject(e);
+        });
+    });
+}
+//# sourceMappingURL=task-queue.js.map

package/lib/core/task-queue.js.map

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

package/lib/core/worker/bun-worker.d.ts

@@ -0,0 +1,21 @@
+/**
+ * worker 线程池（Bun Worker 实现）
+ * bun 的 Worker 是全局 web-worker 风格构造器：new Worker(url, {type:'module'})
+ * 消息事件：addEventListener('message', e => e.data)
+ */
+import type { WorkerTaskSpec } from '../../types/queue.js';
+import type { WorkerBackend } from './node-worker.js';
+export declare class BunWorkerPool implements WorkerBackend {
+    private count;
+    private workers;
+    private pending;
+    private seq;
+    private closed;
+    constructor(count: number);
+    get size(): number;
+    private get WorkerCtor();
+    private spawn;
+    run<T>(spec: WorkerTaskSpec): Promise<T>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=bun-worker.d.ts.map

package/lib/core/worker/bun-worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bun-worker.d.ts","sourceRoot":"","sources":["../../../src/core/worker/bun-worker.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAkBtD,qBAAa,aAAc,YAAW,aAAa;IAMrC,OAAO,CAAC,KAAK;IALzB,OAAO,CAAC,OAAO,CAAuB;IACtC,OAAO,CAAC,OAAO,CAAmC;IAClD,OAAO,CAAC,GAAG,CAAK;IAChB,OAAO,CAAC,MAAM,CAAS;gBAEH,KAAK,EAAE,MAAM;IAEjC,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,OAAO,KAAK,UAAU,GAQrB;IAED,OAAO,CAAC,KAAK;IAuBb,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC;IAyClC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAO7B"}

package/lib/core/worker/bun-worker.js

@@ -0,0 +1,93 @@
+const RUNNER_URL = new URL(`./task-runner-bun${import.meta.url.endsWith('.ts') ? '.ts' : '.js'}`, import.meta.url);
+export class BunWorkerPool {
+    count;
+    workers = [];
+    pending = [];
+    seq = 0;
+    closed = false;
+    constructor(count) {
+        this.count = count;
+    }
+    get size() {
+        return this.workers.length;
+    }
+    get WorkerCtor() {
+        const ctor = globalThis.Worker;
+        if (typeof ctor !== 'function') {
+            throw new Error('当前运行时无 Worker 全局构造器（需要 Bun ≥ 1.1）');
+        }
+        return ctor;
+    }
+    spawn(index) {
+        const worker = new this.WorkerCtor(RUNNER_URL, { type: 'module' });
+        worker.addEventListener('message', (e) => {
+            const msg = e.data;
+            const task = this.pending[index];
+            this.pending[index] = undefined;
+            if (!task)
+                return;
+            if (msg.ok)
+                task.resolve(msg.result);
+            else
+                task.reject(new Error(msg.error ?? 'bun worker task failed'));
+        });
+        worker.addEventListener('error', (err) => {
+            const task = this.pending[index];
+            this.pending[index] = undefined;
+            if (task) {
+                const e = err?.message ? new Error(String(err.message)) : new Error('bun worker error');
+                task.reject(e);
+            }
+            this.workers[index] = undefined;
+        });
+        this.workers[index] = worker;
+        return worker;
+    }
+    run(spec) {
+        if (this.closed)
+            return Promise.reject(new Error('worker pool closed'));
+        // 找空闲 worker
+        let index = -1;
+        for (let i = 0; i < this.workers.length; i++) {
+            if (!this.pending[i]) {
+                index = i;
+                break;
+            }
+        }
+        if (index === -1) {
+            if (this.workers.length >= this.count) {
+                // 池满：等一个空闲
+                return new Promise((resolve, reject) => {
+                    const timer = setInterval(() => {
+                        if (this.closed) {
+                            clearInterval(timer);
+                            reject(new Error('worker pool closed'));
+                            return;
+                        }
+                        for (let i = 0; i < this.workers.length; i++) {
+                            if (!this.pending[i]) {
+                                clearInterval(timer);
+                                this.run(spec).then(resolve, reject);
+                                return;
+                            }
+                        }
+                    }, 1);
+                });
+            }
+            index = this.workers.length;
+            this.spawn(index);
+        }
+        return new Promise((resolve, reject) => {
+            this.pending[index] = { resolve: resolve, reject };
+            this.workers[index].postMessage({ id: ++this.seq, ...spec });
+        });
+    }
+    async close() {
+        this.closed = true;
+        const workers = this.workers;
+        this.workers = [];
+        this.pending = [];
+        workers.forEach((w) => w.terminate?.());
+    }
+}
+//# sourceMappingURL=bun-worker.js.map

package/lib/core/worker/bun-worker.js.map

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

package/lib/core/worker/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * worker 后端选择：按运行时创建
+ */
+import { type RuntimeName } from '../../runtime.js';
+import type { WorkerTaskSpec } from '../../types/queue.js';
+import { type WorkerBackend } from './node-worker.js';
+export type { WorkerBackend } from './node-worker.js';
+export interface WorkerPoolOptions {
+    /** worker 线程数，默认 min(4, cpu) */
+    workerCount?: number;
+    runtime?: RuntimeName;
+}
+/** 创建 worker 后端（Node worker_threads / Bun Worker） */
+export declare function createWorkerBackend(options?: WorkerPoolOptions): WorkerBackend;
+export type { WorkerTaskSpec };
+//# sourceMappingURL=index.d.ts.map

package/lib/core/worker/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/worker/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAiB,KAAK,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACnE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAkB,KAAK,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAGtE,YAAY,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEtD,MAAM,WAAW,iBAAiB;IAChC,gCAAgC;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,WAAW,CAAC;CACvB;AAED,qDAAqD;AACrD,wBAAgB,mBAAmB,CAAC,OAAO,GAAE,iBAAsB,GAAG,aAAa,CAOlF;AAED,YAAY,EAAE,cAAc,EAAE,CAAC"}

package/lib/core/worker/index.js

@@ -0,0 +1,16 @@
+/**
+ * worker 后端选择：按运行时创建
+ */
+import { detectRuntime } from '../../runtime.js';
+import { NodeWorkerPool } from './node-worker.js';
+import { BunWorkerPool } from './bun-worker.js';
+/** 创建 worker 后端（Node worker_threads / Bun Worker） */
+export function createWorkerBackend(options = {}) {
+    const runtime = options.runtime ?? detectRuntime();
+    const count = Math.max(1, Math.min(options.workerCount ?? 4, 32));
+    if (runtime === 'bun') {
+        return new BunWorkerPool(count);
+    }
+    return new NodeWorkerPool(count);
+}
+//# sourceMappingURL=index.js.map

package/lib/core/worker/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/worker/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,aAAa,EAAoB,MAAM,kBAAkB,CAAC;AAEnE,OAAO,EAAE,cAAc,EAAsB,MAAM,kBAAkB,CAAC;AACtE,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAUhD,qDAAqD;AACrD,MAAM,UAAU,mBAAmB,CAAC,UAA6B,EAAE;IACjE,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,aAAa,EAAE,CAAC;IACnD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,WAAW,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;IAClE,IAAI,OAAO,KAAK,KAAK,EAAE,CAAC;QACtB,OAAO,IAAI,aAAa,CAAC,KAAK,CAAC,CAAC;IAClC,CAAC;IACD,OAAO,IAAI,cAAc,CAAC,KAAK,CAAC,CAAC;AACnC,CAAC"}

package/lib/core/worker/node-worker.d.ts

@@ -0,0 +1,19 @@
+import type { WorkerTaskSpec } from '../../types/queue.js';
+export interface WorkerBackend {
+    readonly size: number;
+    run<T>(spec: WorkerTaskSpec): Promise<T>;
+    close(): Promise<void>;
+}
+export declare class NodeWorkerPool implements WorkerBackend {
+    private count;
+    private workers;
+    private pending;
+    private seq;
+    private closed;
+    constructor(count: number);
+    get size(): number;
+    private spawn;
+    run<T>(spec: WorkerTaskSpec): Promise<T>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=node-worker.d.ts.map

package/lib/core/worker/node-worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-worker.d.ts","sourceRoot":"","sources":["../../../src/core/worker/node-worker.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACzC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAYD,qBAAa,cAAe,YAAW,aAAa;IAMtC,OAAO,CAAC,KAAK;IALzB,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,OAAO,CAAmC;IAClD,OAAO,CAAC,GAAG,CAAK;IAChB,OAAO,CAAC,MAAM,CAAS;gBAEH,KAAK,EAAE,MAAM;IAEjC,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,OAAO,CAAC,KAAK;IAoBb,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC;IA6ClC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAS7B"}

package/lib/core/worker/node-worker.js

@@ -0,0 +1,94 @@
+/**
+ * worker 线程池（Node worker_threads 实现）
+ * 固定数量 worker，每个 worker 同一时刻只处理一个任务，结果经 postMessage 回传
+ */
+import { Worker } from 'node:worker_threads';
+import { fileURLToPath } from 'node:url';
+const RUNNER_URL = new URL(`./task-runner${import.meta.url.endsWith('.ts') ? '.ts' : '.js'}`, import.meta.url);
+export class NodeWorkerPool {
+    count;
+    workers = [];
+    pending = [];
+    seq = 0;
+    closed = false;
+    constructor(count) {
+        this.count = count;
+    }
+    get size() {
+        return this.workers.length;
+    }
+    spawn(index) {
+        const worker = new Worker(fileURLToPath(RUNNER_URL));
+        worker.on('message', (msg) => {
+            const task = this.pending[index];
+            this.pending[index] = undefined;
+            if (!task)
+                return;
+            if (msg.ok)
+                task.resolve(msg.result);
+            else
+                task.reject(new Error(msg.error ?? 'worker task failed'));
+        });
+        worker.on('error', (err) => {
+            const task = this.pending[index];
+            this.pending[index] = undefined;
+            if (task)
+                task.reject(err);
+            // 崩溃的 worker 移除，下次 run 时重建
+            this.workers[index] = undefined;
+        });
+        this.workers[index] = worker;
+        return worker;
+    }
+    run(spec) {
+        if (this.closed) {
+            return Promise.reject(new Error('worker pool closed'));
+        }
+        // 找空闲 worker（无 pending 任务）
+        let index = -1;
+        for (let i = 0; i < this.workers.length; i++) {
+            if (!this.pending[i]) {
+                index = i;
+                break;
+            }
+        }
+        if (index === -1) {
+            if (this.workers.length >= this.count) {
+                // 池满：等一个空闲（简单轮询等待——用 setTimeout 退避）
+                return new Promise((resolve, reject) => {
+                    const tryRun = () => {
+                        this.run(spec).then(resolve, reject);
+                    };
+                    const timer = setInterval(() => {
+                        if (this.closed) {
+                            clearInterval(timer);
+                            reject(new Error('worker pool closed'));
+                            return;
+                        }
+                        for (let i = 0; i < this.workers.length; i++) {
+                            if (!this.pending[i]) {
+                                clearInterval(timer);
+                                tryRun();
+                                return;
+                            }
+                        }
+                    }, 1);
+                });
+            }
+            index = this.workers.length;
+            this.spawn(index);
+        }
+        return new Promise((resolve, reject) => {
+            this.pending[index] = { resolve: resolve, reject };
+            this.workers[index].postMessage({ id: ++this.seq, ...spec });
+        });
+    }
+    async close() {
+        this.closed = true;
+        const workers = this.workers;
+        this.workers = [];
+        this.pending = [];
+        await Promise.all(workers.map((w) => (w ? w.terminate().catch(() => undefined) : Promise.resolve())));
+    }
+}
+//# sourceMappingURL=node-worker.js.map

package/lib/core/worker/node-worker.js.map

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

package/lib/core/worker/task-runner-bun.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=task-runner-bun.d.ts.map

package/lib/core/worker/task-runner-bun.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-runner-bun.d.ts","sourceRoot":"","sources":["../../../src/core/worker/task-runner-bun.ts"],"names":[],"mappings":""}

package/lib/core/worker/task-runner-bun.js

@@ -0,0 +1,18 @@
+self.onmessage = async (e) => {
+    const msg = e.data;
+    try {
+        const mod = await import(msg.module);
+        const fn = mod[msg.fn];
+        if (typeof fn !== 'function') {
+            throw new Error(`module "${msg.module}" 未导出函数 "${msg.fn}"`);
+        }
+        const result = await fn(...(msg.args ?? []));
+        self.postMessage({ ok: true, result });
+    }
+    catch (err) {
+        const e2 = err;
+        self.postMessage({ ok: false, error: e2?.stack || String(err) });
+    }
+};
+export {};
+//# sourceMappingURL=task-runner-bun.js.map

package/lib/core/worker/task-runner-bun.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-runner-bun.js","sourceRoot":"","sources":["../../../src/core/worker/task-runner-bun.ts"],"names":[],"mappings":"AAcA,IAAI,CAAC,SAAS,GAAG,KAAK,EAAE,CAA0B,EAAE,EAAE;IACpD,MAAM,GAAG,GAAG,CAAC,CAAC,IAAI,CAAC;IACnB,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACrC,MAAM,EAAE,GAAI,GAA+B,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACpD,IAAI,OAAO,EAAE,KAAK,UAAU,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CAAC,WAAW,GAAG,CAAC,MAAM,YAAY,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC;QAC9D,CAAC;QACD,MAAM,MAAM,GAAG,MAAO,EAAsC,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC;QAClF,IAAI,CAAC,WAAW,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;IACzC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,EAAE,GAAG,GAAY,CAAC;QACxB,IAAI,CAAC,WAAW,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,IAAI,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACnE,CAAC;AACH,CAAC,CAAC"}

package/lib/core/worker/task-runner.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=task-runner.d.ts.map

package/lib/core/worker/task-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-runner.d.ts","sourceRoot":"","sources":["../../../src/core/worker/task-runner.ts"],"names":[],"mappings":""}

package/lib/core/worker/task-runner.js

@@ -0,0 +1,21 @@
+/**
+ * worker 线程执行入口（Node worker_threads 侧）
+ * 收到 { module, fn, args } → 动态 import 模块 → 调用导出函数 → 回传结果
+ */
+import { parentPort } from 'node:worker_threads';
+parentPort?.on('message', async (msg) => {
+    try {
+        const mod = await import(msg.module);
+        const fn = mod[msg.fn];
+        if (typeof fn !== 'function') {
+            throw new Error(`module "${msg.module}" 未导出函数 "${msg.fn}"`);
+        }
+        const result = await fn(...(msg.args ?? []));
+        parentPort?.postMessage({ ok: true, result });
+    }
+    catch (err) {
+        const e = err;
+        parentPort?.postMessage({ ok: false, error: e?.stack || String(err) });
+    }
+});
+//# sourceMappingURL=task-runner.js.map

package/lib/core/worker/task-runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-runner.js","sourceRoot":"","sources":["../../../src/core/worker/task-runner.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAQjD,UAAU,EAAE,EAAE,CAAC,SAAS,EAAE,KAAK,EAAE,GAAkB,EAAE,EAAE;IACrD,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACrC,MAAM,EAAE,GAAI,GAA+B,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACpD,IAAI,OAAO,EAAE,KAAK,UAAU,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CAAC,WAAW,GAAG,CAAC,MAAM,YAAY,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC;QAC9D,CAAC;QACD,MAAM,MAAM,GAAG,MAAO,EAAsC,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC;QAClF,UAAU,EAAE,WAAW,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;IAChD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,CAAC,GAAG,GAAY,CAAC;QACvB,UAAU,EAAE,WAAW,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,IAAI,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACzE,CAAC;AACH,CAAC,CAAC,CAAC"}

package/lib/driver/index.d.ts

@@ -0,0 +1,3 @@
+export * from './registry.js';
+export * from './interface.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/driver/index.ts"],"names":[],"mappings":"AAeA,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC"}

package/lib/driver/index.js

@@ -0,0 +1,16 @@
+/**
+ * 驱动注册入口：内置方言在此注册
+ */
+import { registerDriver } from './registry.js';
+import { sqliteDriver } from './sqlite/index.js';
+import { mysqlDriver, mariadbDriver } from './mysql/index.js';
+import { postgresqlDriver } from './postgresql/index.js';
+import { mongodbDriver } from './mongodb/index.js';
+registerDriver(sqliteDriver);
+registerDriver(mysqlDriver);
+registerDriver(mariadbDriver);
+registerDriver(postgresqlDriver);
+registerDriver(mongodbDriver);
+export * from './registry.js';
+export * from './interface.js';
+//# sourceMappingURL=index.js.map

package/lib/driver/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/driver/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,cAAc,CAAC,YAAY,CAAC,CAAC;AAC7B,cAAc,CAAC,WAAW,CAAC,CAAC;AAC5B,cAAc,CAAC,aAAa,CAAC,CAAC;AAC9B,cAAc,CAAC,gBAAgB,CAAC,CAAC;AACjC,cAAc,CAAC,aAAa,CAAC,CAAC;AAE9B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC"}

package/lib/driver/interface.d.ts

@@ -0,0 +1,39 @@
+/**
+ * 驱动接口：各数据库方言适配器的统一契约
+ * 连接池由 PoolHandle 持有（由 client/registry 统一管理生命周期），
+ * driver 方法只接收已绑定 config 的 handle，不做重复缓存
+ */
+import type { ConnectionConfig, SchemaOptions } from '../types/config.js';
+import type { ExecResult, Field, RunSqlRequest, TestResult } from '../types/result.js';
+import type { TableSchema } from '../types/schema.js';
+import type { IntrospectTask } from '../types/task.js';
+import type { TransactionHandle } from '../types/transaction.js';
+import type { PoolStats } from '../types/manager.js';
+/** 连接池句柄（registry 生命周期管理单元） */
+export interface PoolHandle {
+    readonly fingerprint: string;
+    readonly config: ConnectionConfig;
+    readonly stats: PoolStats;
+    /** 已销毁标记（invalidate/destroy 后为 true） */
+    readonly destroyed: boolean;
+    ping(): Promise<void>;
+    destroy(): Promise<void>;
+}
+export interface SqlDriver {
+    readonly dialect: string;
+    /** 创建连接池（纯工厂，registry 负责缓存与销毁） */
+    createPool(config: ConnectionConfig): Promise<PoolHandle>;
+    /** 连接测试：一次性连接，不入池 */
+    testConnection(config: ConnectionConfig): Promise<TestResult>;
+    runSql(pool: PoolHandle, request: RunSqlRequest): Promise<ExecResult>;
+    getTableList(pool: PoolHandle): Promise<string[]>;
+    getTableDDL?(pool: PoolHandle, table: string): Promise<string>;
+    getPreviewRows(pool: PoolHandle, table: string, offset: number, limit: number, whereClause?: string): Promise<any[]>;
+    getColumns(pool: PoolHandle, table: string): Promise<Field[]>;
+    getRowsCount(pool: PoolHandle, table: string, whereClause?: string): Promise<number>;
+    getTableSchema(pool: PoolHandle, table: string, opts?: SchemaOptions): Promise<TableSchema>;
+    getAllTableSchemas?(pool: PoolHandle, opts?: SchemaOptions): IntrospectTask<TableSchema[]>;
+    /** 事务：fn 内所有查询在同一事务/连接内执行；fn 抛错自动回滚 */
+    withTransaction?<T>(pool: PoolHandle, fn: (tx: TransactionHandle) => Promise<T>): Promise<T>;
+}
+//# sourceMappingURL=interface.d.ts.map

package/lib/driver/interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interface.d.ts","sourceRoot":"","sources":["../../src/driver/interface.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAC1E,OAAO,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACvF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAErD,+BAA+B;AAC/B,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAC1B,wCAAwC;IACxC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB,kCAAkC;IAClC,UAAU,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAE1D,qBAAqB;IACrB,cAAc,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAE9D,MAAM,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAEtE,YAAY,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAClD,WAAW,CAAC,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC/D,cAAc,CACZ,IAAI,EAAE,UAAU,EAChB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IAClB,UAAU,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;IAC9D,YAAY,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACrF,cAAc,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAC5F,kBAAkB,CAAC,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,CAAC,EAAE,aAAa,GAAG,cAAc,CAAC,WAAW,EAAE,CAAC,CAAC;IAC3F,uCAAuC;IACvC,eAAe,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,iBAAiB,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CAC9F"}

package/lib/driver/interface.js

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

package/lib/driver/interface.js.map

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