@qimen-lab/core 0.1.3 → 0.1.5

package/dist/task/hash-task/hash/HashTaskState.esm.js

@@ -0,0 +1,203 @@
+import { TaskStateError } from '../errors';
+/**
+ * 哈希任务状态管理类
+ *
+ * 管理哈希任务的整个生命周期状态，包括状态迁移验证和状态查询
+ */
+export class HashTaskState {
+    constructor() {
+        this.status = 'idle';
+    }
+    /**
+     * 获取当前任务状态
+     */
+    get value() {
+        return this.status;
+    }
+    /* ---------------- 状态查询 ---------------- */
+    /**
+     * 检查是否可以开始任务
+     *
+     * @returns 如果当前状态为 'idle' 则返回 true，否则返回 false
+     */
+    canStart() {
+        return this.status === 'idle';
+    }
+    /**
+     * 检查是否可以暂停任务
+     *
+     * @returns 如果当前状态为 'running' 则返回 true，否则返回 false
+     */
+    canPause() {
+        return this.status === 'running';
+    }
+    /**
+     * 检查是否可以恢复任务
+     *
+     * @returns 如果当前状态为 'paused' 则返回 true，否则返回 false
+     */
+    canResume() {
+        return this.status === 'paused';
+    }
+    /**
+     * 检查是否可以取消任务
+     *
+     * @returns 如果当前状态为 'running' 或 'paused' 则返回 true，否则返回 false
+     */
+    canCancel() {
+        return this.status === 'running' || this.status === 'paused';
+    }
+    /**
+     * 检查任务是否已完成
+     *
+     * @returns 如果当前状态为 'completed'、'failed' 或 'cancelled' 则返回 true，否则返回 false
+     */
+    isFinished() {
+        return (this.status === 'completed' || this.status === 'failed' || this.status === 'cancelled');
+    }
+    /**
+     * 适配 Runner 的检查逻辑
+     * 判断任务是否因为用户操作而进入了取消状态
+     *
+     * @returns 如果当前状态为 'cancelled' 则返回 true，否则返回 false
+     */
+    isCancelled() {
+        return this.status === 'cancelled';
+    }
+    /* ---------------- 状态迁移 ---------------- */
+    /**
+     * 开始任务
+     *
+     * 将任务状态从 'idle' 迁移到 'running'，并记录开始时间
+     *
+     * @throws TaskStateError 如果当前状态不允许开始操作
+     */
+    start() {
+        if (!this.canStart()) {
+            throw new TaskStateError(`Cannot start task from state "${this.status}"`, {
+                current: this.status,
+            });
+        }
+        this.status = 'running';
+        this.startedAt = Date.now();
+    }
+    /**
+     * 暂停任务
+     *
+     * 将任务状态从 'running' 迁移到 'paused'，并记录暂停时间
+     *
+     * @throws TaskStateError 如果当前状态不允许暂停操作
+     */
+    pause() {
+        if (!this.canPause()) {
+            throw new TaskStateError(`Cannot pause task from state "${this.status}"`, {
+                current: this.status,
+            });
+        }
+        this.status = 'paused';
+        this.pausedAt = Date.now();
+    }
+    /**
+     * 恢复任务
+     *
+     * 将任务状态从 'paused' 迁移到 'running'，并清除暂停时间
+     *
+     * @throws TaskStateError 如果当前状态不允许恢复操作
+     */
+    resume() {
+        if (!this.canResume()) {
+            throw new TaskStateError(`Cannot resume task from state "${this.status}"`, {
+                current: this.status,
+            });
+        }
+        this.status = 'running';
+        this.pausedAt = undefined;
+    }
+    /**
+     * 完成任务
+     *
+     * 将任务状态从 'running' 迁移到 'completed'，并记录完成时间
+     *
+     * @throws TaskStateError 如果当前状态不允许完成操作
+     */
+    complete() {
+        // 修复：应该检查当前状态是否允许完成任务
+        if (this.status !== 'running') {
+            throw new TaskStateError(`Cannot complete task from state "${this.status}"`, {
+                current: this.status,
+            });
+        }
+        this.status = 'completed';
+        this.finishedAt = Date.now();
+    }
+    /**
+     * 标记任务失败
+     *
+     * 将任务状态迁移到 'failed'，并记录完成时间
+     *
+     * @param error 失败的错误对象
+     * @throws TaskStateError 如果当前状态不允许失败操作
+     */
+    fail(error) {
+        if (this.isFinished()) {
+            throw new TaskStateError(`Cannot fail task from state "${this.status}"`, {
+                current: this.status,
+                error,
+            });
+        }
+        this.status = 'failed';
+        this.finishedAt = Date.now();
+    }
+    /**
+     * 取消任务
+     *
+     * 将任务状态迁移到 'cancelled'，并记录完成时间
+     *
+     * @throws TaskStateError 如果当前状态不允许取消操作
+     */
+    cancel() {
+        // 修复：应该检查当前状态是否允许取消任务
+        if (!this.canCancel()) {
+            throw new TaskStateError(`Cannot cancel task from state "${this.status}"`, {
+                current: this.status,
+            });
+        }
+        this.status = 'cancelled';
+        this.finishedAt = Date.now();
+    }
+    /* ---------------- 快照 ---------------- */
+    /**
+     * 生成当前状态的快照
+     *
+     * @returns 任务状态快照
+     */
+    snapshot() {
+        return {
+            status: this.status,
+            startedAt: this.startedAt,
+            finishedAt: this.finishedAt,
+            pausedAt: this.pausedAt,
+        };
+    }
+    /**
+     * 适配 Runner 的状态更新逻辑
+     * 将状态迁移封装一层，方便 Runner 调用
+     *
+     * @param newStatus 新的任务状态
+     */
+    updateStatus(newStatus) {
+        // 简单的状态映射或直接赋值（如果外部已经校验过逻辑）
+        switch (newStatus) {
+            case 'running':
+                if (this.canStart())
+                    this.start();
+                break;
+            case 'cancelled':
+                if (this.canCancel())
+                    this.cancel();
+                break;
+            // ... 其他状态映射
+        }
+    }
+}
+//# sourceMappingURL=HashTaskState.js.map

package/dist/task/hash-task/hash/HashTaskState.esm.js.map

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

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

@@ -0,0 +1,13 @@
+/**
+ * Hash任务模块的公共API导出
+ *
+ * 该模块提供了一个用于处理大文件或数据流的哈希计算任务的完整解决方案，
+ * 包括进度监控、暂停/恢复/取消操作、资源管理等功能。
+ */
+export * from './HashTask';
+export * from './HashTaskProgress';
+export * from './HashTaskResources';
+export * from './HashTaskRunner';
+export * from './HashTaskState';
+export * from './HashTaskHealthMonitor';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/task/hash-task/hash/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,yBAAyB,CAAC"}

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

@@ -0,0 +1,13 @@
+/**
+ * HashTask模块入口文件
+ *
+ * 该文件导出HashTask模块的所有公共API，包括工厂函数、数据块处理、错误定义、
+ * 哈希计算核心功能、类型定义和Worker相关功能
+ */
+export * from './factory';
+export * from './chunk';
+export * from './errors';
+export * from './hash';
+export * from './types';
+export * from './worker';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/task/hash-task/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC"}

package/dist/task/hash-task/types/algorithm.esm.js

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

package/dist/task/hash-task/types/algorithm.esm.js.map

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

package/dist/task/hash-task/types/chunk.esm.js

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

package/dist/task/hash-task/types/chunk.esm.js.map

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

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

@@ -0,0 +1,5 @@
+export * from './algorithm';
+export * from './chunk';
+export * from './task';
+export * from './worker';
+//# sourceMappingURL=index.js.map

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

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

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

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

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

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

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

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

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

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

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

@@ -0,0 +1,71 @@
+/**
+ * 浏览器环境下的Worker句柄实现
+ *
+ * 提供了浏览器环境下Worker句柄接口的实现，用于与Web Worker通信
+ * 设计原则：只负责与Worker的通信和生命周期管理，不关心具体执行的算法
+ *
+ * 明确不负责：
+ * - 不执行具体的哈希计算
+ * - 不管理任务状态
+ * - 不处理算法逻辑
+ */
+export 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;
+    }
+}
+//# sourceMappingURL=BrowserWorkerHandle.js.map

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

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"BrowserWorkerPool.js","sourceRoot":"","sources":["../../../../../src/task/hash-task/worker/BrowserWorkerPool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD;;;;;;;;;;GAUG;AACH,MAAM,OAAO,iBAAkB,SAAQ,iBAAiB;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"}

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"}