@taicode/common-base 1.6.3 → 1.7.1

package/output/logger/logger.js

@@ -1,12 +1,12 @@
 // 基础 Logger 实现，支持简单的日志输出和扩展能力
 import { defaultLogFormatter } from './formatter';
 export class Logger {
-    level;
+    _level;
     transports;
     formatter;
     print;
     constructor(options = {}) {
-        this.level = options.level || 'info';
+        this._level = options.level || 'info';
         this.formatter = options.formatter || defaultLogFormatter;
         this.transports = options.transports || [];
         this.print = options.print;
@@ -17,12 +17,32 @@ export class Logger {
     }
     defaultPrint(level, ...args) {
         const prefix = `[${level.toUpperCase()}]`;
+        // 映射 pino 兼容的 level 到 console 方法
+        let consoleMethod;
+        switch (level) {
+            case 'trace':
+            case 'debug':
+                consoleMethod = console.debug || console.log;
+                break;
+            case 'info':
+                consoleMethod = console.info || console.log;
+                break;
+            case 'warn':
+                consoleMethod = console.warn || console.log;
+                break;
+            case 'error':
+            case 'fatal':
+                consoleMethod = console.error || console.log;
+                break;
+            default:
+                consoleMethod = console.log;
+        }
         // eslint-disable-next-line no-console
-        (console[level] || console.log)(prefix, ...args);
+        consoleMethod(prefix, ...args);
     }
     shouldLog(level) {
-        const order = ['debug', 'info', 'warn', 'error'];
-        return order.indexOf(level) >= order.indexOf(this.level);
+        const order = ['trace', 'debug', 'info', 'warn', 'error', 'fatal'];
+        return order.indexOf(level) >= order.indexOf(this._level);
     }
     /**
      * 记录日志到所有 transports
@@ -63,6 +83,12 @@ export class Logger {
         const formattedArgs = this.formatter.formatArguments(args);
         this.print(level, ...formattedArgs);
     }
+    trace(...args) {
+        if (this.shouldLog('trace')) {
+            this.logToTransports('trace', args);
+            this.logToPrint('trace', args);
+        }
+    }
     debug(...args) {
         if (this.shouldLog('debug')) {
             this.logToTransports('debug', args);
@@ -87,6 +113,15 @@ export class Logger {
             this.logToPrint('error', args);
         }
     }
+    fatal(...args) {
+        if (this.shouldLog('fatal')) {
+            this.logToTransports('fatal', args);
+            this.logToPrint('fatal', args);
+        }
+    }
+    silent() {
+        // Pino 兼容的 silent 方法 - 无操作
+    }
     /**
      * 添加 LogTransport
      */
@@ -114,5 +149,32 @@ export class Logger {
             .filter(Boolean);
         await Promise.all(closePromises);
     }
+    /**
+     * Pino 兼容的 child 方法
+     * 创建一个共享配置的子 logger
+     */
+    child(bindings, options) {
+        // 合并选项，子 logger 继承父 logger 的配置
+        const childOptions = {
+            level: options?.level || this._level,
+            transports: options?.transports || this.transports,
+            formatter: options?.formatter || this.formatter,
+            print: options?.print || this.print
+        };
+        const childLogger = new Logger(childOptions);
+        // 如果提供了 bindings，我们可以在这里处理
+        // 目前的实现中，bindings 主要用于标识，不直接影响日志输出
+        // 在更完整的实现中，这些 bindings 会被添加到每个日志条目中
+        return childLogger;
+    }
+    /**
+     * Pino 兼容的 level getter/setter
+     */
+    get level() {
+        return this._level;
+    }
+    set level(newLevel) {
+        this._level = newLevel;
+    }
 }
 export const logger = new Logger();

package/output/logger/logger.test.js

@@ -7,24 +7,52 @@ describe('Logger', () => {
     it('应该默认记录 info 及以上级别', () => {
         const print = vi.fn();
         const logger = new Logger({ print });
+        logger.trace('trace');
         logger.debug('debug');
         logger.info('info');
         logger.warn('warn');
         logger.error('error');
+        logger.fatal('fatal');
+        expect(print).not.toHaveBeenCalledWith('trace', 'trace');
         expect(print).not.toHaveBeenCalledWith('debug', 'debug');
         expect(print).toHaveBeenCalledWith('info', 'info');
         expect(print).toHaveBeenCalledWith('warn', 'warn');
         expect(print).toHaveBeenCalledWith('error', 'error');
+        expect(print).toHaveBeenCalledWith('fatal', 'fatal');
     });
     it('应该遵守日志级别', () => {
         const print = vi.fn();
         const logger = new Logger({ level: 'warn', print });
+        logger.trace('trace');
+        logger.debug('debug');
         logger.info('info');
         logger.warn('warn');
         logger.error('error');
+        logger.fatal('fatal');
+        expect(print).not.toHaveBeenCalledWith('trace', 'trace');
+        expect(print).not.toHaveBeenCalledWith('debug', 'debug');
         expect(print).not.toHaveBeenCalledWith('info', 'info');
         expect(print).toHaveBeenCalledWith('warn', 'warn');
         expect(print).toHaveBeenCalledWith('error', 'error');
+        expect(print).toHaveBeenCalledWith('fatal', 'fatal');
+    });
+    it('应该支持 trace 级别日志', () => {
+        const print = vi.fn();
+        const logger = new Logger({ level: 'trace', print });
+        logger.trace('trace message');
+        expect(print).toHaveBeenCalledWith('trace', 'trace message');
+    });
+    it('应该支持 fatal 级别日志', () => {
+        const print = vi.fn();
+        const logger = new Logger({ level: 'fatal', print });
+        logger.fatal('fatal error');
+        expect(print).toHaveBeenCalledWith('fatal', 'fatal error');
+    });
+    it('silent 方法应该是无操作函数', () => {
+        const print = vi.fn();
+        const logger = new Logger({ print });
+        logger.silent();
+        expect(print).not.toHaveBeenCalled();
     });
     it('应该允许自定义处理器', () => {
         const logs = [];
@@ -217,3 +245,65 @@ describe('向后兼容性测试', () => {
         expect(records[0].args).toEqual(['测试向后兼容性']);
     });
 });
+describe('Pino 兼容性测试', () => {
+    it('应该支持 child 方法创建子 logger', () => {
+        const print = vi.fn();
+        const logger = new Logger({ print });
+        const child = logger.child({ requestId: '123' });
+        expect(child).toBeInstanceOf(Logger);
+        expect(child.level).toBe(logger.level);
+        child.info('child log');
+        expect(print).toHaveBeenCalledWith('info', 'child log');
+    });
+    it('child logger 应该继承父 logger 的配置', () => {
+        const print = vi.fn();
+        const parent = new Logger({ level: 'warn', print });
+        const child = parent.child();
+        expect(child.level).toBe('warn');
+        child.info('info message');
+        child.warn('warn message');
+        expect(print).not.toHaveBeenCalledWith('info', 'info message');
+        expect(print).toHaveBeenCalledWith('warn', 'warn message');
+    });
+    it('child logger 可以有自己的配置选项', () => {
+        const parentPrint = vi.fn();
+        const childPrint = vi.fn();
+        const parent = new Logger({ level: 'info', print: parentPrint });
+        const child = parent.child({}, { level: 'debug', print: childPrint });
+        expect(child.level).toBe('debug');
+        child.debug('debug message');
+        expect(parentPrint).not.toHaveBeenCalled();
+        expect(childPrint).toHaveBeenCalledWith('debug', 'debug message');
+    });
+    it('应该支持 level 属性的 getter 和 setter', () => {
+        const logger = new Logger();
+        expect(logger.level).toBe('info'); // 默认级别
+        logger.level = 'debug';
+        expect(logger.level).toBe('debug');
+        logger.level = 'error';
+        expect(logger.level).toBe('error');
+    });
+    it('level 变更应该影响日志输出', () => {
+        const print = vi.fn();
+        const logger = new Logger({ print });
+        logger.level = 'error';
+        logger.info('info message');
+        logger.error('error message');
+        expect(print).not.toHaveBeenCalledWith('info', 'info message');
+        expect(print).toHaveBeenCalledWith('error', 'error message');
+    });
+    it('应该包含所有 Pino 兼容的方法', () => {
+        const logger = new Logger();
+        // 检查所有必需的方法是否存在
+        expect(typeof logger.trace).toBe('function');
+        expect(typeof logger.debug).toBe('function');
+        expect(typeof logger.info).toBe('function');
+        expect(typeof logger.warn).toBe('function');
+        expect(typeof logger.error).toBe('function');
+        expect(typeof logger.fatal).toBe('function');
+        expect(typeof logger.silent).toBe('function');
+        expect(typeof logger.child).toBe('function');
+        // 检查 level 属性
+        expect(typeof logger.level).toBe('string');
+    });
+});

package/output/logger/transport.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../source/logger/transport.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AAGxC;;;GAGG;AACH,MAAM,WAAW,SAAS;IACxB,WAAW;IACX,KAAK,EAAE,QAAQ,CAAA;IACf,UAAU;IACV,SAAS,EAAE,IAAI,CAAA;IACf,aAAa;IACb,IAAI,EAAE,GAAG,EAAE,CAAA;IACX,eAAe;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;CAC/B;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,sBAAsB;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IAErB,aAAa;IACb,KAAK,CAAC,EAAE,QAAQ,CAAA;IAEhB,WAAW;IACX,OAAO,CAAC,EAAE,OAAO,CAAA;IAEjB;;;OAGG;IACH,GAAG,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAE5C;;OAEG;IACH,KAAK,CAAC,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,gBAAgB;IAChB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,aAAa;IACb,KAAK,CAAC,EAAE,QAAQ,CAAA;IAChB,WAAW;IACX,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,cAAe,SAAQ,SAAS;IAC/C,YAAY;IACZ,EAAE,EAAE,MAAM,CAAA;CACX;AAED;;;;GAIG;AACH,qBAAa,eAAgB,YAAW,YAAY;IAClD,SAAgB,IAAI,EAAE,MAAM,CAAY;IACjC,KAAK,CAAC,EAAE,QAAQ,CAAA;IAChB,OAAO,EAAE,OAAO,CAAQ;IAE/B,OAAO,CAAC,KAAK,CAAsB;IACnC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAkD;gBAExE,OAAO,GAAE,sBAA2B;IAQhD;;OAEG;IACH,OAAO,CAAC,SAAS;IAeV,GAAG,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI;IAQnC;;OAEG;IACI,UAAU,IAAI,SAAS,cAAc,EAAE;IAO9C;;OAEG;IACI,iBAAiB,CAAC,KAAK,EAAE,QAAQ,GAAG,cAAc,EAAE;IAQ3D;;OAEG;IACI,qBAAqB,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,GAAG,cAAc,EAAE;IAQtE;;;OAGG;IACI,aAAa,CAAC,SAAS,EAAE,CAAC,MAAM,EAAE,cAAc,KAAK,OAAO,GAAG,cAAc,EAAE;IAItF;;;OAGG;IACI,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,cAAc,EAAE;IAsB5D;;OAEG;IACI,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,EAAE;IAOxD;;OAEG;IACI,QAAQ,IAAI;QACjB,KAAK,EAAE,MAAM,CAAA;QACb,OAAO,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAA;QACjC,eAAe,CAAC,EAAE,IAAI,CAAA;QACtB,eAAe,CAAC,EAAE,IAAI,CAAA;KACvB;IA4BD;;OAEG;IACI,KAAK,IAAI,IAAI;IAIpB;;OAEG;IACI,YAAY,IAAI,MAAM;IAI7B;;OAEG;IACI,KAAK,IAAI,IAAI;CAGrB"}
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../source/logger/transport.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AAGxC;;;GAGG;AACH,MAAM,WAAW,SAAS;IACxB,WAAW;IACX,KAAK,EAAE,QAAQ,CAAA;IACf,UAAU;IACV,SAAS,EAAE,IAAI,CAAA;IACf,aAAa;IACb,IAAI,EAAE,GAAG,EAAE,CAAA;IACX,eAAe;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;CAC/B;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,sBAAsB;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IAErB,aAAa;IACb,KAAK,CAAC,EAAE,QAAQ,CAAA;IAEhB,WAAW;IACX,OAAO,CAAC,EAAE,OAAO,CAAA;IAEjB;;;OAGG;IACH,GAAG,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAE5C;;OAEG;IACH,KAAK,CAAC,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,gBAAgB;IAChB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,aAAa;IACb,KAAK,CAAC,EAAE,QAAQ,CAAA;IAChB,WAAW;IACX,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,cAAe,SAAQ,SAAS;IAC/C,YAAY;IACZ,EAAE,EAAE,MAAM,CAAA;CACX;AAED;;;;GAIG;AACH,qBAAa,eAAgB,YAAW,YAAY;IAClD,SAAgB,IAAI,EAAE,MAAM,CAAY;IACjC,KAAK,CAAC,EAAE,QAAQ,CAAA;IAChB,OAAO,EAAE,OAAO,CAAQ;IAE/B,OAAO,CAAC,KAAK,CAAsB;IACnC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAoE;gBAE1F,OAAO,GAAE,sBAA2B;IAQhD;;OAEG;IACH,OAAO,CAAC,SAAS;IAeV,GAAG,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI;IAQnC;;OAEG;IACI,UAAU,IAAI,SAAS,cAAc,EAAE;IAO9C;;OAEG;IACI,iBAAiB,CAAC,KAAK,EAAE,QAAQ,GAAG,cAAc,EAAE;IAQ3D;;OAEG;IACI,qBAAqB,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,GAAG,cAAc,EAAE;IAQtE;;;OAGG;IACI,aAAa,CAAC,SAAS,EAAE,CAAC,MAAM,EAAE,cAAc,KAAK,OAAO,GAAG,cAAc,EAAE;IAItF;;;OAGG;IACI,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,cAAc,EAAE;IAsB5D;;OAEG;IACI,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,EAAE;IAOxD;;OAEG;IACI,QAAQ,IAAI;QACjB,KAAK,EAAE,MAAM,CAAA;QACb,OAAO,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAA;QACjC,eAAe,CAAC,EAAE,IAAI,CAAA;QACtB,eAAe,CAAC,EAAE,IAAI,CAAA;KACvB;IA4BD;;OAEG;IACI,KAAK,IAAI,IAAI;IAIpB;;OAEG;IACI,YAAY,IAAI,MAAM;IAI7B;;OAEG;IACI,KAAK,IAAI,IAAI;CAGrB"}

package/output/logger/transport.js

@@ -9,7 +9,7 @@ export class MemoryTransport {
     level;
     enabled = true;
     cache;
-    static LOG_LEVELS = ['debug', 'info', 'warn', 'error'];
+    static LOG_LEVELS = ['trace', 'debug', 'info', 'warn', 'error', 'fatal'];
     constructor(options = {}) {
         this.level = options.level;
         this.enabled = options.enabled ?? true;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@taicode/common-base",
-  "version": "1.6.3",
+  "version": "1.7.1",
   "author": "Alain",
   "license": "ISC",
   "description": "",

package/output/events/disposer.d.ts

@@ -1,6 +0,0 @@
-export declare class Disposer {
-    private cleanupFunctions;
-    addDisposer(cleanupFn: () => unknown): void;
-    dispose(): void;
-}
-//# sourceMappingURL=disposer.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"disposer.d.ts","sourceRoot":"","sources":["../../source/events/disposer.ts"],"names":[],"mappings":"AAAA,qBAAa,QAAQ;IACnB,OAAO,CAAC,gBAAgB,CAAyB;IAGjD,WAAW,CAAC,SAAS,EAAE,MAAM,OAAO,GAAG,IAAI;IAK3C,OAAO,IAAI,IAAI;CAUhB"}

package/output/events/disposer.js

@@ -1,19 +0,0 @@
-export class Disposer {
-    cleanupFunctions = [];
-    // 添加清理函数
-    addDisposer(cleanupFn) {
-        this.cleanupFunctions.push(cleanupFn);
-    }
-    // 执行所有清理函数
-    dispose() {
-        for (const cleanupFn of this.cleanupFunctions) {
-            try {
-                cleanupFn();
-            }
-            catch (error) {
-                console.error('Error during cleanup:', error);
-            }
-        }
-        this.cleanupFunctions = []; // 清空清理函数列表
-    }
-}

package/output/events/disposer.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=disposer.test.d.ts.map

package/output/events/disposer.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"disposer.test.d.ts","sourceRoot":"","sources":["../../source/events/disposer.test.ts"],"names":[],"mappings":""}

package/output/events/disposer.test.js

@@ -1,192 +0,0 @@
-import { describe, it, expect, vi, beforeEach } from 'vitest';
-import { Disposer } from './disposer';
-describe('Disposer', () => {
-    let disposer;
-    beforeEach(() => {
-        disposer = new Disposer();
-    });
-    describe('addDisposer', () => {
-        it('应该能够添加清理函数', () => {
-            const cleanupFn = vi.fn();
-            expect(() => {
-                disposer.addDisposer(cleanupFn);
-            }).not.toThrow();
-        });
-        it('应该能够添加多个清理函数', () => {
-            const cleanupFn1 = vi.fn();
-            const cleanupFn2 = vi.fn();
-            const cleanupFn3 = vi.fn();
-            disposer.addDisposer(cleanupFn1);
-            disposer.addDisposer(cleanupFn2);
-            disposer.addDisposer(cleanupFn3);
-            disposer.dispose();
-            expect(cleanupFn1).toHaveBeenCalledOnce();
-            expect(cleanupFn2).toHaveBeenCalledOnce();
-            expect(cleanupFn3).toHaveBeenCalledOnce();
-        });
-        it('应该能够添加返回不同类型的清理函数', () => {
-            const voidFn = vi.fn(() => { });
-            const stringFn = vi.fn(() => 'cleanup result');
-            const numberFn = vi.fn(() => 42);
-            const promiseFn = vi.fn(() => Promise.resolve('async cleanup'));
-            disposer.addDisposer(voidFn);
-            disposer.addDisposer(stringFn);
-            disposer.addDisposer(numberFn);
-            disposer.addDisposer(promiseFn);
-            disposer.dispose();
-            expect(voidFn).toHaveBeenCalled();
-            expect(stringFn).toHaveBeenCalled();
-            expect(numberFn).toHaveBeenCalled();
-            expect(promiseFn).toHaveBeenCalled();
-        });
-    });
-    describe('dispose', () => {
-        it('应该执行所有清理函数', () => {
-            const cleanupFn1 = vi.fn();
-            const cleanupFn2 = vi.fn();
-            const cleanupFn3 = vi.fn();
-            disposer.addDisposer(cleanupFn1);
-            disposer.addDisposer(cleanupFn2);
-            disposer.addDisposer(cleanupFn3);
-            disposer.dispose();
-            expect(cleanupFn1).toHaveBeenCalledOnce();
-            expect(cleanupFn2).toHaveBeenCalledOnce();
-            expect(cleanupFn3).toHaveBeenCalledOnce();
-        });
-        it('应该按添加顺序执行清理函数', () => {
-            const executionOrder = [];
-            disposer.addDisposer(() => executionOrder.push(1));
-            disposer.addDisposer(() => executionOrder.push(2));
-            disposer.addDisposer(() => executionOrder.push(3));
-            disposer.dispose();
-            expect(executionOrder).toEqual([1, 2, 3]);
-        });
-        it('应该处理清理函数中的错误', () => {
-            const workingFn1 = vi.fn();
-            const errorFn = vi.fn(() => {
-                throw new Error('Cleanup error');
-            });
-            const workingFn2 = vi.fn();
-            // 模拟 console.error
-            const consoleSpy = vi.spyOn(console, 'error').mockImplementation(() => { });
-            disposer.addDisposer(workingFn1);
-            disposer.addDisposer(errorFn);
-            disposer.addDisposer(workingFn2);
-            // dispose 不应该抛出错误
-            expect(() => {
-                disposer.dispose();
-            }).not.toThrow();
-            // 所有函数都应该被调用
-            expect(workingFn1).toHaveBeenCalled();
-            expect(errorFn).toHaveBeenCalled();
-            expect(workingFn2).toHaveBeenCalled();
-            // 错误应该被记录
-            expect(consoleSpy).toHaveBeenCalledWith('Error during cleanup:', expect.any(Error));
-            consoleSpy.mockRestore();
-        });
-        it('应该在执行后清空清理函数列表', () => {
-            const cleanupFn = vi.fn();
-            disposer.addDisposer(cleanupFn);
-            disposer.dispose();
-            expect(cleanupFn).toHaveBeenCalledOnce();
-            // 再次调用 dispose 不应该执行任何函数
-            disposer.dispose();
-            expect(cleanupFn).toHaveBeenCalledOnce();
-        });
-        it('应该能够在清空后重新添加清理函数', () => {
-            const firstCleanup = vi.fn();
-            const secondCleanup = vi.fn();
-            disposer.addDisposer(firstCleanup);
-            disposer.dispose();
-            disposer.addDisposer(secondCleanup);
-            disposer.dispose();
-            expect(firstCleanup).toHaveBeenCalledOnce();
-            expect(secondCleanup).toHaveBeenCalledOnce();
-        });
-        it('应该在没有清理函数时安全执行', () => {
-            expect(() => {
-                disposer.dispose();
-            }).not.toThrow();
-        });
-        it('应该能够多次调用 dispose', () => {
-            const cleanupFn = vi.fn();
-            disposer.addDisposer(cleanupFn);
-            disposer.dispose();
-            disposer.dispose();
-            disposer.dispose();
-            expect(cleanupFn).toHaveBeenCalledOnce();
-        });
-    });
-    describe('实际使用场景', () => {
-        it('应该能够清理事件监听器', () => {
-            const removeEventListener = vi.fn();
-            const unsubscribe = vi.fn();
-            disposer.addDisposer(removeEventListener);
-            disposer.addDisposer(unsubscribe);
-            disposer.dispose();
-            expect(removeEventListener).toHaveBeenCalled();
-            expect(unsubscribe).toHaveBeenCalled();
-        });
-        it('应该能够清理定时器', () => {
-            const clearTimeout = vi.fn();
-            const clearInterval = vi.fn();
-            disposer.addDisposer(() => clearTimeout(123));
-            disposer.addDisposer(() => clearInterval(456));
-            disposer.dispose();
-            expect(clearTimeout).toHaveBeenCalledWith(123);
-            expect(clearInterval).toHaveBeenCalledWith(456);
-        });
-        it('应该能够清理资源连接', () => {
-            const closeConnection = vi.fn();
-            const releaseResource = vi.fn();
-            disposer.addDisposer(() => closeConnection());
-            disposer.addDisposer(() => releaseResource());
-            disposer.dispose();
-            expect(closeConnection).toHaveBeenCalled();
-            expect(releaseResource).toHaveBeenCalled();
-        });
-        it('应该与 EventEmitter 配合使用', () => {
-            // 模拟 EventEmitter 的使用
-            const mockEventEmitter = {
-                on: vi.fn().mockReturnValue(vi.fn()), // 返回 off 函数
-                cleanup: vi.fn()
-            };
-            const offFunction1 = mockEventEmitter.on('event1', vi.fn());
-            const offFunction2 = mockEventEmitter.on('event2', vi.fn());
-            disposer.addDisposer(offFunction1);
-            disposer.addDisposer(offFunction2);
-            disposer.addDisposer(() => mockEventEmitter.cleanup());
-            disposer.dispose();
-            expect(offFunction1).toHaveBeenCalled();
-            expect(offFunction2).toHaveBeenCalled();
-            expect(mockEventEmitter.cleanup).toHaveBeenCalled();
-        });
-    });
-    describe('错误处理', () => {
-        it('应该捕获并记录同步错误', () => {
-            const consoleSpy = vi.spyOn(console, 'error').mockImplementation(() => { });
-            const error = new Error('Sync error');
-            disposer.addDisposer(() => {
-                throw error;
-            });
-            disposer.dispose();
-            expect(consoleSpy).toHaveBeenCalledWith('Error during cleanup:', error);
-            consoleSpy.mockRestore();
-        });
-        it('应该处理不同类型的错误', () => {
-            const consoleSpy = vi.spyOn(console, 'error').mockImplementation(() => { });
-            disposer.addDisposer(() => {
-                throw new TypeError('Type error');
-            });
-            disposer.addDisposer(() => {
-                throw 'String error';
-            });
-            disposer.addDisposer(() => {
-                throw { message: 'Object error' };
-            });
-            disposer.dispose();
-            expect(consoleSpy).toHaveBeenCalledTimes(3);
-            consoleSpy.mockRestore();
-        });
-    });
-});

package/output/events/event-emitter.d.ts

@@ -1,33 +0,0 @@
-type OffFn = () => void;
-type Listener<T = unknown> = (data: T) => void;
-export declare class EventEmitter<Events extends object = object> {
-    private listeners;
-    constructor();
-    /**
-     * 订阅事件
-     * @param type 事件类型
-     * @param listener 回调函数
-     */
-    on<K extends keyof Events>(type: K, listener: Listener<Events[K]>): OffFn;
-    /**
-     * 取消订阅
-     * @param type 事件类型
-     * @param listener 要移除的回调函数（可选）
-     */
-    off<K extends keyof Events>(type: K, listener?: Listener<Events[K]>): void;
-    /**
-     * 触发事件
-     * @param type 事件类型
-     * @param data 要传递的数据
-     */
-    emit<K extends keyof Events>(type: K, data: Events[K]): void;
-    /**
-     * 一次性订阅
-     * @param type 事件类型
-     * @param listener 回调函数
-     */
-    once<K extends keyof Events>(type: K, listener: Listener<Events[K]>): void;
-    cleanup(): void;
-}
-export {};
-//# sourceMappingURL=event-emitter.d.ts.map

package/output/events/event-emitter.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"event-emitter.d.ts","sourceRoot":"","sources":["../../source/events/event-emitter.ts"],"names":[],"mappings":"AAAA,KAAK,KAAK,GAAG,MAAM,IAAI,CAAA;AACvB,KAAK,QAAQ,CAAC,CAAC,GAAG,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,CAAA;AAE9C,qBAAa,YAAY,CAAC,MAAM,SAAS,MAAM,GAAG,MAAM;IACtD,OAAO,CAAC,SAAS,CAAsD;;IAUvE;;;;OAIG;IACH,EAAE,CAAC,CAAC,SAAS,MAAM,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK;IASzE;;;;OAIG;IACH,GAAG,CAAC,CAAC,SAAS,MAAM,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI;IAc1E;;;;OAIG;IACH,IAAI,CAAC,CAAC,SAAS,MAAM,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI;IAQ5D;;;;OAIG;IACH,IAAI,CAAC,CAAC,SAAS,MAAM,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI;IAQ1E,OAAO;CAGR"}

package/output/events/event-emitter.js

@@ -1,66 +0,0 @@
-export class EventEmitter {
-    listeners = {};
-    constructor() {
-        this.on = this.on.bind(this);
-        this.off = this.off.bind(this);
-        this.once = this.once.bind(this);
-        this.emit = this.emit.bind(this);
-        this.cleanup = this.cleanup.bind(this);
-    }
-    /**
-     * 订阅事件
-     * @param type 事件类型
-     * @param listener 回调函数
-     */
-    on(type, listener) {
-        if (!this.listeners[type]) {
-            this.listeners[type] = [];
-        }
-        this.listeners[type].push(listener);
-        return () => this.off(type, listener);
-    }
-    /**
-     * 取消订阅
-     * @param type 事件类型
-     * @param listener 要移除的回调函数（可选）
-     */
-    off(type, listener) {
-        if (!this.listeners[type])
-            return;
-        if (!listener) {
-            // 移除该事件的所有监听器
-            delete this.listeners[type];
-        }
-        else {
-            // 移除特定监听器
-            this.listeners[type] = this.listeners[type].filter((fn) => fn !== listener);
-        }
-    }
-    /**
-     * 触发事件
-     * @param type 事件类型
-     * @param data 要传递的数据
-     */
-    emit(type, data) {
-        const listeners = this.listeners[type];
-        // 复制数组避免回调中取消订阅导致的遍历问题
-        if (listeners) {
-            listeners.slice().forEach((fn) => fn(data));
-        }
-    }
-    /**
-     * 一次性订阅
-     * @param type 事件类型
-     * @param listener 回调函数
-     */
-    once(type, listener) {
-        const onceWrapper = (data) => {
-            listener(data);
-            this.off(type, onceWrapper);
-        };
-        this.on(type, onceWrapper);
-    }
-    cleanup() {
-        this.listeners = {};
-    }
-}

package/output/events/event-emitter.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=event-emitter.test.d.ts.map

package/output/events/event-emitter.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"event-emitter.test.d.ts","sourceRoot":"","sources":["../../source/events/event-emitter.test.ts"],"names":[],"mappings":""}