logixia 2.0.10 → 2.0.11

package/dist/nest.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"nest.mjs","names":[],"sources":["../src/core/logitron-nestjs.service.ts","../src/core/kafka-trace.interceptor.ts","../src/core/trace.middleware.ts","../src/core/websocket-trace.interceptor.ts","../src/core/logitron-logger.module.ts","../src/core/nestjs-extras.ts","../src/nest.ts"],"sourcesContent":["/**\n * NestJS Service integration for Logixia Logger\n *\n * Implements NestJS's `LoggerService` interface for framework compat, while\n * simultaneously exposing native async overloads that accept structured data:\n *\n *   // NestJS compat — void, string context\n *   logger.warn('message', 'AuthService');\n *\n *   // Native async — Promise<void>, structured metadata\n *   await logger.warn('message', { userId: 'u_abc', action: 'login' });\n *\n * TypeScript resolves the correct overload automatically based on the type of\n * the second argument:\n *   - second arg is `Record<string, unknown>`  → native path  (returns Promise<void>)\n *   - second arg is `string | undefined`       → NestJS compat (returns void)\n *\n * No wrapper, no casting required on the calling side.\n */\n\nimport type { LoggerService } from '@nestjs/common';\nimport { Injectable, Scope } from '@nestjs/common';\n\nimport type { LoggerConfig, LogLevelString } from '../types';\nimport { LogLevel } from '../types';\n\n// ── Custom-level IntelliSense helpers ─────────────────────────────────────────\n\n/**\n * Level names that already have proper typed implementations on LogixiaLoggerService.\n * These are excluded from the auto-generated method type so we don't produce\n * duplicate / conflicting signatures.\n */\ntype _ServiceBuiltinLevels =\n  'error' | 'warn' | 'info' | 'debug' | 'verbose' | 'trace' | 'log' | 'logLevel';\n\n/**\n * Mapped type that adds one method per *custom* level (i.e. every key in TLevels\n * that is not already a built-in method on LogixiaLoggerService).\n *\n * @example\n * ServiceCustomLevelMethods<{ kafka: 3; mysql: 4; payment: 5 }>\n * // → { kafka(msg, data?): Promise<void>; mysql(...): …; payment(...): … }\n */\ntype ServiceCustomLevelMethods<TLevels extends Record<string, number>> = {\n  readonly [K in keyof TLevels as K extends _ServiceBuiltinLevels ? never : K & string]: (\n    message: string,\n    data?: Record<string, unknown>\n  ) => Promise<void>;\n};\n\n/**\n * The return type of `LogixiaLoggerService.create<T>(config)`.\n *\n * When `T` carries `levelOptions.levels`, this type intersects\n * `LogixiaLoggerService` with a method for every *custom* level so the IDE\n * suggests `service.kafka(...)`, `service.payment(...)`, etc.\n */\nexport type LogixiaServiceWithLevels<T extends LoggerConfig<Record<string, number>>> =\n  T['levelOptions'] extends { levels: infer L }\n    ? L extends Record<string, number>\n      ? LogixiaLoggerService & ServiceCustomLevelMethods<L>\n      : LogixiaLoggerService\n    : LogixiaLoggerService;\n\n/**\n * Helper — extracts custom level names from a config object's `levelOptions.levels`.\n */\ntype _ExtractCustomLevelNames<T> = T extends { levelOptions?: { levels?: infer L } }\n  ? L extends Record<string, number>\n    ? Exclude<keyof L & string, _ServiceBuiltinLevels>\n    : never\n  : never;\n\n/**\n * Typed `LogixiaLoggerService` with autocomplete for custom levels.\n *\n * Accepts either:\n *   - **string union** of custom level names: `LogixiaServiceWith<'kafka' | 'payment'>`\n *   - **config object type** (via `typeof`): `LogixiaServiceWith<typeof logixiaConfig>`\n *\n * Define your config with `as const` once, derive the type everywhere:\n *\n * @example\n * ```ts\n * // logger.config.ts — define once\n * export const logixiaConfig = {\n *   levelOptions: {\n *     levels: { error: 0, warn: 1, info: 2, debug: 3, verbose: 4, kafka: 5, payment: 6 },\n *   },\n * } as const;\n * export type AppLogger = LogixiaServiceWith<typeof logixiaConfig>;\n *\n * // any.controller.ts — use everywhere, no casting\n * constructor(private readonly logger: AppLogger) {}\n * // this.logger.kafka('msg')  ← fully typed\n * // this.logger.payment('msg') ← fully typed\n * ```\n *\n * @example\n * ```ts\n * // Or use string union directly:\n * type AppLogger = LogixiaServiceWith<'kafka' | 'payment'>;\n * ```\n */\nexport type LogixiaServiceWith<T extends string | Record<string, unknown>> =\n  LogixiaLoggerService & {\n    readonly [\n      K in T extends string ? Exclude<T, _ServiceBuiltinLevels> : _ExtractCustomLevelNames<T>\n    ]: (message: string, data?: Record<string, unknown>) => Promise<void>;\n  };\nimport { protectSecrets } from '../transports/secret-config';\nimport { safeToString } from '../utils/coerce.utils';\nimport { internalError } from '../utils/internal-log';\nimport { getTraceContextKey, TraceContext } from '../utils/trace.utils';\nimport { LogixiaLogger } from './logitron-logger';\n\n@Injectable({ scope: Scope.TRANSIENT })\nexport class LogixiaLoggerService implements LoggerService {\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any -- index signature required for dynamic custom-level methods\n  [K: string]: any;\n\n  private logger: LogixiaLogger;\n  private context?: string;\n  private _mergedConfig: LoggerConfig;\n\n  constructor(config?: LoggerConfig) {\n    const defaultConfig: LoggerConfig = {\n      appName: 'NestJS-App',\n      environment: 'development',\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          error: 0,\n          warn: 1,\n          log: 2,\n          debug: 3,\n          verbose: 4,\n        },\n        colors: {\n          error: 'red',\n          warn: 'yellow',\n          log: 'green',\n          debug: 'blue',\n          verbose: 'cyan',\n        },\n      },\n      fields: {\n        timestamp: '[yyyy-mm-dd HH:MM:ss.MS]',\n        level: '[log_level]',\n        appName: '[app_name]',\n        traceId: '[trace_id]',\n        message: '[message]',\n        payload: '[payload]',\n        timeTaken: '[time_taken_MS]',\n      },\n    };\n\n    protectSecrets(this, ['_mergedConfig']);\n    this._mergedConfig = { ...defaultConfig, ...config };\n    this.logger = new LogixiaLogger(this._mergedConfig);\n    this._createCustomLevelMethods();\n  }\n\n  // Dynamically adds a proxy method for every custom level defined in levelOptions.levels\n  // so that `service.payment('msg')` works the same as `service.logLevel('payment', 'msg')`.\n  private _createCustomLevelMethods(): void {\n    const levels = this._mergedConfig.levelOptions?.levels;\n    if (!levels) return;\n    for (const levelName of Object.keys(levels)) {\n      const lower = levelName.toLowerCase();\n      // Skip levels that already have a built-in implementation on this class\n      if (typeof (this as Record<string, unknown>)[lower] !== 'undefined') continue;\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      (this as any)[lower] = async (\n        message: string,\n        data?: Record<string, unknown>\n      ): Promise<void> => {\n        return this.logger.logLevel(lower, message, data);\n      };\n    }\n  }\n\n  // ── log / info ──────────────────────────────────────────────────────────────\n\n  /**\n   * NestJS `LoggerService.log` — void, string context.\n   * Maps internally to `info`.\n   *\n   * @example `logger.log('User signed up', 'AuthService')`\n   */\n  log(message: unknown, context?: string): void {\n    this.setContextIfProvided(context);\n    this.logger\n      .info(this.formatMessage(message))\n      .catch((err: unknown) => internalError('LogixiaLoggerService.log failed', err));\n  }\n\n  /**\n   * Native async `info` — structured data, returns `Promise<void>`.\n   *\n   * @example `await logger.info('User signed up', { userId: 'u_abc' })`\n   */\n  async info(message: string, data?: Record<string, unknown>): Promise<void> {\n    return this.logger.info(message, data);\n  }\n\n  // ── error ──────────────────────────────────────────────────────────────────\n\n  /**\n   * Native async overload — structured metadata, returns `Promise<void>`.\n   *\n   * @example `await logger.error(new Error('DB timeout'), { requestId: 'req_abc' })`\n   * @example `await logger.error('Login failed', { userId: 'u_abc' })`\n   */\n  error(message: string | Error, data: Record<string, unknown>): Promise<void>;\n\n  /**\n   * NestJS compat overload — string trace + optional context, returns `void`.\n   *\n   * @example `logger.error('Something failed', err.stack, 'AuthService')`\n   */\n  error(message: unknown, trace?: string, context?: string): void;\n\n  error(\n    message: unknown,\n    dataOrTrace?: Record<string, unknown> | string,\n    context?: string\n  ): void | Promise<void> {\n    // ── Native path: second arg is a structured-data object ──────────────────\n    if (typeof dataOrTrace === 'object' && dataOrTrace !== null) {\n      return message instanceof Error\n        ? this.logger.error(message, dataOrTrace)\n        : this.logger.error(this.formatMessage(message), dataOrTrace);\n    }\n\n    // ── NestJS compat path: second arg is trace string or undefined ──────────\n    this.setContextIfProvided(context);\n    const errorData: Record<string, string> = {};\n    if (typeof dataOrTrace === 'string' && dataOrTrace) {\n      errorData.stack = dataOrTrace;\n    }\n\n    const logPromise =\n      message instanceof Error\n        ? this.logger.error(message, errorData)\n        : this.logger.error(this.formatMessage(message), errorData);\n\n    logPromise.catch((err: unknown) => internalError('LogixiaLoggerService.error failed', err));\n  }\n\n  // ── warn ───────────────────────────────────────────────────────────────────\n\n  /**\n   * Native async overload — structured metadata, returns `Promise<void>`.\n   *\n   * @example `await logger.warn('Rate limit approaching', { userId: 'u_abc', count: 90 })`\n   */\n  warn(message: string, data: Record<string, unknown>): Promise<void>;\n\n  /**\n   * NestJS compat overload — optional context string, returns `void`.\n   *\n   * @example `logger.warn('Deprecated API used', 'PaymentService')`\n   */\n  warn(message: unknown, context?: string): void;\n\n  warn(message: unknown, dataOrContext?: Record<string, unknown> | string): void | Promise<void> {\n    if (typeof dataOrContext === 'object' && dataOrContext !== null) {\n      return this.logger.warn(this.formatMessage(message), dataOrContext);\n    }\n    this.setContextIfProvided(typeof dataOrContext === 'string' ? dataOrContext : undefined);\n    this.logger\n      .warn(this.formatMessage(message))\n      .catch((err: unknown) => internalError('LogixiaLoggerService.warn failed', err));\n  }\n\n  // ── debug ──────────────────────────────────────────────────────────────────\n\n  /**\n   * Native async overload — structured metadata, returns `Promise<void>`.\n   *\n   * @example `await logger.debug('Cache miss', { key: 'user:abc', ttl: 300 })`\n   */\n  debug(message: string, data: Record<string, unknown>): Promise<void>;\n\n  /**\n   * NestJS compat overload — optional context string, returns `void`.\n   *\n   * @example `logger.debug('Processing request', 'OrderService')`\n   */\n  debug(message: unknown, context?: string): void;\n\n  debug(message: unknown, dataOrContext?: Record<string, unknown> | string): void | Promise<void> {\n    if (typeof dataOrContext === 'object' && dataOrContext !== null) {\n      return this.logger.debug(this.formatMessage(message), dataOrContext);\n    }\n    this.setContextIfProvided(typeof dataOrContext === 'string' ? dataOrContext : undefined);\n    this.logger\n      .debug(this.formatMessage(message))\n      .catch((err: unknown) => internalError('LogixiaLoggerService.debug failed', err));\n  }\n\n  // ── verbose ────────────────────────────────────────────────────────────────\n\n  /**\n   * Native async overload — structured metadata, returns `Promise<void>`.\n   * Maps to `trace` level internally.\n   *\n   * @example `await logger.verbose('Socket message received', { event: 'ping', size: 42 })`\n   */\n  verbose(message: string, data: Record<string, unknown>): Promise<void>;\n\n  /**\n   * NestJS compat overload — optional context string, returns `void`.\n   *\n   * @example `logger.verbose('Connection established', 'WebSocketGateway')`\n   */\n  verbose(message: unknown, context?: string): void;\n\n  verbose(\n    message: unknown,\n    dataOrContext?: Record<string, unknown> | string\n  ): void | Promise<void> {\n    if (typeof dataOrContext === 'object' && dataOrContext !== null) {\n      return this.logger.trace(this.formatMessage(message), dataOrContext);\n    }\n    this.setContextIfProvided(typeof dataOrContext === 'string' ? dataOrContext : undefined);\n    this.logger\n      .trace(this.formatMessage(message))\n      .catch((err: unknown) => internalError('LogixiaLoggerService.verbose failed', err));\n  }\n\n  // ── trace / logLevel ───────────────────────────────────────────────────────\n\n  /**\n   * Native async `trace` — lowest verbosity level, structured data.\n   */\n  async trace(message: string, data?: Record<string, unknown>): Promise<void> {\n    return this.logger.trace(message, data);\n  }\n\n  /**\n   * Log at any named level with structured data.\n   */\n  logLevel(level: string, message: string, data?: Record<string, unknown>): Promise<void> {\n    return this.logger.logLevel(level, message, data);\n  }\n\n  // ── Timing ─────────────────────────────────────────────────────────────────\n\n  time(label: string): void {\n    this.logger.time(label);\n  }\n\n  async timeEnd(label: string): Promise<number | undefined> {\n    return this.logger.timeEnd(label);\n  }\n\n  async timeAsync<T>(label: string, fn: () => Promise<T>): Promise<T> {\n    return this.logger.timeAsync(label, fn);\n  }\n\n  // ── Context / level management ─────────────────────────────────────────────\n\n  setContext(context: string): void {\n    const coerced = typeof context === 'string' ? context : safeToString(context);\n    this.context = coerced;\n    this.logger.setContext(coerced);\n  }\n\n  getContext(): string | undefined {\n    return this.context;\n  }\n\n  setLevel(level: LogLevelString): void {\n    this.logger.setLevel(level);\n  }\n\n  getLevel(): LogLevelString {\n    return this.logger.getLevel();\n  }\n\n  // ── Child logger ───────────────────────────────────────────────────────────\n\n  child(context: string, data?: Record<string, unknown>): LogixiaLoggerService {\n    const childService = new LogixiaLoggerService(this._mergedConfig);\n    childService.logger = this.logger.child(context, data) as LogixiaLogger;\n    childService.context = context;\n    return childService;\n  }\n\n  // ── Misc ───────────────────────────────────────────────────────────────────\n\n  getCurrentTraceId(): string | undefined {\n    return TraceContext.instance.getCurrentTraceId();\n  }\n\n  /** Returns the AsyncLocalStorage key currently used to store the trace ID. */\n  get traceContextKey(): string {\n    return getTraceContextKey();\n  }\n\n  async close(): Promise<void> {\n    return this.logger.close();\n  }\n\n  static create<T extends LoggerConfig<Record<string, number>>>(\n    config?: T\n  ): LogixiaServiceWithLevels<T> {\n    return new LogixiaLoggerService(config) as unknown as LogixiaServiceWithLevels<T>;\n  }\n\n  getLogger(): LogixiaLogger {\n    return this.logger;\n  }\n\n  // ── Private helpers ────────────────────────────────────────────────────────\n\n  private setContextIfProvided(context?: unknown): void {\n    // NestJS framework occasionally passes non-string values (ExecutionContext,\n    // arguments host, etc.) in the context slot. Silently ignore those — we\n    // only want an explicit string label to override `this.context`.\n    if (typeof context !== 'string' || context.length === 0) return;\n    if (context !== this.context) {\n      this.setContext(context);\n    }\n  }\n\n  private formatMessage(message: unknown): string {\n    if (typeof message === 'string') return message;\n    // Use safeToString rather than raw JSON.stringify: NestJS passes arbitrary\n    // values here, and JSON.stringify both THROWS on circular structures (which\n    // would crash the log call) and RETURNS undefined for some inputs (e.g. a\n    // toJSON returning undefined). safeToString handles both safely.\n    return safeToString(message);\n  }\n}\n","/** @format */\n\nimport type { CallHandler, ExecutionContext, NestInterceptor } from '@nestjs/common';\nimport { Injectable } from '@nestjs/common';\nimport { EMPTY, Observable } from 'rxjs';\n\nimport type { TraceIdConfig } from '../types';\nimport { extractTraceId, TraceContext } from '../utils/trace.utils';\nimport { LogixiaLoggerModule } from './logitron-logger.module';\n\n/**\n * Observable counters exposed for monitoring Kafka consumer trace hygiene.\n *\n * Usage:\n *   import { KafkaTraceInterceptor } from 'logixia/nest';\n *   setInterval(() => {\n *     myMetrics.gauge('kafka.trace.dropped', KafkaTraceInterceptor.metrics.dropped);\n *   }, 10_000);\n */\nexport interface KafkaTraceMetrics {\n  /** Messages processed where a traceId was successfully resolved (body/header/ALS). */\n  accepted: number;\n  /** Messages handled without any traceId — `requireTraceId: false`. */\n  acceptedWithoutTrace: number;\n  /** Messages dropped because `requireTraceId: true` and no traceId was found. */\n  dropped: number;\n}\n\n@Injectable()\nexport class KafkaTraceInterceptor implements NestInterceptor {\n  /**\n   * Process-wide counters. Readable from anywhere — scrape into your metrics\n   * system (Prometheus, Datadog, CloudWatch) on an interval.\n   */\n  static readonly metrics: KafkaTraceMetrics = {\n    accepted: 0,\n    acceptedWithoutTrace: 0,\n    dropped: 0,\n  };\n\n  /** Reset counters (tests). */\n  static resetMetrics(): void {\n    KafkaTraceInterceptor.metrics.accepted = 0;\n    KafkaTraceInterceptor.metrics.acceptedWithoutTrace = 0;\n    KafkaTraceInterceptor.metrics.dropped = 0;\n  }\n\n  private readonly ctx = TraceContext.instance;\n  private readonly config: TraceIdConfig;\n\n  /**\n   * @param config        - TraceIdConfig options (extractor keys, contextKey, etc.)\n   * @param requireTraceId - When true, messages with no traceId are silently skipped\n   *                         (EMPTY Observable — message is ack'd, consumer stays alive).\n   *                         A WARN is logged AND `KafkaTraceInterceptor.metrics.dropped`\n   *                         increments so the missing traceId is observable end-to-end.\n   *                         Default: false (handler runs without trace context).\n   */\n  constructor(\n    config?: TraceIdConfig,\n    private readonly requireTraceId: boolean = false\n  ) {\n    this.config = {\n      enabled: true,\n      contextKey: 'traceId',\n      extractor: {\n        body: ['traceId', 'trace_id', 'x-trace-id'],\n        header: ['x-trace-id', 'trace-id'],\n      },\n      ...config,\n    };\n  }\n\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any -- NestJS interceptor interface requires Observable<any>\n  intercept(context: ExecutionContext, next: CallHandler): Observable<any> {\n    if (!this.config.enabled) {\n      return next.handle();\n    }\n\n    const rpcContext = context.switchToRpc();\n    const data = rpcContext.getData();\n    const rpcData = rpcContext.getContext();\n\n    let traceId: string | undefined;\n\n    if (this.config.extractor) {\n      traceId = extractTraceId(\n        { body: data, headers: rpcData?.headers ?? {}, query: {}, params: {} },\n        this.config.extractor\n      );\n    }\n\n    if (!traceId) {\n      traceId = this.ctx.getCurrentTraceId();\n    }\n\n    if (!traceId) {\n      if (this.requireTraceId) {\n        // Warn via global logger (set when LogixiaLoggerModule boots) and ack\n        // the message by returning EMPTY — consumer stays alive, no retry loop.\n        KafkaTraceInterceptor.metrics.dropped++;\n        LogixiaLoggerModule.getGlobalLogger()?.warn(\n          `[KafkaTraceInterceptor] Missing traceId on topic \"${rpcData?.topic}\" — message skipped.`\n        );\n        return EMPTY;\n      }\n      KafkaTraceInterceptor.metrics.acceptedWithoutTrace++;\n      return next.handle();\n    }\n\n    KafkaTraceInterceptor.metrics.accepted++;\n\n    const kafkaContext = {\n      messageType: 'kafka',\n      topic: rpcData?.topic,\n      partition: rpcData?.partition,\n      offset: rpcData?.offset,\n      key: rpcData?.key,\n      timestamp: rpcData?.timestamp,\n    };\n\n    return new Observable((subscriber) => {\n      // Capture the inner subscription so it is torn down when the outer\n      // subscriber unsubscribes (consumer shutdown, upstream takeUntil/timeout).\n      // Without returning it, the handler subscription leaked and kept running\n      // after cancellation.\n      let inner: { unsubscribe(): void } | undefined;\n      this.ctx.run(\n        traceId!,\n        () => {\n          inner = next.handle().subscribe({\n            next: (value) => subscriber.next(value),\n            error: (err) => subscriber.error(err),\n            complete: () => subscriber.complete(),\n          });\n        },\n        kafkaContext\n      );\n      return () => inner?.unsubscribe();\n    });\n  }\n}\n","/**\n * Trace ID middleware for NestJS integration\n */\n\nimport type { NestMiddleware } from '@nestjs/common';\nimport { Inject, Injectable, Optional } from '@nestjs/common';\nimport type { NextFunction, Request, Response } from 'express';\n\nimport type { TraceIdConfig } from '../types';\nimport { internalWarn } from '../utils/internal-log';\nimport {\n  buildNameSet,\n  DEFAULT_REDACT_QUERY_PARAMS,\n  redactUrlQuery,\n} from '../utils/sensitive-names';\nimport { DEFAULT_TRACE_HEADERS, extractTraceId, TraceContext } from '../utils/trace.utils';\n\n/** Default response header used to echo the resolved traceId back to the caller. */\nexport const DEFAULT_TRACE_RESPONSE_HEADER = 'X-Trace-Id';\n\n/**\n * Resolve the response header name from config.\n * - `undefined`   → default `'X-Trace-Id'`\n * - `string`      → user's custom header\n * - `false`       → `null` (suppress entirely)\n */\nexport function resolveResponseHeader(config?: TraceIdConfig): string | null {\n  if (config?.responseHeader === false) return null;\n  return config?.responseHeader ?? DEFAULT_TRACE_RESPONSE_HEADER;\n}\n\n/**\n * Echo the trace ID on the response, tolerating non-Express responses and\n * already-sent headers. NestJS can run on Fastify (reply.header() instead of\n * res.setHeader()), and on a closed/sent response setHeader throws — neither\n * should crash the request. The trace ID is still propagated via async context.\n */\nfunction writeTraceHeader(res: unknown, header: string, traceId: string): void {\n  const r = res as {\n    setHeader?: (k: string, v: string) => void;\n    header?: (k: string, v: string) => void;\n    headersSent?: boolean;\n  };\n  if (r.headersSent) return;\n  try {\n    if (typeof r.setHeader === 'function') r.setHeader(header, traceId);\n    else if (typeof r.header === 'function') r.header(header, traceId);\n  } catch {\n    /* response not in a header-settable state — context propagation still works */\n  }\n}\n\n// Extend Express Request interface — requires namespace to augment Express typings\n/* eslint-disable @typescript-eslint/no-namespace */\ndeclare global {\n  namespace Express {\n    interface Request {\n      traceId?: string;\n    }\n  }\n}\n/* eslint-enable @typescript-eslint/no-namespace */\n\n/** Injection token for extra query parameter names redacted in the trace context `url`. */\nexport const LOGIXIA_TRACE_REDACT_QUERY_PARAMS = 'LOGIXIA_TRACE_REDACT_QUERY_PARAMS';\n\n/** The request URL as stored in the trace context: `originalUrl`, sensitive query values redacted. */\nfunction traceUrl(\n  req: { originalUrl?: string; url?: string },\n  names: ReadonlySet<string>\n): string | undefined {\n  const raw = req.originalUrl ?? req.url;\n  return raw === undefined ? undefined : redactUrlQuery(raw, names);\n}\n\n@Injectable()\nexport class TraceMiddleware implements NestMiddleware {\n  private readonly ctx = TraceContext.instance;\n  private readonly redactParams: ReadonlySet<string>;\n\n  constructor(\n    @Optional() private readonly config?: TraceIdConfig,\n    @Optional()\n    @Inject(LOGIXIA_TRACE_REDACT_QUERY_PARAMS)\n    redactQueryParams?: readonly string[]\n  ) {\n    this.redactParams = buildNameSet(DEFAULT_REDACT_QUERY_PARAMS, redactQueryParams);\n    const defaultExtractor = {\n      header: DEFAULT_TRACE_HEADERS,\n      query: ['traceId', 'trace_id'],\n    };\n    this.config = {\n      enabled: true,\n      generator: () => this.ctx.generate(),\n      contextKey: 'traceId',\n      ...config,\n      extractor: config?.extractor\n        ? { ...defaultExtractor, ...config.extractor }\n        : defaultExtractor,\n    };\n    // Only mutate the process-wide context key when tracing is actually enabled —\n    // otherwise a disabled middleware would still change global state.\n    if (this.config.enabled) {\n      this.ctx.setContextKey(this.config.contextKey ?? 'traceId');\n    }\n  }\n\n  use(req: Request, res: Response, next: NextFunction): void {\n    if (!this.config?.enabled) {\n      return next();\n    }\n\n    let traceId: string | undefined;\n\n    if (this.config.extractor) {\n      traceId = extractTraceId(req, this.config.extractor);\n    }\n\n    if (!traceId && this.config.generator) {\n      const candidate = this.config.generator();\n      // Guard against a user-supplied generator that returns a bad value —\n      // fall back to the built-in UUID generator so the request always has\n      // a valid, non-empty traceId downstream.\n      if (typeof candidate === 'string' && candidate.trim().length > 0) {\n        traceId = candidate;\n      } else {\n        internalWarn(\n          'TraceIdConfig.generator returned a non-string/empty value — using built-in generator.'\n        );\n      }\n    }\n    if (!traceId) {\n      traceId = this.ctx.generate();\n    }\n\n    req.traceId = traceId;\n\n    const header = resolveResponseHeader(this.config);\n    if (header) writeTraceHeader(res, header, traceId);\n\n    this.ctx.run(traceId, () => next(), {\n      method: req.method,\n      url: traceUrl(req, this.redactParams),\n      userAgent: req.get('User-Agent'),\n      ip: req.ip || req.socket?.remoteAddress || req.connection?.remoteAddress,\n    });\n  }\n}\n\n/**\n * Factory function to create trace middleware with configuration\n */\nexport function createTraceMiddleware(\n  config?: TraceIdConfig,\n  redactQueryParams?: readonly string[]\n): TraceMiddleware {\n  return new TraceMiddleware(config, redactQueryParams);\n}\n\n/**\n * Functional middleware for Express-style usage\n */\nexport function traceMiddleware(config?: TraceIdConfig, redactQueryParams?: readonly string[]) {\n  const redactParams = buildNameSet(DEFAULT_REDACT_QUERY_PARAMS, redactQueryParams);\n  const ctx = TraceContext.instance;\n  const defaultExtractor = {\n    header: DEFAULT_TRACE_HEADERS,\n    query: ['traceId', 'trace_id'],\n  };\n  const traceConfig = {\n    enabled: true,\n    generator: () => ctx.generate(),\n    contextKey: 'traceId',\n    ...config,\n    extractor: config?.extractor ? { ...defaultExtractor, ...config.extractor } : defaultExtractor,\n  };\n\n  // Only mutate the process-wide context key when the middleware is actually\n  // enabled — otherwise a disabled instance would still change global state.\n  if (traceConfig.enabled) {\n    ctx.setContextKey(traceConfig.contextKey ?? 'traceId');\n  }\n\n  return (req: Request, res: Response, next: NextFunction) => {\n    if (!traceConfig.enabled) {\n      return next();\n    }\n\n    let traceId: string | undefined;\n\n    if (traceConfig.extractor) {\n      traceId = extractTraceId(req, traceConfig.extractor);\n    }\n\n    if (!traceId && traceConfig.generator) {\n      const candidate = traceConfig.generator();\n      if (typeof candidate === 'string' && candidate.trim().length > 0) {\n        traceId = candidate;\n      } else {\n        internalWarn(\n          'TraceIdConfig.generator returned a non-string/empty value — using built-in generator.'\n        );\n      }\n    }\n    if (!traceId) {\n      traceId = ctx.generate();\n    }\n\n    req.traceId = traceId;\n\n    const header = resolveResponseHeader(traceConfig);\n    if (header) writeTraceHeader(res, header, traceId);\n\n    ctx.run(traceId, () => next(), {\n      method: req.method,\n      url: traceUrl(req, redactParams),\n      userAgent: req.get('User-Agent'),\n      ip: req.ip || req.socket?.remoteAddress || req.connection?.remoteAddress,\n    });\n  };\n}\n","/** @format */\n\nimport type { CallHandler, ExecutionContext, NestInterceptor } from '@nestjs/common';\nimport { Injectable } from '@nestjs/common';\nimport { Observable } from 'rxjs';\n\nimport type { TraceIdConfig } from '../types';\nimport { extractTraceId, TraceContext } from '../utils/trace.utils';\n\n@Injectable()\nexport class WebSocketTraceInterceptor implements NestInterceptor {\n  private readonly ctx = TraceContext.instance;\n  private readonly config: TraceIdConfig;\n\n  constructor(config?: TraceIdConfig) {\n    this.config = {\n      enabled: true,\n      contextKey: 'traceId',\n      extractor: {\n        body: ['traceId', 'trace_id', 'x-trace-id'],\n        header: ['x-trace-id', 'trace-id'],\n        query: ['traceId', 'trace_id'],\n      },\n      ...config,\n    };\n  }\n\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any -- NestJS interceptor interface requires Observable<any>\n  intercept(context: ExecutionContext, next: CallHandler): Observable<any> {\n    // Check if trace ID is enabled\n    if (!this.config.enabled) {\n      return next.handle();\n    }\n\n    const wsContext = context.switchToWs();\n    const data = wsContext.getData();\n    const client = wsContext.getClient();\n\n    let traceId: string | undefined;\n\n    // Try to extract existing trace ID using extractor\n    if (this.config.extractor) {\n      // Create a request-like object for extractTraceId\n      const requestLike = {\n        body: data,\n        headers: client?.handshake?.headers || {},\n        query: client?.handshake?.query || {},\n        params: {},\n      };\n      traceId = extractTraceId(requestLike, this.config.extractor);\n    }\n\n    // Only use current trace ID if no extraction happened and we have one\n    if (!traceId) {\n      traceId = this.ctx.getCurrentTraceId();\n    }\n\n    // If still no trace ID and enabled, skip (don't generate)\n    if (!traceId) {\n      return next.handle();\n    }\n\n    // Set up WebSocket-specific context data\n    const wsContextData = {\n      messageType: 'websocket',\n      event: data?.event,\n      socketId: client?.id,\n      rooms: client?.rooms ? Array.from(client.rooms) : [],\n      clientAddress: client?.handshake?.address,\n    };\n\n    // Run the handler with trace ID context\n    return new Observable((observer) => {\n      // Capture the inner subscription so it is torn down when the outer observer\n      // unsubscribes — otherwise the handler subscription leaks after the socket\n      // disconnects or an upstream operator cancels.\n      let inner: { unsubscribe(): void } | undefined;\n      this.ctx.run(\n        traceId!,\n        () => {\n          inner = next.handle().subscribe({\n            next: (value) => observer.next(value),\n            error: (err) => observer.error(err),\n            complete: () => observer.complete(),\n          });\n        },\n        wsContextData\n      );\n      return () => inner?.unsubscribe();\n    });\n  }\n}\n","import type {\n  InjectionToken,\n  MiddlewareConsumer,\n  ModuleMetadata,\n  NestModule,\n  OptionalFactoryDependency,\n  Type,\n} from '@nestjs/common';\nimport { Module, RequestMethod } from '@nestjs/common';\nimport type { RouteInfo } from '@nestjs/common/interfaces/middleware/middleware-configuration.interface';\nimport type { NextFunction, Request, Response } from 'express';\n\nimport type { LoggerConfig, TraceIdConfig } from '../types';\nimport { internalWarn } from '../utils/internal-log';\nimport { TraceContext } from '../utils/trace.utils';\nimport { KafkaTraceInterceptor } from './kafka-trace.interceptor';\nimport { LogixiaLoggerService } from './logitron-nestjs.service';\nimport { TraceMiddleware } from './trace.middleware';\nimport { WebSocketTraceInterceptor } from './websocket-trace.interceptor';\n\nconst DEFAULT_ROUTES: RouteInfo[] = [{ path: '*', method: RequestMethod.ALL }];\n\n// Constants for provider tokens\nexport const LOGIXIA_LOGGER_CONFIG = 'LOGIXIA_LOGGER_CONFIG';\nexport const LOGIXIA_TRACE_CONFIG = 'TRACE_CONFIG';\nexport const LOGIXIA_LOGGER_PREFIX = 'LOGIXIA_LOGGER_';\n\n// Export the service and interceptors for external use\nexport { KafkaTraceInterceptor } from './kafka-trace.interceptor';\nexport { LogixiaLoggerService } from './logitron-nestjs.service';\nexport { WebSocketTraceInterceptor } from './websocket-trace.interceptor';\n\n// Interface for module configuration\ninterface LogixiaModuleConfig {\n  forRoutes?: RouteInfo[];\n  exclude?: RouteInfo[];\n}\n\n// Interface for async configuration\nexport interface LogixiaAsyncOptions extends Pick<ModuleMetadata, 'imports'> {\n  useExisting?: Type<LogixiaOptionsFactory>;\n  useClass?: Type<LogixiaOptionsFactory>;\n  useFactory?: (...args: unknown[]) => Promise<Partial<LoggerConfig>> | Partial<LoggerConfig>;\n  inject?: Array<InjectionToken | OptionalFactoryDependency>;\n}\n\n// Interface for options factory\nexport interface LogixiaOptionsFactory {\n  createLogixiaOptions(): Promise<Partial<LoggerConfig>> | Partial<LoggerConfig>;\n}\n\n/**\n * Logixia Logger Module for NestJS dependency injection\n */\n@Module({})\nexport class LogixiaLoggerModule implements NestModule {\n  private config: LogixiaModuleConfig = {};\n  private static loggerConfig: Partial<LoggerConfig> = {};\n\n  /**\n   * @internal Backing field for the global logger. Do not read or write\n   * directly — use {@link getGlobalLogger} / {@link _setGlobalLogger} which\n   * enforce single-init semantics.\n   */\n  // Retained for backwards compatibility with internal callers that read the\n  // field directly (e.g. nestjs-extras). Treat as read-only — writes must go\n  // through _setGlobalLogger / _resetGlobalLogger.\n  // eslint-disable-next-line sonarjs/public-static-readonly -- intentional: we need to swap this in tests via _resetGlobalLogger, so `readonly` is too strict\n  static _globalLogger: LogixiaLoggerService | null = null;\n\n  /**\n   * @internal Set the global logger exactly once.\n   *\n   * Called from the module's forRoot / forRootAsync factory. If the module is\n   * initialised more than once in the same process (nested DI context, test\n   * harness creating multiple apps, hot reload, etc.) a warning is written to\n   * stderr and the first logger wins — silently overwriting would allow the\n   * newer instance's transport config to replace the live one while the old\n   * one is still being used by registered shutdown hooks, decorators, etc.\n   *\n   * Use {@link _resetGlobalLogger} in tests to reset between runs.\n   */\n  static _setGlobalLogger(service: LogixiaLoggerService): void {\n    if (LogixiaLoggerModule._globalLogger !== null) {\n      internalWarn(\n        'LogixiaLoggerModule.forRoot() was called more than once — ignoring the second init. ' +\n          'If this is intentional (e.g. in tests), call LogixiaLoggerModule._resetGlobalLogger() first.'\n      );\n      return;\n    }\n    LogixiaLoggerModule._globalLogger = service;\n  }\n\n  /** @internal Clear the global logger. Tests only. */\n  static _resetGlobalLogger(): void {\n    LogixiaLoggerModule._globalLogger = null;\n  }\n\n  /**\n   * Returns the global LogixiaLoggerService instance that was created when the\n   * module booted. Useful for logging outside of NestJS DI — utility functions,\n   * plain scripts, decorators — without injecting the service everywhere.\n   *\n   * Returns `null` if called before `LogixiaLoggerModule.forRoot[Async]()` has\n   * been initialised (i.e. before the NestJS app has started).\n   *\n   * @example\n   * ```ts\n   * // some-util.ts\n   * import { LogixiaLoggerModule } from 'logixia/nest';\n   *\n   * export function doSomething() {\n   *   LogixiaLoggerModule.getGlobalLogger()?.info('doing something');\n   * }\n   * ```\n   */\n  static getGlobalLogger(): LogixiaLoggerService | null {\n    return LogixiaLoggerModule._globalLogger;\n  }\n\n  configure(consumer: MiddlewareConsumer) {\n    const { forRoutes = DEFAULT_ROUTES, exclude } = this.config;\n\n    // Resolve the trace config ONCE at configure() time — it does not change\n    // per request, so constructing a fresh TraceMiddleware on every invocation\n    // (the old behaviour) was just allocation churn.\n    let resolvedTraceConfig: TraceIdConfig | undefined;\n    if (typeof LogixiaLoggerModule.loggerConfig.traceId === 'object') {\n      resolvedTraceConfig = LogixiaLoggerModule.loggerConfig.traceId as TraceIdConfig;\n    } else if (LogixiaLoggerModule.loggerConfig.traceId === true) {\n      resolvedTraceConfig = {\n        enabled: true,\n        contextKey: 'traceId',\n        generator: () => TraceContext.instance.generate(),\n      };\n    }\n\n    const middleware = new TraceMiddleware(\n      resolvedTraceConfig,\n      LogixiaLoggerModule.loggerConfig.redact?.queryParams\n    );\n    const middlewareConfig = (req: Request, res: Response, next: NextFunction) =>\n      middleware.use(req, res, next);\n\n    if (exclude) {\n      consumer\n        .apply(middlewareConfig)\n        .exclude(...exclude)\n        .forRoutes(...forRoutes);\n    } else {\n      consumer.apply(middlewareConfig).forRoutes(...forRoutes);\n    }\n  }\n\n  /**\n   * Configure the module with synchronous options\n   */\n  static forRoot(config?: Partial<LoggerConfig>) {\n    // Store config for middleware access\n    LogixiaLoggerModule.loggerConfig = config || {};\n\n    const traceConfig =\n      config?.traceId && typeof config.traceId === 'object'\n        ? config.traceId\n        : { enabled: !!config?.traceId };\n\n    return {\n      module: LogixiaLoggerModule,\n      providers: [\n        {\n          provide: LOGIXIA_LOGGER_CONFIG,\n          useValue: config || {},\n        },\n        {\n          provide: LOGIXIA_TRACE_CONFIG,\n          useValue: traceConfig,\n        },\n        {\n          provide: LogixiaLoggerService,\n          useFactory: (loggerConfig: Partial<LoggerConfig>) => {\n            const defaultConfig: LoggerConfig = {\n              level: 'info',\n              service: 'NestJSApp',\n              environment: 'development',\n              fields: {},\n              formatters: ['text'],\n              outputs: ['console'],\n              levelOptions: {\n                level: 'info', // INFO level\n                levels: {\n                  error: 0,\n                  warn: 1,\n                  info: 2,\n                  debug: 3,\n                  verbose: 4,\n                },\n                colors: {\n                  error: 'red',\n                  warn: 'yellow',\n                  info: 'green',\n                  debug: 'blue',\n                  verbose: 'cyan',\n                },\n              },\n              ...loggerConfig,\n            };\n            const service = new LogixiaLoggerService(defaultConfig);\n            LogixiaLoggerModule._setGlobalLogger(service);\n            return service;\n          },\n          inject: [LOGIXIA_LOGGER_CONFIG],\n        },\n        {\n          provide: KafkaTraceInterceptor,\n          useFactory: (traceConfig: TraceIdConfig | undefined) =>\n            new KafkaTraceInterceptor(traceConfig),\n          inject: [LOGIXIA_TRACE_CONFIG],\n        },\n        {\n          provide: WebSocketTraceInterceptor,\n          useFactory: (traceConfig: TraceIdConfig | undefined) =>\n            new WebSocketTraceInterceptor(traceConfig),\n          inject: [LOGIXIA_TRACE_CONFIG],\n        },\n      ],\n      exports: [\n        LogixiaLoggerService,\n        LOGIXIA_LOGGER_CONFIG,\n        KafkaTraceInterceptor,\n        WebSocketTraceInterceptor,\n      ],\n      global: true,\n    };\n  }\n\n  /**\n   * Configure the module with asynchronous options\n   */\n  static forRootAsync(options: LogixiaAsyncOptions) {\n    return {\n      module: LogixiaLoggerModule,\n      imports: options.imports || [],\n      providers: [\n        ...this.createAsyncProviders(options),\n        {\n          provide: LOGIXIA_TRACE_CONFIG,\n          useFactory: (loggerConfig: Partial<LoggerConfig>) => {\n            return typeof loggerConfig?.traceId === 'object'\n              ? loggerConfig.traceId\n              : { enabled: !!loggerConfig?.traceId };\n          },\n          inject: [LOGIXIA_LOGGER_CONFIG],\n        },\n        {\n          provide: LogixiaLoggerService,\n          useFactory: (loggerConfig: Partial<LoggerConfig>) => {\n            const defaultConfig: LoggerConfig = {\n              level: 'info',\n              service: 'NestJSApp',\n              environment: 'development',\n              fields: {},\n              formatters: ['text'],\n              outputs: ['console'],\n              levelOptions: {\n                level: 'info', // INFO level\n                levels: {\n                  error: 0,\n                  warn: 1,\n                  info: 2,\n                  debug: 3,\n                  verbose: 4,\n                },\n                colors: {\n                  error: 'red',\n                  warn: 'yellow',\n                  info: 'green',\n                  debug: 'blue',\n                  verbose: 'cyan',\n                },\n              },\n              ...loggerConfig,\n            };\n            // Store config for middleware access\n            LogixiaLoggerModule.loggerConfig = defaultConfig;\n            const service = new LogixiaLoggerService(defaultConfig);\n            LogixiaLoggerModule._setGlobalLogger(service);\n            return service;\n          },\n          inject: [LOGIXIA_LOGGER_CONFIG],\n        },\n        {\n          provide: KafkaTraceInterceptor,\n          useFactory: (traceConfig: TraceIdConfig | undefined) =>\n            new KafkaTraceInterceptor(traceConfig),\n          inject: [LOGIXIA_TRACE_CONFIG],\n        },\n        {\n          provide: WebSocketTraceInterceptor,\n          useFactory: (traceConfig: TraceIdConfig | undefined) =>\n            new WebSocketTraceInterceptor(traceConfig),\n          inject: [LOGIXIA_TRACE_CONFIG],\n        },\n      ],\n      exports: [\n        LogixiaLoggerService,\n        LOGIXIA_LOGGER_CONFIG,\n        KafkaTraceInterceptor,\n        WebSocketTraceInterceptor,\n      ],\n      global: true,\n    };\n  }\n\n  /**\n   * Create feature-specific logger instances\n   */\n  static forFeature(context: string) {\n    const providerToken = `${LOGIXIA_LOGGER_PREFIX}${context.toUpperCase()}`;\n    return {\n      module: LogixiaLoggerModule,\n      providers: [\n        {\n          provide: providerToken,\n          useFactory: (baseLogger: LogixiaLoggerService) => {\n            return baseLogger.child(context);\n          },\n          inject: [LogixiaLoggerService],\n        },\n      ],\n      exports: [providerToken],\n    };\n  }\n\n  private static createAsyncProviders(options: LogixiaAsyncOptions) {\n    if (options.useExisting || options.useFactory) {\n      return [this.createAsyncOptionsProvider(options)];\n    }\n    return [\n      this.createAsyncOptionsProvider(options),\n      {\n        provide: options.useClass!,\n        useClass: options.useClass!,\n      },\n    ];\n  }\n\n  private static createAsyncOptionsProvider(options: LogixiaAsyncOptions) {\n    if (options.useFactory) {\n      return {\n        provide: LOGIXIA_LOGGER_CONFIG,\n        useFactory: options.useFactory,\n        inject: options.inject || [],\n      };\n    }\n    return {\n      provide: LOGIXIA_LOGGER_CONFIG,\n      useFactory: async (optionsFactory: LogixiaOptionsFactory) =>\n        await optionsFactory.createLogixiaOptions(),\n      inject: [options.useExisting || options.useClass!],\n    };\n  }\n}\n","/**\n * logixia — NestJS extras: @InjectLogger, @LogMethod, LogixiaExceptionFilter\n *\n * Completes the NestJS deep integration story:\n *   - @InjectLogger() — inject the logger via NestJS DI without typing LOGIXIA_TOKEN manually\n *   - @LogMethod()    — auto-log method entry / exit with args and return value\n *   - LogixiaExceptionFilter — catch-all exception filter that logs unhandled errors\n *                              with full request context before re-throwing\n *\n * @example Full setup\n * ```ts\n * // app.module.ts\n * import { LogixiaLoggerModule } from 'logixia/nest';\n * @Module({ imports: [LogixiaLoggerModule.forRoot({ service: 'api' })] })\n * export class AppModule {}\n *\n * // order.service.ts\n * import { Injectable } from '@nestjs/common';\n * import { InjectLogger, LogMethod, LogixiaLoggerService } from 'logixia/nest';\n *\n * @Injectable()\n * export class OrderService {\n *   constructor(@InjectLogger() private readonly logger: LogixiaLoggerService) {}\n *\n *   @LogMethod()\n *   async createOrder(dto: CreateOrderDto) { … }\n * }\n *\n * // main.ts\n * import { LogixiaExceptionFilter } from 'logixia/nest';\n * app.useGlobalFilters(new LogixiaExceptionFilter(logger));\n * ```\n */\n\nimport type { ArgumentsHost, ExceptionFilter } from '@nestjs/common';\nimport { Catch, Inject, Optional } from '@nestjs/common';\n\nimport { ErrorResponseBuilder } from '../exceptions/builder';\nimport { isLogixiaException } from '../exceptions/exception';\nimport type { LogixiaErrorResponse } from '../exceptions/types';\nimport type { LoggerConfig, LogLevelString, TraceIdConfig } from '../types';\nimport { serializeError } from '../utils/error.utils';\nimport { internalError, internalWarn } from '../utils/internal-log';\nimport { assignOwn } from '../utils/own-property';\nimport {\n  buildNameSet,\n  DEFAULT_REDACT_QUERY_PARAMS,\n  redactUrlQuery,\n  sanitizeText,\n  sensitiveQueryValues,\n} from '../utils/sensitive-names';\nimport { sanitizeIncomingId, TraceContext } from '../utils/trace.utils';\nimport {\n  LOGIXIA_LOGGER_CONFIG,\n  LOGIXIA_LOGGER_PREFIX,\n  LogixiaLoggerModule,\n} from './logitron-logger.module';\nimport { LogixiaLoggerService } from './logitron-nestjs.service';\nimport { resolveResponseHeader } from './trace.middleware';\n\n// ── @InjectLogger() ──────────────────────────────────────────────────────────\n\n/**\n * Inject the Logixia logger registered in the current NestJS DI container.\n *\n * With no argument it injects the root `LogixiaLoggerService` provided by\n * `LogixiaLoggerModule.forRoot[Async]()`. With a `context` it injects the child\n * logger that `LogixiaLoggerModule.forFeature(context)` provides for that context\n * (the feature module must be imported where it is used).\n *\n * @example\n * ```ts\n * constructor(@InjectLogger() private readonly logger: LogixiaLoggerService) {}\n *\n * // with LogixiaLoggerModule.forFeature('orders') imported:\n * constructor(@InjectLogger('orders') private readonly logger: LogixiaLoggerService) {}\n * ```\n */\nexport const InjectLogger = (context?: string): ParameterDecorator =>\n  context === undefined\n    ? Inject(LogixiaLoggerService)\n    : Inject(`${LOGIXIA_LOGGER_PREFIX}${context.toUpperCase()}`);\n\n// ── @LogMethod() ─────────────────────────────────────────────────────────────\n\nexport interface LogMethodOptions {\n  /**\n   * Log level to use for entry / exit messages.\n   * @default 'debug'\n   */\n  level?: LogLevelString;\n  /**\n   * Whether to log the arguments passed to the method.\n   * Disable for high-throughput hot paths.\n   * @default true\n   */\n  logArgs?: boolean;\n  /**\n   * Whether to log the return value of the method.\n   * @default false\n   */\n  logResult?: boolean;\n  /**\n   * Whether to log error stack traces for thrown errors.\n   * @default true\n   */\n  logErrors?: boolean;\n  /**\n   * Custom label used in log messages instead of the auto-detected class.method name.\n   */\n  label?: string;\n}\n\n/**\n * Method decorator that auto-logs entry, exit, duration, and errors.\n *\n * Preserves the original method's sync/async contract: a synchronous method\n * stays synchronous (returns its value directly, with logs emitted\n * fire-and-forget), and an async method is awaited so exit/error logs reflect\n * the resolved result. Attaches to the logger found on the class instance via a\n * `logger` property (the conventional NestJS name).\n *\n * @example\n * ```ts\n * @LogMethod({ level: 'info', logArgs: true })\n * async processPayment(orderId: string): Promise<void> { … }\n * ```\n */\nexport function LogMethod(options: LogMethodOptions = {}): MethodDecorator {\n  const { level = 'debug', logArgs = true, logResult = false, logErrors = true } = options;\n\n  // Use PropertyDescriptor (not generic TypedPropertyDescriptor<T>) to avoid\n  // strict generic inference issues with exactOptionalPropertyTypes.\n  return function (\n    target: object,\n    propertyKey: string | symbol,\n    descriptor: PropertyDescriptor\n  ): PropertyDescriptor {\n    const originalMethod = descriptor.value as ((...args: unknown[]) => unknown) | undefined;\n    if (typeof originalMethod !== 'function') return descriptor;\n\n    const methodName = String(propertyKey);\n    const className =\n      (target as { constructor?: { name?: string } }).constructor?.name ?? 'Unknown';\n    const label = options.label ?? `${className}.${methodName}`;\n\n    let _warnedNoLogger = false;\n\n    // Surface logger failures on stderr instead of silently swallowing them.\n    const reportLogFailure = (phase: string, err: unknown): void => {\n      internalError(`@LogMethod(${label}) ${phase} log failed: ${String(err)}`);\n    };\n\n    // Emit a log line fire-and-forget, routing transport failures to stderr.\n    const emit = (\n      logger: LogixiaLoggerService,\n      phase: string,\n      message: string,\n      data: Record<string, unknown>\n    ): void => {\n      const logFnRaw = (\n        logger as unknown as Record<\n          string,\n          (msg: string, data?: Record<string, unknown>) => Promise<void>\n        >\n      )[level];\n      const logFn = (typeof logFnRaw === 'function' ? logFnRaw : logger.debug).bind(logger);\n      const p = logFn(message, data);\n      if (p && typeof (p as Promise<void>).catch === 'function') {\n        (p as Promise<void>).catch((e: unknown) => reportLogFailure(phase, e));\n      }\n    };\n\n    const emitError = (logger: LogixiaLoggerService, error: unknown, start: number): void => {\n      const err = error instanceof Error ? error : new Error(String(error));\n      const errLog: unknown = logger.error(err, { method: label, durationMs: Date.now() - start });\n      if (errLog && typeof (errLog as Promise<void>).catch === 'function') {\n        (errLog as Promise<void>).catch((e: unknown) => reportLogFailure('error', e));\n      }\n    };\n\n    descriptor.value = function (this: { logger?: LogixiaLoggerService }, ...args: unknown[]) {\n      // Prefer the instance's own logger; fall back to the global module logger.\n      const logger: LogixiaLoggerService | undefined =\n        this.logger ?? LogixiaLoggerModule._globalLogger ?? undefined;\n\n      if (!logger && !_warnedNoLogger) {\n        _warnedNoLogger = true;\n        internalWarn(\n          `@LogMethod on ${label}: no logger available. ` +\n            `Either inject LogixiaLoggerService as this.logger or ensure LogixiaLoggerModule is initialised.`\n        );\n      }\n\n      const start = Date.now();\n      const entry: Record<string, unknown> = { method: label };\n      if (logArgs && args.length > 0) entry['args'] = args;\n      // Entry log is fire-and-forget so a SYNC method is not forced to become\n      // async just to await it.\n      if (logger) emit(logger, 'entry', `→ ${label}`, entry);\n\n      const buildExit = (result: unknown): Record<string, unknown> => {\n        const exit: Record<string, unknown> = { method: label, durationMs: Date.now() - start };\n        if (logResult) exit['result'] = result;\n        return exit;\n      };\n\n      let result: unknown;\n      try {\n        result = originalMethod.apply(this, args);\n      } catch (error) {\n        // Synchronous throw.\n        if (logger && logErrors) emitError(logger, error, start);\n        throw error;\n      }\n\n      // Async method → await via the returned thenable so exit/error reflect the\n      // resolved outcome, and preserve the Promise return type.\n      if (result && typeof (result as PromiseLike<unknown>).then === 'function') {\n        return (result as Promise<unknown>).then(\n          (resolved) => {\n            if (logger) emit(logger, 'exit', `← ${label}`, buildExit(resolved));\n            return resolved;\n          },\n          (error: unknown) => {\n            if (logger && logErrors) emitError(logger, error, start);\n            throw error;\n          }\n        );\n      }\n\n      // Synchronous method → log exit fire-and-forget and return the value as-is,\n      // preserving the original synchronous contract.\n      if (logger) emit(logger, 'exit', `← ${label}`, buildExit(result));\n      return result;\n    };\n\n    return descriptor;\n  };\n}\n\n// ── LogixiaExceptionFilter ───────────────────────────────────────────────────\n\n/**\n * Global NestJS exception filter that converts any exception into the standard\n * `LogixiaErrorResponse` wire format and logs it with full request context.\n *\n * Handles three exception types in priority order:\n *  1. `LogixiaException`     — typed fields used directly\n *  2. NestJS `HttpException` — status + message extracted\n *  3. Unknown / plain Error  — falls back to 500 `server_error`\n *\n * **Debug block (off by default):**\n * Responses never include the `debug` block (stack trace, service, duration)\n * unless `exposeDebug: true` is passed in the filter options. The underlying\n * `cause` is only added when `exposeCause: true` is also set. Enable explicitly\n * for local development only, e.g.\n * `new LogixiaExceptionFilter(logger, undefined, { exposeDebug: process.env.NODE_ENV === 'development' })`.\n *\n * **Trace ID headers:**\n * The request's trace ID is written to one response header — `X-Trace-ID` by\n * default, or the name set via `traceId.responseHeader` (`false` disables it) — so\n * clients can correlate with server logs. The filter does not write\n * `X-Request-ID`.\n *\n * **Retry-After header:**\n * Automatically added for `429` responses (`Retry-After: 60`).\n *\n * Register in `main.ts`:\n * ```ts\n * const logger = app.get(LogixiaLoggerService);\n * app.useGlobalFilters(new LogixiaExceptionFilter(logger));\n * ```\n */\nexport interface LogixiaExceptionFilterOptions {\n  /**\n   * Include the `debug` block (stack trace, service, duration) in error responses.\n   * @default false\n   */\n  exposeDebug?: boolean;\n  /**\n   * Include `debug.cause` as well. Requires `exposeDebug`.\n   * @default false\n   */\n  exposeCause?: boolean;\n  /**\n   * Extra query parameter names whose values are replaced with `[REDACTED]` in the\n   * logged `url`, the response `path`, and any copy of those values inside the error\n   * message, stack or details. Merged with the defaults (`token`, `code`, `password`,\n   * `api_key`, …) and `LoggerConfig.redact.queryParams`.\n   */\n  redactQueryParams?: readonly string[];\n}\n\n/** Injection token for {@link LogixiaExceptionFilterOptions}. */\nexport const LOGIXIA_EXCEPTION_FILTER_OPTIONS = 'LOGIXIA_EXCEPTION_FILTER_OPTIONS';\n\nconst MAX_SCRUB_DEPTH = 8;\n\n/** Copy `value` with every string passed through `clean`; the input is never modified. */\nfunction cleanDeep(value: unknown, clean: (text: string) => string, depth = 0): unknown {\n  if (typeof value === 'string') return clean(value);\n  if (value === null || typeof value !== 'object' || depth >= MAX_SCRUB_DEPTH) return value;\n  if (Array.isArray(value)) return value.map((item) => cleanDeep(item, clean, depth + 1));\n  const out: Record<string, unknown> = {};\n  for (const [key, item] of Object.entries(value)) out[key] = cleanDeep(item, clean, depth + 1);\n  return out;\n}\n\nfunction scrubErrorResponse(\n  response: LogixiaErrorResponse,\n  clean: (text: string) => string\n): LogixiaErrorResponse {\n  const { error, debug } = response;\n  return {\n    ...response,\n    error: cleanDeep(error, clean) as LogixiaErrorResponse['error'],\n    ...(debug !== undefined ? { debug: cleanDeep(debug, clean) as typeof debug } : {}),\n  };\n}\n\nconst MAX_ERROR_DEPTH = 6;\n\n/** Scrub string VALUES of an already serialized tree; keys stay so key-based redaction still applies. */\nfunction scrubSerialized(\n  value: unknown,\n  clean: (text: string) => string,\n  depth: number,\n  seen: WeakSet<object>\n): unknown {\n  if (typeof value === 'string') return clean(value);\n  if (value === null || typeof value !== 'object') {\n    return typeof value === 'function' || typeof value === 'symbol' ? '[Unserializable]' : value;\n  }\n  if (seen.has(value)) return '[Circular]';\n  if (depth >= MAX_ERROR_DEPTH) return '[MaxDepth]';\n  seen.add(value);\n  try {\n    if (Array.isArray(value))\n      return value.map((item) => scrubSerialized(item, clean, depth + 1, seen));\n    const out: Record<string, unknown> = {};\n    for (const [key, item] of Object.entries(value)) {\n      assignOwn(out, key, scrubSerialized(item, clean, depth + 1, seen));\n    }\n    return out;\n  } finally {\n    seen.delete(value);\n  }\n}\n\n/** Minimal copy used when the full sanitize step fails; never throws. */\nfunction fallbackError(exception: unknown, clean: (text: string) => string): Error {\n  let name = 'Error';\n  let message = '[Unserializable]';\n  try {\n    if (exception instanceof Error) {\n      name = exception.name;\n      message = clean(exception.message);\n    }\n  } catch {\n    /* hostile getter or revoked proxy: keep the placeholders */\n  }\n  const copy = new Error(message);\n  copy.name = name;\n  assignOwn(copy, 'serialization', '[Unserializable]');\n  return copy;\n}\n\n/**\n * A fresh Error safe to log. Built from `serializeError` (class instances walked by key,\n * so the logger's key-based redaction still sees `authorization`, `x-api-key`, ...), with\n * string values scrubbed. Keeps name, message, stack, cause and custom properties.\n * The original is untouched and this never throws.\n */\nfunction sanitizedError(exception: unknown, clean: (text: string) => string): Error {\n  try {\n    if (!(exception instanceof Error)) return new Error(clean(String(exception)));\n    const serialized = serializeError(exception);\n    const scrubbed = scrubSerialized(serialized, clean, 0, new WeakSet()) as Record<\n      string,\n      unknown\n    >;\n    const copy = new Error(String(scrubbed['message'] ?? ''));\n    for (const [key, value] of Object.entries(scrubbed)) {\n      if (key === 'message') continue;\n      if (key === 'stack' || key === 'name') {\n        Object.defineProperty(copy, key, { value, writable: true, configurable: true });\n      } else {\n        assignOwn(copy, key, value);\n      }\n    }\n    return copy;\n  } catch {\n    return fallbackError(exception, clean);\n  }\n}\n\n@Catch()\nexport class LogixiaExceptionFilter implements ExceptionFilter {\n  private readonly _logger: LogixiaLoggerService | undefined;\n  private readonly _traceConfig: TraceIdConfig | undefined;\n  private readonly _options: LogixiaExceptionFilterOptions;\n  private readonly _redactParams: ReadonlySet<string>;\n\n  constructor(\n    @Optional()\n    @Inject(LogixiaLoggerService)\n    logger?: LogixiaLoggerService,\n    @Optional()\n    @Inject(LOGIXIA_LOGGER_CONFIG)\n    loggerConfig?: Partial<LoggerConfig>,\n    @Optional()\n    @Inject(LOGIXIA_EXCEPTION_FILTER_OPTIONS)\n    options?: LogixiaExceptionFilterOptions\n  ) {\n    this._options = options ?? {};\n    this._redactParams = buildNameSet(DEFAULT_REDACT_QUERY_PARAMS, [\n      ...(loggerConfig?.redact?.queryParams ?? []),\n      ...(this._options.redactQueryParams ?? []),\n    ]);\n    // Prefer the injected logger; fall back to the global module logger so\n    // `new LogixiaExceptionFilter()` (registered in main.ts before DI resolves)\n    // still logs without needing an explicit logger argument.\n    this._logger = logger ?? LogixiaLoggerModule._globalLogger ?? undefined;\n    // Pick up the user-configured trace settings (response header name, etc.)\n    // so the filter echoes the same header the middleware writes.\n    this._traceConfig =\n      typeof loggerConfig?.traceId === 'object' ? loggerConfig.traceId : undefined;\n  }\n\n  catch(exception: unknown, host: ArgumentsHost): void {\n    const ctx = host.switchToHttp();\n\n    const request = ctx.getRequest<{\n      method?: string;\n      url?: string;\n      originalUrl?: string;\n      id?: string;\n      startTime?: number;\n      headers?: Record<string, string | string[] | undefined>;\n    }>();\n\n    interface MinimalResponse {\n      status(code: number): MinimalResponse;\n      json(body: unknown): void;\n      setHeader(name: string, value: string): void;\n    }\n    const response = ctx.getResponse<MinimalResponse>();\n\n    // ALS is the single source of truth (set by TraceMiddleware).\n    // Fall back to header/request.id only if ALS has nothing (e.g. traceId disabled).\n    const traceId =\n      TraceContext.instance.getCurrentTraceId() ??\n      sanitizeIncomingId(request.headers?.['x-trace-id']) ??\n      sanitizeIncomingId(request.id) ??\n      undefined;\n\n    // Query values like ?token=… must not reach logs or the echoed response path.\n    // `originalUrl` keeps mount prefixes and matches the HTTP logger / wide events.\n    const rawUrl = request.originalUrl ?? request.url ?? '';\n    const url = redactUrlQuery(rawUrl, this._redactParams);\n    // Nest's own 404 puts the full URL in the message, so scrub it from every text field.\n    const secrets = sensitiveQueryValues(rawUrl, this._redactParams);\n    const clean = (text: string): string => sanitizeText(text, this._redactParams, secrets);\n\n    const buildFor = (input: unknown) => {\n      const { response: built, httpStatus: status } = ErrorResponseBuilder.build({\n        exception: input,\n        traceId,\n        path: url || '/',\n        startTime: request.startTime,\n        exposeDebug: this._options.exposeDebug === true,\n        exposeCause: this._options.exposeCause === true,\n      });\n      return { errorResponse: scrubErrorResponse(built, clean), httpStatus: status };\n    };\n    // A hostile exception (throwing getter, revoked proxy) must never lose the response.\n    let result: ReturnType<typeof buildFor>;\n    try {\n      result = buildFor(exception);\n    } catch {\n      result = buildFor(fallbackError(exception, clean));\n    }\n    const { errorResponse, httpStatus } = result;\n    let logixiaException = false;\n    try {\n      logixiaException = isLogixiaException(exception);\n    } catch {\n      /* not inspectable: treat as a plain error */\n    }\n\n    // ── Logging ──────────────────────────────────────────────────────────────\n    if (this._logger) {\n      const requestMeta: Record<string, unknown> = {\n        method: request.method ?? '',\n        url,\n        status: httpStatus,\n        // Only include trace_id when it exists — keeps log records honest when\n        // tracing is disabled (instead of writing `trace_id: undefined`).\n        ...(errorResponse.meta.trace_id !== undefined\n          ? { trace_id: errorResponse.meta.trace_id }\n          : {}),\n      };\n\n      // `error()` / `warn()` return Promise<void> for the structured overload.\n      // We cannot await inside a synchronous ExceptionFilter.catch(), so attach\n      // a `.catch()` to prevent unhandledRejection if a transport fails — and\n      // fall back to stderr so the error is never silently swallowed.\n      const onLogFailure = (err: unknown): void => {\n        internalError(`ExceptionFilter failed to write log entry: ${String(err)}`);\n      };\n\n      let logPromise: Promise<void> | void;\n      if (httpStatus >= 500) {\n        logPromise = this._logger.error(sanitizedError(exception, clean), requestMeta);\n      } else if (logixiaException) {\n        logPromise = this._logger.warn(\n          `[${errorResponse.error.code}] ${errorResponse.error.message}`,\n          requestMeta\n        );\n      } else {\n        logPromise = this._logger.warn(\n          `[${httpStatus}] ${errorResponse.error.message}`,\n          requestMeta\n        );\n      }\n\n      if (logPromise && typeof (logPromise as Promise<void>).catch === 'function') {\n        (logPromise as Promise<void>).catch(onLogFailure);\n      }\n    }\n\n    // ── Response headers ──────────────────────────────────────────────────\n    if (errorResponse.meta.trace_id) {\n      const traceHeader = resolveResponseHeader(this._traceConfig);\n      if (traceHeader) {\n        try {\n          response.setHeader(traceHeader, errorResponse.meta.trace_id);\n        } catch {\n          /* headers already sent or invalid — the body still carries the trace id */\n        }\n      }\n    }\n    if (httpStatus === 429) {\n      try {\n        response.setHeader('Retry-After', '60');\n      } catch {\n        /* headers already sent */\n      }\n    }\n\n    response.status(httpStatus).json(errorResponse);\n  }\n}\n","/**\n * logixia/nest — NestJS integration\n *\n * @example\n * import { LogixiaLoggerModule, LogixiaLoggerService } from 'logixia/nest';\n *\n * @Module({\n *   imports: [LogixiaLoggerModule.forRoot({ levelOptions: { level: 'info' } })],\n * })\n * export class AppModule {}\n */\n\nimport { DEFAULT_CONFIG } from './core/default-config';\nimport { LogixiaLoggerService } from './core/logitron-nestjs.service';\nimport type { LoggerConfig } from './types';\n\n// Everything NestJS-specific. These were exported from the root `logixia`\n// entry before 2.0.0; keep this list a superset of what the root used to export.\nexport * from './core/logitron-logger.module';\nexport * from './core/logitron-nestjs.service';\nexport type { LogixiaExceptionFilterOptions, LogMethodOptions } from './core/nestjs-extras';\nexport {\n  InjectLogger,\n  LOGIXIA_EXCEPTION_FILTER_OPTIONS,\n  LogixiaExceptionFilter,\n  LogMethod,\n} from './core/nestjs-extras';\nexport { TraceMiddleware } from './core/trace.middleware';\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"],"mappings":"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"}
+{"version":3,"file":"nest.mjs","names":[],"sources":["../src/core/logitron-nestjs.service.ts","../src/core/kafka-trace.interceptor.ts","../src/core/trace.middleware.ts","../src/core/websocket-trace.interceptor.ts","../src/core/logitron-logger.module.ts","../src/core/nestjs-extras.ts","../src/nest.ts"],"sourcesContent":["/**\n * NestJS Service integration for Logixia Logger\n *\n * Implements NestJS's `LoggerService` interface for framework compat, while\n * simultaneously exposing native async overloads that accept structured data:\n *\n *   // NestJS compat — void, string context\n *   logger.warn('message', 'AuthService');\n *\n *   // Native async — Promise<void>, structured metadata\n *   await logger.warn('message', { userId: 'u_abc', action: 'login' });\n *\n * TypeScript resolves the correct overload automatically based on the type of\n * the second argument:\n *   - second arg is `Record<string, unknown>`  → native path  (returns Promise<void>)\n *   - second arg is `string | undefined`       → NestJS compat (returns void)\n *\n * No wrapper, no casting required on the calling side.\n */\n\nimport type { LoggerService } from '@nestjs/common';\nimport { Injectable, Scope } from '@nestjs/common';\n\nimport type { LoggerConfig, LogLevelString } from '../types';\nimport { LogLevel } from '../types';\n\n// ── Custom-level IntelliSense helpers ─────────────────────────────────────────\n\n/**\n * Level names that already have proper typed implementations on LogixiaLoggerService.\n * These are excluded from the auto-generated method type so we don't produce\n * duplicate / conflicting signatures.\n */\ntype _ServiceBuiltinLevels =\n  'error' | 'warn' | 'info' | 'debug' | 'verbose' | 'trace' | 'log' | 'logLevel';\n\n/**\n * Mapped type that adds one method per *custom* level (i.e. every key in TLevels\n * that is not already a built-in method on LogixiaLoggerService).\n *\n * @example\n * ServiceCustomLevelMethods<{ kafka: 3; mysql: 4; payment: 5 }>\n * // → { kafka(msg, data?): Promise<void>; mysql(...): …; payment(...): … }\n */\ntype ServiceCustomLevelMethods<TLevels extends Record<string, number>> = {\n  readonly [K in keyof TLevels as K extends _ServiceBuiltinLevels ? never : K & string]: (\n    message: string,\n    data?: Record<string, unknown>\n  ) => Promise<void>;\n};\n\n/**\n * The return type of `LogixiaLoggerService.create<T>(config)`.\n *\n * When `T` carries `levelOptions.levels`, this type intersects\n * `LogixiaLoggerService` with a method for every *custom* level so the IDE\n * suggests `service.kafka(...)`, `service.payment(...)`, etc.\n */\nexport type LogixiaServiceWithLevels<T extends LoggerConfig<Record<string, number>>> =\n  T['levelOptions'] extends { levels: infer L }\n    ? L extends Record<string, number>\n      ? LogixiaLoggerService & ServiceCustomLevelMethods<L>\n      : LogixiaLoggerService\n    : LogixiaLoggerService;\n\n/**\n * Helper — extracts custom level names from a config object's `levelOptions.levels`.\n */\ntype _ExtractCustomLevelNames<T> = T extends { levelOptions?: { levels?: infer L } }\n  ? L extends Record<string, number>\n    ? Exclude<keyof L & string, _ServiceBuiltinLevels>\n    : never\n  : never;\n\n/**\n * Typed `LogixiaLoggerService` with autocomplete for custom levels.\n *\n * Accepts either:\n *   - **string union** of custom level names: `LogixiaServiceWith<'kafka' | 'payment'>`\n *   - **config object type** (via `typeof`): `LogixiaServiceWith<typeof logixiaConfig>`\n *\n * Define your config with `as const` once, derive the type everywhere:\n *\n * @example\n * ```ts\n * // logger.config.ts — define once\n * export const logixiaConfig = {\n *   levelOptions: {\n *     levels: { error: 0, warn: 1, info: 2, debug: 3, verbose: 4, kafka: 5, payment: 6 },\n *   },\n * } as const;\n * export type AppLogger = LogixiaServiceWith<typeof logixiaConfig>;\n *\n * // any.controller.ts — use everywhere, no casting\n * constructor(private readonly logger: AppLogger) {}\n * // this.logger.kafka('msg')  ← fully typed\n * // this.logger.payment('msg') ← fully typed\n * ```\n *\n * @example\n * ```ts\n * // Or use string union directly:\n * type AppLogger = LogixiaServiceWith<'kafka' | 'payment'>;\n * ```\n */\nexport type LogixiaServiceWith<T extends string | Record<string, unknown>> =\n  LogixiaLoggerService & {\n    readonly [\n      K in T extends string ? Exclude<T, _ServiceBuiltinLevels> : _ExtractCustomLevelNames<T>\n    ]: (message: string, data?: Record<string, unknown>) => Promise<void>;\n  };\nimport { protectSecrets } from '../transports/secret-config';\nimport { safeToString } from '../utils/coerce.utils';\nimport { internalError } from '../utils/internal-log';\nimport { getTraceContextKey, TraceContext } from '../utils/trace.utils';\nimport { LogixiaLogger } from './logitron-logger';\n\n@Injectable({ scope: Scope.TRANSIENT })\nexport class LogixiaLoggerService implements LoggerService {\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any -- index signature required for dynamic custom-level methods\n  [K: string]: any;\n\n  private logger: LogixiaLogger;\n  private context?: string;\n  private _mergedConfig: LoggerConfig;\n\n  constructor(config?: LoggerConfig) {\n    const defaultConfig: LoggerConfig = {\n      appName: 'NestJS-App',\n      environment: 'development',\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          error: 0,\n          warn: 1,\n          log: 2,\n          debug: 3,\n          verbose: 4,\n        },\n        colors: {\n          error: 'red',\n          warn: 'yellow',\n          log: 'green',\n          debug: 'blue',\n          verbose: 'cyan',\n        },\n      },\n      fields: {\n        timestamp: '[yyyy-mm-dd HH:MM:ss.MS]',\n        level: '[log_level]',\n        appName: '[app_name]',\n        traceId: '[trace_id]',\n        message: '[message]',\n        payload: '[payload]',\n        timeTaken: '[time_taken_MS]',\n      },\n    };\n\n    protectSecrets(this, ['_mergedConfig']);\n    this._mergedConfig = { ...defaultConfig, ...config };\n    this.logger = new LogixiaLogger(this._mergedConfig);\n    this._createCustomLevelMethods();\n  }\n\n  // Dynamically adds a proxy method for every custom level defined in levelOptions.levels\n  // so that `service.payment('msg')` works the same as `service.logLevel('payment', 'msg')`.\n  private _createCustomLevelMethods(): void {\n    const levels = this._mergedConfig.levelOptions?.levels;\n    if (!levels) return;\n    for (const levelName of Object.keys(levels)) {\n      const lower = levelName.toLowerCase();\n      // Skip levels that already have a built-in implementation on this class\n      if (typeof (this as Record<string, unknown>)[lower] !== 'undefined') continue;\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      (this as any)[lower] = async (\n        message: string,\n        data?: Record<string, unknown>\n      ): Promise<void> => {\n        return this.logger.logLevel(lower, message, data);\n      };\n    }\n  }\n\n  // ── log / info ──────────────────────────────────────────────────────────────\n\n  /**\n   * NestJS `LoggerService.log` — void, string context.\n   * Maps internally to `info`.\n   *\n   * @example `logger.log('User signed up', 'AuthService')`\n   */\n  log(message: unknown, context?: string): void {\n    this.setContextIfProvided(context);\n    this.logger\n      .info(this.formatMessage(message))\n      .catch((err: unknown) => internalError('LogixiaLoggerService.log failed', err));\n  }\n\n  /**\n   * Native async `info` — structured data, returns `Promise<void>`.\n   *\n   * @example `await logger.info('User signed up', { userId: 'u_abc' })`\n   */\n  async info(message: string, data?: Record<string, unknown>): Promise<void> {\n    return this.logger.info(message, data);\n  }\n\n  // ── error ──────────────────────────────────────────────────────────────────\n\n  /**\n   * Native async overload — structured metadata, returns `Promise<void>`.\n   *\n   * @example `await logger.error(new Error('DB timeout'), { requestId: 'req_abc' })`\n   * @example `await logger.error('Login failed', { userId: 'u_abc' })`\n   */\n  error(message: string | Error, data: Record<string, unknown>): Promise<void>;\n\n  /**\n   * NestJS compat overload — string trace + optional context, returns `void`.\n   *\n   * @example `logger.error('Something failed', err.stack, 'AuthService')`\n   */\n  error(message: unknown, trace?: string, context?: string): void;\n\n  error(\n    message: unknown,\n    dataOrTrace?: Record<string, unknown> | string,\n    context?: string\n  ): void | Promise<void> {\n    // ── Native path: second arg is a structured-data object ──────────────────\n    if (typeof dataOrTrace === 'object' && dataOrTrace !== null) {\n      return message instanceof Error\n        ? this.logger.error(message, dataOrTrace)\n        : this.logger.error(this.formatMessage(message), dataOrTrace);\n    }\n\n    // ── NestJS compat path: second arg is trace string or undefined ──────────\n    this.setContextIfProvided(context);\n    const errorData: Record<string, string> = {};\n    if (typeof dataOrTrace === 'string' && dataOrTrace) {\n      errorData.stack = dataOrTrace;\n    }\n\n    const logPromise =\n      message instanceof Error\n        ? this.logger.error(message, errorData)\n        : this.logger.error(this.formatMessage(message), errorData);\n\n    logPromise.catch((err: unknown) => internalError('LogixiaLoggerService.error failed', err));\n  }\n\n  // ── warn ───────────────────────────────────────────────────────────────────\n\n  /**\n   * Native async overload — structured metadata, returns `Promise<void>`.\n   *\n   * @example `await logger.warn('Rate limit approaching', { userId: 'u_abc', count: 90 })`\n   */\n  warn(message: string, data: Record<string, unknown>): Promise<void>;\n\n  /**\n   * NestJS compat overload — optional context string, returns `void`.\n   *\n   * @example `logger.warn('Deprecated API used', 'PaymentService')`\n   */\n  warn(message: unknown, context?: string): void;\n\n  warn(message: unknown, dataOrContext?: Record<string, unknown> | string): void | Promise<void> {\n    if (typeof dataOrContext === 'object' && dataOrContext !== null) {\n      return this.logger.warn(this.formatMessage(message), dataOrContext);\n    }\n    this.setContextIfProvided(typeof dataOrContext === 'string' ? dataOrContext : undefined);\n    this.logger\n      .warn(this.formatMessage(message))\n      .catch((err: unknown) => internalError('LogixiaLoggerService.warn failed', err));\n  }\n\n  // ── debug ──────────────────────────────────────────────────────────────────\n\n  /**\n   * Native async overload — structured metadata, returns `Promise<void>`.\n   *\n   * @example `await logger.debug('Cache miss', { key: 'user:abc', ttl: 300 })`\n   */\n  debug(message: string, data: Record<string, unknown>): Promise<void>;\n\n  /**\n   * NestJS compat overload — optional context string, returns `void`.\n   *\n   * @example `logger.debug('Processing request', 'OrderService')`\n   */\n  debug(message: unknown, context?: string): void;\n\n  debug(message: unknown, dataOrContext?: Record<string, unknown> | string): void | Promise<void> {\n    if (typeof dataOrContext === 'object' && dataOrContext !== null) {\n      return this.logger.debug(this.formatMessage(message), dataOrContext);\n    }\n    this.setContextIfProvided(typeof dataOrContext === 'string' ? dataOrContext : undefined);\n    this.logger\n      .debug(this.formatMessage(message))\n      .catch((err: unknown) => internalError('LogixiaLoggerService.debug failed', err));\n  }\n\n  // ── verbose ────────────────────────────────────────────────────────────────\n\n  /**\n   * Native async overload — structured metadata, returns `Promise<void>`.\n   * Maps to `trace` level internally.\n   *\n   * @example `await logger.verbose('Socket message received', { event: 'ping', size: 42 })`\n   */\n  verbose(message: string, data: Record<string, unknown>): Promise<void>;\n\n  /**\n   * NestJS compat overload — optional context string, returns `void`.\n   *\n   * @example `logger.verbose('Connection established', 'WebSocketGateway')`\n   */\n  verbose(message: unknown, context?: string): void;\n\n  verbose(\n    message: unknown,\n    dataOrContext?: Record<string, unknown> | string\n  ): void | Promise<void> {\n    if (typeof dataOrContext === 'object' && dataOrContext !== null) {\n      return this.logger.trace(this.formatMessage(message), dataOrContext);\n    }\n    this.setContextIfProvided(typeof dataOrContext === 'string' ? dataOrContext : undefined);\n    this.logger\n      .trace(this.formatMessage(message))\n      .catch((err: unknown) => internalError('LogixiaLoggerService.verbose failed', err));\n  }\n\n  // ── trace / logLevel ───────────────────────────────────────────────────────\n\n  /**\n   * Native async `trace` — lowest verbosity level, structured data.\n   */\n  async trace(message: string, data?: Record<string, unknown>): Promise<void> {\n    return this.logger.trace(message, data);\n  }\n\n  /**\n   * Log at any named level with structured data.\n   */\n  logLevel(level: string, message: string, data?: Record<string, unknown>): Promise<void> {\n    return this.logger.logLevel(level, message, data);\n  }\n\n  // ── Timing ─────────────────────────────────────────────────────────────────\n\n  time(label: string): void {\n    this.logger.time(label);\n  }\n\n  async timeEnd(label: string): Promise<number | undefined> {\n    return this.logger.timeEnd(label);\n  }\n\n  async timeAsync<T>(label: string, fn: () => Promise<T>): Promise<T> {\n    return this.logger.timeAsync(label, fn);\n  }\n\n  // ── Context / level management ─────────────────────────────────────────────\n\n  setContext(context: string): void {\n    const coerced = typeof context === 'string' ? context : safeToString(context);\n    this.context = coerced;\n    this.logger.setContext(coerced);\n  }\n\n  getContext(): string | undefined {\n    return this.context;\n  }\n\n  setLevel(level: LogLevelString): void {\n    this.logger.setLevel(level);\n  }\n\n  getLevel(): LogLevelString {\n    return this.logger.getLevel();\n  }\n\n  // ── Child logger ───────────────────────────────────────────────────────────\n\n  child(context: string, data?: Record<string, unknown>): LogixiaLoggerService {\n    const childService = new LogixiaLoggerService(this._mergedConfig);\n    childService.logger = this.logger.child(context, data) as LogixiaLogger;\n    childService.context = context;\n    return childService;\n  }\n\n  // ── Misc ───────────────────────────────────────────────────────────────────\n\n  getCurrentTraceId(): string | undefined {\n    return TraceContext.instance.getCurrentTraceId();\n  }\n\n  /** Returns the AsyncLocalStorage key currently used to store the trace ID. */\n  get traceContextKey(): string {\n    return getTraceContextKey();\n  }\n\n  async close(): Promise<void> {\n    return this.logger.close();\n  }\n\n  static create<T extends LoggerConfig<Record<string, number>>>(\n    config?: T\n  ): LogixiaServiceWithLevels<T> {\n    return new LogixiaLoggerService(config) as unknown as LogixiaServiceWithLevels<T>;\n  }\n\n  getLogger(): LogixiaLogger {\n    return this.logger;\n  }\n\n  // ── Private helpers ────────────────────────────────────────────────────────\n\n  private setContextIfProvided(context?: unknown): void {\n    // NestJS framework occasionally passes non-string values (ExecutionContext,\n    // arguments host, etc.) in the context slot. Silently ignore those — we\n    // only want an explicit string label to override `this.context`.\n    if (typeof context !== 'string' || context.length === 0) return;\n    if (context !== this.context) {\n      this.setContext(context);\n    }\n  }\n\n  private formatMessage(message: unknown): string {\n    if (typeof message === 'string') return message;\n    // The core logger redacts an object message by key and path before turning it\n    // into a string. Stringifying here first would leave it only the patterns.\n    if (message !== null && typeof message === 'object') return message as unknown as string;\n    // Use safeToString rather than raw JSON.stringify: NestJS passes arbitrary\n    // values here, and JSON.stringify both THROWS on circular structures (which\n    // would crash the log call) and RETURNS undefined for some inputs (e.g. a\n    // toJSON returning undefined). safeToString handles both safely.\n    return safeToString(message);\n  }\n}\n","/** @format */\n\nimport type { CallHandler, ExecutionContext, NestInterceptor } from '@nestjs/common';\nimport { Injectable } from '@nestjs/common';\nimport { EMPTY, Observable } from 'rxjs';\n\nimport type { TraceIdConfig } from '../types';\nimport { extractTraceId, TraceContext } from '../utils/trace.utils';\nimport { LogixiaLoggerModule } from './logitron-logger.module';\n\n/**\n * Observable counters exposed for monitoring Kafka consumer trace hygiene.\n *\n * Usage:\n *   import { KafkaTraceInterceptor } from 'logixia/nest';\n *   setInterval(() => {\n *     myMetrics.gauge('kafka.trace.dropped', KafkaTraceInterceptor.metrics.dropped);\n *   }, 10_000);\n */\nexport interface KafkaTraceMetrics {\n  /** Messages processed where a traceId was successfully resolved (body/header/ALS). */\n  accepted: number;\n  /** Messages handled without any traceId — `requireTraceId: false`. */\n  acceptedWithoutTrace: number;\n  /** Messages dropped because `requireTraceId: true` and no traceId was found. */\n  dropped: number;\n}\n\n@Injectable()\nexport class KafkaTraceInterceptor implements NestInterceptor {\n  /**\n   * Process-wide counters. Readable from anywhere — scrape into your metrics\n   * system (Prometheus, Datadog, CloudWatch) on an interval.\n   */\n  static readonly metrics: KafkaTraceMetrics = {\n    accepted: 0,\n    acceptedWithoutTrace: 0,\n    dropped: 0,\n  };\n\n  /** Reset counters (tests). */\n  static resetMetrics(): void {\n    KafkaTraceInterceptor.metrics.accepted = 0;\n    KafkaTraceInterceptor.metrics.acceptedWithoutTrace = 0;\n    KafkaTraceInterceptor.metrics.dropped = 0;\n  }\n\n  private readonly ctx = TraceContext.instance;\n  private readonly config: TraceIdConfig;\n\n  /**\n   * @param config        - TraceIdConfig options (extractor keys, contextKey, etc.)\n   * @param requireTraceId - When true, messages with no traceId are silently skipped\n   *                         (EMPTY Observable — message is ack'd, consumer stays alive).\n   *                         A WARN is logged AND `KafkaTraceInterceptor.metrics.dropped`\n   *                         increments so the missing traceId is observable end-to-end.\n   *                         Default: false (handler runs without trace context).\n   */\n  constructor(\n    config?: TraceIdConfig,\n    private readonly requireTraceId: boolean = false\n  ) {\n    this.config = {\n      enabled: true,\n      contextKey: 'traceId',\n      extractor: {\n        body: ['traceId', 'trace_id', 'x-trace-id'],\n        header: ['x-trace-id', 'trace-id'],\n      },\n      ...config,\n    };\n  }\n\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any -- NestJS interceptor interface requires Observable<any>\n  intercept(context: ExecutionContext, next: CallHandler): Observable<any> {\n    if (!this.config.enabled) {\n      return next.handle();\n    }\n\n    const rpcContext = context.switchToRpc();\n    const data = rpcContext.getData();\n    const rpcData = rpcContext.getContext();\n\n    let traceId: string | undefined;\n\n    if (this.config.extractor) {\n      traceId = extractTraceId(\n        { body: data, headers: rpcData?.headers ?? {}, query: {}, params: {} },\n        this.config.extractor\n      );\n    }\n\n    if (!traceId) {\n      traceId = this.ctx.getCurrentTraceId();\n    }\n\n    if (!traceId) {\n      if (this.requireTraceId) {\n        // Warn via global logger (set when LogixiaLoggerModule boots) and ack\n        // the message by returning EMPTY — consumer stays alive, no retry loop.\n        KafkaTraceInterceptor.metrics.dropped++;\n        LogixiaLoggerModule.getGlobalLogger()?.warn(\n          `[KafkaTraceInterceptor] Missing traceId on topic \"${rpcData?.topic}\" — message skipped.`\n        );\n        return EMPTY;\n      }\n      KafkaTraceInterceptor.metrics.acceptedWithoutTrace++;\n      return next.handle();\n    }\n\n    KafkaTraceInterceptor.metrics.accepted++;\n\n    const kafkaContext = {\n      messageType: 'kafka',\n      topic: rpcData?.topic,\n      partition: rpcData?.partition,\n      offset: rpcData?.offset,\n      key: rpcData?.key,\n      timestamp: rpcData?.timestamp,\n    };\n\n    return new Observable((subscriber) => {\n      // Capture the inner subscription so it is torn down when the outer\n      // subscriber unsubscribes (consumer shutdown, upstream takeUntil/timeout).\n      // Without returning it, the handler subscription leaked and kept running\n      // after cancellation.\n      let inner: { unsubscribe(): void } | undefined;\n      this.ctx.run(\n        traceId!,\n        () => {\n          inner = next.handle().subscribe({\n            next: (value) => subscriber.next(value),\n            error: (err) => subscriber.error(err),\n            complete: () => subscriber.complete(),\n          });\n        },\n        kafkaContext\n      );\n      return () => inner?.unsubscribe();\n    });\n  }\n}\n","/**\n * Trace ID middleware for NestJS integration\n */\n\nimport type { NestMiddleware } from '@nestjs/common';\nimport { Inject, Injectable, Optional } from '@nestjs/common';\nimport type { NextFunction, Request, Response } from 'express';\n\nimport type { TraceIdConfig } from '../types';\nimport { internalWarn } from '../utils/internal-log';\nimport {\n  buildNameSet,\n  DEFAULT_REDACT_QUERY_PARAMS,\n  redactUrlQuery,\n} from '../utils/sensitive-names';\nimport { DEFAULT_TRACE_HEADERS, extractTraceId, TraceContext } from '../utils/trace.utils';\n\n/** Default response header used to echo the resolved traceId back to the caller. */\nexport const DEFAULT_TRACE_RESPONSE_HEADER = 'X-Trace-Id';\n\n/**\n * Resolve the response header name from config.\n * - `undefined`   → default `'X-Trace-Id'`\n * - `string`      → user's custom header\n * - `false`       → `null` (suppress entirely)\n */\nexport function resolveResponseHeader(config?: TraceIdConfig): string | null {\n  if (config?.responseHeader === false) return null;\n  return config?.responseHeader ?? DEFAULT_TRACE_RESPONSE_HEADER;\n}\n\n/**\n * Echo the trace ID on the response, tolerating non-Express responses and\n * already-sent headers. NestJS can run on Fastify (reply.header() instead of\n * res.setHeader()), and on a closed/sent response setHeader throws — neither\n * should crash the request. The trace ID is still propagated via async context.\n */\nfunction writeTraceHeader(res: unknown, header: string, traceId: string): void {\n  const r = res as {\n    setHeader?: (k: string, v: string) => void;\n    header?: (k: string, v: string) => void;\n    headersSent?: boolean;\n  };\n  if (r.headersSent) return;\n  try {\n    if (typeof r.setHeader === 'function') r.setHeader(header, traceId);\n    else if (typeof r.header === 'function') r.header(header, traceId);\n  } catch {\n    /* response not in a header-settable state — context propagation still works */\n  }\n}\n\n// Extend Express Request interface — requires namespace to augment Express typings\n/* eslint-disable @typescript-eslint/no-namespace */\ndeclare global {\n  namespace Express {\n    interface Request {\n      traceId?: string;\n    }\n  }\n}\n/* eslint-enable @typescript-eslint/no-namespace */\n\n/** Injection token for extra query parameter names redacted in the trace context `url`. */\nexport const LOGIXIA_TRACE_REDACT_QUERY_PARAMS = 'LOGIXIA_TRACE_REDACT_QUERY_PARAMS';\n\n/** The request URL as stored in the trace context: `originalUrl`, sensitive query values redacted. */\nfunction traceUrl(\n  req: { originalUrl?: string; url?: string },\n  names: ReadonlySet<string>\n): string | undefined {\n  const raw = req.originalUrl ?? req.url;\n  return raw === undefined ? undefined : redactUrlQuery(raw, names);\n}\n\n@Injectable()\nexport class TraceMiddleware implements NestMiddleware {\n  private readonly ctx = TraceContext.instance;\n  private readonly redactParams: ReadonlySet<string>;\n\n  constructor(\n    @Optional() private readonly config?: TraceIdConfig,\n    @Optional()\n    @Inject(LOGIXIA_TRACE_REDACT_QUERY_PARAMS)\n    redactQueryParams?: readonly string[]\n  ) {\n    this.redactParams = buildNameSet(DEFAULT_REDACT_QUERY_PARAMS, redactQueryParams);\n    const defaultExtractor = {\n      header: DEFAULT_TRACE_HEADERS,\n      query: ['traceId', 'trace_id'],\n    };\n    this.config = {\n      enabled: true,\n      generator: () => this.ctx.generate(),\n      contextKey: 'traceId',\n      ...config,\n      extractor: config?.extractor\n        ? { ...defaultExtractor, ...config.extractor }\n        : defaultExtractor,\n    };\n    // Only mutate the process-wide context key when tracing is actually enabled —\n    // otherwise a disabled middleware would still change global state.\n    if (this.config.enabled) {\n      this.ctx.setContextKey(this.config.contextKey ?? 'traceId');\n    }\n  }\n\n  use(req: Request, res: Response, next: NextFunction): void {\n    if (!this.config?.enabled) {\n      return next();\n    }\n\n    let traceId: string | undefined;\n\n    if (this.config.extractor) {\n      traceId = extractTraceId(req, this.config.extractor);\n    }\n\n    if (!traceId && this.config.generator) {\n      const candidate = this.config.generator();\n      // Guard against a user-supplied generator that returns a bad value —\n      // fall back to the built-in UUID generator so the request always has\n      // a valid, non-empty traceId downstream.\n      if (typeof candidate === 'string' && candidate.trim().length > 0) {\n        traceId = candidate;\n      } else {\n        internalWarn(\n          'TraceIdConfig.generator returned a non-string/empty value — using built-in generator.'\n        );\n      }\n    }\n    if (!traceId) {\n      traceId = this.ctx.generate();\n    }\n\n    req.traceId = traceId;\n\n    const header = resolveResponseHeader(this.config);\n    if (header) writeTraceHeader(res, header, traceId);\n\n    this.ctx.run(traceId, () => next(), {\n      method: req.method,\n      url: traceUrl(req, this.redactParams),\n      userAgent: req.get('User-Agent'),\n      ip: req.ip || req.socket?.remoteAddress || req.connection?.remoteAddress,\n    });\n  }\n}\n\n/**\n * Factory function to create trace middleware with configuration\n */\nexport function createTraceMiddleware(\n  config?: TraceIdConfig,\n  redactQueryParams?: readonly string[]\n): TraceMiddleware {\n  return new TraceMiddleware(config, redactQueryParams);\n}\n\n/**\n * Functional middleware for Express-style usage\n */\nexport function traceMiddleware(config?: TraceIdConfig, redactQueryParams?: readonly string[]) {\n  const redactParams = buildNameSet(DEFAULT_REDACT_QUERY_PARAMS, redactQueryParams);\n  const ctx = TraceContext.instance;\n  const defaultExtractor = {\n    header: DEFAULT_TRACE_HEADERS,\n    query: ['traceId', 'trace_id'],\n  };\n  const traceConfig = {\n    enabled: true,\n    generator: () => ctx.generate(),\n    contextKey: 'traceId',\n    ...config,\n    extractor: config?.extractor ? { ...defaultExtractor, ...config.extractor } : defaultExtractor,\n  };\n\n  // Only mutate the process-wide context key when the middleware is actually\n  // enabled — otherwise a disabled instance would still change global state.\n  if (traceConfig.enabled) {\n    ctx.setContextKey(traceConfig.contextKey ?? 'traceId');\n  }\n\n  return (req: Request, res: Response, next: NextFunction) => {\n    if (!traceConfig.enabled) {\n      return next();\n    }\n\n    let traceId: string | undefined;\n\n    if (traceConfig.extractor) {\n      traceId = extractTraceId(req, traceConfig.extractor);\n    }\n\n    if (!traceId && traceConfig.generator) {\n      const candidate = traceConfig.generator();\n      if (typeof candidate === 'string' && candidate.trim().length > 0) {\n        traceId = candidate;\n      } else {\n        internalWarn(\n          'TraceIdConfig.generator returned a non-string/empty value — using built-in generator.'\n        );\n      }\n    }\n    if (!traceId) {\n      traceId = ctx.generate();\n    }\n\n    req.traceId = traceId;\n\n    const header = resolveResponseHeader(traceConfig);\n    if (header) writeTraceHeader(res, header, traceId);\n\n    ctx.run(traceId, () => next(), {\n      method: req.method,\n      url: traceUrl(req, redactParams),\n      userAgent: req.get('User-Agent'),\n      ip: req.ip || req.socket?.remoteAddress || req.connection?.remoteAddress,\n    });\n  };\n}\n","/** @format */\n\nimport type { CallHandler, ExecutionContext, NestInterceptor } from '@nestjs/common';\nimport { Injectable } from '@nestjs/common';\nimport { Observable } from 'rxjs';\n\nimport type { TraceIdConfig } from '../types';\nimport { extractTraceId, TraceContext } from '../utils/trace.utils';\n\n@Injectable()\nexport class WebSocketTraceInterceptor implements NestInterceptor {\n  private readonly ctx = TraceContext.instance;\n  private readonly config: TraceIdConfig;\n\n  constructor(config?: TraceIdConfig) {\n    this.config = {\n      enabled: true,\n      contextKey: 'traceId',\n      extractor: {\n        body: ['traceId', 'trace_id', 'x-trace-id'],\n        header: ['x-trace-id', 'trace-id'],\n        query: ['traceId', 'trace_id'],\n      },\n      ...config,\n    };\n  }\n\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any -- NestJS interceptor interface requires Observable<any>\n  intercept(context: ExecutionContext, next: CallHandler): Observable<any> {\n    // Check if trace ID is enabled\n    if (!this.config.enabled) {\n      return next.handle();\n    }\n\n    const wsContext = context.switchToWs();\n    const data = wsContext.getData();\n    const client = wsContext.getClient();\n\n    let traceId: string | undefined;\n\n    // Try to extract existing trace ID using extractor\n    if (this.config.extractor) {\n      // Create a request-like object for extractTraceId\n      const requestLike = {\n        body: data,\n        headers: client?.handshake?.headers || {},\n        query: client?.handshake?.query || {},\n        params: {},\n      };\n      traceId = extractTraceId(requestLike, this.config.extractor);\n    }\n\n    // Only use current trace ID if no extraction happened and we have one\n    if (!traceId) {\n      traceId = this.ctx.getCurrentTraceId();\n    }\n\n    // If still no trace ID and enabled, skip (don't generate)\n    if (!traceId) {\n      return next.handle();\n    }\n\n    // Set up WebSocket-specific context data\n    const wsContextData = {\n      messageType: 'websocket',\n      event: data?.event,\n      socketId: client?.id,\n      rooms: client?.rooms ? Array.from(client.rooms) : [],\n      clientAddress: client?.handshake?.address,\n    };\n\n    // Run the handler with trace ID context\n    return new Observable((observer) => {\n      // Capture the inner subscription so it is torn down when the outer observer\n      // unsubscribes — otherwise the handler subscription leaks after the socket\n      // disconnects or an upstream operator cancels.\n      let inner: { unsubscribe(): void } | undefined;\n      this.ctx.run(\n        traceId!,\n        () => {\n          inner = next.handle().subscribe({\n            next: (value) => observer.next(value),\n            error: (err) => observer.error(err),\n            complete: () => observer.complete(),\n          });\n        },\n        wsContextData\n      );\n      return () => inner?.unsubscribe();\n    });\n  }\n}\n","import type {\n  InjectionToken,\n  MiddlewareConsumer,\n  ModuleMetadata,\n  NestModule,\n  OptionalFactoryDependency,\n  Type,\n} from '@nestjs/common';\nimport { Module, RequestMethod } from '@nestjs/common';\nimport type { RouteInfo } from '@nestjs/common/interfaces/middleware/middleware-configuration.interface';\nimport type { NextFunction, Request, Response } from 'express';\n\nimport type { LoggerConfig, TraceIdConfig } from '../types';\nimport { internalWarn } from '../utils/internal-log';\nimport { TraceContext } from '../utils/trace.utils';\nimport { KafkaTraceInterceptor } from './kafka-trace.interceptor';\nimport { LogixiaLoggerService } from './logitron-nestjs.service';\nimport { TraceMiddleware } from './trace.middleware';\nimport { WebSocketTraceInterceptor } from './websocket-trace.interceptor';\n\nconst DEFAULT_ROUTES: RouteInfo[] = [{ path: '*', method: RequestMethod.ALL }];\n\n// Constants for provider tokens\nexport const LOGIXIA_LOGGER_CONFIG = 'LOGIXIA_LOGGER_CONFIG';\nexport const LOGIXIA_TRACE_CONFIG = 'TRACE_CONFIG';\nexport const LOGIXIA_LOGGER_PREFIX = 'LOGIXIA_LOGGER_';\n\n// Export the service and interceptors for external use\nexport { KafkaTraceInterceptor } from './kafka-trace.interceptor';\nexport { LogixiaLoggerService } from './logitron-nestjs.service';\nexport { WebSocketTraceInterceptor } from './websocket-trace.interceptor';\n\n// Interface for module configuration\ninterface LogixiaModuleConfig {\n  forRoutes?: RouteInfo[];\n  exclude?: RouteInfo[];\n}\n\n// Interface for async configuration\nexport interface LogixiaAsyncOptions extends Pick<ModuleMetadata, 'imports'> {\n  useExisting?: Type<LogixiaOptionsFactory>;\n  useClass?: Type<LogixiaOptionsFactory>;\n  useFactory?: (...args: unknown[]) => Promise<Partial<LoggerConfig>> | Partial<LoggerConfig>;\n  inject?: Array<InjectionToken | OptionalFactoryDependency>;\n}\n\n// Interface for options factory\nexport interface LogixiaOptionsFactory {\n  createLogixiaOptions(): Promise<Partial<LoggerConfig>> | Partial<LoggerConfig>;\n}\n\n/**\n * Logixia Logger Module for NestJS dependency injection\n */\n@Module({})\nexport class LogixiaLoggerModule implements NestModule {\n  private config: LogixiaModuleConfig = {};\n  private static loggerConfig: Partial<LoggerConfig> = {};\n\n  /**\n   * @internal Backing field for the global logger. Do not read or write\n   * directly — use {@link getGlobalLogger} / {@link _setGlobalLogger} which\n   * enforce single-init semantics.\n   */\n  // Retained for backwards compatibility with internal callers that read the\n  // field directly (e.g. nestjs-extras). Treat as read-only — writes must go\n  // through _setGlobalLogger / _resetGlobalLogger.\n  // eslint-disable-next-line sonarjs/public-static-readonly -- intentional: we need to swap this in tests via _resetGlobalLogger, so `readonly` is too strict\n  static _globalLogger: LogixiaLoggerService | null = null;\n\n  /**\n   * @internal Set the global logger exactly once.\n   *\n   * Called from the module's forRoot / forRootAsync factory. If the module is\n   * initialised more than once in the same process (nested DI context, test\n   * harness creating multiple apps, hot reload, etc.) a warning is written to\n   * stderr and the first logger wins — silently overwriting would allow the\n   * newer instance's transport config to replace the live one while the old\n   * one is still being used by registered shutdown hooks, decorators, etc.\n   *\n   * Use {@link _resetGlobalLogger} in tests to reset between runs.\n   */\n  static _setGlobalLogger(service: LogixiaLoggerService): void {\n    if (LogixiaLoggerModule._globalLogger !== null) {\n      internalWarn(\n        'LogixiaLoggerModule.forRoot() was called more than once — ignoring the second init. ' +\n          'If this is intentional (e.g. in tests), call LogixiaLoggerModule._resetGlobalLogger() first.'\n      );\n      return;\n    }\n    LogixiaLoggerModule._globalLogger = service;\n  }\n\n  /** @internal Clear the global logger. Tests only. */\n  static _resetGlobalLogger(): void {\n    LogixiaLoggerModule._globalLogger = null;\n  }\n\n  /**\n   * Returns the global LogixiaLoggerService instance that was created when the\n   * module booted. Useful for logging outside of NestJS DI — utility functions,\n   * plain scripts, decorators — without injecting the service everywhere.\n   *\n   * Returns `null` if called before `LogixiaLoggerModule.forRoot[Async]()` has\n   * been initialised (i.e. before the NestJS app has started).\n   *\n   * @example\n   * ```ts\n   * // some-util.ts\n   * import { LogixiaLoggerModule } from 'logixia/nest';\n   *\n   * export function doSomething() {\n   *   LogixiaLoggerModule.getGlobalLogger()?.info('doing something');\n   * }\n   * ```\n   */\n  static getGlobalLogger(): LogixiaLoggerService | null {\n    return LogixiaLoggerModule._globalLogger;\n  }\n\n  configure(consumer: MiddlewareConsumer) {\n    const { forRoutes = DEFAULT_ROUTES, exclude } = this.config;\n\n    // Resolve the trace config ONCE at configure() time — it does not change\n    // per request, so constructing a fresh TraceMiddleware on every invocation\n    // (the old behaviour) was just allocation churn.\n    let resolvedTraceConfig: TraceIdConfig | undefined;\n    if (typeof LogixiaLoggerModule.loggerConfig.traceId === 'object') {\n      resolvedTraceConfig = LogixiaLoggerModule.loggerConfig.traceId as TraceIdConfig;\n    } else if (LogixiaLoggerModule.loggerConfig.traceId === true) {\n      resolvedTraceConfig = {\n        enabled: true,\n        contextKey: 'traceId',\n        generator: () => TraceContext.instance.generate(),\n      };\n    }\n\n    const middleware = new TraceMiddleware(\n      resolvedTraceConfig,\n      LogixiaLoggerModule.loggerConfig.redact?.queryParams\n    );\n    const middlewareConfig = (req: Request, res: Response, next: NextFunction) =>\n      middleware.use(req, res, next);\n\n    if (exclude) {\n      consumer\n        .apply(middlewareConfig)\n        .exclude(...exclude)\n        .forRoutes(...forRoutes);\n    } else {\n      consumer.apply(middlewareConfig).forRoutes(...forRoutes);\n    }\n  }\n\n  /**\n   * Configure the module with synchronous options\n   */\n  static forRoot(config?: Partial<LoggerConfig>) {\n    // Store config for middleware access\n    LogixiaLoggerModule.loggerConfig = config || {};\n\n    const traceConfig =\n      config?.traceId && typeof config.traceId === 'object'\n        ? config.traceId\n        : { enabled: !!config?.traceId };\n\n    return {\n      module: LogixiaLoggerModule,\n      providers: [\n        {\n          provide: LOGIXIA_LOGGER_CONFIG,\n          useValue: config || {},\n        },\n        {\n          provide: LOGIXIA_TRACE_CONFIG,\n          useValue: traceConfig,\n        },\n        {\n          provide: LogixiaLoggerService,\n          useFactory: (loggerConfig: Partial<LoggerConfig>) => {\n            const defaultConfig: LoggerConfig = {\n              level: 'info',\n              service: 'NestJSApp',\n              environment: 'development',\n              fields: {},\n              formatters: ['text'],\n              outputs: ['console'],\n              levelOptions: {\n                level: 'info', // INFO level\n                levels: {\n                  error: 0,\n                  warn: 1,\n                  info: 2,\n                  debug: 3,\n                  verbose: 4,\n                },\n                colors: {\n                  error: 'red',\n                  warn: 'yellow',\n                  info: 'green',\n                  debug: 'blue',\n                  verbose: 'cyan',\n                },\n              },\n              ...loggerConfig,\n            };\n            const service = new LogixiaLoggerService(defaultConfig);\n            LogixiaLoggerModule._setGlobalLogger(service);\n            return service;\n          },\n          inject: [LOGIXIA_LOGGER_CONFIG],\n        },\n        {\n          provide: KafkaTraceInterceptor,\n          useFactory: (traceConfig: TraceIdConfig | undefined) =>\n            new KafkaTraceInterceptor(traceConfig),\n          inject: [LOGIXIA_TRACE_CONFIG],\n        },\n        {\n          provide: WebSocketTraceInterceptor,\n          useFactory: (traceConfig: TraceIdConfig | undefined) =>\n            new WebSocketTraceInterceptor(traceConfig),\n          inject: [LOGIXIA_TRACE_CONFIG],\n        },\n      ],\n      exports: [\n        LogixiaLoggerService,\n        LOGIXIA_LOGGER_CONFIG,\n        KafkaTraceInterceptor,\n        WebSocketTraceInterceptor,\n      ],\n      global: true,\n    };\n  }\n\n  /**\n   * Configure the module with asynchronous options\n   */\n  static forRootAsync(options: LogixiaAsyncOptions) {\n    return {\n      module: LogixiaLoggerModule,\n      imports: options.imports || [],\n      providers: [\n        ...this.createAsyncProviders(options),\n        {\n          provide: LOGIXIA_TRACE_CONFIG,\n          useFactory: (loggerConfig: Partial<LoggerConfig>) => {\n            return typeof loggerConfig?.traceId === 'object'\n              ? loggerConfig.traceId\n              : { enabled: !!loggerConfig?.traceId };\n          },\n          inject: [LOGIXIA_LOGGER_CONFIG],\n        },\n        {\n          provide: LogixiaLoggerService,\n          useFactory: (loggerConfig: Partial<LoggerConfig>) => {\n            const defaultConfig: LoggerConfig = {\n              level: 'info',\n              service: 'NestJSApp',\n              environment: 'development',\n              fields: {},\n              formatters: ['text'],\n              outputs: ['console'],\n              levelOptions: {\n                level: 'info', // INFO level\n                levels: {\n                  error: 0,\n                  warn: 1,\n                  info: 2,\n                  debug: 3,\n                  verbose: 4,\n                },\n                colors: {\n                  error: 'red',\n                  warn: 'yellow',\n                  info: 'green',\n                  debug: 'blue',\n                  verbose: 'cyan',\n                },\n              },\n              ...loggerConfig,\n            };\n            // Store config for middleware access\n            LogixiaLoggerModule.loggerConfig = defaultConfig;\n            const service = new LogixiaLoggerService(defaultConfig);\n            LogixiaLoggerModule._setGlobalLogger(service);\n            return service;\n          },\n          inject: [LOGIXIA_LOGGER_CONFIG],\n        },\n        {\n          provide: KafkaTraceInterceptor,\n          useFactory: (traceConfig: TraceIdConfig | undefined) =>\n            new KafkaTraceInterceptor(traceConfig),\n          inject: [LOGIXIA_TRACE_CONFIG],\n        },\n        {\n          provide: WebSocketTraceInterceptor,\n          useFactory: (traceConfig: TraceIdConfig | undefined) =>\n            new WebSocketTraceInterceptor(traceConfig),\n          inject: [LOGIXIA_TRACE_CONFIG],\n        },\n      ],\n      exports: [\n        LogixiaLoggerService,\n        LOGIXIA_LOGGER_CONFIG,\n        KafkaTraceInterceptor,\n        WebSocketTraceInterceptor,\n      ],\n      global: true,\n    };\n  }\n\n  /**\n   * Create feature-specific logger instances\n   */\n  static forFeature(context: string) {\n    const providerToken = `${LOGIXIA_LOGGER_PREFIX}${context.toUpperCase()}`;\n    return {\n      module: LogixiaLoggerModule,\n      providers: [\n        {\n          provide: providerToken,\n          useFactory: (baseLogger: LogixiaLoggerService) => {\n            return baseLogger.child(context);\n          },\n          inject: [LogixiaLoggerService],\n        },\n      ],\n      exports: [providerToken],\n    };\n  }\n\n  private static createAsyncProviders(options: LogixiaAsyncOptions) {\n    if (options.useExisting || options.useFactory) {\n      return [this.createAsyncOptionsProvider(options)];\n    }\n    return [\n      this.createAsyncOptionsProvider(options),\n      {\n        provide: options.useClass!,\n        useClass: options.useClass!,\n      },\n    ];\n  }\n\n  private static createAsyncOptionsProvider(options: LogixiaAsyncOptions) {\n    if (options.useFactory) {\n      return {\n        provide: LOGIXIA_LOGGER_CONFIG,\n        useFactory: options.useFactory,\n        inject: options.inject || [],\n      };\n    }\n    return {\n      provide: LOGIXIA_LOGGER_CONFIG,\n      useFactory: async (optionsFactory: LogixiaOptionsFactory) =>\n        await optionsFactory.createLogixiaOptions(),\n      inject: [options.useExisting || options.useClass!],\n    };\n  }\n}\n","/**\n * logixia — NestJS extras: @InjectLogger, @LogMethod, LogixiaExceptionFilter\n *\n * Completes the NestJS deep integration story:\n *   - @InjectLogger() — inject the logger via NestJS DI without typing LOGIXIA_TOKEN manually\n *   - @LogMethod()    — auto-log method entry / exit with args and return value\n *   - LogixiaExceptionFilter — catch-all exception filter that logs unhandled errors\n *                              with full request context before re-throwing\n *\n * @example Full setup\n * ```ts\n * // app.module.ts\n * import { LogixiaLoggerModule } from 'logixia/nest';\n * @Module({ imports: [LogixiaLoggerModule.forRoot({ service: 'api' })] })\n * export class AppModule {}\n *\n * // order.service.ts\n * import { Injectable } from '@nestjs/common';\n * import { InjectLogger, LogMethod, LogixiaLoggerService } from 'logixia/nest';\n *\n * @Injectable()\n * export class OrderService {\n *   constructor(@InjectLogger() private readonly logger: LogixiaLoggerService) {}\n *\n *   @LogMethod()\n *   async createOrder(dto: CreateOrderDto) { … }\n * }\n *\n * // main.ts\n * import { LogixiaExceptionFilter } from 'logixia/nest';\n * app.useGlobalFilters(new LogixiaExceptionFilter(logger));\n * ```\n */\n\nimport type { ArgumentsHost, ExceptionFilter } from '@nestjs/common';\nimport { Catch, Inject, Optional } from '@nestjs/common';\n\nimport { ErrorResponseBuilder } from '../exceptions/builder';\nimport { isLogixiaException } from '../exceptions/exception';\nimport type { LogixiaErrorResponse } from '../exceptions/types';\nimport type { LoggerConfig, LogLevelString, TraceIdConfig } from '../types';\nimport { serializeError } from '../utils/error.utils';\nimport { internalError, internalWarn } from '../utils/internal-log';\nimport { assignOwn } from '../utils/own-property';\nimport {\n  buildNameSet,\n  DEFAULT_REDACT_QUERY_PARAMS,\n  redactUrlQuery,\n  sanitizeText,\n  sensitiveQueryValues,\n} from '../utils/sensitive-names';\nimport { sanitizeIncomingId, TraceContext } from '../utils/trace.utils';\nimport {\n  LOGIXIA_LOGGER_CONFIG,\n  LOGIXIA_LOGGER_PREFIX,\n  LogixiaLoggerModule,\n} from './logitron-logger.module';\nimport { LogixiaLoggerService } from './logitron-nestjs.service';\nimport { resolveResponseHeader } from './trace.middleware';\n\n// ── @InjectLogger() ──────────────────────────────────────────────────────────\n\n/**\n * Inject the Logixia logger registered in the current NestJS DI container.\n *\n * With no argument it injects the root `LogixiaLoggerService` provided by\n * `LogixiaLoggerModule.forRoot[Async]()`. With a `context` it injects the child\n * logger that `LogixiaLoggerModule.forFeature(context)` provides for that context\n * (the feature module must be imported where it is used).\n *\n * @example\n * ```ts\n * constructor(@InjectLogger() private readonly logger: LogixiaLoggerService) {}\n *\n * // with LogixiaLoggerModule.forFeature('orders') imported:\n * constructor(@InjectLogger('orders') private readonly logger: LogixiaLoggerService) {}\n * ```\n */\nexport const InjectLogger = (context?: string): ParameterDecorator =>\n  context === undefined\n    ? Inject(LogixiaLoggerService)\n    : Inject(`${LOGIXIA_LOGGER_PREFIX}${context.toUpperCase()}`);\n\n// ── @LogMethod() ─────────────────────────────────────────────────────────────\n\nexport interface LogMethodOptions {\n  /**\n   * Log level to use for entry / exit messages.\n   * @default 'debug'\n   */\n  level?: LogLevelString;\n  /**\n   * Whether to log the method's arguments. Off by default: positional arguments\n   * have no key names, so redaction rules can't recognise a password passed as\n   * `validate(username, password)`.\n   * @default false\n   */\n  logArgs?: boolean;\n  /**\n   * Whether to log the return value of the method.\n   * @default false\n   */\n  logResult?: boolean;\n  /**\n   * Whether to log error stack traces for thrown errors.\n   * @default true\n   */\n  logErrors?: boolean;\n  /**\n   * Custom label used in log messages instead of the auto-detected class.method name.\n   */\n  label?: string;\n}\n\n/**\n * Method decorator that auto-logs entry, exit, duration, and errors.\n *\n * Preserves the original method's sync/async contract: a synchronous method\n * stays synchronous (returns its value directly, with logs emitted\n * fire-and-forget), and an async method is awaited so exit/error logs reflect\n * the resolved result. Attaches to the logger found on the class instance via a\n * `logger` property (the conventional NestJS name).\n *\n * @example\n * ```ts\n * @LogMethod({ level: 'info', logArgs: true })\n * async processPayment(orderId: string): Promise<void> { … }\n * ```\n */\nexport function LogMethod(options: LogMethodOptions = {}): MethodDecorator {\n  const { level = 'debug', logArgs = false, logResult = false, logErrors = true } = options;\n\n  // Use PropertyDescriptor (not generic TypedPropertyDescriptor<T>) to avoid\n  // strict generic inference issues with exactOptionalPropertyTypes.\n  return function (\n    target: object,\n    propertyKey: string | symbol,\n    descriptor: PropertyDescriptor\n  ): PropertyDescriptor {\n    const originalMethod = descriptor.value as ((...args: unknown[]) => unknown) | undefined;\n    if (typeof originalMethod !== 'function') return descriptor;\n\n    const methodName = String(propertyKey);\n    const className =\n      (target as { constructor?: { name?: string } }).constructor?.name ?? 'Unknown';\n    const label = options.label ?? `${className}.${methodName}`;\n\n    let _warnedNoLogger = false;\n\n    // Surface logger failures on stderr instead of silently swallowing them.\n    const reportLogFailure = (phase: string, err: unknown): void => {\n      internalError(`@LogMethod(${label}) ${phase} log failed: ${String(err)}`);\n    };\n\n    // Emit a log line fire-and-forget, routing transport failures to stderr.\n    const emit = (\n      logger: LogixiaLoggerService,\n      phase: string,\n      message: string,\n      data: Record<string, unknown>\n    ): void => {\n      const logFnRaw = (\n        logger as unknown as Record<\n          string,\n          (msg: string, data?: Record<string, unknown>) => Promise<void>\n        >\n      )[level];\n      const logFn = (typeof logFnRaw === 'function' ? logFnRaw : logger.debug).bind(logger);\n      const p = logFn(message, data);\n      if (p && typeof (p as Promise<void>).catch === 'function') {\n        (p as Promise<void>).catch((e: unknown) => reportLogFailure(phase, e));\n      }\n    };\n\n    const emitError = (logger: LogixiaLoggerService, error: unknown, start: number): void => {\n      const err = error instanceof Error ? error : new Error(String(error));\n      const errLog: unknown = logger.error(err, { method: label, durationMs: Date.now() - start });\n      if (errLog && typeof (errLog as Promise<void>).catch === 'function') {\n        (errLog as Promise<void>).catch((e: unknown) => reportLogFailure('error', e));\n      }\n    };\n\n    descriptor.value = function (this: { logger?: LogixiaLoggerService }, ...args: unknown[]) {\n      // Prefer the instance's own logger; fall back to the global module logger.\n      const logger: LogixiaLoggerService | undefined =\n        this.logger ?? LogixiaLoggerModule._globalLogger ?? undefined;\n\n      if (!logger && !_warnedNoLogger) {\n        _warnedNoLogger = true;\n        internalWarn(\n          `@LogMethod on ${label}: no logger available. ` +\n            `Either inject LogixiaLoggerService as this.logger or ensure LogixiaLoggerModule is initialised.`\n        );\n      }\n\n      const start = Date.now();\n      const entry: Record<string, unknown> = { method: label };\n      if (logArgs && args.length > 0) entry['args'] = args;\n      // Entry log is fire-and-forget so a SYNC method is not forced to become\n      // async just to await it.\n      if (logger) emit(logger, 'entry', `→ ${label}`, entry);\n\n      const buildExit = (result: unknown): Record<string, unknown> => {\n        const exit: Record<string, unknown> = { method: label, durationMs: Date.now() - start };\n        if (logResult) exit['result'] = result;\n        return exit;\n      };\n\n      let result: unknown;\n      try {\n        result = originalMethod.apply(this, args);\n      } catch (error) {\n        // Synchronous throw.\n        if (logger && logErrors) emitError(logger, error, start);\n        throw error;\n      }\n\n      // Async method → await via the returned thenable so exit/error reflect the\n      // resolved outcome, and preserve the Promise return type.\n      if (result && typeof (result as PromiseLike<unknown>).then === 'function') {\n        return (result as Promise<unknown>).then(\n          (resolved) => {\n            if (logger) emit(logger, 'exit', `← ${label}`, buildExit(resolved));\n            return resolved;\n          },\n          (error: unknown) => {\n            if (logger && logErrors) emitError(logger, error, start);\n            throw error;\n          }\n        );\n      }\n\n      // Synchronous method → log exit fire-and-forget and return the value as-is,\n      // preserving the original synchronous contract.\n      if (logger) emit(logger, 'exit', `← ${label}`, buildExit(result));\n      return result;\n    };\n\n    return descriptor;\n  };\n}\n\n// ── LogixiaExceptionFilter ───────────────────────────────────────────────────\n\n/**\n * Global NestJS exception filter that converts any exception into the standard\n * `LogixiaErrorResponse` wire format and logs it with full request context.\n *\n * Handles three exception types in priority order:\n *  1. `LogixiaException`     — typed fields used directly\n *  2. NestJS `HttpException` — status + message extracted\n *  3. Unknown / plain Error  — falls back to 500 `server_error`\n *\n * **Debug block (off by default):**\n * Responses never include the `debug` block (stack trace, service, duration)\n * unless `exposeDebug: true` is passed in the filter options. The underlying\n * `cause` is only added when `exposeCause: true` is also set. Enable explicitly\n * for local development only, e.g.\n * `new LogixiaExceptionFilter(logger, undefined, { exposeDebug: process.env.NODE_ENV === 'development' })`.\n *\n * **Trace ID headers:**\n * The request's trace ID is written to one response header — `X-Trace-ID` by\n * default, or the name set via `traceId.responseHeader` (`false` disables it) — so\n * clients can correlate with server logs. The filter does not write\n * `X-Request-ID`.\n *\n * **Retry-After header:**\n * Automatically added for `429` responses (`Retry-After: 60`).\n *\n * Register in `main.ts`:\n * ```ts\n * const logger = app.get(LogixiaLoggerService);\n * app.useGlobalFilters(new LogixiaExceptionFilter(logger));\n * ```\n */\nexport interface LogixiaExceptionFilterOptions {\n  /**\n   * Include the `debug` block (stack trace, service, duration) in error responses.\n   * @default false\n   */\n  exposeDebug?: boolean;\n  /**\n   * Include `debug.cause` as well. Requires `exposeDebug`.\n   * @default false\n   */\n  exposeCause?: boolean;\n  /**\n   * Extra query parameter names whose values are replaced with `[REDACTED]` in the\n   * logged `url`, the response `path`, and any copy of those values inside the error\n   * message, stack or details. Merged with the defaults (`token`, `code`, `password`,\n   * `api_key`, …) and `LoggerConfig.redact.queryParams`.\n   */\n  redactQueryParams?: readonly string[];\n}\n\n/** Injection token for {@link LogixiaExceptionFilterOptions}. */\nexport const LOGIXIA_EXCEPTION_FILTER_OPTIONS = 'LOGIXIA_EXCEPTION_FILTER_OPTIONS';\n\nconst MAX_SCRUB_DEPTH = 8;\n\n/** Copy `value` with every string passed through `clean`; the input is never modified. */\nfunction cleanDeep(value: unknown, clean: (text: string) => string, depth = 0): unknown {\n  if (typeof value === 'string') return clean(value);\n  if (value === null || typeof value !== 'object' || depth >= MAX_SCRUB_DEPTH) return value;\n  if (Array.isArray(value)) return value.map((item) => cleanDeep(item, clean, depth + 1));\n  const out: Record<string, unknown> = {};\n  for (const [key, item] of Object.entries(value)) out[key] = cleanDeep(item, clean, depth + 1);\n  return out;\n}\n\nfunction scrubErrorResponse(\n  response: LogixiaErrorResponse,\n  clean: (text: string) => string\n): LogixiaErrorResponse {\n  const { error, debug } = response;\n  return {\n    ...response,\n    error: cleanDeep(error, clean) as LogixiaErrorResponse['error'],\n    ...(debug !== undefined ? { debug: cleanDeep(debug, clean) as typeof debug } : {}),\n  };\n}\n\nconst MAX_ERROR_DEPTH = 6;\n\n/** Scrub string VALUES of an already serialized tree; keys stay so key-based redaction still applies. */\nfunction scrubSerialized(\n  value: unknown,\n  clean: (text: string) => string,\n  depth: number,\n  seen: WeakSet<object>\n): unknown {\n  if (typeof value === 'string') return clean(value);\n  if (value === null || typeof value !== 'object') {\n    return typeof value === 'function' || typeof value === 'symbol' ? '[Unserializable]' : value;\n  }\n  if (seen.has(value)) return '[Circular]';\n  if (depth >= MAX_ERROR_DEPTH) return '[MaxDepth]';\n  seen.add(value);\n  try {\n    if (Array.isArray(value))\n      return value.map((item) => scrubSerialized(item, clean, depth + 1, seen));\n    const out: Record<string, unknown> = {};\n    for (const [key, item] of Object.entries(value)) {\n      assignOwn(out, key, scrubSerialized(item, clean, depth + 1, seen));\n    }\n    return out;\n  } finally {\n    seen.delete(value);\n  }\n}\n\n/** Minimal copy used when the full sanitize step fails; never throws. */\nfunction fallbackError(exception: unknown, clean: (text: string) => string): Error {\n  let name = 'Error';\n  let message = '[Unserializable]';\n  try {\n    if (exception instanceof Error) {\n      name = exception.name;\n      message = clean(exception.message);\n    }\n  } catch {\n    /* hostile getter or revoked proxy: keep the placeholders */\n  }\n  const copy = new Error(message);\n  copy.name = name;\n  assignOwn(copy, 'serialization', '[Unserializable]');\n  return copy;\n}\n\n/**\n * A fresh Error safe to log. Built from `serializeError` (class instances walked by key,\n * so the logger's key-based redaction still sees `authorization`, `x-api-key`, ...), with\n * string values scrubbed. Keeps name, message, stack, cause and custom properties.\n * The original is untouched and this never throws.\n */\nfunction sanitizedError(exception: unknown, clean: (text: string) => string): Error {\n  try {\n    if (!(exception instanceof Error)) return new Error(clean(String(exception)));\n    const serialized = serializeError(exception);\n    const scrubbed = scrubSerialized(serialized, clean, 0, new WeakSet()) as Record<\n      string,\n      unknown\n    >;\n    const copy = new Error(String(scrubbed['message'] ?? ''));\n    for (const [key, value] of Object.entries(scrubbed)) {\n      if (key === 'message') continue;\n      if (key === 'stack' || key === 'name') {\n        Object.defineProperty(copy, key, { value, writable: true, configurable: true });\n      } else {\n        assignOwn(copy, key, value);\n      }\n    }\n    return copy;\n  } catch {\n    return fallbackError(exception, clean);\n  }\n}\n\n@Catch()\nexport class LogixiaExceptionFilter implements ExceptionFilter {\n  private readonly _logger: LogixiaLoggerService | undefined;\n  private readonly _traceConfig: TraceIdConfig | undefined;\n  private readonly _options: LogixiaExceptionFilterOptions;\n  private readonly _redactParams: ReadonlySet<string>;\n\n  constructor(\n    @Optional()\n    @Inject(LogixiaLoggerService)\n    logger?: LogixiaLoggerService,\n    @Optional()\n    @Inject(LOGIXIA_LOGGER_CONFIG)\n    loggerConfig?: Partial<LoggerConfig>,\n    @Optional()\n    @Inject(LOGIXIA_EXCEPTION_FILTER_OPTIONS)\n    options?: LogixiaExceptionFilterOptions\n  ) {\n    this._options = options ?? {};\n    this._redactParams = buildNameSet(DEFAULT_REDACT_QUERY_PARAMS, [\n      ...(loggerConfig?.redact?.queryParams ?? []),\n      ...(this._options.redactQueryParams ?? []),\n    ]);\n    // Prefer the injected logger; fall back to the global module logger so\n    // `new LogixiaExceptionFilter()` (registered in main.ts before DI resolves)\n    // still logs without needing an explicit logger argument.\n    this._logger = logger ?? LogixiaLoggerModule._globalLogger ?? undefined;\n    // Pick up the user-configured trace settings (response header name, etc.)\n    // so the filter echoes the same header the middleware writes.\n    this._traceConfig =\n      typeof loggerConfig?.traceId === 'object' ? loggerConfig.traceId : undefined;\n  }\n\n  catch(exception: unknown, host: ArgumentsHost): void {\n    const ctx = host.switchToHttp();\n\n    const request = ctx.getRequest<{\n      method?: string;\n      url?: string;\n      originalUrl?: string;\n      id?: string;\n      startTime?: number;\n      headers?: Record<string, string | string[] | undefined>;\n    }>();\n\n    interface MinimalResponse {\n      status(code: number): MinimalResponse;\n      json(body: unknown): void;\n      setHeader(name: string, value: string): void;\n    }\n    const response = ctx.getResponse<MinimalResponse>();\n\n    // ALS is the single source of truth (set by TraceMiddleware).\n    // Fall back to header/request.id only if ALS has nothing (e.g. traceId disabled).\n    const traceId =\n      TraceContext.instance.getCurrentTraceId() ??\n      sanitizeIncomingId(request.headers?.['x-trace-id']) ??\n      sanitizeIncomingId(request.id) ??\n      undefined;\n\n    // Query values like ?token=… must not reach logs or the echoed response path.\n    // `originalUrl` keeps mount prefixes and matches the HTTP logger / wide events.\n    const rawUrl = request.originalUrl ?? request.url ?? '';\n    const url = redactUrlQuery(rawUrl, this._redactParams);\n    // Nest's own 404 puts the full URL in the message, so scrub it from every text field.\n    const secrets = sensitiveQueryValues(rawUrl, this._redactParams);\n    const clean = (text: string): string => sanitizeText(text, this._redactParams, secrets);\n\n    const buildFor = (input: unknown) => {\n      const { response: built, httpStatus: status } = ErrorResponseBuilder.build({\n        exception: input,\n        traceId,\n        path: url || '/',\n        startTime: request.startTime,\n        exposeDebug: this._options.exposeDebug === true,\n        exposeCause: this._options.exposeCause === true,\n      });\n      return { errorResponse: scrubErrorResponse(built, clean), httpStatus: status };\n    };\n    // A hostile exception (throwing getter, revoked proxy) must never lose the response.\n    let result: ReturnType<typeof buildFor>;\n    try {\n      result = buildFor(exception);\n    } catch {\n      result = buildFor(fallbackError(exception, clean));\n    }\n    const { errorResponse, httpStatus } = result;\n    let logixiaException = false;\n    try {\n      logixiaException = isLogixiaException(exception);\n    } catch {\n      /* not inspectable: treat as a plain error */\n    }\n\n    // ── Logging ──────────────────────────────────────────────────────────────\n    if (this._logger) {\n      const requestMeta: Record<string, unknown> = {\n        method: request.method ?? '',\n        url,\n        status: httpStatus,\n        // Only include trace_id when it exists — keeps log records honest when\n        // tracing is disabled (instead of writing `trace_id: undefined`).\n        ...(errorResponse.meta.trace_id !== undefined\n          ? { trace_id: errorResponse.meta.trace_id }\n          : {}),\n      };\n\n      // `error()` / `warn()` return Promise<void> for the structured overload.\n      // We cannot await inside a synchronous ExceptionFilter.catch(), so attach\n      // a `.catch()` to prevent unhandledRejection if a transport fails — and\n      // fall back to stderr so the error is never silently swallowed.\n      const onLogFailure = (err: unknown): void => {\n        internalError(`ExceptionFilter failed to write log entry: ${String(err)}`);\n      };\n\n      let logPromise: Promise<void> | void;\n      if (httpStatus >= 500) {\n        logPromise = this._logger.error(sanitizedError(exception, clean), requestMeta);\n      } else if (logixiaException) {\n        logPromise = this._logger.warn(\n          `[${errorResponse.error.code}] ${errorResponse.error.message}`,\n          requestMeta\n        );\n      } else {\n        logPromise = this._logger.warn(\n          `[${httpStatus}] ${errorResponse.error.message}`,\n          requestMeta\n        );\n      }\n\n      if (logPromise && typeof (logPromise as Promise<void>).catch === 'function') {\n        (logPromise as Promise<void>).catch(onLogFailure);\n      }\n    }\n\n    // ── Response headers ──────────────────────────────────────────────────\n    if (errorResponse.meta.trace_id) {\n      const traceHeader = resolveResponseHeader(this._traceConfig);\n      if (traceHeader) {\n        try {\n          response.setHeader(traceHeader, errorResponse.meta.trace_id);\n        } catch {\n          /* headers already sent or invalid — the body still carries the trace id */\n        }\n      }\n    }\n    if (httpStatus === 429) {\n      try {\n        response.setHeader('Retry-After', '60');\n      } catch {\n        /* headers already sent */\n      }\n    }\n\n    response.status(httpStatus).json(errorResponse);\n  }\n}\n","/**\n * logixia/nest — NestJS integration\n *\n * @example\n * import { LogixiaLoggerModule, LogixiaLoggerService } from 'logixia/nest';\n *\n * @Module({\n *   imports: [LogixiaLoggerModule.forRoot({ levelOptions: { level: 'info' } })],\n * })\n * export class AppModule {}\n */\n\nimport { DEFAULT_CONFIG } from './core/default-config';\nimport { LogixiaLoggerService } from './core/logitron-nestjs.service';\nimport type { LoggerConfig } from './types';\n\n// Everything NestJS-specific. These were exported from the root `logixia`\n// entry before 2.0.0; keep this list a superset of what the root used to export.\nexport * from './core/logitron-logger.module';\nexport * from './core/logitron-nestjs.service';\nexport type { LogixiaExceptionFilterOptions, LogMethodOptions } from './core/nestjs-extras';\nexport {\n  InjectLogger,\n  LOGIXIA_EXCEPTION_FILTER_OPTIONS,\n  LogixiaExceptionFilter,\n  LogMethod,\n} from './core/nestjs-extras';\nexport { TraceMiddleware } from './core/trace.middleware';\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"],"mappings":"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"}