@lark-apaas/nestjs-logger 1.0.10 → 1.0.12

package/README.md

@@ -365,9 +365,11 @@ NestJS LoggerService 级别到 Pino 级别的映射：
 
 ### 存储
 
-1. 日志直接写入文件，不支持自动轮转，建议通过外部工具（如 logrotate）管理日志文件
-2. verbose 级别 + 请求/响应体日志会显著增加日志量
-3. 建议设置 `LOG_MAX_BODY_LENGTH` 限制单条日志大小（默认不限制）
+1. 开发环境默认启用日志轮转（基于 [rotating-file-stream](https://github.com/iccicci/rotating-file-stream)），活跃文件始终为 `server.log`，归档为 `server.log.1`（最新）→ `server.log.N`（最旧）
+2. 默认单文件 10MB，最多保留 5 个归档，总占用上限约 60MB
+3. 可通过环境变量控制轮转行为：`LOG_ROTATION_ENABLED`、`LOG_ROTATION_MAX_SIZE`、`LOG_ROTATION_MAX_FILES`
+4. verbose 级别 + 请求/响应体日志会显著增加日志量
+5. 建议设置 `LOG_MAX_BODY_LENGTH` 限制单条日志大小（默认不限制）
 
 ## 最佳实践
 

package/dist/index.cjs

@@ -9022,7 +9022,7 @@ var import_nestjs_common = require("@lark-apaas/nestjs-common");
 function safeStringify(obj) {
   const seen = /* @__PURE__ */ new Set();
   try {
-    return JSON.stringify(obj, (key, value) => {
+    return JSON.stringify(obj, (_key, value) => {
       if (typeof value === "object" && value !== null) {
         if (seen.has(value)) {
           return "[Circular]";
@@ -9482,7 +9482,12 @@ var logger_config_default = (0, import_config.registerAs)("logger", () => {
     logDir: process.env.LOG_DIR || "logs",
     logRequestBody: process.env.LOG_REQUEST_BODY === "true",
     logResponseBody: process.env.LOG_RESPONSE_BODY === "true",
-    maxBodyLength
+    maxBodyLength,
+    rotation: {
+      enabled: process.env.LOG_ROTATION_ENABLED !== "false",
+      maxSize: process.env.LOG_ROTATION_MAX_SIZE || "10m",
+      maxFiles: Number(process.env.LOG_ROTATION_MAX_FILES) || 5
+    }
   };
 });
 
@@ -9716,38 +9721,28 @@ LoggingInterceptor = _ts_decorate2([
 var import_fs = require("fs");
 var import_path = require("path");
 var import_pino = __toESM(require("pino"), 1);
-function createPinoLogger(config) {
-  const baseLevel = normalizeLevel(config.level);
-  const options = {
-    base: void 0,
-    messageKey: "message",
-    level: baseLevel,
-    timestamp: import_pino.stdTimeFunctions.isoTime,
-    formatters: {
-      level(label) {
-        return {
-          level: label.toUpperCase()
-        };
-      }
-    }
-  };
-  const streams = [
-    {
-      level: config.level,
-      stream: createFileDestination(config.filePath)
+var import_rotating_file_stream = require("rotating-file-stream");
+var pinoBaseOptions = {
+  base: void 0,
+  messageKey: "message",
+  timestamp: import_pino.stdTimeFunctions.isoTime,
+  formatters: {
+    level(label) {
+      return {
+        level: label.toUpperCase()
+      };
     }
-  ];
-  if (streams.length === 0) {
-    return (0, import_pino.default)(options);
   }
-  if (streams.length === 1) {
-    return (0, import_pino.default)(options, streams[0].stream);
+};
+function createPinoLogger(config) {
+  const baseLevel = normalizeLevel(config.level);
+  if (process.env.NODE_ENV !== "development") {
+    return (0, import_pino.default)({
+      ...pinoBaseOptions,
+      level: "silent"
+    });
   }
-  return (0, import_pino.default)(options, import_pino.default.multistream(streams));
-}
-__name(createPinoLogger, "createPinoLogger");
-function createFileDestination(pathname) {
-  const target = pathname && pathname.length > 0 ? pathname : "logs/server.log";
+  const target = config.filePath || "logs/server.log";
   const resolved = (0, import_path.isAbsolute)(target) ? target : (0, import_path.join)(process.cwd(), target);
   const dir = (0, import_path.dirname)(resolved);
   if (!(0, import_fs.existsSync)(dir)) {
@@ -9755,12 +9750,27 @@ function createFileDestination(pathname) {
       recursive: true
     });
   }
-  return import_pino.default.destination({
+  if (config.rotation?.enabled) {
+    const size = config.rotation.maxSize.replace(/[kmgb]$/i, (c) => c.toUpperCase());
+    const stream = (0, import_rotating_file_stream.createStream)((0, import_path.basename)(resolved), {
+      size,
+      rotate: config.rotation.maxFiles,
+      path: dir
+    });
+    return (0, import_pino.default)({
+      ...pinoBaseOptions,
+      level: baseLevel
+    }, stream);
+  }
+  return (0, import_pino.default)({
+    ...pinoBaseOptions,
+    level: baseLevel
+  }, import_pino.default.destination({
     dest: resolved,
     mkdir: true
-  });
+  }));
 }
-__name(createFileDestination, "createFileDestination");
+__name(createPinoLogger, "createPinoLogger");
 
 // src/middleware/logger-context.middleware.ts
 var import_common3 = require("@nestjs/common");
@@ -9846,7 +9856,8 @@ LoggerModule = _ts_decorate4([
         useFactory: /* @__PURE__ */ __name((config) => {
           return createPinoLogger({
             level: config.level,
-            filePath: `${config.logDir}/server.log`
+            filePath: `${config.logDir}/server.log`,
+            rotation: config.rotation
           });
         }, "useFactory"),
         inject: [
@@ -9857,7 +9868,8 @@ LoggerModule = _ts_decorate4([
         provide: TRACE_LOGGER,
         useFactory: /* @__PURE__ */ __name((requestContext, config, observableService) => new PinoLoggerService(createPinoLogger({
           level: config.level,
-          filePath: `${config.logDir}/trace.log`
+          filePath: `${config.logDir}/trace.log`,
+          rotation: config.rotation
         }), requestContext, observableService), "useFactory"),
         inject: [
           import_nestjs_common4.RequestContextService,