@qimen-lab/core 0.1.1

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

@@ -0,0 +1,95 @@
+/**
+ * =========================
+ * 主线程 → Worker 通信协议
+ * hashWorkerProtocol 只解决一件事：
+ * 主线程 ↔ Worker 之间"能且只能"交换什么
+ * 我们要确保：
+ * ❌ 不 eval
+ * ❌ 不传函数
+ * ❌ 不暴露内部状态
+ * ✔ 可扩展（以后加算法、并行）
+ * =========================
+ */
+/**
+ * 初始化Worker的消息类型
+ * 用于向Worker传递哈希算法类型
+ */
+export type HashWorkerInitMessage = {
+    /** 消息类型：初始化 */
+    type: 'init';
+    /** 算法标识，例如 'sha-256' */
+    algorithm: string;
+};
+/**
+ * 更新哈希计算的消息类型
+ * 用于向Worker传递数据块进行哈希计算
+ */
+export type HashWorkerUpdateMessage = {
+    /** 消息类型：更新 */
+    type: 'update';
+    /** chunk 唯一标识（用于调试 / 并发） */
+    chunkId: string;
+    /** chunk 数据 */
+    data: ArrayBuffer;
+};
+/**
+ * 请求最终哈希结果的消息类型
+ * 用于通知Worker完成哈希计算并返回最终结果
+ */
+export type HashWorkerFinalMessage = {
+    /** 消息类型：完成 */
+    type: 'final';
+};
+/**
+ * 重置Worker状态的消息类型
+ * 用于重置Worker内部的哈希计算状态
+ */
+export type HashWorkerResetMessage = {
+    /** 消息类型：重置 */
+    type: 'reset';
+};
+/**
+ * 主线程向Worker发送的消息联合类型
+ */
+export type HashWorkerMessage = HashWorkerInitMessage | HashWorkerUpdateMessage | HashWorkerFinalMessage | HashWorkerResetMessage;
+/**
+ * =========================
+ * Worker → 主线程 通信协议
+ * =========================
+ */
+/**
+ * Worker确认消息类型
+ * 用于向主线程确认已处理某条消息
+ */
+export type HashWorkerAck = {
+    /** 消息类型：确认 */
+    type: 'ack';
+    /** 可选：回应哪个 chunk */
+    chunkId?: string;
+};
+/**
+ * Worker返回最终哈希结果的消息类型
+ */
+export type HashWorkerDigest = {
+    /** 消息类型：摘要 */
+    type: 'digest';
+    /** 最终 hash 结果 */
+    result: ArrayBuffer;
+};
+/**
+ * Worker错误消息类型
+ * 用于向主线程报告错误
+ */
+export type HashWorkerError = {
+    /** 消息类型：错误 */
+    type: 'error';
+    /** 错误代码 */
+    code: number | string;
+    /** 错误消息 */
+    message: string;
+};
+/**
+ * Worker向主线程发送的响应消息联合类型
+ */
+export type HashWorkerResponse = HashWorkerAck | HashWorkerDigest | HashWorkerError;
+//# sourceMappingURL=HashWorkerProtocol.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"HashWorkerProtocol.d.ts","sourceRoot":"","sources":["../../../../../src/task/hash-task/worker/HashWorkerProtocol.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AAEH;;;GAGG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAChC,eAAe;IACf,IAAI,EAAE,MAAM,CAAC;IACb,wBAAwB;IACxB,SAAS,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,uBAAuB,GAAG;IAClC,cAAc;IACd,IAAI,EAAE,QAAQ,CAAC;IACf,4BAA4B;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe;IACf,IAAI,EAAE,WAAW,CAAC;CACrB,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,sBAAsB,GAAG;IACjC,cAAc;IACd,IAAI,EAAE,OAAO,CAAC;CACjB,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,sBAAsB,GAAG;IACjC,cAAc;IACd,IAAI,EAAE,OAAO,CAAC;CACjB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,iBAAiB,GACvB,qBAAqB,GACrB,uBAAuB,GACvB,sBAAsB,GACtB,sBAAsB,CAAC;AAE7B;;;;GAIG;AAEH;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG;IACxB,cAAc;IACd,IAAI,EAAE,KAAK,CAAC;IACZ,oBAAoB;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC3B,cAAc;IACd,IAAI,EAAE,QAAQ,CAAC;IACf,iBAAiB;IACjB,MAAM,EAAE,WAAW,CAAC;CACvB,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG;IAC1B,cAAc;IACd,IAAI,EAAE,OAAO,CAAC;IACd,WAAW;IACX,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IACtB,WAAW;IACX,OAAO,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,aAAa,GAAG,gBAAgB,GAAG,eAAe,CAAC"}

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

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=HashWorkerProtocol.js.map

package/dist/task/hash-task/worker/HashWorkerProtocol.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.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Worker句柄接口
+ *
+ * 定义了Worker实例的统一接口，提供与Worker通信和管理的基本方法
+ * 设计原则：只负责Worker的通信和生命周期管理，不关心具体执行的算法
+ *
+ * 明确不负责：
+ * - 不实现具体的哈希算法
+ * - 不管理任务状态
+ * - 不处理进度跟踪
+ */
+export interface WorkerHandle {
+    /** Worker的唯一标识符 */
+    readonly id: string;
+    /**
+     * 向Worker发送消息
+     *
+     * @param message 要发送的消息内容
+     * @param transfer 可选的可转移对象数组，用于零拷贝传输
+     */
+    post<T = any>(message: T, transfer?: Transferable[]): void;
+    /**
+     * 注册消息监听，并返回一个取消监听的函数 (Unsubscribe pattern)
+     * 这种模式比手动 add/remove 更不容易出错
+     *
+     * @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=WorkerHandle.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"WorkerHandle.d.ts","sourceRoot":"","sources":["../../../../../src/task/hash-task/worker/WorkerHandle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,MAAM,WAAW,YAAY;IACzB,mBAAmB;IACnB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAEpB;;;;;OAKG;IACH,IAAI,CAAC,CAAC,GAAG,GAAG,EAAE,OAAO,EAAE,CAAC,EAAE,QAAQ,CAAC,EAAE,YAAY,EAAE,GAAG,IAAI,CAAC;IAE3D;;;;;;OAMG;IACH,SAAS,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IAEnD;;;;;OAKG;IACH,OAAO,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,KAAK,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IAEnD;;;;OAIG;IACH,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAE3B;;;;OAIG;IACH,OAAO,IAAI,OAAO,CAAC;CACtB"}

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

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=WorkerHandle.js.map

package/dist/task/hash-task/worker/WorkerHandle.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.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Worker池接口
+ *
+ * 定义了Worker池的基本操作接口，用于管理和复用Worker实例
+ * 设计原则：只负责Worker的获取、归还和销毁，不关心具体执行的任务
+ *
+ * 明确不负责：
+ * - 不执行具体的哈希计算
+ * - 不管理任务状态
+ * - 不处理算法逻辑
+ */
+import { WorkerHandle } from './WorkerHandle';
+export interface WorkerPool {
+    /**
+     * 获取一个可用的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=WorkerPool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"WorkerPool.d.ts","sourceRoot":"","sources":["../../../../../src/task/hash-task/worker/WorkerPool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C,MAAM,WAAW,UAAU;IACvB;;;;;;;;OAQG;IACH,OAAO,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAErD;;;;;;OAMG;IACH,OAAO,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAAC;IAEpC;;;;OAIG;IACH,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B"}

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

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=WorkerPool.js.map

package/dist/task/hash-task/worker/WorkerPool.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.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Worker脚本构建器
+ *
+ * 负责将算法函数转换为可在Worker中执行的源码字符串
+ * 设计原则：只负责脚本的构建，不关心算法的具体实现
+ *
+ * 明确不负责：
+ * - 不执行具体的哈希计算
+ * - 不管理Worker生命周期
+ * - 不处理通信协议
+ */
+export declare class WorkerScriptBuilder {
+    private readonly template;
+    /**
+     * 将算法转换成 Worker 可执行的源码
+     *
+     * @param algorithm 要构建的算法，可以是函数或字符串
+     * @returns 可在Worker中执行的源码字符串
+     */
+    build(algorithm: ((data: ArrayBuffer) => any) | string): string;
+    /**
+     * 获取内置算法的实现
+     *
+     * @param name 算法名称
+     * @returns 对应算法的函数字符串实现
+     * @private
+     */
+    private getBuiltInAlgorithm;
+}
+//# sourceMappingURL=WorkerScriptBuilder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"WorkerScriptBuilder.d.ts","sourceRoot":"","sources":["../../../../../src/task/hash-task/worker/WorkerScriptBuilder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,qBAAa,mBAAmB;IAE5B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAoBvB;IAEF;;;;;OAKG;IACH,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC,IAAI,EAAE,WAAW,KAAK,GAAG,CAAC,GAAG,MAAM,GAAG,MAAM;IAc/D;;;;;;OAMG;IACH,OAAO,CAAC,mBAAmB;CAO9B"}

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

@@ -0,0 +1,74 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WorkerScriptBuilder = void 0;
+/**
+ * Worker脚本构建器
+ *
+ * 负责将算法函数转换为可在Worker中执行的源码字符串
+ * 设计原则：只负责脚本的构建，不关心算法的具体实现
+ *
+ * 明确不负责：
+ * - 不执行具体的哈希计算
+ * - 不管理Worker生命周期
+ * - 不处理通信协议
+ */
+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;
+        }`;
+    }
+}
+exports.WorkerScriptBuilder = WorkerScriptBuilder;
+//# sourceMappingURL=WorkerScriptBuilder.js.map

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

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

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

@@ -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.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","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/hash-task/worker/index.js

@@ -0,0 +1,39 @@
+"use strict";
+/**
+ * Worker模块的公共API导出
+ *
+ * 该模块提供了一个用于处理哈希计算任务的Worker管理解决方案，
+ * 包括Worker句柄、Worker池、通信协议和脚本构建等功能。
+ *
+ * 核心组件：
+ * - WorkerHandle: Worker句柄接口及实现
+ * - WorkerPool: Worker池接口及实现
+ * - HashWorkerProtocol: Worker通信协议定义
+ * - WorkerScriptBuilder: Worker脚本构建器
+ * - HashWorker: Node.js环境下的哈希计算Worker
+ */
+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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./HashWorkerProtocol"), exports);
+__exportStar(require("./HashWorker"), exports);
+__exportStar(require("./WorkerPool"), exports);
+__exportStar(require("./WorkerHandle"), exports);
+__exportStar(require("./WorkerScriptBuilder"), exports);
+__exportStar(require("./DefaultWorkerHandle"), exports);
+__exportStar(require("./BrowserWorkerHandle"), exports);
+__exportStar(require("./DefaultWorkerPool"), exports);
+__exportStar(require("./BrowserWorkerPool"), exports);
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/task/hash-task/worker/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;GAYG;;;;;;;;;;;;;;;;AAEH,uDAAqC;AACrC,+CAA6B;AAC7B,+CAA6B;AAC7B,iDAA+B;AAC/B,wDAAsC;AACtC,wDAAsC;AACtC,wDAAsC;AACtC,sDAAoC;AACpC,sDAAoC"}

package/dist/task/index.d.ts

@@ -0,0 +1,4 @@
+export * from './task';
+export * from './worker';
+export * from './hash-task';
+//# sourceMappingURL=index.d.ts.map

package/dist/task/index.d.ts.map

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

package/dist/task/index.esm.js

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

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

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

package/dist/task/index.js

@@ -0,0 +1,20 @@
+"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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./task"), exports);
+__exportStar(require("./worker"), exports);
+__exportStar(require("./hash-task"), exports);
+//# sourceMappingURL=index.js.map

package/dist/task/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/task/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,yCAAuB;AACvB,2CAAyB;AACzB,8CAA4B"}

package/dist/task/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "@qimen-lab/task",
+  "version": "0.1.1",
+  "main": "index.js",
+  "module": "index.esm.js",
+  "types": "index.d.ts",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "import": "./index.esm.js",
+      "require": "./index.js",
+      "types": "./index.d.ts"
+    }
+  },
+  "dependencies": {
+    "@qimen-lab/logger": "0.1.1",
+    "@qimen-lab/utils": "0.1.1",
+    "@qimen-lab/error": "0.1.1",
+    "@qimen-lab/runtime": "0.1.1"
+  }
+}

package/dist/task/task/TaskQueue.d.ts

@@ -0,0 +1,97 @@
+import { TaskPriority } from './types';
+/**
+ * 全局任务队列 - 用于管理任务执行、优先级排序和重试的核心类
+ *
+ * 该类实现了单例模式，确保整个应用中只有一个任务队列实例。
+ * 支持任务优先级、重试机制和轮询任务。
+ *
+ * @example
+ * ```ts
+ * // 获取全局任务队列实例并添加一个普通任务
+ * globalTaskQueue.addTask(
+ *   async () => console.log('Task executed'),
+ *   'HIGH',
+ *   3, // 最大重试次数
+ *   1000 // 重试延迟
+ * );
+ *
+ * // 添加一个轮询任务
+ * globalTaskQueue.addTask(
+ *   async () => fetch('/api/data'),
+ *   'NORMAL',
+ *   5,
+ *   1000,
+ *   true, // 轮询
+ *   5000  // 轮询间隔
+ * );
+ * ```
+ */
+export declare class GlobalTaskQueue {
+    private taskQueue;
+    private maxConcurrentTasks;
+    private isRunning;
+    private static instance;
+    private logger;
+    /**
+     * 构造函数 - 创建任务队列实例
+     *
+     * @param maxConcurrentTasks - 最大并发任务数，默认为5
+     */
+    constructor(maxConcurrentTasks?: number);
+    /**
+     * 获取任务队列的单例实例
+     *
+     * @param maxConcurrentTasks - 可选参数，指定最大并发任务数
+     * @returns 返回任务队列的单例实例
+     */
+    static getInstance(maxConcurrentTasks?: number): GlobalTaskQueue;
+    /**
+     * 根据优先级对任务队列进行排序
+     *
+     * @returns 排序后的任务数组
+     * @private
+     */
+    private getSortedQueue;
+    /**
+     * 添加任务到队列
+     *
+     * @param fn - 要执行的任务函数，返回Promise
+     * @param priority - 任务优先级，默认为NORMAL
+     * @param maxRetries - 最大重试次数，默认为3
+     * @param delay - 重试延迟时间（毫秒），默认为1000
+     * @param isPolling - 是否为轮询任务，默认为false
+     * @param interval - 轮询间隔时间（毫秒），默认为5000
+     */
+    addTask(fn: () => Promise<unknown>, priority?: TaskPriority, maxRetries?: number, delay?: number, isPolling?: boolean, interval?: number): void;
+    /**
+     * 处理任务的重试逻辑
+     *
+     * @param task - 需要重试的任务
+     * @returns 如果任务将被重试则返回true，否则返回false
+     * @private
+     */
+    private handleTaskRetry;
+    /**
+     * 处理轮询任务的重试逻辑
+     *
+     * @param task - 需要轮询的任务
+     * @returns 如果任务将被重试则返回true，否则返回false
+     * @private
+     */
+    private handlePollingTask;
+    /**
+     * 执行任务
+     *
+     * @param task - 要执行的任务
+     * @private
+     */
+    private runTask;
+    /**
+     * 执行队列中的任务
+     *
+     * @private
+     */
+    private run;
+}
+export declare const globalTaskQueue: GlobalTaskQueue;
+//# sourceMappingURL=TaskQueue.d.ts.map

package/dist/task/task/TaskQueue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TaskQueue.d.ts","sourceRoot":"","sources":["../../../../src/task/task/TaskQueue.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,YAAY,EAAE,MAAM,SAAS,CAAC;AAI7C;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,qBAAa,eAAe;IACxB,OAAO,CAAC,SAAS,CAAc;IAC/B,OAAO,CAAC,kBAAkB,CAAS;IACnC,OAAO,CAAC,SAAS,CAAkB;IACnC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAgC;IACvD,OAAO,CAAC,MAAM,CAAU;IAExB;;;;OAIG;gBACS,kBAAkB,GAAE,MAAU;IAK1C;;;;;OAKG;WACW,WAAW,CAAC,kBAAkB,CAAC,EAAE,MAAM,GAAG,eAAe;IAOvE;;;;;OAKG;IACH,OAAO,CAAC,cAAc;IAStB;;;;;;;;;OASG;IACI,OAAO,CACV,EAAE,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,EAC1B,QAAQ,GAAE,YAAuB,EACjC,UAAU,GAAE,MAAU,EACtB,KAAK,GAAE,MAAa,EACpB,SAAS,GAAE,OAAe,EAC1B,QAAQ,GAAE,MAAa,GACxB,IAAI;IAgBP;;;;;;OAMG;YACW,eAAe;IAoB7B;;;;;;OAMG;YACW,iBAAiB;IAoB/B;;;;;OAKG;YACW,OAAO;IAkBrB;;;;OAIG;YACW,GAAG;CAgBpB;AAGD,eAAO,MAAM,eAAe,iBAAgC,CAAC"}