ee-core 5.0.0-beta.2 → 5.0.0-beta.5

package/dist/cjs/loader/index.js

@@ -8,12 +8,34 @@ exports.requireFile = requireFile;
 exports.execFile = execFile;
 exports.resolveModule = resolveModule;
 exports.getFullpath = getFullpath;
+/**
+ * @module loader
+ * @description File loading module. Provides multiple file loading and execution methods,
+ * serving as the foundational dependency for controller loading, config loading, and task execution.
+ *
+ * Core functions:
+ * - loadFile: Load a file, automatically execute if the export is a function
+ * - requireFile: Load a file without auto-execution
+ * - execFile: Load a file, instantiate if class, execute if function
+ * - resolveModule: Resolve the absolute path of a module
+ * - getFullpath: Get the absolute path of a file under the electron directory
+ */
 const type_check_js_1 = require("../utils/type_check.js");
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
 const index_js_1 = require("../core/utils/index.js");
 const index_js_2 = require("../ps/index.js");
-// 加载单个文件(如果是函数，将被执行)
+/**
+ * Load a file and automatically execute function exports
+ *
+ * If the file exports a plain function (not a class or bytecode class), automatically calls that function
+ * and returns the execution result. Suitable for config files that need to dynamically return content based on appInfo.
+ *
+ * @param filepath - File path (relative paths are based on electronDir)
+ * @param inject - Arguments passed to the function export (spread into the call)
+ * @returns File export content or function execution result
+ * @throws Throws an error if the file does not exist
+ */
 function loadFile(filepath, ...inject) {
     let fullpath = filepath;
     const isAbsolute = path_1.default.isAbsolute(fullpath);
@@ -25,39 +47,78 @@ function loadFile(filepath, ...inject) {
         throw new Error(`[ee-core] [loader/index] loadFile ${filepath} does not exist`);
     }
     let ret = (0, index_js_1.loadFile)(fullpath);
+    // Plain function export: auto-execute, inject arguments (e.g. appInfo)
     if ((0, type_check_js_1.isFunction)(ret) && !(0, type_check_js_1.isClass)(ret) && !(0, index_js_1.isBytecodeClass)(ret)) {
         ret = ret(...inject);
     }
     return ret;
 }
-// requireFile
+/**
+ * Load a file (without auto-execution)
+ *
+ * Returns the module export content directly, without any processing.
+ * Suitable for scenarios where the original module reference is needed (e.g. child process task loading).
+ *
+ * @param filepath - Absolute file path
+ * @returns Module export content
+ */
 function requireFile(filepath) {
     return (0, index_js_1.loadFile)(filepath);
 }
-// 加载并运行文件
+/**
+ * Load and run a file
+ *
+ * Determines execution method based on export type:
+ * - Class/bytecode class -> Instantiate with new, inject as constructor arguments
+ * - Plain function -> Call directly, inject as function arguments
+ * - Other -> Return as-is
+ *
+ * @param filepath - Absolute file path
+ * @param inject - Arguments passed to the constructor or function (spread into the call)
+ * @returns Instantiated class object or function execution result
+ */
 function execFile(filepath, ...inject) {
     let ret = (0, index_js_1.loadFile)(filepath);
     if ((0, type_check_js_1.isClass)(ret) || (0, index_js_1.isBytecodeClass)(ret)) {
-        ret = new ret(inject);
+        ret = new ret(...inject);
     }
     else if ((0, type_check_js_1.isFunction)(ret)) {
-        ret = ret(inject);
+        ret = ret(...inject);
     }
     return ret;
 }
-// 模块的绝对路径
+/**
+ * Resolve the absolute path of a module
+ *
+ * First tries require.resolve(), then falls back to suffix-based rules:
+ * - .default / .prod -> Try .jsc (bytecode version)
+ * - .js -> Try .jsc
+ * - No suffix -> Try .js and .jsc
+ *
+ * @param filepath - Module path
+ * @returns Absolute path of the module, or undefined if it cannot be resolved
+ */
 function resolveModule(filepath) {
     let fullpath;
     try {
         fullpath = require.resolve(filepath);
     }
     catch {
-        // 特殊后缀处理
-        if (filepath && (filepath.endsWith('.defalut') || filepath.endsWith('.prod'))) {
+        // Special suffix handling: config filenames like config.default, config.prod
+        if (filepath && (filepath.endsWith('.default') || filepath.endsWith('.prod'))) {
             fullpath = filepath + '.jsc';
         }
         else if (filepath && filepath.endsWith('.js')) {
-            fullpath = filepath + 'c';
+            fullpath = filepath + 'c'; // .js → .jsc
+        }
+        // In packaged mode, require.resolve may fail; try checking if the file exists directly
+        if (!fullpath || !fs_1.default.existsSync(fullpath)) {
+            if (fs_1.default.existsSync(filepath + '.js')) {
+                fullpath = filepath + '.js';
+            }
+            else if (fs_1.default.existsSync(filepath + '.jsc')) {
+                fullpath = filepath + '.jsc';
+            }
         }
         if (!fs_1.default.existsSync(filepath) && (!fullpath || !fs_1.default.existsSync(fullpath))) {
             console.warn(`[ee-core] [loader] resolveModule unknow filepath: ${JSON.stringify({ filepath, fullpath })}`);
@@ -66,7 +127,15 @@ function resolveModule(filepath) {
     }
     return fullpath;
 }
-// 获取electron目录下文件的绝对路径
+/**
+ * Get the absolute path of a file under the electron directory
+ *
+ * Relative paths are resolved based on electronDir, and resolveModule is also attempted to find the actual file.
+ *
+ * @param filepath - File path (relative or absolute)
+ * @returns Absolute path of the file
+ * @throws Throws an error if the file does not exist
+ */
 function getFullpath(filepath) {
     let fullpath;
     const isAbsolute = path_1.default.isAbsolute(filepath);

package/dist/cjs/loader/index.js.map

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

package/dist/cjs/log/index.d.ts

@@ -1,5 +1,25 @@
+/**
+ * @module log
+ * @description Log module entry point. Provides log creation, loading, and retrieval functionality.
+ *
+ * Three log instances:
+ * - logger: Application log, records business code output
+ * - coreLogger: Framework core log, records framework internal runtime information
+ * - errorLogger: Error log, only records error/fatal levels
+ *
+ * Wraps log methods with Proxy, compatible with multiple calling styles:
+ * - pino standard: logger.info({ key: 'value' }, 'message')
+ * - pino printf: logger.info('count: %d', 42)
+ * - Concatenation mode: logger.info('msg:', value) → auto-concatenates to 'msg: value'
+ */
 import pino from 'pino';
 import { PinoLoggers } from './logger.js';
+/**
+ * EeLogger interface
+ *
+ * Defines the framework's unified log interface, shielding pino internal implementation details.
+ * Supports six levels: trace/debug/info/warn/error/fatal and child() sub-logger.
+ */
 export interface EeLogger {
     trace(...args: unknown[]): void;
     debug(...args: unknown[]): void;
@@ -9,10 +29,31 @@ export interface EeLogger {
     fatal(...args: unknown[]): void;
     child(bindings: pino.Bindings): EeLogger;
 }
+/**
+ * Create log instances
+ *
+ * @param config - Custom log configuration (optional)
+ * @returns PinoLoggers object
+ */
 export declare function createLog(config?: Record<string, unknown>): PinoLoggers;
+/**
+ * Load log system
+ *
+ * Creates log instances using system configuration. Called by boot.ts init() during framework startup flow.
+ */
 export declare function loadLog(): void;
+/**
+ * Get log instance collection
+ *
+ * If logs have not been loaded yet, automatically triggers loading.
+ *
+ * @returns PinoLoggers object
+ */
 export declare function getLoggers(): PinoLoggers;
+/** Application log instance (Proxy wrapped) */
 export declare const logger: EeLogger;
+/** Framework core log instance (Proxy wrapped) */
 export declare const coreLogger: EeLogger;
+/** Error log instance (Proxy wrapped, error/fatal level only) */
 export declare const errorLogger: EeLogger;
 //# sourceMappingURL=index.d.ts.map

package/dist/cjs/log/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/log/index.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,WAAW,EAAU,MAAM,aAAa,CAAC;AAElD,MAAM,WAAW,QAAQ;IACvB,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAChC,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAChC,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAC/B,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAC/B,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAChC,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAChC,KAAK,CAAC,QAAQ,EAAE,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;CAC1C;AAID,wBAAgB,SAAS,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,WAAW,CAEvE;AAED,wBAAgB,OAAO,IAAI,IAAI,CAE9B;AAED,wBAAgB,UAAU,IAAI,WAAW,CAGxC;AA6DD,eAAO,MAAM,MAAM,EAAE,QAAwC,CAAC;AAC9D,eAAO,MAAM,UAAU,EAAE,QAA4C,CAAC;AACtE,eAAO,MAAM,WAAW,EAAE,QAA6C,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/log/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,WAAW,EAAU,MAAM,aAAa,CAAC;AAElD;;;;;GAKG;AACH,MAAM,WAAW,QAAQ;IACvB,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAChC,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAChC,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAC/B,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAC/B,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAChC,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAChC,KAAK,CAAC,QAAQ,EAAE,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;CAC1C;AAKD;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,WAAW,CAEvE;AAED;;;;GAIG;AACH,wBAAgB,OAAO,IAAI,IAAI,CAE9B;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,IAAI,WAAW,CAGxC;AAgFD,+CAA+C;AAC/C,eAAO,MAAM,MAAM,EAAE,QAA0D,CAAC;AAChF,kDAAkD;AAClD,eAAO,MAAM,UAAU,EAAE,QAA8D,CAAC;AACxF,iEAAiE;AACjE,eAAO,MAAM,WAAW,EAAE,QAA+D,CAAC"}

package/dist/cjs/log/index.js

@@ -5,38 +5,59 @@ exports.createLog = createLog;
 exports.loadLog = loadLog;
 exports.getLoggers = getLoggers;
 const logger_js_1 = require("./logger.js");
+/** Log instance collection (assigned after startup) */
 let loggers = null;
+/**
+ * Create log instances
+ *
+ * @param config - Custom log configuration (optional)
+ * @returns PinoLoggers object
+ */
 function createLog(config) {
     return (0, logger_js_1.create)(config ?? {});
 }
+/**
+ * Load log system
+ *
+ * Creates log instances using system configuration. Called by boot.ts init() during framework startup flow.
+ */
 function loadLog() {
     loggers = (0, logger_js_1.create)();
 }
+/**
+ * Get log instance collection
+ *
+ * If logs have not been loaded yet, automatically triggers loading.
+ *
+ * @returns PinoLoggers object
+ */
 function getLoggers() {
     if (!loggers) {
         loadLog();
     }
     return loggers;
 }
-function _getLogger() {
+/**
+ * Get pino log instance by property name
+ *
+ * @param prop - Property name (logger / coreLogger / errorLogger)
+ * @returns pino.Logger instance
+ */
+function _getLoggerBy(prop) {
     if (!loggers) {
         loadLog();
     }
-    return loggers.logger;
-}
-function _getCoreLogger() {
-    if (!loggers) {
-        loadLog();
-    }
-    return loggers.coreLogger;
-}
-function _getErrorLogger() {
-    if (!loggers) {
-        loadLog();
-    }
-    return loggers.errorLogger;
+    return loggers[prop];
 }
+/** Set of supported log method names */
 const LOG_METHODS = new Set(['trace', 'debug', 'info', 'warn', 'error', 'fatal']);
+/**
+ * Format argument to string
+ *
+ * - Error → stack or message
+ * - Object → JSON string
+ * - Other → String()
+ */
 function formatArg(a) {
     if (a instanceof Error)
         return a.stack || a.message;
@@ -44,9 +65,23 @@ function formatArg(a) {
         return JSON.stringify(a);
     return String(a);
 }
+/**
+ * Create log proxy object
+ *
+ * Uses Proxy to intercept method calls, compatible with multiple log calling styles:
+ * 1. pino standard: logger.info({ key: 'val' }, 'msg') — first argument is merge object
+ * 2. pino printf: logger.info('count: %d', 42) — contains %s/%d format placeholders
+ * 3. Concatenation mode: logger.info('msg:', value) — multiple arguments auto-concatenated to string
+ *
+ * child() method returns a new proxy object bound to sub-logger context.
+ *
+ * @param getter - Deferred function to get pino.Logger instance
+ * @returns EeLogger proxy object
+ */
 function createLoggerProxy(getter) {
     return new Proxy({}, {
         get(_target, prop) {
+            // child() returns sub-logger proxy
             if (prop === 'child') {
                 return (bindings) => createLoggerProxy(() => getter().child(bindings));
             }
@@ -57,28 +92,32 @@ function createLoggerProxy(getter) {
                 const method = l[prop];
                 if (!method)
                     return;
+                // Single argument, call directly
                 if (args.length <= 1) {
                     method.call(l, ...args);
                     return;
                 }
                 const first = args[0];
-                // pino 标准: 第一个参数是普通对象 → (mergeObj, msg, ...args)
+                // pino standard: first argument is a plain object → (mergeObj, msg, ...args)
                 if (typeof first === 'object' && first !== null && !(first instanceof Error)) {
                     method.call(l, ...args);
                     return;
                 }
-                // pino printf: 第一个参数含 %s/%d 格式化 → 保持原样
+                // pino printf: first argument contains %s/%d formatting → keep as-is
                 if (typeof first === 'string' && /%[sdijo]/.test(first)) {
                     method.call(l, ...args);
                     return;
                 }
-                // 拼接模式: logger.info('msg:', value) → 'msg: value'
+                // Concatenation mode: logger.info('msg:', value) → 'msg: value'
                 method.call(l, args.map(formatArg).join(' '));
             };
         },
     });
 }
-exports.logger = createLoggerProxy(_getLogger);
-exports.coreLogger = createLoggerProxy(_getCoreLogger);
-exports.errorLogger = createLoggerProxy(_getErrorLogger);
+/** Application log instance (Proxy wrapped) */
+exports.logger = createLoggerProxy(() => _getLoggerBy('logger'));
+/** Framework core log instance (Proxy wrapped) */
+exports.coreLogger = createLoggerProxy(() => _getLoggerBy('coreLogger'));
+/** Error log instance (Proxy wrapped, error/fatal level only) */
+exports.errorLogger = createLoggerProxy(() => _getLoggerBy('errorLogger'));
 //# sourceMappingURL=index.js.map

package/dist/cjs/log/index.js.map

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

package/dist/cjs/log/logger.d.ts

@@ -1,9 +1,35 @@
+/**
+ * @module log/logger
+ * @description Logger creator. Creates three log instances based on the pino logging library:
+ * - logger: Application log (ee.log), records business code logs
+ * - coreLogger: Framework core log (ee-core.log), records framework internal logs
+ * - errorLogger: Error log (ee-error.log), only records error level and above
+ *
+ * Features:
+ * - Log file rotation based on pino-roll (daily/hourly)
+ * - pino-pretty colorized output in development environment
+ * - Supports field redaction (redact), custom log levels, custom serializers
+ * - Safe mode: does not throw exceptions when log write fails
+ */
 import pino from 'pino';
 import type { LoggerConfig } from '../types/index.js';
+/** Collection of three pino log instances */
 export interface PinoLoggers {
+    /** Application log instance */
     logger: pino.Logger;
+    /** Framework core log instance */
     coreLogger: pino.Logger;
+    /** Error log instance (error level and above only) */
     errorLogger: pino.Logger;
 }
+/**
+ * Create three log instances (logger / coreLogger / errorLogger)
+ *
+ * Merges default configuration and user configuration, creating independent pino instances for each log file.
+ * errorLogger level is fixed to error; others use the configured level.
+ *
+ * @param config - Custom log configuration (optional, overrides system configuration)
+ * @returns PinoLoggers object containing three log instances
+ */
 export declare function create(config?: Partial<LoggerConfig>): PinoLoggers;
 //# sourceMappingURL=logger.d.ts.map

package/dist/cjs/log/logger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../src/log/logger.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AAOxB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAItD,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC;IACpB,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC;IACxB,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC;CAC1B;AA+ED,wBAAgB,MAAM,CAAC,MAAM,GAAE,OAAO,CAAC,YAAY,CAAM,GAAG,WAAW,CAiEtE"}
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../src/log/logger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,IAAI,MAAM,MAAM,CAAC;AAOxB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAItD,6CAA6C;AAC7C,MAAM,WAAW,WAAW;IAC1B,+BAA+B;IAC/B,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC;IACpB,kCAAkC;IAClC,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC;IACxB,sDAAsD;IACtD,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC;CAC1B;AAuKD;;;;;;;;GAQG;AACH,wBAAgB,MAAM,CAAC,MAAM,GAAE,OAAO,CAAC,YAAY,CAAM,GAAG,WAAW,CA2EtE"}

package/dist/cjs/log/logger.js

@@ -4,6 +4,19 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.create = create;
+/**
+ * @module log/logger
+ * @description Logger creator. Creates three log instances based on the pino logging library:
+ * - logger: Application log (ee.log), records business code logs
+ * - coreLogger: Framework core log (ee-core.log), records framework internal logs
+ * - errorLogger: Error log (ee-error.log), only records error level and above
+ *
+ * Features:
+ * - Log file rotation based on pino-roll (daily/hourly)
+ * - pino-pretty colorized output in development environment
+ * - Supports field redaction (redact), custom log levels, custom serializers
+ * - Safe mode: does not throw exceptions when log write fails
+ */
 const pino_1 = __importDefault(require("pino"));
 const path_1 = __importDefault(require("path"));
 const debug_1 = __importDefault(require("debug"));
@@ -12,15 +25,76 @@ const default_config_js_1 = __importDefault(require("../config/default_config.js
 const extend_js_1 = require("../utils/extend.js");
 const index_js_2 = require("../ps/index.js");
 const debugLog = (0, debug_1.default)('ee-core:log:logger');
+/** Log level name mapping (case-insensitive) */
 const LEVEL_MAP = {
     DEBUG: 'debug', INFO: 'info', WARN: 'warn',
     ERROR: 'error', FATAL: 'fatal', TRACE: 'trace',
 };
+/**
+ * Normalize log level name
+ *
+ * Converts uppercase level names to lowercase, case-insensitive input.
+ */
 function normalizeLevel(level) {
     return LEVEL_MAP[level.toUpperCase()] || level.toLowerCase();
 }
+/**
+ * Build a pino timestamp function that emits wall-clock time in a specific IANA timezone.
+ *
+ * pino's built-in isoTime always emits UTC (e.g. '...Z'); this preserves that exact behavior for
+ * 'UTC' (fast path via Date.toISOString()), and for any other IANA zone emits a full ISO string
+ * carrying the zone offset (e.g. '2026-06-01T21:42:24.123+08:00'), so file logs read as the
+ * configured timezone regardless of the host machine's TZ. The returned function follows pino's
+ * contract: it returns a string beginning with `,"time":...` to be concatenated into the JSON line.
+ *
+ * @param timeZone - IANA timezone name (e.g. 'Asia/Shanghai'), or 'UTC' for standard 'Z' output
+ */
+function buildTimezoneTimeFn(timeZone) {
+    // UTC fast path: standard ISO 'Z' suffix, identical to pino's stdTimeFunctions.isoTime
+    if (timeZone === 'UTC') {
+        return function utcTime() {
+            return `,"time":"${new Date().toISOString()}"`;
+        };
+    }
+    const dtf = new Intl.DateTimeFormat('en-US', {
+        timeZone,
+        hour12: false,
+        year: 'numeric', month: '2-digit', day: '2-digit',
+        hour: '2-digit', minute: '2-digit', second: '2-digit',
+        timeZoneName: 'longOffset',
+    });
+    return function timezoneTime() {
+        const now = new Date();
+        const parts = {};
+        for (const p of dtf.formatToParts(now))
+            parts[p.type] = p.value;
+        const ms = String(now.getMilliseconds()).padStart(3, '0');
+        // longOffset yields 'GMT+08:00' (or plain 'GMT' for UTC)
+        const raw = parts.timeZoneName || 'GMT';
+        const offset = raw === 'GMT' ? '+00:00' : raw.replace('GMT', '');
+        // Some engines emit '24' for midnight hour; normalize to '00'
+        const hour = parts.hour === '24' ? '00' : parts.hour;
+        return `,"time":"${parts.year}-${parts.month}-${parts.day}T${hour}:${parts.minute}:${parts.second}.${ms}${offset}"`;
+    };
+}
+/**
+ * Build pino transport target list
+ *
+ * At minimum includes one pino-roll file output target;
+ * in development environment, additionally adds pino-pretty terminal output target.
+ *
+ * @param logDir - Log directory
+ * @param logFileBase - Log file base name (without extension)
+ * @param logFileExt - Log file extension
+ * @param level - Log level
+ * @param prettyPrint - Whether to enable terminal colorized output
+ * @param frequency - Rotation frequency (daily/hourly)
+ * @param maxSize - Maximum single file size
+ * @param dateFormat - File name date format
+ */
 function buildTransportTargets(logDir, logFileBase, logFileExt, level, prettyPrint, frequency, maxSize, dateFormat) {
     const targets = [];
+    // File output target: uses pino-roll for log rotation
     targets.push({
         target: 'pino-roll',
         level,
@@ -33,24 +107,37 @@ function buildTransportTargets(logDir, logFileBase, logFileExt, level, prettyPri
             mkdir: true,
         },
     });
+    // Development environment: terminal colorized output
     if (prettyPrint) {
         targets.push({
             target: 'pino-pretty',
             level,
             options: {
                 colorize: true,
-                translateTime: 'SYS:yyyy-MM-dd HH:mm:ss',
+                translateTime: 'SYS:yyyy-mm-dd HH:MM:ss',
                 ignore: 'pid,hostname',
             },
         });
     }
     return targets;
 }
+/**
+ * Parse log file name, separating base name and extension
+ *
+ * @param fileName - Log file name (e.g., 'ee.log')
+ * @returns { base: base name, ext: extension }
+ */
 function parseLogFileName(fileName) {
     const ext = path_1.default.extname(fileName);
     const base = path_1.default.basename(fileName, ext);
     return { base, ext: ext || '.log' };
 }
+/**
+ * Map the rotator value from config to pino-roll supported frequency
+ *
+ * @param rotator - Rotation strategy config value
+ * @returns 'daily' or 'hourly'
+ */
 function mapRotatorToFrequency(rotator) {
     if (rotator === 'day' || rotator === 'daily')
         return 'daily';
@@ -58,19 +145,44 @@ function mapRotatorToFrequency(rotator) {
         return 'hourly';
     return 'daily';
 }
+/**
+ * Create a single pino log instance
+ *
+ * @param opts - pino LoggerOptions
+ * @param logDir - Log directory
+ * @param logFileBase - Log file base name
+ * @param logFileExt - Log file extension
+ * @param level - Log level
+ * @param prettyPrint - Whether to enable colorized output
+ * @param frequency - Rotation frequency
+ * @param maxSize - Maximum single file size
+ * @param dateFormat - File name date format
+ * @returns pino Logger instance
+ */
 function createLoggerInstance(opts, logDir, logFileBase, logFileExt, level, prettyPrint, frequency, maxSize, dateFormat) {
     const targets = buildTransportTargets(logDir, logFileBase, logFileExt, level, prettyPrint, frequency, maxSize, dateFormat);
     const transport = pino_1.default.transport({ targets });
     return (0, pino_1.default)(opts, transport);
 }
+/**
+ * Create three log instances (logger / coreLogger / errorLogger)
+ *
+ * Merges default configuration and user configuration, creating independent pino instances for each log file.
+ * errorLogger level is fixed to error; others use the configured level.
+ *
+ * @param config - Custom log configuration (optional, overrides system configuration)
+ * @returns PinoLoggers object containing three log instances
+ */
 function create(config = {}) {
     const defaults = (0, default_config_js_1.default)().logger;
     let loggerConf;
     if (Object.keys(config).length === 0) {
+        // No custom configuration: use system configuration to override defaults
         const sysConfig = (0, index_js_1.getConfig)();
         loggerConf = (0, extend_js_1.extend)(true, { ...defaults }, sysConfig.logger);
     }
     else {
+        // Has custom configuration: use custom configuration to override defaults
         loggerConf = (0, extend_js_1.extend)(true, { ...defaults }, config);
     }
     const logDir = loggerConf.dir || (0, index_js_2.getLogDir)();
@@ -83,6 +195,10 @@ function create(config = {}) {
     const redactCensor = loggerConf.redactCensor || '[Redacted]';
     const name = loggerConf.name || 'ee';
     const timestamp = loggerConf.timestamp ?? true;
+    // Default 'UTC' keeps file logs machine-readable (standard ISO 'Z'); set an IANA zone
+    // (e.g. 'Asia/Shanghai') to emit wall-clock time with offset instead.
+    const timezone = loggerConf.timezone || 'UTC';
+    // Unify maxSize to string format supported by pino-roll (e.g., '10m')
     const maxSize = typeof loggerConf.maxSize === 'number'
         ? `${loggerConf.maxSize / 1024 / 1024}m`
         : loggerConf.maxSize || '10m';
@@ -93,10 +209,11 @@ function create(config = {}) {
     const depthLimit = loggerConf.depthLimit ?? 5;
     const safe = loggerConf.safe ?? true;
     const enabled = loggerConf.enabled ?? true;
+    // Build pino base configuration
     const baseOpts = {
         level,
         name,
-        timestamp: timestamp ? pino_1.default.stdTimeFunctions.isoTime : false,
+        timestamp: timestamp ? buildTimezoneTimeFn(timezone) : false,
         depthLimit,
         safe,
         enabled,
@@ -110,11 +227,14 @@ function create(config = {}) {
     if (redact.length > 0) {
         baseOpts.redact = { paths: redact, censor: redactCensor };
     }
+    // Parse log file names
     const appParsed = parseLogFileName(appLogName);
     const coreParsed = parseLogFileName(coreLogName);
     const errorParsed = parseLogFileName(errorLogName);
+    // Create three independent log instances
     const loggerInstance = createLoggerInstance(baseOpts, logDir, appParsed.base, appParsed.ext, level, prettyPrint, frequency, maxSize, dateFormat);
     const coreLoggerInstance = createLoggerInstance({ ...baseOpts, name: `${name}-core` }, logDir, coreParsed.base, coreParsed.ext, level, prettyPrint, frequency, maxSize, dateFormat);
+    // errorLogger is fixed to error level
     const errorLoggerInstance = createLoggerInstance({ ...baseOpts, level: 'error', name: `${name}-error` }, logDir, errorParsed.base, errorParsed.ext, 'error', prettyPrint, frequency, maxSize, dateFormat);
     debugLog('[create] level: %s, dir: %s, frequency: %s', level, logDir, frequency);
     return {

package/dist/cjs/log/logger.js.map

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