@chaeco/logger 0.1.7

package/dist/file/node-writer.js

@@ -0,0 +1,219 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NodeWriter = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const zlib = __importStar(require("zlib"));
+const util_1 = require("util");
+const dayjs_1 = __importDefault(require("dayjs"));
+const gzip = (0, util_1.promisify)(zlib.gzip);
+const readFile = (0, util_1.promisify)(fs.readFile);
+const writeFile = (0, util_1.promisify)(fs.writeFile);
+const unlink = (0, util_1.promisify)(fs.unlink);
+/**
+ * Node.js 文件写入器 - 管理日志文件的创建、轮转、压缩与清理。
+ * @internal
+ */
+class NodeWriter {
+    /** 初始化错误（只读），如果初始化失败则值不为 undefined */
+    get initError() { return this._initError; }
+    constructor(options) {
+        this.currentFilePath = '';
+        this.currentFileSize = 0;
+        this.fileIndex = 0;
+        this.options = {
+            ...options,
+            // 清理文件名中的路径分隔符，防止目录穿越攻击（如 filename: '../../etc/passwd'）
+            filename: options.filename.replace(/[/\\]/g, '_'),
+        };
+    }
+    init() {
+        this.ensureLogDirectory();
+        this.initializeCurrentFile();
+    }
+    /** 写入单条消息（内部使用 appendFileSync，通过重试逻辑提供可靠性） */
+    async write(message) {
+        this.checkDateRotation();
+        if (this.shouldRotateFile())
+            this.rotateFile();
+        const content = message + '\n';
+        await this.appendToFileWithRetry(content);
+        this.currentFileSize += Buffer.byteLength(content, 'utf8');
+    }
+    /** 批量写入消息（由 AsyncQueue 刷新时调用） */
+    async writeBatch(messages) {
+        this.checkDateRotation();
+        const content = messages.join('\n') + '\n';
+        if (this.shouldRotateFile())
+            this.rotateFile();
+        await this.appendToFileWithRetry(content);
+        this.currentFileSize += Buffer.byteLength(content, 'utf8');
+    }
+    // ─── 私有方法 ────────────────────────────────────────────
+    ensureLogDirectory() {
+        try {
+            if (!fs.existsSync(this.options.path)) {
+                fs.mkdirSync(this.options.path, { recursive: true, mode: 0o755 });
+            }
+        }
+        catch (e) {
+            this._initError = e instanceof Error ? e : new Error(String(e));
+            console.warn(`@chaeco/logger: Failed to create log directory "${this.options.path}":`, this._initError.message);
+        }
+    }
+    initializeCurrentFile() {
+        try {
+            this.fileIndex = 0;
+            // 上界取 maxFiles 的两倍（最少 100），避免目录中存在大量文件时无限扫描
+            const maxIndex = Math.max(this.options.maxFiles * 2, 100);
+            while (this.fileIndex < maxIndex && fs.existsSync(this.getIndexedFilePath())) {
+                this.fileIndex++;
+            }
+            if (this.fileIndex > 0) {
+                this.fileIndex--;
+                this.currentFilePath = this.getIndexedFilePath();
+                this.currentFileSize = fs.statSync(this.currentFilePath).size;
+                if (this.shouldRotateFile()) {
+                    this.fileIndex++;
+                    this.currentFilePath = this.getIndexedFilePath();
+                    this.currentFileSize = 0;
+                }
+            }
+            else {
+                this.currentFilePath = this.getIndexedFilePath();
+                this.currentFileSize = 0;
+            }
+        }
+        catch (e) {
+            this._initError = e instanceof Error ? e : new Error(String(e));
+            console.warn('@chaeco/logger: Failed to initialize current file:', this._initError.message);
+        }
+    }
+    getIndexedFilePath() {
+        const today = (0, dayjs_1.default)().format('YYYY-MM-DD');
+        const base = `${this.options.filename}-${today}`;
+        return this.fileIndex === 0
+            ? path.join(this.options.path, `${base}.log`)
+            : path.join(this.options.path, `${base}.${this.fileIndex}.log`);
+    }
+    shouldRotateFile() {
+        return this.currentFileSize >= this.options.maxSize;
+    }
+    rotateFile() {
+        this.fileIndex++;
+        this.currentFilePath = this.getIndexedFilePath();
+        this.currentFileSize = 0;
+        this.cleanupOldFiles();
+    }
+    cleanupOldFiles() {
+        try {
+            const files = fs.readdirSync(this.options.path)
+                .filter(f => f.startsWith(this.options.filename) && (f.endsWith('.log') || f.endsWith('.log.gz')))
+                .map(f => {
+                const stats = fs.statSync(path.join(this.options.path, f));
+                // 优先使用文件名中的日期，避免 mtime 因压缩操作被刷新为近期时间
+                const fileDate = f.match(/(\d{4}-\d{2}-\d{2})/)?.[1] ?? null;
+                const sortKey = fileDate ? new Date(fileDate).getTime() : stats.mtime.getTime();
+                return { name: f, path: path.join(this.options.path, f), stats, fileDate, sortKey };
+            })
+                // 按日期降序（最新在前）；用文件名日期而非 mtime 排序，防止旧压缩日志因近期 mtime 排在前
+                .sort((a, b) => b.sortKey - a.sortKey);
+            // 超出 maxFiles 的文件：先收集待删集合，避免与过期清理产生重复 unlinkSync 调用
+            const toDelete = new Set();
+            if (files.length > this.options.maxFiles)
+                files.slice(this.options.maxFiles).forEach(f => toDelete.add(f.path));
+            const maxAgeMs = this.options.maxAge * 24 * 60 * 60 * 1000;
+            files.forEach(f => {
+                // 同 compressOldLogs：用文件名日期判断过期，而非 mtime。
+                // .log.gz 的 mtime 是压缩时间（近期），用 mtime 会使旧日志看起来永远"新"。
+                const ageBasis = f.fileDate ? new Date(f.fileDate).getTime() : f.stats.mtime.getTime();
+                if (Date.now() - ageBasis > maxAgeMs)
+                    toDelete.add(f.path);
+            });
+            toDelete.forEach(p => { try {
+                fs.unlinkSync(p);
+            }
+            catch { /* ignore */ } });
+            if (this.options.compress)
+                this.compressOldLogs().catch(() => { });
+        }
+        catch { /* ignore cleanup errors */ }
+    }
+    async compressOldLogs() {
+        const today = (0, dayjs_1.default)().format('YYYY-MM-DD');
+        try {
+            const files = fs.readdirSync(this.options.path)
+                .filter(f => f.startsWith(this.options.filename) && f.endsWith('.log') && !f.endsWith('.log.gz'))
+                .map(f => ({ name: f, path: path.join(this.options.path, f) }));
+            for (const file of files) {
+                const dateMatch = file.name.match(/(\d{4}-\d{2}-\d{2})/);
+                const fileDate = dateMatch?.[1];
+                // 仅压缩文件名日期不是今天的文件，并排除当前写入文件。
+                // 不依赖 mtime：跨午夜写入的昨日文件 mtime < 24h 会导致 mtime 条件失效。
+                if (fileDate && fileDate !== today && file.path !== this.currentFilePath) {
+                    try {
+                        const compressed = await gzip(await readFile(file.path));
+                        await writeFile(file.path + '.gz', compressed);
+                        await unlink(file.path);
+                    }
+                    catch { /* compress fails silently */ }
+                }
+            }
+        }
+        catch { /* ignore */ }
+    }
+    checkDateRotation() {
+        const today = (0, dayjs_1.default)().format('YYYY-MM-DD');
+        const m = path.basename(this.currentFilePath).match(/(\d{4}-\d{2}-\d{2})/);
+        if ((m?.[1] ?? null) !== today)
+            this.initializeCurrentFile();
+    }
+    async appendToFileWithRetry(content) {
+        const { retryCount, retryDelay } = this.options;
+        let lastError;
+        for (let i = 0; i <= retryCount; i++) {
+            try {
+                if (i > 0)
+                    await new Promise(r => setTimeout(r, retryDelay * i));
+                this.ensureLogDirectory();
+                fs.appendFileSync(this.currentFilePath, content, { mode: 0o644 });
+                return;
+            }
+            catch (e) {
+                lastError = e instanceof Error ? e : new Error(String(e));
+                if (i === 0)
+                    this.initializeCurrentFile();
+            }
+        }
+        console.error(`Failed to write log after ${retryCount + 1} attempts:`, lastError);
+        throw lastError;
+    }
+}
+exports.NodeWriter = NodeWriter;
+//# sourceMappingURL=node-writer.js.map

package/dist/file/node-writer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-writer.js","sourceRoot":"","sources":["../../src/file/node-writer.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,uCAAwB;AACxB,2CAA4B;AAC5B,2CAA4B;AAC5B,+BAAgC;AAChC,kDAAyB;AAGzB,MAAM,IAAI,GAAG,IAAA,gBAAS,EAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACjC,MAAM,QAAQ,GAAG,IAAA,gBAAS,EAAC,EAAE,CAAC,QAAQ,CAAC,CAAA;AACvC,MAAM,SAAS,GAAG,IAAA,gBAAS,EAAC,EAAE,CAAC,SAAS,CAAC,CAAA;AACzC,MAAM,MAAM,GAAG,IAAA,gBAAS,EAAC,EAAE,CAAC,MAAM,CAAC,CAAA;AAEnC;;;GAGG;AACH,MAAa,UAAU;IAOrB,sCAAsC;IACtC,IAAI,SAAS,KAAwB,OAAO,IAAI,CAAC,UAAU,CAAA,CAAC,CAAC;IAE7D,YAAY,OAA8B;QARlC,oBAAe,GAAG,EAAE,CAAA;QACpB,oBAAe,GAAG,CAAC,CAAA;QACnB,cAAS,GAAG,CAAC,CAAA;QAOnB,IAAI,CAAC,OAAO,GAAG;YACb,GAAG,OAAO;YACV,wDAAwD;YACxD,QAAQ,EAAE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC;SAClD,CAAA;IACH,CAAC;IAED,IAAI;QACF,IAAI,CAAC,kBAAkB,EAAE,CAAA;QACzB,IAAI,CAAC,qBAAqB,EAAE,CAAA;IAC9B,CAAC;IAED,8CAA8C;IAC9C,KAAK,CAAC,KAAK,CAAC,OAAe;QACzB,IAAI,CAAC,iBAAiB,EAAE,CAAA;QACxB,IAAI,IAAI,CAAC,gBAAgB,EAAE;YAAE,IAAI,CAAC,UAAU,EAAE,CAAA;QAC9C,MAAM,OAAO,GAAG,OAAO,GAAG,IAAI,CAAA;QAC9B,MAAM,IAAI,CAAC,qBAAqB,CAAC,OAAO,CAAC,CAAA;QACzC,IAAI,CAAC,eAAe,IAAI,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC,CAAA;IAC5D,CAAC;IAED,iCAAiC;IACjC,KAAK,CAAC,UAAU,CAAC,QAAkB;QACjC,IAAI,CAAC,iBAAiB,EAAE,CAAA;QACxB,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;QAC1C,IAAI,IAAI,CAAC,gBAAgB,EAAE;YAAE,IAAI,CAAC,UAAU,EAAE,CAAA;QAC9C,MAAM,IAAI,CAAC,qBAAqB,CAAC,OAAO,CAAC,CAAA;QACzC,IAAI,CAAC,eAAe,IAAI,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC,CAAA;IAC5D,CAAC;IAED,wDAAwD;IAEhD,kBAAkB;QACxB,IAAI,CAAC;YACH,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;gBACtC,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAA;YACnE,CAAC;QACH,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,IAAI,CAAC,UAAU,GAAG,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAA;YAC/D,OAAO,CAAC,IAAI,CAAC,mDAAmD,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAA;QACjH,CAAC;IACH,CAAC;IAEO,qBAAqB;QAC3B,IAAI,CAAC;YACH,IAAI,CAAC,SAAS,GAAG,CAAC,CAAA;YAClB,4CAA4C;YAC5C,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,GAAG,CAAC,EAAE,GAAG,CAAC,CAAA;YACzD,OAAO,IAAI,CAAC,SAAS,GAAG,QAAQ,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,kBAAkB,EAAE,CAAC,EAAE,CAAC;gBAC7E,IAAI,CAAC,SAAS,EAAE,CAAA;YAClB,CAAC;YACD,IAAI,IAAI,CAAC,SAAS,GAAG,CAAC,EAAE,CAAC;gBACvB,IAAI,CAAC,SAAS,EAAE,CAAA;gBAChB,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC,kBAAkB,EAAE,CAAA;gBAChD,IAAI,CAAC,eAAe,GAAG,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,IAAI,CAAA;gBAC7D,IAAI,IAAI,CAAC,gBAAgB,EAAE,EAAE,CAAC;oBAC5B,IAAI,CAAC,SAAS,EAAE,CAAA;oBAChB,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC,kBAAkB,EAAE,CAAA;oBAChD,IAAI,CAAC,eAAe,GAAG,CAAC,CAAA;gBAC1B,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC,kBAAkB,EAAE,CAAA;gBAChD,IAAI,CAAC,eAAe,GAAG,CAAC,CAAA;YAC1B,CAAC;QACH,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,IAAI,CAAC,UAAU,GAAG,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAA;YAC/D,OAAO,CAAC,IAAI,CAAC,oDAAoD,EAAE,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAA;QAC7F,CAAC;IACH,CAAC;IAEO,kBAAkB;QACxB,MAAM,KAAK,GAAG,IAAA,eAAK,GAAE,CAAC,MAAM,CAAC,YAAY,CAAC,CAAA;QAC1C,MAAM,IAAI,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,IAAI,KAAK,EAAE,CAAA;QAChD,OAAO,IAAI,CAAC,SAAS,KAAK,CAAC;YACzB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,IAAI,MAAM,CAAC;YAC7C,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,IAAI,IAAI,IAAI,CAAC,SAAS,MAAM,CAAC,CAAA;IACnE,CAAC;IAEO,gBAAgB;QACtB,OAAO,IAAI,CAAC,eAAe,IAAI,IAAI,CAAC,OAAO,CAAC,OAAO,CAAA;IACrD,CAAC;IAEO,UAAU;QAChB,IAAI,CAAC,SAAS,EAAE,CAAA;QAChB,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC,kBAAkB,EAAE,CAAA;QAChD,IAAI,CAAC,eAAe,GAAG,CAAC,CAAA;QACxB,IAAI,CAAC,eAAe,EAAE,CAAA;IACxB,CAAC;IAEO,eAAe;QACrB,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;iBAC5C,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC;iBACjG,GAAG,CAAC,CAAC,CAAC,EAAE;gBACP,MAAM,KAAK,GAAG,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAA;gBAC1D,qCAAqC;gBACrC,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,qBAAqB,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAA;gBAC5D,MAAM,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,CAAA;gBAC/E,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAA;YACrF,CAAC,CAAC;gBACF,qDAAqD;iBACpD,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO,CAAC,CAAA;YAExC,oDAAoD;YACpD,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAU,CAAA;YAClC,IAAI,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ;gBACtC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAA;YAEvE,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAA;YAC1D,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE;gBAChB,yCAAyC;gBACzC,mDAAmD;gBACnD,MAAM,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,CAAA;gBACtF,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,GAAG,QAAQ;oBAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAA;YAC5D,CAAC,CAAC,CAAA;YAEF,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC;gBAAC,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,CAAA;YAAC,CAAC;YAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;YAE1E,IAAI,IAAI,CAAC,OAAO,CAAC,QAAQ;gBAAE,IAAI,CAAC,eAAe,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAgB,CAAC,CAAC,CAAA;QACjF,CAAC;QAAC,MAAM,CAAC,CAAC,2BAA2B,CAAC,CAAC;IACzC,CAAC;IAEO,KAAK,CAAC,eAAe;QAC3B,MAAM,KAAK,GAAG,IAAA,eAAK,GAAE,CAAC,MAAM,CAAC,YAAY,CAAC,CAAA;QAC1C,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;iBAC5C,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;iBAChG,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;YAEjE,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAA;gBACxD,MAAM,QAAQ,GAAG,SAAS,EAAE,CAAC,CAAC,CAAC,CAAA;gBAC/B,6BAA6B;gBAC7B,mDAAmD;gBACnD,IAAI,QAAQ,IAAI,QAAQ,KAAK,KAAK,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,eAAe,EAAE,CAAC;oBACzE,IAAI,CAAC;wBACH,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,MAAM,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAA;wBACxD,MAAM,SAAS,CAAC,IAAI,CAAC,IAAI,GAAG,KAAK,EAAE,UAAU,CAAC,CAAA;wBAC9C,MAAM,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;oBACzB,CAAC;oBAAC,MAAM,CAAC,CAAC,6BAA6B,CAAC,CAAC;gBAC3C,CAAC;YACH,CAAC;QACH,CAAC;QAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;IAC1B,CAAC;IAEO,iBAAiB;QACvB,MAAM,KAAK,GAAG,IAAA,eAAK,GAAE,CAAC,MAAM,CAAC,YAAY,CAAC,CAAA;QAC1C,MAAM,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAA;QAC1E,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,KAAK,KAAK;YAAE,IAAI,CAAC,qBAAqB,EAAE,CAAA;IAC9D,CAAC;IAEO,KAAK,CAAC,qBAAqB,CAAC,OAAe;QACjD,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC,OAAO,CAAA;QAC/C,IAAI,SAA4B,CAAA;QAChC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,UAAU,EAAE,CAAC,EAAE,EAAE,CAAC;YACrC,IAAI,CAAC;gBACH,IAAI,CAAC,GAAG,CAAC;oBAAE,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,UAAU,GAAG,CAAC,CAAC,CAAC,CAAA;gBAChE,IAAI,CAAC,kBAAkB,EAAE,CAAA;gBACzB,EAAE,CAAC,cAAc,CAAC,IAAI,CAAC,eAAe,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAA;gBACjE,OAAM;YACR,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,SAAS,GAAG,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAA;gBACzD,IAAI,CAAC,KAAK,CAAC;oBAAE,IAAI,CAAC,qBAAqB,EAAE,CAAA;YAC3C,CAAC;QACH,CAAC;QACD,OAAO,CAAC,KAAK,CAAC,6BAA6B,UAAU,GAAG,CAAC,YAAY,EAAE,SAAS,CAAC,CAAA;QACjF,MAAM,SAAS,CAAA;IACjB,CAAC;CACF;AAnLD,gCAmLC"}

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @chaeco/logger - 功能完整的日志模块
+ *
+ * @remarks
+ * 仅支持 Node.js 运行时，提供多级别日志、彩色控制台输出、文件写入和错误事件处理等功能。
+ *
+ * @packageDocumentation
+ */
+import { Logger } from './core/logger';
+export { Logger };
+/**
+ * 默认 Logger 实例（name: 'app'，level: 'info'，写入 ./logs）
+ */
+export declare const logger: Logger;
+export type { LogLevel, LoggerOptions, FileOptions, ConsoleOptions, LogEntry, LoggerEventType, LoggerEventHandler, LoggerEvent, FormatOptions, AsyncWriteOptions, ErrorHandlingOptions, } from './core/types';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AACtC,OAAO,EAAE,MAAM,EAAE,CAAA;AAEjB;;GAEG;AACH,eAAO,MAAM,MAAM,QAIjB,CAAA;AAEF,YAAY,EACV,QAAQ,EACR,aAAa,EACb,WAAW,EACX,cAAc,EACd,QAAQ,EACR,eAAe,EACf,kBAAkB,EAClB,WAAW,EACX,aAAa,EACb,iBAAiB,EACjB,oBAAoB,GACrB,MAAM,cAAc,CAAA"}

package/dist/index.js

@@ -0,0 +1,22 @@
+"use strict";
+/**
+ * @chaeco/logger - 功能完整的日志模块
+ *
+ * @remarks
+ * 仅支持 Node.js 运行时，提供多级别日志、彩色控制台输出、文件写入和错误事件处理等功能。
+ *
+ * @packageDocumentation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.logger = exports.Logger = void 0;
+const logger_1 = require("./core/logger");
+Object.defineProperty(exports, "Logger", { enumerable: true, get: function () { return logger_1.Logger; } });
+/**
+ * 默认 Logger 实例（name: 'app'，level: 'info'，写入 ./logs）
+ */
+exports.logger = new logger_1.Logger({
+    name: 'app',
+    file: { enabled: true, path: './logs', maxSize: 10 * 1024 * 1024, maxFiles: 30 },
+    console: { enabled: true, colors: true, timestamp: true },
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;AAEH,0CAAsC;AAC7B,uFADA,eAAM,OACA;AAEf;;GAEG;AACU,QAAA,MAAM,GAAG,IAAI,eAAM,CAAC;IAC/B,IAAI,EAAE,KAAK;IACX,IAAI,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,GAAG,IAAI,GAAG,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE;IAChF,OAAO,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE;CAC1D,CAAC,CAAA"}

package/dist/utils/caller-info.d.ts

@@ -0,0 +1,29 @@
+/**
+ * 调用栈解析工具
+ * @internal
+ * 负责从 Error 堆栈中提取调用日志方法的文件路径和行号，并带 LRU 缓存。
+ */
+export declare class CallerInfoHelper {
+    private readonly cache;
+    private readonly maxCacheSize;
+    constructor(maxCacheSize?: number);
+    /**
+     * 获取当前调用者的文件路径和行号
+     */
+    getCallerInfo(): {
+        file?: string;
+        line?: number;
+    };
+    /** 清除缓存 */
+    clearCache(): void;
+    /** 获取缓存大小（调试用） */
+    getCacheSize(): number;
+    /**
+     * 53 位非加密哈希（双 32 位混合），碰撞概率约为 32 位哈希的 1/20亿。
+     * 参考：https://stackoverflow.com/a/52171480
+     */
+    private simpleHash;
+    /** LRU 缓存写入：满时淘汰最旧项 */
+    private cacheResult;
+}
+//# sourceMappingURL=caller-info.d.ts.map

package/dist/utils/caller-info.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"caller-info.d.ts","sourceRoot":"","sources":["../../src/utils/caller-info.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA2D;IACjF,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAQ;gBAEzB,YAAY,SAAO;IAI/B;;OAEG;IACH,aAAa,IAAI;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE;IA8EjD,WAAW;IACX,UAAU,IAAI,IAAI;IAIlB,kBAAkB;IAClB,YAAY,IAAI,MAAM;IAMtB;;;OAGG;IACH,OAAO,CAAC,UAAU;IAclB,uBAAuB;IACvB,OAAO,CAAC,WAAW;CASpB"}

package/dist/utils/caller-info.js

@@ -0,0 +1,120 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CallerInfoHelper = void 0;
+/**
+ * 调用栈解析工具
+ * @internal
+ * 负责从 Error 堆栈中提取调用日志方法的文件路径和行号，并带 LRU 缓存。
+ */
+class CallerInfoHelper {
+    constructor(maxCacheSize = 1000) {
+        this.cache = new Map();
+        this.maxCacheSize = maxCacheSize;
+    }
+    /**
+     * 获取当前调用者的文件路径和行号
+     */
+    getCallerInfo() {
+        const error = new Error();
+        const stack = error.stack;
+        if (!stack)
+            return {};
+        // 尝试从缓存获取（使用堆栈的哈希作为键）
+        const stackHash = this.simpleHash(stack);
+        if (this.cache.has(stackHash)) {
+            // Map.has() 已确认键存在，get() 不会返回 undefined
+            return this.cache.get(stackHash);
+        }
+        // 解析堆栈信息
+        const stackLines = stack.split('\n');
+        for (let i = 0; i < stackLines.length; i++) {
+            const line = stackLines[i]?.trim();
+            if (!line)
+                continue;
+            // 跳过 Error 本身的行（V8 堆栈首行）
+            if (line.startsWith('Error'))
+                continue;
+            // 跳过所有 logger 内部帧，包括：
+            //   CallerInfoHelper.getCallerInfo  → 当前函数
+            //   Logger.createLogEntry           → 内部调用 getCallerInfo 的方法
+            //   Logger.log / .debug / .info …  → 公开日志方法
+            if (line.includes('Logger.log') ||
+                line.includes('Logger.info') ||
+                line.includes('Logger.warn') ||
+                line.includes('Logger.error') ||
+                line.includes('Logger.debug') ||
+                line.includes('Logger.createLogEntry') ||
+                line.includes('getCallerInfo') ||
+                line.includes('CallerInfoHelper')) {
+                continue;
+            }
+            // 匹配文件路径和行号
+            const match = line.match(/\((.+?):(\d+):\d+\)$/) || line.match(/at (.+?):(\d+):\d+$/);
+            if (match && match[1] && match[2]) {
+                const filePath = match[1];
+                const lineNumber = parseInt(match[2], 10);
+                // 排除 Node.js 内部文件和 logger 模块文件
+                if (filePath &&
+                    !filePath.includes('/plugins/logger/') &&
+                    !filePath.includes('\\plugins\\logger\\') &&
+                    !filePath.includes('node:internal') &&
+                    !filePath.includes('node_modules') &&
+                    !filePath.startsWith('node:')) {
+                    // 使用 process.cwd() 裁剪为相对路径
+                    let simplifiedPath = filePath;
+                    try {
+                        const cwd = process.cwd();
+                        if (filePath.startsWith(cwd)) {
+                            simplifiedPath = filePath.slice(cwd.length).replace(/^[/\\]/, '');
+                        }
+                    }
+                    catch {
+                        // 忽略路径简化失败
+                    }
+                    const result = { file: simplifiedPath, line: lineNumber };
+                    this.cacheResult(stackHash, result);
+                    return result;
+                }
+            }
+        }
+        return {};
+    }
+    /** 清除缓存 */
+    clearCache() {
+        this.cache.clear();
+    }
+    /** 获取缓存大小（调试用） */
+    getCacheSize() {
+        return this.cache.size;
+    }
+    // ─── 私有方法 ─────────────────────────────────────────────
+    /**
+     * 53 位非加密哈希（双 32 位混合），碰撞概率约为 32 位哈希的 1/20亿。
+     * 参考：https://stackoverflow.com/a/52171480
+     */
+    simpleHash(str) {
+        let h1 = 0xdeadbeef;
+        let h2 = 0x41c6ce57;
+        for (let i = 0; i < str.length; i++) {
+            const char = str.charCodeAt(i);
+            h1 = Math.imul(h1 ^ char, 2654435761);
+            h2 = Math.imul(h2 ^ char, 1597334677);
+        }
+        h1 = Math.imul(h1 ^ (h1 >>> 16), 2246822507) ^ Math.imul(h2 ^ (h2 >>> 13), 3266489909);
+        h2 = Math.imul(h2 ^ (h2 >>> 16), 2246822507) ^ Math.imul(h1 ^ (h1 >>> 13), 3266489909);
+        const hash = 4294967296 * (2097151 & h2) + (h1 >>> 0);
+        return hash.toString(36);
+    }
+    /** LRU 缓存写入：满时淘汰最旧项 */
+    cacheResult(key, info) {
+        if (this.cache.size >= this.maxCacheSize) {
+            const firstKey = this.cache.keys().next().value;
+            if (firstKey !== undefined) {
+                this.cache.delete(firstKey);
+            }
+        }
+        this.cache.set(key, info);
+    }
+}
+exports.CallerInfoHelper = CallerInfoHelper;
+//# sourceMappingURL=caller-info.js.map

package/dist/utils/caller-info.js.map

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

package/dist/utils/color-utils.d.ts

@@ -0,0 +1,19 @@
+import chalk from 'chalk';
+/**
+ * 颜色工具类
+ * @internal
+ * @remarks
+ * 用于处理控制台输出的颜色。为不同级别的日志提供不同的颜色显示。
+ */
+export declare class ColorUtils {
+    static getLevelColor(level: string): typeof chalk;
+    static colorizeLevel(level: string): string;
+    /**
+     * 将时间戳渲染为灰色，内部添加方括号（与 colorizeName / colorizeFileLocation 约定一致）
+     */
+    static colorizeTimestamp(timestamp: string): string;
+    static colorizeName(name: string): string;
+    static colorizeFileLocation(location: string): string;
+    static colorizeMessage(level: string, message: string): string;
+}
+//# sourceMappingURL=color-utils.d.ts.map

package/dist/utils/color-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"color-utils.d.ts","sourceRoot":"","sources":["../../src/utils/color-utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAEzB;;;;;GAKG;AACH,qBAAa,UAAU;IACrB,MAAM,CAAC,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,KAAK;IAejD,MAAM,CAAC,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAK3C;;OAEG;IACH,MAAM,CAAC,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IAInD,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAIzC,MAAM,CAAC,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAIrD,MAAM,CAAC,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM;CAI/D"}

package/dist/utils/color-utils.js

@@ -0,0 +1,51 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ColorUtils = void 0;
+const chalk_1 = __importDefault(require("chalk"));
+/**
+ * 颜色工具类
+ * @internal
+ * @remarks
+ * 用于处理控制台输出的颜色。为不同级别的日志提供不同的颜色显示。
+ */
+class ColorUtils {
+    static getLevelColor(level) {
+        switch (level.toLowerCase()) {
+            case 'debug':
+                return chalk_1.default.gray;
+            case 'info':
+                return chalk_1.default.blue;
+            case 'warn':
+                return chalk_1.default.yellow;
+            case 'error':
+                return chalk_1.default.red;
+            default:
+                return chalk_1.default.white;
+        }
+    }
+    static colorizeLevel(level) {
+        const color = this.getLevelColor(level);
+        return color(level.toUpperCase().padEnd(6));
+    }
+    /**
+     * 将时间戳渲染为灰色，内部添加方括号（与 colorizeName / colorizeFileLocation 约定一致）
+     */
+    static colorizeTimestamp(timestamp) {
+        return chalk_1.default.gray(`[${timestamp}]`);
+    }
+    static colorizeName(name) {
+        return chalk_1.default.cyan(`[${name}]`);
+    }
+    static colorizeFileLocation(location) {
+        return chalk_1.default.gray(`(${location})`);
+    }
+    static colorizeMessage(level, message) {
+        const color = this.getLevelColor(level);
+        return color(message);
+    }
+}
+exports.ColorUtils = ColorUtils;
+//# sourceMappingURL=color-utils.js.map

package/dist/utils/color-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"color-utils.js","sourceRoot":"","sources":["../../src/utils/color-utils.ts"],"names":[],"mappings":";;;;;;AAAA,kDAAyB;AAEzB;;;;;GAKG;AACH,MAAa,UAAU;IACrB,MAAM,CAAC,aAAa,CAAC,KAAa;QAChC,QAAQ,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;YAC5B,KAAK,OAAO;gBACV,OAAO,eAAK,CAAC,IAAI,CAAA;YACnB,KAAK,MAAM;gBACT,OAAO,eAAK,CAAC,IAAI,CAAA;YACnB,KAAK,MAAM;gBACT,OAAO,eAAK,CAAC,MAAM,CAAA;YACrB,KAAK,OAAO;gBACV,OAAO,eAAK,CAAC,GAAG,CAAA;YAClB;gBACE,OAAO,eAAK,CAAC,KAAK,CAAA;QACtB,CAAC;IACH,CAAC;IAED,MAAM,CAAC,aAAa,CAAC,KAAa;QAChC,MAAM,KAAK,GAAG,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAA;QACvC,OAAO,KAAK,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAA;IAC7C,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,iBAAiB,CAAC,SAAiB;QACxC,OAAO,eAAK,CAAC,IAAI,CAAC,IAAI,SAAS,GAAG,CAAC,CAAA;IACrC,CAAC;IAED,MAAM,CAAC,YAAY,CAAC,IAAY;QAC9B,OAAO,eAAK,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,CAAC,CAAA;IAChC,CAAC;IAED,MAAM,CAAC,oBAAoB,CAAC,QAAgB;QAC1C,OAAO,eAAK,CAAC,IAAI,CAAC,IAAI,QAAQ,GAAG,CAAC,CAAA;IACpC,CAAC;IAED,MAAM,CAAC,eAAe,CAAC,KAAa,EAAE,OAAe;QACnD,MAAM,KAAK,GAAG,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAA;QACvC,OAAO,KAAK,CAAC,OAAO,CAAC,CAAA;IACvB,CAAC;CACF;AAxCD,gCAwCC"}

package/dist/utils/formatter.d.ts

@@ -0,0 +1,51 @@
+import { LogEntry, FormatOptions } from '../core/types';
+/**
+ * 格式化器运行时配置
+ */
+export interface FormatterSettings {
+    consoleTimestamp: boolean;
+    consoleColors: boolean;
+    format: {
+        enabled: boolean;
+        timestampFormat: string;
+        formatter?: (entry: LogEntry) => string;
+        includeStack: boolean;
+        includeName: boolean;
+        json: boolean;
+        jsonIndent: number;
+    };
+}
+/**
+ * 日志格式化器
+ * @internal
+ * 负责将 LogEntry 转换为可输出的字符串，支持普通文本、彩色控制台和 JSON 格式。
+ */
+export declare class LogFormatter {
+    settings: FormatterSettings;
+    constructor(settings: FormatterSettings);
+    /**
+     * 更新格式化选项（支持部分更新）
+     */
+    updateFormat(options: Partial<FormatOptions>): void;
+    /**
+     * 格式化为文件输出字符串。
+     * 注意：文件日志始终包含时间戳，与控制台的 consoleTimestamp 开关无关。
+     */
+    formatMessage(entry: LogEntry): string;
+    /**
+     * 格式化为带 ANSI 颜色的控制台字符串。
+     * 无色模式下使用纯文本，且遵守 consoleTimestamp 开关（与文件格式独立）。
+     * 自定义 formatter 函数的优先级高于颜色开关。
+     */
+    formatConsoleMessage(entry: LogEntry): string;
+    /**
+     * 构建纯文本日志行，供文件输出和无色控制台复用。
+     * @param includeTimestamp 是否包含时间戳（文件格式始终传 true；控制台按 consoleTimestamp 传入）
+     */
+    private buildPlainText;
+    /**
+     * 安全的 JSON 序列化，处理循环引用
+     */
+    private safeStringify;
+}
+//# sourceMappingURL=formatter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"formatter.d.ts","sourceRoot":"","sources":["../../src/utils/formatter.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAIvD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,gBAAgB,EAAE,OAAO,CAAA;IACzB,aAAa,EAAE,OAAO,CAAA;IACtB,MAAM,EAAE;QACN,OAAO,EAAE,OAAO,CAAA;QAChB,eAAe,EAAE,MAAM,CAAA;QACvB,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,MAAM,CAAA;QACvC,YAAY,EAAE,OAAO,CAAA;QACrB,WAAW,EAAE,OAAO,CAAA;QACpB,IAAI,EAAE,OAAO,CAAA;QACb,UAAU,EAAE,MAAM,CAAA;KACnB,CAAA;CACF;AAED;;;;GAIG;AACH,qBAAa,YAAY;IACvB,QAAQ,EAAE,iBAAiB,CAAA;gBAEf,QAAQ,EAAE,iBAAiB;IAIvC;;OAEG;IACH,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,IAAI;IAanD;;;OAGG;IACH,aAAa,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM;IAiCtC;;;;OAIG;IACH,oBAAoB,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM;IA0C7C;;;OAGG;IACH,OAAO,CAAC,cAAc;IAwBtB;;OAEG;IACH,OAAO,CAAC,aAAa;CA0BtB"}