logixia 1.13.0 → 2.0.0

package/dist/middleware.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"middleware.mjs","names":["out: Record<string, unknown>","fields: Record<string, unknown>"],"sources":["../src/middleware/http-logger.ts"],"sourcesContent":["/**\n * HTTP request/response logging middleware — Morgan replacement.\n *\n * Fixes every documented Morgan bug:\n *  - statusCode always captured correctly, even for requests > 20 s\n *  - Logs request START (with traceId) and response FINISH (with duration)\n *  - Captures errors before and after response\n *  - Auto-redacts Authorization / Cookie / Set-Cookie headers\n *  - Slow-request warnings\n *  - Skip predicates for health-check routes / static assets\n *\n * @example Express\n * ```ts\n * import { createExpressMiddleware } from 'logixia/middleware';\n * app.use(createExpressMiddleware(logger));\n * ```\n *\n * @example Fastify\n * ```ts\n * import { createFastifyPlugin } from 'logixia/middleware';\n * await fastify.register(createFastifyPlugin(logger));\n * ```\n */\n\nimport type { IBaseLogger } from '../types';\nimport { stringifyForLog } from '../utils/safe-stringify';\n\n// ── Shared types ─────────────────────────────────────────────────────────────\n\nexport interface HttpLoggerOptions {\n  /**\n   * Skip logging for a request. Called before any I/O.\n   * @example `skip: (req) => req.url === '/health'`\n   */\n  skip?: (req: IncomingRequest) => boolean;\n  /**\n   * Log request body (POST/PUT/PATCH). Capped at `bodyMaxBytes` (default: 4096).\n   * Redaction still applies to the captured body.\n   * Default: false.\n   */\n  logBody?: boolean;\n  /** Max bytes of body to capture. Default: 4096. */\n  bodyMaxBytes?: number;\n  /**\n   * Emit a WARN log when a request duration exceeds this threshold (ms).\n   * Default: 1000.\n   */\n  slowRequestThresholdMs?: number;\n  /**\n   * Additional fields to include in every log entry.\n   * @example `extraFields: (req) => ({ tenantId: req.headers['x-tenant-id'] })`\n   */\n  extraFields?: (req: IncomingRequest) => Record<string, unknown>;\n  /**\n   * Trace ID header. Default: 'x-trace-id'.\n   * If the header is absent, a short random ID is generated.\n   */\n  traceIdHeader?: string;\n  /**\n   * Headers to redact from logged output.\n   * Default: ['authorization', 'cookie', 'set-cookie', 'x-api-key'].\n   */\n  redactHeaders?: string[];\n  /**\n   * Log level for request-start entries. Default: 'debug'.\n   * Set to 'silent' to suppress request-start logs entirely.\n   */\n  requestLevel?: string;\n  /** Log level for successful response entries. Default: 'info'. */\n  responseLevel?: string;\n  /** Log level for error responses (status ≥ 500). Default: 'error'. */\n  errorLevel?: string;\n}\n\n// Minimal structural types so we don't need @types/express / fastify in core\nexport interface IncomingRequest {\n  method?: string;\n  url?: string;\n  headers?: Record<string, string | string[] | undefined>;\n  body?: unknown;\n  socket?: { remoteAddress?: string };\n  ip?: string;\n}\n\nexport interface OutgoingResponse {\n  statusCode?: number;\n  on?: (event: string, cb: () => void) => void;\n  once?: (event: string, cb: () => void) => void;\n  getHeader?: (name: string) => string | number | string[] | undefined;\n}\n\n// ── Helpers ───────────────────────────────────────────────────────────────────\n\nconst DEFAULT_REDACT_HEADERS = new Set(['authorization', 'cookie', 'set-cookie', 'x-api-key']);\n\nfunction sanitizeHeaders(\n  headers: Record<string, string | string[] | undefined> | undefined,\n  redactSet: Set<string>\n): Record<string, unknown> {\n  if (!headers) return {};\n  const out: Record<string, unknown> = {};\n  for (const [k, v] of Object.entries(headers)) {\n    if (k === '__proto__' || k === 'constructor' || k === 'prototype') continue;\n    out[k] = redactSet.has(k.toLowerCase()) ? '[REDACTED]' : v;\n  }\n  return out;\n}\n\nfunction shortId(): string {\n  // eslint-disable-next-line sonarjs/pseudo-random -- non-security request ID\n  return Math.random().toString(36).slice(2, 10);\n}\n\nfunction buildBaseFields(\n  req: IncomingRequest,\n  traceId: string,\n  options: HttpLoggerOptions\n): Record<string, unknown> {\n  const redactSet = options.redactHeaders\n    ? new Set(options.redactHeaders.map((h) => h.toLowerCase()))\n    : DEFAULT_REDACT_HEADERS;\n\n  const fields: Record<string, unknown> = {\n    traceId,\n    method: req.method?.toUpperCase() ?? 'UNKNOWN',\n    url: req.url ?? '/',\n    ip: req.ip ?? req.socket?.remoteAddress ?? 'unknown',\n    headers: sanitizeHeaders(req.headers, redactSet),\n  };\n\n  if (options.extraFields) {\n    Object.assign(fields, options.extraFields(req));\n  }\n\n  return fields;\n}\n\n// ── Express middleware ────────────────────────────────────────────────────────\n\n/**\n * Create an Express / Connect compatible middleware that replaces Morgan.\n */\nexport function createExpressMiddleware(\n  logger: IBaseLogger,\n  options: HttpLoggerOptions = {}\n): (req: IncomingRequest, res: OutgoingResponse, next: () => void) => void {\n  const {\n    skip,\n    logBody,\n    bodyMaxBytes,\n    traceIdHeader = 'x-trace-id',\n    requestLevel = 'debug',\n    responseLevel = 'info',\n    errorLevel = 'error',\n    slowRequestThresholdMs = 1000,\n  } = options;\n\n  return function logixiaHttpMiddleware(\n    req: IncomingRequest,\n    res: OutgoingResponse,\n    next: () => void\n  ): void {\n    if (skip?.(req)) {\n      next();\n      return;\n    }\n\n    const traceId = (req.headers?.[traceIdHeader] as string | undefined) ?? shortId();\n    const startMs = Date.now();\n    const baseFields = buildBaseFields(req, traceId, options);\n\n    // Log request start\n    if (requestLevel !== 'silent') {\n      void logger.logLevel(requestLevel, 'request started', {\n        ...baseFields,\n        ...(logBody && req.body ? { body: truncateBody(req.body, bodyMaxBytes) } : {}),\n      });\n    }\n\n    // Hook into the response 'finish' event — fires after headers + body are sent.\n    // This is what Morgan gets wrong for slow requests (it uses 'close' which may\n    // fire before the status code is set on some Node versions).\n    //\n    // BOTH 'finish' and 'close' fire on a normal response, so guard against\n    // logging the completion twice (which would duplicate the completed entry and\n    // the slow-request warning).\n    let completed = false;\n    const onFinish = (): void => {\n      if (completed) return;\n      completed = true;\n\n      const duration = Date.now() - startMs;\n      const status = res.statusCode ?? 0;\n      const level = status >= 500 ? errorLevel : responseLevel;\n\n      void logger.logLevel(level, 'request completed', {\n        ...baseFields,\n        statusCode: status,\n        duration,\n      });\n\n      if (duration > slowRequestThresholdMs) {\n        void logger.warn('slow request detected', {\n          ...baseFields,\n          statusCode: status,\n          duration,\n          threshold: slowRequestThresholdMs,\n        });\n      }\n    };\n\n    res.once?.('finish', onFinish);\n    // Fallback: also covers a client that disconnects before 'finish' fires. The\n    // `completed` guard ensures a normal finish+close pair logs only once.\n    res.once?.('close', onFinish);\n\n    next();\n  };\n}\n\n// ── Fastify plugin ─────────────────────────────────────────────────────────────\n\nexport interface FastifyInstance {\n  addHook: (name: string, fn: (req: unknown, reply: unknown, done: () => void) => void) => void;\n}\n\n/**\n * Create a Fastify plugin (a function you pass to `fastify.register()`).\n *\n * @example\n * ```ts\n * await fastify.register(createFastifyPlugin(logger, { slowRequestThresholdMs: 500 }));\n * ```\n */\nexport function createFastifyPlugin(logger: IBaseLogger, options: HttpLoggerOptions = {}) {\n  const {\n    skip,\n    traceIdHeader = 'x-trace-id',\n    requestLevel = 'debug',\n    responseLevel = 'info',\n    errorLevel = 'error',\n    slowRequestThresholdMs = 1000,\n  } = options;\n\n  function logixiaFastifyPlugin(fastify: FastifyInstance, _opts: unknown, done: () => void): void {\n    fastify.addHook('onRequest', (request: unknown, _reply: unknown, hookDone: () => void) => {\n      const req = request as IncomingRequest & { _logixiaStart?: number; _logixiaId?: string };\n      if (skip?.(req)) {\n        hookDone();\n        return;\n      }\n\n      const traceId = (req.headers?.[traceIdHeader] as string | undefined) ?? shortId();\n      req._logixiaStart = Date.now();\n      req._logixiaId = traceId;\n\n      if (requestLevel !== 'silent') {\n        void logger.logLevel(\n          requestLevel,\n          'request started',\n          buildBaseFields(req, traceId, options)\n        );\n      }\n      hookDone();\n    });\n\n    fastify.addHook('onResponse', (request: unknown, reply: unknown, hookDone: () => void) => {\n      const req = request as IncomingRequest & { _logixiaStart?: number; _logixiaId?: string };\n      if (req._logixiaStart === undefined) {\n        hookDone();\n        return;\n      }\n\n      const rep = reply as { statusCode?: number };\n      const duration = Date.now() - req._logixiaStart;\n      const status = rep.statusCode ?? 0;\n      const traceId = req._logixiaId ?? shortId();\n      const level = status >= 500 ? errorLevel : responseLevel;\n\n      void logger.logLevel(level, 'request completed', {\n        ...buildBaseFields(req, traceId, options),\n        statusCode: status,\n        duration,\n      });\n\n      if (duration > slowRequestThresholdMs) {\n        void logger.warn('slow request detected', {\n          traceId,\n          url: req.url,\n          method: req.method,\n          duration,\n          threshold: slowRequestThresholdMs,\n        });\n      }\n\n      hookDone();\n    });\n\n    done();\n  }\n\n  return Object.assign(logixiaFastifyPlugin, {\n    [Symbol.for('skip-override')]: true,\n    [Symbol.for('fastify.display-name')]: 'logixia',\n  });\n}\n\n// ── Internal helpers ──────────────────────────────────────────────────────────\n\nfunction truncateBody(body: unknown, maxBytes = 4096): unknown {\n  if (typeof body === 'string') {\n    return body.length > maxBytes ? body.slice(0, maxBytes) + '…[truncated]' : body;\n  }\n  if (body && typeof body === 'object') {\n    const str = stringifyForLog(body);\n    if (str.length > maxBytes) {\n      return str.slice(0, maxBytes) + '…[truncated]';\n    }\n  }\n  return body;\n}\n"],"mappings":";;;AA6FA,MAAM,yBAAyB,IAAI,IAAI;CAAC;CAAiB;CAAU;CAAc;CAAY,CAAC;AAE9F,SAAS,gBACP,SACA,WACyB;AACzB,KAAI,CAAC,QAAS,QAAO,EAAE;CACvB,MAAMA,MAA+B,EAAE;AACvC,MAAK,MAAM,CAAC,GAAG,MAAM,OAAO,QAAQ,QAAQ,EAAE;AAC5C,MAAI,MAAM,eAAe,MAAM,iBAAiB,MAAM,YAAa;AACnE,MAAI,KAAK,UAAU,IAAI,EAAE,aAAa,CAAC,GAAG,eAAe;;AAE3D,QAAO;;AAGT,SAAS,UAAkB;AAEzB,QAAO,KAAK,QAAQ,CAAC,SAAS,GAAG,CAAC,MAAM,GAAG,GAAG;;AAGhD,SAAS,gBACP,KACA,SACA,SACyB;;CACzB,MAAM,YAAY,QAAQ,gBACtB,IAAI,IAAI,QAAQ,cAAc,KAAK,MAAM,EAAE,aAAa,CAAC,CAAC,GAC1D;CAEJ,MAAMC,SAAkC;EACtC;EACA,wBAAQ,IAAI,kEAAQ,aAAa,KAAI;EACrC,KAAK,IAAI,OAAO;EAChB,IAAI,IAAI,sBAAM,IAAI,kEAAQ,kBAAiB;EAC3C,SAAS,gBAAgB,IAAI,SAAS,UAAU;EACjD;AAED,KAAI,QAAQ,YACV,QAAO,OAAO,QAAQ,QAAQ,YAAY,IAAI,CAAC;AAGjD,QAAO;;;;;AAQT,SAAgB,wBACd,QACA,UAA6B,EAAE,EAC0C;CACzE,MAAM,EACJ,MACA,SACA,cACA,gBAAgB,cAChB,eAAe,SACf,gBAAgB,QAChB,aAAa,SACb,yBAAyB,QACvB;AAEJ,QAAO,SAAS,sBACd,KACA,KACA,MACM;;AACN,kDAAI,KAAO,IAAI,EAAE;AACf,SAAM;AACN;;EAGF,MAAM,2BAAW,IAAI,qEAAU,mBAAyC,SAAS;EACjF,MAAM,UAAU,KAAK,KAAK;EAC1B,MAAM,aAAa,gBAAgB,KAAK,SAAS,QAAQ;AAGzD,MAAI,iBAAiB,SACnB,CAAK,OAAO,SAAS,cAAc,mBAAmB;GACpD,GAAG;GACH,GAAI,WAAW,IAAI,OAAO,EAAE,MAAM,aAAa,IAAI,MAAM,aAAa,EAAE,GAAG,EAAE;GAC9E,CAAC;EAUJ,IAAI,YAAY;EAChB,MAAM,iBAAuB;AAC3B,OAAI,UAAW;AACf,eAAY;GAEZ,MAAM,WAAW,KAAK,KAAK,GAAG;GAC9B,MAAM,SAAS,IAAI,cAAc;GACjC,MAAM,QAAQ,UAAU,MAAM,aAAa;AAE3C,GAAK,OAAO,SAAS,OAAO,qBAAqB;IAC/C,GAAG;IACH,YAAY;IACZ;IACD,CAAC;AAEF,OAAI,WAAW,uBACb,CAAK,OAAO,KAAK,yBAAyB;IACxC,GAAG;IACH,YAAY;IACZ;IACA,WAAW;IACZ,CAAC;;AAIN,mBAAI,8DAAO,UAAU,SAAS;AAG9B,oBAAI,gEAAO,SAAS,SAAS;AAE7B,QAAM;;;;;;;;;;;AAkBV,SAAgB,oBAAoB,QAAqB,UAA6B,EAAE,EAAE;CACxF,MAAM,EACJ,MACA,gBAAgB,cAChB,eAAe,SACf,gBAAgB,QAChB,aAAa,SACb,yBAAyB,QACvB;CAEJ,SAAS,qBAAqB,SAA0B,OAAgB,MAAwB;AAC9F,UAAQ,QAAQ,cAAc,SAAkB,QAAiB,aAAyB;;GACxF,MAAM,MAAM;AACZ,mDAAI,KAAO,IAAI,EAAE;AACf,cAAU;AACV;;GAGF,MAAM,4BAAW,IAAI,uEAAU,mBAAyC,SAAS;AACjF,OAAI,gBAAgB,KAAK,KAAK;AAC9B,OAAI,aAAa;AAEjB,OAAI,iBAAiB,SACnB,CAAK,OAAO,SACV,cACA,mBACA,gBAAgB,KAAK,SAAS,QAAQ,CACvC;AAEH,aAAU;IACV;AAEF,UAAQ,QAAQ,eAAe,SAAkB,OAAgB,aAAyB;GACxF,MAAM,MAAM;AACZ,OAAI,IAAI,kBAAkB,QAAW;AACnC,cAAU;AACV;;GAGF,MAAM,MAAM;GACZ,MAAM,WAAW,KAAK,KAAK,GAAG,IAAI;GAClC,MAAM,SAAS,IAAI,cAAc;GACjC,MAAM,UAAU,IAAI,cAAc,SAAS;GAC3C,MAAM,QAAQ,UAAU,MAAM,aAAa;AAE3C,GAAK,OAAO,SAAS,OAAO,qBAAqB;IAC/C,GAAG,gBAAgB,KAAK,SAAS,QAAQ;IACzC,YAAY;IACZ;IACD,CAAC;AAEF,OAAI,WAAW,uBACb,CAAK,OAAO,KAAK,yBAAyB;IACxC;IACA,KAAK,IAAI;IACT,QAAQ,IAAI;IACZ;IACA,WAAW;IACZ,CAAC;AAGJ,aAAU;IACV;AAEF,QAAM;;AAGR,QAAO,OAAO,OAAO,sBAAsB;GACxC,OAAO,IAAI,gBAAgB,GAAG;GAC9B,OAAO,IAAI,uBAAuB,GAAG;EACvC,CAAC;;AAKJ,SAAS,aAAa,MAAe,WAAW,MAAe;AAC7D,KAAI,OAAO,SAAS,SAClB,QAAO,KAAK,SAAS,WAAW,KAAK,MAAM,GAAG,SAAS,GAAG,iBAAiB;AAE7E,KAAI,QAAQ,OAAO,SAAS,UAAU;EACpC,MAAM,MAAM,gBAAgB,KAAK;AACjC,MAAI,IAAI,SAAS,SACf,QAAO,IAAI,MAAM,GAAG,SAAS,GAAG;;AAGpC,QAAO"}
+{"version":3,"file":"middleware.mjs","names":["out: Record<string, unknown>","fields: Record<string, unknown>","items: unknown[]","json: unknown","record: Record<string, unknown>"],"sources":["../src/middleware/http-logger.ts"],"sourcesContent":["/**\n * HTTP request/response logging middleware — Morgan replacement.\n *\n * Fixes every documented Morgan bug:\n *  - statusCode always captured correctly, even for requests > 20 s\n *  - Logs request START (with traceId) and response FINISH (with duration)\n *  - Captures errors before and after response\n *  - Auto-redacts Authorization / Cookie / Set-Cookie headers\n *  - Slow-request warnings\n *  - Skip predicates for health-check routes / static assets\n *\n * @example Express\n * ```ts\n * import { createExpressMiddleware } from 'logixia/middleware';\n * app.use(createExpressMiddleware(logger));\n * ```\n *\n * @example Fastify\n * ```ts\n * import { createFastifyPlugin } from 'logixia/middleware';\n * await fastify.register(createFastifyPlugin(logger));\n * ```\n */\n\nimport type { IBaseLogger } from '../types';\nimport { internalError } from '../utils/internal-log';\nimport { stringifyForLog } from '../utils/safe-stringify';\nimport { sanitizeIncomingId } from '../utils/trace.utils';\n\n// ── Shared types ─────────────────────────────────────────────────────────────\n\nexport interface HttpLoggerOptions {\n  /**\n   * Skip logging for a request. Called before any I/O.\n   * @example `skip: (req) => req.url === '/health'`\n   */\n  skip?: (req: IncomingRequest) => boolean;\n  /**\n   * Log request body (POST/PUT/PATCH). Capped at `bodyMaxBytes` (default: 4096).\n   * Redaction still applies to the captured body.\n   * Default: false.\n   */\n  logBody?: boolean;\n  /** Max bytes of body to capture. Default: 4096. */\n  bodyMaxBytes?: number;\n  /**\n   * Emit a WARN log when a request duration exceeds this threshold (ms).\n   * Default: 1000.\n   */\n  slowRequestThresholdMs?: number;\n  /**\n   * Additional fields to include in every log entry.\n   * @example `extraFields: (req) => ({ tenantId: req.headers['x-tenant-id'] })`\n   */\n  extraFields?: (req: IncomingRequest) => Record<string, unknown>;\n  /**\n   * Trace ID header. Default: 'x-trace-id'.\n   * If the header is absent, a short random ID is generated.\n   */\n  traceIdHeader?: string;\n  /**\n   * Additional headers to redact from logged output. Merged with the defaults\n   * (authorization, cookie, set-cookie, x-api-key, proxy-authorization,\n   * x-auth-token, x-access-token, x-csrf-token, x-amz-security-token).\n   */\n  redactHeaders?: string[];\n  /**\n   * Additional query-string parameter names whose values are redacted from the\n   * logged URL. Merged with the defaults (token, access_token, refresh_token,\n   * code, password, secret, api_key, apikey, key, signature, sig, auth).\n   */\n  redactQueryParams?: string[];\n  /**\n   * Log level for request-start entries. Default: 'debug'.\n   * Set to 'silent' to suppress request-start logs entirely.\n   */\n  requestLevel?: string;\n  /** Log level for successful response entries. Default: 'info'. */\n  responseLevel?: string;\n  /** Log level for error responses (status ≥ 500). Default: 'error'. */\n  errorLevel?: string;\n}\n\n// Minimal structural types so we don't need @types/express / fastify in core\nexport interface IncomingRequest {\n  method?: string;\n  url?: string;\n  headers?: Record<string, string | string[] | undefined>;\n  body?: unknown;\n  socket?: { remoteAddress?: string };\n  ip?: string;\n}\n\nexport interface OutgoingResponse {\n  statusCode?: number;\n  on?: (event: string, cb: () => void) => void;\n  once?: (event: string, cb: () => void) => void;\n  getHeader?: (name: string) => string | number | string[] | undefined;\n}\n\n// ── Helpers ───────────────────────────────────────────────────────────────────\n\nconst DEFAULT_REDACT_HEADERS = [\n  'authorization',\n  'cookie',\n  'set-cookie',\n  'x-api-key',\n  'proxy-authorization',\n  'x-auth-token',\n  'x-access-token',\n  'x-csrf-token',\n  'x-amz-security-token',\n];\n\nconst DEFAULT_REDACT_QUERY_PARAMS = [\n  'token',\n  'access_token',\n  'refresh_token',\n  'code',\n  'password',\n  'secret',\n  'api_key',\n  'apikey',\n  'key',\n  'signature',\n  'sig',\n  'auth',\n];\n\nfunction buildNameSet(defaults: readonly string[], extra: readonly string[] | undefined) {\n  return new Set([...defaults, ...(extra ?? [])].map((n) => n.toLowerCase()));\n}\n\nfunction safeDecode(value: string): string {\n  try {\n    return decodeURIComponent(value.replace(/\\+/g, ' '));\n  } catch {\n    return value;\n  }\n}\n\n/** Replace the values of sensitive query parameters, leaving the rest verbatim. */\nfunction sanitizeUrl(url: string, redactParams: Set<string>): string {\n  const q = url.indexOf('?');\n  if (q === -1) return url;\n  const hashAt = url.indexOf('#', q);\n  const query = url.slice(q + 1, hashAt === -1 ? undefined : hashAt);\n  const hash = hashAt === -1 ? '' : url.slice(hashAt);\n  const cleaned = query\n    .split('&')\n    .map((pair) => {\n      const eq = pair.indexOf('=');\n      const rawKey = eq === -1 ? pair : pair.slice(0, eq);\n      const decoded = safeDecode(rawKey);\n      const bracket = decoded.indexOf('[');\n      const name = (bracket === -1 ? decoded : decoded.slice(0, bracket)).toLowerCase();\n      return redactParams.has(name) && eq !== -1 ? `${rawKey}=[REDACTED]` : pair;\n    })\n    .join('&');\n  return `${url.slice(0, q)}?${cleaned}${hash}`;\n}\n\nfunction sanitizeHeaders(\n  headers: Record<string, string | string[] | undefined> | undefined,\n  redactSet: Set<string>\n): Record<string, unknown> {\n  if (!headers) return {};\n  const out: Record<string, unknown> = {};\n  for (const [k, v] of Object.entries(headers)) {\n    if (k === '__proto__' || k === 'constructor' || k === 'prototype') continue;\n    out[k] = redactSet.has(k.toLowerCase()) ? '[REDACTED]' : v;\n  }\n  return out;\n}\n\n/** Fire-and-forget a logger call; a failing log must never become an unhandled rejection. */\nfunction fire(result: unknown): void {\n  if (result && typeof (result as Promise<unknown>).catch === 'function') {\n    (result as Promise<unknown>).catch((error: unknown) =>\n      internalError('http-logger: log call failed', error)\n    );\n  }\n}\n\nfunction shortId(): string {\n  // eslint-disable-next-line sonarjs/pseudo-random -- non-security request ID\n  return Math.random().toString(36).slice(2, 10);\n}\n\ninterface NameSets {\n  headers: Set<string>;\n  queryParams: Set<string>;\n}\n\nfunction resolveNameSets(options: HttpLoggerOptions): NameSets {\n  return {\n    headers: buildNameSet(DEFAULT_REDACT_HEADERS, options.redactHeaders),\n    queryParams: buildNameSet(DEFAULT_REDACT_QUERY_PARAMS, options.redactQueryParams),\n  };\n}\n\nfunction buildBaseFields(\n  req: IncomingRequest,\n  traceId: string,\n  options: HttpLoggerOptions,\n  { headers: redactSet, queryParams: paramSet }: NameSets\n): Record<string, unknown> {\n  const fields: Record<string, unknown> = {\n    traceId,\n    method: req.method?.toUpperCase() ?? 'UNKNOWN',\n    url: sanitizeUrl(req.url ?? '/', paramSet),\n    ip: req.ip ?? req.socket?.remoteAddress ?? 'unknown',\n    headers: sanitizeHeaders(req.headers, redactSet),\n  };\n\n  if (options.extraFields) {\n    Object.assign(fields, options.extraFields(req));\n  }\n\n  return fields;\n}\n\n// ── Express middleware ────────────────────────────────────────────────────────\n\n/**\n * Create an Express / Connect compatible middleware that replaces Morgan.\n */\nexport function createExpressMiddleware(\n  logger: IBaseLogger,\n  options: HttpLoggerOptions = {}\n): (req: IncomingRequest, res: OutgoingResponse, next: () => void) => void {\n  const {\n    skip,\n    logBody,\n    bodyMaxBytes,\n    traceIdHeader = 'x-trace-id',\n    requestLevel = 'debug',\n    responseLevel = 'info',\n    errorLevel = 'error',\n    slowRequestThresholdMs = 1000,\n  } = options;\n  const nameSets = resolveNameSets(options);\n  const traceHeaderName = traceIdHeader.toLowerCase();\n\n  return function logixiaHttpMiddleware(\n    req: IncomingRequest,\n    res: OutgoingResponse,\n    next: () => void\n  ): void {\n    if (skip?.(req)) {\n      next();\n      return;\n    }\n\n    const traceId = sanitizeIncomingId(req.headers?.[traceHeaderName]) ?? shortId();\n    const startMs = Date.now();\n    const baseFields = buildBaseFields(req, traceId, options, nameSets);\n\n    // Log request start\n    if (requestLevel !== 'silent') {\n      fire(\n        logger.logLevel(requestLevel, 'request started', {\n          ...baseFields,\n          ...(logBody && req.body ? { body: truncateBody(req.body, bodyMaxBytes) } : {}),\n        })\n      );\n    }\n\n    // Hook into the response 'finish' event — fires after headers + body are sent.\n    // This is what Morgan gets wrong for slow requests (it uses 'close' which may\n    // fire before the status code is set on some Node versions).\n    //\n    // BOTH 'finish' and 'close' fire on a normal response, so guard against\n    // logging the completion twice (which would duplicate the completed entry and\n    // the slow-request warning).\n    let completed = false;\n    const onFinish = (): void => {\n      if (completed) return;\n      completed = true;\n\n      const duration = Date.now() - startMs;\n      const status = res.statusCode ?? 0;\n      const level = status >= 500 ? errorLevel : responseLevel;\n\n      fire(\n        logger.logLevel(level, 'request completed', {\n          ...baseFields,\n          statusCode: status,\n          duration,\n        })\n      );\n\n      if (duration > slowRequestThresholdMs) {\n        fire(\n          logger.warn('slow request detected', {\n            ...baseFields,\n            statusCode: status,\n            duration,\n            threshold: slowRequestThresholdMs,\n          })\n        );\n      }\n    };\n\n    res.once?.('finish', onFinish);\n    // Fallback: also covers a client that disconnects before 'finish' fires. The\n    // `completed` guard ensures a normal finish+close pair logs only once.\n    res.once?.('close', onFinish);\n\n    next();\n  };\n}\n\n// ── Fastify plugin ─────────────────────────────────────────────────────────────\n\nexport interface FastifyInstance {\n  addHook: (name: string, fn: (req: unknown, reply: unknown, done: () => void) => void) => void;\n}\n\n/**\n * Create a Fastify plugin (a function you pass to `fastify.register()`).\n *\n * @example\n * ```ts\n * await fastify.register(createFastifyPlugin(logger, { slowRequestThresholdMs: 500 }));\n * ```\n */\nexport function createFastifyPlugin(logger: IBaseLogger, options: HttpLoggerOptions = {}) {\n  const {\n    skip,\n    traceIdHeader = 'x-trace-id',\n    requestLevel = 'debug',\n    responseLevel = 'info',\n    errorLevel = 'error',\n    slowRequestThresholdMs = 1000,\n  } = options;\n  const nameSets = resolveNameSets(options);\n  const traceHeaderName = traceIdHeader.toLowerCase();\n\n  function logixiaFastifyPlugin(fastify: FastifyInstance, _opts: unknown, done: () => void): void {\n    fastify.addHook('onRequest', (request: unknown, _reply: unknown, hookDone: () => void) => {\n      const req = request as IncomingRequest & { _logixiaStart?: number; _logixiaId?: string };\n      if (skip?.(req)) {\n        hookDone();\n        return;\n      }\n\n      const traceId = sanitizeIncomingId(req.headers?.[traceHeaderName]) ?? shortId();\n      req._logixiaStart = Date.now();\n      req._logixiaId = traceId;\n\n      if (requestLevel !== 'silent') {\n        fire(\n          logger.logLevel(\n            requestLevel,\n            'request started',\n            buildBaseFields(req, traceId, options, nameSets)\n          )\n        );\n      }\n      hookDone();\n    });\n\n    fastify.addHook('onResponse', (request: unknown, reply: unknown, hookDone: () => void) => {\n      const req = request as IncomingRequest & { _logixiaStart?: number; _logixiaId?: string };\n      if (req._logixiaStart === undefined) {\n        hookDone();\n        return;\n      }\n\n      const rep = reply as { statusCode?: number };\n      const duration = Date.now() - req._logixiaStart;\n      const status = rep.statusCode ?? 0;\n      const traceId = req._logixiaId ?? shortId();\n      const level = status >= 500 ? errorLevel : responseLevel;\n      const baseFields = buildBaseFields(req, traceId, options, nameSets);\n\n      fire(\n        logger.logLevel(level, 'request completed', {\n          ...baseFields,\n          statusCode: status,\n          duration,\n        })\n      );\n\n      if (duration > slowRequestThresholdMs) {\n        fire(\n          logger.warn('slow request detected', {\n            traceId,\n            url: baseFields.url,\n            method: req.method,\n            duration,\n            threshold: slowRequestThresholdMs,\n          })\n        );\n      }\n\n      hookDone();\n    });\n\n    done();\n  }\n\n  return Object.assign(logixiaFastifyPlugin, {\n    [Symbol.for('skip-override')]: true,\n    [Symbol.for('fastify.display-name')]: 'logixia',\n  });\n}\n\n// ── Internal helpers ──────────────────────────────────────────────────────────\n\n/**\n * Bound the captured body without turning it into a string, so the logger's\n * path-based redaction still sees the original keys. Oversized structures are\n * pruned (extra keys/items dropped, long strings cut) rather than serialized.\n */\nfunction truncateBody(body: unknown, maxBytes = 4096): unknown {\n  if (typeof body === 'string') {\n    return body.length > maxBytes ? body.slice(0, maxBytes) + '…[truncated]' : body;\n  }\n  if (body && typeof body === 'object') {\n    const str = stringifyForLog(body);\n    if (str.length <= maxBytes) return body;\n    return pruneValue(body, { left: maxBytes }, 0, new Set());\n  }\n  return body;\n}\n\nconst TRUNCATED = '…[truncated]';\nconst MAX_PRUNE_DEPTH = 8;\n\nfunction pruneValue(\n  value: unknown,\n  budget: { left: number },\n  depth: number,\n  ancestors: Set<object>\n): unknown {\n  if (typeof value === 'string') {\n    const cut = value.slice(0, Math.max(0, budget.left));\n    budget.left -= cut.length;\n    return cut.length < value.length ? cut + TRUNCATED : cut;\n  }\n  if (value === null || typeof value !== 'object') {\n    budget.left -= 8;\n    return value;\n  }\n  if (value instanceof Date) {\n    budget.left -= 24;\n    return Number.isNaN(value.getTime()) ? 'Invalid Date' : value.toISOString();\n  }\n  if (value instanceof ArrayBuffer || ArrayBuffer.isView(value)) {\n    budget.left -= 16;\n    return `[Buffer ${value.byteLength} bytes]`;\n  }\n  if (value instanceof Error) return value;\n  if (ancestors.has(value) || depth >= MAX_PRUNE_DEPTH) return TRUNCATED;\n  ancestors.add(value);\n  try {\n    if (Array.isArray(value) || value instanceof Set || value instanceof Map) {\n      const items: unknown[] = [];\n      for (const item of value instanceof Map ? value.entries() : value) {\n        if (budget.left <= 0) {\n          items.push(TRUNCATED);\n          break;\n        }\n        items.push(pruneValue(item, budget, depth + 1, ancestors));\n      }\n      return items;\n    }\n    const toJSON = (value as { toJSON?: unknown }).toJSON;\n    if (typeof toJSON === 'function') {\n      const json: unknown = toJSON.call(value);\n      if (json !== value) return pruneValue(json, budget, depth + 1, ancestors);\n    }\n    const record: Record<string, unknown> = {};\n    for (const [k, v] of Object.entries(value)) {\n      if (k === '__proto__' || k === 'constructor' || k === 'prototype') continue;\n      if (budget.left <= 0) {\n        record['…'] = TRUNCATED;\n        break;\n      }\n      budget.left -= k.length;\n      record[k] = pruneValue(v, budget, depth + 1, ancestors);\n    }\n    return record;\n  } catch {\n    return TRUNCATED;\n  } finally {\n    ancestors.delete(value);\n  }\n}\n"],"mappings":"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"}

package/dist/nest.d.mts

@@ -1,11 +1,478 @@
-import "./transport.types-B5vcyv2k.mjs";
-import { E as TraceIdConfig } from "./index-BPKwwERo.mjs";
-import { a as LogixiaLoggerModule, c as KafkaTraceInterceptor, d as LogixiaServiceWithLevels, i as LogixiaAsyncOptions, l as LogixiaLoggerService, n as LOGIXIA_LOGGER_PREFIX, o as LogixiaOptionsFactory, s as WebSocketTraceInterceptor, t as LOGIXIA_LOGGER_CONFIG, u as LogixiaServiceWith } from "./logitron-logger.module-BdG1Jnpk.mjs";
-import { NestMiddleware } from "@nestjs/common";
+import "./transport.types-BMnurPcc.mjs";
+import { E as TraceIdConfig, v as LogLevelString, y as LoggerConfig } from "./index-3mw5gaCw.mjs";
+import { t as LogixiaLogger } from "./logitron-logger-BFDSO8Io.mjs";
+import * as _nestjs_common0 from "@nestjs/common";
+import { ArgumentsHost, CallHandler, ExceptionFilter, ExecutionContext, InjectionToken, LoggerService, MiddlewareConsumer, ModuleMetadata, NestInterceptor, NestMiddleware, NestModule, OptionalFactoryDependency, Type } from "@nestjs/common";
+import { Observable } from "rxjs";
 import { NextFunction, Request, Response } from "express";
 
-//#region src/core/trace.middleware.d.ts
+//#region src/core/logitron-nestjs.service.d.ts
 
+/**
+ * Level names that already have proper typed implementations on LogixiaLoggerService.
+ * These are excluded from the auto-generated method type so we don't produce
+ * duplicate / conflicting signatures.
+ */
+type _ServiceBuiltinLevels = 'error' | 'warn' | 'info' | 'debug' | 'verbose' | 'trace' | 'log' | 'logLevel';
+/**
+ * Mapped type that adds one method per *custom* level (i.e. every key in TLevels
+ * that is not already a built-in method on LogixiaLoggerService).
+ *
+ * @example
+ * ServiceCustomLevelMethods<{ kafka: 3; mysql: 4; payment: 5 }>
+ * // → { kafka(msg, data?): Promise<void>; mysql(...): …; payment(...): … }
+ */
+type ServiceCustomLevelMethods<TLevels extends Record<string, number>> = { readonly [K in keyof TLevels as K extends _ServiceBuiltinLevels ? never : K & string]: (message: string, data?: Record<string, unknown>) => Promise<void> };
+/**
+ * The return type of `LogixiaLoggerService.create<T>(config)`.
+ *
+ * When `T` carries `levelOptions.levels`, this type intersects
+ * `LogixiaLoggerService` with a method for every *custom* level so the IDE
+ * suggests `service.kafka(...)`, `service.payment(...)`, etc.
+ */
+type LogixiaServiceWithLevels<T extends LoggerConfig<Record<string, number>>> = T['levelOptions'] extends {
+  levels: infer L;
+} ? L extends Record<string, number> ? LogixiaLoggerService & ServiceCustomLevelMethods<L> : LogixiaLoggerService : LogixiaLoggerService;
+/**
+ * Helper — extracts custom level names from a config object's `levelOptions.levels`.
+ */
+type _ExtractCustomLevelNames<T> = T extends {
+  levelOptions?: {
+    levels?: infer L;
+  };
+} ? L extends Record<string, number> ? Exclude<keyof L & string, _ServiceBuiltinLevels> : never : never;
+/**
+ * Typed `LogixiaLoggerService` with autocomplete for custom levels.
+ *
+ * Accepts either:
+ *   - **string union** of custom level names: `LogixiaServiceWith<'kafka' | 'payment'>`
+ *   - **config object type** (via `typeof`): `LogixiaServiceWith<typeof logixiaConfig>`
+ *
+ * Define your config with `as const` once, derive the type everywhere:
+ *
+ * @example
+ * ```ts
+ * // logger.config.ts — define once
+ * export const logixiaConfig = {
+ *   levelOptions: {
+ *     levels: { error: 0, warn: 1, info: 2, debug: 3, verbose: 4, kafka: 5, payment: 6 },
+ *   },
+ * } as const;
+ * export type AppLogger = LogixiaServiceWith<typeof logixiaConfig>;
+ *
+ * // any.controller.ts — use everywhere, no casting
+ * constructor(private readonly logger: AppLogger) {}
+ * // this.logger.kafka('msg')  ← fully typed
+ * // this.logger.payment('msg') ← fully typed
+ * ```
+ *
+ * @example
+ * ```ts
+ * // Or use string union directly:
+ * type AppLogger = LogixiaServiceWith<'kafka' | 'payment'>;
+ * ```
+ */
+type LogixiaServiceWith<T extends string | Record<string, unknown>> = LogixiaLoggerService & { readonly [K in T extends string ? Exclude<T, _ServiceBuiltinLevels> : _ExtractCustomLevelNames<T>]: (message: string, data?: Record<string, unknown>) => Promise<void> };
+declare class LogixiaLoggerService implements LoggerService {
+  [K: string]: any;
+  private logger;
+  private context?;
+  private _mergedConfig;
+  constructor(config?: LoggerConfig);
+  private _createCustomLevelMethods;
+  /**
+   * NestJS `LoggerService.log` — void, string context.
+   * Maps internally to `info`.
+   *
+   * @example `logger.log('User signed up', 'AuthService')`
+   */
+  log(message: unknown, context?: string): void;
+  /**
+   * Native async `info` — structured data, returns `Promise<void>`.
+   *
+   * @example `await logger.info('User signed up', { userId: 'u_abc' })`
+   */
+  info(message: string, data?: Record<string, unknown>): Promise<void>;
+  /**
+   * Native async overload — structured metadata, returns `Promise<void>`.
+   *
+   * @example `await logger.error(new Error('DB timeout'), { requestId: 'req_abc' })`
+   * @example `await logger.error('Login failed', { userId: 'u_abc' })`
+   */
+  error(message: string | Error, data: Record<string, unknown>): Promise<void>;
+  /**
+   * NestJS compat overload — string trace + optional context, returns `void`.
+   *
+   * @example `logger.error('Something failed', err.stack, 'AuthService')`
+   */
+  error(message: unknown, trace?: string, context?: string): void;
+  /**
+   * Native async overload — structured metadata, returns `Promise<void>`.
+   *
+   * @example `await logger.warn('Rate limit approaching', { userId: 'u_abc', count: 90 })`
+   */
+  warn(message: string, data: Record<string, unknown>): Promise<void>;
+  /**
+   * NestJS compat overload — optional context string, returns `void`.
+   *
+   * @example `logger.warn('Deprecated API used', 'PaymentService')`
+   */
+  warn(message: unknown, context?: string): void;
+  /**
+   * Native async overload — structured metadata, returns `Promise<void>`.
+   *
+   * @example `await logger.debug('Cache miss', { key: 'user:abc', ttl: 300 })`
+   */
+  debug(message: string, data: Record<string, unknown>): Promise<void>;
+  /**
+   * NestJS compat overload — optional context string, returns `void`.
+   *
+   * @example `logger.debug('Processing request', 'OrderService')`
+   */
+  debug(message: unknown, context?: string): void;
+  /**
+   * Native async overload — structured metadata, returns `Promise<void>`.
+   * Maps to `trace` level internally.
+   *
+   * @example `await logger.verbose('Socket message received', { event: 'ping', size: 42 })`
+   */
+  verbose(message: string, data: Record<string, unknown>): Promise<void>;
+  /**
+   * NestJS compat overload — optional context string, returns `void`.
+   *
+   * @example `logger.verbose('Connection established', 'WebSocketGateway')`
+   */
+  verbose(message: unknown, context?: string): void;
+  /**
+   * Native async `trace` — lowest verbosity level, structured data.
+   */
+  trace(message: string, data?: Record<string, unknown>): Promise<void>;
+  /**
+   * Log at any named level with structured data.
+   */
+  logLevel(level: string, message: string, data?: Record<string, unknown>): Promise<void>;
+  time(label: string): void;
+  timeEnd(label: string): Promise<number | undefined>;
+  timeAsync<T>(label: string, fn: () => Promise<T>): Promise<T>;
+  setContext(context: string): void;
+  getContext(): string | undefined;
+  setLevel(level: LogLevelString): void;
+  getLevel(): LogLevelString;
+  child(context: string, data?: Record<string, unknown>): LogixiaLoggerService;
+  getCurrentTraceId(): string | undefined;
+  /** Returns the AsyncLocalStorage key currently used to store the trace ID. */
+  get traceContextKey(): string;
+  close(): Promise<void>;
+  static create<T extends LoggerConfig<Record<string, number>>>(config?: T): LogixiaServiceWithLevels<T>;
+  getLogger(): LogixiaLogger;
+  private setContextIfProvided;
+  private formatMessage;
+}
+//#endregion
+//#region src/core/kafka-trace.interceptor.d.ts
+/**
+ * Observable counters exposed for monitoring Kafka consumer trace hygiene.
+ *
+ * Usage:
+ *   import { KafkaTraceInterceptor } from 'logixia/nest';
+ *   setInterval(() => {
+ *     myMetrics.gauge('kafka.trace.dropped', KafkaTraceInterceptor.metrics.dropped);
+ *   }, 10_000);
+ */
+interface KafkaTraceMetrics {
+  /** Messages processed where a traceId was successfully resolved (body/header/ALS). */
+  accepted: number;
+  /** Messages handled without any traceId — `requireTraceId: false`. */
+  acceptedWithoutTrace: number;
+  /** Messages dropped because `requireTraceId: true` and no traceId was found. */
+  dropped: number;
+}
+declare class KafkaTraceInterceptor implements NestInterceptor {
+  private readonly config?;
+  private readonly requireTraceId;
+  /**
+   * Process-wide counters. Readable from anywhere — scrape into your metrics
+   * system (Prometheus, Datadog, CloudWatch) on an interval.
+   */
+  static readonly metrics: KafkaTraceMetrics;
+  /** Reset counters (tests). */
+  static resetMetrics(): void;
+  private readonly ctx;
+  /**
+   * @param config        - TraceIdConfig options (extractor keys, contextKey, etc.)
+   * @param requireTraceId - When true, messages with no traceId are silently skipped
+   *                         (EMPTY Observable — message is ack'd, consumer stays alive).
+   *                         A WARN is logged AND `KafkaTraceInterceptor.metrics.dropped`
+   *                         increments so the missing traceId is observable end-to-end.
+   *                         Default: false (handler runs without trace context).
+   */
+  constructor(config?: TraceIdConfig | undefined, requireTraceId?: boolean);
+  intercept(context: ExecutionContext, next: CallHandler): Observable<any>;
+}
+//#endregion
+//#region src/core/websocket-trace.interceptor.d.ts
+declare class WebSocketTraceInterceptor implements NestInterceptor {
+  private readonly config?;
+  private readonly ctx;
+  constructor(config?: TraceIdConfig | undefined);
+  intercept(context: ExecutionContext, next: CallHandler): Observable<any>;
+}
+//#endregion
+//#region src/core/logitron-logger.module.d.ts
+declare const LOGIXIA_LOGGER_CONFIG = "LOGIXIA_LOGGER_CONFIG";
+declare const LOGIXIA_TRACE_CONFIG = "TRACE_CONFIG";
+declare const LOGIXIA_LOGGER_PREFIX = "LOGIXIA_LOGGER_";
+interface LogixiaAsyncOptions extends Pick<ModuleMetadata, 'imports'> {
+  useExisting?: Type<LogixiaOptionsFactory>;
+  useClass?: Type<LogixiaOptionsFactory>;
+  useFactory?: (...args: unknown[]) => Promise<Partial<LoggerConfig>> | Partial<LoggerConfig>;
+  inject?: Array<InjectionToken | OptionalFactoryDependency>;
+}
+interface LogixiaOptionsFactory {
+  createLogixiaOptions(): Promise<Partial<LoggerConfig>> | Partial<LoggerConfig>;
+}
+/**
+ * Logixia Logger Module for NestJS dependency injection
+ */
+declare class LogixiaLoggerModule implements NestModule {
+  private config;
+  private static loggerConfig;
+  /**
+   * @internal Backing field for the global logger. Do not read or write
+   * directly — use {@link getGlobalLogger} / {@link _setGlobalLogger} which
+   * enforce single-init semantics.
+   */
+  static _globalLogger: LogixiaLoggerService | null;
+  /**
+   * @internal Set the global logger exactly once.
+   *
+   * Called from the module's forRoot / forRootAsync factory. If the module is
+   * initialised more than once in the same process (nested DI context, test
+   * harness creating multiple apps, hot reload, etc.) a warning is written to
+   * stderr and the first logger wins — silently overwriting would allow the
+   * newer instance's transport config to replace the live one while the old
+   * one is still being used by registered shutdown hooks, decorators, etc.
+   *
+   * Use {@link _resetGlobalLogger} in tests to reset between runs.
+   */
+  static _setGlobalLogger(service: LogixiaLoggerService): void;
+  /** @internal Clear the global logger. Tests only. */
+  static _resetGlobalLogger(): void;
+  /**
+   * Returns the global LogixiaLoggerService instance that was created when the
+   * module booted. Useful for logging outside of NestJS DI — utility functions,
+   * plain scripts, decorators — without injecting the service everywhere.
+   *
+   * Returns `null` if called before `LogixiaLoggerModule.forRoot[Async]()` has
+   * been initialised (i.e. before the NestJS app has started).
+   *
+   * @example
+   * ```ts
+   * // some-util.ts
+   * import { LogixiaLoggerModule } from 'logixia/nest';
+   *
+   * export function doSomething() {
+   *   LogixiaLoggerModule.getGlobalLogger()?.info('doing something');
+   * }
+   * ```
+   */
+  static getGlobalLogger(): LogixiaLoggerService | null;
+  configure(consumer: MiddlewareConsumer): void;
+  /**
+   * Configure the module with synchronous options
+   */
+  static forRoot(config?: Partial<LoggerConfig>): {
+    module: typeof LogixiaLoggerModule;
+    providers: ({
+      provide: string;
+      useValue: Partial<LoggerConfig<Record<string, number>>>;
+      useFactory?: never;
+      inject?: never;
+    } | {
+      provide: string;
+      useValue: TraceIdConfig;
+      useFactory?: never;
+      inject?: never;
+    } | {
+      provide: typeof LogixiaLoggerService;
+      useFactory: (loggerConfig: Partial<LoggerConfig>) => LogixiaLoggerService;
+      inject: string[];
+      useValue?: never;
+    } | {
+      provide: typeof KafkaTraceInterceptor;
+      useFactory: (traceConfig: TraceIdConfig | undefined) => KafkaTraceInterceptor;
+      inject: string[];
+      useValue?: never;
+    } | {
+      provide: typeof WebSocketTraceInterceptor;
+      useFactory: (traceConfig: TraceIdConfig | undefined) => WebSocketTraceInterceptor;
+      inject: string[];
+      useValue?: never;
+    })[];
+    exports: (string | typeof LogixiaLoggerService | typeof KafkaTraceInterceptor | typeof WebSocketTraceInterceptor)[];
+    global: boolean;
+  };
+  /**
+   * Configure the module with asynchronous options
+   */
+  static forRootAsync(options: LogixiaAsyncOptions): {
+    module: typeof LogixiaLoggerModule;
+    imports: (Type<any> | _nestjs_common0.DynamicModule | Promise<_nestjs_common0.DynamicModule> | _nestjs_common0.ForwardReference<any>)[];
+    providers: ({
+      provide: string;
+      useFactory: (...args: unknown[]) => Promise<Partial<LoggerConfig>> | Partial<LoggerConfig>;
+      inject: (InjectionToken | OptionalFactoryDependency)[];
+    } | {
+      provide: string;
+      useFactory: (optionsFactory: LogixiaOptionsFactory) => Promise<Partial<LoggerConfig<Record<string, number>>>>;
+      inject: Type<LogixiaOptionsFactory>[];
+    } | {
+      provide: Type<LogixiaOptionsFactory>;
+      useClass: Type<LogixiaOptionsFactory>;
+    } | {
+      provide: string;
+      useFactory: (loggerConfig: Partial<LoggerConfig>) => TraceIdConfig;
+      inject: string[];
+    } | {
+      provide: typeof LogixiaLoggerService;
+      useFactory: (loggerConfig: Partial<LoggerConfig>) => LogixiaLoggerService;
+      inject: string[];
+    } | {
+      provide: typeof KafkaTraceInterceptor;
+      useFactory: (traceConfig: TraceIdConfig | undefined) => KafkaTraceInterceptor;
+      inject: string[];
+    } | {
+      provide: typeof WebSocketTraceInterceptor;
+      useFactory: (traceConfig: TraceIdConfig | undefined) => WebSocketTraceInterceptor;
+      inject: string[];
+    })[];
+    exports: (string | typeof LogixiaLoggerService | typeof KafkaTraceInterceptor | typeof WebSocketTraceInterceptor)[];
+    global: boolean;
+  };
+  /**
+   * Create feature-specific logger instances
+   */
+  static forFeature(context: string): {
+    module: typeof LogixiaLoggerModule;
+    providers: {
+      provide: string;
+      useFactory: (baseLogger: LogixiaLoggerService) => LogixiaLoggerService;
+      inject: (typeof LogixiaLoggerService)[];
+    }[];
+    exports: string[];
+  };
+  private static createAsyncProviders;
+  private static createAsyncOptionsProvider;
+}
+//#endregion
+//#region src/core/nestjs-extras.d.ts
+/**
+ * Inject the Logixia logger registered in the current NestJS DI container.
+ *
+ * Equivalent to `@Inject(LOGIXIA_LOGGER_TOKEN)` but without needing to import
+ * the internal token constant yourself.
+ *
+ * @example
+ * ```ts
+ * constructor(@InjectLogger() private readonly logger: LogixiaLoggerService) {}
+ * ```
+ */
+declare const InjectLogger: () => ParameterDecorator;
+interface LogMethodOptions {
+  /**
+   * Log level to use for entry / exit messages.
+   * @default 'debug'
+   */
+  level?: LogLevelString;
+  /**
+   * Whether to log the arguments passed to the method.
+   * Disable for high-throughput hot paths.
+   * @default true
+   */
+  logArgs?: boolean;
+  /**
+   * Whether to log the return value of the method.
+   * @default false
+   */
+  logResult?: boolean;
+  /**
+   * Whether to log error stack traces for thrown errors.
+   * @default true
+   */
+  logErrors?: boolean;
+  /**
+   * Custom label used in log messages instead of the auto-detected class.method name.
+   */
+  label?: string;
+}
+/**
+ * Method decorator that auto-logs entry, exit, duration, and errors.
+ *
+ * Preserves the original method's sync/async contract: a synchronous method
+ * stays synchronous (returns its value directly, with logs emitted
+ * fire-and-forget), and an async method is awaited so exit/error logs reflect
+ * the resolved result. Attaches to the logger found on the class instance via a
+ * `logger` property (the conventional NestJS name).
+ *
+ * @example
+ * ```ts
+ * @LogMethod({ level: 'info', logArgs: true })
+ * async processPayment(orderId: string): Promise<void> { … }
+ * ```
+ */
+declare function LogMethod(options?: LogMethodOptions): MethodDecorator;
+/**
+ * Global NestJS exception filter that converts any exception into the standard
+ * `LogixiaErrorResponse` wire format and logs it with full request context.
+ *
+ * Handles three exception types in priority order:
+ *  1. `LogixiaException`     — typed fields used directly
+ *  2. NestJS `HttpException` — status + message extracted
+ *  3. Unknown / plain Error  — falls back to 500 `server_error`
+ *
+ * **Debug block (off by default):**
+ * Responses never include the `debug` block (stack trace, service, duration)
+ * unless `exposeDebug: true` is passed in the filter options. The underlying
+ * `cause` is only added when `exposeCause: true` is also set. Enable explicitly
+ * for local development only, e.g.
+ * `new LogixiaExceptionFilter(logger, undefined, { exposeDebug: process.env.NODE_ENV === 'development' })`.
+ *
+ * **Trace ID headers:**
+ * `X-Trace-ID` and `X-Request-ID` are echoed back on every error response so
+ * clients can correlate with server logs.
+ *
+ * **Retry-After header:**
+ * Automatically added for `429` responses (`Retry-After: 60`).
+ *
+ * Register in `main.ts`:
+ * ```ts
+ * const logger = app.get(LogixiaLoggerService);
+ * app.useGlobalFilters(new LogixiaExceptionFilter(logger));
+ * ```
+ */
+interface LogixiaExceptionFilterOptions {
+  /**
+   * Include the `debug` block (stack trace, service, duration) in error responses.
+   * @default false
+   */
+  exposeDebug?: boolean;
+  /**
+   * Include `debug.cause` as well. Requires `exposeDebug`.
+   * @default false
+   */
+  exposeCause?: boolean;
+}
+/** Injection token for {@link LogixiaExceptionFilterOptions}. */
+declare const LOGIXIA_EXCEPTION_FILTER_OPTIONS = "LOGIXIA_EXCEPTION_FILTER_OPTIONS";
+declare class LogixiaExceptionFilter implements ExceptionFilter {
+  private readonly _logger;
+  private readonly _traceConfig;
+  private readonly _options;
+  constructor(logger?: LogixiaLoggerService, loggerConfig?: Partial<LoggerConfig>, options?: LogixiaExceptionFilterOptions);
+  catch(exception: unknown, host: ArgumentsHost): void;
+}
+//#endregion
+//#region src/core/trace.middleware.d.ts
 declare global {
   namespace Express {
     interface Request {
@@ -20,5 +487,13 @@ declare class TraceMiddleware implements NestMiddleware {
   use(req: Request, res: Response, next: NextFunction): void;
 }
 //#endregion
-export { KafkaTraceInterceptor, LOGIXIA_LOGGER_CONFIG, LOGIXIA_LOGGER_PREFIX, type LogixiaAsyncOptions, LogixiaLoggerModule, LogixiaLoggerService, type LogixiaOptionsFactory, type LogixiaServiceWith, type LogixiaServiceWithLevels, TraceMiddleware, WebSocketTraceInterceptor };
+//#region src/nest.d.ts
+/**
+ * Create a new Logixia logger service for NestJS
+ * @param config - Logger configuration
+ * @returns LogixiaLoggerService instance
+ */
+declare function createLoggerService(config?: Partial<LoggerConfig>): LogixiaLoggerService;
+//#endregion
+export { InjectLogger, KafkaTraceInterceptor, LOGIXIA_EXCEPTION_FILTER_OPTIONS, LOGIXIA_LOGGER_CONFIG, LOGIXIA_LOGGER_PREFIX, LOGIXIA_TRACE_CONFIG, LogMethod, type LogMethodOptions, LogixiaAsyncOptions, LogixiaExceptionFilter, type LogixiaExceptionFilterOptions, LogixiaLoggerModule, LogixiaLoggerService, LogixiaOptionsFactory, LogixiaServiceWith, LogixiaServiceWithLevels, TraceMiddleware, WebSocketTraceInterceptor, createLoggerService };
 //# sourceMappingURL=nest.d.mts.map

package/dist/nest.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"nest.d.mts","names":[],"sources":["../src/core/trace.middleware.ts"],"sourcesContent":[],"mappings":";;;;;;;;QAmFyB,MAAA,CAAA;EAAgB,UAAA,OAAA,CAAA;IAxBD,UAAA,OAAA,CAAA;MAAc,OAAA,CAAA,EAAA,MAAA;;;;cAAzC,eAAA,YAA2B;;;uBAGY;WAqBzC,cAAc,gBAAgB"}
+{"version":3,"file":"nest.d.mts","names":[],"sources":["../src/core/logitron-nestjs.service.ts","../src/core/kafka-trace.interceptor.ts","../src/core/websocket-trace.interceptor.ts","../src/core/logitron-logger.module.ts","../src/core/nestjs-extras.ts","../src/core/trace.middleware.ts","../src/nest.ts"],"sourcesContent":[],"mappings":"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"}