@vlian/framework 1.0.0

package/dist/utils/logger.cjs

@@ -0,0 +1,396 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+function _export(target, all) {
+    for(var name in all)Object.defineProperty(target, name, {
+        enumerable: true,
+        get: Object.getOwnPropertyDescriptor(all, name).get
+    });
+}
+_export(exports, {
+    get LogFormat () {
+        return LogFormat;
+    },
+    get Logger () {
+        return Logger;
+    },
+    get createLogger () {
+        return createLogger;
+    },
+    get logger () {
+        return logger;
+    }
+});
+const _loggertypes = require("./logger.types");
+const _security = require("./security");
+const _traceId = require("./traceId");
+function _define_property(obj, key, value) {
+    if (key in obj) {
+        Object.defineProperty(obj, key, {
+            value: value,
+            enumerable: true,
+            configurable: true,
+            writable: true
+        });
+    } else {
+        obj[key] = value;
+    }
+    return obj;
+}
+/**
+ * 检测运行环境是否为浏览器
+ */ const isBrowser = ()=>{
+    return typeof window !== 'undefined' && typeof window.document !== 'undefined';
+};
+/**
+ * ANSI 颜色代码（用于 Node.js 环境）
+ */ const ANSI_COLORS = {
+    reset: '\x1b[0m',
+    bright: '\x1b[1m',
+    dim: '\x1b[2m',
+    red: '\x1b[31m',
+    green: '\x1b[32m',
+    yellow: '\x1b[33m',
+    blue: '\x1b[34m',
+    magenta: '\x1b[35m',
+    cyan: '\x1b[36m',
+    white: '\x1b[37m',
+    bgRed: '\x1b[41m',
+    bgGreen: '\x1b[42m',
+    bgYellow: '\x1b[43m',
+    bgBlue: '\x1b[44m',
+    bgMagenta: '\x1b[45m',
+    bgCyan: '\x1b[46m',
+    bgWhite: '\x1b[47m'
+};
+/**
+ * 浏览器控制台样式（用于浏览器环境）
+ */ const BROWSER_STYLES = {
+    debug: 'color: #888; font-weight: normal;',
+    info: 'color: #2196F3; font-weight: normal;',
+    warn: 'color: #FF9800; font-weight: bold;',
+    error: 'color: #F44336; font-weight: bold;'
+};
+/**
+ * 日志级别对应的颜色配置
+ */ const LEVEL_COLORS = {
+    [_loggertypes.LogLevel.DEBUG]: {
+        node: ANSI_COLORS.dim + ANSI_COLORS.white,
+        browser: BROWSER_STYLES.debug
+    },
+    [_loggertypes.LogLevel.INFO]: {
+        node: ANSI_COLORS.cyan,
+        browser: BROWSER_STYLES.info
+    },
+    [_loggertypes.LogLevel.WARN]: {
+        node: ANSI_COLORS.yellow,
+        browser: BROWSER_STYLES.warn
+    },
+    [_loggertypes.LogLevel.ERROR]: {
+        node: ANSI_COLORS.red + ANSI_COLORS.bright,
+        browser: BROWSER_STYLES.error
+    },
+    [_loggertypes.LogLevel.NONE]: {
+        node: '',
+        browser: ''
+    }
+};
+/**
+ * 日志级别标签
+ */ const LEVEL_LABELS = {
+    [_loggertypes.LogLevel.DEBUG]: 'DEBUG',
+    [_loggertypes.LogLevel.INFO]: 'INFO',
+    [_loggertypes.LogLevel.WARN]: 'WARN',
+    [_loggertypes.LogLevel.ERROR]: 'ERROR',
+    [_loggertypes.LogLevel.NONE]: ''
+};
+var LogFormat = /*#__PURE__*/ function(LogFormat) {
+    /**
+   * 文本格式（默认）
+   */ LogFormat["TEXT"] = "text";
+    /**
+   * JSON 格式（用于日志聚合）
+   */ LogFormat["JSON"] = "json";
+    /**
+   * 结构化格式（用于分析）
+   */ LogFormat["STRUCTURED"] = "structured";
+    return LogFormat;
+}({});
+/**
+ * Logger 类
+ */ let Logger = class Logger {
+    /**
+   * 设置日志级别
+   */ setLevel(level) {
+        this.level = level;
+    }
+    /**
+   * 获取当前日志级别
+   */ getLevel() {
+        return this.level;
+    }
+    /**
+   * 格式化时间戳
+   */ formatTimestamp() {
+        const now = new Date();
+        const year = now.getFullYear();
+        const month = String(now.getMonth() + 1).padStart(2, '0');
+        const day = String(now.getDate()).padStart(2, '0');
+        const hours = String(now.getHours()).padStart(2, '0');
+        const minutes = String(now.getMinutes()).padStart(2, '0');
+        const seconds = String(now.getSeconds()).padStart(2, '0');
+        const milliseconds = String(now.getMilliseconds()).padStart(3, '0');
+        return `${year}-${month}-${day} ${hours}:${minutes}:${seconds}.${milliseconds}`;
+    }
+    /**
+   * 构建日志前缀
+   */ buildPrefix(logLevel) {
+        const parts = [];
+        if (this.showTimestamp) {
+            parts.push(`[${this.formatTimestamp()}]`);
+        }
+        if (this.showLevel) {
+            parts.push(`[${LEVEL_LABELS[logLevel]}]`);
+        }
+        // 添加追踪 ID（如果存在）
+        const traceId = (0, _traceId.getCurrentTraceId)();
+        if (traceId) {
+            parts.push(`[Trace:${traceId.substring(0, 8)}]`);
+        }
+        if (this.prefix) {
+            parts.push(`[${this.prefix}]`);
+        }
+        return parts.join(' ');
+    }
+    /**
+   * 输出日志（Node.js 环境）
+   */ logNode(level, ...args) {
+        if (level < this.level) {
+            return;
+        }
+        const prefix = this.buildPrefix(level);
+        const colorConfig = LEVEL_COLORS[level];
+        const reset = this.enableColors ? ANSI_COLORS.reset : '';
+        if (this.enableColors && colorConfig.node) {
+            console.log(`${colorConfig.node}${prefix}${reset}`, ...args);
+        } else {
+            console.log(prefix, ...args);
+        }
+    }
+    /**
+   * 输出日志（浏览器环境）
+   */ logBrowser(level, ...args) {
+        if (level < this.level) {
+            return;
+        }
+        const prefix = this.buildPrefix(level);
+        const colorConfig = LEVEL_COLORS[level];
+        if (this.enableColors && colorConfig.browser) {
+            console.log(`%c${prefix}`, colorConfig.browser, ...args);
+        } else {
+            console.log(prefix, ...args);
+        }
+    }
+    /**
+   * 脱敏处理
+   */ sanitizeValue(value) {
+        if (!this.enableSanitization) {
+            return value;
+        }
+        if (typeof value === 'string') {
+            // 检查是否包含敏感内容
+            if (_security.SecurityUtils.containsDangerousContent(value)) {
+                return _security.SecurityUtils.sanitizeText(value);
+            }
+            return value;
+        }
+        if (value && typeof value === 'object') {
+            if (Array.isArray(value)) {
+                return value.map((item)=>this.sanitizeValue(item));
+            }
+            const sanitized = {};
+            for (const [key, val] of Object.entries(value)){
+                // 检查是否为敏感字段
+                if (_security.SecurityUtils.isSensitiveField(key)) {
+                    sanitized[key] = '***';
+                } else {
+                    sanitized[key] = this.sanitizeValue(val);
+                }
+            }
+            return sanitized;
+        }
+        return value;
+    }
+    /**
+   * 处理日志参数（脱敏、过滤等）
+   */ processLogArgs(...args) {
+        // 生产环境自动禁用 DEBUG 级别
+        if (this.isProduction && this.level === _loggertypes.LogLevel.DEBUG) {
+            return [];
+        }
+        return args.map((arg)=>this.sanitizeValue(arg));
+    }
+    /**
+   * 设置日志格式
+   */ setFormat(format) {
+        this.format = format;
+    }
+    /**
+   * 设置日志上下文
+   */ setContext(context) {
+        this.context = {
+            ...this.context,
+            ...context
+        };
+    }
+    /**
+   * 更新日志上下文
+   */ updateContext(context) {
+        this.context = {
+            ...this.context,
+            ...context
+        };
+    }
+    /**
+   * 获取日志上下文
+   */ getContext() {
+        return {
+            ...this.context
+        };
+    }
+    /**
+   * 清除日志上下文
+   */ clearContext() {
+        this.context = {};
+    }
+    /**
+   * 注册日志处理器（用于日志聚合）
+   */ addLogHandler(handler) {
+        this.logHandlers.push(handler);
+        return ()=>{
+            const index = this.logHandlers.indexOf(handler);
+            if (index > -1) {
+                this.logHandlers.splice(index, 1);
+            }
+        };
+    }
+    /**
+   * 创建结构化日志条目
+   */ createStructuredEntry(level, message, data) {
+        const traceId = (0, _traceId.getCurrentTraceId)();
+        const entry = {
+            timestamp: new Date().toISOString(),
+            level,
+            message,
+            context: {
+                ...this.context,
+                traceId: traceId || this.context.traceId
+            },
+            source: this.prefix || 'framework'
+        };
+        if (data !== undefined) {
+            entry.data = this.sanitizeValue(data);
+        }
+        // 如果是错误，提取堆栈信息
+        if (data instanceof Error) {
+            entry.stack = data.stack;
+            entry.message = data.message || message;
+        }
+        return entry;
+    }
+    /**
+   * 输出结构化日志
+   */ outputStructured(entry) {
+        // 调用日志处理器
+        this.logHandlers.forEach((handler)=>{
+            try {
+                handler(entry);
+            } catch (error) {
+            // 忽略处理器错误，避免循环
+            }
+        });
+        // 根据格式输出
+        if (this.format === "json") {
+            console.log(JSON.stringify(entry));
+        } else if (this.format === "structured") {
+            console.log(entry);
+        } else {
+            // TEXT 格式使用原有输出方式
+            const args = entry.data !== undefined ? [
+                entry.data
+            ] : [];
+            if (isBrowser()) {
+                this.logBrowser(entry.level, entry.message, ...args);
+            } else {
+                this.logNode(entry.level, entry.message, ...args);
+            }
+        }
+    }
+    /**
+   * 通用日志输出方法
+   */ log(level, ...args) {
+        if (level < this.level) {
+            return;
+        }
+        const processedArgs = this.processLogArgs(...args);
+        // 如果处理后没有参数（被过滤），则不输出
+        if (processedArgs.length === 0) {
+            return;
+        }
+        // 提取消息和数据
+        const message = typeof processedArgs[0] === 'string' ? processedArgs[0] : 'Log message';
+        const data = processedArgs.length > 1 ? processedArgs.slice(1) : typeof processedArgs[0] === 'string' ? undefined : processedArgs[0];
+        // 创建结构化日志条目
+        const entry = this.createStructuredEntry(level, message, data);
+        // 输出日志
+        this.outputStructured(entry);
+    }
+    /**
+   * 输出 DEBUG 级别日志
+   */ debug(...args) {
+        this.log(_loggertypes.LogLevel.DEBUG, ...args);
+    }
+    /**
+   * 输出 INFO 级别日志
+   */ info(...args) {
+        this.log(_loggertypes.LogLevel.INFO, ...args);
+    }
+    /**
+   * 输出 WARN 级别日志
+   */ warn(...args) {
+        this.log(_loggertypes.LogLevel.WARN, ...args);
+    }
+    /**
+   * 输出 ERROR 级别日志
+   */ error(...args) {
+        this.log(_loggertypes.LogLevel.ERROR, ...args);
+    }
+    constructor(options = {}){
+        _define_property(this, "level", void 0);
+        _define_property(this, "enableColors", void 0);
+        _define_property(this, "showTimestamp", void 0);
+        _define_property(this, "showLevel", void 0);
+        _define_property(this, "prefix", void 0);
+        _define_property(this, "enableSanitization", void 0);
+        _define_property(this, "isProduction", void 0);
+        _define_property(this, "format", void 0);
+        _define_property(this, "context", {});
+        _define_property(this, "logHandlers", []);
+        this.level = options.level ?? _loggertypes.LogLevel.INFO;
+        this.enableColors = options.enableColors ?? true;
+        this.showTimestamp = options.showTimestamp ?? true;
+        this.showLevel = options.showLevel ?? true;
+        this.prefix = options.prefix ?? '';
+        this.enableSanitization = options.enableSanitization ?? true;
+        this.isProduction = typeof process !== 'undefined' && process.env.NODE_ENV === 'production';
+        this.format = options.format ?? "text";
+        this.context = options.context ?? {};
+    }
+};
+const createLogger = (options)=>{
+    return new Logger(options);
+};
+const logger = createLogger();
+
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/logger.ts"],"sourcesContent":["import type { LoggerOptions } from './logger.types';\nimport { LogLevel } from './logger.types';\nimport { SecurityUtils } from './security';\nimport { getCurrentTraceId } from './traceId';\n\n/**\n * 检测运行环境是否为浏览器\n */\nconst isBrowser = (): boolean => {\n  return typeof window !== 'undefined' && typeof window.document !== 'undefined';\n};\n\n/**\n * ANSI 颜色代码（用于 Node.js 环境）\n */\nconst ANSI_COLORS = {\n  reset: '\\x1b[0m',\n  bright: '\\x1b[1m',\n  dim: '\\x1b[2m',\n  red: '\\x1b[31m',\n  green: '\\x1b[32m',\n  yellow: '\\x1b[33m',\n  blue: '\\x1b[34m',\n  magenta: '\\x1b[35m',\n  cyan: '\\x1b[36m',\n  white: '\\x1b[37m',\n  bgRed: '\\x1b[41m',\n  bgGreen: '\\x1b[42m',\n  bgYellow: '\\x1b[43m',\n  bgBlue: '\\x1b[44m',\n  bgMagenta: '\\x1b[45m',\n  bgCyan: '\\x1b[46m',\n  bgWhite: '\\x1b[47m',\n} as const;\n\n/**\n * 浏览器控制台样式（用于浏览器环境）\n */\nconst BROWSER_STYLES = {\n  debug: 'color: #888; font-weight: normal;',\n  info: 'color: #2196F3; font-weight: normal;',\n  warn: 'color: #FF9800; font-weight: bold;',\n  error: 'color: #F44336; font-weight: bold;',\n} as const;\n\n/**\n * 日志级别对应的颜色配置\n */\nconst LEVEL_COLORS: Record<LogLevel, { node: string; browser: string }> = {\n  [LogLevel.DEBUG]: {\n    node: ANSI_COLORS.dim + ANSI_COLORS.white,\n    browser: BROWSER_STYLES.debug,\n  },\n  [LogLevel.INFO]: {\n    node: ANSI_COLORS.cyan,\n    browser: BROWSER_STYLES.info,\n  },\n  [LogLevel.WARN]: {\n    node: ANSI_COLORS.yellow,\n    browser: BROWSER_STYLES.warn,\n  },\n  [LogLevel.ERROR]: {\n    node: ANSI_COLORS.red + ANSI_COLORS.bright,\n    browser: BROWSER_STYLES.error,\n  },\n  [LogLevel.NONE]: {\n    node: '',\n    browser: '',\n  },\n};\n\n/**\n * 日志级别标签\n */\nconst LEVEL_LABELS: Record<LogLevel, string> = {\n  [LogLevel.DEBUG]: 'DEBUG',\n  [LogLevel.INFO]: 'INFO',\n  [LogLevel.WARN]: 'WARN',\n  [LogLevel.ERROR]: 'ERROR',\n  [LogLevel.NONE]: '',\n};\n\n/**\n * 日志格式类型\n */\nexport enum LogFormat {\n  /**\n   * 文本格式（默认）\n   */\n  TEXT = 'text',\n  /**\n   * JSON 格式（用于日志聚合）\n   */\n  JSON = 'json',\n  /**\n   * 结构化格式（用于分析）\n   */\n  STRUCTURED = 'structured',\n}\n\n/**\n * 日志上下文\n */\nexport interface LogContext {\n  /**\n   * 追踪 ID\n   */\n  traceId?: string;\n  /**\n   * 用户 ID\n   */\n  userId?: string;\n  /**\n   * 会话 ID\n   */\n  sessionId?: string;\n  /**\n   * 请求 ID\n   */\n  requestId?: string;\n  /**\n   * 自定义上下文\n   */\n  [key: string]: unknown;\n}\n\n/**\n * 结构化日志条目\n */\nexport interface StructuredLogEntry {\n  /**\n   * 时间戳\n   */\n  timestamp: string;\n  /**\n   * 日志级别\n   */\n  level: LogLevel;\n  /**\n   * 日志消息\n   */\n  message: string;\n  /**\n   * 日志数据\n   */\n  data?: unknown;\n  /**\n   * 日志上下文\n   */\n  context?: LogContext;\n  /**\n   * 日志来源\n   */\n  source?: string;\n  /**\n   * 错误堆栈（如果是错误日志）\n   */\n  stack?: string;\n}\n\n/**\n * Logger 类\n */\nclass Logger {\n  private level: LogLevel;\n  private enableColors: boolean;\n  private showTimestamp: boolean;\n  private showLevel: boolean;\n  private prefix: string;\n  private enableSanitization: boolean;\n  private isProduction: boolean;\n  private format: LogFormat;\n  private context: LogContext = {};\n  private logHandlers: Array<(entry: StructuredLogEntry) => void> = [];\n\n  constructor(options: LoggerOptions = {}) {\n    this.level = options.level ?? LogLevel.INFO;\n    this.enableColors = options.enableColors ?? true;\n    this.showTimestamp = options.showTimestamp ?? true;\n    this.showLevel = options.showLevel ?? true;\n    this.prefix = options.prefix ?? '';\n    this.enableSanitization = options.enableSanitization ?? true;\n    this.isProduction = typeof process !== 'undefined' && process.env.NODE_ENV === 'production';\n    this.format = (options as any).format ?? LogFormat.TEXT;\n    this.context = (options as any).context ?? {};\n  }\n\n  /**\n   * 设置日志级别\n   */\n  setLevel(level: LogLevel): void {\n    this.level = level;\n  }\n\n  /**\n   * 获取当前日志级别\n   */\n  getLevel(): LogLevel {\n    return this.level;\n  }\n\n  /**\n   * 格式化时间戳\n   */\n  private formatTimestamp(): string {\n    const now = new Date();\n    const year = now.getFullYear();\n    const month = String(now.getMonth() + 1).padStart(2, '0');\n    const day = String(now.getDate()).padStart(2, '0');\n    const hours = String(now.getHours()).padStart(2, '0');\n    const minutes = String(now.getMinutes()).padStart(2, '0');\n    const seconds = String(now.getSeconds()).padStart(2, '0');\n    const milliseconds = String(now.getMilliseconds()).padStart(3, '0');\n    return `${year}-${month}-${day} ${hours}:${minutes}:${seconds}.${milliseconds}`;\n  }\n\n  /**\n   * 构建日志前缀\n   */\n  private buildPrefix(logLevel: LogLevel): string {\n    const parts: string[] = [];\n\n    if (this.showTimestamp) {\n      parts.push(`[${this.formatTimestamp()}]`);\n    }\n\n    if (this.showLevel) {\n      parts.push(`[${LEVEL_LABELS[logLevel]}]`);\n    }\n\n    // 添加追踪 ID（如果存在）\n    const traceId = getCurrentTraceId();\n    if (traceId) {\n      parts.push(`[Trace:${traceId.substring(0, 8)}]`);\n    }\n\n    if (this.prefix) {\n      parts.push(`[${this.prefix}]`);\n    }\n\n    return parts.join(' ');\n  }\n\n  /**\n   * 输出日志（Node.js 环境）\n   */\n  private logNode(level: LogLevel, ...args: unknown[]): void {\n    if (level < this.level) {\n      return;\n    }\n\n    const prefix = this.buildPrefix(level);\n    const colorConfig = LEVEL_COLORS[level];\n    const reset = this.enableColors ? ANSI_COLORS.reset : '';\n\n    if (this.enableColors && colorConfig.node) {\n      console.log(`${colorConfig.node}${prefix}${reset}`, ...args);\n    } else {\n      console.log(prefix, ...args);\n    }\n  }\n\n  /**\n   * 输出日志（浏览器环境）\n   */\n  private logBrowser(level: LogLevel, ...args: unknown[]): void {\n    if (level < this.level) {\n      return;\n    }\n\n    const prefix = this.buildPrefix(level);\n    const colorConfig = LEVEL_COLORS[level];\n\n    if (this.enableColors && colorConfig.browser) {\n      console.log(`%c${prefix}`, colorConfig.browser, ...args);\n    } else {\n      console.log(prefix, ...args);\n    }\n  }\n\n  /**\n   * 脱敏处理\n   */\n  private sanitizeValue(value: unknown): unknown {\n    if (!this.enableSanitization) {\n      return value;\n    }\n\n    if (typeof value === 'string') {\n      // 检查是否包含敏感内容\n      if (SecurityUtils.containsDangerousContent(value)) {\n        return SecurityUtils.sanitizeText(value);\n      }\n      return value;\n    }\n\n    if (value && typeof value === 'object') {\n      if (Array.isArray(value)) {\n        return value.map((item) => this.sanitizeValue(item));\n      }\n\n      const sanitized: Record<string, unknown> = {};\n      for (const [key, val] of Object.entries(value)) {\n        // 检查是否为敏感字段\n        if (SecurityUtils.isSensitiveField(key)) {\n          sanitized[key] = '***';\n        } else {\n          sanitized[key] = this.sanitizeValue(val);\n        }\n      }\n      return sanitized;\n    }\n\n    return value;\n  }\n\n  /**\n   * 处理日志参数（脱敏、过滤等）\n   */\n  private processLogArgs(...args: unknown[]): unknown[] {\n    // 生产环境自动禁用 DEBUG 级别\n    if (this.isProduction && this.level === LogLevel.DEBUG) {\n      return [];\n    }\n\n    return args.map((arg) => this.sanitizeValue(arg));\n  }\n\n  /**\n   * 设置日志格式\n   */\n  setFormat(format: LogFormat): void {\n    this.format = format;\n  }\n\n  /**\n   * 设置日志上下文\n   */\n  setContext(context: LogContext): void {\n    this.context = { ...this.context, ...context };\n  }\n\n  /**\n   * 更新日志上下文\n   */\n  updateContext(context: Partial<LogContext>): void {\n    this.context = { ...this.context, ...context };\n  }\n\n  /**\n   * 获取日志上下文\n   */\n  getContext(): LogContext {\n    return { ...this.context };\n  }\n\n  /**\n   * 清除日志上下文\n   */\n  clearContext(): void {\n    this.context = {};\n  }\n\n  /**\n   * 注册日志处理器（用于日志聚合）\n   */\n  addLogHandler(handler: (entry: StructuredLogEntry) => void): () => void {\n    this.logHandlers.push(handler);\n    return () => {\n      const index = this.logHandlers.indexOf(handler);\n      if (index > -1) {\n        this.logHandlers.splice(index, 1);\n      }\n    };\n  }\n\n  /**\n   * 创建结构化日志条目\n   */\n  private createStructuredEntry(\n    level: LogLevel,\n    message: string,\n    data?: unknown\n  ): StructuredLogEntry {\n    const traceId = getCurrentTraceId();\n    const entry: StructuredLogEntry = {\n      timestamp: new Date().toISOString(),\n      level,\n      message,\n      context: {\n        ...this.context,\n        traceId: traceId || this.context.traceId,\n      },\n      source: this.prefix || 'framework',\n    };\n\n    if (data !== undefined) {\n      entry.data = this.sanitizeValue(data);\n    }\n\n    // 如果是错误，提取堆栈信息\n    if (data instanceof Error) {\n      entry.stack = data.stack;\n      entry.message = data.message || message;\n    }\n\n    return entry;\n  }\n\n  /**\n   * 输出结构化日志\n   */\n  private outputStructured(entry: StructuredLogEntry): void {\n    // 调用日志处理器\n    this.logHandlers.forEach((handler) => {\n      try {\n        handler(entry);\n      } catch (error) {\n        // 忽略处理器错误，避免循环\n      }\n    });\n\n    // 根据格式输出\n    if (this.format === LogFormat.JSON) {\n      console.log(JSON.stringify(entry));\n    } else if (this.format === LogFormat.STRUCTURED) {\n      console.log(entry);\n    } else {\n      // TEXT 格式使用原有输出方式\n      const args = entry.data !== undefined ? [entry.data] : [];\n      if (isBrowser()) {\n        this.logBrowser(entry.level, entry.message, ...args);\n      } else {\n        this.logNode(entry.level, entry.message, ...args);\n      }\n    }\n  }\n\n  /**\n   * 通用日志输出方法\n   */\n  private log(level: LogLevel, ...args: unknown[]): void {\n    if (level < this.level) {\n      return;\n    }\n\n    const processedArgs = this.processLogArgs(...args);\n    \n    // 如果处理后没有参数（被过滤），则不输出\n    if (processedArgs.length === 0) {\n      return;\n    }\n\n    // 提取消息和数据\n    const message = typeof processedArgs[0] === 'string' \n      ? processedArgs[0] \n      : 'Log message';\n    const data = processedArgs.length > 1 \n      ? processedArgs.slice(1) \n      : (typeof processedArgs[0] === 'string' ? undefined : processedArgs[0]);\n\n    // 创建结构化日志条目\n    const entry = this.createStructuredEntry(level, message, data);\n\n    // 输出日志\n    this.outputStructured(entry);\n  }\n\n  /**\n   * 输出 DEBUG 级别日志\n   */\n  debug(...args: unknown[]): void {\n    this.log(LogLevel.DEBUG, ...args);\n  }\n\n  /**\n   * 输出 INFO 级别日志\n   */\n  info(...args: unknown[]): void {\n    this.log(LogLevel.INFO, ...args);\n  }\n\n  /**\n   * 输出 WARN 级别日志\n   */\n  warn(...args: unknown[]): void {\n    this.log(LogLevel.WARN, ...args);\n  }\n\n  /**\n   * 输出 ERROR 级别日志\n   */\n  error(...args: unknown[]): void {\n    this.log(LogLevel.ERROR, ...args);\n  }\n}\n\n/**\n * 创建 Logger 实例\n */\nexport const createLogger = (options?: LoggerOptions): Logger => {\n  return new Logger(options);\n};\n\n/**\n * 默认 Logger 实例\n */\nexport const logger = createLogger();\n\n/**\n * 导出 Logger 类\n */\nexport { Logger };\n"],"names":["LogFormat","Logger","createLogger","logger","isBrowser","window","document","ANSI_COLORS","reset","bright","dim","red","green","yellow","blue","magenta","cyan","white","bgRed","bgGreen","bgYellow","bgBlue","bgMagenta","bgCyan","bgWhite","BROWSER_STYLES","debug","info","warn","error","LEVEL_COLORS","LogLevel","DEBUG","node","browser","INFO","WARN","ERROR","NONE","LEVEL_LABELS","setLevel","level","getLevel","formatTimestamp","now","Date","year","getFullYear","month","String","getMonth","padStart","day","getDate","hours","getHours","minutes","getMinutes","seconds","getSeconds","milliseconds","getMilliseconds","buildPrefix","logLevel","parts","showTimestamp","push","showLevel","traceId","getCurrentTraceId","substring","prefix","join","logNode","args","colorConfig","enableColors","console","log","logBrowser","sanitizeValue","value","enableSanitization","SecurityUtils","containsDangerousContent","sanitizeText","Array","isArray","map","item","sanitized","key","val","Object","entries","isSensitiveField","processLogArgs","isProduction","arg","setFormat","format","setContext","context","updateContext","getContext","clearContext","addLogHandler","handler","logHandlers","index","indexOf","splice","createStructuredEntry","message","data","entry","timestamp","toISOString","source","undefined","Error","stack","outputStructured","forEach","JSON","stringify","processedArgs","length","slice","options","process","env","NODE_ENV"],"mappings":"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"}

package/dist/utils/logger.d.ts

@@ -0,0 +1,190 @@
+import type { LoggerOptions } from './logger.types';
+import { LogLevel } from './logger.types';
+/**
+ * 日志格式类型
+ */
+export declare enum LogFormat {
+    /**
+     * 文本格式（默认）
+     */
+    TEXT = "text",
+    /**
+     * JSON 格式（用于日志聚合）
+     */
+    JSON = "json",
+    /**
+     * 结构化格式（用于分析）
+     */
+    STRUCTURED = "structured"
+}
+/**
+ * 日志上下文
+ */
+export interface LogContext {
+    /**
+     * 追踪 ID
+     */
+    traceId?: string;
+    /**
+     * 用户 ID
+     */
+    userId?: string;
+    /**
+     * 会话 ID
+     */
+    sessionId?: string;
+    /**
+     * 请求 ID
+     */
+    requestId?: string;
+    /**
+     * 自定义上下文
+     */
+    [key: string]: unknown;
+}
+/**
+ * 结构化日志条目
+ */
+export interface StructuredLogEntry {
+    /**
+     * 时间戳
+     */
+    timestamp: string;
+    /**
+     * 日志级别
+     */
+    level: LogLevel;
+    /**
+     * 日志消息
+     */
+    message: string;
+    /**
+     * 日志数据
+     */
+    data?: unknown;
+    /**
+     * 日志上下文
+     */
+    context?: LogContext;
+    /**
+     * 日志来源
+     */
+    source?: string;
+    /**
+     * 错误堆栈（如果是错误日志）
+     */
+    stack?: string;
+}
+/**
+ * Logger 类
+ */
+declare class Logger {
+    private level;
+    private enableColors;
+    private showTimestamp;
+    private showLevel;
+    private prefix;
+    private enableSanitization;
+    private isProduction;
+    private format;
+    private context;
+    private logHandlers;
+    constructor(options?: LoggerOptions);
+    /**
+     * 设置日志级别
+     */
+    setLevel(level: LogLevel): void;
+    /**
+     * 获取当前日志级别
+     */
+    getLevel(): LogLevel;
+    /**
+     * 格式化时间戳
+     */
+    private formatTimestamp;
+    /**
+     * 构建日志前缀
+     */
+    private buildPrefix;
+    /**
+     * 输出日志（Node.js 环境）
+     */
+    private logNode;
+    /**
+     * 输出日志（浏览器环境）
+     */
+    private logBrowser;
+    /**
+     * 脱敏处理
+     */
+    private sanitizeValue;
+    /**
+     * 处理日志参数（脱敏、过滤等）
+     */
+    private processLogArgs;
+    /**
+     * 设置日志格式
+     */
+    setFormat(format: LogFormat): void;
+    /**
+     * 设置日志上下文
+     */
+    setContext(context: LogContext): void;
+    /**
+     * 更新日志上下文
+     */
+    updateContext(context: Partial<LogContext>): void;
+    /**
+     * 获取日志上下文
+     */
+    getContext(): LogContext;
+    /**
+     * 清除日志上下文
+     */
+    clearContext(): void;
+    /**
+     * 注册日志处理器（用于日志聚合）
+     */
+    addLogHandler(handler: (entry: StructuredLogEntry) => void): () => void;
+    /**
+     * 创建结构化日志条目
+     */
+    private createStructuredEntry;
+    /**
+     * 输出结构化日志
+     */
+    private outputStructured;
+    /**
+     * 通用日志输出方法
+     */
+    private log;
+    /**
+     * 输出 DEBUG 级别日志
+     */
+    debug(...args: unknown[]): void;
+    /**
+     * 输出 INFO 级别日志
+     */
+    info(...args: unknown[]): void;
+    /**
+     * 输出 WARN 级别日志
+     */
+    warn(...args: unknown[]): void;
+    /**
+     * 输出 ERROR 级别日志
+     */
+    error(...args: unknown[]): void;
+}
+/**
+ * 创建 Logger 实例
+ */
+export declare const createLogger: (options?: LoggerOptions) => Logger;
+/**
+ * 默认 Logger 实例
+ */
+export declare const logger: Logger;
+/**
+ * 导出 Logger 类
+ */
+export { Logger };
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

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