@taicode/common-base 1.7.4 → 1.7.5

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

@@ -0,0 +1,33 @@
+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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,66 @@
+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

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

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

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

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/logger/formatter.d.ts

@@ -52,7 +52,6 @@ export declare class DefaultLogFormatter implements LogFormatter {
     private formatError;
     private formatUserError;
     private formatSystemError;
-    private formatUnknownError;
     private formatGenericError;
     private formatUnknownValue;
     private formatContext;

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

@@ -1 +1 @@
-{"version":3,"file":"formatter.d.ts","sourceRoot":"","sources":["../../source/logger/formatter.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,eAAe;IAC9B,eAAe;IACf,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,MAAM,CAAA;IAClC,aAAa;IACb,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,MAAM,CAAA;IAC7B,aAAa;IACb,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,MAAM,CAAA;IAC7B,aAAa;IACb,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,MAAM,CAAA;IAC9B,aAAa;IACb,QAAQ,CAAC,EAAE,CAAC,EAAE,EAAE,QAAQ,KAAK,MAAM,CAAA;IACnC,eAAe;IACf,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,MAAM,CAAA;CAC/B;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,cAAc;IACd,MAAM,CAAC,GAAG,EAAE,GAAG,GAAG,MAAM,CAAA;IACxB,cAAc;IACd,eAAe,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,MAAM,EAAE,CAAA;CACvC;AAED,MAAM,WAAW,qBAAqB;IACpC,eAAe;IACf,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,gBAAgB;IAChB,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,sBAAsB;IACtB,SAAS,CAAC,EAAE,OAAO,CAAA;CACpB;AAED;;;GAGG;AACH,qBAAa,mBAAoB,YAAW,YAAY;IACtD,OAAO,CAAC,YAAY,CAAuB;IAC3C,OAAO,CAAC,MAAM,CAA0C;gBAE5C,MAAM,GAAE,eAAoB,EAAE,YAAY,GAAE,qBAA0B;IAgBlF;;OAEG;IACH,MAAM,CAAC,GAAG,EAAE,GAAG,GAAG,MAAM;IAwBxB;;OAEG;IACH,eAAe,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,MAAM,EAAE;IAItC;;OAEG;IACH,OAAO,CAAC,WAAW;IA0BnB,OAAO,CAAC,eAAe;IAiBvB,OAAO,CAAC,iBAAiB;IAiBzB,OAAO,CAAC,kBAAkB;IAiB1B,OAAO,CAAC,kBAAkB;IAuB1B,OAAO,CAAC,kBAAkB;IAI1B,OAAO,CAAC,aAAa;IAYrB,OAAO,CAAC,QAAQ;IAehB,OAAO,CAAC,UAAU;IAIlB,OAAO,CAAC,YAAY;IAWpB,OAAO,CAAC,WAAW;IAQnB,OAAO,CAAC,cAAc;IAItB,OAAO,CAAC,YAAY;IAWpB,OAAO,CAAC,WAAW;CAWpB;AAED;;GAEG;AACH,eAAO,MAAM,mBAAmB,qBAA4B,CAAA"}
+{"version":3,"file":"formatter.d.ts","sourceRoot":"","sources":["../../source/logger/formatter.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,eAAe;IAC9B,eAAe;IACf,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,MAAM,CAAA;IAClC,aAAa;IACb,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,MAAM,CAAA;IAC7B,aAAa;IACb,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,MAAM,CAAA;IAC7B,aAAa;IACb,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,MAAM,CAAA;IAC9B,aAAa;IACb,QAAQ,CAAC,EAAE,CAAC,EAAE,EAAE,QAAQ,KAAK,MAAM,CAAA;IACnC,eAAe;IACf,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,MAAM,CAAA;CAC/B;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,cAAc;IACd,MAAM,CAAC,GAAG,EAAE,GAAG,GAAG,MAAM,CAAA;IACxB,cAAc;IACd,eAAe,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,MAAM,EAAE,CAAA;CACvC;AAED,MAAM,WAAW,qBAAqB;IACpC,eAAe;IACf,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,gBAAgB;IAChB,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,sBAAsB;IACtB,SAAS,CAAC,EAAE,OAAO,CAAA;CACpB;AAED;;;GAGG;AACH,qBAAa,mBAAoB,YAAW,YAAY;IACtD,OAAO,CAAC,YAAY,CAAuB;IAC3C,OAAO,CAAC,MAAM,CAA0C;gBAE5C,MAAM,GAAE,eAAoB,EAAE,YAAY,GAAE,qBAA0B;IAgBlF;;OAEG;IACH,MAAM,CAAC,GAAG,EAAE,GAAG,GAAG,MAAM;IAwBxB;;OAEG;IACH,eAAe,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,MAAM,EAAE;IAItC;;OAEG;IACH,OAAO,CAAC,WAAW;IAsBnB,OAAO,CAAC,eAAe;IAiBvB,OAAO,CAAC,iBAAiB;IAiBzB,OAAO,CAAC,kBAAkB;IAuB1B,OAAO,CAAC,kBAAkB;IAI1B,OAAO,CAAC,aAAa;IAYrB,OAAO,CAAC,QAAQ;IAehB,OAAO,CAAC,UAAU;IAIlB,OAAO,CAAC,YAAY;IAWpB,OAAO,CAAC,WAAW;IAQnB,OAAO,CAAC,cAAc;IAItB,OAAO,CAAC,YAAY;IAWpB,OAAO,CAAC,WAAW;CAWpB;AAED;;GAEG;AACH,eAAO,MAAM,mBAAmB,qBAA4B,CAAA"}

package/output/logger/formatter.js

@@ -2,7 +2,7 @@
  * 格式化器配置模块
  * 提供各种类型数据的格式化功能
  */
-import { UserError, SystemError, UnknownError } from '../error';
+import { UserError, SystemError } from '../error';
 /**
  * 日志格式化器
  * 负责根据配置格式化各种类型的参数
@@ -66,9 +66,6 @@ export class DefaultLogFormatter {
         if (SystemError.is(error)) {
             return this.formatSystemError(error, opts);
         }
-        if (UnknownError.is(error)) {
-            return this.formatUnknownError(error, opts);
-        }
         if (error instanceof Error) {
             return this.formatGenericError(error, opts);
         }
@@ -100,19 +97,6 @@ export class DefaultLogFormatter {
         }
         return lines.join('\n  ');
     }
-    formatUnknownError(error, opts) {
-        const lines = [
-            this.colorize('❓ Unknown Error', 'magenta', opts.useColors),
-            `Message: ${error.message}`,
-        ];
-        if (opts.showContext && error.context) {
-            lines.push(`Context: ${this.formatContext(error.context)}`);
-        }
-        if (opts.showStack && error.stack) {
-            lines.push(`Stack: ${error.stack}`);
-        }
-        return lines.join('\n  ');
-    }
     formatGenericError(error, opts) {
         const lines = [
             this.colorize(`💥 ${error.name}`, 'red', opts.useColors),

package/output/logger/formatter.test.d.ts

@@ -1,26 +1,2 @@
-declare module '../error' {
-    interface UserErrorTypes {
-        'validation-failed': {
-            field?: string;
-            value?: unknown;
-            rule?: string;
-        };
-        'test-error': {
-            field?: string;
-        };
-    }
-    interface SystemErrorTypes {
-        'database-error': {
-            query?: string;
-            table?: string;
-            operation?: string;
-        };
-        'network-error': {
-            url?: string;
-            method?: string;
-            status?: number;
-        };
-    }
-}
 export {};
 //# sourceMappingURL=formatter.test.d.ts.map

package/output/logger/formatter.test.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"formatter.test.d.ts","sourceRoot":"","sources":["../../source/logger/formatter.test.ts"],"names":[],"mappings":"AAKA,OAAO,QAAQ,UAAU,CAAC;IACxB,UAAU,cAAc;QACtB,mBAAmB,EAAE;YAAE,KAAK,CAAC,EAAE,MAAM,CAAC;YAAC,KAAK,CAAC,EAAE,OAAO,CAAC;YAAC,IAAI,CAAC,EAAE,MAAM,CAAA;SAAE,CAAA;QACvE,YAAY,EAAE;YAAE,KAAK,CAAC,EAAE,MAAM,CAAA;SAAE,CAAA;KACjC;IAED,UAAU,gBAAgB;QACxB,gBAAgB,EAAE;YAAE,KAAK,CAAC,EAAE,MAAM,CAAC;YAAC,KAAK,CAAC,EAAE,MAAM,CAAC;YAAC,SAAS,CAAC,EAAE,MAAM,CAAA;SAAE,CAAA;QACxE,eAAe,EAAE;YAAE,GAAG,CAAC,EAAE,MAAM,CAAC;YAAC,MAAM,CAAC,EAAE,MAAM,CAAC;YAAC,MAAM,CAAC,EAAE,MAAM,CAAA;SAAE,CAAA;KACpE;CACF"}
+{"version":3,"file":"formatter.test.d.ts","sourceRoot":"","sources":["../../source/logger/formatter.test.ts"],"names":[],"mappings":""}

package/output/logger/formatter.test.js

@@ -1,6 +1,6 @@
 import { describe, it, expect, beforeEach } from 'vitest';
 import { DefaultLogFormatter } from './formatter';
-import { UserError, SystemError, UnknownError } from '../error';
+import { UserError, SystemError } from '../error';
 describe('DefaultLogFormatter', () => {
     let formatter;
     beforeEach(() => {
@@ -119,11 +119,11 @@ describe('DefaultLogFormatter', () => {
     describe('错误格式化', () => {
         describe('UserError 格式化', () => {
             it('应该格式化带有完整信息的 UserError', () => {
-                const error = new UserError('validation-failed', '验证失败', {
+                const error = new UserError('validation-failed', {
                     field: 'email',
                     value: 'invalid-email',
                     rule: 'email-format'
-                });
+                }, '验证失败');
                 const result = formatter.format(error);
                 expect(result).toContain('🚫 User Error [validation-failed]');
                 expect(result).toContain('Message: 验证失败');
@@ -132,7 +132,7 @@ describe('DefaultLogFormatter', () => {
             });
             it('应该在禁用颜色时不包含 ANSI 代码', () => {
                 const formatterWithoutColors = new DefaultLogFormatter({}, { useColors: false });
-                const error = new UserError('test-error', '测试错误');
+                const error = new UserError('test-error', undefined, '测试错误');
                 const result = formatterWithoutColors.format(error);
                 expect(result).not.toContain('\x1b[');
                 expect(result).toContain('🚫 User Error [test-error]');
@@ -140,14 +140,14 @@ describe('DefaultLogFormatter', () => {
             });
             it('应该在禁用堆栈时不显示堆栈信息', () => {
                 const formatterWithoutStack = new DefaultLogFormatter({}, { showStack: false });
-                const error = new UserError('test-error', '测试错误');
+                const error = new UserError('test-error', undefined, '测试错误');
                 const result = formatterWithoutStack.format(error);
                 expect(result).not.toContain('Stack:');
                 expect(result).toContain('Message: 测试错误');
             });
             it('应该在禁用上下文时不显示上下文信息', () => {
                 const formatterWithoutContext = new DefaultLogFormatter({}, { showContext: false });
-                const error = new UserError('test-error', '测试错误', { field: 'test' });
+                const error = new UserError('test-error', { field: 'test' }, '测试错误');
                 const result = formatterWithoutContext.format(error);
                 expect(result).not.toContain('Context:');
                 expect(result).toContain('Message: 测试错误');
@@ -155,11 +155,11 @@ describe('DefaultLogFormatter', () => {
         });
         describe('SystemError 格式化', () => {
             it('应该格式化带有完整信息的 SystemError', () => {
-                const error = new SystemError('database-error', '数据库连接失败', {
+                const error = new SystemError('database-error', {
                     table: 'users',
                     query: 'SELECT * FROM users',
                     operation: 'select'
-                });
+                }, '数据库连接失败');
                 const result = formatter.format(error);
                 expect(result).toContain('⚠️ System Error [database-error]');
                 expect(result).toContain('Message: 数据库连接失败');
@@ -168,31 +168,12 @@ describe('DefaultLogFormatter', () => {
             });
             it('应该在禁用颜色时不包含 ANSI 代码', () => {
                 const formatterWithoutColors = new DefaultLogFormatter({}, { useColors: false });
-                const error = new SystemError('network-error', '网络错误');
+                const error = new SystemError('network-error', undefined, '网络错误');
                 const result = formatterWithoutColors.format(error);
                 expect(result).not.toContain('\x1b[');
                 expect(result).toContain('⚠️ System Error [network-error]');
             });
         });
-        describe('UnknownError 格式化', () => {
-            it('应该格式化带有完整信息的 UnknownError', () => {
-                const error = new UnknownError('未知错误', {
-                    cause: 'something went wrong'
-                });
-                const result = formatter.format(error);
-                expect(result).toContain('❓ Unknown Error');
-                expect(result).toContain('Message: 未知错误');
-                expect(result).toContain('Context:');
-                expect(result).toContain('Stack:');
-            });
-            it('应该在禁用颜色时不包含 ANSI 代码', () => {
-                const formatterWithoutColors = new DefaultLogFormatter({}, { useColors: false });
-                const error = new UnknownError('测试未知错误');
-                const result = formatterWithoutColors.format(error);
-                expect(result).not.toContain('\x1b[');
-                expect(result).toContain('❓ Unknown Error');
-            });
-        });
         describe('通用 Error 格式化', () => {
             it('应该格式化普通 Error', () => {
                 const error = new Error('普通错误');
@@ -291,7 +272,7 @@ describe('DefaultLogFormatter', () => {
                 showContext: false,
                 useColors: false
             });
-            const error = new UserError('test-error', '测试错误', { field: 'test' });
+            const error = new UserError('test-error', { field: 'test' }, '测试错误');
             const result = minimalistFormatter.format(error);
             expect(result).not.toContain('Stack:');
             expect(result).not.toContain('Context:');
@@ -305,7 +286,7 @@ describe('DefaultLogFormatter', () => {
                 showContext: false,
                 useColors: false
             });
-            const error = new SystemError('database-error', '数据库错误', { table: 'users' });
+            const error = new SystemError('database-error', { table: 'users' }, '数据库错误');
             const result = stackOnlyFormatter.format(error);
             expect(result).toContain('Stack:');
             expect(result).not.toContain('Context:');

package/output/logger/logger.test.d.ts

@@ -1,21 +1,2 @@
-declare module '../error' {
-    interface UserErrorTypes {
-        'validation-failed': {
-            field?: string;
-            value?: unknown;
-            rule?: string;
-        };
-        'test-error': {
-            field?: string;
-        };
-    }
-    interface SystemErrorTypes {
-        'database-error': {
-            query?: string;
-            table?: string;
-            operation?: string;
-        };
-    }
-}
 export {};
 //# sourceMappingURL=logger.test.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"logger.test.d.ts","sourceRoot":"","sources":["../../source/logger/logger.test.ts"],"names":[],"mappings":"AAOA,OAAO,QAAQ,UAAU,CAAC;IACxB,UAAU,cAAc;QACtB,mBAAmB,EAAE;YAAE,KAAK,CAAC,EAAE,MAAM,CAAC;YAAC,KAAK,CAAC,EAAE,OAAO,CAAC;YAAC,IAAI,CAAC,EAAE,MAAM,CAAA;SAAE,CAAA;QACvE,YAAY,EAAE;YAAE,KAAK,CAAC,EAAE,MAAM,CAAA;SAAE,CAAA;KACjC;IAED,UAAU,gBAAgB;QACxB,gBAAgB,EAAE;YAAE,KAAK,CAAC,EAAE,MAAM,CAAC;YAAC,KAAK,CAAC,EAAE,MAAM,CAAC;YAAC,SAAS,CAAC,EAAE,MAAM,CAAA;SAAE,CAAA;KACzE;CACF"}
+{"version":3,"file":"logger.test.d.ts","sourceRoot":"","sources":["../../source/logger/logger.test.ts"],"names":[],"mappings":""}

package/output/logger/logger.test.js

@@ -1,7 +1,7 @@
 import { describe, it, expect, vi } from 'vitest';
 import { Logger } from './logger';
 import { DefaultLogFormatter } from './formatter';
-import { UserError, SystemError, UnknownError } from '../error';
+import { UserError, SystemError } from '../error';
 import { MemoryTransport } from './transport'; // 测试向后兼容性
 describe('Logger', () => {
     it('应该默认记录 info 及以上级别', () => {
@@ -66,11 +66,11 @@ describe('Logger 错误处理', () => {
     it('应该正确格式化 UserError', () => {
         const mockPrint = vi.fn();
         const logger = new Logger({ print: mockPrint });
-        const userError = new UserError('validation-failed', '邮箱格式无效', {
+        const userError = new UserError('validation-failed', {
             field: 'email',
             value: 'invalid-email',
             rule: 'email-format'
-        });
+        }, '邮箱格式无效');
         logger.error('测试用户错误:', userError);
         expect(mockPrint).toHaveBeenCalledWith('error', '测试用户错误:', expect.stringContaining('🚫 User Error [validation-failed]'));
         expect(mockPrint).toHaveBeenCalledWith('error', '测试用户错误:', expect.stringContaining('邮箱格式无效'));
@@ -78,25 +78,15 @@ describe('Logger 错误处理', () => {
     it('应该正确格式化 SystemError', () => {
         const mockPrint = vi.fn();
         const logger = new Logger({ print: mockPrint });
-        const systemError = new SystemError('database-error', '数据库连接失败', {
+        const systemError = new SystemError('database-error', {
             table: 'users',
             query: 'SELECT * FROM users',
             operation: 'select'
-        });
+        }, '数据库连接失败');
         logger.error('测试系统错误:', systemError);
         expect(mockPrint).toHaveBeenCalledWith('error', '测试系统错误:', expect.stringContaining('⚠️ System Error [database-error]'));
         expect(mockPrint).toHaveBeenCalledWith('error', '测试系统错误:', expect.stringContaining('数据库连接失败'));
     });
-    it('应该正确格式化 UnknownError', () => {
-        const mockPrint = vi.fn();
-        const logger = new Logger({ print: mockPrint });
-        const unknownError = new UnknownError('未知错误', {
-            cause: 'something went wrong'
-        });
-        logger.error('测试未知错误:', unknownError);
-        expect(mockPrint).toHaveBeenCalledWith('error', '测试未知错误:', expect.stringContaining('❓ Unknown Error'));
-        expect(mockPrint).toHaveBeenCalledWith('error', '测试未知错误:', expect.stringContaining('未知错误'));
-    });
     it('应该正确格式化普通 Error', () => {
         const mockPrint = vi.fn();
         const logger = new Logger({ print: mockPrint });
@@ -132,7 +122,7 @@ describe('Logger 错误处理', () => {
             print: mockPrint,
             formatter: customFormatter
         });
-        const userError = new UserError('test-error', '测试错误', { field: 'test' });
+        const userError = new UserError('test-error', { field: 'test' }, '测试错误');
         logger.error(userError);
         const formattedError = mockPrint.mock.calls[0][1];
         expect(formattedError).not.toContain('Stack:');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@taicode/common-base",
-  "version": "1.7.4",
+  "version": "1.7.5",
   "author": "Alain",
   "license": "ISC",
   "description": "",
@@ -28,6 +28,7 @@
     "output"
   ],
   "devDependencies": {
-    "vitest": "^3.2.4"
+    "vitest": "^3.2.4",
+    "mobx": "^6.0.0"
   }
 }