logixia 1.2.1 → 1.3.0

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":["formatted: Record<string, unknown>","serialized: Record<string, unknown>","parts: string[]","createLoggerFromCore"],"sources":["../src/formatters/json.formatter.ts","../src/formatters/text.formatter.ts","../src/index.ts"],"sourcesContent":["/**\n * JSON formatter for Logixia\n */\n\nimport type { ILogFormatter, LogEntry } from '../types';\nimport { serializeError } from '../utils/error.utils';\n\nexport class JsonFormatter implements ILogFormatter {\n  private includeTimestamp: boolean;\n  private includeLevel: boolean;\n  private includeAppName: boolean;\n  private includeTraceId: boolean;\n  private includeContext: boolean;\n  private prettyPrint: boolean;\n\n  constructor(\n    options: {\n      includeTimestamp?: boolean;\n      includeLevel?: boolean;\n      includeAppName?: boolean;\n      includeTraceId?: boolean;\n      includeContext?: boolean;\n      prettyPrint?: boolean;\n    } = {}\n  ) {\n    this.includeTimestamp = options.includeTimestamp ?? true;\n    this.includeLevel = options.includeLevel ?? true;\n    this.includeAppName = options.includeAppName ?? true;\n    this.includeTraceId = options.includeTraceId ?? true;\n    this.includeContext = options.includeContext ?? true;\n    this.prettyPrint = options.prettyPrint ?? false;\n  }\n\n  format(entry: LogEntry): string {\n    const formatted: Record<string, unknown> = {};\n\n    // Add timestamp\n    if (this.includeTimestamp) {\n      formatted.timestamp = entry.timestamp;\n    }\n\n    // Add log level\n    if (this.includeLevel) {\n      formatted.level = entry.level.toLowerCase();\n      formatted.levelValue = entry.level;\n    }\n\n    // Add app name\n    if (this.includeAppName) {\n      formatted.appName = entry.appName;\n    }\n\n    // Add trace ID\n    if (this.includeTraceId && entry.traceId) {\n      formatted.traceId = entry.traceId;\n    }\n\n    // Add context\n    if (this.includeContext && entry.context) {\n      formatted.context = entry.context;\n    }\n\n    // Add message\n    formatted.message = entry.message;\n\n    // Add payload\n    if (entry.payload && Object.keys(entry.payload).length > 0) {\n      formatted.payload = this.serializePayload(entry.payload);\n    }\n\n    // Add error if present\n    if (entry.error) {\n      formatted.error = serializeError(entry.error);\n    }\n\n    // Add metadata\n    formatted.meta = {\n      pid: process.pid,\n      hostname: process.env.HOSTNAME || 'unknown',\n      version: process.version,\n    };\n\n    return this.prettyPrint ? JSON.stringify(formatted, null, 2) : JSON.stringify(formatted);\n  }\n\n  private serializePayload(payload: Record<string, unknown>): Record<string, unknown> {\n    const serialized: Record<string, unknown> = {};\n\n    for (const [key, value] of Object.entries(payload)) {\n      try {\n        if (value instanceof Error) {\n          serialized[key] = serializeError(value);\n        } else if (value instanceof Date) {\n          serialized[key] = value.toISOString();\n        } else if (typeof value === 'function') {\n          serialized[key] = '[Function]';\n        } else if (typeof value === 'symbol') {\n          serialized[key] = value.toString();\n        } else if (value === undefined) {\n          serialized[key] = null;\n        } else {\n          serialized[key] = value;\n        }\n      } catch {\n        serialized[key] = '[Unserializable]';\n      }\n    }\n\n    return serialized;\n  }\n}\n","/**\n * Text formatter for Logixia\n */\n\nimport type { ILogFormatter, LogEntry } from '../types';\nimport { LogLevel } from '../types';\n\nexport class TextFormatter implements ILogFormatter {\n  private colorize: boolean;\n  private includeTimestamp: boolean;\n  private includeAppName: boolean;\n  private includeTraceId: boolean;\n  private includeContext: boolean;\n  private timestampFormat: 'iso' | 'locale' | 'short';\n  private colors: Record<string, string>;\n\n  constructor(\n    options: {\n      colorize?: boolean;\n      includeTimestamp?: boolean;\n      includeAppName?: boolean;\n      includeTraceId?: boolean;\n      includeContext?: boolean;\n      timestampFormat?: 'iso' | 'locale' | 'short';\n      colors?: Record<string, string>;\n    } = {}\n  ) {\n    this.colorize = options.colorize ?? true;\n    this.includeTimestamp = options.includeTimestamp ?? true;\n    this.includeAppName = options.includeAppName ?? true;\n    this.includeTraceId = options.includeTraceId ?? true;\n    this.includeContext = options.includeContext ?? true;\n    this.timestampFormat = options.timestampFormat ?? 'locale';\n    this.colors = {\n      error: '\\x1b[31m', // Red\n      warn: '\\x1b[33m', // Yellow\n      info: '\\x1b[32m', // Green\n      debug: '\\x1b[34m', // Blue\n      trace: '\\x1b[35m', // Magenta\n      verbose: '\\x1b[36m', // Cyan\n      reset: '\\x1b[0m', // Reset\n      bold: '\\x1b[1m', // Bold\n      dim: '\\x1b[2m', // Dim\n      ...options.colors,\n    };\n  }\n\n  format(entry: LogEntry): string {\n    const parts: string[] = [];\n\n    // Add timestamp\n    if (this.includeTimestamp) {\n      const timestamp = this.formatTimestamp(entry.timestamp);\n      parts.push(this.colorize ? `${this.colors.dim}${timestamp}${this.colors.reset}` : timestamp);\n    }\n\n    // Add log level\n    const levelName = entry.level.toLowerCase();\n    const levelColor = this.colors[levelName] || this.colors.reset;\n    const formattedLevel = this.colorize\n      ? `${levelColor}${this.colors.bold}${levelName.toUpperCase().padEnd(5)}${this.colors.reset}`\n      : levelName.toUpperCase().padEnd(5);\n    parts.push(`[${formattedLevel}]`);\n\n    // Add app name\n    if (this.includeAppName) {\n      const appName = this.colorize\n        ? `${this.colors.bold}${entry.appName}${this.colors.reset}`\n        : entry.appName;\n      parts.push(`[${appName}]`);\n    }\n\n    // Add trace ID\n    if (this.includeTraceId && entry.traceId) {\n      const traceId = this.colorize\n        ? `${this.colors.dim}${entry.traceId}${this.colors.reset}`\n        : entry.traceId;\n      parts.push(`[${traceId}]`);\n    }\n\n    // Add context\n    if (this.includeContext && entry.context) {\n      const context = this.colorize\n        ? `${this.colors.cyan}${entry.context}${this.colors.reset}`\n        : entry.context;\n      parts.push(`[${context}]`);\n    }\n\n    // Add message\n    const message =\n      this.colorize && entry.level === LogLevel.ERROR\n        ? `${this.colors.error}${entry.message}${this.colors.reset}`\n        : entry.message;\n    parts.push(message);\n\n    // Add payload\n    if (entry.payload && Object.keys(entry.payload).length > 0) {\n      const payload = this.formatPayload(entry.payload);\n      if (payload) {\n        parts.push(this.colorize ? `${this.colors.dim}${payload}${this.colors.reset}` : payload);\n      }\n    }\n\n    return parts.join(' ');\n  }\n\n  private formatTimestamp(timestamp: string): string {\n    const date = new Date(timestamp);\n\n    switch (this.timestampFormat) {\n      case 'iso':\n        return date.toISOString();\n      case 'short':\n        return date.toLocaleTimeString();\n      case 'locale':\n      default:\n        return date.toLocaleString();\n    }\n  }\n\n  private formatPayload(payload: Record<string, unknown>): string {\n    try {\n      // Handle simple objects\n      if (Object.keys(payload).length === 1) {\n        const entry = Object.entries(payload)[0];\n        if (entry) {\n          const [key, value] = entry;\n          if (\n            typeof value === 'string' ||\n            typeof value === 'number' ||\n            typeof value === 'boolean'\n          ) {\n            return `${key}=${value}`;\n          }\n        }\n      }\n\n      // Handle multiple properties or complex objects\n      const formatted = Object.entries(payload)\n        .map(([key, value]) => {\n          if (value === null || value === undefined) {\n            return `${key}=${value}`;\n          }\n          if (typeof value === 'string') {\n            return `${key}=\"${value}\"`;\n          }\n          if (typeof value === 'number' || typeof value === 'boolean') {\n            return `${key}=${value}`;\n          }\n          if (value instanceof Date) {\n            return `${key}=${value.toISOString()}`;\n          }\n          if (typeof value === 'object') {\n            return `${key}=${JSON.stringify(value)}`;\n          }\n          return `${key}=${String(value)}`;\n        })\n        .join(' ');\n\n      return formatted;\n    } catch {\n      return JSON.stringify(payload);\n    }\n  }\n\n  /**\n   * Create a formatter with preset configurations\n   */\n  static createSimple(): TextFormatter {\n    return new TextFormatter({\n      colorize: true,\n      includeTimestamp: true,\n      includeAppName: false,\n      includeTraceId: false,\n      includeContext: true,\n      timestampFormat: 'short',\n    });\n  }\n\n  static createDetailed(): TextFormatter {\n    return new TextFormatter({\n      colorize: true,\n      includeTimestamp: true,\n      includeAppName: true,\n      includeTraceId: true,\n      includeContext: true,\n      timestampFormat: 'locale',\n    });\n  }\n\n  static createMinimal(): TextFormatter {\n    return new TextFormatter({\n      colorize: false,\n      includeTimestamp: false,\n      includeAppName: false,\n      includeTraceId: false,\n      includeContext: false,\n    });\n  }\n}\n","/**\n * Logixia - Advanced TypeScript Logger\n *\n * A comprehensive logging library with support for:\n * - Multiple output formats (console, file, JSON)\n * - Trace ID tracking\n * - Performance monitoring\n * - NestJS integration\n * - Customizable log levels and colors\n * - Intelligent log search and aggregation\n * - Natural language query processing\n * - Pattern recognition and anomaly detection\n */\n\nimport { createLogger as createLoggerFromCore, LogixiaLogger } from './core/logitron-logger';\nimport { LogixiaLoggerService } from './core/logitron-nestjs.service';\nimport type { Environment, LogColor, LoggerConfig } from './types';\nimport { LogLevel } from './types';\n\n// Type exports\nexport * from './core/logitron-logger.module';\nexport * from './core/logitron-nestjs.service';\nexport * from './formatters';\nexport * from './types';\nexport * from './utils/error.utils';\nexport { applyRedaction, redactObject } from './utils/redact.utils';\nexport * from './utils/shutdown.utils';\nexport * from './utils/trace.utils';\n\n// Search module exports\nexport * from './search';\n\n// Core exports\nexport { DEFAULT_CONFIG, LogixiaLogger, LogixiaLoggerService };\n\n/**\n * Default configuration for Logixia logger\n */\nconst DEFAULT_CONFIG = {\n  appName: 'App',\n  environment: 'development' as Environment,\n  traceId: true,\n  format: {\n    timestamp: true,\n    colorize: true,\n    json: false,\n  },\n  silent: false,\n  levelOptions: {\n    level: LogLevel.INFO,\n    levels: {\n      [LogLevel.ERROR]: 0,\n      [LogLevel.WARN]: 1,\n      [LogLevel.INFO]: 2,\n      [LogLevel.DEBUG]: 3,\n      [LogLevel.TRACE]: 4,\n      [LogLevel.VERBOSE]: 5,\n    },\n    colors: {\n      [LogLevel.ERROR]: 'red',\n      [LogLevel.WARN]: 'yellow',\n      [LogLevel.INFO]: 'blue',\n      [LogLevel.DEBUG]: 'green',\n      [LogLevel.TRACE]: 'gray',\n      [LogLevel.VERBOSE]: 'cyan',\n    } as Record<string, LogColor>,\n  },\n  fields: {\n    timestamp: true,\n    level: true,\n    appName: true,\n    traceId: true,\n    message: true,\n    payload: true,\n    timeTaken: true,\n  },\n  outputs: ['console'],\n};\n\n/**\n * Create a new Logixia logger instance with TypeScript support for custom levels\n * @param config - Logger configuration\n * @returns Typed logger instance\n */\nexport const createLogger = createLoggerFromCore;\n\n/**\n * Create a new Logixia logger service for NestJS\n * @param config - Logger configuration\n * @returns LogixiaLoggerService instance\n */\nexport function createLoggerService(config?: Partial<LoggerConfig>): LogixiaLoggerService {\n  return new LogixiaLoggerService({ ...DEFAULT_CONFIG, ...config });\n}\n\n/**\n * Default logger instance\n */\nexport const logger = new LogixiaLogger(DEFAULT_CONFIG);\n\n/**\n * Export default configuration for reference\n */\n"],"mappings":"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"}
+{"version":3,"file":"index.mjs","names":["formatted: Record<string, unknown>","serialized: Record<string, unknown>","parts: string[]","createLoggerFromCore"],"sources":["../src/formatters/json.formatter.ts","../src/formatters/text.formatter.ts","../src/index.ts"],"sourcesContent":["/**\n * JSON formatter for Logixia\n */\n\nimport type { ILogFormatter, LogEntry } from '../types';\nimport { serializeError } from '../utils/error.utils';\n\nexport class JsonFormatter implements ILogFormatter {\n  private includeTimestamp: boolean;\n  private includeLevel: boolean;\n  private includeAppName: boolean;\n  private includeTraceId: boolean;\n  private includeContext: boolean;\n  private prettyPrint: boolean;\n\n  constructor(\n    options: {\n      includeTimestamp?: boolean;\n      includeLevel?: boolean;\n      includeAppName?: boolean;\n      includeTraceId?: boolean;\n      includeContext?: boolean;\n      prettyPrint?: boolean;\n    } = {}\n  ) {\n    this.includeTimestamp = options.includeTimestamp ?? true;\n    this.includeLevel = options.includeLevel ?? true;\n    this.includeAppName = options.includeAppName ?? true;\n    this.includeTraceId = options.includeTraceId ?? true;\n    this.includeContext = options.includeContext ?? true;\n    this.prettyPrint = options.prettyPrint ?? false;\n  }\n\n  format(entry: LogEntry): string {\n    const formatted: Record<string, unknown> = {};\n\n    // Add timestamp\n    if (this.includeTimestamp) {\n      formatted.timestamp = entry.timestamp;\n    }\n\n    // Add log level\n    if (this.includeLevel) {\n      formatted.level = entry.level.toLowerCase();\n      formatted.levelValue = entry.level;\n    }\n\n    // Add app name\n    if (this.includeAppName) {\n      formatted.appName = entry.appName;\n    }\n\n    // Add trace ID\n    if (this.includeTraceId && entry.traceId) {\n      formatted.traceId = entry.traceId;\n    }\n\n    // Add context\n    if (this.includeContext && entry.context) {\n      formatted.context = entry.context;\n    }\n\n    // Add message\n    formatted.message = entry.message;\n\n    // Add payload\n    if (entry.payload && Object.keys(entry.payload).length > 0) {\n      formatted.payload = this.serializePayload(entry.payload);\n    }\n\n    // Add error if present\n    if (entry.error) {\n      formatted.error = serializeError(entry.error);\n    }\n\n    // Add metadata\n    formatted.meta = {\n      pid: process.pid,\n      hostname: process.env.HOSTNAME || 'unknown',\n      version: process.version,\n    };\n\n    return this.prettyPrint ? JSON.stringify(formatted, null, 2) : JSON.stringify(formatted);\n  }\n\n  private serializePayload(payload: Record<string, unknown>): Record<string, unknown> {\n    const serialized: Record<string, unknown> = {};\n\n    for (const [key, value] of Object.entries(payload)) {\n      try {\n        if (value instanceof Error) {\n          serialized[key] = serializeError(value);\n        } else if (value instanceof Date) {\n          serialized[key] = value.toISOString();\n        } else if (typeof value === 'function') {\n          serialized[key] = '[Function]';\n        } else if (typeof value === 'symbol') {\n          serialized[key] = value.toString();\n        } else if (value === undefined) {\n          serialized[key] = null;\n        } else {\n          serialized[key] = value;\n        }\n      } catch {\n        serialized[key] = '[Unserializable]';\n      }\n    }\n\n    return serialized;\n  }\n}\n","/**\n * Text formatter for Logixia\n */\n\nimport type { ILogFormatter, LogEntry } from '../types';\nimport { LogLevel } from '../types';\n\nexport class TextFormatter implements ILogFormatter {\n  private colorize: boolean;\n  private includeTimestamp: boolean;\n  private includeAppName: boolean;\n  private includeTraceId: boolean;\n  private includeContext: boolean;\n  private timestampFormat: 'iso' | 'locale' | 'short';\n  private colors: Record<string, string>;\n\n  constructor(\n    options: {\n      colorize?: boolean;\n      includeTimestamp?: boolean;\n      includeAppName?: boolean;\n      includeTraceId?: boolean;\n      includeContext?: boolean;\n      timestampFormat?: 'iso' | 'locale' | 'short';\n      colors?: Record<string, string>;\n    } = {}\n  ) {\n    this.colorize = options.colorize ?? true;\n    this.includeTimestamp = options.includeTimestamp ?? true;\n    this.includeAppName = options.includeAppName ?? true;\n    this.includeTraceId = options.includeTraceId ?? true;\n    this.includeContext = options.includeContext ?? true;\n    this.timestampFormat = options.timestampFormat ?? 'locale';\n    this.colors = {\n      error: '\\x1b[31m', // Red\n      warn: '\\x1b[33m', // Yellow\n      info: '\\x1b[32m', // Green\n      debug: '\\x1b[34m', // Blue\n      trace: '\\x1b[35m', // Magenta\n      verbose: '\\x1b[36m', // Cyan\n      reset: '\\x1b[0m', // Reset\n      bold: '\\x1b[1m', // Bold\n      dim: '\\x1b[2m', // Dim\n      ...options.colors,\n    };\n  }\n\n  format(entry: LogEntry): string {\n    const parts: string[] = [];\n\n    // Add timestamp\n    if (this.includeTimestamp) {\n      const timestamp = this.formatTimestamp(entry.timestamp);\n      parts.push(this.colorize ? `${this.colors.dim}${timestamp}${this.colors.reset}` : timestamp);\n    }\n\n    // Add log level\n    const levelName = entry.level.toLowerCase();\n    const levelColor = this.colors[levelName] || this.colors.reset;\n    const formattedLevel = this.colorize\n      ? `${levelColor}${this.colors.bold}${levelName.toUpperCase().padEnd(5)}${this.colors.reset}`\n      : levelName.toUpperCase().padEnd(5);\n    parts.push(`[${formattedLevel}]`);\n\n    // Add app name\n    if (this.includeAppName) {\n      const appName = this.colorize\n        ? `${this.colors.bold}${entry.appName}${this.colors.reset}`\n        : entry.appName;\n      parts.push(`[${appName}]`);\n    }\n\n    // Add trace ID\n    if (this.includeTraceId && entry.traceId) {\n      const traceId = this.colorize\n        ? `${this.colors.dim}${entry.traceId}${this.colors.reset}`\n        : entry.traceId;\n      parts.push(`[${traceId}]`);\n    }\n\n    // Add context\n    if (this.includeContext && entry.context) {\n      const context = this.colorize\n        ? `${this.colors.cyan}${entry.context}${this.colors.reset}`\n        : entry.context;\n      parts.push(`[${context}]`);\n    }\n\n    // Add message\n    const message =\n      this.colorize && entry.level === LogLevel.ERROR\n        ? `${this.colors.error}${entry.message}${this.colors.reset}`\n        : entry.message;\n    parts.push(message);\n\n    // Add payload\n    if (entry.payload && Object.keys(entry.payload).length > 0) {\n      const payload = this.formatPayload(entry.payload);\n      if (payload) {\n        parts.push(this.colorize ? `${this.colors.dim}${payload}${this.colors.reset}` : payload);\n      }\n    }\n\n    return parts.join(' ');\n  }\n\n  private formatTimestamp(timestamp: string): string {\n    const date = new Date(timestamp);\n\n    switch (this.timestampFormat) {\n      case 'iso':\n        return date.toISOString();\n      case 'short':\n        return date.toLocaleTimeString();\n      case 'locale':\n      default:\n        return date.toLocaleString();\n    }\n  }\n\n  private formatPayload(payload: Record<string, unknown>): string {\n    try {\n      // Handle simple objects\n      if (Object.keys(payload).length === 1) {\n        const entry = Object.entries(payload)[0];\n        if (entry) {\n          const [key, value] = entry;\n          if (\n            typeof value === 'string' ||\n            typeof value === 'number' ||\n            typeof value === 'boolean'\n          ) {\n            return `${key}=${value}`;\n          }\n        }\n      }\n\n      // Handle multiple properties or complex objects\n      const formatted = Object.entries(payload)\n        .map(([key, value]) => {\n          if (value === null || value === undefined) {\n            return `${key}=${value}`;\n          }\n          if (typeof value === 'string') {\n            return `${key}=\"${value}\"`;\n          }\n          if (typeof value === 'number' || typeof value === 'boolean') {\n            return `${key}=${value}`;\n          }\n          if (value instanceof Date) {\n            return `${key}=${value.toISOString()}`;\n          }\n          if (typeof value === 'object') {\n            return `${key}=${JSON.stringify(value)}`;\n          }\n          return `${key}=${String(value)}`;\n        })\n        .join(' ');\n\n      return formatted;\n    } catch {\n      return JSON.stringify(payload);\n    }\n  }\n\n  /**\n   * Create a formatter with preset configurations\n   */\n  static createSimple(): TextFormatter {\n    return new TextFormatter({\n      colorize: true,\n      includeTimestamp: true,\n      includeAppName: false,\n      includeTraceId: false,\n      includeContext: true,\n      timestampFormat: 'short',\n    });\n  }\n\n  static createDetailed(): TextFormatter {\n    return new TextFormatter({\n      colorize: true,\n      includeTimestamp: true,\n      includeAppName: true,\n      includeTraceId: true,\n      includeContext: true,\n      timestampFormat: 'locale',\n    });\n  }\n\n  static createMinimal(): TextFormatter {\n    return new TextFormatter({\n      colorize: false,\n      includeTimestamp: false,\n      includeAppName: false,\n      includeTraceId: false,\n      includeContext: false,\n    });\n  }\n}\n","/**\n * Logixia - Advanced TypeScript Logger\n *\n * A comprehensive logging library with support for:\n * - Multiple output formats (console, file, JSON)\n * - Trace ID tracking\n * - Performance monitoring\n * - NestJS integration\n * - Customizable log levels and colors\n * - Intelligent log search and aggregation\n * - Natural language query processing\n * - Pattern recognition and anomaly detection\n */\n\nimport { createLogger as createLoggerFromCore, LogixiaLogger } from './core/logitron-logger';\nimport { LogixiaLoggerService } from './core/logitron-nestjs.service';\nimport type { Environment, LogColor, LoggerConfig } from './types';\nimport { LogLevel } from './types';\n\n// Type exports\nexport * from './core/logitron-logger.module';\nexport * from './core/logitron-nestjs.service';\nexport * from './formatters';\nexport * from './types';\nexport * from './utils/error.utils';\nexport { applyRedaction, redactObject } from './utils/redact.utils';\nexport * from './utils/shutdown.utils';\nexport * from './utils/trace.utils';\n\n// Search module exports\nexport * from './search';\n\n// Context propagation (AsyncLocalStorage)\nexport type { LogContext } from './context/async-context';\nexport {\n  createExpressContextMiddleware,\n  createFastifyContextHook,\n  LogixiaContext,\n} from './context/async-context';\n\n// Sampling stats (SamplingConfig is already exported via ./types)\nexport type { SamplingStats } from './utils/sampling.utils';\n\n// Core exports\nexport { DEFAULT_CONFIG, LogixiaLogger, LogixiaLoggerService };\n\n/**\n * Default configuration for Logixia logger\n */\nconst DEFAULT_CONFIG = {\n  appName: 'App',\n  environment: 'development' as Environment,\n  traceId: true,\n  format: {\n    timestamp: true,\n    colorize: true,\n    json: false,\n  },\n  silent: false,\n  levelOptions: {\n    level: LogLevel.INFO,\n    levels: {\n      [LogLevel.ERROR]: 0,\n      [LogLevel.WARN]: 1,\n      [LogLevel.INFO]: 2,\n      [LogLevel.DEBUG]: 3,\n      [LogLevel.TRACE]: 4,\n      [LogLevel.VERBOSE]: 5,\n    },\n    colors: {\n      [LogLevel.ERROR]: 'red',\n      [LogLevel.WARN]: 'yellow',\n      [LogLevel.INFO]: 'blue',\n      [LogLevel.DEBUG]: 'green',\n      [LogLevel.TRACE]: 'gray',\n      [LogLevel.VERBOSE]: 'cyan',\n    } as Record<string, LogColor>,\n  },\n  fields: {\n    timestamp: true,\n    level: true,\n    appName: true,\n    traceId: true,\n    message: true,\n    payload: true,\n    timeTaken: true,\n  },\n  outputs: ['console'],\n};\n\n/**\n * Create a new Logixia logger instance with TypeScript support for custom levels\n * @param config - Logger configuration\n * @returns Typed logger instance\n */\nexport const createLogger = createLoggerFromCore;\n\n/**\n * Create a new Logixia logger service for NestJS\n * @param config - Logger configuration\n * @returns LogixiaLoggerService instance\n */\nexport function createLoggerService(config?: Partial<LoggerConfig>): LogixiaLoggerService {\n  return new LogixiaLoggerService({ ...DEFAULT_CONFIG, ...config });\n}\n\n/**\n * Default logger instance\n */\nexport const logger = new LogixiaLogger(DEFAULT_CONFIG);\n\n/**\n * Export default configuration for reference\n */\n"],"mappings":"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"}

package/dist/{logitron-logger.module-iO8DPE7_.mjs → logitron-logger.module-2AzkadqZ.mjs}

@@ -1,10 +1,79 @@
 import { a as __toESM, t as __commonJS } from "./chunk-uEZWKkIX.mjs";
-import { d as internalLog, f as internalWarn, t as TransportManager, u as internalError } from "./transport.manager-Vi__pagn.mjs";
+import { d as internalLog, f as internalWarn, t as TransportManager, u as internalError } from "./transport.manager-5VVdqS3o.mjs";
 import buildFastStringify from "fast-json-stringify";
 import { AsyncLocalStorage } from "node:async_hooks";
-import crypto from "crypto";
+import crypto$1 from "crypto";
 import { Injectable, Module, RequestMethod, Scope } from "@nestjs/common";
 
+//#region src/context/async-context.ts
+const _storage = new AsyncLocalStorage();
+const LogixiaContext = {
+	run(store, callback) {
+		const parent = _storage.getStore() ?? {};
+		return _storage.run({
+			...parent,
+			...store
+		}, callback);
+	},
+	get() {
+		return _storage.getStore();
+	},
+	set(fields) {
+		const store = _storage.getStore();
+		if (!store) return;
+		Object.assign(store, fields);
+	},
+	getStorage() {
+		return _storage;
+	}
+};
+/**
+* Create an Express/Connect-compatible middleware that wraps each request in
+* a `LogixiaContext.run()` scope populated with common request fields.
+*
+* @example
+* ```ts
+* import { createExpressContextMiddleware } from 'logixia';
+* app.use(createExpressContextMiddleware());
+* ```
+*/
+function createExpressContextMiddleware(options = {}) {
+	const { enrich, requestIdHeader = "x-request-id", traceIdHeader = "x-trace-id" } = options;
+	return function logixiaContextMiddleware(req, _res, next) {
+		const headers = req["headers"] ?? {};
+		const traceId = headers[traceIdHeader];
+		const base = {
+			requestId: headers[requestIdHeader] ?? crypto.randomUUID().slice(0, 8),
+			...traceId !== void 0 ? { traceId } : {}
+		};
+		LogixiaContext.run({
+			...base,
+			...enrich ? enrich(req) : {}
+		}, next);
+	};
+}
+/**
+* Create a Fastify lifecycle hook that wraps each request in a context scope.
+*
+* Register with `fastify.addHook('onRequest', createFastifyContextHook())`.
+*/
+function createFastifyContextHook(options = {}) {
+	const { enrich, requestIdHeader = "x-request-id", traceIdHeader = "x-trace-id" } = options;
+	return function logixiaFastifyHook(request, _reply, done) {
+		const headers = request["headers"] ?? {};
+		const traceId = headers[traceIdHeader];
+		const base = {
+			requestId: headers[requestIdHeader] ?? request["id"] ?? crypto.randomUUID().slice(0, 8),
+			...traceId !== void 0 ? { traceId } : {}
+		};
+		LogixiaContext.run({
+			...base,
+			...enrich ? enrich(request) : {}
+		}, done);
+	};
+}
+
+//#endregion
 //#region src/types/index.ts
 const LogLevel = {
 	ERROR: "error",
@@ -223,6 +292,137 @@ function isPlainObject(value) {
 	return value !== null && typeof value === "object" && !Array.isArray(value) && !(value instanceof Date) && !(value instanceof Error) && !(value instanceof RegExp);
 }
 
+//#endregion
+//#region src/utils/sampling.utils.ts
+const ALWAYS_EMIT_LEVELS = new Set(["error", "fatal"]);
+var Sampler = class {
+	constructor(config, onStats) {
+		this.sampledTraces = /* @__PURE__ */ new Set();
+		this.droppedTraces = /* @__PURE__ */ new Set();
+		this._tokenBucket = 0;
+		this._lastRefillMs = Date.now();
+		this._stats = {
+			evaluated: 0,
+			emitted: 0,
+			dropped: 0,
+			byLevel: {},
+			windowStart: Date.now()
+		};
+		this.config = config;
+		if (config.maxLogsPerSecond && config.maxLogsPerSecond > 0) this._tokenBucket = config.maxLogsPerSecond;
+		const interval$1 = config.statsIntervalMs ?? 6e4;
+		if (interval$1 > 0 && onStats) {
+			this._statsTimer = setInterval(() => {
+				onStats(this.getStats());
+				this.resetStats();
+			}, interval$1);
+			if (this._statsTimer.unref) this._statsTimer.unref();
+		}
+	}
+	/**
+	* Decide whether a given log entry should be emitted.
+	*
+	* @param level    Log level string (lowercase)
+	* @param traceId  Active trace ID, if any
+	* @returns true → emit, false → drop
+	*/
+	shouldEmit(level, traceId) {
+		var _this$config$perLevel;
+		const lvl = level.toLowerCase();
+		this._trackEvaluated(lvl);
+		if (ALWAYS_EMIT_LEVELS.has(lvl) && ((_this$config$perLevel = this.config.perLevel) === null || _this$config$perLevel === void 0 ? void 0 : _this$config$perLevel[lvl]) === void 0) {
+			this._trackEmitted(lvl);
+			return true;
+		}
+		if (this.config.traceConsistent && traceId) {
+			if (this.sampledTraces.has(traceId)) {
+				this._trackEmitted(lvl);
+				return true;
+			}
+			if (this.droppedTraces.has(traceId)) {
+				this._trackDropped(lvl);
+				return false;
+			}
+			const emit = this._sampleByRate(lvl);
+			if (emit) this.sampledTraces.add(traceId);
+			else this.droppedTraces.add(traceId);
+			if (emit) this._trackEmitted(lvl);
+			else this._trackDropped(lvl);
+			return emit;
+		}
+		if (!this._sampleByRate(lvl)) {
+			this._trackDropped(lvl);
+			return false;
+		}
+		if (this.config.maxLogsPerSecond && this.config.maxLogsPerSecond > 0) {
+			if (!this._consumeToken()) {
+				this._trackDropped(lvl);
+				return false;
+			}
+		}
+		this._trackEmitted(lvl);
+		return true;
+	}
+	getStats() {
+		return {
+			...this._stats,
+			byLevel: { ...this._stats.byLevel }
+		};
+	}
+	resetStats() {
+		this._stats = {
+			evaluated: 0,
+			emitted: 0,
+			dropped: 0,
+			byLevel: {},
+			windowStart: Date.now()
+		};
+		this.sampledTraces.clear();
+		this.droppedTraces.clear();
+	}
+	destroy() {
+		if (this._statsTimer) clearInterval(this._statsTimer);
+	}
+	_sampleByRate(level) {
+		var _this$config$perLevel2, _this$config$perLevel3;
+		const rate = ((_this$config$perLevel2 = this.config.perLevel) === null || _this$config$perLevel2 === void 0 ? void 0 : _this$config$perLevel2[level]) ?? ((_this$config$perLevel3 = this.config.perLevel) === null || _this$config$perLevel3 === void 0 ? void 0 : _this$config$perLevel3["*"]) ?? this.config.rate ?? 1;
+		if (rate >= 1) return true;
+		if (rate <= 0) return false;
+		return Math.random() < rate;
+	}
+	_consumeToken() {
+		const now = Date.now();
+		const elapsed = (now - this._lastRefillMs) / 1e3;
+		const max$1 = this.config.maxLogsPerSecond;
+		this._tokenBucket = Math.min(max$1, this._tokenBucket + elapsed * max$1);
+		this._lastRefillMs = now;
+		if (this._tokenBucket >= 1) {
+			this._tokenBucket -= 1;
+			return true;
+		}
+		return false;
+	}
+	_ensure(level) {
+		if (!this._stats.byLevel[level]) this._stats.byLevel[level] = {
+			evaluated: 0,
+			emitted: 0
+		};
+	}
+	_trackEvaluated(level) {
+		this._stats.evaluated++;
+		this._ensure(level);
+		this._stats.byLevel[level].evaluated++;
+	}
+	_trackEmitted(level) {
+		this._stats.emitted++;
+		this._ensure(level);
+		this._stats.byLevel[level].emitted++;
+	}
+	_trackDropped(_level) {
+		this._stats.dropped++;
+	}
+};
+
 //#endregion
 //#region src/utils/shutdown.utils.ts
 /** Module-level registry of all logger instances that have opted into graceful shutdown */
@@ -286,7 +486,7 @@ const rnds8Pool = new Uint8Array(256);
 let poolPtr = rnds8Pool.length;
 function rng() {
 	if (poolPtr > rnds8Pool.length - 16) {
-		crypto.randomFillSync(rnds8Pool);
+		crypto$1.randomFillSync(rnds8Pool);
 		poolPtr = 0;
 	}
 	return rnds8Pool.slice(poolPtr, poolPtr += 16);
@@ -306,7 +506,7 @@ function unsafeStringify(arr, offset = 0) {
 
 //#endregion
 //#region node_modules/uuid/dist/esm-node/native.js
-var native_default = { randomUUID: crypto.randomUUID };
+var native_default = { randomUUID: crypto$1.randomUUID };
 
 //#endregion
 //#region node_modules/uuid/dist/esm-node/v4.js
@@ -544,6 +744,13 @@ var LogixiaLogger = class LogixiaLogger {
 		};
 		this.context = context$1 ?? "";
 		if (this.config.transports) this.transportManager = new TransportManager(this.config.transports);
+		if (this.config.sampling) this._sampler = new Sampler(this.config.sampling, (stats) => {
+			process.stdout.write(JSON.stringify({
+				level: "info",
+				message: "[logixia/sampling] stats",
+				...stats
+			}) + "\n");
+		});
 		this.setupGracefulShutdown();
 		this.createCustomLevelMethods();
 		this._buildPerfCaches();
@@ -783,6 +990,7 @@ var LogixiaLogger = class LogixiaLogger {
 		return this.transportManager.healthCheck();
 	}
 	async close() {
+		var _this$_sampler;
 		for (const [label, timer$1] of this.timers) await this.warn(`Timer '${label}' was not ended properly`, {
 			startTime: new Date(timer$1.startTime).toISOString(),
 			duration: `${Date.now() - timer$1.startTime}ms (incomplete)`
@@ -792,15 +1000,25 @@ var LogixiaLogger = class LogixiaLogger {
 			await this.transportManager.flush();
 			await this.transportManager.close();
 		}
+		(_this$_sampler = this._sampler) === null || _this$_sampler === void 0 || _this$_sampler.destroy();
 		deregisterFromShutdown(this);
 	}
 	async log(level, message, data) {
 		if (this.config.silent) return;
 		if (!this.shouldLog(level)) return;
-		const rawPayload = this._hasContextData ? {
-			...this.contextData,
+		if (this._sampler) {
+			const traceId$1 = this.config.traceId ? getCurrentTraceId() ?? this.fallbackTraceId : void 0;
+			if (!this._sampler.shouldEmit(level, traceId$1)) return;
+		}
+		const alsContext = LogixiaContext.get();
+		const mergedData = alsContext && Object.keys(alsContext).length > 0 ? {
+			...alsContext,
 			...data
 		} : data;
+		const rawPayload = this._hasContextData ? {
+			...this.contextData,
+			...mergedData
+		} : mergedData;
 		let payload;
 		if (rawPayload !== void 0 && rawPayload !== null) payload = this._hasRedact ? applyRedaction(rawPayload, this.config.redact) ?? rawPayload : rawPayload;
 		const traceId = this.config.traceId ? getCurrentTraceId() ?? this.fallbackTraceId : void 0;
@@ -10303,5 +10521,5 @@ let LogixiaLoggerModule = class LogixiaLoggerModule$1 {
 LogixiaLoggerModule = _LogixiaLoggerModule = __decorate([Module({})], LogixiaLoggerModule);
 
 //#endregion
-export { redactObject as C, DEFAULT_LOG_COLORS as D, serializeError as E, DEFAULT_LOG_LEVELS as O, applyRedaction as S, normalizeError as T, traceStorage as _, TraceMiddleware as a, registerForShutdown as b, LogixiaLogger as c, createTraceMiddleware as d, extractTraceId as f, setTraceId as g, runWithTraceId as h, WebSocketTraceInterceptor as i, LogLevel as k, createLogger as l, getCurrentTraceId as m, LOGIXIA_LOGGER_PREFIX as n, KafkaTraceInterceptor as o, generateTraceId as p, LogixiaLoggerModule as r, LogixiaLoggerService as s, LOGIXIA_LOGGER_CONFIG as t, DEFAULT_TRACE_HEADERS$1 as u, deregisterFromShutdown as v, isError as w, resetShutdownHandlers as x, flushOnExit as y };
-//# sourceMappingURL=logitron-logger.module-iO8DPE7_.mjs.map
+export { LogixiaContext as A, redactObject as C, DEFAULT_LOG_COLORS as D, serializeError as E, createFastifyContextHook as M, DEFAULT_LOG_LEVELS as O, applyRedaction as S, normalizeError as T, traceStorage as _, TraceMiddleware as a, registerForShutdown as b, LogixiaLogger as c, createTraceMiddleware as d, extractTraceId as f, setTraceId as g, runWithTraceId as h, WebSocketTraceInterceptor as i, createExpressContextMiddleware as j, LogLevel as k, createLogger as l, getCurrentTraceId as m, LOGIXIA_LOGGER_PREFIX as n, KafkaTraceInterceptor as o, generateTraceId as p, LogixiaLoggerModule as r, LogixiaLoggerService as s, LOGIXIA_LOGGER_CONFIG as t, DEFAULT_TRACE_HEADERS$1 as u, deregisterFromShutdown as v, isError as w, resetShutdownHandlers as x, flushOnExit as y };
+//# sourceMappingURL=logitron-logger.module-2AzkadqZ.mjs.map