@taicode/common-server 1.0.11 → 1.0.13

package/output/redis-queue/batch-redis-queue.d.ts

@@ -1,136 +0,0 @@
-import type { BatchTaskQueueConfig, TaskData, Task, QueueStats } from './types';
-/**
- * 批量任务队列类（泛型）
- *
- * 提供基于 Redis 的批量任务队列功能，支持：
- * - 批量处理任务（每次处理多条）
- * - 任务入队和持久化
- * - 自动重试机制
- * - 任务状态追踪
- * - 分布式消费
- *
- * @template T 任务数据类型
- *
- * @example
- * ```ts
- * interface EmailTask {
- *   to: string
- * }
- *
- * const queue = new BatchRedisQueue<EmailTask>({
- *   redisUrl: 'redis://localhost:6379',
- *   queueKey: 'email-batch-queue',
- *   batchSize: 50,
- *   handler: async (dataList) => {
- *     await sendEmailsBatch(dataList.map(d => d.to))
- *     return catchIt(() => {})
- *   }
- * })
- *
- * // 连接 Redis（自动启动消费者）
- * await queue.connect()
- *
- * // 入队任务（自动开始处理）
- * await queue.enqueue([
- *   { to: 'user1@example.com' },
- *   { to: 'user2@example.com' },
- * ])
- *
- * // 获取队列统计信息（O(1) 时间复杂度）
- * const stats = await queue.statistics()
- * console.log(stats) // { pending: 100, processing: 50, completed: 200, failed: 5 }
- * ```
- */
-export declare class BatchRedisQueue<T extends TaskData = TaskData> {
-    private consumerRunning;
-    private redis;
-    private consumerInterval;
-    private recoveryInterval;
-    private processingBatches;
-    private readonly config;
-    private readonly handler;
-    private readonly failedQueue;
-    private readonly pendingQueue;
-    private readonly processingQueue;
-    private readonly completedQueue;
-    constructor(config: BatchTaskQueueConfig<T>);
-    /**
-     * 连接 Redis 并自动启动消费者
-     */
-    connect(): Promise<void>;
-    /**
-     * 断开 Redis 连接并停止消费者
-     */
-    disconnect(): void;
-    /**
-     * 将任务推入队列(支持单个或批量)
-     * @param data 任务数据(单个或数组)。可以在 data 中包含 `id` 字段来实现幂等性
-     *
-     * @example
-     * // 普通任务,自动生成 ID
-     * await queue.enqueue({ to: 'user@example.com' })
-     *
-     * // 幂等任务,手动指定 ID,重复提交会被忽略
-     * await queue.enqueue({ id: 'email-123', to: 'user@example.com' })
-     * await queue.enqueue({ id: 'email-123', to: 'user@example.com' }) // 会被跳过
-     */
-    enqueue(data: T[]): Promise<string[]>;
-    enqueue(data: T): Promise<string>;
-    /**
-     * 获取任务详情
-     */
-    getTask(taskId: string): Promise<Task<T> | null>;
-    /**
-     * 更新任务状态并移动到对应队列（原子操作）
-     */
-    private applyStatus;
-    /**
-     * 批量更新任务状态
-     */
-    private applyStatusBatch;
-    /**
-     * 根据状态获取对应的队列键
-     */
-    private getQueueByStatus;
-    /**
-     * 恢复超时的任务
-     * 检查 processing 队列中的任务，将超时的任务重试或标记为失败
-     */
-    private recoverStalledTasks;
-    /**
-     * 批量处理任务
-     */
-    private processBatch;
-    /**
-     * 启动恢复机制（内部方法，自动调用）
-     */
-    private startRecovery;
-    /**
-     * 停止恢复机制（内部方法，自动调用）
-     */
-    private stopRecovery;
-    /**
-     * 启动消费者（内部方法，自动调用）
-     */
-    private startConsumer;
-    /**
-     * 停止消费者（内部方法，自动调用）
-     */
-    private stopConsumer;
-    /**
-     * 获取队列统计信息
-     * 返回队列中各种状态任务的详细数量
-     *
-     * 使用分离队列设计，O(1) 时间复杂度
-     */
-    statistics(): Promise<QueueStats>;
-    /**
-     * 清空所有队列
-     */
-    clear(): Promise<void>;
-    /**
-     * 健康检查
-     */
-    health(): Promise<boolean>;
-}
-//# sourceMappingURL=batch-redis-queue.d.ts.map

package/output/redis-queue/batch-redis-queue.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"batch-redis-queue.d.ts","sourceRoot":"","sources":["../../source/redis-queue/batch-redis-queue.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,oBAAoB,EAAU,QAAQ,EAAE,IAAI,EAAoB,UAAU,EAAE,MAAM,SAAS,CAAA;AAEzG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,qBAAa,eAAe,CAAC,CAAC,SAAS,QAAQ,GAAG,QAAQ;IACxD,OAAO,CAAC,eAAe,CAAQ;IAC/B,OAAO,CAAC,KAAK,CAA+B;IAC5C,OAAO,CAAC,gBAAgB,CAA8B;IACtD,OAAO,CAAC,gBAAgB,CAA8B;IACtD,OAAO,CAAC,iBAAiB,CAAI;IAE7B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoD;IAC3E,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;IAG7C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAQ;IACpC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAQ;IACrC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAQ;IACxC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAQ;gBAE3B,MAAM,EAAE,oBAAoB,CAAC,CAAC,CAAC;IA0C3C;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAY9B;;OAEG;IACH,UAAU,IAAI,IAAI;IAUlB;;;;;;;;;;;OAWG;IACG,OAAO,CAAC,IAAI,EAAE,CAAC,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IACrC,OAAO,CAAC,IAAI,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;IAkEvC;;OAEG;IACG,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAWtD;;OAEG;YACW,WAAW;IA8BzB;;OAEG;YACW,gBAAgB;IAI9B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAUxB;;;OAGG;YACW,mBAAmB;IA6EjC;;OAEG;YACW,YAAY;IA8F1B;;OAEG;IACH,OAAO,CAAC,aAAa;IAoBrB;;OAEG;IACH,OAAO,CAAC,YAAY;IAQpB;;OAEG;IACH,OAAO,CAAC,aAAa;IA2ErB;;OAEG;IACH,OAAO,CAAC,YAAY;IASpB;;;;;OAKG;IACG,UAAU,IAAI,OAAO,CAAC,UAAU,CAAC;IA0BvC;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAkB5B;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC;CAMjC"}