@qimen-lab/core 0.1.3 → 0.1.5

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

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

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

@@ -0,0 +1,129 @@
+/**
+ * HashTaskHealthMonitor类
+ *
+ * 该类只负责监控与判断：
+ * - 是否长时间无进展
+ * - Worker 是否假活着
+ * - 内存是否未释放
+ * - 是否触发 fail-fast
+ *
+ * 明确不负责：
+ * - 不直接取消任务
+ * - 不直接重试
+ * - 不处理UI
+ * - 不做日志聚合
+ *
+ * 它只发出"健康事件"。
+ *
+ * 设计原则：
+ * - 只负责监控和判断
+ * - 不直接干预任务执行
+ * - 通过事件机制通知外部
+ */
+export class HashTaskHealthMonitor {
+    /**
+     * 构造函数
+     *
+     * @param state 任务状态管理器
+     * @param progress 任务进度管理器
+     * @param resources 任务资源管理器
+     * @param options 健康监控选项
+     */
+    constructor(state, progress, resources, options = {}) {
+        var _a, _b;
+        this.state = state;
+        this.progress = progress;
+        this.resources = resources;
+        this.listeners = new Set();
+        this.lastProgressBytes = 0;
+        this.lastProgressTime = Date.now();
+        this.stallThresholdMs = (_a = options.stallThresholdMs) !== null && _a !== void 0 ? _a : 10000;
+        this.intervalMs = (_b = options.intervalMs) !== null && _b !== void 0 ? _b : 1000;
+    }
+    /**
+     * 开始健康监控
+     *
+     * 启动定时器，定期检查任务健康状态
+     *
+     * 检查包括：
+     * - 任务进度是否卡死
+     * - Worker是否无响应
+     * - 资源是否泄漏
+     */
+    start() {
+        if (this.timer)
+            return;
+        this.timer = setInterval(() => this.check(), this.intervalMs);
+    }
+    /**
+     * 停止健康监控
+     *
+     * 清除定时器，停止健康检查
+     */
+    stop() {
+        if (this.timer) {
+            clearInterval(this.timer);
+            this.timer = undefined;
+        }
+    }
+    /**
+     * 添加健康事件监听器
+     *
+     * @param listener 健康事件监听器
+     * @returns 用于移除监听器的函数
+     */
+    onEvent(listener) {
+        this.listeners.add(listener);
+        return () => this.listeners.delete(listener);
+    }
+    /**
+     * 触发健康事件
+     *
+     * @param event 健康事件
+     * @private
+     */
+    emit(event) {
+        this.listeners.forEach(fn => fn(event));
+    }
+    /**
+     * 执行健康检查
+     *
+     * 检查任务进度是否卡死、资源是否泄漏等情况
+     *
+     * 检查内容包括：
+     * 1. 进度卡死检测：检查任务是否在stallThresholdMs时间内无进展
+     * 2. 资源泄漏检测：检查任务结束后资源是否被正确释放
+     *
+     * @private
+     */
+    check() {
+        const now = Date.now();
+        const stateValue = this.state.value;
+        const progressSnap = this.progress.snapshot();
+        const resourceSnap = this.resources.snapshot();
+        // ===== 1. 检测进度卡死 =====
+        if (stateValue === 'running') {
+            if (progressSnap.processedBytes !== this.lastProgressBytes) {
+                this.lastProgressBytes = progressSnap.processedBytes;
+                this.lastProgressTime = now;
+            }
+            else {
+                const stalledFor = now - this.lastProgressTime;
+                if (stalledFor > this.stallThresholdMs) {
+                    this.emit({ type: 'stalled', durationMs: stalledFor });
+                    if (resourceSnap.hasWorker) {
+                        this.emit({ type: 'worker_unresponsive' });
+                    }
+                    // 防止重复刷事件
+                    this.lastProgressTime = now;
+                }
+            }
+        }
+        // ===== 2. 检测资源泄漏 =====
+        if ((stateValue === 'completed' || stateValue === 'failed' || stateValue === 'cancelled') &&
+            resourceSnap.hasWorker) {
+            this.emit({ type: 'resource_leak' });
+        }
+    }
+}
+//# sourceMappingURL=HashTaskHealthMonitor.js.map

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

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

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

@@ -0,0 +1,58 @@
+/**
+ * 哈希任务进度管理类
+ *
+ * 负责跟踪和管理哈希任务的执行进度
+ *
+ * 设计原则：
+ * - 仅负责进度跟踪和快照生成
+ * - 不关心数据块的来源
+ * - 不关心哈希算法的实现
+ * - 不管理Worker或任务状态
+ */
+export class HashTaskProgress {
+    constructor() {
+        this.processedBytes = 0;
+        this.processedChunks = 0;
+    }
+    /**
+     * 初始化进度（可选总量）
+     *
+     * @param totalBytes 总字节数，可选参数
+     */
+    init(totalBytes) {
+        this.totalBytes = totalBytes;
+        this.processedBytes = 0;
+        this.processedChunks = 0;
+    }
+    /**
+     * 处理数据块，更新进度
+     *
+     * 该方法会更新已处理的块数和字节数
+     *
+     * @param chunk 要处理的数据块，包含字节数信息
+     */
+    onChunk(chunk) {
+        this.processedChunks += 1;
+        this.processedBytes += chunk.data.byteLength;
+    }
+    /**
+     * 生成只读快照
+     *
+     * 计算当前进度百分比并返回进度快照
+     *
+     * @returns 任务进度快照
+     */
+    snapshot() {
+        // ✅ 符合原则：在生成快照时计算百分比（0~1）
+        const progress = this.totalBytes !== undefined && this.totalBytes > 0
+            ? Math.min(this.processedBytes / this.totalBytes, 1)
+            : undefined;
+        return {
+            progress,
+            processedBytes: this.processedBytes,
+            totalBytes: this.totalBytes,
+            processedChunks: this.processedChunks,
+        };
+    }
+}
+//# sourceMappingURL=HashTaskProgress.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"HashTaskProgress.js","sourceRoot":"","sources":["../../../../../src/task/hash-task/hash/HashTaskProgress.ts"],"names":[],"mappings":"AAmCA;;;;;;;;;;GAUG;AACH,MAAM,OAAO,gBAAgB;IAA7B;QACY,mBAAc,GAAG,CAAC,CAAC;QACnB,oBAAe,GAAG,CAAC,CAAC;IA+ChC,CAAC;IA5CG;;;;OAIG;IACH,IAAI,CAAC,UAAmB;QACpB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,cAAc,GAAG,CAAC,CAAC;QACxB,IAAI,CAAC,eAAe,GAAG,CAAC,CAAC;IAC7B,CAAC;IAED;;;;;;OAMG;IACH,OAAO,CAAC,KAAuC;QAC3C,IAAI,CAAC,eAAe,IAAI,CAAC,CAAC;QAC1B,IAAI,CAAC,cAAc,IAAI,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC;IACjD,CAAC;IAED;;;;;;OAMG;IACH,QAAQ;QACJ,0BAA0B;QAC1B,MAAM,QAAQ,GACV,IAAI,CAAC,UAAU,KAAK,SAAS,IAAI,IAAI,CAAC,UAAU,GAAG,CAAC;YAChD,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;YACpD,CAAC,CAAC,SAAS,CAAC;QAEpB,OAAO;YACH,QAAQ;YACR,cAAc,EAAE,IAAI,CAAC,cAAc;YACnC,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,eAAe,EAAE,IAAI,CAAC,eAAe;SACxC,CAAC;IACN,CAAC;CACJ"}

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

@@ -0,0 +1,158 @@
+import { ResourceUnavailableError } from '../errors';
+import { ResourceNotAcquiredError } from '../errors/ResourceNotAcquiredError';
+/**
+ * 哈希任务资源管理类
+ *
+ * 负责管理哈希任务所需的资源，包括内存和Worker。
+ * 这是一个资源管理器，用于在执行哈希任务时获取和释放必要的计算资源。
+ * 设计原则是单一职责，只负责资源的申请和释放，不涉及具体的哈希计算逻辑。
+ *
+ * 设计原则：
+ * - 仅负责资源的申请与释放
+ * - 不涉及具体哈希计算逻辑
+ * - 保证资源操作的原子性
+ * - 提供资源状态快照
+ */
+export class HashTaskResources {
+    /**
+     * 构造函数
+     *
+     * @param memoryManager 内存管理器，用于申请和释放内存资源
+     * @param workerPool Worker池，用于获取和归还Worker线程
+     */
+    constructor(memoryManager, workerPool) {
+        this.memoryManager = memoryManager;
+        this.workerPool = workerPool;
+        this.acquired = false; // 标记资源是否已成功获取
+    }
+    /**
+     * 核心：申请计算所需的资源（内存 + 线程）
+     *
+     * 此方法用于为哈希任务申请必要的计算资源。如果资源已经获取，则直接返回。
+     * 方法具有原子性，要么成功获取所有资源，要么在失败时释放已获取的资源。
+     *
+     * @param scriptSource 经过 Builder 转换后的算法源码字符串，将被注入到Worker中
+     * @param memoryBytes 需要锁定的内存预算，以字节为单位
+     * @returns 当资源成功获取后解析的Promise
+     * @throws 当资源申请失败时，会抛出相应的错误，并确保已申请的资源被释放
+     */
+    async acquire(scriptSource, memoryBytes) {
+        if (this.acquired)
+            return; // 防止重复获取资源
+        try {
+            // 按顺序获取内存和Worker资源
+            await this.acquireMemory(memoryBytes);
+            await this.acquireWorker(scriptSource);
+            this.acquired = true; // 标记资源已获取
+        }
+        catch (err) {
+            // 如果获取过程中出现错误，释放已获取的资源
+            await this.release();
+            throw err; // 重新抛出原始错误
+        }
+    }
+    /**
+     * 专用方法：获取内存资源
+     *
+     * 尝试从内存管理器获取指定数量的字节，如果失败则抛出内存资源不可用错误
+     *
+     * @param memoryBytes 需要获取的内存字节数
+     * @throws ResourceUnavailableError 如果内存不足或获取失败
+     */
+    async acquireMemory(memoryBytes) {
+        try {
+            this.memoryTicket = await this.memoryManager.acquire(memoryBytes);
+        }
+        catch (err) {
+            throw new ResourceUnavailableError('memory', {
+                requestedBytes: memoryBytes,
+                originalError: err instanceof Error ? err.message : err,
+            });
+        }
+    }
+    /**
+     * 专用方法：获取Worker资源
+     *
+     * 尝试从Worker池获取一个Worker实例，如果失败则抛出Worker资源不可用错误
+     *
+     * @param scriptSource 要注入到Worker中的脚本源码
+     * @throws ResourceUnavailableError 如果Worker池已满或获取失败
+     */
+    async acquireWorker(scriptSource) {
+        try {
+            this.worker = await this.workerPool.acquire(scriptSource);
+        }
+        catch (err) {
+            throw new ResourceUnavailableError('worker', {
+                originalError: err instanceof Error ? err.message : err,
+            });
+        }
+    }
+    /**
+     * 释放所有资源（幂等）
+     *
+     * 释放之前通过acquire方法获取的所有资源。此方法是幂等的，
+     * 即可以安全地多次调用而不会产生副作用。
+     * 无论资源是否已经被释放，或者从未被获取，调用此方法都是安全的。
+     *
+     * @returns 当资源成功释放后解析的Promise
+     */
+    async release() {
+        // 释放Worker资源（如果已获取）
+        if (this.worker) {
+            try {
+                this.workerPool.release(this.worker);
+            }
+            catch (error) {
+                // 即使释放worker失败，也要继续释放其他资源
+                console.error('Failed to release worker:', error);
+            }
+            this.worker = undefined;
+        }
+        // 释放内存资源（如果已获取）
+        if (this.memoryTicket) {
+            try {
+                this.memoryTicket.release();
+            }
+            catch (error) {
+                // 即使释放内存失败，也要继续执行
+                console.error('Failed to release memory ticket:', error);
+            }
+            this.memoryTicket = undefined;
+        }
+        // 重置获取状态
+        this.acquired = false;
+    }
+    /**
+     * 访问 worker（只允许 Runner 用）
+     *
+     * 获取当前持有的Worker句柄，供Runner使用来执行实际的哈希计算。
+     * 如果尚未获取Worker或Worker已被释放，则抛出错误。
+     *
+     * @returns Worker句柄，可用于向Worker发送消息和接收结果
+     * @throws 如果Worker尚未获取则抛出错误，确保使用者意识到资源未就绪
+     */
+    getWorker() {
+        if (!this.worker) {
+            throw new ResourceNotAcquiredError();
+        }
+        return this.worker;
+    }
+    /**
+     * 当前资源快照（给 health / debug）
+     *
+     * 获取当前资源使用情况的快照，主要用于健康检查和调试目的。
+     * 返回一个不可变的对象，包含当前内存使用量和Worker状态。
+     *
+     * @returns 资源快照对象，包含内存字节数（如果有）和Worker存在状态
+     */
+    snapshot() {
+        var _a;
+        return {
+            // ✅ 修正：如果有内存票据，返回具体的字节数
+            memoryBytes: (_a = this.memoryTicket) === null || _a === void 0 ? void 0 : _a.bytes,
+            hasWorker: !!this.worker, // 确保返回布尔值
+        };
+    }
+}
+//# sourceMappingURL=HashTaskResources.js.map

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

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

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

@@ -0,0 +1,234 @@
+import { Logger } from '../../../logger/index.esm.js';
+import { WorkerScriptBuilder } from '../worker';
+import { HashTaskHealthMonitor } from './HashTaskHealthMonitor';
+/**
+ * HashTaskRunner类
+ *
+ * 该类只负责流程控制：
+ * - 驱动任务生命周期
+ * - 串联 State / Progress / Resources
+ * - 把「计算」委托给 worker
+ * - 处理中断（pause / cancel）
+ *
+ * 明确不负责：
+ * - 不分块（ChunkProvider 的事）
+ * - 不实现 hash 算法
+ * - 不处理内存细节
+ * - 不做健康监控
+ * - 不做任务调度
+ */
+export class HashTaskRunner {
+    /**
+     * 构造函数
+     *
+     * @param state 任务状态管理器
+     * @param progress 任务进度管理器
+     * @param resources 任务资源管理器
+     * @param options 哈希任务选项
+     */
+    constructor(state, progress, resources, options) {
+        this.state = state;
+        this.progress = progress;
+        this.resources = resources;
+        this.options = options;
+        this.builder = new WorkerScriptBuilder();
+        this.logger = Logger.for('HashTaskRunner');
+    }
+    /**
+     * 获取ChunkProvider的辅助属性，让代码更易读
+     */
+    get chunkProvider() {
+        return this.options.chunkProvider;
+    }
+    /**
+     * 执行哈希任务
+     *
+     * 该方法负责：
+     * 1. 构建Worker脚本
+     * 2. 计算所需内存
+     * 3. 获取资源（内存和Worker）
+     * 4. 启动健康监控
+     * 5. 执行哈希计算
+     * 6. 最终释放资源
+     *
+     * @returns Promise<ArrayBuffer> 包含哈希结果的Promise
+     */
+    async run() {
+        this.logger.debug(`Starting hash task with algorithm: ${this.options.algorithm}`);
+        const scriptSource = this.builder.build(this.options.algorithm);
+        // 使用新定义的辅助属性计算内存
+        const memoryRequired = this.calculateRequiredMemory();
+        this.logger.debug(`Acquiring resources: memory=${(memoryRequired / 1024 / 1024).toFixed(2)}MB`);
+        await this.resources.acquire(scriptSource, memoryRequired);
+        const monitor = new HashTaskHealthMonitor(this.state, this.progress, this.resources);
+        monitor.start();
+        try {
+            // 注意：此时 State 的迁移需要符合你上传的 HashTaskState.ts 逻辑
+            if (this.state.canStart()) {
+                this.state.start();
+            }
+            return await this.executeHashing();
+        }
+        catch (err) {
+            // 如果 state 有 fail 方法，在这里调用
+            // this.state.fail(err);
+            this.logger.error('Task failed:', err);
+            throw err;
+        }
+        finally {
+            this.logger.debug('Releasing resources and stopping monitor.');
+            monitor.stop();
+            await this.resources.release();
+        }
+    }
+    /**
+     * 暂停任务：通过状态机实现
+     *
+     * 检查当前状态是否允许暂停，如果允许则更新状态为暂停
+     */
+    pause() {
+        if (this.state.canPause()) {
+            this.state.pause();
+        }
+    }
+    /**
+     * 恢复任务：通过状态机实现
+     *
+     * 检查当前状态是否允许恢复，如果允许则更新状态为运行中
+     */
+    resume() {
+        if (this.state.canResume()) {
+            this.state.resume();
+        }
+    }
+    /**
+     * 取消任务：直接调用状态机的 cancel
+     * 状态变更为 'cancelled' 后，executeHashing 循环中的 isCancelled() 会检测到并抛出异常
+     *
+     * 检查当前状态是否允许取消，如果允许则更新状态为已取消
+     */
+    cancel() {
+        if (this.state.canCancel()) {
+            this.state.cancel();
+        }
+    }
+    /**
+     * 等待任务恢复（如果处于暂停状态）
+     *
+     * 当任务处于暂停状态时，持续等待直到恢复运行或被取消
+     *
+     * @private
+     */
+    async waitIfPaused() {
+        // ✅ 统一使用 state 判定，不再需要私有变量
+        while (this.state.value === 'paused' && !this.state.isCancelled()) {
+            await new Promise(resolve => setTimeout(resolve, 200));
+        }
+    }
+    /**
+     * 运行单个数据块的哈希计算
+     *
+     * 该方法向Worker发送数据块进行哈希计算，并等待处理结果
+     *
+     * @param worker Worker句柄
+     * @param chunk 要处理的数据块
+     * @returns Promise<void> 表示处理完成的Promise
+     * @private
+     */
+    async runChunk(worker, chunk) {
+        return new Promise((resolve, reject) => {
+            let unsubscribe;
+            // 1. 定义处理器
+            const handler = (msg) => {
+                // 只响应当前 chunk 的确认消息
+                if (msg.type === 'ack' && msg.chunkId === chunk.id) {
+                    if (unsubscribe)
+                        unsubscribe(); // ✨ 执行清理！
+                    resolve();
+                }
+                else if (msg.type === 'error') {
+                    if (unsubscribe)
+                        unsubscribe(); // ✨ 出错也要清理！
+                    reject(new Error(msg.message));
+                }
+            };
+            // 2. 订阅消息
+            unsubscribe = worker.onMessage(handler);
+            // 3. 发送数据
+            worker.post({ type: 'update', chunkId: chunk.id, data: chunk.data }, [chunk.data] // 零拷贝转移
+            );
+        });
+    }
+    /**
+     * 完成哈希计算并获取最终结果
+     *
+     * 该方法向Worker发送完成信号并等待最终的哈希结果
+     *
+     * @param worker Worker句柄
+     * @returns Promise<ArrayBuffer> 包含最终哈希结果的Promise
+     * @private
+     */
+    async finalize(worker) {
+        return new Promise((resolve, reject) => {
+            let unsubscribe;
+            const onMessage = (msg) => {
+                if (msg.type === 'digest') {
+                    if (unsubscribe)
+                        unsubscribe(); // ✨ 清理
+                    resolve(msg.result);
+                }
+            };
+            unsubscribe = worker.onMessage(onMessage);
+            worker.post({ type: 'final' });
+        });
+    }
+    /**
+     * 计算所需内存大小
+     *
+     * 根据数据块大小计算所需的内存，预留额外空间用于处理
+     *
+     * @returns 所需的内存大小（以字节为单位）
+     * @private
+     */
+    calculateRequiredMemory() {
+        // 所有的 Provider 现在都有这个方法了
+        const chunkSize = this.chunkProvider.getChunkSize();
+        // 预留 2 个分片 + 1MB 冗余
+        return chunkSize * 2 + 1024 * 1024;
+    }
+    /**
+     * 执行哈希计算的主要逻辑
+     *
+     * 主循环：获取数据块 -> 检查暂停/取消 -> 执行哈希 -> 更新进度 -> 继续下一块
+     *
+     * @returns Promise<ArrayBuffer> 包含最终哈希结果的Promise
+     * @private
+     */
+    async executeHashing() {
+        const worker = this.resources.getWorker();
+        const provider = this.chunkProvider;
+        while (provider.hasNext()) {
+            // 1. 检查暂停
+            await this.waitIfPaused();
+            // 2. 检查取消
+            if (this.state.isCancelled()) {
+                throw new Error('Task cancelled');
+            }
+            const chunk = await provider.next();
+            if (!chunk)
+                break;
+            // 3. 执行哈希
+            await this.runChunk(worker, chunk);
+            // 4. 更新进度
+            this.progress.onChunk(chunk);
+        }
+        const result = await this.finalize(worker);
+        // ✨ 完成后同步状态机
+        if (this.state.canPause()) {
+            // 此时状态通常是 running
+            this.state.complete();
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=HashTaskRunner.js.map

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

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