@adatechnology/logger 0.0.11 → 0.0.12

package/dist/index.d.ts

@@ -90,6 +90,20 @@ interface LoggerConfig extends WinstonModuleConfig {
      * Suporta prefixo exato ou parcial via startsWith
      */
     interceptorExcludedPaths?: string[];
+    /**
+     * Habilita rastreamento de stack de chamadas nos logs (default: false)
+     */
+    enableTraceStack?: boolean;
+    /**
+     * Configuração de file transport para os logs
+     */
+    fileTransport?: {
+        enabled: boolean;
+        dir?: string;
+        filename?: string;
+        maxSize?: string;
+        maxFiles?: string;
+    };
 }
 declare const DEFAULT_LOGGER_CONFIG: LoggerConfig;
 
@@ -137,9 +151,14 @@ declare const HTTP_LOGGING_INTERCEPTOR_CONTEXT: {
 
 declare const ExcludeHttpLogging: () => _nestjs_common.CustomDecorator<string>;
 
-type RequestContext = Record<string, unknown> | undefined;
+type RequestContext = (Record<string, unknown> & {
+    traceStack?: string[];
+}) | undefined;
 
 declare function getContext(): RequestContext;
 declare function runWithContext<T>(ctx: Record<string, unknown>, fn: () => T): T;
+declare function getTraceStack(): string[];
+declare function pushToTraceStack(method: string): void;
+declare function popFromTraceStack(): void;
 
-export { DEFAULT_LOGGER_CONFIG, type DebugParams, type DebugResult, type ErrorParams, type ErrorResult, ExcludeHttpLogging, HTTP_LOGGING_INTERCEPTOR, HTTP_LOGGING_INTERCEPTOR_CONTEXT, HttpLoggingInterceptor, type InfoParams, type InfoResult, LOGGER_CONFIG, LOGGER_PROVIDER, type LogParams, type LogResult, type LoggerConfig, LoggerLevel, LoggerModule, type LoggerProviderInterface, RequestContextMiddleware, type WarnParams, type WarnResult, type WriteLogParams, type WriteLogResult, getContext, runWithContext };
+export { DEFAULT_LOGGER_CONFIG, type DebugParams, type DebugResult, type ErrorParams, type ErrorResult, ExcludeHttpLogging, HTTP_LOGGING_INTERCEPTOR, HTTP_LOGGING_INTERCEPTOR_CONTEXT, HttpLoggingInterceptor, type InfoParams, type InfoResult, LOGGER_CONFIG, LOGGER_PROVIDER, type LogParams, type LogResult, type LoggerConfig, LoggerLevel, LoggerModule, type LoggerProviderInterface, RequestContextMiddleware, type WarnParams, type WarnResult, type WriteLogParams, type WriteLogResult, getContext, getTraceStack, popFromTraceStack, pushToTraceStack, runWithContext };

package/dist/index.js

@@ -9008,6 +9008,9 @@ __export(index_exports, {
   LoggerModule: () => LoggerModule,
   RequestContextMiddleware: () => RequestContextMiddleware,
   getContext: () => getContext,
+  getTraceStack: () => getTraceStack,
+  popFromTraceStack: () => popFromTraceStack,
+  pushToTraceStack: () => pushToTraceStack,
   runWithContext: () => runWithContext
 });
 module.exports = __toCommonJS(index_exports);
@@ -9110,6 +9113,30 @@ function runWithContext(ctx, fn) {
   return asyncLocalStorage.run(ctx, fn);
 }
 __name(runWithContext, "runWithContext");
+function getTraceStack() {
+  const ctx = getContext();
+  if (!ctx) return [];
+  if (!ctx.traceStack) {
+    ctx.traceStack = [];
+  }
+  return ctx.traceStack;
+}
+__name(getTraceStack, "getTraceStack");
+function pushToTraceStack(method) {
+  const ctx = getContext();
+  if (!ctx) return;
+  if (!ctx.traceStack) {
+    ctx.traceStack = [];
+  }
+  ctx.traceStack.push(method);
+}
+__name(pushToTraceStack, "pushToTraceStack");
+function popFromTraceStack() {
+  const ctx = getContext();
+  if (!ctx || !ctx.traceStack) return;
+  ctx.traceStack.pop();
+}
+__name(popFromTraceStack, "popFromTraceStack");
 
 // src/logger.constant.ts
 var DEFAULT_SENSITIVE_KEYS = [
@@ -9160,10 +9187,12 @@ var WinstonLoggerProvider = class {
   }
   logger;
   obfuscator;
+  config;
   context;
-  constructor(logger, obfuscator) {
+  constructor(logger, obfuscator, config) {
     this.logger = logger;
     this.obfuscator = obfuscator;
+    this.config = config;
   }
   debug(payload) {
     this.log({
@@ -9218,6 +9247,12 @@ var WinstonLoggerProvider = class {
       requestId: requestIdFromContext || rest.requestId,
       meta: obfuscatedMeta
     };
+    if (this.config?.enableTraceStack) {
+      const traceStack = getTraceStack();
+      if (traceStack.length > 0) {
+        logInfo.traceStack = traceStack;
+      }
+    }
     this.logger.log(level, messageText, logInfo);
   }
 };
@@ -9225,10 +9260,12 @@ WinstonLoggerProvider = _ts_decorate2([
   (0, import_common2.Injectable)(),
   _ts_param2(0, (0, import_common2.Inject)(WINSTON_RAW)),
   _ts_param2(1, (0, import_common2.Inject)(WINSTON_OBFUSCATOR)),
+  _ts_param2(2, (0, import_common2.Inject)("LOGGER_CONFIG")),
   _ts_metadata2("design:type", Function),
   _ts_metadata2("design:paramtypes", [
     typeof import_winston.Logger === "undefined" ? Object : import_winston.Logger,
-    typeof Obfuscator === "undefined" ? Object : Obfuscator
+    typeof Obfuscator === "undefined" ? Object : Obfuscator,
+    typeof LoggerConfig === "undefined" ? Object : LoggerConfig
   ])
 ], WinstonLoggerProvider);
 
@@ -9355,7 +9392,8 @@ function fillInfoFromMeta(info) {
     "libVersion",
     "libMethod",
     "appName",
-    "appVersion"
+    "appVersion",
+    "traceStack"
   ];
   for (const key of metadataKeys) {
     if (meta[key] && !info[key]) {
@@ -9440,6 +9478,7 @@ function formatDevelopmentLog(infoInput, useColors, levelColorizer) {
   const libMethod = asString(info.libMethod);
   const libVersion = asString(info.libVersion);
   const stack = asString(info.stack);
+  const traceStack = Array.isArray(info.traceStack) ? info.traceStack : void 0;
   const meta = info.meta && typeof info.meta === "object" ? info.meta : void 0;
   const colors = {
     reset: "\x1B[0m",
@@ -9471,7 +9510,12 @@ function formatDevelopmentLog(infoInput, useColors, levelColorizer) {
     libMethod,
     colorize: /* @__PURE__ */ __name((text) => colorizeText(useColors, colors.magenta, colors.reset, text), "colorize")
   });
-  let output = `${appDisplay}${libDisplay}[${coloredRequestId}][${coloredTime}]${sourceDisplay}${libMethodDisplay}[${coloredLevel}] - ${message}`;
+  let traceStackDisplay = "";
+  if (traceStack && traceStack.length > 0) {
+    const stackItems = traceStack.map((item) => `[${colorizeText(useColors, colors.magenta, colors.reset, item)}]`).join("");
+    traceStackDisplay = stackItems;
+  }
+  let output = `${appDisplay}${libDisplay}[${coloredRequestId}][${coloredTime}]${sourceDisplay}${traceStackDisplay}${libMethodDisplay}[${coloredLevel}] - ${message}`;
   if (meta && typeof meta === "object" && Object.keys(meta).length > 0) {
     const inspectedMeta = (0, import_node_util.inspect)(meta, {
       colors: useColors,
@@ -9545,6 +9589,10 @@ var WinstonImplementationModule = class _WinstonImplementationModule {
     const winstonLogger = this.createWinstonLogger(config);
     const obfuscator = config?.obfuscator ?? buildDefaultObfuscator(config?.obfuscatorKeys);
     return [
+      {
+        provide: "LOGGER_CONFIG",
+        useValue: config
+      },
       {
         provide: WINSTON_RAW,
         useValue: winstonLogger
@@ -9587,12 +9635,29 @@ var WinstonImplementationModule = class _WinstonImplementationModule {
     const consoleTransport = new import_winston2.transports.Console({
       format: defaultFormat
     });
+    const transportsList = [
+      consoleTransport
+    ];
+    if (config?.fileTransport?.enabled) {
+      try {
+        const DailyRotateFile = require("winston-daily-rotate-file");
+        const fileTransport = new DailyRotateFile({
+          dirname: config.fileTransport.dir ?? "logs",
+          filename: config.fileTransport.filename ?? "app-%DATE%.log",
+          datePattern: "YYYY-MM-DD",
+          maxSize: config.fileTransport.maxSize ?? "20m",
+          maxFiles: config.fileTransport.maxFiles ?? "14d",
+          format: isProduction ? import_winston2.format.json() : developmentFormat
+        });
+        transportsList.push(fileTransport);
+      } catch (error) {
+        console.warn("winston-daily-rotate-file not installed, skipping file transport");
+      }
+    }
     const defaultOptions = {
       level: config?.level || process.env.LOG_LEVEL || DEFAULT_LOG_LEVEL,
       format: defaultFormat,
-      transports: [
-        consoleTransport
-      ]
+      transports: transportsList
     };
     const mergedOptions = config?.loggerOptions ? {
       ...defaultOptions,
@@ -9878,5 +9943,8 @@ var DEFAULT_LOGGER_CONFIG = {
   LoggerModule,
   RequestContextMiddleware,
   getContext,
+  getTraceStack,
+  popFromTraceStack,
+  pushToTraceStack,
   runWithContext
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adatechnology/logger",
-  "version": "0.0.11",
+  "version": "0.0.12",
   "publishConfig": {
     "access": "public"
   },
@@ -16,7 +16,8 @@
     "tsup": "^8.5.1"
   },
   "dependencies": {
-    "winston": "^3.9.0"
+    "winston": "^3.9.0",
+    "winston-daily-rotate-file": "^5.0.0"
   },
   "scripts": {
     "prebuild": "rm -rf dist",

package/src/context/async-context.service.ts

@@ -15,3 +15,27 @@ export function runWithContext<T>(
 ): T {
   return asyncLocalStorage.run(ctx, fn as any);
 }
+
+export function getTraceStack(): string[] {
+  const ctx = getContext();
+  if (!ctx) return [];
+  if (!ctx.traceStack) {
+    ctx.traceStack = [];
+  }
+  return ctx.traceStack as string[];
+}
+
+export function pushToTraceStack(method: string): void {
+  const ctx = getContext();
+  if (!ctx) return;
+  if (!ctx.traceStack) {
+    ctx.traceStack = [];
+  }
+  (ctx.traceStack as string[]).push(method);
+}
+
+export function popFromTraceStack(): void {
+  const ctx = getContext();
+  if (!ctx || !ctx.traceStack) return;
+  (ctx.traceStack as string[]).pop();
+}

package/src/context/async-context.types.ts

@@ -1 +1,3 @@
-export type RequestContext = Record<string, unknown> | undefined;
+export type RequestContext = (Record<string, unknown> & {
+  traceStack?: string[];
+}) | undefined;

package/src/implementations/winston/winston.logger.module.ts

@@ -25,6 +25,7 @@ type WritableLogInfo = Record<string, unknown> & {
   libMethod?: unknown;
   stack?: unknown;
   meta?: unknown;
+  traceStack?: unknown;
 };
 
 type MetaLogContext = {
@@ -62,6 +63,7 @@ function fillInfoFromMeta(info: WritableLogInfo): void {
     "libMethod",
     "appName",
     "appVersion",
+    "traceStack",
   ] as const;
 
   for (const key of metadataKeys) {
@@ -157,6 +159,7 @@ function formatDevelopmentLog(
   const libMethod = asString(info.libMethod);
   const libVersion = asString(info.libVersion);
   const stack = asString(info.stack);
+  const traceStack = Array.isArray(info.traceStack) ? info.traceStack : undefined;
 
   const meta =
     info.meta && typeof info.meta === "object"
@@ -212,7 +215,15 @@ function formatDevelopmentLog(
       colorizeText(useColors, colors.magenta, colors.reset, text),
   });
 
-  let output = `${appDisplay}${libDisplay}[${coloredRequestId}][${coloredTime}]${sourceDisplay}${libMethodDisplay}[${coloredLevel}] - ${message}`;
+  let traceStackDisplay = "";
+  if (traceStack && traceStack.length > 0) {
+    const stackItems = traceStack
+      .map((item) => `[${colorizeText(useColors, colors.magenta, colors.reset, item)}]`)
+      .join("");
+    traceStackDisplay = stackItems;
+  }
+
+  let output = `${appDisplay}${libDisplay}[${coloredRequestId}][${coloredTime}]${sourceDisplay}${traceStackDisplay}${libMethodDisplay}[${coloredLevel}] - ${message}`;
 
   if (meta && typeof meta === "object" && Object.keys(meta).length > 0) {
     const inspectedMeta = inspect(meta, {
@@ -290,6 +301,10 @@ export class WinstonImplementationModule {
       config?.obfuscator ?? buildDefaultObfuscator(config?.obfuscatorKeys);
 
     return [
+      {
+        provide: "LOGGER_CONFIG",
+        useValue: config,
+      },
       {
         provide: WINSTON_RAW,
         useValue: winstonLogger,
@@ -344,11 +359,32 @@ export class WinstonImplementationModule {
       format: defaultFormat,
     });
 
+    const transportsList: any[] = [consoleTransport];
+
+    if (config?.fileTransport?.enabled) {
+      try {
+        const DailyRotateFile = require("winston-daily-rotate-file");
+        const fileTransport = new DailyRotateFile({
+          dirname: config.fileTransport.dir ?? "logs",
+          filename: config.fileTransport.filename ?? "app-%DATE%.log",
+          datePattern: "YYYY-MM-DD",
+          maxSize: config.fileTransport.maxSize ?? "20m",
+          maxFiles: config.fileTransport.maxFiles ?? "14d",
+          format: isProduction ? format.json() : developmentFormat,
+        });
+        transportsList.push(fileTransport);
+      } catch (error) {
+        console.warn(
+          "winston-daily-rotate-file not installed, skipping file transport",
+        );
+      }
+    }
+
     const defaultOptions: LoggerOptions = {
       level:
         config?.level || (process.env.LOG_LEVEL as any) || DEFAULT_LOG_LEVEL,
       format: defaultFormat,
-      transports: [consoleTransport],
+      transports: transportsList,
     };
 
     const mergedOptions: LoggerOptions = config?.loggerOptions

package/src/implementations/winston/winston.logger.provider.ts

@@ -15,9 +15,10 @@ import {
   type WriteLogResult,
 } from "../../logger.interface";
 import type { Obfuscator } from "./winston.logger.types";
-import { getContext } from "../../context/async-context.service";
+import { getContext, getTraceStack } from "../../context/async-context.service";
 import { EMPTY_STRING } from "../../logger.constant";
 import { WINSTON_RAW, WINSTON_OBFUSCATOR } from "./winston.logger.token";
+import type { LoggerConfig } from "../../logger.config";
 
 @Injectable()
 export class WinstonLoggerProvider implements LoggerProviderInterface {
@@ -26,6 +27,7 @@ export class WinstonLoggerProvider implements LoggerProviderInterface {
   constructor(
     @Inject(WINSTON_RAW) private readonly logger: WinstonLoggerType,
     @Inject(WINSTON_OBFUSCATOR) private readonly obfuscator?: Obfuscator,
+    @Inject("LOGGER_CONFIG") private readonly config?: LoggerConfig,
   ) {}
 
   debug(payload: DebugParams): DebugResult {
@@ -92,6 +94,13 @@ export class WinstonLoggerProvider implements LoggerProviderInterface {
       meta: obfuscatedMeta,
     };
 
+    if (this.config?.enableTraceStack) {
+      const traceStack = getTraceStack();
+      if (traceStack.length > 0) {
+        logInfo.traceStack = traceStack;
+      }
+    }
+
     this.logger.log(level as unknown as string, messageText, logInfo);
   }
 }

package/src/index.ts

@@ -20,6 +20,12 @@ export { RequestContextMiddleware } from "./middleware/request-context.middlewar
 export { HttpLoggingInterceptor } from "./interceptors/http-logging.interceptor";
 export { HTTP_LOGGING_INTERCEPTOR_CONTEXT } from "./interceptors/http-logging.interceptor.constant";
 export { ExcludeHttpLogging } from "./interceptors/exclude-http-logging.decorator";
-export { getContext, runWithContext } from "./context/async-context.service";
+export {
+  getContext,
+  runWithContext,
+  getTraceStack,
+  pushToTraceStack,
+  popFromTraceStack,
+} from "./context/async-context.service";
 export type { LoggerConfig } from "./logger.config";
 export { DEFAULT_LOGGER_CONFIG } from "./logger.config";

package/src/logger.config.ts

@@ -52,6 +52,22 @@ export interface LoggerConfig extends WinstonModuleConfig {
    * Suporta prefixo exato ou parcial via startsWith
    */
   interceptorExcludedPaths?: string[];
+
+  /**
+   * Habilita rastreamento de stack de chamadas nos logs (default: false)
+   */
+  enableTraceStack?: boolean;
+
+  /**
+   * Configuração de file transport para os logs
+   */
+  fileTransport?: {
+    enabled: boolean;
+    dir?: string;
+    filename?: string;
+    maxSize?: string;
+    maxFiles?: string;
+  };
 }
 
 export const DEFAULT_LOGGER_CONFIG: LoggerConfig = {