@taicode/common-base 1.2.0 → 1.4.0

package/output/error/error.d.ts

@@ -1,23 +1,73 @@
-interface ErrorOptions {
+/**
+ * 错误类型模块
+ * key 为错误的类型
+ * value 为错误的上下文类型
+ * 错误的上下文可以帮助系统更好的理解和处理错误
+ * 一般存放的是错误发生时的关键信息，例如请求的路径，参数等等
+ * 输入错误时输入的字段信息，校验规则等等
+ * 可以通过模块声明合并来定义全局错误类型：
+ *
+ * @example
+ * ```typescript
+ * declare module '@taicode/common-base/error' {
+ *   interface UserErrorTypes {
+ *     'validation-failed': { field?: string; value?: unknown; rule?: string }
+ *     'permission-denied': { resource?: string; action?: string; userId?: string }
+ *     'not-found': { id?: string; type?: string; query?: Record<string, unknown> }
+ *   }
+ *
+ *   interface SystemErrorTypes {
+ *     'database-error': { query?: string; table?: string; operation?: string }
+ *     'network-error': { url?: string; method?: string; status?: number }
+ *     'service-unavailable': { service?: string; endpoint?: string; retryAfter?: number }
+ *   }
+ * }
+ *
+ * // 然后可以这样使用：
+ * const userError = new UserError('validation-failed', '邮箱格式无效', {
+ *   field: 'email',
+ *   value: 'invalid-email',
+ *   rule: 'email-format'
+ * })
+ * const systemError = new SystemError('database-error', '数据库连接失败', {
+ *   table: 'users',
+ *   query: 'SELECT * FROM users',
+ *   operation: 'select'
+ * })
+ * ```
+ */
+interface ErrorContext {
+    /** 导致此错误的原因，通常是另一个错误或异常 */
     cause?: unknown;
 }
+export interface UserErrorTypes {
+}
+export interface SystemErrorTypes {
+}
+type UserErrorType = keyof UserErrorTypes extends never ? string : Extract<keyof UserErrorTypes, string>;
+type SystemErrorType = keyof SystemErrorTypes extends never ? string : Extract<keyof SystemErrorTypes, string>;
+type UserErrorContext<T extends string> = T extends keyof UserErrorTypes ? UserErrorTypes[T] & ErrorContext : ErrorContext;
+type SystemErrorContext<T extends string> = T extends keyof SystemErrorTypes ? SystemErrorTypes[T] & ErrorContext : ErrorContext;
 /** 用户可见的错误 */
-export declare class UserError<T extends string> extends Error {
+export declare class UserError<T extends string = UserErrorType> extends Error {
     type: T;
     message: string;
-    constructor(type: T, message: string, options?: ErrorOptions);
-    static is<T extends string>(error: unknown): error is UserError<T>;
+    context?: UserErrorContext<T> | undefined;
+    constructor(type: T, message: string, context?: UserErrorContext<T> | undefined);
+    static is<T extends string = UserErrorType>(error: unknown): error is UserError<T>;
 }
 /** 系统错误 */
-export declare class SystemError<T extends string> extends Error {
+export declare class SystemError<T extends string = SystemErrorType> extends Error {
     type: T;
     message: string;
-    constructor(type: T, message: string, options?: ErrorOptions);
-    static is<T extends string>(error: unknown): error is SystemError<T>;
+    context?: SystemErrorContext<T> | undefined;
+    constructor(type: T, message: string, context?: SystemErrorContext<T> | undefined);
+    static is<T extends string = SystemErrorType>(error: unknown): error is SystemError<T>;
 }
 export declare class UnknownError extends Error {
-    constructor(message: string, options?: ErrorOptions);
-    static is(error: unknown): boolean;
+    context?: ErrorContext | undefined;
+    constructor(message: string, context?: ErrorContext | undefined);
+    static is(error: unknown): error is UnknownError;
 }
 export {};
 //# sourceMappingURL=error.d.ts.map

package/output/error/error.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../../source/error/error.ts"],"names":[],"mappings":"AAAA,UAAU,YAAY;IACpB,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB;AAED,cAAc;AACd,qBAAa,SAAS,CAAC,CAAC,SAAS,MAAM,CAAE,SAAQ,KAAK;IACjC,IAAI,EAAE,CAAC;IAAS,OAAO,EAAE,MAAM;gBAA/B,IAAI,EAAE,CAAC,EAAS,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;IAK1E,MAAM,CAAC,EAAE,CAAC,CAAC,SAAS,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,SAAS,CAAC,CAAC,CAAC;CAGnE;AAED,WAAW;AACX,qBAAa,WAAW,CAAC,CAAC,SAAS,MAAM,CAAE,SAAQ,KAAK;IACnC,IAAI,EAAE,CAAC;IAAS,OAAO,EAAE,MAAM;gBAA/B,IAAI,EAAE,CAAC,EAAS,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;IAK1E,MAAM,CAAC,EAAE,CAAC,CAAC,SAAS,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,WAAW,CAAC,CAAC,CAAC;CAGrE;AAED,qBAAa,YAAa,SAAQ,KAAK;gBACzB,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;IAKnD,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO;CAGnC"}
+{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../../source/error/error.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAEH,UAAU,YAAY;IACpB,2BAA2B;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB;AAID,MAAM,WAAW,cAAc;CAAG;AAClC,MAAM,WAAW,gBAAgB;CAAG;AAGpC,KAAK,aAAa,GAAG,MAAM,cAAc,SAAS,KAAK,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,cAAc,EAAE,MAAM,CAAC,CAAA;AACxG,KAAK,eAAe,GAAG,MAAM,gBAAgB,SAAS,KAAK,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,gBAAgB,EAAE,MAAM,CAAC,CAAA;AAG9G,KAAK,gBAAgB,CAAC,CAAC,SAAS,MAAM,IAAI,CAAC,SAAS,MAAM,cAAc,GACpE,cAAc,CAAC,CAAC,CAAC,GAAG,YAAY,GAChC,YAAY,CAAA;AAEhB,KAAK,kBAAkB,CAAC,CAAC,SAAS,MAAM,IAAI,CAAC,SAAS,MAAM,gBAAgB,GACxE,gBAAgB,CAAC,CAAC,CAAC,GAAG,YAAY,GAClC,YAAY,CAAA;AAEhB,cAAc;AACd,qBAAa,SAAS,CAAC,CAAC,SAAS,MAAM,GAAG,aAAa,CAAE,SAAQ,KAAK;IACjD,IAAI,EAAE,CAAC;IAAS,OAAO,EAAE,MAAM;IAAS,OAAO,CAAC,EAAE,gBAAgB,CAAC,CAAC,CAAC;gBAArE,IAAI,EAAE,CAAC,EAAS,OAAO,EAAE,MAAM,EAAS,OAAO,CAAC,EAAE,gBAAgB,CAAC,CAAC,CAAC,YAAA;IAKxF,MAAM,CAAC,EAAE,CAAC,CAAC,SAAS,MAAM,GAAG,aAAa,EAAE,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,SAAS,CAAC,CAAC,CAAC;CAGnF;AAED,WAAW;AACX,qBAAa,WAAW,CAAC,CAAC,SAAS,MAAM,GAAG,eAAe,CAAE,SAAQ,KAAK;IACrD,IAAI,EAAE,CAAC;IAAS,OAAO,EAAE,MAAM;IAAS,OAAO,CAAC,EAAE,kBAAkB,CAAC,CAAC,CAAC;gBAAvE,IAAI,EAAE,CAAC,EAAS,OAAO,EAAE,MAAM,EAAS,OAAO,CAAC,EAAE,kBAAkB,CAAC,CAAC,CAAC,YAAA;IAK1F,MAAM,CAAC,EAAE,CAAC,CAAC,SAAS,MAAM,GAAG,eAAe,EAAE,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,WAAW,CAAC,CAAC,CAAC;CAGvF;AAED,qBAAa,YAAa,SAAQ,KAAK;IACD,OAAO,CAAC,EAAE,YAAY;gBAA9C,OAAO,EAAE,MAAM,EAAS,OAAO,CAAC,EAAE,YAAY,YAAA;IAK1D,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,YAAY;CAGjD"}

package/output/error/error.js

@@ -1,11 +1,51 @@
+/**
+ * 错误类型模块
+ * key 为错误的类型
+ * value 为错误的上下文类型
+ * 错误的上下文可以帮助系统更好的理解和处理错误
+ * 一般存放的是错误发生时的关键信息，例如请求的路径，参数等等
+ * 输入错误时输入的字段信息，校验规则等等
+ * 可以通过模块声明合并来定义全局错误类型：
+ *
+ * @example
+ * ```typescript
+ * declare module '@taicode/common-base/error' {
+ *   interface UserErrorTypes {
+ *     'validation-failed': { field?: string; value?: unknown; rule?: string }
+ *     'permission-denied': { resource?: string; action?: string; userId?: string }
+ *     'not-found': { id?: string; type?: string; query?: Record<string, unknown> }
+ *   }
+ *
+ *   interface SystemErrorTypes {
+ *     'database-error': { query?: string; table?: string; operation?: string }
+ *     'network-error': { url?: string; method?: string; status?: number }
+ *     'service-unavailable': { service?: string; endpoint?: string; retryAfter?: number }
+ *   }
+ * }
+ *
+ * // 然后可以这样使用：
+ * const userError = new UserError('validation-failed', '邮箱格式无效', {
+ *   field: 'email',
+ *   value: 'invalid-email',
+ *   rule: 'email-format'
+ * })
+ * const systemError = new SystemError('database-error', '数据库连接失败', {
+ *   table: 'users',
+ *   query: 'SELECT * FROM users',
+ *   operation: 'select'
+ * })
+ * ```
+ */
 /** 用户可见的错误 */
 export class UserError extends Error {
     type;
     message;
-    constructor(type, message, options) {
-        super(message, options);
+    context;
+    constructor(type, message, context) {
+        super(message, context);
         this.type = type;
         this.message = message;
+        this.context = context;
         this.name = 'UserError';
     }
     static is(error) {
@@ -16,10 +56,12 @@ export class UserError extends Error {
 export class SystemError extends Error {
     type;
     message;
-    constructor(type, message, options) {
-        super(message, options);
+    context;
+    constructor(type, message, context) {
+        super(message, context);
         this.type = type;
         this.message = message;
+        this.context = context;
         this.name = 'SystemError';
     }
     static is(error) {
@@ -27,8 +69,10 @@ export class SystemError extends Error {
     }
 }
 export class UnknownError extends Error {
-    constructor(message, options) {
-        super(message, options);
+    context;
+    constructor(message, context) {
+        super(message, context);
+        this.context = context;
         this.name = 'UnknownError';
     }
     static is(error) {

package/output/error/index.d.ts

@@ -1,2 +1,2 @@
-export { UserError, SystemError, UnknownError } from './error';
+export { UserError, SystemError, UnknownError, UserErrorTypes, SystemErrorTypes } from './error';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../source/error/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../source/error/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,WAAW,EACX,YAAY,EACZ,cAAc,EACd,gBAAgB,EACjB,MAAM,SAAS,CAAA"}

package/output/logger/formatter.d.ts

@@ -0,0 +1,71 @@
+export interface FormatterConfig {
+    /** 错误对象格式化器 */
+    error?: (error: unknown) => string;
+    /** 日期格式化器 */
+    date?: (date: Date) => string;
+    /** 对象格式化器 */
+    object?: (obj: any) => string;
+    /** 数组格式化器 */
+    array?: (arr: any[]) => string;
+    /** 函数格式化器 */
+    function?: (fn: Function) => string;
+    /** 其他类型格式化器 */
+    other?: (value: any) => string;
+}
+/**
+ * 日志格式化器接口
+ * 定义格式化器的核心方法
+ */
+export interface LogFormatter {
+    /** 格式化单个参数 */
+    format(arg: any): string;
+    /** 格式化参数数组 */
+    formatArguments(args: any[]): string[];
+}
+export interface ErrorFormatterOptions {
+    /** 是否显示堆栈信息 */
+    showStack?: boolean;
+    /** 是否显示错误上下文 */
+    showContext?: boolean;
+    /** 是否使用颜色（在支持的终端中） */
+    useColors?: boolean;
+}
+/**
+ * 日志格式化器
+ * 负责根据配置格式化各种类型的参数
+ */
+export declare class DefaultLogFormatter implements LogFormatter {
+    private errorOptions;
+    private config;
+    constructor(config?: FormatterConfig, errorOptions?: ErrorFormatterOptions);
+    /**
+     * 格式化单个参数
+     */
+    format(arg: any): string;
+    /**
+     * 格式化参数数组
+     */
+    formatArguments(args: any[]): string[];
+    /**
+     * 格式化错误对象
+     */
+    private formatError;
+    private formatUserError;
+    private formatSystemError;
+    private formatUnknownError;
+    private formatGenericError;
+    private formatUnknownValue;
+    private formatContext;
+    private colorize;
+    private formatDate;
+    private formatObject;
+    private formatArray;
+    private formatFunction;
+    private formatSimple;
+    private formatOther;
+}
+/**
+ * 默认的日志格式化器实例
+ */
+export declare const defaultLogFormatter: DefaultLogFormatter;
+//# sourceMappingURL=formatter.d.ts.map

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

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

package/output/logger/formatter.js

@@ -0,0 +1,222 @@
+/**
+ * 格式化器配置模块
+ * 提供各种类型数据的格式化功能
+ */
+import { UserError, SystemError, UnknownError } from '../error';
+/**
+ * 日志格式化器
+ * 负责根据配置格式化各种类型的参数
+ */
+export class DefaultLogFormatter {
+    errorOptions;
+    config;
+    constructor(config = {}, errorOptions = {}) {
+        this.errorOptions = {
+            showStack: errorOptions.showStack ?? true,
+            showContext: errorOptions.showContext ?? true,
+            useColors: errorOptions.useColors ?? true,
+        };
+        this.config = {
+            date: config.date || this.formatDate.bind(this),
+            object: config.object || this.formatObject.bind(this),
+            array: config.array || this.formatArray.bind(this),
+            function: config.function || this.formatFunction.bind(this),
+            other: config.other || this.formatOther.bind(this),
+        };
+    }
+    /**
+     * 格式化单个参数
+     */
+    format(arg) {
+        if (arg instanceof Error) {
+            return this.formatError(arg, this.errorOptions);
+        }
+        if (arg instanceof Date) {
+            return this.config.date(arg);
+        }
+        if (Array.isArray(arg)) {
+            return this.config.array(arg);
+        }
+        if (typeof arg === 'function') {
+            return this.config.function(arg);
+        }
+        if (typeof arg === 'object' && arg !== null) {
+            return this.config.object(arg);
+        }
+        return this.config.other(arg);
+    }
+    /**
+     * 格式化参数数组
+     */
+    formatArguments(args) {
+        return args.map(arg => this.format(arg));
+    }
+    /**
+     * 格式化错误对象
+     */
+    formatError(error, options = {}) {
+        const opts = {
+            showStack: options.showStack ?? true,
+            showContext: options.showContext ?? true,
+            useColors: options.useColors ?? true,
+        };
+        if (UserError.is(error)) {
+            return this.formatUserError(error, opts);
+        }
+        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);
+        }
+        return this.formatUnknownValue(error);
+    }
+    formatUserError(error, opts) {
+        const lines = [
+            this.colorize(`🚫 User Error [${error.type}]`, 'red', 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  ');
+    }
+    formatSystemError(error, opts) {
+        const lines = [
+            this.colorize(`⚠️ System Error [${error.type}]`, 'yellow', 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  ');
+    }
+    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),
+            `Message: ${error.message}`,
+        ];
+        // 处理额外的错误属性
+        const additionalProps = Object.getOwnPropertyNames(error)
+            .filter(prop => !['name', 'message', 'stack'].includes(prop))
+            .map(prop => `${prop}: ${this.formatSimple(error[prop])}`)
+            .filter(Boolean);
+        if (additionalProps.length > 0) {
+            lines.push(`Additional: ${additionalProps.join(', ')}`);
+        }
+        if (opts.showStack && error.stack) {
+            lines.push(`Stack: ${error.stack}`);
+        }
+        return lines.join('\n  ');
+    }
+    formatUnknownValue(value) {
+        return `Unknown Error: ${this.formatOther(value)}`;
+    }
+    formatContext(context) {
+        if (!context || typeof context !== 'object') {
+            return String(context);
+        }
+        try {
+            return JSON.stringify(context, null, 2);
+        }
+        catch {
+            return String(context);
+        }
+    }
+    colorize(text, color, useColors) {
+        if (!useColors) {
+            return text;
+        }
+        const colors = {
+            red: '\x1b[31m',
+            yellow: '\x1b[33m',
+            magenta: '\x1b[35m',
+            reset: '\x1b[0m',
+        };
+        return `${colors[color] || ''}${text}${colors.reset}`;
+    }
+    formatDate(date) {
+        return date.toISOString();
+    }
+    formatObject(obj) {
+        if (obj === null)
+            return 'null';
+        if (obj === undefined)
+            return 'undefined';
+        try {
+            return JSON.stringify(obj, null, 2);
+        }
+        catch {
+            return String(obj);
+        }
+    }
+    formatArray(arr) {
+        try {
+            return JSON.stringify(arr, null, 2);
+        }
+        catch {
+            return String(arr);
+        }
+    }
+    formatFunction(fn) {
+        return `[Function: ${fn.name || 'anonymous'}]`;
+    }
+    formatSimple(value) {
+        if (value === null)
+            return 'null';
+        if (value === undefined)
+            return 'undefined';
+        if (typeof value === 'string')
+            return value;
+        if (typeof value === 'number' || typeof value === 'boolean')
+            return String(value);
+        if (typeof value === 'symbol')
+            return value.toString();
+        if (typeof value === 'bigint')
+            return value.toString() + 'n';
+        return String(value);
+    }
+    formatOther(value) {
+        if (value === null)
+            return '[null]';
+        if (value === undefined)
+            return '[undefined]';
+        if (typeof value === 'string')
+            return value; // 字符串保持原样，不添加类型标识
+        if (typeof value === 'number')
+            return `${value}`;
+        if (typeof value === 'boolean')
+            return `${value}`;
+        if (typeof value === 'symbol')
+            return `[symbol] ${value.toString()}`;
+        if (typeof value === 'bigint')
+            return `[bigint] ${value.toString()}n`;
+        return String(value);
+    }
+}
+/**
+ * 默认的日志格式化器实例
+ */
+export const defaultLogFormatter = new DefaultLogFormatter();

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

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

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