@qimen-lab/core 0.1.4 → 0.1.5

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

@@ -0,0 +1,93 @@
+import { Logger } from '../../../logger/index.esm.js';
+/**
+ * 默认Worker句柄实现
+ *
+ * 提供了Worker句柄接口的默认实现，用于与Web Worker通信
+ * 设计原则：只负责与Worker的通信和生命周期管理，不关心具体执行的算法
+ *
+ * 明确不负责：
+ * - 不执行具体的哈希计算
+ * - 不管理任务状态
+ * - 不处理算法逻辑
+ */
+export class DefaultWorkerHandle {
+    /**
+     * 构造函数
+     *
+     * @param scriptUrl Worker脚本的URL
+     */
+    constructor(scriptUrl) {
+        // 内部维护一个清理函数集，确保 terminate 时彻底释放
+        this.cleanupFns = new Set();
+        this.id = `worker-${Math.random().toString(36).slice(2, 11)}`;
+        this.worker = new Worker(scriptUrl);
+        this.logger = Logger.for(this.constructor.name);
+    }
+    /**
+     * 向Worker发送消息
+     *
+     * @param message 要发送的消息内容
+     * @param transfer 可选的可转移对象数组，用于零拷贝传输
+     */
+    post(message, transfer) {
+        // 这里的第二个参数可选，用于零拷贝
+        this.worker.postMessage(message, transfer || []);
+    }
+    /**
+     * 注册消息监听，并返回一个取消监听的函数
+     *
+     * @param handler 消息处理函数
+     * @returns 用于取消监听的函数
+     */
+    onMessage(handler) {
+        const wrapper = (e) => handler(e.data);
+        this.worker.addEventListener('message', wrapper);
+        const unsubscribe = () => {
+            this.worker.removeEventListener('message', wrapper);
+            this.cleanupFns.delete(unsubscribe);
+        };
+        this.cleanupFns.add(unsubscribe);
+        return unsubscribe;
+    }
+    /**
+     * 注册错误监听，并返回一个取消监听的函数
+     *
+     * @param handler 错误处理函数
+     * @returns 用于取消监听的函数
+     */
+    onError(handler) {
+        const wrapper = (e) => {
+            this.logger.error(`Worker Error [${this.id}]:`, e.message); // 增加日志记录
+            handler(new Error(e.message));
+        };
+        this.worker.addEventListener('error', wrapper);
+        const unsubscribe = () => {
+            this.worker.removeEventListener('error', wrapper);
+            this.cleanupFns.delete(unsubscribe);
+        };
+        this.cleanupFns.add(unsubscribe);
+        return unsubscribe;
+    }
+    /**
+     * 终止Worker
+     *
+     * 清理所有事件监听器并终止Worker线程
+     */
+    async terminate() {
+        this.logger.debug(`Terminating worker: ${this.id}`);
+        // 1. 执行所有未完成的清理（移除事件监听）
+        this.cleanupFns.forEach(unsub => unsub());
+        this.cleanupFns.clear();
+        // 2. 彻底终结线程
+        this.worker.terminate();
+    }
+    /**
+     * 检查Worker是否仍在运行
+     *
+     * @returns 如果Worker正在运行则返回true，否则返回false
+     */
+    isAlive() {
+        return !!this.worker;
+    }
+}
+//# sourceMappingURL=DefaultWorkerHandle.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DefaultWorkerHandle.js","sourceRoot":"","sources":["../../../../../src/task/hash-task/worker/DefaultWorkerHandle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAGlD;;;;;;;;;;GAUG;AACH,MAAM,OAAO,mBAAmB;IAO5B;;;;OAIG;IACH,YAAY,SAAuB;QARnC,iCAAiC;QACzB,eAAU,GAAoB,IAAI,GAAG,EAAE,CAAC;QAQ5C,IAAI,CAAC,EAAE,GAAG,UAAU,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;QAC9D,IAAI,CAAC,MAAM,GAAG,IAAI,MAAM,CAAC,SAAS,CAAC,CAAC;QACpC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IACpD,CAAC;IAED;;;;;OAKG;IACH,IAAI,CAAU,OAAU,EAAE,QAAyB;QAC/C,mBAAmB;QACnB,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,OAAO,EAAE,QAAQ,IAAI,EAAE,CAAC,CAAC;IACrD,CAAC;IAED;;;;;OAKG;IACH,SAAS,CAAC,OAA2B;QACjC,MAAM,OAAO,GAAG,CAAC,CAAe,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACrD,IAAI,CAAC,MAAM,CAAC,gBAAgB,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QAEjD,MAAM,WAAW,GAAG,GAAG,EAAE;YACrB,IAAI,CAAC,MAAM,CAAC,mBAAmB,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;YACpD,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;QACxC,CAAC,CAAC;QAEF,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QACjC,OAAO,WAAW,CAAC;IACvB,CAAC;IAED;;;;;OAKG;IACH,OAAO,CAAC,OAA6B;QACjC,MAAM,OAAO,GAAG,CAAC,CAAa,EAAE,EAAE;YAC9B,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,iBAAiB,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS;YACrE,OAAO,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;QAClC,CAAC,CAAC;QACF,IAAI,CAAC,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAE/C,MAAM,WAAW,GAAG,GAAG,EAAE;YACrB,IAAI,CAAC,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAClD,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;QACxC,CAAC,CAAC;QAEF,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QACjC,OAAO,WAAW,CAAC;IACvB,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,SAAS;QACX,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,uBAAuB,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;QACpD,wBAAwB;QACxB,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC;QAC1C,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;QAExB,YAAY;QACZ,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;IAC5B,CAAC;IAED;;;;OAIG;IACH,OAAO;QACH,OAAO,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC;IACzB,CAAC;CACJ"}

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

@@ -0,0 +1,96 @@
+import { DefaultWorkerHandle } from './DefaultWorkerHandle';
+/**
+ * 默认Worker池实现
+ *
+ * 提供了Worker池的基本功能，包括Worker的获取、归还和销毁
+ * 设计原则：只负责Worker的生命周期管理，不关心具体执行的任务
+ *
+ * 明确不负责：
+ * - 不执行具体的哈希计算
+ * - 不管理任务状态
+ * - 不处理算法逻辑
+ */
+export class DefaultWorkerPool {
+    /**
+     * 构造函数
+     *
+     * @param maxWorkers 最大Worker数量，默认为硬件并发数或8，取较小值
+     */
+    constructor(maxWorkers = Math.min(navigator.hardwareConcurrency || 4, 8)) {
+        this.maxWorkers = maxWorkers;
+        this.idleWorkers = [];
+        this.allWorkers = new Set();
+        this.waiters = [];
+        this.isDestroyed = false;
+    }
+    /**
+     * 获取一个可用的Worker
+     *
+     * 如果有空闲Worker则直接返回，否则如果未达到最大数量则创建新的，
+     * 否则等待其他任务释放Worker
+     *
+     * @param scriptSource 要注入Worker的脚本源码
+     * @returns 可用的Worker句柄
+     */
+    async acquire(scriptSource) {
+        if (this.isDestroyed)
+            throw new Error('WorkerPool is destroyed');
+        // 1. 如果有闲置的 Worker
+        const idle = this.idleWorkers.pop();
+        if (idle) {
+            // 这里有一个进阶逻辑：
+            // 如果你希望 Worker 复用（不重造 Blob），你可能需要判断 idle 的 Worker
+            // 里面跑的代码是否和当前 scriptSource 一致。
+            // 但为了简单和"不限定算法包"，我们这里选择：只要是归还的，就直接用（假设 Runner 会发 reset 消息）
+            return idle;
+        }
+        // 2. 如果还没到上限，造个新的
+        if (this.allWorkers.size < this.maxWorkers) {
+            // 这里的 scriptSource 就是 WorkerScriptBuilder 生成的完整 JS 代码
+            const worker = new DefaultWorkerHandle(scriptSource);
+            this.allWorkers.add(worker);
+            return worker;
+        }
+        // 3. 否则，排队等别人释放
+        return new Promise(resolve => {
+            this.waiters.push(resolve);
+        });
+    }
+    /**
+     * 归还Worker到池子
+     *
+     * 将使用完毕的Worker归还到池中，供其他任务使用
+     *
+     * @param worker 要归还的Worker句柄
+     */
+    release(worker) {
+        if (this.isDestroyed) {
+            worker.terminate();
+            return;
+        }
+        // 如果有人在排队，直接转交给排队的人
+        const nextWaiter = this.waiters.shift();
+        if (nextWaiter) {
+            nextWaiter(worker);
+        }
+        else {
+            // 否则放入闲置队列
+            this.idleWorkers.push(worker);
+        }
+    }
+    /**
+     * 销毁整个Worker池
+     *
+     * 终止并清理池中的所有Worker，释放相关资源
+     */
+    async destroy() {
+        this.isDestroyed = true;
+        // 终止所有 Worker
+        const terminations = Array.from(this.allWorkers).map(w => w.terminate());
+        await Promise.all(terminations);
+        this.allWorkers.clear();
+        this.idleWorkers.length = 0;
+        this.waiters.length = 0;
+    }
+}
+//# sourceMappingURL=DefaultWorkerPool.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DefaultWorkerPool.js","sourceRoot":"","sources":["../../../../../src/task/hash-task/worker/DefaultWorkerPool.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAE5D;;;;;;;;;;GAUG;AACH,MAAM,OAAO,iBAAiB;IAO1B;;;;OAIG;IACH,YACqB,aAAqB,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,mBAAmB,IAAI,CAAC,EAAE,CAAC,CAAC;QAApE,eAAU,GAAV,UAAU,CAA0D;QAZxE,gBAAW,GAAmB,EAAE,CAAC;QACjC,eAAU,GAAG,IAAI,GAAG,EAAgB,CAAC;QACrC,YAAO,GAA0C,EAAE,CAAC;QAE7D,gBAAW,GAAG,KAAK,CAAC;IASzB,CAAC;IAEJ;;;;;;;;OAQG;IACH,KAAK,CAAC,OAAO,CAAC,YAAoB;QAC9B,IAAI,IAAI,CAAC,WAAW;YAAE,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;QAEjE,mBAAmB;QACnB,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,EAAE,CAAC;QACpC,IAAI,IAAI,EAAE,CAAC;YACP,aAAa;YACb,kDAAkD;YAClD,+BAA+B;YAC/B,2DAA2D;YAC3D,OAAO,IAAI,CAAC;QAChB,CAAC;QAED,kBAAkB;QAClB,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;YACzC,sDAAsD;YACtD,MAAM,MAAM,GAAG,IAAI,mBAAmB,CAAC,YAAY,CAAC,CAAC;YACrD,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YAC5B,OAAO,MAAM,CAAC;QAClB,CAAC;QAED,gBAAgB;QAChB,OAAO,IAAI,OAAO,CAAe,OAAO,CAAC,EAAE;YACvC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC/B,CAAC,CAAC,CAAC;IACP,CAAC;IAED;;;;;;OAMG;IACH,OAAO,CAAC,MAAoB;QACxB,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACnB,MAAM,CAAC,SAAS,EAAE,CAAC;YACnB,OAAO;QACX,CAAC;QAED,oBAAoB;QACpB,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QACxC,IAAI,UAAU,EAAE,CAAC;YACb,UAAU,CAAC,MAAM,CAAC,CAAC;QACvB,CAAC;aAAM,CAAC;YACJ,WAAW;YACX,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAClC,CAAC;IACL,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,OAAO;QACT,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;QAExB,cAAc;QACd,MAAM,YAAY,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC;QACzE,MAAM,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QAEhC,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;QACxB,IAAI,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC;QAC5B,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;IAC5B,CAAC;CACJ"}

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.3",
+  "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.3",
-    "@qimen-lab/utils": "0.1.3",
-    "@qimen-lab/error": "0.1.3",
-    "@qimen-lab/runtime": "0.1.3"
+    "@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":""}