@qimen-lab/core 0.1.3 → 0.1.5

package/dist/task/hash-task/worker/HashWorker.esm.js

@@ -0,0 +1,99 @@
+import { parentPort } from 'worker_threads';
+import * as crypto from 'crypto';
+/**
+ * Node.js环境下的哈希计算Worker
+ *
+ * 该Worker只负责一件事：按固定协议，增量计算哈希
+ *
+ * 必须满足：
+ * ❌ 不 eval
+ * ❌ 不接受函数
+ * ❌ 不关心任务状态 / 进度
+ * ✔ 支持大文件（多次 update）
+ * ✔ 可被 reset / 重用
+ * ✔ 出错可恢复
+ */
+if (!parentPort) {
+    throw new Error('hash.worker must be run in a Worker thread');
+}
+let hash = null;
+let algorithm = null;
+/**
+ * 允许的算法白名单
+ * ❗ 不允许任意字符串
+ */
+const ALLOWED_ALGORITHMS = new Set([
+    'sha1',
+    'sha256',
+    'sha384',
+    'sha512',
+    'md5', // 如不需要可移除
+]);
+/**
+ * 向主线程发送消息的辅助函数
+ *
+ * @param message 要发送的响应消息
+ */
+function post(message) {
+    parentPort.postMessage(message);
+}
+/**
+ * 重置内部哈希状态
+ */
+function reset() {
+    hash = null;
+    algorithm = null;
+}
+parentPort.on('message', (msg) => {
+    try {
+        switch (msg.type) {
+            case 'init': {
+                if (!ALLOWED_ALGORITHMS.has(msg.algorithm)) {
+                    throw {
+                        code: 'UNSUPPORTED_ALGORITHM',
+                        message: `Unsupported: ${msg.algorithm}`,
+                    };
+                }
+                algorithm = msg.algorithm;
+                hash = crypto.createHash(algorithm);
+                post({ type: 'ack' });
+                break;
+            }
+            case 'update': {
+                if (!hash) {
+                    throw new Error('Hash not initialized');
+                }
+                hash.update(Buffer.from(msg.data));
+                post({ type: 'ack', chunkId: msg.chunkId });
+                break;
+            }
+            case 'final': {
+                if (!hash) {
+                    throw new Error('Hash not initialized');
+                }
+                const result = hash.digest();
+                post({
+                    type: 'digest',
+                    result: result.buffer.slice(result.byteOffset, result.byteOffset + result.byteLength),
+                });
+                reset();
+                break;
+            }
+            case 'reset': {
+                reset();
+                post({ type: 'ack' });
+                break;
+            }
+            default:
+                throw { code: 'UNKNOWN_COMMAND', message: `Unknown type: ${msg.type}` };
+        }
+    }
+    catch (err) {
+        post({
+            type: 'error',
+            code: err.code || 'WORKER_INTERNAL_ERROR',
+            message: err.message,
+        });
+    }
+});
+//# sourceMappingURL=HashWorker.js.map

package/dist/task/hash-task/worker/HashWorker.esm.js.map

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

package/dist/task/hash-task/worker/HashWorkerProtocol.esm.js

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

package/dist/task/hash-task/worker/HashWorkerProtocol.esm.js.map

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

package/dist/task/hash-task/worker/WorkerHandle.esm.js

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

package/dist/task/hash-task/worker/WorkerHandle.esm.js.map

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

package/dist/task/hash-task/worker/WorkerPool.esm.js

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

package/dist/task/hash-task/worker/WorkerPool.esm.js.map

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

package/dist/task/hash-task/worker/WorkerScriptBuilder.esm.js

@@ -0,0 +1,70 @@
+/**
+ * Worker脚本构建器
+ *
+ * 负责将算法函数转换为可在Worker中执行的源码字符串
+ * 设计原则：只负责脚本的构建，不关心算法的具体实现
+ *
+ * 明确不负责：
+ * - 不执行具体的哈希计算
+ * - 不管理Worker生命周期
+ * - 不处理通信协议
+ */
+export class WorkerScriptBuilder {
+    constructor() {
+        // 这里建议直接把模板内容嵌入或通过构建工具导入
+        this.template = `
+        // --- 注入的算法开始 ---
+        const userAlgorithm = {{ALGORITHM_PLACEHOLDER}};
+        // --- 注入的算法结束 ---
+
+        self.onmessage = async function(e) {
+            const { type, data, chunkId } = e.data;
+            
+            try {
+                if (type === 'update') {
+                    // 调用注入的算法
+                    const result = await userAlgorithm(data);
+                    self.postMessage({ type: 'ack', chunkId, result });
+                } else if (type === 'reset') {
+                    self.postMessage({ type: 'ack' });
+                }
+            } catch (error) {
+                self.postMessage({ type: 'error', message: error.message });
+            }
+        };
+    `;
+    }
+    /**
+     * 将算法转换成 Worker 可执行的源码
+     *
+     * @param algorithm 要构建的算法，可以是函数或字符串
+     * @returns 可在Worker中执行的源码字符串
+     */
+    build(algorithm) {
+        let fnString = '';
+        if (typeof algorithm === 'function') {
+            // 如果是函数，直接 toString()
+            fnString = algorithm.toString();
+        }
+        else {
+            // 如果是字符串（比如 'md5'），可以映射到内置的简单实现或 Web Crypto
+            fnString = this.getBuiltInAlgorithm(algorithm);
+        }
+        return this.template.replace('{{ALGORITHM_PLACEHOLDER}}', fnString);
+    }
+    /**
+     * 获取内置算法的实现
+     *
+     * @param name 算法名称
+     * @returns 对应算法的函数字符串实现
+     * @private
+     */
+    getBuiltInAlgorithm(name) {
+        // 示例：映射到浏览器原生的 Web Crypto (注意 digest 不支持流式，这只是示例)
+        return `async (data) => {
+            const hashBuffer = await self.crypto.subtle.digest('${name.toUpperCase()}', data);
+            return hashBuffer;
+        }`;
+    }
+}
+//# sourceMappingURL=WorkerScriptBuilder.js.map

package/dist/task/hash-task/worker/WorkerScriptBuilder.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkerScriptBuilder.js","sourceRoot":"","sources":["../../../../../src/task/hash-task/worker/WorkerScriptBuilder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,MAAM,OAAO,mBAAmB;IAAhC;QACI,yBAAyB;QACR,aAAQ,GAAG;;;;;;;;;;;;;;;;;;;;KAoB3B,CAAC;IAoCN,CAAC;IAlCG;;;;;OAKG;IACH,KAAK,CAAC,SAAgD;QAClD,IAAI,QAAQ,GAAG,EAAE,CAAC;QAElB,IAAI,OAAO,SAAS,KAAK,UAAU,EAAE,CAAC;YAClC,sBAAsB;YACtB,QAAQ,GAAG,SAAS,CAAC,QAAQ,EAAE,CAAC;QACpC,CAAC;aAAM,CAAC;YACJ,4CAA4C;YAC5C,QAAQ,GAAG,IAAI,CAAC,mBAAmB,CAAC,SAAS,CAAC,CAAC;QACnD,CAAC;QAED,OAAO,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,2BAA2B,EAAE,QAAQ,CAAC,CAAC;IACxE,CAAC;IAED;;;;;;OAMG;IACK,mBAAmB,CAAC,IAAY;QACpC,kDAAkD;QAClD,OAAO;kEACmD,IAAI,CAAC,WAAW,EAAE;;UAE1E,CAAC;IACP,CAAC;CACJ"}

package/dist/task/hash-task/worker/index.esm.js

@@ -0,0 +1,23 @@
+/**
+ * Worker模块的公共API导出
+ *
+ * 该模块提供了一个用于处理哈希计算任务的Worker管理解决方案，
+ * 包括Worker句柄、Worker池、通信协议和脚本构建等功能。
+ *
+ * 核心组件：
+ * - WorkerHandle: Worker句柄接口及实现
+ * - WorkerPool: Worker池接口及实现
+ * - HashWorkerProtocol: Worker通信协议定义
+ * - WorkerScriptBuilder: Worker脚本构建器
+ * - HashWorker: Node.js环境下的哈希计算Worker
+ */
+export * from './HashWorkerProtocol';
+export * from './HashWorker';
+export * from './WorkerPool';
+export * from './WorkerHandle';
+export * from './WorkerScriptBuilder';
+export * from './DefaultWorkerHandle';
+export * from './BrowserWorkerHandle';
+export * from './DefaultWorkerPool';
+export * from './BrowserWorkerPool';
+//# sourceMappingURL=index.js.map

package/dist/task/hash-task/worker/index.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/task/hash-task/worker/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,cAAc,sBAAsB,CAAC;AACrC,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC"}

package/dist/task/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qimen-lab/task",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "main": "index.js",
   "module": "index.esm.js",
   "types": "index.d.ts",
@@ -13,9 +13,9 @@
     }
   },
   "dependencies": {
-    "@qimen-lab/logger": "0.1.2",
-    "@qimen-lab/utils": "0.1.2",
-    "@qimen-lab/error": "0.1.2",
-    "@qimen-lab/runtime": "0.1.2"
+    "@qimen-lab/logger": "0.1.4",
+    "@qimen-lab/utils": "0.1.4",
+    "@qimen-lab/error": "0.1.4",
+    "@qimen-lab/runtime": "0.1.4"
   }
 }

package/dist/task/task/TaskQueue.esm.js

@@ -0,0 +1,176 @@
+import { Logger } from '../../logger/index.esm.js';
+import { time, string } from '../../utils/index.esm.js';
+/**
+ * 全局任务队列 - 用于管理任务执行、优先级排序和重试的核心类
+ *
+ * 该类实现了单例模式，确保整个应用中只有一个任务队列实例。
+ * 支持任务优先级、重试机制和轮询任务。
+ *
+ * @example
+ * ```ts
+ * // 获取全局任务队列实例并添加一个普通任务
+ * globalTaskQueue.addTask(
+ *   async () => console.log('Task executed'),
+ *   'HIGH',
+ *   3, // 最大重试次数
+ *   1000 // 重试延迟
+ * );
+ *
+ * // 添加一个轮询任务
+ * globalTaskQueue.addTask(
+ *   async () => fetch('/api/data'),
+ *   'NORMAL',
+ *   5,
+ *   1000,
+ *   true, // 轮询
+ *   5000  // 轮询间隔
+ * );
+ * ```
+ */
+export class GlobalTaskQueue {
+    /**
+     * 构造函数 - 创建任务队列实例
+     *
+     * @param maxConcurrentTasks - 最大并发任务数，默认为5
+     */
+    constructor(maxConcurrentTasks = 5) {
+        this.taskQueue = [];
+        this.isRunning = false;
+        this.maxConcurrentTasks = maxConcurrentTasks;
+        this.logger = Logger.for('GlobalTaskQueue');
+    }
+    /**
+     * 获取任务队列的单例实例
+     *
+     * @param maxConcurrentTasks - 可选参数，指定最大并发任务数
+     * @returns 返回任务队列的单例实例
+     */
+    static getInstance(maxConcurrentTasks) {
+        if (!GlobalTaskQueue.instance) {
+            GlobalTaskQueue.instance = new GlobalTaskQueue(maxConcurrentTasks);
+        }
+        return GlobalTaskQueue.instance;
+    }
+    /**
+     * 根据优先级对任务队列进行排序
+     *
+     * @returns 排序后的任务数组
+     * @private
+     */
+    getSortedQueue() {
+        const priorityMap = {
+            HIGH: 1,
+            NORMAL: 2,
+            LOW: 3,
+        };
+        return this.taskQueue.sort((a, b) => priorityMap[a.priority] - priorityMap[b.priority]);
+    }
+    /**
+     * 添加任务到队列
+     *
+     * @param fn - 要执行的任务函数，返回Promise
+     * @param priority - 任务优先级，默认为NORMAL
+     * @param maxRetries - 最大重试次数，默认为3
+     * @param delay - 重试延迟时间（毫秒），默认为1000
+     * @param isPolling - 是否为轮询任务，默认为false
+     * @param interval - 轮询间隔时间（毫秒），默认为5000
+     */
+    addTask(fn, priority = 'NORMAL', maxRetries = 3, delay = 1000, isPolling = false, interval = 5000) {
+        const task = {
+            id: string.getId('task-'),
+            fn,
+            retries: 0,
+            maxRetries,
+            delay,
+            priority,
+            isPolling,
+            interval,
+        };
+        this.taskQueue.push(task);
+        this.logger.debug(`Task added: ${task.id}, priority: ${task.priority}`);
+        this.run();
+    }
+    /**
+     * 处理任务的重试逻辑
+     *
+     * @param task - 需要重试的任务
+     * @returns 如果任务将被重试则返回true，否则返回false
+     * @private
+     */
+    async handleTaskRetry(task) {
+        if (task.retries < task.maxRetries) {
+            task.retries++;
+            await time.after(task.delay, () => this.addTask(task.fn, task.priority, task.maxRetries, task.delay, task.isPolling, task.interval));
+            return true;
+        }
+        else {
+            this.logger.error(`Task ${task.id} exceeded max retries`);
+            return false;
+        }
+    }
+    /**
+     * 处理轮询任务的重试逻辑
+     *
+     * @param task - 需要轮询的任务
+     * @returns 如果任务将被重试则返回true，否则返回false
+     * @private
+     */
+    async handlePollingTask(task) {
+        if (task.retries < task.maxRetries) {
+            task.retries++;
+            await time.after(task.interval, () => this.addTask(task.fn, task.priority, task.maxRetries, task.delay, task.isPolling, task.interval));
+            return true;
+        }
+        else {
+            this.logger.error(`Polling task ${task.id} exceeded max retries`);
+            return false;
+        }
+    }
+    /**
+     * 执行任务
+     *
+     * @param task - 要执行的任务
+     * @private
+     */
+    async runTask(task) {
+        try {
+            await task.fn();
+            this.logger.debug(`Task executed: ${task.id}`);
+            if (task.isPolling) {
+                // 执行完后继续轮询
+                this.handlePollingTask(task);
+            }
+        }
+        catch (error) {
+            this.logger.error(`Task failed: ${task.id}`, error);
+            if (task.isPolling) {
+                this.handlePollingTask(task);
+            }
+            else {
+                this.handleTaskRetry(task);
+            }
+        }
+    }
+    /**
+     * 执行队列中的任务
+     *
+     * @private
+     */
+    async run() {
+        if (this.isRunning) {
+            this.logger.debug('Task queue is already running');
+            return;
+        }
+        this.isRunning = true;
+        const sortedQueue = this.getSortedQueue();
+        const tasksToRun = sortedQueue.splice(0, this.maxConcurrentTasks);
+        this.logger.info(`Running ${tasksToRun.length} tasks concurrently`);
+        await Promise.all(tasksToRun.map(task => this.runTask(task)));
+        this.isRunning = false;
+        this.logger.debug('Task queue execution completed');
+    }
+}
+GlobalTaskQueue.instance = null;
+// Export the global instance getter
+export const globalTaskQueue = GlobalTaskQueue.getInstance();
+//# sourceMappingURL=TaskQueue.js.map

package/dist/task/task/TaskQueue.esm.js.map

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

package/dist/task/task/index.esm.js

@@ -0,0 +1,8 @@
+/**
+ * Task模块入口文件
+ *
+ * 该文件导出Task模块的核心类型定义和任务队列实现
+ */
+export * from './types';
+export * from './TaskQueue';
+//# sourceMappingURL=index.js.map

package/dist/task/task/index.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/task/task/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC"}

package/dist/task/task/types.esm.js

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

package/dist/task/task/types.esm.js.map

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

package/dist/task/worker/SimpleWorkerManager.esm.js

@@ -0,0 +1,57 @@
+import { WorkerManagerBase } from './WorkerManagerBase';
+/**
+ * SimpleWorkerManager 是一个简化版的 Web Worker 管理器
+ *
+ * 它基于 WorkerManagerBase 实现，通过构造函数传入的回调函数来处理消息和错误
+ * 遵循"配置优于继承"的设计原则，支持通过 WorkerManagerOptions 配置回调函数
+ */
+export class SimpleWorkerManager extends WorkerManagerBase {
+    /**
+     * 构造函数
+     *
+     * @param url Worker 脚本的 URL
+     * @param handlers 可选的回调函数集合，包括 onMessage、onError、onMessageError
+     */
+    constructor(url, handlers = {}) {
+        super(url);
+        this.handlers = handlers;
+    }
+    /**
+     * 处理从 Worker 接收到的消息
+     *
+     * 如果提供了 onMessage 回调函数，则调用它
+     *
+     * @param event MessageEvent 事件对象
+     */
+    onMessage(event) {
+        var _a, _b;
+        (_b = (_a = this.handlers).onMessage) === null || _b === void 0 ? void 0 : _b.call(_a, event);
+    }
+    /**
+     * 处理 Worker 的错误事件
+     *
+     * 如果提供了 onError 回调函数，则调用它
+     * 同时调用父类的错误处理方法以保持默认行为
+     *
+     * @param error ErrorEvent 事件对象
+     */
+    onError(error) {
+        var _a, _b;
+        (_b = (_a = this.handlers).onError) === null || _b === void 0 ? void 0 : _b.call(_a, error);
+        super.onError(error);
+    }
+    /**
+     * 处理 Worker 消息传递过程中的错误
+     *
+     * 如果提供了 onMessageError 回调函数，则调用它
+     * 同时调用父类的错误处理方法以保持默认行为
+     *
+     * @param error MessageEvent 事件对象
+     */
+    onMessageError(error) {
+        var _a, _b;
+        (_b = (_a = this.handlers).onMessageError) === null || _b === void 0 ? void 0 : _b.call(_a, error);
+        super.onMessageError(error);
+    }
+}
+//# sourceMappingURL=SimpleWorkerManager.js.map

package/dist/task/worker/SimpleWorkerManager.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SimpleWorkerManager.js","sourceRoot":"","sources":["../../../../src/task/worker/SimpleWorkerManager.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD;;;;;GAKG;AACH,MAAM,OAAO,mBAAoB,SAAQ,iBAAiB;IACtD;;;;;OAKG;IACH,YACI,GAAW,EACH,WAAiC,EAAE;QAE3C,KAAK,CAAC,GAAG,CAAC,CAAC;QAFH,aAAQ,GAAR,QAAQ,CAA2B;IAG/C,CAAC;IAED;;;;;;OAMG;IACO,SAAS,CAAC,KAAmB;;QACnC,MAAA,MAAA,IAAI,CAAC,QAAQ,EAAC,SAAS,mDAAG,KAAK,CAAC,CAAC;IACrC,CAAC;IAED;;;;;;;OAOG;IACO,OAAO,CAAC,KAAiB;;QAC/B,MAAA,MAAA,IAAI,CAAC,QAAQ,EAAC,OAAO,mDAAG,KAAK,CAAC,CAAC;QAC/B,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACzB,CAAC;IAED;;;;;;;OAOG;IACO,cAAc,CAAC,KAAmB;;QACxC,MAAA,MAAA,IAAI,CAAC,QAAQ,EAAC,cAAc,mDAAG,KAAK,CAAC,CAAC;QACtC,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;IAChC,CAAC;CACJ"}

package/dist/task/worker/WorkerManagerBase.esm.js

@@ -0,0 +1,87 @@
+import { Logger } from '../../logger/index.esm.js';
+/**
+ * Worker管理器基类
+ *
+ * 提供了Web Worker管理的基础功能，包括启动、停止、消息处理等。
+ * 使用抽象类设计，具体的onMessage处理需要子类实现。
+ *
+ * @example
+ * ```ts
+ * class MyWorkerManager extends WorkerManagerBase {
+ *   constructor(url: string) {
+ *     super(url);
+ *   }
+ *
+ *   protected onMessage(event: MessageEvent) {
+ *     console.log('Received message from worker:', event.data);
+ *   }
+ * }
+ * ```
+ */
+export class WorkerManagerBase {
+    /**
+     * 构造函数
+     *
+     * @param url Worker脚本的URL
+     */
+    constructor(url) {
+        this.url = url;
+        /** Worker实例，可能为空 */
+        this.worker = null;
+        this.logger = Logger.for(this.constructor.name);
+    }
+    /**
+     * 启动Worker
+     *
+     * 创建Worker实例并绑定消息和错误处理函数。
+     * 如果Worker已经启动，则不执行任何操作。
+     */
+    start() {
+        if (this.worker)
+            return;
+        this.worker = new Worker(this.url);
+        this.worker.onmessage = this.onMessage.bind(this);
+        this.worker.onerror = this.onError.bind(this);
+        this.worker.onmessageerror = this.onMessageError.bind(this);
+    }
+    /**
+     * 停止Worker
+     *
+     * 终止Worker实例并将其设置为null。
+     */
+    stop() {
+        var _a;
+        (_a = this.worker) === null || _a === void 0 ? void 0 : _a.terminate();
+        this.worker = null;
+    }
+    /**
+     * 向Worker发送消息
+     *
+     * @param data 要发送的数据
+     */
+    post(data) {
+        var _a;
+        (_a = this.worker) === null || _a === void 0 ? void 0 : _a.postMessage(data);
+    }
+    /**
+     * 处理Worker错误
+     *
+     * 记录错误信息到日志。
+     *
+     * @param error ErrorEvent对象，包含错误信息
+     */
+    onError(error) {
+        this.logger.error(error);
+    }
+    /**
+     * 处理Worker消息传递错误
+     *
+     * 记录消息传递错误信息到日志。
+     *
+     * @param error MessageEvent对象，包含错误信息
+     */
+    onMessageError(error) {
+        this.logger.error(error);
+    }
+}
+//# sourceMappingURL=WorkerManagerBase.js.map

package/dist/task/worker/WorkerManagerBase.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkerManagerBase.js","sourceRoot":"","sources":["../../../../src/task/worker/WorkerManagerBase.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAElD;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,OAAgB,iBAAiB;IAMnC;;;;OAIG;IACH,YAAsB,GAAW;QAAX,QAAG,GAAH,GAAG,CAAQ;QAVjC,oBAAoB;QACV,WAAM,GAAkB,IAAI,CAAC;QAUnC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IACpD,CAAC;IAED;;;;;OAKG;IACH,KAAK;QACD,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO;QACxB,IAAI,CAAC,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACnC,IAAI,CAAC,MAAM,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClD,IAAI,CAAC,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC9C,IAAI,CAAC,MAAM,CAAC,cAAc,GAAG,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAChE,CAAC;IAED;;;;OAIG;IACH,IAAI;;QACA,MAAA,IAAI,CAAC,MAAM,0CAAE,SAAS,EAAE,CAAC;QACzB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;IACvB,CAAC;IAED;;;;OAIG;IACO,IAAI,CAAC,IAAS;;QACpB,MAAA,IAAI,CAAC,MAAM,0CAAE,WAAW,CAAC,IAAI,CAAC,CAAC;IACnC,CAAC;IAWD;;;;;;OAMG;IACO,OAAO,CAAC,KAAiB;QAC/B,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC7B,CAAC;IAED;;;;;;OAMG;IACO,cAAc,CAAC,KAAmB;QACxC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC7B,CAAC;CACJ"}

package/dist/task/worker/index.esm.js

@@ -0,0 +1,9 @@
+/**
+ * Worker模块入口文件
+ *
+ * 该文件导出Worker模块的核心类和类型定义
+ */
+export * from './SimpleWorkerManager';
+export * from './WorkerManagerBase';
+export * from './types';
+//# sourceMappingURL=index.js.map

package/dist/task/worker/index.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/task/worker/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,SAAS,CAAC"}

package/dist/task/worker/types.esm.js

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

package/dist/task/worker/types.esm.js.map

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

package/dist/types/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qimen-lab/types",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "main": "index.js",
   "module": "index.esm.js",
   "types": "index.d.ts",