@qimen-lab/core 0.1.1

package/dist/task/hash-task/worker/BrowserWorkerHandle.js

@@ -0,0 +1,75 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BrowserWorkerHandle = void 0;
+/**
+ * 浏览器环境下的Worker句柄实现
+ *
+ * 提供了浏览器环境下Worker句柄接口的实现，用于与Web Worker通信
+ * 设计原则：只负责与Worker的通信和生命周期管理，不关心具体执行的算法
+ *
+ * 明确不负责：
+ * - 不执行具体的哈希计算
+ * - 不管理任务状态
+ * - 不处理算法逻辑
+ */
+class BrowserWorkerHandle {
+    /**
+     * 构造函数
+     *
+     * @param workerScriptUrl Worker脚本的URL
+     */
+    constructor(workerScriptUrl) {
+        this.id = `worker-${Math.random().toString(36).substr(2, 9)}`;
+        this.worker = new Worker(workerScriptUrl);
+    }
+    /**
+     * 向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);
+        // 返回一个清理函数，这就是我们之前讨论的"自清理"模式
+        return () => this.worker.removeEventListener('message', wrapper);
+    }
+    /**
+     * 注册错误监听，并返回一个取消监听的函数
+     *
+     * @param handler 错误处理函数
+     * @returns 用于取消监听的函数
+     */
+    onError(handler) {
+        const wrapper = (e) => handler(new Error(e.message));
+        this.worker.addEventListener('error', wrapper);
+        return () => this.worker.removeEventListener('error', wrapper);
+    }
+    /**
+     * 终止Worker
+     *
+     * 终止Worker线程
+     */
+    async terminate() {
+        this.worker.terminate();
+    }
+    /**
+     * 检查Worker是否仍在运行
+     *
+     * @returns 如果Worker正在运行则返回true，否则返回false
+     */
+    isAlive() {
+        return !!this.worker;
+    }
+}
+exports.BrowserWorkerHandle = BrowserWorkerHandle;
+//# sourceMappingURL=BrowserWorkerHandle.js.map

package/dist/task/hash-task/worker/BrowserWorkerHandle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BrowserWorkerHandle.js","sourceRoot":"","sources":["../../../../../src/task/hash-task/worker/BrowserWorkerHandle.ts"],"names":[],"mappings":";;;AAEA;;;;;;;;;;GAUG;AACH,MAAa,mBAAmB;IAI5B;;;;OAIG;IACH,YAAY,eAAuB;QAC/B,IAAI,CAAC,EAAE,GAAG,UAAU,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;QAC9D,IAAI,CAAC,MAAM,GAAG,IAAI,MAAM,CAAC,eAAe,CAAC,CAAC;IAC9C,CAAC;IAED;;;;;OAKG;IACH,IAAI,CAAU,OAAU,EAAE,QAAyB;QAC/C,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,6BAA6B;QAC7B,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,mBAAmB,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IACrE,CAAC;IAED;;;;;OAKG;IACH,OAAO,CAAC,OAA6B;QACjC,MAAM,OAAO,GAAG,CAAC,CAAa,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;QACjE,IAAI,CAAC,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAC/C,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACnE,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,SAAS;QACX,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;IAC5B,CAAC;IAED;;;;OAIG;IACH,OAAO;QACH,OAAO,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC;IACzB,CAAC;CACJ;AAnED,kDAmEC"}

package/dist/task/hash-task/worker/BrowserWorkerPool.d.ts

@@ -0,0 +1,21 @@
+import { DefaultWorkerPool } from './DefaultWorkerPool';
+/**
+ * 浏览器环境下的Worker池实现
+ *
+ * 继承自DefaultWorkerPool，针对浏览器环境进行了优化
+ * 设计原则：只负责Worker的生命周期管理，不关心具体执行的任务
+ *
+ * 明确不负责：
+ * - 不执行具体的哈希计算
+ * - 不管理任务状态
+ * - 不处理算法逻辑
+ */
+export declare class BrowserWorkerPool extends DefaultWorkerPool {
+    /**
+     * 浏览器环境下的池子实现
+     *
+     * @param poolSize 并行 Worker 数量，默认根据 CPU 核心数计算
+     */
+    constructor(poolSize?: number);
+}
+//# sourceMappingURL=BrowserWorkerPool.d.ts.map

package/dist/task/hash-task/worker/BrowserWorkerPool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BrowserWorkerPool.d.ts","sourceRoot":"","sources":["../../../../../src/task/hash-task/worker/BrowserWorkerPool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD;;;;;;;;;;GAUG;AACH,qBAAa,iBAAkB,SAAQ,iBAAiB;IACpD;;;;OAIG;gBACS,QAAQ,GAAE,MAAwD;CAIjF"}

package/dist/task/hash-task/worker/BrowserWorkerPool.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BrowserWorkerPool = void 0;
+const DefaultWorkerPool_1 = require("./DefaultWorkerPool");
+/**
+ * 浏览器环境下的Worker池实现
+ *
+ * 继承自DefaultWorkerPool，针对浏览器环境进行了优化
+ * 设计原则：只负责Worker的生命周期管理，不关心具体执行的任务
+ *
+ * 明确不负责：
+ * - 不执行具体的哈希计算
+ * - 不管理任务状态
+ * - 不处理算法逻辑
+ */
+class BrowserWorkerPool extends DefaultWorkerPool_1.DefaultWorkerPool {
+    /**
+     * 浏览器环境下的池子实现
+     *
+     * @param poolSize 并行 Worker 数量，默认根据 CPU 核心数计算
+     */
+    constructor(poolSize = Math.min(navigator.hardwareConcurrency || 4, 8)) {
+        // 现在父类构造函数只接收 maxWorkers
+        super(poolSize);
+    }
+}
+exports.BrowserWorkerPool = BrowserWorkerPool;
+//# sourceMappingURL=BrowserWorkerPool.js.map

package/dist/task/hash-task/worker/BrowserWorkerPool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BrowserWorkerPool.js","sourceRoot":"","sources":["../../../../../src/task/hash-task/worker/BrowserWorkerPool.ts"],"names":[],"mappings":";;;AAAA,2DAAwD;AAExD;;;;;;;;;;GAUG;AACH,MAAa,iBAAkB,SAAQ,qCAAiB;IACpD;;;;OAIG;IACH,YAAY,WAAmB,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,mBAAmB,IAAI,CAAC,EAAE,CAAC,CAAC;QAC1E,yBAAyB;QACzB,KAAK,CAAC,QAAQ,CAAC,CAAC;IACpB,CAAC;CACJ;AAVD,8CAUC"}

package/dist/task/hash-task/worker/DefaultWorkerHandle.d.ts

@@ -0,0 +1,58 @@
+import { WorkerHandle } from './WorkerHandle';
+/**
+ * 默认Worker句柄实现
+ *
+ * 提供了Worker句柄接口的默认实现，用于与Web Worker通信
+ * 设计原则：只负责与Worker的通信和生命周期管理，不关心具体执行的算法
+ *
+ * 明确不负责：
+ * - 不执行具体的哈希计算
+ * - 不管理任务状态
+ * - 不处理算法逻辑
+ */
+export declare class DefaultWorkerHandle implements WorkerHandle {
+    private logger;
+    private worker;
+    readonly id: string;
+    private cleanupFns;
+    /**
+     * 构造函数
+     *
+     * @param scriptUrl Worker脚本的URL
+     */
+    constructor(scriptUrl: string | URL);
+    /**
+     * 向Worker发送消息
+     *
+     * @param message 要发送的消息内容
+     * @param transfer 可选的可转移对象数组，用于零拷贝传输
+     */
+    post<T = any>(message: T, transfer?: Transferable[]): void;
+    /**
+     * 注册消息监听，并返回一个取消监听的函数
+     *
+     * @param handler 消息处理函数
+     * @returns 用于取消监听的函数
+     */
+    onMessage(handler: (msg: any) => void): () => void;
+    /**
+     * 注册错误监听，并返回一个取消监听的函数
+     *
+     * @param handler 错误处理函数
+     * @returns 用于取消监听的函数
+     */
+    onError(handler: (err: Error) => void): () => void;
+    /**
+     * 终止Worker
+     *
+     * 清理所有事件监听器并终止Worker线程
+     */
+    terminate(): Promise<void>;
+    /**
+     * 检查Worker是否仍在运行
+     *
+     * @returns 如果Worker正在运行则返回true，否则返回false
+     */
+    isAlive(): boolean;
+}
+//# sourceMappingURL=DefaultWorkerHandle.d.ts.map

package/dist/task/hash-task/worker/DefaultWorkerHandle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DefaultWorkerHandle.d.ts","sourceRoot":"","sources":["../../../../../src/task/hash-task/worker/DefaultWorkerHandle.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C;;;;;;;;;;GAUG;AACH,qBAAa,mBAAoB,YAAW,YAAY;IACpD,OAAO,CAAC,MAAM,CAAU;IACxB,OAAO,CAAC,MAAM,CAAS;IACvB,SAAgB,EAAE,EAAE,MAAM,CAAC;IAE3B,OAAO,CAAC,UAAU,CAA8B;IAEhD;;;;OAIG;gBACS,SAAS,EAAE,MAAM,GAAG,GAAG;IAMnC;;;;;OAKG;IACH,IAAI,CAAC,CAAC,GAAG,GAAG,EAAE,OAAO,EAAE,CAAC,EAAE,QAAQ,CAAC,EAAE,YAAY,EAAE,GAAG,IAAI;IAK1D;;;;;OAKG;IACH,SAAS,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,IAAI,GAAG,MAAM,IAAI;IAalD;;;;;OAKG;IACH,OAAO,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,KAAK,KAAK,IAAI,GAAG,MAAM,IAAI;IAgBlD;;;;OAIG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAUhC;;;;OAIG;IACH,OAAO,IAAI,OAAO;CAGrB"}

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

@@ -0,0 +1,97 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DefaultWorkerHandle = void 0;
+const logger_1 = require("@qimenjs/logger");
+/**
+ * 默认Worker句柄实现
+ *
+ * 提供了Worker句柄接口的默认实现，用于与Web Worker通信
+ * 设计原则：只负责与Worker的通信和生命周期管理，不关心具体执行的算法
+ *
+ * 明确不负责：
+ * - 不执行具体的哈希计算
+ * - 不管理任务状态
+ * - 不处理算法逻辑
+ */
+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_1.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;
+    }
+}
+exports.DefaultWorkerHandle = DefaultWorkerHandle;
+//# sourceMappingURL=DefaultWorkerHandle.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DefaultWorkerHandle.js","sourceRoot":"","sources":["../../../../../src/task/hash-task/worker/DefaultWorkerHandle.ts"],"names":[],"mappings":";;;AAAA,4CAAkD;AAGlD;;;;;;;;;;GAUG;AACH,MAAa,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,eAAM,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;AA7FD,kDA6FC"}

package/dist/task/hash-task/worker/DefaultWorkerPool.d.ts

@@ -0,0 +1,51 @@
+import { WorkerHandle } from './WorkerHandle';
+import { WorkerPool } from './WorkerPool';
+/**
+ * 默认Worker池实现
+ *
+ * 提供了Worker池的基本功能，包括Worker的获取、归还和销毁
+ * 设计原则：只负责Worker的生命周期管理，不关心具体执行的任务
+ *
+ * 明确不负责：
+ * - 不执行具体的哈希计算
+ * - 不管理任务状态
+ * - 不处理算法逻辑
+ */
+export declare class DefaultWorkerPool implements WorkerPool {
+    private readonly maxWorkers;
+    private readonly idleWorkers;
+    private readonly allWorkers;
+    private readonly waiters;
+    private isDestroyed;
+    /**
+     * 构造函数
+     *
+     * @param maxWorkers 最大Worker数量，默认为硬件并发数或8，取较小值
+     */
+    constructor(maxWorkers?: number);
+    /**
+     * 获取一个可用的Worker
+     *
+     * 如果有空闲Worker则直接返回，否则如果未达到最大数量则创建新的，
+     * 否则等待其他任务释放Worker
+     *
+     * @param scriptSource 要注入Worker的脚本源码
+     * @returns 可用的Worker句柄
+     */
+    acquire(scriptSource: string): Promise<WorkerHandle>;
+    /**
+     * 归还Worker到池子
+     *
+     * 将使用完毕的Worker归还到池中，供其他任务使用
+     *
+     * @param worker 要归还的Worker句柄
+     */
+    release(worker: WorkerHandle): void;
+    /**
+     * 销毁整个Worker池
+     *
+     * 终止并清理池中的所有Worker，释放相关资源
+     */
+    destroy(): Promise<void>;
+}
+//# sourceMappingURL=DefaultWorkerPool.d.ts.map

package/dist/task/hash-task/worker/DefaultWorkerPool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DefaultWorkerPool.d.ts","sourceRoot":"","sources":["../../../../../src/task/hash-task/worker/DefaultWorkerPool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAG1C;;;;;;;;;;GAUG;AACH,qBAAa,iBAAkB,YAAW,UAAU;IAa5C,OAAO,CAAC,QAAQ,CAAC,UAAU;IAZ/B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAsB;IAClD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA2B;IACtD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA6C;IAErE,OAAO,CAAC,WAAW,CAAS;IAE5B;;;;OAIG;gBAEkB,UAAU,GAAE,MAAwD;IAGzF;;;;;;;;OAQG;IACG,OAAO,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IA2B1D;;;;;;OAMG;IACH,OAAO,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI;IAgBnC;;;;OAIG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAWjC"}

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

@@ -0,0 +1,100 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DefaultWorkerPool = void 0;
+const DefaultWorkerHandle_1 = require("./DefaultWorkerHandle");
+/**
+ * 默认Worker池实现
+ *
+ * 提供了Worker池的基本功能，包括Worker的获取、归还和销毁
+ * 设计原则：只负责Worker的生命周期管理，不关心具体执行的任务
+ *
+ * 明确不负责：
+ * - 不执行具体的哈希计算
+ * - 不管理任务状态
+ * - 不处理算法逻辑
+ */
+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_1.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;
+    }
+}
+exports.DefaultWorkerPool = DefaultWorkerPool;
+//# sourceMappingURL=DefaultWorkerPool.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DefaultWorkerPool.js","sourceRoot":"","sources":["../../../../../src/task/hash-task/worker/DefaultWorkerPool.ts"],"names":[],"mappings":";;;AAEA,+DAA4D;AAE5D;;;;;;;;;;GAUG;AACH,MAAa,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,yCAAmB,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;AA3FD,8CA2FC"}

package/dist/task/hash-task/worker/HashWorker.d.ts

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

package/dist/task/hash-task/worker/HashWorker.d.ts.map

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

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

@@ -0,0 +1,134 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const worker_threads_1 = require("worker_threads");
+const crypto = __importStar(require("crypto"));
+/**
+ * Node.js环境下的哈希计算Worker
+ *
+ * 该Worker只负责一件事：按固定协议，增量计算哈希
+ *
+ * 必须满足：
+ * ❌ 不 eval
+ * ❌ 不接受函数
+ * ❌ 不关心任务状态 / 进度
+ * ✔ 支持大文件（多次 update）
+ * ✔ 可被 reset / 重用
+ * ✔ 出错可恢复
+ */
+if (!worker_threads_1.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) {
+    worker_threads_1.parentPort.postMessage(message);
+}
+/**
+ * 重置内部哈希状态
+ */
+function reset() {
+    hash = null;
+    algorithm = null;
+}
+worker_threads_1.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.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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"}