@chaeco/logger 0.1.7

package/dist/core/types.d.ts

@@ -0,0 +1,155 @@
+/**
+ * 日志等级类型
+ * @remarks
+ * - debug: 调试信息，最详细的日志级别
+ * - info: 一般信息，用于记录正常的系统操作
+ * - warn: 警告信息，表示潜在的问题
+ * - error: 错误信息，表示系统出现错误
+ * - silent: 静默模式，不输出任何日志
+ */
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error' | 'silent';
+/**
+ * Logger 配置选项
+ */
+export interface LoggerOptions {
+    /** 日志等级，默认为 'info' */
+    level?: LogLevel;
+    /** 文件输出配置 */
+    file?: FileOptions;
+    /** 控制台输出配置 */
+    console?: ConsoleOptions;
+    /** Logger 名称，用于区分不同的 logger 实例 */
+    name?: string;
+    /** 日志格式化配置 */
+    format?: FormatOptions;
+    /** 异步写入配置（Node.js） */
+    async?: AsyncWriteOptions;
+    /** 错误处理配置 */
+    errorHandling?: ErrorHandlingOptions;
+}
+/**
+ * 文件输出配置选项
+ */
+export interface FileOptions {
+    /** 是否启用文件输出，默认为 true */
+    enabled?: boolean;
+    /** 日志文件存储路径，默认为 './logs' */
+    path?: string;
+    /** 单个日志文件的最大大小（字节），默认为 10485760（10 MB） */
+    maxSize?: number;
+    /** 最大保留的日志文件数量，默认为 30 */
+    maxFiles?: number;
+    /** 日志文件名前缀，默认为 'app' */
+    filename?: string;
+    /** 日志文件最大保留天数，超过该天数的日志将被自动删除，默认为 30 天 */
+    maxAge?: number;
+    /** 是否压缩旧的日志文件（gzip），默认为 false */
+    compress?: boolean;
+    /** 写入失败时的重试次数，默认为 3 */
+    retryCount?: number;
+    /** 重试间隔基数（毫秒），实际延迟为 retryDelay * attempt，默认为 100 */
+    retryDelay?: number;
+}
+/**
+ * 控制台输出配置选项
+ */
+export interface ConsoleOptions {
+    /** 是否启用控制台输出，默认为 true */
+    enabled?: boolean;
+    /** 是否启用彩色输出，默认为 true */
+    colors?: boolean;
+    /** 是否显示时间戳，默认为 true */
+    timestamp?: boolean;
+}
+/**
+ * 日志条目接口
+ * @internal
+ */
+export interface LogEntry {
+    /** 日志等级 */
+    level: LogLevel;
+    /** 日志消息内容 */
+    message: string;
+    /** 时间戳 */
+    timestamp: string;
+    /** Logger 名称 */
+    name?: string;
+    /** 调用者文件路径 */
+    file?: string;
+    /** 调用者行号 */
+    line?: number;
+    /** 附加数据 */
+    data?: any;
+}
+/**
+ * Logger 事件类型
+ */
+export type LoggerEventType = 'error' | 'fileWriteError' | 'levelChange';
+/**
+ * Logger 事件处理程序
+ */
+export type LoggerEventHandler = (event: LoggerEvent) => void;
+/**
+ * Logger 事件接口
+ */
+export interface LoggerEvent {
+    /** 事件类型 */
+    type: LoggerEventType;
+    /** 事件消息 */
+    message: string;
+    /** 事件发生的时间戳 */
+    timestamp: string;
+    /** 相关的错误对象（如果有） */
+    error?: Error;
+    /** 事件的附加数据 */
+    data?: any;
+}
+/**
+ * 日志格式化配置选项
+ */
+export interface FormatOptions {
+    /** 是否启用自定义 formatter 函数，默认为 false。
+     *  仅控制 `formatter` 函数是否生效；`json` 模式独立工作，不受此开关影响 */
+    enabled?: boolean;
+    /** 日期时间格式，默认为 'YYYY-MM-DD HH:mm:ss.SSS' */
+    timestampFormat?: string;
+    /** 自定义格式化函数 */
+    formatter?: (entry: LogEntry) => string;
+    /** 是否包含调用栈信息，默认为 true */
+    includeStack?: boolean;
+    /** 是否包含 logger 名称，默认为 true */
+    includeName?: boolean;
+    /** JSON 格式输出，默认为 false */
+    json?: boolean;
+    /** JSON 缩进空格数（仅当 json=true 时生效），0 表示不缩进 */
+    jsonIndent?: number;
+}
+/**
+ * 异步写入配置选项（Node.js）
+ */
+export interface AsyncWriteOptions {
+    /** 是否启用异步写入，默认为 false */
+    enabled?: boolean;
+    /** 写入队列最大长度，默认为 1000 */
+    queueSize?: number;
+    /** 批量写入的最大条数，默认为 100 */
+    batchSize?: number;
+    /** 批量写入的最大等待时间（毫秒），默认为 1000 */
+    flushInterval?: number;
+    /** 队列满时的处理策略：'drop'（丢弃新消息）、'block'（等待当前批次写完再继续）、
+     *  'overflow'（当前与 'block' 等效：等待写完后继续；未来可扩展为独立溢出队列） */
+    overflowStrategy?: 'drop' | 'block' | 'overflow';
+}
+/**
+ * 错误处理配置选项
+ */
+export interface ErrorHandlingOptions {
+    /** 是否静默错误：true（默认）→ 抑制所有 stderr 输出，仅通过 onError 回调和事件通知；
+     *  false → 与 fallbackToConsole 协同：当 fallbackToConsole:true 时输出 console.error */
+    silent?: boolean;
+    /** 错误回调函数 */
+    onError?: (error: Error, context: string) => void;
+    /** 是否在错误时降级到控制台输出，默认为 true */
+    fallbackToConsole?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/core/types.d.ts.map

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

package/dist/core/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/core/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":""}

package/dist/file/async-queue.d.ts

@@ -0,0 +1,24 @@
+import { AsyncWriteOptions } from '../core/types';
+/**
+ * 异步写入队列 - 批量缓冲日志消息，按批次大小或定时间隔写入。
+ * @internal
+ */
+export declare class AsyncQueue {
+    private queue;
+    private isWriting;
+    private flushTimer?;
+    private readonly options;
+    private readonly onFlush;
+    constructor(options: Required<AsyncWriteOptions>, onFlush: (messages: string[]) => Promise<void>);
+    get size(): number;
+    get writing(): boolean;
+    /** 启动定时刷新器 */
+    start(): void;
+    /** 将消息加入队列 */
+    enqueue(message: string): Promise<void>;
+    /** 立即刷新队列 */
+    flush(): Promise<void>;
+    /** 停止定时器并持续刷新直到队列完全清空 */
+    stop(): Promise<void>;
+}
+//# sourceMappingURL=async-queue.d.ts.map

package/dist/file/async-queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"async-queue.d.ts","sourceRoot":"","sources":["../../src/file/async-queue.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA;AAEjD;;;GAGG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,KAAK,CAAe;IAC5B,OAAO,CAAC,SAAS,CAAQ;IACzB,OAAO,CAAC,UAAU,CAAC,CAAgB;IACnC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA6B;IACrD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAuC;gBAEnD,OAAO,EAAE,QAAQ,CAAC,iBAAiB,CAAC,EAAE,OAAO,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC;IAKhG,IAAI,IAAI,IAAI,MAAM,CAA6B;IAC/C,IAAI,OAAO,IAAI,OAAO,CAA0B;IAEhD,cAAc;IACd,KAAK,IAAI,IAAI;IAWb,cAAc;IACR,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAqB7C,aAAa;IACP,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAc5B,yBAAyB;IACnB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAyB5B"}

package/dist/file/async-queue.js

@@ -0,0 +1,95 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AsyncQueue = void 0;
+/**
+ * 异步写入队列 - 批量缓冲日志消息，按批次大小或定时间隔写入。
+ * @internal
+ */
+class AsyncQueue {
+    constructor(options, onFlush) {
+        this.queue = [];
+        this.isWriting = false;
+        this.options = options;
+        this.onFlush = onFlush;
+    }
+    get size() { return this.queue.length; }
+    get writing() { return this.isWriting; }
+    /** 启动定时刷新器 */
+    start() {
+        if (this.flushTimer)
+            return;
+        this.flushTimer = setInterval(() => {
+            if (this.queue.length > 0) {
+                this.flush().catch(e => console.error('Failed to flush log queue:', e));
+            }
+        }, this.options.flushInterval);
+        // unref 使定时器不阻止进程自然退出（进程中只剩这个定时器时可以退出）
+        this.flushTimer.unref?.();
+    }
+    /** 将消息加入队列 */
+    async enqueue(message) {
+        // 用 while 而非 if：flush 失败时消息会被退回队列，队列仍可能满，需重新判断。
+        // 若一直用 if，flush 失败后依然 push，队列长度将无限突破 queueSize 上界。
+        while (this.queue.length >= this.options.queueSize) {
+            switch (this.options.overflowStrategy) {
+                case 'drop': return;
+                case 'block':
+                case 'overflow':
+                    // 'block' 和 'overflow' 均在此处先刷写一批再继续入队。
+                    // 注意：'overflow' 字面含义为"溢出到新队列"，当前实现与 'block' 等效——
+                    // 都是等待当前批次写完后继续。如需真正独立溢出队列，需扩展此处逻辑。
+                    await this.flush();
+                    break;
+            }
+        }
+        this.queue.push(message);
+        if (this.queue.length >= this.options.batchSize) {
+            await this.flush();
+        }
+    }
+    /** 立即刷新队列 */
+    async flush() {
+        if (this.isWriting || this.queue.length === 0)
+            return;
+        this.isWriting = true;
+        const messages = this.queue.splice(0, this.options.batchSize);
+        try {
+            await this.onFlush(messages);
+        }
+        catch (e) {
+            console.error('Failed to flush queue:', e);
+            this.queue.unshift(...messages);
+        }
+        finally {
+            this.isWriting = false;
+        }
+    }
+    /** 停止定时器并持续刷新直到队列完全清空 */
+    async stop() {
+        if (this.flushTimer) {
+            clearInterval(this.flushTimer);
+            this.flushTimer = undefined;
+        }
+        // 循环直到队列彻底清空（每次最多写 batchSize 条）。
+        // 若 onFlush 持续失败，flush() 会将消息退回队列，此处设置最大重试轮次防止死循环。
+        // FLUSH_SAFETY_BUFFER 额外轮次：防止 onFlush 间歇性失败时循环提前终止。
+        const FLUSH_SAFETY_BUFFER = 3;
+        const maxAttempts = Math.ceil(this.queue.length / this.options.batchSize) + FLUSH_SAFETY_BUFFER;
+        let attempts = 0;
+        while (this.queue.length > 0 && attempts < maxAttempts) {
+            if (this.isWriting) {
+                // 如果当前正在进行 flush（可能来自 setInterval），等待一小段时间再重试
+                await new Promise(r => setTimeout(r, 10));
+                attempts++;
+                continue;
+            }
+            await this.flush();
+            attempts++;
+        }
+        if (this.queue.length > 0) {
+            console.error(`@chaeco/logger: AsyncQueue stopped with ${this.queue.length} unwritten messages (flush failed repeatedly)`);
+        }
+    }
+}
+exports.AsyncQueue = AsyncQueue;
+//# sourceMappingURL=async-queue.js.map

package/dist/file/async-queue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"async-queue.js","sourceRoot":"","sources":["../../src/file/async-queue.ts"],"names":[],"mappings":";;;AAEA;;;GAGG;AACH,MAAa,UAAU;IAOrB,YAAY,OAAoC,EAAE,OAA8C;QANxF,UAAK,GAAa,EAAE,CAAA;QACpB,cAAS,GAAG,KAAK,CAAA;QAMvB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;QACtB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;IACxB,CAAC;IAED,IAAI,IAAI,KAAa,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAA,CAAC,CAAC;IAC/C,IAAI,OAAO,KAAc,OAAO,IAAI,CAAC,SAAS,CAAA,CAAC,CAAC;IAEhD,cAAc;IACd,KAAK;QACH,IAAI,IAAI,CAAC,UAAU;YAAE,OAAM;QAC3B,IAAI,CAAC,UAAU,GAAG,WAAW,CAAC,GAAG,EAAE;YACjC,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC1B,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,4BAA4B,EAAE,CAAC,CAAC,CAAC,CAAA;YACzE,CAAC;QACH,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,CAAA;QAC9B,uCAAuC;QACvC,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,CAAA;IAC3B,CAAC;IAED,cAAc;IACd,KAAK,CAAC,OAAO,CAAC,OAAe;QAC3B,gDAAgD;QAChD,mDAAmD;QACnD,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,IAAI,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC;YACnD,QAAQ,IAAI,CAAC,OAAO,CAAC,gBAAgB,EAAE,CAAC;gBACtC,KAAK,MAAM,CAAC,CAAC,OAAM;gBACnB,KAAK,OAAO,CAAC;gBACb,KAAK,UAAU;oBACb,uCAAuC;oBACvC,iDAAiD;oBACjD,oCAAoC;oBACpC,MAAM,IAAI,CAAC,KAAK,EAAE,CAAA;oBAClB,MAAK;YACT,CAAC;QACH,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QACxB,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,IAAI,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC;YAChD,MAAM,IAAI,CAAC,KAAK,EAAE,CAAA;QACpB,CAAC;IACH,CAAC;IAED,aAAa;IACb,KAAK,CAAC,KAAK;QACT,IAAI,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAM;QACrD,IAAI,CAAC,SAAS,GAAG,IAAI,CAAA;QACrB,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAA;QAC7D,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAA;QAC9B,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,CAAC,KAAK,CAAC,wBAAwB,EAAE,CAAC,CAAC,CAAA;YAC1C,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,QAAQ,CAAC,CAAA;QACjC,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,SAAS,GAAG,KAAK,CAAA;QACxB,CAAC;IACH,CAAC;IAED,yBAAyB;IACzB,KAAK,CAAC,IAAI;QACR,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACpB,aAAa,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;YAC9B,IAAI,CAAC,UAAU,GAAG,SAAS,CAAA;QAC7B,CAAC;QACD,iCAAiC;QACjC,mDAAmD;QACnD,oDAAoD;QACpD,MAAM,mBAAmB,GAAG,CAAC,CAAA;QAC7B,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,GAAG,mBAAmB,CAAA;QAC/F,IAAI,QAAQ,GAAG,CAAC,CAAA;QAChB,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,QAAQ,GAAG,WAAW,EAAE,CAAC;YACvD,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;gBACnB,8CAA8C;gBAC9C,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAA;gBACzC,QAAQ,EAAE,CAAA;gBACV,SAAQ;YACV,CAAC;YACD,MAAM,IAAI,CAAC,KAAK,EAAE,CAAA;YAClB,QAAQ,EAAE,CAAA;QACZ,CAAC;QACD,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC1B,OAAO,CAAC,KAAK,CAAC,2CAA2C,IAAI,CAAC,KAAK,CAAC,MAAM,+CAA+C,CAAC,CAAA;QAC5H,CAAC;IACH,CAAC;CACF;AA1FD,gCA0FC"}

package/dist/file/file-manager.d.ts

@@ -0,0 +1,29 @@
+import { FileOptions, AsyncWriteOptions } from '../core/types';
+/**
+ * 文件管理器 - 管理日志文件写入（仅 Node.js）。
+ * @internal
+ */
+export declare class FileManager {
+    private isInitialized;
+    private initError?;
+    private nodeWriter;
+    private asyncQueue?;
+    private readonly options;
+    private readonly asyncOptions?;
+    constructor(options?: FileOptions, asyncOptions?: AsyncWriteOptions);
+    /** 提前初始化（可选，首次写入时也会自动初始化） */
+    init(): void;
+    write(message: string): Promise<void>;
+    /** 获取当前文件配置（只读），供 child logger 复制时使用 */
+    getOptions(): Readonly<Required<FileOptions>>;
+    /** 获取异步写入配置（只读），供 child logger 继承异步策略 */
+    getAsyncOptions(): Readonly<AsyncWriteOptions> | undefined;
+    /** 关闭存储，刷新剩余队列 */
+    close(): Promise<void>;
+    /** 获取异步队列状态 */
+    getQueueStatus(): {
+        size: number;
+        isWriting: boolean;
+    };
+}
+//# sourceMappingURL=file-manager.d.ts.map

package/dist/file/file-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-manager.d.ts","sourceRoot":"","sources":["../../src/file/file-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA;AAI9D;;;GAGG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,aAAa,CAAQ;IAC7B,OAAO,CAAC,SAAS,CAAC,CAAO;IACzB,OAAO,CAAC,UAAU,CAAY;IAC9B,OAAO,CAAC,UAAU,CAAC,CAAY;IAC/B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAuB;IAC/C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAmB;gBAErC,OAAO,GAAE,WAAgB,EAAE,YAAY,CAAC,EAAE,iBAAiB;IA4BvE,6BAA6B;IACtB,IAAI,IAAI,IAAI;IAYb,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ3C,wCAAwC;IACxC,UAAU,IAAI,QAAQ,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;IAI7C,yCAAyC;IACzC,eAAe,IAAI,QAAQ,CAAC,iBAAiB,CAAC,GAAG,SAAS;IAI1D,kBAAkB;IACZ,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B,eAAe;IACf,cAAc,IAAI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,OAAO,CAAA;KAAE;CAGvD"}

package/dist/file/file-manager.js

@@ -0,0 +1,85 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FileManager = void 0;
+const node_writer_1 = require("./node-writer");
+const async_queue_1 = require("./async-queue");
+/**
+ * 文件管理器 - 管理日志文件写入（仅 Node.js）。
+ * @internal
+ */
+class FileManager {
+    constructor(options = {}, asyncOptions) {
+        this.isInitialized = false;
+        this.asyncOptions = asyncOptions;
+        this.options = {
+            enabled: options.enabled ?? true,
+            path: options.path ?? './logs',
+            maxSize: options.maxSize ?? 10 * 1024 * 1024,
+            maxFiles: options.maxFiles ?? 30,
+            filename: options.filename ?? 'app',
+            maxAge: options.maxAge ?? 30,
+            compress: options.compress ?? false,
+            retryCount: options.retryCount ?? 3,
+            retryDelay: options.retryDelay ?? 100,
+        };
+        this.nodeWriter = new node_writer_1.NodeWriter(this.options);
+        if (asyncOptions?.enabled) {
+            const ao = {
+                enabled: asyncOptions.enabled,
+                queueSize: asyncOptions.queueSize ?? 1000,
+                batchSize: asyncOptions.batchSize ?? 100,
+                flushInterval: asyncOptions.flushInterval ?? 1000,
+                overflowStrategy: asyncOptions.overflowStrategy ?? 'drop',
+            };
+            this.asyncQueue = new async_queue_1.AsyncQueue(ao, msgs => this.nodeWriter.writeBatch(msgs));
+            this.asyncQueue.start();
+        }
+    }
+    /** 提前初始化（可选，首次写入时也会自动初始化） */
+    init() {
+        if (this.isInitialized)
+            return;
+        try {
+            this.nodeWriter.init();
+            if (this.nodeWriter.initError)
+                this.initError = this.nodeWriter.initError;
+            else
+                this.isInitialized = true;
+        }
+        catch (e) {
+            this.initError = e instanceof Error ? e : new Error(String(e));
+            console.warn('@chaeco/logger: Failed to initialize FileManager:', e);
+        }
+    }
+    async write(message) {
+        if (!this.options.enabled)
+            return;
+        if (!this.isInitialized && !this.initError)
+            this.init();
+        if (this.initError)
+            return;
+        if (this.asyncQueue) {
+            await this.asyncQueue.enqueue(message);
+            return;
+        }
+        await this.nodeWriter.write(message);
+    }
+    /** 获取当前文件配置（只读），供 child logger 复制时使用 */
+    getOptions() {
+        return this.options;
+    }
+    /** 获取异步写入配置（只读），供 child logger 继承异步策略 */
+    getAsyncOptions() {
+        return this.asyncOptions;
+    }
+    /** 关闭存储，刷新剩余队列 */
+    async close() {
+        await this.asyncQueue?.stop();
+    }
+    /** 获取异步队列状态 */
+    getQueueStatus() {
+        return { size: this.asyncQueue?.size ?? 0, isWriting: this.asyncQueue?.writing ?? false };
+    }
+}
+exports.FileManager = FileManager;
+//# sourceMappingURL=file-manager.js.map

package/dist/file/file-manager.js.map

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

package/dist/file/node-writer.d.ts

@@ -0,0 +1,30 @@
+import { FileOptions } from '../core/types';
+/**
+ * Node.js 文件写入器 - 管理日志文件的创建、轮转、压缩与清理。
+ * @internal
+ */
+export declare class NodeWriter {
+    private readonly options;
+    private currentFilePath;
+    private currentFileSize;
+    private fileIndex;
+    private _initError;
+    /** 初始化错误（只读），如果初始化失败则值不为 undefined */
+    get initError(): Error | undefined;
+    constructor(options: Required<FileOptions>);
+    init(): void;
+    /** 写入单条消息（内部使用 appendFileSync，通过重试逻辑提供可靠性） */
+    write(message: string): Promise<void>;
+    /** 批量写入消息（由 AsyncQueue 刷新时调用） */
+    writeBatch(messages: string[]): Promise<void>;
+    private ensureLogDirectory;
+    private initializeCurrentFile;
+    private getIndexedFilePath;
+    private shouldRotateFile;
+    private rotateFile;
+    private cleanupOldFiles;
+    private compressOldLogs;
+    private checkDateRotation;
+    private appendToFileWithRetry;
+}
+//# sourceMappingURL=node-writer.d.ts.map

package/dist/file/node-writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-writer.d.ts","sourceRoot":"","sources":["../../src/file/node-writer.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAO3C;;;GAGG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAuB;IAC/C,OAAO,CAAC,eAAe,CAAK;IAC5B,OAAO,CAAC,eAAe,CAAI;IAC3B,OAAO,CAAC,SAAS,CAAI;IACrB,OAAO,CAAC,UAAU,CAAmB;IAErC,sCAAsC;IACtC,IAAI,SAAS,IAAI,KAAK,GAAG,SAAS,CAA2B;gBAEjD,OAAO,EAAE,QAAQ,CAAC,WAAW,CAAC;IAQ1C,IAAI,IAAI,IAAI;IAKZ,8CAA8C;IACxC,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ3C,iCAAiC;IAC3B,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAUnD,OAAO,CAAC,kBAAkB;IAW1B,OAAO,CAAC,qBAAqB;IA2B7B,OAAO,CAAC,kBAAkB;IAQ1B,OAAO,CAAC,gBAAgB;IAIxB,OAAO,CAAC,UAAU;IAOlB,OAAO,CAAC,eAAe;YAiCT,eAAe;IAuB7B,OAAO,CAAC,iBAAiB;YAMX,qBAAqB;CAiBpC"}