@vritti/api-sdk 0.3.2 → 0.3.5

package/dist/logger.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/logger/index.ts","../src/logger/interceptors/http-logger.interceptor.ts","../src/exceptions/conflict.exception.ts","../src/exceptions/base-field.exception.ts","../src/filters/pg-error.translator.ts","../src/logger/services/logger.service.ts","../src/logger/utils/index.ts","../src/logger/logger.module.ts","../src/logger/middleware/correlation-id.middleware.ts"],"sourcesContent":["export { HttpLoggerInterceptor } from './interceptors/http-logger.interceptor';\n// Main Module (import this in your AppModule)\nexport { LOGGER_MODULE_OPTIONS, LoggerModule } from './logger.module';\n\n// Middleware & Interceptors\nexport { CorrelationIdMiddleware } from './middleware/correlation-id.middleware';\n// Main Service (inject this in your services)\nexport { LoggerService } from './services/logger.service';\n\n// Type Definitions\nexport type {\n  CorrelationContext,\n  HttpLoggerOptions,\n  LogFormat,\n  LoggerModuleAsyncOptions,\n  LoggerModuleOptions,\n  LoggerOptionsFactory,\n  LogLevel,\n  LogMetadata,\n} from './types';\n\n// Utility Functions\nexport {\n  addCorrelationIdToResponse,\n  // AsyncLocalStorage management\n  correlationStorage,\n  // Correlation ID helpers\n  DEFAULT_CORRELATION_HEADER,\n  generateCorrelationId,\n  getCorrelationContext,\n  runWithCorrelationContext,\n  updateCorrelationContext,\n} from './utils';\n","import { type CallHandler, type ExecutionContext, Injectable, type NestInterceptor, Optional } from '@nestjs/common';\nimport type { FastifyReply, FastifyRequest } from 'fastify';\nimport type { Observable } from 'rxjs';\nimport { catchError, tap } from 'rxjs/operators';\nimport { findPgError } from '../../filters/pg-error.translator';\nimport { LoggerService } from '../services/logger.service';\nimport type { HttpLoggerOptions, LogMetadata } from '../types';\nimport { getCorrelationContext } from '../utils';\n\n@Injectable()\nexport class HttpLoggerInterceptor implements NestInterceptor {\n  private readonly enableRequestLog: boolean;\n  private readonly enableResponseLog: boolean;\n  private readonly slowRequestThreshold: number;\n\n  constructor(\n    private readonly logger: LoggerService,\n    @Optional() options?: HttpLoggerOptions,\n  ) {\n    this.enableRequestLog = options?.enableRequestLog ?? true;\n    this.enableResponseLog = options?.enableResponseLog ?? true;\n    this.slowRequestThreshold = options?.slowRequestThreshold ?? 3000; // 3 seconds\n  }\n\n  intercept(context: ExecutionContext, next: CallHandler): Observable<unknown> {\n    if (context.getType() !== 'http') {\n      return next.handle();\n    }\n\n    const httpContext = context.switchToHttp();\n    const request = httpContext.getRequest<FastifyRequest>();\n    const response = httpContext.getResponse<FastifyReply>();\n\n    const startTime = Date.now();\n\n    // Log incoming request\n    if (this.enableRequestLog) {\n      this.logRequest(request);\n    }\n\n    // Process request and log response/errors\n    return next.handle().pipe(\n      tap(() => {\n        if (this.enableResponseLog) {\n          const duration = Date.now() - startTime;\n          this.logResponse(request, response, duration);\n        }\n      }),\n      catchError((error) => {\n        const duration = Date.now() - startTime;\n        this.logError(request, response, duration, error);\n        throw error;\n      }),\n    );\n  }\n\n  private logRequest(request: FastifyRequest): void {\n    try {\n      const correlationContext = getCorrelationContext();\n      const metadata: LogMetadata = {\n        type: 'http_request',\n        method: request.method,\n        url: request.url,\n        correlationId: correlationContext?.correlationId,\n        ip: request.ip,\n        userAgent: request.headers['user-agent'],\n      };\n\n      this.logger.logWithMetadata('log', `Incoming ${request.method} ${request.url}`, metadata);\n    } catch (error) {\n      this.logger.error('Failed to log HTTP request', (error as Error).stack);\n    }\n  }\n\n  private logResponse(request: FastifyRequest, response: FastifyReply, duration: number): void {\n    try {\n      const correlationContext = getCorrelationContext();\n      const statusCode = response.statusCode;\n\n      // Determine log level based on status code\n      const logLevel = statusCode >= 500 ? 'error' : statusCode >= 400 ? 'warn' : 'log';\n\n      const metadata: LogMetadata = {\n        type: 'http_response',\n        method: request.method,\n        url: request.url,\n        statusCode,\n        duration,\n        correlationId: correlationContext?.correlationId,\n      };\n\n      // Flag slow requests\n      if (duration > this.slowRequestThreshold) {\n        metadata.slowRequest = true;\n      }\n\n      const message = metadata.slowRequest\n        ? `SLOW ${request.method} ${request.url} ${statusCode} - ${duration}ms`\n        : `${request.method} ${request.url} ${statusCode} - ${duration}ms`;\n\n      this.logger.logWithMetadata(logLevel, message, metadata);\n    } catch (error) {\n      this.logger.error('Failed to log HTTP response', (error as Error).stack);\n    }\n  }\n\n  private logError(request: FastifyRequest, response: FastifyReply, duration: number, error: unknown): void {\n    try {\n      const correlationContext = getCorrelationContext();\n      const err = error as {\n        name?: string;\n        message?: string;\n        detail?: string;\n        status?: number;\n        statusCode?: number;\n        stack?: string;\n        response?: unknown;\n      };\n      const statusCode = err.status ?? err.statusCode ?? response.statusCode ?? 500;\n      // Drizzle wraps pg errors in DrizzleQueryError whose `.message` is only the failed query — unwrap the real reason from `.cause`.\n      const pgCause = findPgError(error);\n      let errorMessage = err.message || err.detail || 'Unknown error';\n      if (pgCause?.message && pgCause.message !== err.message) {\n        errorMessage = `${errorMessage} — cause: ${pgCause.message}${pgCause.code ? ` [${pgCause.code}]` : ''}`;\n      }\n\n      const metadata: LogMetadata = {\n        type: 'http_error',\n        method: request.method,\n        url: request.url,\n        statusCode,\n        duration,\n        correlationId: correlationContext?.correlationId,\n        errorName: err.name || 'Error',\n        errorMessage,\n      };\n\n      // Attach the structured pg cause so log sinks capture SQLSTATE, constraint, table, etc.\n      if (pgCause) {\n        metadata.pgError = pgCause;\n      }\n\n      if (err.stack) {\n        metadata.trace = err.stack;\n      }\n\n      if (err.response) {\n        metadata.errorDetails = err.response;\n      }\n\n      const message = `ERROR ${request.method} ${request.url} ${statusCode} - ${errorMessage}`;\n      this.logger.logWithMetadata('error', message, metadata);\n    } catch (loggingError) {\n      this.logger.error('Failed to log HTTP error', (loggingError as Error).stack);\n    }\n  }\n}\n","import { HttpStatus } from '@nestjs/common';\nimport { HttpProblemException, type ProblemOptions } from './base-field.exception';\n\nexport class ConflictException extends HttpProblemException {\n  constructor(detailOrOptions?: string | ProblemOptions) {\n    super(detailOrOptions ?? 'Conflict', HttpStatus.CONFLICT);\n  }\n}\n","import { HttpException, HttpStatus } from '@nestjs/common';\nimport type { FieldError } from '../types/error-response.types';\n\n// Re-export FieldError for backwards compatibility\nexport type { FieldError } from '../types/error-response.types';\n\nexport interface ProblemOptions {\n  type?: string;\n  label?: string;\n  detail?: string;\n  errors?: FieldError[];\n}\n\nexport abstract class HttpProblemException extends HttpException {\n  constructor(detailOrOptions: string | ProblemOptions, httpStatus: HttpStatus) {\n    const options = typeof detailOrOptions === 'string' ? { detail: detailOrOptions } : detailOrOptions;\n\n    super(\n      {\n        type: options.type ?? 'about:blank',\n        label: options.label,\n        detail: options.detail,\n        errors: options.errors ?? [],\n      },\n      httpStatus,\n    );\n  }\n}\n","import { ConflictException } from '../exceptions/conflict.exception';\n\nconst PG_UNIQUE_VIOLATION = '23505';\n\nexport type PgErrorShape = {\n  code?: string;\n  message?: string;\n  constraint?: string;\n  table?: string;\n  schema?: string;\n  column?: string;\n  detail?: string;\n  hint?: string;\n};\n\n// Returns a ConflictException for a Postgres unique-violation error, otherwise undefined.\nexport function tryTranslatePgError(error: unknown): ConflictException | undefined {\n  const pgError = findPgError(error);\n  if (!pgError) return undefined;\n  const { code, constraint, table, detail } = pgError;\n  if (code !== PG_UNIQUE_VIOLATION) return undefined;\n  return new ConflictException({\n    label: 'Duplicate Entry',\n    detail: detail?.trim() || 'A record with these values already exists.',\n    errors: [],\n    ...(constraint || table ? { meta: { constraint, table } } : {}),\n  });\n}\n\n// Walks up to N levels of `.cause` looking for a pg-shaped error (has SQLSTATE `code`), capping depth.\nexport function findPgError(error: unknown, depth = 0): PgErrorShape | undefined {\n  if (!error || typeof error !== 'object' || depth > 5) return undefined;\n  const candidate = error as PgErrorShape & { cause?: unknown };\n  if (typeof candidate.code === 'string') return candidate;\n  return findPgError(candidate.cause, depth + 1);\n}\n","import { Injectable, type Logger, type LoggerService as NestLoggerService, Optional } from '@nestjs/common';\nimport { createLogger, format, type LoggerOptions, transports, type Logger as WinstonLogger } from 'winston';\nimport DailyRotateFile from 'winston-daily-rotate-file';\nimport type { LoggerModuleOptions, LogLevel, LogMetadata } from '../types';\nimport { getCorrelationContext } from '../utils';\n\nexport type LogMessage = string | Error | object;\n\n@Injectable()\nexport class LoggerService implements NestLoggerService {\n  private readonly activeLogger: NestLoggerService | WinstonLogger;\n  private readonly options: LoggerModuleOptions;\n  private context?: string;\n\n  constructor(\n    @Optional() options: LoggerModuleOptions = {},\n    @Optional() private readonly defaultLogger?: Logger,\n  ) {\n    this.options = options;\n    const provider = options.provider ?? 'winston';\n\n    if (provider === 'default') {\n      if (!this.defaultLogger) {\n        throw new Error('LoggerService: Default Logger not provided');\n      }\n      this.activeLogger = this.defaultLogger;\n    } else {\n      this.activeLogger = this.createWinstonLogger(options);\n    }\n  }\n\n  // Creates a Winston logger instance with inline transports and format configuration\n  private createWinstonLogger(opts: LoggerModuleOptions): WinstonLogger {\n    const level = opts.level ?? 'debug';\n    const logFormat = opts.format ?? 'text';\n\n    // Base formatters — Winston merges metadata into the info object, so all properties are already at the top level.\n    const baseFormatters = [format.timestamp({ format: 'YYYY-MM-DDTHH:mm:ss.SSSZ' }), format.errors({ stack: true })];\n\n    // Console transport\n    const consoleTransport =\n      logFormat === 'json'\n        ? new transports.Console({\n            level,\n            format: format.combine(...baseFormatters, format.json()),\n          })\n        : new transports.Console({\n            level,\n            format: format.combine(\n              ...baseFormatters,\n              format.printf((info) => {\n                const { timestamp, level, message, context, correlationId, trace } = info;\n                const parts = [\n                  timestamp,\n                  level.toUpperCase().padEnd(7),\n                  correlationId ? `[${correlationId.toString().slice(-6)}]` : '',\n                  context ? `[${context}]` : '',\n                  message,\n                ].filter(Boolean);\n                let output = parts.join(' ');\n\n                // Append stack trace on new line if present\n                if (trace) {\n                  output += `\\n${trace}`;\n                }\n\n                return output;\n              }),\n              format.colorize({ all: true }),\n            ),\n          });\n\n    const winstonTransports: (InstanceType<typeof transports.Console> | DailyRotateFile)[] = [consoleTransport];\n\n    // File transports\n    if (opts.enableFileLogger) {\n      const filePath = opts.filePath ?? './logs';\n      const maxFiles = opts.maxFiles ?? '14d';\n\n      winstonTransports.push(\n        new DailyRotateFile({\n          level,\n          filename: `${filePath}/%DATE%-combined.log`,\n          datePattern: 'YYYY-MM-DD',\n          maxSize: '20m',\n          maxFiles,\n          format: format.combine(format.timestamp(), format.json()),\n        }),\n        new DailyRotateFile({\n          level: 'error',\n          filename: `${filePath}/%DATE%-error.log`,\n          datePattern: 'YYYY-MM-DD',\n          maxSize: '20m',\n          maxFiles,\n          format: format.combine(format.timestamp(), format.json()),\n        }),\n      );\n    }\n\n    const config: LoggerOptions = {\n      level,\n      transports: winstonTransports,\n      exitOnError: false,\n    };\n\n    if (opts.defaultMeta || opts.appName) {\n      config.defaultMeta = {\n        ...opts.defaultMeta,\n        appName: opts.appName,\n        environment: opts.environment,\n      };\n    }\n\n    return createLogger(config);\n  }\n\n  // NestJS LoggerService interface methods\n  log(message: LogMessage, context?: string): void {\n    this._log('log', message, context);\n  }\n\n  error(message: LogMessage, trace?: string, context?: string): void {\n    this._log('error', message, context, trace);\n  }\n\n  warn(message: LogMessage, context?: string): void {\n    this._log('warn', message, context);\n  }\n\n  debug(message: LogMessage, context?: string): void {\n    this._log('debug', message, context);\n  }\n\n  verbose(message: LogMessage, context?: string): void {\n    this._log('verbose', message, context);\n  }\n\n  setContext(context: string): void {\n    this.context = context;\n  }\n\n  // Dispatches a log entry to either the Winston or NestJS logger implementation\n  private _log(level: LogLevel, message: LogMessage, context?: string, trace?: string): void {\n    const ctx = context ?? this.context;\n\n    // Check if Winston logger by duck typing\n    if ('format' in this.activeLogger && 'transports' in this.activeLogger) {\n      // Winston logger path\n      const winstonLogger = this.activeLogger as WinstonLogger;\n      const winstonLevel = level === 'log' ? 'info' : level;\n      const formattedMessage = this.formatMessage(message);\n      const metadata = this.enrichMetadata({}, ctx, trace);\n      // Winston merges all properties into the info object when using object syntax\n      winstonLogger.log({ level: winstonLevel, message: formattedMessage, ...metadata });\n    } else {\n      // NestJS logger path\n      const nestLogger = this.activeLogger as Logger;\n      if (level === 'error' && trace) {\n        ctx ? nestLogger.error(message, trace, ctx) : nestLogger.error(message, trace);\n      } else if (level === 'log') {\n        ctx ? nestLogger.log(message, ctx) : nestLogger.log(message);\n      } else if (level === 'warn') {\n        ctx ? nestLogger.warn(message, ctx) : nestLogger.warn(message);\n      } else if (level === 'debug' && nestLogger.debug) {\n        ctx ? nestLogger.debug(message, ctx) : nestLogger.debug(message);\n      } else if (level === 'verbose' && nestLogger.verbose) {\n        ctx ? nestLogger.verbose(message, ctx) : nestLogger.verbose(message);\n      }\n    }\n  }\n\n  // Logs a message with custom metadata fields (Winston only)\n  logWithMetadata(level: LogLevel, message: LogMessage, metadata?: LogMetadata, context?: string): void {\n    const ctx = context ?? this.context;\n\n    // Check if Winston logger by duck typing\n    if ('format' in this.activeLogger && 'transports' in this.activeLogger) {\n      const winstonLogger = this.activeLogger as WinstonLogger;\n      const winstonLevel = level === 'log' ? 'info' : level;\n      // Winston merges all properties into the info object when using object syntax\n      winstonLogger.log({ level: winstonLevel, message: this.formatMessage(message), ...metadata });\n    } else {\n      // Fallback for default logger\n      const messageWithMeta = metadata ? `${message} ${JSON.stringify(metadata)}` : message;\n      this[level](messageWithMeta, ctx);\n    }\n  }\n\n  private formatMessage(message: LogMessage): string {\n    if (message instanceof Error) return message.message;\n    if (typeof message === 'object' && message !== null) {\n      try {\n        return JSON.stringify(message);\n      } catch {\n        return String(message);\n      }\n    }\n    return String(message);\n  }\n\n  // Enriches metadata with correlation context from AsyncLocalStorage\n  private enrichMetadata(metadata: LogMetadata = {}, context?: string, trace?: string): LogMetadata {\n    const enriched: LogMetadata = { ...metadata };\n\n    if (context) enriched.context = context;\n\n    const correlationContext = getCorrelationContext();\n    if (correlationContext) {\n      if (correlationContext.correlationId) enriched.correlationId = correlationContext.correlationId;\n      for (const [key, value] of Object.entries(correlationContext)) {\n        if (key !== 'correlationId') {\n          enriched[key] = value;\n        }\n      }\n    }\n\n    if (trace) enriched.trace = trace;\n\n    return enriched;\n  }\n\n  child(context: string): LoggerService {\n    const childLogger = new LoggerService(this.options, this.defaultLogger);\n    childLogger.setContext(context);\n    return childLogger;\n  }\n}\n","import { AsyncLocalStorage } from 'node:async_hooks';\nimport { randomUUID } from 'node:crypto';\nimport type { FastifyReply } from 'fastify';\nimport type { CorrelationContext } from '../types';\n\n// Async Context Management (AsyncLocalStorage)\n\nexport const correlationStorage = new AsyncLocalStorage<CorrelationContext>();\n\n// Returns the current correlation context from AsyncLocalStorage\nexport function getCorrelationContext(): CorrelationContext | undefined {\n  return correlationStorage.getStore();\n}\n\n// Runs a callback within the given correlation context\nexport function runWithCorrelationContext<T>(context: CorrelationContext, callback: () => T): T {\n  return correlationStorage.run(context, callback);\n}\n\n// Updates the current correlation context with new values\nexport function updateCorrelationContext(updates: Partial<CorrelationContext>): void {\n  const context = correlationStorage.getStore();\n  if (context) {\n    Object.assign(context, updates);\n  }\n}\n\n// Correlation ID Management\n\nexport const DEFAULT_CORRELATION_HEADER = 'x-correlation-id';\n\n// Generates a new UUID v4 correlation ID for the current request\nexport function generateCorrelationId(): string {\n  return randomUUID();\n}\n\n// Adds the correlation ID to Fastify response headers\nexport function addCorrelationIdToResponse(\n  reply: FastifyReply,\n  correlationId: string,\n  headerName: string = DEFAULT_CORRELATION_HEADER,\n): void {\n  if (typeof reply.header === 'function') {\n    reply.header(headerName, correlationId);\n  } else if (reply.raw && typeof reply.raw.setHeader === 'function') {\n    reply.raw.setHeader(headerName, correlationId);\n  }\n}\n","import {\n  type DynamicModule,\n  Global,\n  Logger,\n  type MiddlewareConsumer,\n  Module,\n  type NestModule,\n  type Provider,\n} from '@nestjs/common';\nimport { HttpLoggerInterceptor } from './interceptors/http-logger.interceptor';\nimport { CorrelationIdMiddleware } from './middleware/correlation-id.middleware';\nimport { LoggerService } from './services/logger.service';\nimport type { LoggerModuleAsyncOptions, LoggerModuleOptions, LoggerOptionsFactory } from './types';\n\n// Constants (inline from constants.ts)\n\nexport const LOGGER_MODULE_OPTIONS = Symbol('LOGGER_MODULE_OPTIONS');\n\nconst DEFAULT_LOGGER_OPTIONS = {\n  provider: 'winston' as const,\n  enableCorrelationId: true,\n  enableHttpLogger: true,\n  filePath: './logs',\n  maxFiles: '14d',\n} as const;\n\n// Environment Presets (replaces process.env auto-detection)\n\nconst ENVIRONMENT_PRESETS: Record<string, Partial<LoggerModuleOptions>> = {\n  development: {\n    provider: 'winston',\n    level: 'debug',\n    format: 'text',\n    enableFileLogger: false,\n    enableCorrelationId: true,\n    enableHttpLogger: true,\n    httpLogger: {\n      enableRequestLog: true,\n      enableResponseLog: true,\n      slowRequestThreshold: 1000, // 1 second - lower threshold for dev\n    },\n  },\n\n  staging: {\n    provider: 'winston',\n    level: 'log',\n    format: 'json',\n    enableFileLogger: true,\n    enableCorrelationId: true,\n    enableHttpLogger: true,\n    httpLogger: {\n      enableRequestLog: true,\n      enableResponseLog: true,\n      slowRequestThreshold: 3000, // 3 seconds\n    },\n  },\n\n  production: {\n    provider: 'winston',\n    level: 'warn',\n    format: 'json',\n    enableFileLogger: true,\n    enableCorrelationId: true,\n    enableHttpLogger: true,\n    httpLogger: {\n      enableRequestLog: false, // Reduce noise in production\n      enableResponseLog: true,\n      slowRequestThreshold: 5000, // 5 seconds - higher threshold for prod\n    },\n  },\n\n  test: {\n    provider: 'winston',\n    level: 'error',\n    format: 'json',\n    enableFileLogger: false,\n    enableCorrelationId: false,\n    enableHttpLogger: false,\n  },\n} as const;\n\n// Configuration Merging (uses presets instead of process.env)\n\n// Merges user-provided options with default and environment preset values\nfunction mergeWithDefaults(options: LoggerModuleOptions = {}): LoggerModuleOptions {\n  // Select preset based on explicit environment option (defaults to development)\n  const preset = options.environment\n    ? (ENVIRONMENT_PRESETS[options.environment] ?? ENVIRONMENT_PRESETS.development)\n    : ENVIRONMENT_PRESETS.development;\n\n  // Filter out undefined values from user options to avoid overriding preset defaults\n  const filteredOptions = Object.fromEntries(Object.entries(options).filter(([_, value]) => value !== undefined));\n\n  // Handle nested httpLogger object - merge with preset httpLogger if both exist\n  if (filteredOptions.httpLogger && preset?.httpLogger) {\n    filteredOptions.httpLogger = {\n      ...preset.httpLogger,\n      ...Object.fromEntries(Object.entries(filteredOptions.httpLogger).filter(([_, value]) => value !== undefined)),\n    };\n  }\n\n  // Merge: base defaults < preset < user options (with undefined values removed)\n  const merged = {\n    ...DEFAULT_LOGGER_OPTIONS,\n    ...preset,\n    ...filteredOptions,\n  };\n\n  return merged;\n}\n\n// Provider Factories (inline from logging.providers.ts)\n\n// Creates the default NestJS Logger provider with optional log level configuration\nfunction createDefaultLoggerProvider(options: LoggerModuleOptions): Provider {\n  return {\n    provide: Logger,\n    useFactory: () => {\n      const logger = new Logger();\n\n      // Set log levels if specified and method exists\n      if (options.level) {\n        const levels = getLevelsUpTo(options.level);\n        (logger as { setLogLevels?: (levels: NestLogLevel[]) => void }).setLogLevels?.(levels);\n      }\n\n      return logger;\n    },\n  };\n}\n\n// Builds all logger providers for the module based on merged configuration\nfunction createLoggerProviders(options: LoggerModuleOptions = {}): Provider[] {\n  // Merge user options with preset defaults\n  const mergedOptions = mergeWithDefaults(options);\n\n  // Base providers (always included)\n  const providers: Provider[] = [\n    // Options provider\n    {\n      provide: LOGGER_MODULE_OPTIONS,\n      useValue: mergedOptions,\n    },\n  ];\n\n  // Default logger provider (only if using default provider)\n  if (mergedOptions.provider === 'default') {\n    providers.push(createDefaultLoggerProvider(mergedOptions));\n  }\n\n  // Unified LoggerService facade (always included)\n  providers.push({\n    provide: LoggerService,\n    useFactory: (opts: LoggerModuleOptions, defaultLogger?: Logger) => {\n      return new LoggerService(opts, defaultLogger);\n    },\n    inject: [LOGGER_MODULE_OPTIONS, { token: Logger, optional: true }],\n  });\n\n  // Correlation ID middleware\n  providers.push({\n    provide: CorrelationIdMiddleware,\n    useFactory: () => {\n      return new CorrelationIdMiddleware({\n        includeInResponse: true,\n        responseHeader: 'x-correlation-id',\n      });\n    },\n  });\n\n  // HTTP logger interceptor\n  providers.push({\n    provide: HttpLoggerInterceptor,\n    useFactory: (logger: LoggerService, opts: LoggerModuleOptions) => {\n      // Use detailed httpLogger config if provided, otherwise fall back to simple enableHttpLogger\n      const httpLoggerOptions = opts.httpLogger ?? {\n        enableRequestLog: opts.enableHttpLogger,\n        enableResponseLog: opts.enableHttpLogger,\n      };\n      return new HttpLoggerInterceptor(logger, httpLoggerOptions);\n    },\n    inject: [LoggerService, LOGGER_MODULE_OPTIONS],\n  });\n\n  return providers;\n}\n\ntype NestLogLevel = 'error' | 'warn' | 'log' | 'debug' | 'verbose';\n\n// Returns all NestJS log levels up to and including the specified level\nfunction getLevelsUpTo(level: string): NestLogLevel[] {\n  const allLevels: NestLogLevel[] = ['error', 'warn', 'log', 'debug', 'verbose'];\n\n  // Check if level is a valid NestLogLevel\n  const isValidLevel = (l: string): l is NestLogLevel => allLevels.includes(l as NestLogLevel);\n\n  if (!isValidLevel(level)) {\n    return ['error', 'warn', 'log'];\n  }\n\n  const levelIndex = allLevels.indexOf(level);\n  return allLevels.slice(0, levelIndex + 1);\n}\n\n@Global()\n@Module({})\nexport class LoggerModule implements NestModule {\n  // Configures the logger module with static options and environment preset\n  static forRoot(options: LoggerModuleOptions = {}): DynamicModule {\n    const providers = createLoggerProviders(options);\n\n    return {\n      module: LoggerModule,\n      providers,\n      exports: [LoggerService, CorrelationIdMiddleware, HttpLoggerInterceptor, LOGGER_MODULE_OPTIONS],\n    };\n  }\n\n  // Configures the logger module with async options (useFactory, useClass, useExisting)\n  static forRootAsync<T extends unknown[] = unknown[]>(options: LoggerModuleAsyncOptions<T>): DynamicModule {\n    const asyncProviders = LoggerModule.createAsyncProviders(options as LoggerModuleAsyncOptions<unknown[]>);\n\n    return {\n      module: LoggerModule,\n      imports: options.imports || [],\n      providers: [\n        ...asyncProviders,\n        // Default logger provider\n        {\n          provide: Logger,\n          useFactory: (opts: LoggerModuleOptions) => {\n            if (opts.provider === 'default') {\n              const logger = new Logger();\n              if (opts.level) {\n                const levels = getLevelsUpTo(opts.level);\n                (logger as { setLogLevels?: (levels: NestLogLevel[]) => void }).setLogLevels?.(levels);\n              }\n              return logger;\n            }\n            return null;\n          },\n          inject: [LOGGER_MODULE_OPTIONS],\n        },\n        // Unified logger service\n        {\n          provide: LoggerService,\n          useFactory: (opts: LoggerModuleOptions, defaultLogger?: Logger) => {\n            return new LoggerService(opts, defaultLogger);\n          },\n          inject: [LOGGER_MODULE_OPTIONS, { token: Logger, optional: true }],\n        },\n        // Correlation ID middleware\n        {\n          provide: CorrelationIdMiddleware,\n          useFactory: () => {\n            return new CorrelationIdMiddleware({\n              includeInResponse: true,\n              responseHeader: 'x-correlation-id',\n            });\n          },\n        },\n        // HTTP logger interceptor\n        {\n          provide: HttpLoggerInterceptor,\n          useFactory: (logger: LoggerService, opts: LoggerModuleOptions) => {\n            // Use detailed httpLogger config if provided, otherwise fall back to simple enableHttpLogger\n            const httpLoggerOptions = opts.httpLogger ?? {\n              enableRequestLog: opts.enableHttpLogger,\n              enableResponseLog: opts.enableHttpLogger,\n            };\n            return new HttpLoggerInterceptor(logger, httpLoggerOptions);\n          },\n          inject: [LoggerService, LOGGER_MODULE_OPTIONS],\n        },\n      ],\n      exports: [LoggerService, CorrelationIdMiddleware, HttpLoggerInterceptor, LOGGER_MODULE_OPTIONS],\n    };\n  }\n\n  // Middleware registration is handled globally in main.ts via Fastify hooks\n  configure(_consumer: MiddlewareConsumer): void {\n    // Middleware is registered globally in main.ts via Fastify's addHook('onRequest') to avoid DI issues with the constructor.\n  }\n\n  // Creates async providers for dynamic module configuration\n  private static createAsyncProviders(options: LoggerModuleAsyncOptions<unknown[]>): Provider[] {\n    if (options.useFactory) {\n      return [LoggerModule.createAsyncOptionsProvider(options)];\n    }\n\n    const providers: Provider[] = [LoggerModule.createAsyncOptionsProvider(options)];\n\n    if (options.useClass) {\n      providers.push({\n        provide: options.useClass,\n        useClass: options.useClass,\n      });\n    }\n\n    return providers;\n  }\n\n  // Creates the DI provider that resolves and merges async logger options\n  private static createAsyncOptionsProvider(options: LoggerModuleAsyncOptions<unknown[]>): Provider {\n    if (options.useFactory) {\n      return {\n        provide: LOGGER_MODULE_OPTIONS,\n        useFactory: async (...args: unknown[]) => {\n          const userOptions = await options.useFactory?.(...args);\n          return mergeWithDefaults(userOptions);\n        },\n        inject: options.inject || [],\n      };\n    }\n\n    if (options.useClass) {\n      return {\n        provide: LOGGER_MODULE_OPTIONS,\n        useFactory: async (optionsFactory: LoggerOptionsFactory) => {\n          const userOptions = await optionsFactory.createLoggerOptions();\n          return mergeWithDefaults(userOptions);\n        },\n        inject: [options.useClass],\n      };\n    }\n\n    if (options.useExisting) {\n      return {\n        provide: LOGGER_MODULE_OPTIONS,\n        useFactory: async (optionsFactory: LoggerOptionsFactory) => {\n          const userOptions = await optionsFactory.createLoggerOptions();\n          return mergeWithDefaults(userOptions);\n        },\n        inject: [options.useExisting],\n      };\n    }\n\n    throw new Error('LoggerModule.forRootAsync() requires one of: useFactory, useClass, or useExisting');\n  }\n}\n","import { Injectable, type NestMiddleware } from '@nestjs/common';\nimport type { FastifyReply, FastifyRequest } from 'fastify';\nimport {\n  addCorrelationIdToResponse,\n  correlationStorage,\n  DEFAULT_CORRELATION_HEADER,\n  generateCorrelationId,\n  runWithCorrelationContext,\n} from '../utils';\n\nexport interface CorrelationIdMiddlewareOptions {\n  includeInResponse?: boolean;\n  responseHeader?: string;\n}\n\n@Injectable()\nexport class CorrelationIdMiddleware implements NestMiddleware {\n  private readonly includeInResponse: boolean;\n  private readonly responseHeader: string;\n\n  constructor(options: CorrelationIdMiddlewareOptions = {}) {\n    this.includeInResponse = options.includeInResponse ?? true;\n    this.responseHeader = options.responseHeader ?? DEFAULT_CORRELATION_HEADER;\n  }\n\n  // Generates and stores a correlation ID for the incoming request\n  use(_req: FastifyRequest, reply: FastifyReply, next: () => void): void {\n    // Generate new correlation ID for this request\n    const correlationId = generateCorrelationId();\n\n    // Add to response headers if enabled\n    if (this.includeInResponse) {\n      addCorrelationIdToResponse(reply, correlationId, this.responseHeader);\n    }\n\n    // Run the rest of the request in AsyncLocalStorage context\n    runWithCorrelationContext({ correlationId }, () => {\n      next();\n    });\n  }\n\n  // Fastify onRequest hook that initializes correlation context in AsyncLocalStorage\n  async onRequest(_req: FastifyRequest, reply: FastifyReply): Promise<void> {\n    // Generate new correlation ID for this request\n    const correlationId = generateCorrelationId();\n\n    // Add to response headers if enabled\n    if (this.includeInResponse) {\n      addCorrelationIdToResponse(reply, correlationId, this.responseHeader);\n    }\n\n    // Store in AsyncLocalStorage — no runWithCorrelationContext wrap needed, Fastify's async context tracking handles it.\n    const store = correlationStorage.getStore();\n    if (!store) {\n      // Initialize new store\n      correlationStorage.enterWith({ correlationId });\n    }\n  }\n}\n"],"mappings":"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","names":["import_common","import_common","findPgError","error","depth","undefined","candidate","code","cause","import_common","correlationStorage","AsyncLocalStorage","getCorrelationContext","getStore","runWithCorrelationContext","context","callback","run","updateCorrelationContext","updates","Object","assign","DEFAULT_CORRELATION_HEADER","generateCorrelationId","randomUUID","addCorrelationIdToResponse","reply","correlationId","headerName","header","raw","setHeader","LoggerService","activeLogger","options","context","defaultLogger","provider","Error","createWinstonLogger","opts","level","logFormat","format","baseFormatters","timestamp","errors","stack","consoleTransport","transports","Console","combine","json","printf","info","message","correlationId","trace","parts","toUpperCase","padEnd","toString","slice","filter","Boolean","output","join","colorize","all","winstonTransports","enableFileLogger","filePath","maxFiles","push","DailyRotateFile","filename","datePattern","maxSize","config","exitOnError","defaultMeta","appName","environment","createLogger","log","_log","error","warn","debug","verbose","setContext","ctx","winstonLogger","winstonLevel","formattedMessage","formatMessage","metadata","enrichMetadata","nestLogger","logWithMetadata","messageWithMeta","JSON","stringify","String","enriched","correlationContext","getCorrelationContext","key","value","Object","entries","child","childLogger","HttpLoggerInterceptor","enableRequestLog","enableResponseLog","slowRequestThreshold","logger","options","intercept","context","next","getType","handle","httpContext","switchToHttp","request","getRequest","response","getResponse","startTime","Date","now","logRequest","pipe","tap","duration","logResponse","catchError","error","logError","correlationContext","getCorrelationContext","metadata","type","method","url","correlationId","ip","userAgent","headers","logWithMetadata","stack","statusCode","logLevel","slowRequest","message","err","status","pgCause","findPgError","errorMessage","detail","code","errorName","name","pgError","trace","errorDetails","loggingError","import_common","import_common","CorrelationIdMiddleware","includeInResponse","responseHeader","options","DEFAULT_CORRELATION_HEADER","use","_req","reply","next","correlationId","generateCorrelationId","addCorrelationIdToResponse","runWithCorrelationContext","onRequest","store","correlationStorage","getStore","enterWith","LOGGER_MODULE_OPTIONS","Symbol","DEFAULT_LOGGER_OPTIONS","provider","enableCorrelationId","enableHttpLogger","filePath","maxFiles","ENVIRONMENT_PRESETS","development","level","format","enableFileLogger","httpLogger","enableRequestLog","enableResponseLog","slowRequestThreshold","staging","production","test","mergeWithDefaults","options","preset","environment","filteredOptions","Object","fromEntries","entries","filter","_","value","undefined","merged","createDefaultLoggerProvider","provide","Logger","useFactory","logger","levels","getLevelsUpTo","setLogLevels","createLoggerProviders","mergedOptions","providers","useValue","push","LoggerService","opts","defaultLogger","inject","token","optional","CorrelationIdMiddleware","includeInResponse","responseHeader","HttpLoggerInterceptor","httpLoggerOptions","allLevels","isValidLevel","l","includes","levelIndex","indexOf","slice","LoggerModule","forRoot","module","exports","forRootAsync","asyncProviders","createAsyncProviders","imports","configure","_consumer","createAsyncOptionsProvider","useClass","args","userOptions","optionsFactory","createLoggerOptions","useExisting","Error"]}

package/dist/logger.d.cts

@@ -0,0 +1,118 @@
+import { ModuleMetadata, Type, InjectionToken, LoggerService as LoggerService$1, Logger, NestInterceptor, ExecutionContext, CallHandler, NestModule, DynamicModule, MiddlewareConsumer, NestMiddleware } from '@nestjs/common';
+import { Observable } from 'rxjs';
+import { FastifyRequest, FastifyReply } from 'fastify';
+import { AsyncLocalStorage } from 'node:async_hooks';
+
+type LogLevel = 'error' | 'warn' | 'log' | 'debug' | 'verbose';
+type LogFormat = 'json' | 'text';
+interface LogMetadata {
+    correlationId?: string;
+    method?: string;
+    url?: string;
+    statusCode?: number;
+    duration?: number;
+    ip?: string;
+    userAgent?: string;
+    [key: string]: unknown;
+}
+interface LoggerModuleOptions {
+    provider?: 'default' | 'winston';
+    level?: LogLevel;
+    format?: LogFormat;
+    enableFileLogger?: boolean;
+    filePath?: string;
+    maxFiles?: string;
+    enableCorrelationId?: boolean;
+    enableHttpLogger?: boolean;
+    httpLogger?: HttpLoggerOptions;
+    appName?: string;
+    environment?: string;
+    defaultMeta?: Record<string, unknown>;
+}
+interface LoggerOptionsFactory {
+    createLoggerOptions(): Promise<LoggerModuleOptions> | LoggerModuleOptions;
+}
+interface LoggerModuleAsyncOptions<T extends unknown[] = unknown[]> extends Pick<ModuleMetadata, 'imports'> {
+    useExisting?: Type<LoggerOptionsFactory>;
+    useClass?: Type<LoggerOptionsFactory>;
+    useFactory?: (...args: [...T]) => Promise<LoggerModuleOptions> | LoggerModuleOptions;
+    inject?: InjectionToken[];
+}
+interface CorrelationContext {
+    correlationId: string;
+    [key: string]: unknown;
+}
+interface HttpLoggerOptions {
+    enableRequestLog?: boolean;
+    enableResponseLog?: boolean;
+    enableRequestBodyLog?: boolean;
+    enableResponseBodyLog?: boolean;
+    slowRequestThreshold?: number;
+    excludedRoutes?: string[];
+    maskedHeaders?: string[];
+    maxBodySize?: number;
+}
+
+type LogMessage = string | Error | object;
+declare class LoggerService implements LoggerService$1 {
+    private readonly defaultLogger?;
+    private readonly activeLogger;
+    private readonly options;
+    private context?;
+    constructor(options?: LoggerModuleOptions, defaultLogger?: Logger | undefined);
+    private createWinstonLogger;
+    log(message: LogMessage, context?: string): void;
+    error(message: LogMessage, trace?: string, context?: string): void;
+    warn(message: LogMessage, context?: string): void;
+    debug(message: LogMessage, context?: string): void;
+    verbose(message: LogMessage, context?: string): void;
+    setContext(context: string): void;
+    private _log;
+    logWithMetadata(level: LogLevel, message: LogMessage, metadata?: LogMetadata, context?: string): void;
+    private formatMessage;
+    private enrichMetadata;
+    child(context: string): LoggerService;
+}
+
+declare class HttpLoggerInterceptor implements NestInterceptor {
+    private readonly logger;
+    private readonly enableRequestLog;
+    private readonly enableResponseLog;
+    private readonly slowRequestThreshold;
+    constructor(logger: LoggerService, options?: HttpLoggerOptions);
+    intercept(context: ExecutionContext, next: CallHandler): Observable<unknown>;
+    private logRequest;
+    private logResponse;
+    private logError;
+}
+
+declare const LOGGER_MODULE_OPTIONS: unique symbol;
+declare class LoggerModule implements NestModule {
+    static forRoot(options?: LoggerModuleOptions): DynamicModule;
+    static forRootAsync<T extends unknown[] = unknown[]>(options: LoggerModuleAsyncOptions<T>): DynamicModule;
+    configure(_consumer: MiddlewareConsumer): void;
+    private static createAsyncProviders;
+    private static createAsyncOptionsProvider;
+}
+
+interface CorrelationIdMiddlewareOptions {
+    includeInResponse?: boolean;
+    responseHeader?: string;
+}
+declare class CorrelationIdMiddleware implements NestMiddleware {
+    private readonly includeInResponse;
+    private readonly responseHeader;
+    constructor(options?: CorrelationIdMiddlewareOptions);
+    use(_req: FastifyRequest, reply: FastifyReply, next: () => void): void;
+    onRequest(_req: FastifyRequest, reply: FastifyReply): Promise<void>;
+}
+
+declare const correlationStorage: AsyncLocalStorage<CorrelationContext>;
+declare function getCorrelationContext(): CorrelationContext | undefined;
+declare function runWithCorrelationContext<T>(context: CorrelationContext, callback: () => T): T;
+declare function updateCorrelationContext(updates: Partial<CorrelationContext>): void;
+declare const DEFAULT_CORRELATION_HEADER = "x-correlation-id";
+declare function generateCorrelationId(): string;
+declare function addCorrelationIdToResponse(reply: FastifyReply, correlationId: string, headerName?: string): void;
+
+export { type CorrelationContext, CorrelationIdMiddleware, DEFAULT_CORRELATION_HEADER, HttpLoggerInterceptor, type HttpLoggerOptions, LOGGER_MODULE_OPTIONS, type LogFormat, type LogLevel, type LogMetadata, LoggerModule, type LoggerModuleAsyncOptions, type LoggerModuleOptions, type LoggerOptionsFactory, LoggerService, addCorrelationIdToResponse, correlationStorage, generateCorrelationId, getCorrelationContext, runWithCorrelationContext, updateCorrelationContext };

package/dist/logger.d.ts

@@ -0,0 +1,118 @@
+import { ModuleMetadata, Type, InjectionToken, LoggerService as LoggerService$1, Logger, NestInterceptor, ExecutionContext, CallHandler, NestModule, DynamicModule, MiddlewareConsumer, NestMiddleware } from '@nestjs/common';
+import { Observable } from 'rxjs';
+import { FastifyRequest, FastifyReply } from 'fastify';
+import { AsyncLocalStorage } from 'node:async_hooks';
+
+type LogLevel = 'error' | 'warn' | 'log' | 'debug' | 'verbose';
+type LogFormat = 'json' | 'text';
+interface LogMetadata {
+    correlationId?: string;
+    method?: string;
+    url?: string;
+    statusCode?: number;
+    duration?: number;
+    ip?: string;
+    userAgent?: string;
+    [key: string]: unknown;
+}
+interface LoggerModuleOptions {
+    provider?: 'default' | 'winston';
+    level?: LogLevel;
+    format?: LogFormat;
+    enableFileLogger?: boolean;
+    filePath?: string;
+    maxFiles?: string;
+    enableCorrelationId?: boolean;
+    enableHttpLogger?: boolean;
+    httpLogger?: HttpLoggerOptions;
+    appName?: string;
+    environment?: string;
+    defaultMeta?: Record<string, unknown>;
+}
+interface LoggerOptionsFactory {
+    createLoggerOptions(): Promise<LoggerModuleOptions> | LoggerModuleOptions;
+}
+interface LoggerModuleAsyncOptions<T extends unknown[] = unknown[]> extends Pick<ModuleMetadata, 'imports'> {
+    useExisting?: Type<LoggerOptionsFactory>;
+    useClass?: Type<LoggerOptionsFactory>;
+    useFactory?: (...args: [...T]) => Promise<LoggerModuleOptions> | LoggerModuleOptions;
+    inject?: InjectionToken[];
+}
+interface CorrelationContext {
+    correlationId: string;
+    [key: string]: unknown;
+}
+interface HttpLoggerOptions {
+    enableRequestLog?: boolean;
+    enableResponseLog?: boolean;
+    enableRequestBodyLog?: boolean;
+    enableResponseBodyLog?: boolean;
+    slowRequestThreshold?: number;
+    excludedRoutes?: string[];
+    maskedHeaders?: string[];
+    maxBodySize?: number;
+}
+
+type LogMessage = string | Error | object;
+declare class LoggerService implements LoggerService$1 {
+    private readonly defaultLogger?;
+    private readonly activeLogger;
+    private readonly options;
+    private context?;
+    constructor(options?: LoggerModuleOptions, defaultLogger?: Logger | undefined);
+    private createWinstonLogger;
+    log(message: LogMessage, context?: string): void;
+    error(message: LogMessage, trace?: string, context?: string): void;
+    warn(message: LogMessage, context?: string): void;
+    debug(message: LogMessage, context?: string): void;
+    verbose(message: LogMessage, context?: string): void;
+    setContext(context: string): void;
+    private _log;
+    logWithMetadata(level: LogLevel, message: LogMessage, metadata?: LogMetadata, context?: string): void;
+    private formatMessage;
+    private enrichMetadata;
+    child(context: string): LoggerService;
+}
+
+declare class HttpLoggerInterceptor implements NestInterceptor {
+    private readonly logger;
+    private readonly enableRequestLog;
+    private readonly enableResponseLog;
+    private readonly slowRequestThreshold;
+    constructor(logger: LoggerService, options?: HttpLoggerOptions);
+    intercept(context: ExecutionContext, next: CallHandler): Observable<unknown>;
+    private logRequest;
+    private logResponse;
+    private logError;
+}
+
+declare const LOGGER_MODULE_OPTIONS: unique symbol;
+declare class LoggerModule implements NestModule {
+    static forRoot(options?: LoggerModuleOptions): DynamicModule;
+    static forRootAsync<T extends unknown[] = unknown[]>(options: LoggerModuleAsyncOptions<T>): DynamicModule;
+    configure(_consumer: MiddlewareConsumer): void;
+    private static createAsyncProviders;
+    private static createAsyncOptionsProvider;
+}
+
+interface CorrelationIdMiddlewareOptions {
+    includeInResponse?: boolean;
+    responseHeader?: string;
+}
+declare class CorrelationIdMiddleware implements NestMiddleware {
+    private readonly includeInResponse;
+    private readonly responseHeader;
+    constructor(options?: CorrelationIdMiddlewareOptions);
+    use(_req: FastifyRequest, reply: FastifyReply, next: () => void): void;
+    onRequest(_req: FastifyRequest, reply: FastifyReply): Promise<void>;
+}
+
+declare const correlationStorage: AsyncLocalStorage<CorrelationContext>;
+declare function getCorrelationContext(): CorrelationContext | undefined;
+declare function runWithCorrelationContext<T>(context: CorrelationContext, callback: () => T): T;
+declare function updateCorrelationContext(updates: Partial<CorrelationContext>): void;
+declare const DEFAULT_CORRELATION_HEADER = "x-correlation-id";
+declare function generateCorrelationId(): string;
+declare function addCorrelationIdToResponse(reply: FastifyReply, correlationId: string, headerName?: string): void;
+
+export { type CorrelationContext, CorrelationIdMiddleware, DEFAULT_CORRELATION_HEADER, HttpLoggerInterceptor, type HttpLoggerOptions, LOGGER_MODULE_OPTIONS, type LogFormat, type LogLevel, type LogMetadata, LoggerModule, type LoggerModuleAsyncOptions, type LoggerModuleOptions, type LoggerOptionsFactory, LoggerService, addCorrelationIdToResponse, correlationStorage, generateCorrelationId, getCorrelationContext, runWithCorrelationContext, updateCorrelationContext };