@qimen-lab/core 0.1.1

package/dist/logger/LoggerChild.esm.js

@@ -0,0 +1,131 @@
+/**
+ * 子日志记录器类
+ *
+ * 提供针对特定类别（category）的日志记录功能。
+ * 这些实例通常通过 [Logger.for()](file://d:\Workspace\projects\QimenJs\src\utils\logger\Logger.ts#L60-L72) 方法创建，与主日志记录器关联。
+ *
+ * @example
+ * ```typescript
+ * // 获取一个子记录器
+ * const logger = Logger.for('UserService');
+ *
+ * // 记录不同级别的日志
+ * logger.debug('Debug information');
+ * logger.info('User logged in', userId);
+ * logger.warn('Unexpected input', inputData);
+ * logger.error(new Error('Something went wrong'));
+ * ```
+ */
+export class LoggerChild {
+    /**
+     * 创建一个新的子日志记录器实例
+     *
+     * @param parent - 父级日志记录器实例
+     * @param category - 日志类别名称，用于标识日志来源
+     */
+    constructor(parent, category) {
+        this.parent = parent;
+        this.category = category;
+    }
+    /**
+     * 记录指定级别的日志
+     *
+     * 这是一个内部方法，用于向父级日志记录器发送日志条目。
+     *
+     * @param level - 日志级别
+     * @param message - 日志消息主体
+     * @param data - 附加的数据参数
+     */
+    log(level, message, ...data) {
+        this.parent.emit({
+            timestamp: Date.now(),
+            level,
+            category: this.category,
+            message,
+            data,
+        });
+    }
+    /**
+     * 记录调试级别日志
+     *
+     * 用于记录调试信息，仅在日志级别设为 'debug' 或更低时才会输出。
+     *
+     * @param message - 要记录的消息
+     * @param data - 附加的数据参数
+     *
+     * @example
+     * ```typescript
+     * logger.debug('Processing user data', userData);
+     * logger.debug('Current state:', currentState);
+     * ```
+     */
+    debug(message, ...data) {
+        this.log('debug', message, ...data);
+    }
+    /**
+     * 记录信息级别日志
+     *
+     * 用于记录一般信息，默认情况下会被输出。
+     *
+     * @param message - 要记录的消息
+     * @param data - 附加的数据参数
+     *
+     * @example
+     * ```typescript
+     * logger.info('Application started');
+     * logger.info('User authenticated', userId, ipAddress);
+     * ```
+     */
+    info(message, ...data) {
+        this.log('info', message, ...data);
+    }
+    /**
+     * 记录警告级别日志
+     *
+     * 用于记录潜在的问题或不寻常但不影响程序运行的情况。
+     *
+     * @param message - 要记录的消息
+     * @param data - 附加的数据参数
+     *
+     * @example
+     * ```typescript
+     * logger.warn('Deprecated API used', apiName);
+     * logger.warn('High memory usage detected', currentUsage);
+     * ```
+     */
+    warn(message, ...data) {
+        this.log('warn', message, ...data);
+    }
+    /**
+     * 记录错误级别日志
+     *
+     * 用于记录错误信息。如果传入的是 Error 实例，会特别处理其堆栈跟踪信息。
+     *
+     * @param err - 错误对象或错误消息
+     * @param data - 附加的数据参数
+     *
+     * @example
+     * ```typescript
+     * logger.error(new Error('Database connection failed'));
+     * logger.error('Invalid user input', userInput);
+     * logger.error(new TypeError('Unexpected type'), variableValue);
+     * ```
+     */
+    error(err, ...data) {
+        if (err instanceof Error) {
+            // 对于 Error 实例，单独处理以保留错误堆栈信息
+            this.parent.emit({
+                timestamp: Date.now(),
+                level: 'error',
+                category: this.category,
+                error: err,
+                data,
+            });
+        }
+        else {
+            // 对于其他类型的错误信息，作为普通消息处理
+            this.log('error', err, ...data);
+        }
+    }
+}
+//# sourceMappingURL=LoggerChild.js.map

package/dist/logger/LoggerChild.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LoggerChild.js","sourceRoot":"","sources":["../../../src/logger/LoggerChild.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,OAAO,WAAW;IACpB;;;;;OAKG;IACH,YACqB,MAAc,EACd,QAAgB;QADhB,WAAM,GAAN,MAAM,CAAQ;QACd,aAAQ,GAAR,QAAQ,CAAQ;IAClC,CAAC;IAEJ;;;;;;;;OAQG;IACK,GAAG,CAAC,KAAe,EAAE,OAAa,EAAE,GAAG,IAAW;QACtD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;YACb,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;YACrB,KAAK;YACL,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,OAAO;YACP,IAAI;SACP,CAAC,CAAC;IACP,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,KAAK,CAAC,OAAa,EAAE,GAAG,IAAW;QAC/B,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;IACxC,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,IAAI,CAAC,OAAa,EAAE,GAAG,IAAW;QAC9B,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;IACvC,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,IAAI,CAAC,OAAa,EAAE,GAAG,IAAW;QAC9B,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;IACvC,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACH,KAAK,CAAC,GAAgB,EAAE,GAAG,IAAW;QAClC,IAAI,GAAG,YAAY,KAAK,EAAE,CAAC;YACvB,4BAA4B;YAC5B,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;gBACb,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;gBACrB,KAAK,EAAE,OAAO;gBACd,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,KAAK,EAAE,GAAG;gBACV,IAAI;aACP,CAAC,CAAC;QACP,CAAC;aAAM,CAAC;YACJ,uBAAuB;YACvB,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;QACpC,CAAC;IACL,CAAC;CACJ"}

package/dist/logger/LoggerChild.js

@@ -0,0 +1,135 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LoggerChild = void 0;
+/**
+ * 子日志记录器类
+ *
+ * 提供针对特定类别（category）的日志记录功能。
+ * 这些实例通常通过 [Logger.for()](file://d:\Workspace\projects\QimenJs\src\utils\logger\Logger.ts#L60-L72) 方法创建，与主日志记录器关联。
+ *
+ * @example
+ * ```typescript
+ * // 获取一个子记录器
+ * const logger = Logger.for('UserService');
+ *
+ * // 记录不同级别的日志
+ * logger.debug('Debug information');
+ * logger.info('User logged in', userId);
+ * logger.warn('Unexpected input', inputData);
+ * logger.error(new Error('Something went wrong'));
+ * ```
+ */
+class LoggerChild {
+    /**
+     * 创建一个新的子日志记录器实例
+     *
+     * @param parent - 父级日志记录器实例
+     * @param category - 日志类别名称，用于标识日志来源
+     */
+    constructor(parent, category) {
+        this.parent = parent;
+        this.category = category;
+    }
+    /**
+     * 记录指定级别的日志
+     *
+     * 这是一个内部方法，用于向父级日志记录器发送日志条目。
+     *
+     * @param level - 日志级别
+     * @param message - 日志消息主体
+     * @param data - 附加的数据参数
+     */
+    log(level, message, ...data) {
+        this.parent.emit({
+            timestamp: Date.now(),
+            level,
+            category: this.category,
+            message,
+            data,
+        });
+    }
+    /**
+     * 记录调试级别日志
+     *
+     * 用于记录调试信息，仅在日志级别设为 'debug' 或更低时才会输出。
+     *
+     * @param message - 要记录的消息
+     * @param data - 附加的数据参数
+     *
+     * @example
+     * ```typescript
+     * logger.debug('Processing user data', userData);
+     * logger.debug('Current state:', currentState);
+     * ```
+     */
+    debug(message, ...data) {
+        this.log('debug', message, ...data);
+    }
+    /**
+     * 记录信息级别日志
+     *
+     * 用于记录一般信息，默认情况下会被输出。
+     *
+     * @param message - 要记录的消息
+     * @param data - 附加的数据参数
+     *
+     * @example
+     * ```typescript
+     * logger.info('Application started');
+     * logger.info('User authenticated', userId, ipAddress);
+     * ```
+     */
+    info(message, ...data) {
+        this.log('info', message, ...data);
+    }
+    /**
+     * 记录警告级别日志
+     *
+     * 用于记录潜在的问题或不寻常但不影响程序运行的情况。
+     *
+     * @param message - 要记录的消息
+     * @param data - 附加的数据参数
+     *
+     * @example
+     * ```typescript
+     * logger.warn('Deprecated API used', apiName);
+     * logger.warn('High memory usage detected', currentUsage);
+     * ```
+     */
+    warn(message, ...data) {
+        this.log('warn', message, ...data);
+    }
+    /**
+     * 记录错误级别日志
+     *
+     * 用于记录错误信息。如果传入的是 Error 实例，会特别处理其堆栈跟踪信息。
+     *
+     * @param err - 错误对象或错误消息
+     * @param data - 附加的数据参数
+     *
+     * @example
+     * ```typescript
+     * logger.error(new Error('Database connection failed'));
+     * logger.error('Invalid user input', userInput);
+     * logger.error(new TypeError('Unexpected type'), variableValue);
+     * ```
+     */
+    error(err, ...data) {
+        if (err instanceof Error) {
+            // 对于 Error 实例，单独处理以保留错误堆栈信息
+            this.parent.emit({
+                timestamp: Date.now(),
+                level: 'error',
+                category: this.category,
+                error: err,
+                data,
+            });
+        }
+        else {
+            // 对于其他类型的错误信息，作为普通消息处理
+            this.log('error', err, ...data);
+        }
+    }
+}
+exports.LoggerChild = LoggerChild;
+//# sourceMappingURL=LoggerChild.js.map

package/dist/logger/LoggerChild.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LoggerChild.js","sourceRoot":"","sources":["../../../src/logger/LoggerChild.ts"],"names":[],"mappings":";;;AAIA;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAa,WAAW;IACpB;;;;;OAKG;IACH,YACqB,MAAc,EACd,QAAgB;QADhB,WAAM,GAAN,MAAM,CAAQ;QACd,aAAQ,GAAR,QAAQ,CAAQ;IAClC,CAAC;IAEJ;;;;;;;;OAQG;IACK,GAAG,CAAC,KAAe,EAAE,OAAa,EAAE,GAAG,IAAW;QACtD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;YACb,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;YACrB,KAAK;YACL,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,OAAO;YACP,IAAI;SACP,CAAC,CAAC;IACP,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,KAAK,CAAC,OAAa,EAAE,GAAG,IAAW;QAC/B,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;IACxC,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,IAAI,CAAC,OAAa,EAAE,GAAG,IAAW;QAC9B,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;IACvC,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,IAAI,CAAC,OAAa,EAAE,GAAG,IAAW;QAC9B,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;IACvC,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACH,KAAK,CAAC,GAAgB,EAAE,GAAG,IAAW;QAClC,IAAI,GAAG,YAAY,KAAK,EAAE,CAAC;YACvB,4BAA4B;YAC5B,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;gBACb,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;gBACrB,KAAK,EAAE,OAAO;gBACd,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,KAAK,EAAE,GAAG;gBACV,IAAI;aACP,CAAC,CAAC;QACP,CAAC;aAAM,CAAC;YACJ,uBAAuB;YACvB,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;QACpC,CAAC;IACL,CAAC;CACJ;AAnHD,kCAmHC"}

package/dist/logger/color.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 为日志级别添加颜色
+ * @param level - 日志级别字符串 (如 'DEBUG', 'WARN', 'ERROR')
+ * @param enable - 是否启用颜色显示
+ * @returns 如果启用了颜色，则返回带颜色的日志级别字符串；否则返回原始字符串
+ */
+export declare function colorLevel(level: string, enable: boolean): string;
+//# sourceMappingURL=color.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"color.d.ts","sourceRoot":"","sources":["../../../src/logger/color.ts"],"names":[],"mappings":"AAUA;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,UAIxD"}

package/dist/logger/color.esm.js

@@ -0,0 +1,21 @@
+// 重置颜色的ANSI转义序列
+const RESET = '\x1b[0m';
+// 定义不同日志级别的颜色映射
+const COLORS = {
+    DEBUG: '\x1b[90m', // 灰色
+    WARN: '\x1b[33m', // 黄色
+    ERROR: '\x1b[31m', // 红色
+};
+/**
+ * 为日志级别添加颜色
+ * @param level - 日志级别字符串 (如 'DEBUG', 'WARN', 'ERROR')
+ * @param enable - 是否启用颜色显示
+ * @returns 如果启用了颜色，则返回带颜色的日志级别字符串；否则返回原始字符串
+ */
+export function colorLevel(level, enable) {
+    if (!enable)
+        return level;
+    const color = COLORS[level];
+    return color ? `${color}${level}${RESET}` : level;
+}
+//# sourceMappingURL=color.js.map

package/dist/logger/color.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"color.js","sourceRoot":"","sources":["../../../src/logger/color.ts"],"names":[],"mappings":"AAAA,gBAAgB;AAChB,MAAM,KAAK,GAAG,SAAS,CAAC;AAExB,gBAAgB;AAChB,MAAM,MAAM,GAA2B;IACnC,KAAK,EAAE,UAAU,EAAE,KAAK;IACxB,IAAI,EAAE,UAAU,EAAE,KAAK;IACvB,KAAK,EAAE,UAAU,EAAE,KAAK;CAC3B,CAAC;AAEF;;;;;GAKG;AACH,MAAM,UAAU,UAAU,CAAC,KAAa,EAAE,MAAe;IACrD,IAAI,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IAC1B,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC5B,OAAO,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;AACtD,CAAC"}

package/dist/logger/color.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.colorLevel = colorLevel;
+// 重置颜色的ANSI转义序列
+const RESET = '\x1b[0m';
+// 定义不同日志级别的颜色映射
+const COLORS = {
+    DEBUG: '\x1b[90m', // 灰色
+    WARN: '\x1b[33m', // 黄色
+    ERROR: '\x1b[31m', // 红色
+};
+/**
+ * 为日志级别添加颜色
+ * @param level - 日志级别字符串 (如 'DEBUG', 'WARN', 'ERROR')
+ * @param enable - 是否启用颜色显示
+ * @returns 如果启用了颜色，则返回带颜色的日志级别字符串；否则返回原始字符串
+ */
+function colorLevel(level, enable) {
+    if (!enable)
+        return level;
+    const color = COLORS[level];
+    return color ? `${color}${level}${RESET}` : level;
+}
+//# sourceMappingURL=color.js.map

package/dist/logger/color.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"color.js","sourceRoot":"","sources":["../../../src/logger/color.ts"],"names":[],"mappings":";;AAgBA,gCAIC;AApBD,gBAAgB;AAChB,MAAM,KAAK,GAAG,SAAS,CAAC;AAExB,gBAAgB;AAChB,MAAM,MAAM,GAA2B;IACnC,KAAK,EAAE,UAAU,EAAE,KAAK;IACxB,IAAI,EAAE,UAAU,EAAE,KAAK;IACvB,KAAK,EAAE,UAAU,EAAE,KAAK;CAC3B,CAAC;AAEF;;;;;GAKG;AACH,SAAgB,UAAU,CAAC,KAAa,EAAE,MAAe;IACrD,IAAI,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IAC1B,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC5B,OAAO,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;AACtD,CAAC"}

package/dist/logger/format.d.ts

@@ -0,0 +1,22 @@
+import { LogEntry, LoggerOptions } from './types';
+/**
+ * 格式化日志条目为字符串
+ *
+ * @param entry - 要格式化的日志条目
+ * @param options - 日志记录器选项，包括是否启用颜色等
+ * @returns 格式化后的日志字符串
+ *
+ * @example
+ * ```typescript
+ * const entry: LogEntry = {
+ *   timestamp: Date.now(),
+ *   level: 'info',
+ *   category: 'App',
+ *   message: 'Application started'
+ * };
+ * const options: LoggerOptions = { color: true };
+ * const formatted = format(entry, options);
+ * ```
+ */
+export declare function format(entry: LogEntry, options: LoggerOptions): string;
+//# sourceMappingURL=format.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../../src/logger/format.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAGlD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,aAAa,GAAG,MAAM,CA2BtE"}

package/dist/logger/format.esm.js

@@ -0,0 +1,43 @@
+import { colorLevel } from './color';
+/**
+ * 格式化日志条目为字符串
+ *
+ * @param entry - 要格式化的日志条目
+ * @param options - 日志记录器选项，包括是否启用颜色等
+ * @returns 格式化后的日志字符串
+ *
+ * @example
+ * ```typescript
+ * const entry: LogEntry = {
+ *   timestamp: Date.now(),
+ *   level: 'info',
+ *   category: 'App',
+ *   message: 'Application started'
+ * };
+ * const options: LoggerOptions = { color: true };
+ * const formatted = format(entry, options);
+ * ```
+ */
+export function format(entry, options) {
+    var _a;
+    // 将时间戳转换为 ISO 格式的字符串
+    const time = new Date(entry.timestamp).toISOString();
+    // 获取并填充日志级别的原始文本（用于无颜色模式）
+    const rawLevel = entry.level.toUpperCase();
+    // 根据选项决定是否对日志级别着色，并保持固定宽度
+    const coloredOrRawLevel = colorLevel(rawLevel, !!options.color);
+    const level = coloredOrRawLevel.padEnd(coloredOrRawLevel.length + Math.max(0, 5 - rawLevel.length));
+    // 如果存在分类，则填充到固定宽度，否则为空字符串
+    const category = entry.category ? entry.category.padEnd(16) : '';
+    // 处理消息内容：如果是错误对象则显示堆栈或消息，否则转换为字符串
+    let message = '';
+    if (entry.error instanceof Error) {
+        message = entry.error.stack || entry.error.message;
+    }
+    else {
+        message = String((_a = entry.message) !== null && _a !== void 0 ? _a : '');
+    }
+    // 组合并返回格式化的日志字符串
+    return `${time} ${level} ${category} ${message}`;
+}
+//# sourceMappingURL=format.js.map

package/dist/logger/format.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../../../src/logger/format.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAErC;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,MAAM,CAAC,KAAe,EAAE,OAAsB;;IAC1D,qBAAqB;IACrB,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE,CAAC;IAErD,0BAA0B;IAC1B,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;IAE3C,0BAA0B;IAC1B,MAAM,iBAAiB,GAAG,UAAU,CAAC,QAAQ,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAEhE,MAAM,KAAK,GAAG,iBAAiB,CAAC,MAAM,CAClC,iBAAiB,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC,CAC9D,CAAC;IAEF,0BAA0B;IAC1B,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAEjE,kCAAkC;IAClC,IAAI,OAAO,GAAG,EAAE,CAAC;IACjB,IAAI,KAAK,CAAC,KAAK,YAAY,KAAK,EAAE,CAAC;QAC/B,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC;IACvD,CAAC;SAAM,CAAC;QACJ,OAAO,GAAG,MAAM,CAAC,MAAA,KAAK,CAAC,OAAO,mCAAI,EAAE,CAAC,CAAC;IAC1C,CAAC;IAED,iBAAiB;IACjB,OAAO,GAAG,IAAI,IAAI,KAAK,IAAI,QAAQ,IAAI,OAAO,EAAE,CAAC;AACrD,CAAC"}

package/dist/logger/format.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.format = format;
+const color_1 = require("./color");
+/**
+ * 格式化日志条目为字符串
+ *
+ * @param entry - 要格式化的日志条目
+ * @param options - 日志记录器选项，包括是否启用颜色等
+ * @returns 格式化后的日志字符串
+ *
+ * @example
+ * ```typescript
+ * const entry: LogEntry = {
+ *   timestamp: Date.now(),
+ *   level: 'info',
+ *   category: 'App',
+ *   message: 'Application started'
+ * };
+ * const options: LoggerOptions = { color: true };
+ * const formatted = format(entry, options);
+ * ```
+ */
+function format(entry, options) {
+    var _a;
+    // 将时间戳转换为 ISO 格式的字符串
+    const time = new Date(entry.timestamp).toISOString();
+    // 获取并填充日志级别的原始文本（用于无颜色模式）
+    const rawLevel = entry.level.toUpperCase();
+    // 根据选项决定是否对日志级别着色，并保持固定宽度
+    const coloredOrRawLevel = (0, color_1.colorLevel)(rawLevel, !!options.color);
+    const level = coloredOrRawLevel.padEnd(coloredOrRawLevel.length + Math.max(0, 5 - rawLevel.length));
+    // 如果存在分类，则填充到固定宽度，否则为空字符串
+    const category = entry.category ? entry.category.padEnd(16) : '';
+    // 处理消息内容：如果是错误对象则显示堆栈或消息，否则转换为字符串
+    let message = '';
+    if (entry.error instanceof Error) {
+        message = entry.error.stack || entry.error.message;
+    }
+    else {
+        message = String((_a = entry.message) !== null && _a !== void 0 ? _a : '');
+    }
+    // 组合并返回格式化的日志字符串
+    return `${time} ${level} ${category} ${message}`;
+}
+//# sourceMappingURL=format.js.map

package/dist/logger/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../../../src/logger/format.ts"],"names":[],"mappings":";;AAsBA,wBA2BC;AAhDD,mCAAqC;AAErC;;;;;;;;;;;;;;;;;;GAkBG;AACH,SAAgB,MAAM,CAAC,KAAe,EAAE,OAAsB;;IAC1D,qBAAqB;IACrB,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE,CAAC;IAErD,0BAA0B;IAC1B,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;IAE3C,0BAA0B;IAC1B,MAAM,iBAAiB,GAAG,IAAA,kBAAU,EAAC,QAAQ,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAEhE,MAAM,KAAK,GAAG,iBAAiB,CAAC,MAAM,CAClC,iBAAiB,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC,CAC9D,CAAC;IAEF,0BAA0B;IAC1B,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAEjE,kCAAkC;IAClC,IAAI,OAAO,GAAG,EAAE,CAAC;IACjB,IAAI,KAAK,CAAC,KAAK,YAAY,KAAK,EAAE,CAAC;QAC/B,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC;IACvD,CAAC;SAAM,CAAC;QACJ,OAAO,GAAG,MAAM,CAAC,MAAA,KAAK,CAAC,OAAO,mCAAI,EAAE,CAAC,CAAC;IAC1C,CAAC;IAED,iBAAiB;IACjB,OAAO,GAAG,IAAI,IAAI,KAAK,IAAI,QAAQ,IAAI,OAAO,EAAE,CAAC;AACrD,CAAC"}

package/dist/logger/index.d.ts

@@ -0,0 +1,4 @@
+import { Logger } from './Logger';
+import type { LoggerOptions, ILogger, LogLevel } from './types';
+export { Logger, LoggerOptions, ILogger, LogLevel };
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/logger/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAEhE,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC"}

package/dist/logger/index.esm.js

@@ -0,0 +1,3 @@
+import { Logger } from './Logger';
+export { Logger };
+//# sourceMappingURL=index.js.map

package/dist/logger/index.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/logger/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAGlC,OAAO,EAAE,MAAM,EAAoC,CAAC"}

package/dist/logger/index.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Logger = void 0;
+const Logger_1 = require("./Logger");
+Object.defineProperty(exports, "Logger", { enumerable: true, get: function () { return Logger_1.Logger; } });
+//# sourceMappingURL=index.js.map

package/dist/logger/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/logger/index.ts"],"names":[],"mappings":";;;AAAA,qCAAkC;AAGzB,uFAHA,eAAM,OAGA"}

package/dist/logger/package.json

@@ -0,0 +1,15 @@
+{
+  "name": "@qimen-lab/logger",
+  "version": "0.1.1",
+  "main": "index.js",
+  "module": "index.esm.js",
+  "types": "index.d.ts",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "import": "./index.esm.js",
+      "require": "./index.js",
+      "types": "./index.d.ts"
+    }
+  }
+}

package/dist/logger/sinks/console.d.ts

@@ -0,0 +1,23 @@
+/**
+ * 控制台日志输出处理器
+ *
+ * 根据日志级别将格式化后的日志文本输出到相应的控制台方法。
+ * 不同的日志级别会使用不同的控制台方法以提供视觉区分和过滤能力。
+ *
+ * @param text - 已格式化的日志文本
+ * @param level - 日志级别，用于确定使用哪种控制台方法
+ *
+ * @example
+ * ```typescript
+ * // 输出错误日志到 console.error
+ * consoleSink('2023-01-01T12:00:00.000Z ERROR Some error occurred', 'error');
+ *
+ * // 输出警告日志到 console.warn
+ * consoleSink('2023-01-01T12:00:00.000Z WARN  Something unexpected', 'warn');
+ *
+ * // 输出信息或调试日志到 console.log
+ * consoleSink('2023-01-01T12:00:00.000Z INFO  Application started', 'info');
+ * ```
+ */
+export declare function consoleSink(text: string, level: string): void;
+//# sourceMappingURL=console.d.ts.map

package/dist/logger/sinks/console.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"console.d.ts","sourceRoot":"","sources":["../../../../src/logger/sinks/console.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,QAYtD"}

package/dist/logger/sinks/console.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.consoleSink = consoleSink;
+/**
+ * 控制台日志输出处理器
+ *
+ * 根据日志级别将格式化后的日志文本输出到相应的控制台方法。
+ * 不同的日志级别会使用不同的控制台方法以提供视觉区分和过滤能力。
+ *
+ * @param text - 已格式化的日志文本
+ * @param level - 日志级别，用于确定使用哪种控制台方法
+ *
+ * @example
+ * ```typescript
+ * // 输出错误日志到 console.error
+ * consoleSink('2023-01-01T12:00:00.000Z ERROR Some error occurred', 'error');
+ *
+ * // 输出警告日志到 console.warn
+ * consoleSink('2023-01-01T12:00:00.000Z WARN  Something unexpected', 'warn');
+ *
+ * // 输出信息或调试日志到 console.log
+ * consoleSink('2023-01-01T12:00:00.000Z INFO  Application started', 'info');
+ * ```
+ */
+function consoleSink(text, level) {
+    // 根据日志级别选择适当的控制台方法
+    if (level === 'error') {
+        // 错误级别日志使用 console.error 输出
+        console.error(text);
+    }
+    else if (level === 'warn') {
+        // 警告级别日志使用 console.warn 输出
+        console.warn(text);
+    }
+    else {
+        // 其他级别（info/debug）使用 console.log 输出
+        console.log(text);
+    }
+}
+//# sourceMappingURL=console.js.map

package/dist/logger/sinks/console.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"console.js","sourceRoot":"","sources":["../../../../src/logger/sinks/console.ts"],"names":[],"mappings":";;AAqBA,kCAYC;AAjCD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,SAAgB,WAAW,CAAC,IAAY,EAAE,KAAa;IACnD,mBAAmB;IACnB,IAAI,KAAK,KAAK,OAAO,EAAE,CAAC;QACpB,4BAA4B;QAC5B,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACxB,CAAC;SAAM,IAAI,KAAK,KAAK,MAAM,EAAE,CAAC;QAC1B,2BAA2B;QAC3B,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACvB,CAAC;SAAM,CAAC;QACJ,oCAAoC;QACpC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACtB,CAAC;AACL,CAAC"}