@taicode/common-base 3.1.0 → 3.1.1

package/output/events/event-emitter.test.js

@@ -0,0 +1,213 @@
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import { EventEmitter } from './event-emitter';
+describe('EventEmitter', () => {
+    let emitter;
+    beforeEach(() => {
+        emitter = new EventEmitter();
+    });
+    describe('on', () => {
+        it('应该能够订阅事件', () => {
+            const listener = vi.fn();
+            emitter.on('test', listener);
+            emitter.emit('test', 'hello');
+            expect(listener).toHaveBeenCalledOnce();
+            expect(listener).toHaveBeenCalledWith('hello');
+        });
+        it('应该能够订阅多个监听器', () => {
+            const listener1 = vi.fn();
+            const listener2 = vi.fn();
+            emitter.on('test', listener1);
+            emitter.on('test', listener2);
+            emitter.emit('test', 'hello');
+            expect(listener1).toHaveBeenCalledOnce();
+            expect(listener2).toHaveBeenCalledOnce();
+            expect(listener1).toHaveBeenCalledWith('hello');
+            expect(listener2).toHaveBeenCalledWith('hello');
+        });
+        it('应该返回取消订阅函数', () => {
+            const listener = vi.fn();
+            const off = emitter.on('test', listener);
+            emitter.emit('test', 'hello');
+            expect(listener).toHaveBeenCalledOnce();
+            off();
+            emitter.emit('test', 'world');
+            expect(listener).toHaveBeenCalledOnce();
+        });
+        it('应该支持不同类型的事件数据', () => {
+            const stringListener = vi.fn();
+            const numberListener = vi.fn();
+            const objectListener = vi.fn();
+            const voidListener = vi.fn();
+            emitter.on('test', stringListener);
+            emitter.on('number', numberListener);
+            emitter.on('object', objectListener);
+            emitter.on('noData', voidListener);
+            const testObject = { id: 1, name: 'test' };
+            emitter.emit('test', 'hello');
+            emitter.emit('number', 42);
+            emitter.emit('object', testObject);
+            emitter.emit('noData', undefined);
+            expect(stringListener).toHaveBeenCalledWith('hello');
+            expect(numberListener).toHaveBeenCalledWith(42);
+            expect(objectListener).toHaveBeenCalledWith(testObject);
+            expect(voidListener).toHaveBeenCalledWith(undefined);
+        });
+    });
+    describe('off', () => {
+        it('应该能够取消订阅特定监听器', () => {
+            const listener1 = vi.fn();
+            const listener2 = vi.fn();
+            emitter.on('test', listener1);
+            emitter.on('test', listener2);
+            emitter.off('test', listener1);
+            emitter.emit('test', 'hello');
+            expect(listener1).not.toHaveBeenCalled();
+            expect(listener2).toHaveBeenCalledOnce();
+        });
+        it('应该能够取消订阅所有监听器', () => {
+            const listener1 = vi.fn();
+            const listener2 = vi.fn();
+            emitter.on('test', listener1);
+            emitter.on('test', listener2);
+            emitter.off('test');
+            emitter.emit('test', 'hello');
+            expect(listener1).not.toHaveBeenCalled();
+            expect(listener2).not.toHaveBeenCalled();
+        });
+        it('应该忽略不存在的事件类型', () => {
+            expect(() => {
+                emitter.off('test');
+            }).not.toThrow();
+        });
+        it('应该忽略不存在的监听器', () => {
+            const listener = vi.fn();
+            const anotherListener = vi.fn();
+            emitter.on('test', listener);
+            expect(() => {
+                emitter.off('test', anotherListener);
+            }).not.toThrow();
+            emitter.emit('test', 'hello');
+            expect(listener).toHaveBeenCalledOnce();
+        });
+    });
+    describe('emit', () => {
+        it('应该能够触发事件', () => {
+            const listener = vi.fn();
+            emitter.on('test', listener);
+            emitter.emit('test', 'hello');
+            expect(listener).toHaveBeenCalledWith('hello');
+        });
+        it('应该不抛出错误当没有监听器时', () => {
+            expect(() => {
+                emitter.emit('test', 'hello');
+            }).not.toThrow();
+        });
+        it('应该按顺序调用监听器', () => {
+            const calls = [];
+            emitter.on('test', () => calls.push(1));
+            emitter.on('test', () => calls.push(2));
+            emitter.on('test', () => calls.push(3));
+            emitter.emit('test', 'hello');
+            expect(calls).toEqual([1, 2, 3]);
+        });
+        it('应该处理监听器中的错误', () => {
+            const workingListener = vi.fn();
+            const errorListener = vi.fn(() => {
+                throw new Error('Test error');
+            });
+            const anotherWorkingListener = vi.fn();
+            emitter.on('test', workingListener);
+            emitter.on('test', errorListener);
+            emitter.on('test', anotherWorkingListener);
+            expect(() => {
+                emitter.emit('test', 'hello');
+            }).toThrow('Test error');
+            expect(workingListener).toHaveBeenCalled();
+            expect(errorListener).toHaveBeenCalled();
+            // 由于错误，后续监听器可能不会被调用
+        });
+        it('应该防止监听器修改监听器列表时的遍历问题', () => {
+            const listener1 = vi.fn();
+            const listener2 = vi.fn(() => {
+                // 在回调中取消订阅
+                emitter.off('test', listener3);
+            });
+            const listener3 = vi.fn();
+            emitter.on('test', listener1);
+            emitter.on('test', listener2);
+            emitter.on('test', listener3);
+            emitter.emit('test', 'hello');
+            expect(listener1).toHaveBeenCalled();
+            expect(listener2).toHaveBeenCalled();
+            expect(listener3).toHaveBeenCalled(); // 应该仍然被调用，因为使用了 slice()
+        });
+    });
+    describe('once', () => {
+        it('应该只执行一次监听器', () => {
+            const listener = vi.fn();
+            emitter.once('test', listener);
+            emitter.emit('test', 'first');
+            emitter.emit('test', 'second');
+            expect(listener).toHaveBeenCalledOnce();
+            expect(listener).toHaveBeenCalledWith('first');
+        });
+        it('应该在执行后自动取消订阅', () => {
+            const listener = vi.fn();
+            emitter.once('test', listener);
+            emitter.emit('test', 'hello');
+            // 验证监听器已被移除
+            emitter.emit('test', 'world');
+            expect(listener).toHaveBeenCalledOnce();
+        });
+        it('应该与普通监听器一起工作', () => {
+            const onceListener = vi.fn();
+            const normalListener = vi.fn();
+            emitter.once('test', onceListener);
+            emitter.on('test', normalListener);
+            emitter.emit('test', 'first');
+            emitter.emit('test', 'second');
+            expect(onceListener).toHaveBeenCalledOnce();
+            expect(normalListener).toHaveBeenCalledTimes(2);
+        });
+    });
+    describe('cleanup', () => {
+        it('应该清空所有监听器', () => {
+            const listener1 = vi.fn();
+            const listener2 = vi.fn();
+            emitter.on('test', listener1);
+            emitter.on('number', listener2);
+            emitter.cleanup();
+            emitter.emit('test', 'hello');
+            emitter.emit('number', 42);
+            expect(listener1).not.toHaveBeenCalled();
+            expect(listener2).not.toHaveBeenCalled();
+        });
+        it('清理后应该能够重新添加监听器', () => {
+            const listener = vi.fn();
+            emitter.on('test', listener);
+            emitter.cleanup();
+            const newListener = vi.fn();
+            emitter.on('test', newListener);
+            emitter.emit('test', 'hello');
+            expect(listener).not.toHaveBeenCalled();
+            expect(newListener).toHaveBeenCalledWith('hello');
+        });
+    });
+    describe('方法绑定', () => {
+        it('方法应该绑定到实例', () => {
+            const { on, off, emit, once, cleanup } = emitter;
+            const listener = vi.fn();
+            on('test', listener);
+            emit('test', 'hello');
+            expect(listener).toHaveBeenCalledWith('hello');
+            off('test', listener);
+            emit('test', 'world');
+            expect(listener).toHaveBeenCalledOnce();
+            // 测试其他方法
+            once('test', listener);
+            emit('test', 'once');
+            expect(listener).toHaveBeenCalledTimes(2);
+            cleanup();
+        });
+    });
+});

package/output/events/index.d.ts

@@ -0,0 +1,3 @@
+export * from './event-emitter';
+export * from './disposer';
+//# sourceMappingURL=index.d.ts.map

package/output/events/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../source/events/index.ts"],"names":[],"mappings":"AACA,cAAc,iBAAiB,CAAA;AAC/B,cAAc,YAAY,CAAA"}

package/output/events/index.js

@@ -0,0 +1,3 @@
+// 事件系统相关功能
+export * from './event-emitter';
+export * from './disposer';

package/output/flow-queue/flow-queue.test.js

@@ -1,5 +1,6 @@
 import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
 import { FlowQueue } from './flow-queue.js';
+import { logger } from '../logger/index.js';
 describe('FlowQueue', () => {
     let flowQueue;
     let mockProcessor;
@@ -158,8 +159,8 @@ describe('FlowQueue', () => {
                 throw new Error('Callback error');
             });
             const normalCallback = vi.fn();
-            // Mock console.error 来验证错误被正确记录
-            const consoleErrorSpy = vi.spyOn(console, 'error').mockImplementation(() => { });
+            // Mock logger.error 来验证错误被正确记录
+            const loggerErrorSpy = vi.spyOn(logger, 'error').mockImplementation(() => { });
             mockProcessor = vi.fn().mockResolvedValue(expectedOutput);
             flowQueue = new FlowQueue({ retry: { maxRetries: 3 } }, mockProcessor);
             flowQueue.onGenerate(faultyCallback);
@@ -168,8 +169,8 @@ describe('FlowQueue', () => {
             await new Promise(resolve => setTimeout(resolve, 50));
             expect(faultyCallback).toHaveBeenCalled();
             expect(normalCallback).toHaveBeenCalledWith(expectedOutput);
-            expect(consoleErrorSpy).toHaveBeenCalledWith('Error in onGenerate callback:', expect.any(Error));
-            consoleErrorSpy.mockRestore();
+            expect(loggerErrorSpy).toHaveBeenCalledWith('Error in onGenerate callback:', expect.any(Error));
+            loggerErrorSpy.mockRestore();
         });
         it('失败的处理不应该触发回调', async () => {
             const testInput = { id: 1, data: 'test' };

package/output/ring-cache/ring-cache.test.js

@@ -77,9 +77,10 @@ describe('RingCache', () => {
             expect(results.map(e => e.data)).toEqual(['apple', 'apricot']);
         });
         it('应该支持时间范围搜索', () => {
-            const now = new Date();
-            const future = new Date(now.getTime() + 1000);
-            const results = cache.getByTimeRange(now, future);
+            const entries = cache.getAll();
+            const start = new Date(entries[0].timestamp.getTime() - 1);
+            const end = new Date(entries[entries.length - 1].timestamp.getTime() + 1);
+            const results = cache.getByTimeRange(start, end);
             expect(results.length).toBe(3);
         });
     });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@taicode/common-base",
-  "version": "3.1.0",
+  "version": "3.1.1",
   "author": "Alain",
   "license": "ISC",
   "description": "",
@@ -22,15 +22,15 @@
   },
   "scripts": {
     "test": "vitest run",
-    "build": "tsc -p tsconfig.json",
+    "build": "node ../../node_modules/typescript/bin/tsc -p tsconfig.json",
     "prepublishOnly": "npm run build",
-    "dev": "tsc -p tsconfig.json --watch"
+    "dev": "node ../../node_modules/typescript/bin/tsc -p tsconfig.json --watch"
   },
   "files": [
     "output"
   ],
   "devDependencies": {
     "vitest": "^3.2.4",
-    "mobx": "^6.0.0"
+    "mobx": "^6.15.0"
   }
 }

package/output/scheduler/index.d.ts

@@ -1,2 +0,0 @@
-export * from './scheduler';
-//# sourceMappingURL=index.d.ts.map

package/output/scheduler/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../source/scheduler/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA"}

package/output/scheduler/index.js

@@ -1 +0,0 @@
-export * from './scheduler';

package/output/scheduler/scheduler.d.ts

@@ -1,222 +0,0 @@
-import { EventEmitter } from '../event-emitter';
-import { type CatchResult } from '../catch';
-/**
- * 定时任务配置
- */
-export interface ScheduledTaskConfig {
-    /**
-     * 任务唯一标识
-     */
-    id: string;
-    /**
-     * 任务执行间隔（秒），必须是 10 的倍数
-     */
-    interval: number;
-    /**
-     * 任务处理函数
-     */
-    handler: () => Promise<void> | void;
-    /**
-     * 最大重试次数，默认 3
-     */
-    maxRetries?: number;
-    /**
-     * 重试间隔（毫秒），默认 1000
-     */
-    retryDelay?: number;
-    /**
-     * 是否在启动时立即执行一次，默认 false
-     */
-    immediate?: boolean;
-    /**
-     * 是否启用，默认 true
-     */
-    enabled?: boolean;
-}
-/**
- * 任务执行记录
- */
-export interface TaskExecution {
-    taskId: string;
-    startTime: number;
-    endTime?: number;
-    success: boolean;
-    error?: Error;
-    retryCount: number;
-}
-/**
- * 调度器事件
- */
-export interface SchedulerEvents {
-    'task:start': {
-        taskId: string;
-    };
-    'task:success': {
-        taskId: string;
-        duration: number;
-    };
-    'task:error': {
-        taskId: string;
-        error: Error;
-        retryCount: number;
-    };
-    'task:retry': {
-        taskId: string;
-        retryCount: number;
-        maxRetries: number;
-    };
-    'task:failed': {
-        taskId: string;
-        error: Error;
-    };
-    'scheduler:start': void;
-    'scheduler:stop': void;
-    'scheduler:tick': {
-        tick: number;
-    };
-}
-/**
- * 内部任务状态
- */
-interface TaskState {
-    config: Required<ScheduledTaskConfig>;
-    nextTick: number;
-    running: boolean;
-    retryCount: number;
-    lastError?: Error;
-    executions: TaskExecution[];
-}
-/**
- * 定时任务调度器
- *
- * 以 10 秒为基本时间单位，支持多个不同间隔的定时任务
- *
- * @example
- * ```ts
- * const scheduler = new Scheduler()
- *
- * // 添加每 30 秒执行一次的任务
- * scheduler.addTask({
- *   id: 'sync-data',
- *   interval: 30,
- *   handler: async () => {
- *     await syncDataToServer()
- *   },
- *   maxRetries: 3
- * })
- *
- * // 添加每 60 秒执行一次的任务
- * scheduler.addTask({
- *   id: 'cleanup',
- *   interval: 60,
- *   handler: async () => {
- *     await cleanupTempFiles()
- *   }
- * })
- *
- * // 启动调度器
- * scheduler.start()
- *
- * // 监听事件
- * scheduler.on('task:error', (taskId, error) => {
- *   console.error(`Task ${taskId} failed:`, error)
- * })
- *
- * // 停止调度器
- * scheduler.stop()
- * ```
- */
-export declare class Scheduler extends EventEmitter<SchedulerEvents> {
-    /**
-     * 基本时间单位（秒）
-     */
-    private static readonly TICK_INTERVAL;
-    /**
-     * 当前 tick 计数
-     */
-    private currentTick;
-    /**
-     * 定时器 ID
-     */
-    private timerId;
-    /**
-     * 是否正在运行
-     */
-    private running;
-    /**
-     * 任务状态映射
-     */
-    private tasks;
-    /**
-     * 添加定时任务
-     */
-    addTask(config: ScheduledTaskConfig): void;
-    /**
-     * 移除定时任务
-     */
-    removeTask(taskId: string): boolean;
-    /**
-     * 启用任务
-     */
-    enableTask(taskId: string): boolean;
-    /**
-     * 禁用任务
-     */
-    disableTask(taskId: string): boolean;
-    /**
-     * 获取任务状态
-     */
-    getTaskState(taskId: string): Readonly<TaskState> | undefined;
-    /**
-     * 获取所有任务 ID
-     */
-    getTaskIds(): string[];
-    /**
-     * 启动调度器
-     */
-    start(): void;
-    /**
-     * 停止调度器
-     */
-    stop(): void;
-    /**
-     * 是否正在运行
-     */
-    isRunning(): boolean;
-    /**
-     * 获取当前 tick
-     */
-    getCurrentTick(): number;
-    /**
-     * 手动触发任务执行（忽略时间间隔）
-     */
-    triggerTask(taskId: string): Promise<CatchResult<void, string>>;
-    /**
-     * 执行 tick
-     */
-    private tick;
-    /**
-     * 执行任务
-     */
-    private executeTask;
-    /**
-     * 获取任务执行历史
-     */
-    getTaskExecutions(taskId: string, limit?: number): TaskExecution[];
-    /**
-     * 获取调度器统计信息
-     */
-    getStats(): {
-        running: boolean;
-        currentTick: number;
-        totalTasks: number;
-        enabledTasks: number;
-        runningTasks: number;
-    };
-    /**
-     * 清理所有任务
-     */
-    clear(): void;
-}
-export {};
-//# sourceMappingURL=scheduler.d.ts.map

package/output/scheduler/scheduler.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"scheduler.d.ts","sourceRoot":"","sources":["../../source/scheduler/scheduler.ts"],"names":[],"mappings":"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"}