logixia 1.13.0 → 2.0.0

package/dist/slack.transport-Bzw7sucI.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"slack.transport-Bzw7sucI.mjs","names":["LEVEL_RANK: Record<string, number>","url: URL","opts: WebhookQueueOptions<T>","rendered: T[]","body: string","retryAfterMs: number | undefined","DISCORD_LEVEL_COLORS: Record<string, number>","out: DiscordEmbed","payload: Record<string, unknown>","fields: DiscordEmbedField[]","embed: DiscordEmbed","LEVEL_EMOJI: Record<string, string>","payload: Record<string, unknown>","blocks: unknown[]"],"sources":["../src/transports/webhook-queue.ts","../src/transports/discord.transport.ts","../src/transports/slack.transport.ts"],"sourcesContent":["/**\n * Shared core for the chat-webhook transports (Slack, Discord).\n *\n * - entries inside `minIntervalMs` are batched into one message; entries past\n *   `maxPerMessage` are dropped and reported to the payload builder as overflow\n * - the queue is bounded (BufferCap); the oldest entries go first\n * - HTTP 429 waits for Retry-After (bounded, cancelled by close()) and retries a\n *   bounded number of times\n * - an entry that cannot be rendered is dropped alone; an unserializable batch or a\n *   missing global fetch is dropped, never retried\n * - errors only ever name the webhook host, never the URL (the URL is a secret)\n */\n\nimport type { TransportLogEntry } from '../types/transport.types';\nimport { internalError, internalWarn } from '../utils/internal-log';\nimport { HttpError, isPermanentHttpError } from './batch-buffer';\nimport { BufferCap } from './buffer-cap';\n\nconst MAX_BACKOFF_MS = 30_000;\nconst DEFAULT_QUEUE_CAP = 1000;\nconst CLOSE_TIMEOUT_MS = 3000;\nconst OVERFLOW_WARN_MS = 5000;\nexport const DEFAULT_WEBHOOK_TIMEOUT_MS = 10_000;\nconst ZWSP = '​';\n\nconst LEVEL_RANK: Record<string, number> = {\n  fatal: 0,\n  error: 1,\n  warn: 2,\n  warning: 2,\n  info: 3,\n  debug: 4,\n  verbose: 5,\n  trace: 6,\n};\n\nexport function resolveMinLevel(level: string | undefined, label: string): string {\n  const resolved = (level ?? 'error').toLowerCase();\n  if (!(resolved in LEVEL_RANK)) {\n    throw new TypeError(`${label}: unknown level \"${String(level).slice(0, 40)}\"`);\n  }\n  return resolved;\n}\n\n/** Unknown (custom) entry levels pass, like the TransportManager does. */\nexport function meetsLevel(entryLevel: string, minLevel: string): boolean {\n  const entryRank = LEVEL_RANK[entryLevel.toLowerCase()];\n  return entryRank === undefined || entryRank <= (LEVEL_RANK[minLevel] ?? 1);\n}\n\nexport interface WebhookUrlRules {\n  label: string;\n  hostMatches: (host: string) => boolean;\n  pathMatches: (path: string) => boolean;\n  expected: string;\n  allowCustomUrl: boolean | undefined;\n}\n\n/** Validates the secret URL. Error messages never contain it. */\nexport function parseWebhookUrl(raw: unknown, rules: WebhookUrlRules): URL {\n  const { label, allowCustomUrl, hostMatches, pathMatches, expected } = rules;\n  if (typeof raw !== 'string' || raw.length === 0) {\n    throw new TypeError(`${label}: webhookUrl is required`);\n  }\n  let url: URL;\n  try {\n    url = new URL(raw);\n  } catch {\n    throw new TypeError(`${label}: webhookUrl is not a valid URL`);\n  }\n  if (url.protocol !== 'https:') {\n    throw new TypeError(`${label}: webhookUrl must use https:`);\n  }\n  if (url.username || url.password) {\n    throw new TypeError(`${label}: webhookUrl must not contain credentials`);\n  }\n  if (!allowCustomUrl) {\n    const host = url.hostname.toLowerCase();\n    if (!hostMatches(host) || !pathMatches(url.pathname) || url.port) {\n      throw new TypeError(\n        `${label}: webhookUrl must be a ${expected} webhook (set allowCustomUrl: true to use another https endpoint)`\n      );\n    }\n  }\n  return url;\n}\n\nexport interface WebhookResponseLike {\n  ok: boolean;\n  status: number;\n  headers?: { get(name: string): string | null } | undefined;\n  body?: { cancel(): Promise<void> } | null | undefined;\n  json?: () => Promise<unknown>;\n}\n\ninterface PostResult {\n  ok: boolean;\n  status: number;\n  retryAfterMs: number | undefined;\n}\n\nexport interface WebhookQueueOptions<T> {\n  label: string;\n  url: URL;\n  minIntervalMs: number | undefined;\n  maxPerMessage: number;\n  maxQueueSize: number | undefined;\n  maxRetries: number | undefined;\n  requestTimeoutMs: number | undefined;\n  /** Renders one entry. A throw (or unserializable result) drops only that entry. */\n  render: (entry: TransportLogEntry) => T;\n  /**\n   * Builds the JSON request body from the rendered entries. `overflow` counts\n   * entries beyond `maxPerMessage` that were dropped; the body must say so.\n   */\n  assemble: (rendered: T[], overflow: number) => unknown;\n  /** Reads the wait (ms) from a 429 response. Defaults to the Retry-After header. */\n  retryAfterMs?: (res: WebhookResponseLike) => Promise<number | undefined>;\n}\n\nexport function retryAfterHeaderMs(res: WebhookResponseLike): number | undefined {\n  const raw = res.headers?.get('retry-after');\n  if (raw === null || raw === undefined || raw === '') return undefined;\n  const seconds = Number(raw);\n  return Number.isFinite(seconds) && seconds >= 0 ? seconds * 1000 : undefined;\n}\n\nfunction nonNegative(value: number | undefined, fallback: number): number {\n  return typeof value === 'number' && Number.isFinite(value) && value >= 0 ? value : fallback;\n}\n\nfunction failureCode(err: unknown): string {\n  const cause = (err as { cause?: { code?: unknown } } | null)?.cause;\n  const code = cause?.code ?? (err as { code?: unknown } | null)?.code;\n  if (typeof code === 'string') return code.slice(0, 40);\n  return err instanceof Error ? err.name : 'error';\n}\n\nfunction sleep(ms: number, signal: AbortSignal): Promise<void> {\n  return new Promise<void>((resolve) => {\n    if (signal.aborted) return resolve();\n    const done = (): void => {\n      clearTimeout(timer);\n      signal.removeEventListener('abort', done);\n      resolve();\n    };\n    const timer = setTimeout(done, ms);\n    timer.unref?.();\n    signal.addEventListener('abort', done, { once: true });\n  });\n}\n\nasync function cancelBody(res: WebhookResponseLike): Promise<void> {\n  try {\n    await res.body?.cancel();\n  } catch {\n    // body already consumed or locked\n  }\n}\n\n/**\n * Throttled queue for chat webhooks. It is not built on BatchBuffer because the\n * semantics differ: sends are spaced by `minIntervalMs` (leading edge, then one\n * message per window), a window sends one summarized message and drops the\n * overflow, 429 waits are cancellable by close(), and flush() surfaces send\n * errors. HttpError / isPermanentHttpError are shared with BatchBuffer.\n *\n * Entries past `maxPerMessage` in one window are not sent: the message carries a\n * \"… and N more\" line and an internal warning reports the count.\n */\nexport class WebhookQueue<T> {\n  private items: TransportLogEntry[] = [];\n  private readonly cap: BufferCap;\n  private readonly host: string;\n  private readonly httpLabel: string;\n  private readonly minIntervalMs: number;\n  private readonly maxRetries: number;\n  private readonly timeoutMs: number;\n  private timer: NodeJS.Timeout | null = null;\n  private inFlight: Promise<void> | undefined;\n  private nextAllowed = 0;\n  private failures = 0;\n  private closed = false;\n  private readonly shutdown = new AbortController();\n  private overflowPending = 0;\n  private lastOverflowWarn = 0;\n  private fetchWarned = false;\n\n  constructor(private readonly opts: WebhookQueueOptions<T>) {\n    this.host = opts.url.hostname;\n    this.httpLabel = `${opts.label} (${this.host})`;\n    this.minIntervalMs = nonNegative(opts.minIntervalMs, 1000);\n    this.maxRetries = Math.floor(nonNegative(opts.maxRetries, 1));\n    this.timeoutMs = nonNegative(opts.requestTimeoutMs, DEFAULT_WEBHOOK_TIMEOUT_MS);\n    this.cap = new BufferCap(opts.label, opts.maxQueueSize, opts.maxPerMessage, DEFAULT_QUEUE_CAP);\n  }\n\n  get length(): number {\n    return this.items.length;\n  }\n\n  push(entry: TransportLogEntry): void {\n    if (this.closed) return;\n    this.items.push(entry);\n    this.cap.enforce(this.items);\n    this.schedule();\n  }\n\n  flush(): Promise<void> {\n    this.inFlight ??= this.drain().finally(() => {\n      this.inFlight = undefined;\n    });\n    return this.inFlight;\n  }\n\n  /** Cancels rate-limit waits, then makes one best-effort send with a short timeout. */\n  async close(): Promise<void> {\n    this.closed = true;\n    this.clearTimer();\n    this.shutdown.abort();\n    try {\n      await this.inFlight;\n    } catch {\n      // already reported by the timer path\n    }\n    try {\n      await this.flush();\n    } catch (err) {\n      internalError(`${this.opts.label} flush on close failed`, err);\n    }\n    this.reportOverflow(true);\n    if (this.items.length > 0) {\n      internalError(`${this.opts.label} closing with ${this.items.length} undelivered entries`);\n      this.items = [];\n    }\n  }\n\n  private clearTimer(): void {\n    if (this.timer) clearTimeout(this.timer);\n    this.timer = null;\n  }\n\n  private schedule(): void {\n    if (this.timer || this.closed || this.items.length === 0) return;\n    const delay = Math.max(0, this.nextAllowed - Date.now());\n    this.timer = setTimeout(() => {\n      this.timer = null;\n      this.flush().catch((err) => internalError(`${this.opts.label} send failed`, err));\n    }, delay);\n    this.timer.unref?.();\n  }\n\n  private reportOverflow(force = false): void {\n    const now = Date.now();\n    if (this.overflowPending === 0 || (!force && now - this.lastOverflowWarn < OVERFLOW_WARN_MS)) {\n      return;\n    }\n    const n = this.overflowPending;\n    internalWarn(\n      `${this.opts.label}: ${n} entr${n === 1 ? 'y' : 'ies'} over the per-message limit (${this.opts.maxPerMessage}) summarized in a \"... and N more\" line and not sent`\n    );\n    this.overflowPending = 0;\n    this.lastOverflowWarn = now;\n  }\n\n  private render(batch: TransportLogEntry[]): T[] {\n    const rendered: T[] = [];\n    let bad = 0;\n    for (const entry of batch) {\n      try {\n        const value = this.opts.render(entry);\n        JSON.stringify(value);\n        rendered.push(value);\n      } catch (err) {\n        bad += 1;\n        if (bad === 1) {\n          internalError(`${this.opts.label}: dropping an entry that cannot be rendered`, err);\n        }\n      }\n    }\n    if (bad > 1) {\n      internalError(`${this.opts.label}: dropped ${bad} entries that cannot be rendered`);\n    }\n    return rendered;\n  }\n\n  private async drain(): Promise<void> {\n    if (this.items.length === 0) return;\n    if (typeof fetch !== 'function') {\n      if (!this.fetchWarned) {\n        this.fetchWarned = true;\n        internalWarn(\n          `${this.opts.label}: global fetch is unavailable (Node 18+ required); dropping entries`\n        );\n      }\n      this.items = [];\n      return;\n    }\n    const all = this.items;\n    this.items = [];\n    const batch = all.slice(0, this.opts.maxPerMessage);\n    const overflow = all.length - batch.length;\n    if (overflow > 0) {\n      this.overflowPending += overflow;\n      this.reportOverflow();\n    }\n    this.nextAllowed = Date.now() + this.minIntervalMs;\n    try {\n      const rendered = this.render(batch);\n      if (rendered.length === 0 && overflow === 0) return;\n      let body: string;\n      try {\n        body = JSON.stringify(this.opts.assemble(rendered, overflow));\n      } catch (err) {\n        internalError(`${this.opts.label}: dropping a batch that cannot be serialized`, err);\n        return;\n      }\n      try {\n        await this.sendWithRetry(body);\n        this.failures = 0;\n      } catch (err) {\n        if (!isPermanentHttpError(err)) {\n          this.items.unshift(...batch);\n          this.cap.enforce(this.items);\n          this.failures += 1;\n          const backoff = Math.min(\n            MAX_BACKOFF_MS,\n            Math.max(1000, this.minIntervalMs) * 2 ** this.failures\n          );\n          this.nextAllowed = Math.max(this.nextAllowed, Date.now() + backoff);\n        }\n        throw err;\n      }\n    } finally {\n      this.schedule();\n    }\n  }\n\n  private async sendWithRetry(body: string): Promise<void> {\n    for (let attempt = 0; ; attempt += 1) {\n      const res = await this.post(body);\n      if (res.ok) return;\n      if (res.status !== 429) throw new HttpError(res.status, '', this.httpLabel);\n      const waitMs = Math.min(\n        MAX_BACKOFF_MS,\n        Math.max(0, res.retryAfterMs ?? Math.max(1000, this.minIntervalMs))\n      );\n      this.nextAllowed = Math.max(this.nextAllowed, Date.now() + waitMs);\n      if (attempt >= this.maxRetries || this.closed) {\n        throw new HttpError(429, '', this.httpLabel);\n      }\n      await sleep(waitMs, this.shutdown.signal);\n      if (this.shutdown.signal.aborted) {\n        throw new Error(`${this.opts.label}: rate-limit wait cancelled by close()`);\n      }\n    }\n  }\n\n  private async readRetryAfter(res: WebhookResponseLike): Promise<number | undefined> {\n    try {\n      return this.opts.retryAfterMs ? await this.opts.retryAfterMs(res) : retryAfterHeaderMs(res);\n    } catch {\n      return undefined;\n    }\n  }\n\n  private async post(body: string): Promise<PostResult> {\n    const controller = new AbortController();\n    const timeoutMs = this.closed ? Math.min(this.timeoutMs, CLOSE_TIMEOUT_MS) : this.timeoutMs;\n    const timer = setTimeout(() => controller.abort(), timeoutMs);\n    try {\n      const res = (await fetch(this.opts.url, {\n        method: 'POST',\n        headers: { 'Content-Type': 'application/json' },\n        body,\n        redirect: 'error',\n        signal: controller.signal,\n      })) as WebhookResponseLike;\n      let retryAfterMs: number | undefined;\n      try {\n        if (res.status === 429) retryAfterMs = await this.readRetryAfter(res);\n      } finally {\n        await cancelBody(res);\n      }\n      return { ok: res.ok, status: res.status, retryAfterMs };\n    } catch (err) {\n      // fetch errors may echo the request URL; keep only the host and a short code (no cause)\n      // eslint-disable-next-line preserve-caught-error -- the cause can contain the secret URL\n      throw new Error(\n        `${this.opts.label}: request to ${this.host} failed (${controller.signal.aborted ? 'timeout' : failureCode(err)})`\n      );\n    } finally {\n      clearTimeout(timer);\n    }\n  }\n}\n\n/** Cuts `text` to `max` chars without splitting a surrogate pair or a `&amp;`-style entity. */\nexport function truncateText(text: string, max: number, ellipsis = '…'): string {\n  if (text.length <= max) return text;\n  let cut = text.slice(0, Math.max(0, max - ellipsis.length));\n  cut = cut.replace(/&[a-z]{0,3}$/, '');\n  if (/[\\uD800-\\uDBFF]$/.test(cut)) cut = cut.slice(0, -1);\n  return cut + ellipsis;\n}\n\n/** Breaks code-fence and broadcast-mention sequences with a zero-width space. */\nexport function defuseText(text: string): string {\n  return text\n    .replace(/`{3,}/g, (m) => m.split('').join(ZWSP))\n    .replace(/@(everyone|here|channel)/gi, `@${ZWSP}$1`);\n}\n\n/** Collapses control characters and newlines for single-line fields. */\nexport function singleLine(text: string): string {\n  // eslint-disable-next-line no-control-regex\n  return text.replace(/[\\u0000-\\u001f\\u007f]+/g, ' ').trim();\n}\n\n/** ISO string, or undefined for a missing or invalid timestamp. */\nexport function safeIso(date: unknown): string | undefined {\n  return date instanceof Date && !Number.isNaN(date.getTime()) ? date.toISOString() : undefined;\n}\n","/**\n * Discord webhook transport.\n *\n * Sends error-level (by default) entries to a Discord channel as embeds.\n * Entries inside `minIntervalMs` are batched into one request (max 10 embeds;\n * the overflow is dropped and counted in the message `content`). Every request\n * carries `allowed_mentions: { parse: [] }` so logged data can never ping\n * @everyone, roles or users, and logged text has its markdown escaped.\n *\n * Limits follow https://discord.com/developers/docs/resources/message#embed-object-embed-limits\n *\n * The webhook URL is a secret: it is never logged and never appears in errors.\n *\n * @example\n * transports: { custom: [ new DiscordTransport({ webhookUrl: process.env.DISCORD_WEBHOOK_URL! }) ] }\n */\n\nimport type { IAsyncTransport, TransportLogEntry } from '../types/transport.types';\nimport { internalWarn } from '../utils/internal-log';\nimport { stringifyForLog } from '../utils/safe-stringify';\nimport {\n  DEFAULT_WEBHOOK_TIMEOUT_MS,\n  defuseText,\n  meetsLevel,\n  parseWebhookUrl,\n  resolveMinLevel,\n  retryAfterHeaderMs,\n  safeIso,\n  singleLine,\n  truncateText,\n  WebhookQueue,\n  type WebhookResponseLike,\n} from './webhook-queue';\n\nexport const DISCORD_TITLE_MAX = 256;\nexport const DISCORD_DESCRIPTION_MAX = 4096;\nexport const DISCORD_FIELD_VALUE_MAX = 1024;\nexport const DISCORD_EMBEDS_MAX = 10;\nexport const DISCORD_FIELDS_MAX = 25;\nexport const DISCORD_EMBED_TOTAL_MAX = 6000;\nexport const DISCORD_CONTENT_MAX = 2000;\nconst FIELD_VALUE_CAP = 64;\nconst DISCORD_FOOTER_MAX = 2048;\nconst FENCE_OVERHEAD = '```json\\n\\n```'.length;\nconst MIN_USEFUL_BODY = 20;\n\nexport interface DiscordEmbedField {\n  name: string;\n  value: string;\n  inline?: boolean;\n}\n\nexport interface DiscordEmbed {\n  title?: string;\n  description?: string;\n  color?: number;\n  timestamp?: string;\n  fields?: DiscordEmbedField[];\n  [key: string]: unknown;\n}\n\nexport interface DiscordTransportConfig {\n  /** Webhook URL (secret). Must be https on discord.com / discordapp.com unless `allowCustomUrl`. */\n  webhookUrl: string;\n  /** Minimum level to send. Default: 'error'. */\n  level?: string;\n  username?: string;\n  /** https URL of the avatar shown for the webhook. */\n  avatarUrl?: string;\n  /** Entries within this window are batched into one request. Default: 1000. */\n  minIntervalMs?: number;\n  /**\n   * Overrides the embed built for each entry. Limits are still enforced, but\n   * escaping the content is the formatter's responsibility.\n   */\n  formatter?: (entry: TransportLogEntry) => DiscordEmbed;\n  filter?: (entry: TransportLogEntry) => boolean;\n  /** Accept an https webhook URL on any host (e.g. a proxy or Discord-compatible service). */\n  allowCustomUrl?: boolean;\n  /** Retries after an HTTP 429 (waits retry_after, max 30s). Default: 1. */\n  maxRetries?: number;\n  /** Max queued entries; the oldest are dropped past this. Default: 1000. */\n  maxBufferSize?: number;\n  requestTimeoutMs?: number;\n}\n\nexport const DISCORD_LEVEL_COLORS: Record<string, number> = {\n  fatal: 0x992d22,\n  error: 0xed4245,\n  warn: 0xfee75c,\n  warning: 0xfee75c,\n  info: 0x3498db,\n  debug: 0x95a5a6,\n  verbose: 0x95a5a6,\n  trace: 0x95a5a6,\n};\nconst DEFAULT_COLOR = 0x95a5a6;\n\n/** Escapes Discord markdown and defuses @everyone / @here and code fences. */\nexport function escapeDiscord(text: string): string {\n  return defuseText(text.replace(/[\\\\*_~`|>#[\\]()]/g, '\\\\$&'));\n}\n\nfunction textLength(value: unknown, key: string): number {\n  const text = (value as Record<string, unknown> | undefined)?.[key];\n  return typeof text === 'string' ? text.length : 0;\n}\n\n/** Counts every text field Discord counts toward the 6000-character limit. */\nfunction embedChars(embed: DiscordEmbed): number {\n  return (\n    (embed.title?.length ?? 0) +\n    (embed.description?.length ?? 0) +\n    (embed.fields ?? []).reduce((n, f) => n + f.name.length + f.value.length, 0) +\n    textLength(embed['footer'], 'text') +\n    textLength(embed['author'], 'name')\n  );\n}\n\n/** Shrinks one embed to `limit` chars: description first, then fields, footer/author, title. */\nfunction shrinkToFit(embed: DiscordEmbed, limit: number): void {\n  const excess = () => embedChars(embed) - limit;\n  if (excess() > 0 && embed.description) {\n    const keep = embed.description.length - excess();\n    if (keep > 0) embed.description = truncateText(embed.description, keep);\n    else delete embed.description;\n  }\n  while (excess() > 0 && embed.fields?.length) embed.fields.pop();\n  if (excess() > 0) {\n    delete embed['footer'];\n    delete embed['author'];\n  }\n  if (excess() > 0 && embed.title) {\n    embed.title = truncateText(embed.title, Math.max(1, embed.title.length - excess()));\n  }\n}\n\nfunction codeBlock(json: string, max: number): string {\n  return `\\`\\`\\`json\\n${truncateText(\n    json.replace(/`{3,}/g, (m) => m.split('').join('​')),\n    max\n  )}\\n\\`\\`\\``;\n}\n\nfunction clampCustomEmbed(embed: DiscordEmbed): DiscordEmbed {\n  const out: DiscordEmbed = { ...embed };\n  if (typeof out.title === 'string') out.title = truncateText(out.title, DISCORD_TITLE_MAX);\n  if (typeof out.description === 'string') {\n    out.description = truncateText(out.description, DISCORD_DESCRIPTION_MAX);\n  }\n  if (Array.isArray(out.fields)) {\n    out.fields = out.fields.slice(0, DISCORD_FIELDS_MAX).map((f) => ({\n      ...f,\n      name: truncateText(String(f.name), DISCORD_TITLE_MAX),\n      value: truncateText(String(f.value), DISCORD_FIELD_VALUE_MAX),\n    }));\n  }\n  const footer = out['footer'] as { text?: unknown } | undefined;\n  if (footer && typeof footer.text === 'string') {\n    out['footer'] = { ...footer, text: truncateText(footer.text, DISCORD_FOOTER_MAX) };\n  }\n  const author = out['author'] as { name?: unknown } | undefined;\n  if (author && typeof author.name === 'string') {\n    out['author'] = { ...author, name: truncateText(author.name, DISCORD_TITLE_MAX) };\n  }\n  return out;\n}\n\ninterface EmbedDraft {\n  embed: DiscordEmbed;\n  json: string | undefined;\n}\n\nexport class DiscordTransport implements IAsyncTransport {\n  public readonly name = 'discord';\n  public readonly level: string;\n  public filter?: (entry: TransportLogEntry) => boolean;\n\n  private readonly queue!: WebhookQueue<EmbedDraft>;\n  private readonly username: string | undefined;\n  private readonly avatarUrl: string | undefined;\n  private readonly formatter: ((entry: TransportLogEntry) => DiscordEmbed) | undefined;\n\n  constructor(config: DiscordTransportConfig) {\n    const url = parseWebhookUrl(config.webhookUrl, {\n      label: 'DiscordTransport',\n      hostMatches: (h) =>\n        ['discord.com', 'discordapp.com', 'ptb.discord.com', 'canary.discord.com'].includes(h),\n      pathMatches: (p) => /^\\/api(\\/v\\d+)?\\/webhooks\\//.test(p),\n      expected: 'discord.com',\n      allowCustomUrl: config.allowCustomUrl,\n    });\n    if (config.avatarUrl !== undefined && !/^https:\\/\\//i.test(config.avatarUrl)) {\n      throw new TypeError('DiscordTransport: avatarUrl must use https:');\n    }\n    this.level = resolveMinLevel(config.level, 'DiscordTransport');\n    if (config.filter) this.filter = config.filter;\n    this.username = config.username;\n    this.avatarUrl = config.avatarUrl;\n    this.formatter = config.formatter;\n    const queue = new WebhookQueue<EmbedDraft>({\n      label: 'DiscordTransport',\n      url,\n      minIntervalMs: config.minIntervalMs,\n      maxPerMessage: DISCORD_EMBEDS_MAX,\n      maxQueueSize: config.maxBufferSize,\n      maxRetries: config.maxRetries,\n      requestTimeoutMs: config.requestTimeoutMs ?? DEFAULT_WEBHOOK_TIMEOUT_MS,\n      render: (entry) => this.draftFor(entry),\n      assemble: (drafts, overflow) => this.buildPayload(drafts, overflow),\n      retryAfterMs: readRetryAfter,\n    });\n    // non-enumerable so util.inspect / spreads of the transport never reach the secret URL\n    Object.defineProperty(this, 'queue', { value: queue, enumerable: false });\n  }\n\n  write(entry: TransportLogEntry): void {\n    if (!meetsLevel(entry.level, this.level)) return;\n    // `filter` is applied by the TransportManager; it is not run again here\n    this.queue.push(entry);\n  }\n\n  flush(): Promise<void> {\n    return this.queue.flush();\n  }\n\n  close(): Promise<void> {\n    return this.queue.close();\n  }\n\n  /** Never serialise the webhook URL (JSON.stringify, util.inspect). */\n  toJSON(): Record<string, unknown> {\n    return { name: this.name, level: this.level };\n  }\n\n  private buildPayload(drafts: EmbedDraft[], overflow: number): Record<string, unknown> {\n    const kept = this.fitToBudget(drafts);\n    const dropped = overflow + (drafts.length - kept.length);\n\n    const payload: Record<string, unknown> = {\n      embeds: kept.map((d) => d.embed),\n      allowed_mentions: { parse: [] },\n    };\n    if (dropped > 0) {\n      payload['content'] = truncateText(\n        `… and ${dropped} more entr${dropped === 1 ? 'y' : 'ies'} not shown`,\n        DISCORD_CONTENT_MAX\n      );\n    }\n    if (this.username) payload['username'] = truncateText(this.username, 80);\n    if (this.avatarUrl) payload['avatar_url'] = this.avatarUrl;\n    return payload;\n  }\n\n  /** Enforces the 6000-char total: drops trailing embeds if needed, then shares the rest among descriptions. */\n  private fitToBudget(drafts: EmbedDraft[]): EmbedDraft[] {\n    const kept = [...drafts];\n    const base = () => kept.reduce((n, d) => n + embedChars(d.embed), 0);\n    while (kept.length > 1 && base() > DISCORD_EMBED_TOTAL_MAX) kept.pop();\n    const only = kept[0];\n    if (only && base() > DISCORD_EMBED_TOTAL_MAX) shrinkToFit(only.embed, DISCORD_EMBED_TOTAL_MAX);\n    const withData = kept.filter((d) => d.json !== undefined);\n    if (withData.length === 0) return kept;\n    const share = Math.floor((DISCORD_EMBED_TOTAL_MAX - base()) / withData.length);\n    const body = Math.min(DISCORD_DESCRIPTION_MAX, share) - FENCE_OVERHEAD;\n    for (const d of withData) {\n      if (body >= MIN_USEFUL_BODY) d.embed.description = codeBlock(d.json!, body);\n    }\n    return kept;\n  }\n\n  private draftFor(entry: TransportLogEntry): EmbedDraft {\n    if (this.formatter) {\n      try {\n        return { embed: clampCustomEmbed(this.formatter(entry)), json: undefined };\n      } catch {\n        internalWarn('DiscordTransport: formatter threw; using the default embed');\n      }\n    }\n    return defaultDraft(entry);\n  }\n}\n\nfunction defaultDraft(entry: TransportLogEntry): EmbedDraft {\n  const title = `[${singleLine(entry.level).toUpperCase()}] ${escapeDiscord(singleLine(entry.message))}`;\n  const candidates: Array<[string, string | undefined]> = [\n    ['appName', entry.appName],\n    ['environment', entry.environment],\n    ['context', entry.context],\n    ['traceId', entry.traceId],\n  ];\n  const fields: DiscordEmbedField[] = candidates\n    .map(([name, value]) => [name, typeof value === 'string' ? singleLine(value) : ''] as const)\n    .filter(([, value]) => value !== '')\n    .map(([name, value]) => ({\n      name,\n      value: truncateText(escapeDiscord(value), FIELD_VALUE_CAP),\n      inline: true,\n    }));\n  const embed: DiscordEmbed = {\n    title: truncateText(title, DISCORD_TITLE_MAX),\n    color: DISCORD_LEVEL_COLORS[entry.level.toLowerCase()] ?? DEFAULT_COLOR,\n    fields,\n  };\n  const timestamp = safeIso(entry.timestamp);\n  if (timestamp) embed.timestamp = timestamp;\n  const json =\n    entry.data && Object.keys(entry.data).length > 0 ? stringifyForLog(entry.data) : undefined;\n  return { embed, json };\n}\n\nasync function readRetryAfter(res: WebhookResponseLike): Promise<number | undefined> {\n  try {\n    const body = (await res.json?.()) as { retry_after?: unknown } | undefined;\n    const seconds = Number(body?.retry_after);\n    if (body?.retry_after !== undefined && Number.isFinite(seconds) && seconds >= 0) {\n      return seconds * 1000;\n    }\n  } catch {\n    // fall through to the header\n  }\n  return retryAfterHeaderMs(res);\n}\n","/**\n * Slack incoming-webhook transport.\n *\n * Sends error-level (by default) entries to a Slack channel as Block Kit\n * messages. Entries inside `minIntervalMs` are batched into one message so a\n * log storm cannot flood the channel. All logged text is escaped for Slack\n * mrkdwn (`&`, `<`, `>`), which also disarms `<!channel>`, `<!here>` and\n * `<@U123>` mentions coming from logged data.\n *\n * The webhook URL is a secret: it is never logged and never appears in errors.\n *\n * @example\n * transports: { custom: [ new SlackTransport({ webhookUrl: process.env.SLACK_WEBHOOK_URL! }) ] }\n */\n\nimport type { IAsyncTransport, TransportLogEntry } from '../types/transport.types';\nimport { internalWarn } from '../utils/internal-log';\nimport { stringifyForLog } from '../utils/safe-stringify';\nimport {\n  DEFAULT_WEBHOOK_TIMEOUT_MS,\n  defuseText,\n  meetsLevel,\n  parseWebhookUrl,\n  resolveMinLevel,\n  safeIso,\n  singleLine,\n  truncateText,\n  WebhookQueue,\n} from './webhook-queue';\n\nexport const SLACK_HEADER_MAX = 150;\nexport const SLACK_DATA_MAX = 2500;\nconst SLACK_FIELD_MAX = 300;\nconst SLACK_TEXT_MAX = 1000;\nconst SLACK_MAX_BLOCKS = 50;\nconst SLACK_MAX_PER_MESSAGE = 10;\n\n/** A Slack message body as returned by a custom `formatter`. */\nexport interface SlackMessage {\n  text?: string;\n  blocks?: unknown[];\n  [key: string]: unknown;\n}\n\nexport interface SlackTransportConfig {\n  /** Incoming-webhook URL (secret). Must be https on hooks.slack.com unless `allowCustomUrl`. */\n  webhookUrl: string;\n  /** Minimum level to send. Default: 'error'. */\n  level?: string;\n  username?: string;\n  iconEmoji?: string;\n  /** Entries within this window are batched into one message. Default: 1000. */\n  minIntervalMs?: number;\n  /**\n   * Overrides the message built for each entry. The results of one window are\n   * merged: texts are joined and blocks concatenated (capped at 50 blocks).\n   * Escaping the content is the formatter's responsibility.\n   */\n  formatter?: (entry: TransportLogEntry) => SlackMessage;\n  filter?: (entry: TransportLogEntry) => boolean;\n  /** Accept an https webhook URL on any host (e.g. a proxy or Slack-compatible service). */\n  allowCustomUrl?: boolean;\n  /** Retries after an HTTP 429 (waits Retry-After, max 30s). Default: 1. */\n  maxRetries?: number;\n  /** Max queued entries; the oldest are dropped past this. Default: 1000. */\n  maxBufferSize?: number;\n  requestTimeoutMs?: number;\n}\n\n/** Escapes the three characters Slack treats specially and defuses broadcast mentions. */\nexport function escapeSlack(text: string): string {\n  return defuseText(text.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;'));\n}\n\nconst LEVEL_EMOJI: Record<string, string> = {\n  fatal: ':rotating_light:',\n  error: ':red_circle:',\n  warn: ':warning:',\n  warning: ':warning:',\n  info: ':information_source:',\n};\n\nexport class SlackTransport implements IAsyncTransport {\n  public readonly name = 'slack';\n  public readonly level: string;\n  public filter?: (entry: TransportLogEntry) => boolean;\n\n  private readonly queue!: WebhookQueue<SlackMessage>;\n  private readonly username: string | undefined;\n  private readonly iconEmoji: string | undefined;\n  private readonly formatter: ((entry: TransportLogEntry) => SlackMessage) | undefined;\n\n  constructor(config: SlackTransportConfig) {\n    const url = parseWebhookUrl(config.webhookUrl, {\n      label: 'SlackTransport',\n      hostMatches: (h) => h === 'hooks.slack.com' || h === 'hooks.slack-gov.com',\n      pathMatches: (p) => p.startsWith('/services/') || p.startsWith('/triggers/'),\n      expected: 'hooks.slack.com',\n      allowCustomUrl: config.allowCustomUrl,\n    });\n    this.level = resolveMinLevel(config.level, 'SlackTransport');\n    if (config.filter) this.filter = config.filter;\n    this.username = config.username;\n    this.iconEmoji = config.iconEmoji;\n    this.formatter = config.formatter;\n    const queue = new WebhookQueue<SlackMessage>({\n      label: 'SlackTransport',\n      url,\n      minIntervalMs: config.minIntervalMs,\n      maxPerMessage: SLACK_MAX_PER_MESSAGE,\n      maxQueueSize: config.maxBufferSize,\n      maxRetries: config.maxRetries,\n      requestTimeoutMs: config.requestTimeoutMs ?? DEFAULT_WEBHOOK_TIMEOUT_MS,\n      render: (entry) => this.messageFor(entry),\n      assemble: (messages, overflow) => this.buildPayload(messages, overflow),\n    });\n    // non-enumerable so util.inspect / spreads of the transport never reach the secret URL\n    Object.defineProperty(this, 'queue', { value: queue, enumerable: false });\n  }\n\n  write(entry: TransportLogEntry): void {\n    if (!meetsLevel(entry.level, this.level)) return;\n    // `filter` is applied by the TransportManager; it is not run again here\n    this.queue.push(entry);\n  }\n\n  flush(): Promise<void> {\n    return this.queue.flush();\n  }\n\n  close(): Promise<void> {\n    return this.queue.close();\n  }\n\n  /** Never serialise the webhook URL (JSON.stringify, util.inspect). */\n  toJSON(): Record<string, unknown> {\n    return { name: this.name, level: this.level };\n  }\n\n  private buildPayload(messages: SlackMessage[], overflow: number): Record<string, unknown> {\n    const blocks = messages.flatMap((m) => m.blocks ?? []);\n    const plural = overflow === 1 ? 'y' : 'ies';\n    const counter = overflow > 0 ? `… and ${overflow} more entr${plural} not shown` : '';\n    if (counter) {\n      blocks.push({ type: 'context', elements: [{ type: 'mrkdwn', text: counter }] });\n    }\n    const text = [...messages.map((m) => m.text ?? ''), counter].filter(Boolean).join('\\n');\n    const payload: Record<string, unknown> = {\n      text: truncateText(text, SLACK_TEXT_MAX),\n      blocks: blocks.slice(0, SLACK_MAX_BLOCKS),\n    };\n    if (this.username) payload['username'] = truncateText(this.username, 80);\n    if (this.iconEmoji) payload['icon_emoji'] = this.iconEmoji;\n    return payload;\n  }\n\n  private messageFor(entry: TransportLogEntry): SlackMessage {\n    if (this.formatter) {\n      try {\n        return this.formatter(entry);\n      } catch {\n        internalWarn('SlackTransport: formatter threw; using the default message');\n      }\n    }\n    return defaultMessage(entry);\n  }\n}\n\nfunction defaultMessage(entry: TransportLogEntry): SlackMessage {\n  const level = singleLine(entry.level).toUpperCase();\n  const emoji = LEVEL_EMOJI[entry.level.toLowerCase()] ?? ':white_circle:';\n  const headline = `[${level}] ${singleLine(entry.message)}`;\n  const blocks: unknown[] = [\n    {\n      type: 'header',\n      text: {\n        type: 'plain_text',\n        text: truncateText(escapeSlack(headline), SLACK_HEADER_MAX),\n        emoji: false,\n      },\n    },\n  ];\n\n  const context = [\n    ['app', entry.appName],\n    ['env', entry.environment],\n    ['context', entry.context],\n    ['trace', entry.traceId],\n    ['time', safeIso(entry.timestamp)],\n  ]\n    .map(([label, value]) => [label, typeof value === 'string' ? singleLine(value) : ''] as const)\n    .filter(([, value]) => value !== '')\n    .map(([label, value]) => ({\n      type: 'mrkdwn',\n      text: `*${label}:* ${truncateText(escapeSlack(value), SLACK_FIELD_MAX)}`,\n    }));\n  if (context.length > 0) blocks.push({ type: 'context', elements: context });\n\n  if (entry.data && Object.keys(entry.data).length > 0) {\n    const json = truncateText(escapeSlack(stringifyForLog(entry.data)), SLACK_DATA_MAX);\n    blocks.push({ type: 'section', text: { type: 'mrkdwn', text: `\\`\\`\\`${json}\\`\\`\\`` } });\n  }\n\n  return {\n    text: `${emoji} ${escapeSlack(truncateText(headline, SLACK_HEADER_MAX))}`,\n    blocks,\n  };\n}\n"],"mappings":"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"}

package/dist/slack.transport-CXjQYOes.d.ts

@@ -0,0 +1,112 @@
+import { p as TransportLogEntry, s as IAsyncTransport } from "./transport.types-CGoHpWQR.js";
+
+//#region src/transports/discord.transport.d.ts
+
+interface DiscordEmbedField {
+  name: string;
+  value: string;
+  inline?: boolean;
+}
+interface DiscordEmbed {
+  title?: string;
+  description?: string;
+  color?: number;
+  timestamp?: string;
+  fields?: DiscordEmbedField[];
+  [key: string]: unknown;
+}
+interface DiscordTransportConfig {
+  /** Webhook URL (secret). Must be https on discord.com / discordapp.com unless `allowCustomUrl`. */
+  webhookUrl: string;
+  /** Minimum level to send. Default: 'error'. */
+  level?: string;
+  username?: string;
+  /** https URL of the avatar shown for the webhook. */
+  avatarUrl?: string;
+  /** Entries within this window are batched into one request. Default: 1000. */
+  minIntervalMs?: number;
+  /**
+   * Overrides the embed built for each entry. Limits are still enforced, but
+   * escaping the content is the formatter's responsibility.
+   */
+  formatter?: (entry: TransportLogEntry) => DiscordEmbed;
+  filter?: (entry: TransportLogEntry) => boolean;
+  /** Accept an https webhook URL on any host (e.g. a proxy or Discord-compatible service). */
+  allowCustomUrl?: boolean;
+  /** Retries after an HTTP 429 (waits retry_after, max 30s). Default: 1. */
+  maxRetries?: number;
+  /** Max queued entries; the oldest are dropped past this. Default: 1000. */
+  maxBufferSize?: number;
+  requestTimeoutMs?: number;
+}
+declare class DiscordTransport implements IAsyncTransport {
+  readonly name = "discord";
+  readonly level: string;
+  filter?: (entry: TransportLogEntry) => boolean;
+  private readonly queue;
+  private readonly username;
+  private readonly avatarUrl;
+  private readonly formatter;
+  constructor(config: DiscordTransportConfig);
+  write(entry: TransportLogEntry): void;
+  flush(): Promise<void>;
+  close(): Promise<void>;
+  /** Never serialise the webhook URL (JSON.stringify, util.inspect). */
+  toJSON(): Record<string, unknown>;
+  private buildPayload;
+  /** Enforces the 6000-char total: drops trailing embeds if needed, then shares the rest among descriptions. */
+  private fitToBudget;
+  private draftFor;
+}
+//#endregion
+//#region src/transports/slack.transport.d.ts
+/** A Slack message body as returned by a custom `formatter`. */
+interface SlackMessage {
+  text?: string;
+  blocks?: unknown[];
+  [key: string]: unknown;
+}
+interface SlackTransportConfig {
+  /** Incoming-webhook URL (secret). Must be https on hooks.slack.com unless `allowCustomUrl`. */
+  webhookUrl: string;
+  /** Minimum level to send. Default: 'error'. */
+  level?: string;
+  username?: string;
+  iconEmoji?: string;
+  /** Entries within this window are batched into one message. Default: 1000. */
+  minIntervalMs?: number;
+  /**
+   * Overrides the message built for each entry. The results of one window are
+   * merged: texts are joined and blocks concatenated (capped at 50 blocks).
+   * Escaping the content is the formatter's responsibility.
+   */
+  formatter?: (entry: TransportLogEntry) => SlackMessage;
+  filter?: (entry: TransportLogEntry) => boolean;
+  /** Accept an https webhook URL on any host (e.g. a proxy or Slack-compatible service). */
+  allowCustomUrl?: boolean;
+  /** Retries after an HTTP 429 (waits Retry-After, max 30s). Default: 1. */
+  maxRetries?: number;
+  /** Max queued entries; the oldest are dropped past this. Default: 1000. */
+  maxBufferSize?: number;
+  requestTimeoutMs?: number;
+}
+declare class SlackTransport implements IAsyncTransport {
+  readonly name = "slack";
+  readonly level: string;
+  filter?: (entry: TransportLogEntry) => boolean;
+  private readonly queue;
+  private readonly username;
+  private readonly iconEmoji;
+  private readonly formatter;
+  constructor(config: SlackTransportConfig);
+  write(entry: TransportLogEntry): void;
+  flush(): Promise<void>;
+  close(): Promise<void>;
+  /** Never serialise the webhook URL (JSON.stringify, util.inspect). */
+  toJSON(): Record<string, unknown>;
+  private buildPayload;
+  private messageFor;
+}
+//#endregion
+export { DiscordTransport as a, DiscordEmbed as i, SlackTransport as n, DiscordTransportConfig as o, SlackTransportConfig as r, SlackMessage as t };
+//# sourceMappingURL=slack.transport-CXjQYOes.d.ts.map

package/dist/slack.transport-CXjQYOes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slack.transport-CXjQYOes.d.ts","names":[],"sources":["../src/transports/discord.transport.ts","../src/transports/slack.transport.ts"],"sourcesContent":[],"mappings":";;;;AC0DsB,UDZL,iBAAA,CCYK;EAAsB,IAAA,EAAA,MAAA;EACzB,KAAA,EAAA,MAAA;EAAiB,MAAA,CAAA,EAAA,OAAA;AAuBpC;AAG0B,UDjCT,YAAA,CCiCS;EAOJ,KAAA,CAAA,EAAA,MAAA;EA4BP,WAAA,CAAA,EAAA,MAAA;EAMJ,KAAA,CAAA,EAAA,MAAA;EAIA,SAAA,CAAA,EAAA,MAAA;EAKC,MAAA,CAAA,ED9ED,iBC8EC,EAAA;EArD2B,CAAA,GAAA,EAAA,MAAA,CAAA,EAAA,OAAA;;UDrBtB,sBAAA;;;;;;;;;;;;;;sBAcK,sBAAsB;mBACzB;;;;;;;;;cAiGN,gBAAA,YAA4B;;;mBAGf;;;;;sBAOJ;eAiCP;WAMJ;WAIA;;YAKC;;;;;;;;;AA1D4C,UCvIvC,YAAA,CDuIuC;;;;ACvIxD;AAMiB,UAAA,oBAAA,CAAoB;EAcf;EAAsB,UAAA,EAAA,MAAA;EACzB;EAAiB,KAAA,CAAA,EAAA,MAAA;EAuBvB,QAAA,CAAA,EAAA,MAAe;EAGF,SAAA,CAAA,EAAA,MAAA;EAOJ;EA4BP,aAAA,CAAA,EAAA,MAAA;EAMJ;;;;;sBApEW,sBAAsB;mBACzB;;;;;;;;;cAuBN,cAAA,YAA0B;;;mBAGb;;;;;sBAOJ;eA4BP;WAMJ;WAIA;;YAKC"}

package/dist/testing.d.mts

@@ -1,5 +1,5 @@
-import "./transport.types-B5vcyv2k.mjs";
-import { h as LogEntry, u as IBaseLogger } from "./index-BPKwwERo.mjs";
+import "./transport.types-BMnurPcc.mjs";
+import { h as LogEntry, u as IBaseLogger } from "./index-3mw5gaCw.mjs";
 
 //#region src/testing/mock-logger.d.ts
 

package/dist/testing.d.ts

@@ -1,5 +1,5 @@
-import "./transport.types-BuY84TwO.js";
-import { h as LogEntry, u as IBaseLogger } from "./index-C1X-TE5I.js";
+import "./transport.types-CGoHpWQR.js";
+import { h as LogEntry, u as IBaseLogger } from "./index-DhIoploR.js";
 
 //#region src/testing/mock-logger.d.ts
 

package/dist/trace.utils-CvXgaiQT.mjs

@@ -0,0 +1,278 @@
+import { randomUUID } from "node:crypto";
+import { AsyncLocalStorage } from "node:async_hooks";
+
+//#region src/utils/trace.utils.ts
+/** Default key used to store the trace ID in AsyncLocalStorage. */
+const TRACE_CONTEXT_KEY = "traceId";
+/**
+* Singleton that owns the AsyncLocalStorage and the active contextKey.
+*
+* Why a class instead of bare module-level variables?
+*  - The contextKey is user-configurable; encapsulating it here means there is
+*    exactly one place that reads and writes it.
+*  - All helpers (getCurrentTraceId, runWithTraceId, etc.) delegate to this
+*    instance, so the key is always in sync without hidden global state.
+*  - Easier to test: you can reset the singleton between test cases.
+*
+* Usage (advanced):
+*   import { TraceContext } from 'logixia';
+*   TraceContext.instance.contextKey          // → 'traceId' (or custom)
+*   TraceContext.instance.getCurrentTraceId() // same as standalone fn
+*/
+var TraceContext = class TraceContext {
+	static #_ = this._instance = null;
+	constructor() {
+		this.storage = new AsyncLocalStorage();
+		this._contextKey = TRACE_CONTEXT_KEY;
+	}
+	/** The process-wide singleton. */
+	static get instance() {
+		if (!TraceContext._instance) TraceContext._instance = new TraceContext();
+		return TraceContext._instance;
+	}
+	/** @internal Reset the singleton (useful in tests). */
+	static _reset() {
+		TraceContext._instance = null;
+	}
+	/** The AsyncLocalStorage key that holds the trace ID value. */
+	get contextKey() {
+		return this._contextKey;
+	}
+	/** @internal Called by TraceMiddleware when it boots to register the user's key. */
+	setContextKey(key) {
+		this._contextKey = key;
+	}
+	/** UUID v4 generator (default). */
+	generate() {
+		return randomUUID();
+	}
+	/** Read the trace ID from the current async context. */
+	getCurrentTraceId() {
+		var _this$storage$getStor;
+		return (_this$storage$getStor = this.storage.getStore()) === null || _this$storage$getStor === void 0 ? void 0 : _this$storage$getStor[this._contextKey];
+	}
+	/**
+	* Mutate the CURRENT async context in-place.
+	*
+	* ⚠️  DEPRECATED — unsafe for concurrent requests.
+	*
+	* Uses `AsyncLocalStorage.enterWith()`, which mutates the current async
+	* execution context and every Promise chain spawned from it. In a server
+	* processing overlapping requests this can cause a trace ID set for one
+	* request to bleed into *other* in-flight requests that share the same
+	* async parent (e.g. a module-level setup function or a cached handler).
+	*
+	* Use {@link run} instead — it scopes the context to a callback so there
+	* is no risk of cross-request leakage.
+	*
+	* @deprecated Use `TraceContext.instance.run(traceId, fn)` — do not call
+	*             `setTraceId` from request-handling code.
+	*/
+	setTraceId(traceId, data) {
+		const current = this.storage.getStore() ?? {};
+		this.storage.enterWith({
+			...current,
+			[this._contextKey]: traceId,
+			...data
+		});
+	}
+	/** Run `fn` inside a new async context that carries `traceId`. */
+	run(traceId, fn, data) {
+		return this.storage.run({
+			[this._contextKey]: traceId,
+			...data
+		}, fn);
+	}
+};
+/**
+* The shared AsyncLocalStorage instance.
+* @deprecated Prefer `TraceContext.instance.storage` for new code.
+*/
+const traceStorage = TraceContext.instance.storage;
+/** Returns the key currently used to store the trace ID in AsyncLocalStorage. */
+function getTraceContextKey() {
+	return TraceContext.instance.contextKey;
+}
+/** @internal Called by TraceMiddleware / traceMiddleware() when they boot. */
+function _setActiveContextKey(key) {
+	TraceContext.instance.setContextKey(key);
+}
+/** Generate a UUID v4 trace ID. */
+function generateTraceId() {
+	return TraceContext.instance.generate();
+}
+/**
+* Get the current trace ID from async context.
+* Returns `undefined` when called outside a traced request.
+*/
+function getCurrentTraceId() {
+	return TraceContext.instance.getCurrentTraceId();
+}
+/**
+* Set trace ID in the CURRENT async context without starting a new one.
+*
+* ⚠️  DEPRECATED — unsafe for concurrent requests.
+*
+* Uses `AsyncLocalStorage.enterWith()`, which mutates the current async
+* execution context and every Promise chain spawned from it. Under load this
+* can cause a trace ID from one request to bleed into others sharing the same
+* async parent.
+*
+* Use {@link runWithTraceId} instead. Migration patterns:
+*
+* **Express / Fastify middleware — before:**
+* ```ts
+* app.use((req, _res, next) => {
+*   setTraceId(req.headers['x-trace-id'] ?? generateTraceId());
+*   next();
+* });
+* ```
+* **after:**
+* ```ts
+* app.use((req, _res, next) => {
+*   runWithTraceId(req.headers['x-trace-id'] ?? generateTraceId(), () => next());
+* });
+* ```
+*
+* **Kafka / queue consumer — before:**
+* ```ts
+* async function handle(msg) {
+*   setTraceId(msg.headers['x-trace-id']);
+*   await processMessage(msg);
+* }
+* ```
+* **after:**
+* ```ts
+* async function handle(msg) {
+*   await runWithTraceId(msg.headers['x-trace-id'], () => processMessage(msg));
+* }
+* ```
+*
+* **Background job — before:**
+* ```ts
+* setTraceId(generateTraceId(), { jobId: job.id });
+* await job.run();
+* ```
+* **after:**
+* ```ts
+* await runWithTraceId(generateTraceId(), () => job.run(), { jobId: job.id });
+* ```
+*
+* @deprecated Use `runWithTraceId(traceId, fn)` — do not call `setTraceId`
+*             from request-handling code.
+*/
+function setTraceId(traceId, data) {
+	TraceContext.instance.setTraceId(traceId, data);
+}
+/** Run `fn` inside a new async context carrying `traceId`. */
+function runWithTraceId(traceId, fn, data) {
+	return TraceContext.instance.run(traceId, fn, data);
+}
+/** Maximum accepted length for an incoming trace / correlation / request ID. */
+const MAX_INCOMING_ID_LENGTH = 128;
+const SAFE_INCOMING_ID = /^[A-Za-z0-9._:-]{1,128}$/;
+/**
+* Validate an externally supplied identifier (trace ID, correlation ID, origin
+* service name, message-queue ID). Accepts only 1-128 characters from
+* `[A-Za-z0-9._:-]`; surrounding whitespace is trimmed first. Arrays use their
+* first element. Returns the cleaned value, or `undefined` when it is unusable
+* so callers can generate a fresh ID instead of passing client text through.
+*/
+function sanitizeIncomingId(value) {
+	const first = Array.isArray(value) ? value[0] : value;
+	if (typeof first !== "string" || first.length > MAX_INCOMING_ID_LENGTH * 2) return void 0;
+	const trimmed = first.trim();
+	return SAFE_INCOMING_ID.test(trimmed) ? trimmed : void 0;
+}
+/** W3C trace-context: `version-traceId(32hex)-spanId(16hex)-flags(2hex)`. */
+const W3C_TRACEPARENT_RE = /^[\da-f]{2}-([\da-f]{32})-[\da-f]{16}-[\da-f]{2}$/i;
+/**
+* Extract the 32-hex trace-id segment from a W3C `traceparent` header value.
+* Returns the parsed trace ID, or the original value unchanged when it is not a
+* well-formed traceparent (so non-W3C propagation still works).
+*/
+function parseTraceparent(value) {
+	const m = W3C_TRACEPARENT_RE.exec(value);
+	return m ? m[1] : value;
+}
+/** Extract trace ID from request using configuration (header → query → body → params). */
+function extractTraceId(request, config) {
+	const req = request;
+	if (config.header) {
+		const headers = Array.isArray(config.header) ? config.header : [config.header];
+		for (const header of headers) {
+			var _req$headers;
+			const lower = header.toLowerCase();
+			const value = sanitizeIncomingId((_req$headers = req.headers) === null || _req$headers === void 0 ? void 0 : _req$headers[lower]);
+			if (value) return lower === "traceparent" ? parseTraceparent(value) : value;
+		}
+	}
+	if (config.query) {
+		const queries = Array.isArray(config.query) ? config.query : [config.query];
+		for (const query of queries) {
+			var _req$query;
+			const value = sanitizeIncomingId((_req$query = req.query) === null || _req$query === void 0 ? void 0 : _req$query[query]);
+			if (value) return value;
+		}
+	}
+	if (config.body) {
+		const bodyFields = Array.isArray(config.body) ? config.body : [config.body];
+		for (const field of bodyFields) {
+			var _req$body;
+			const value = sanitizeIncomingId((_req$body = req.body) === null || _req$body === void 0 ? void 0 : _req$body[field]);
+			if (value) return value;
+		}
+	}
+	if (config.params) {
+		const paramFields = Array.isArray(config.params) ? config.params : [config.params];
+		for (const param of paramFields) {
+			var _req$params;
+			const value = sanitizeIncomingId((_req$params = req.params) === null || _req$params === void 0 ? void 0 : _req$params[param]);
+			if (value) return value;
+		}
+	}
+}
+/**
+* Default headers checked for incoming trace ID propagation, in priority order:
+*   traceparent (W3C/OTel) → x-trace-id → x-request-id → x-correlation-id → trace-id
+*/
+const DEFAULT_TRACE_HEADERS = [
+	"traceparent",
+	"x-trace-id",
+	"x-request-id",
+	"x-correlation-id",
+	"trace-id"
+];
+/**
+* Create trace ID middleware for Express/NestJS
+*/
+function createTraceMiddleware(config) {
+	const defaultExtractor = {
+		header: DEFAULT_TRACE_HEADERS,
+		query: ["traceId", "trace_id"]
+	};
+	const resolvedConfig = {
+		...config,
+		extractor: (config === null || config === void 0 ? void 0 : config.extractor) ? {
+			...defaultExtractor,
+			...config.extractor
+		} : defaultExtractor
+	};
+	_setActiveContextKey(resolvedConfig.contextKey ?? TRACE_CONTEXT_KEY);
+	return (req, res, next) => {
+		let traceId;
+		if (resolvedConfig.extractor) traceId = extractTraceId(req, resolvedConfig.extractor);
+		if (!traceId) traceId = resolvedConfig.generator ? resolvedConfig.generator() : generateTraceId();
+		req.traceId = traceId;
+		const resObj = res;
+		if (!resObj.headersSent) try {
+			if (typeof resObj.setHeader === "function") resObj.setHeader("X-Trace-Id", traceId);
+			else if (typeof resObj.header === "function") resObj.header("X-Trace-Id", traceId);
+		} catch {}
+		runWithTraceId(traceId, () => next());
+	};
+}
+
+//#endregion
+export { _setActiveContextKey as a, getCurrentTraceId as c, sanitizeIncomingId as d, setTraceId as f, TraceContext as i, getTraceContextKey as l, MAX_INCOMING_ID_LENGTH as n, createTraceMiddleware as o, traceStorage as p, TRACE_CONTEXT_KEY as r, extractTraceId as s, DEFAULT_TRACE_HEADERS as t, runWithTraceId as u };
+//# sourceMappingURL=trace.utils-CvXgaiQT.mjs.map

package/dist/trace.utils-CvXgaiQT.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace.utils-CvXgaiQT.mjs","names":["resolvedConfig: TraceIdConfig","traceId: string | undefined"],"sources":["../src/utils/trace.utils.ts"],"sourcesContent":["/**\n * Trace ID utilities for Logitron\n */\n\nimport { AsyncLocalStorage } from 'node:async_hooks';\nimport { randomUUID } from 'node:crypto';\n\nimport type { TraceIdConfig, TraceIdExtractorConfig } from '../types';\n\n/** Default key used to store the trace ID in AsyncLocalStorage. */\nexport const TRACE_CONTEXT_KEY = 'traceId' as const;\n\n// ── TraceContext class ────────────────────────────────────────────────────────\n\n/**\n * Singleton that owns the AsyncLocalStorage and the active contextKey.\n *\n * Why a class instead of bare module-level variables?\n *  - The contextKey is user-configurable; encapsulating it here means there is\n *    exactly one place that reads and writes it.\n *  - All helpers (getCurrentTraceId, runWithTraceId, etc.) delegate to this\n *    instance, so the key is always in sync without hidden global state.\n *  - Easier to test: you can reset the singleton between test cases.\n *\n * Usage (advanced):\n *   import { TraceContext } from 'logixia';\n *   TraceContext.instance.contextKey          // → 'traceId' (or custom)\n *   TraceContext.instance.getCurrentTraceId() // same as standalone fn\n */\nexport class TraceContext {\n  private static _instance: TraceContext | null = null;\n\n  readonly storage = new AsyncLocalStorage<Record<string, unknown>>();\n  private _contextKey: string = TRACE_CONTEXT_KEY;\n\n  private constructor() {}\n\n  /** The process-wide singleton. */\n  static get instance(): TraceContext {\n    if (!TraceContext._instance) {\n      TraceContext._instance = new TraceContext();\n    }\n    return TraceContext._instance;\n  }\n\n  /** @internal Reset the singleton (useful in tests). */\n  static _reset(): void {\n    TraceContext._instance = null;\n  }\n\n  // ── Key management ──────────────────────────────────────────────────────────\n\n  /** The AsyncLocalStorage key that holds the trace ID value. */\n  get contextKey(): string {\n    return this._contextKey;\n  }\n\n  /** @internal Called by TraceMiddleware when it boots to register the user's key. */\n  setContextKey(key: string): void {\n    this._contextKey = key;\n  }\n\n  // ── Core operations ─────────────────────────────────────────────────────────\n\n  /** UUID v4 generator (default). */\n  generate(): string {\n    return randomUUID();\n  }\n\n  /** Read the trace ID from the current async context. */\n  getCurrentTraceId(): string | undefined {\n    return this.storage.getStore()?.[this._contextKey] as string | undefined;\n  }\n\n  /**\n   * Mutate the CURRENT async context in-place.\n   *\n   * ⚠️  DEPRECATED — unsafe for concurrent requests.\n   *\n   * Uses `AsyncLocalStorage.enterWith()`, which mutates the current async\n   * execution context and every Promise chain spawned from it. In a server\n   * processing overlapping requests this can cause a trace ID set for one\n   * request to bleed into *other* in-flight requests that share the same\n   * async parent (e.g. a module-level setup function or a cached handler).\n   *\n   * Use {@link run} instead — it scopes the context to a callback so there\n   * is no risk of cross-request leakage.\n   *\n   * @deprecated Use `TraceContext.instance.run(traceId, fn)` — do not call\n   *             `setTraceId` from request-handling code.\n   */\n  setTraceId(traceId: string, data?: Record<string, unknown>): void {\n    const current = this.storage.getStore() ?? {};\n    this.storage.enterWith({ ...current, [this._contextKey]: traceId, ...data });\n  }\n\n  /** Run `fn` inside a new async context that carries `traceId`. */\n  run<T>(traceId: string, fn: () => T, data?: Record<string, unknown>): T {\n    return this.storage.run({ [this._contextKey]: traceId, ...data }, fn);\n  }\n}\n\n// ── Module-level aliases (backwards-compatible public API) ────────────────────\n\n/**\n * The shared AsyncLocalStorage instance.\n * @deprecated Prefer `TraceContext.instance.storage` for new code.\n */\nexport const traceStorage = TraceContext.instance.storage;\n\n/** Returns the key currently used to store the trace ID in AsyncLocalStorage. */\nexport function getTraceContextKey(): string {\n  return TraceContext.instance.contextKey;\n}\n\n/** @internal Called by TraceMiddleware / traceMiddleware() when they boot. */\nexport function _setActiveContextKey(key: string): void {\n  TraceContext.instance.setContextKey(key);\n}\n\n/** Generate a UUID v4 trace ID. */\nexport function generateTraceId(): string {\n  return TraceContext.instance.generate();\n}\n\n/**\n * Get the current trace ID from async context.\n * Returns `undefined` when called outside a traced request.\n */\nexport function getCurrentTraceId(): string | undefined {\n  return TraceContext.instance.getCurrentTraceId();\n}\n\n/**\n * Set trace ID in the CURRENT async context without starting a new one.\n *\n * ⚠️  DEPRECATED — unsafe for concurrent requests.\n *\n * Uses `AsyncLocalStorage.enterWith()`, which mutates the current async\n * execution context and every Promise chain spawned from it. Under load this\n * can cause a trace ID from one request to bleed into others sharing the same\n * async parent.\n *\n * Use {@link runWithTraceId} instead. Migration patterns:\n *\n * **Express / Fastify middleware — before:**\n * ```ts\n * app.use((req, _res, next) => {\n *   setTraceId(req.headers['x-trace-id'] ?? generateTraceId());\n *   next();\n * });\n * ```\n * **after:**\n * ```ts\n * app.use((req, _res, next) => {\n *   runWithTraceId(req.headers['x-trace-id'] ?? generateTraceId(), () => next());\n * });\n * ```\n *\n * **Kafka / queue consumer — before:**\n * ```ts\n * async function handle(msg) {\n *   setTraceId(msg.headers['x-trace-id']);\n *   await processMessage(msg);\n * }\n * ```\n * **after:**\n * ```ts\n * async function handle(msg) {\n *   await runWithTraceId(msg.headers['x-trace-id'], () => processMessage(msg));\n * }\n * ```\n *\n * **Background job — before:**\n * ```ts\n * setTraceId(generateTraceId(), { jobId: job.id });\n * await job.run();\n * ```\n * **after:**\n * ```ts\n * await runWithTraceId(generateTraceId(), () => job.run(), { jobId: job.id });\n * ```\n *\n * @deprecated Use `runWithTraceId(traceId, fn)` — do not call `setTraceId`\n *             from request-handling code.\n */\nexport function setTraceId(traceId: string, data?: Record<string, unknown>): void {\n  TraceContext.instance.setTraceId(traceId, data);\n}\n\n/** Run `fn` inside a new async context carrying `traceId`. */\nexport function runWithTraceId<T>(traceId: string, fn: () => T, data?: Record<string, unknown>): T {\n  return TraceContext.instance.run(traceId, fn, data);\n}\n\n// ── Request extraction ────────────────────────────────────────────────────────\n\n/** Shape that extractTraceId accepts (Express-compatible) */\ninterface RequestLike {\n  headers?: Record<string, string | string[] | undefined>;\n  query?: Record<string, string | string[] | undefined>;\n  body?: Record<string, string | undefined>;\n  params?: Record<string, string | undefined>;\n}\n\n/** Maximum accepted length for an incoming trace / correlation / request ID. */\nexport const MAX_INCOMING_ID_LENGTH = 128;\n\nconst SAFE_INCOMING_ID = /^[A-Za-z0-9._:-]{1,128}$/;\n\n/**\n * Validate an externally supplied identifier (trace ID, correlation ID, origin\n * service name, message-queue ID). Accepts only 1-128 characters from\n * `[A-Za-z0-9._:-]`; surrounding whitespace is trimmed first. Arrays use their\n * first element. Returns the cleaned value, or `undefined` when it is unusable\n * so callers can generate a fresh ID instead of passing client text through.\n */\nexport function sanitizeIncomingId(value: unknown): string | undefined {\n  const first = Array.isArray(value) ? value[0] : value;\n  if (typeof first !== 'string' || first.length > MAX_INCOMING_ID_LENGTH * 2) return undefined;\n  const trimmed = first.trim();\n  return SAFE_INCOMING_ID.test(trimmed) ? trimmed : undefined;\n}\n\n/** W3C trace-context: `version-traceId(32hex)-spanId(16hex)-flags(2hex)`. */\nconst W3C_TRACEPARENT_RE = /^[\\da-f]{2}-([\\da-f]{32})-[\\da-f]{16}-[\\da-f]{2}$/i;\n\n/**\n * Extract the 32-hex trace-id segment from a W3C `traceparent` header value.\n * Returns the parsed trace ID, or the original value unchanged when it is not a\n * well-formed traceparent (so non-W3C propagation still works).\n */\nfunction parseTraceparent(value: string): string {\n  const m = W3C_TRACEPARENT_RE.exec(value);\n  return m ? m[1]! : value;\n}\n\n/** Extract trace ID from request using configuration (header → query → body → params). */\nexport function extractTraceId(\n  request: unknown,\n  config: TraceIdExtractorConfig\n): string | undefined {\n  const req = request as RequestLike;\n\n  if (config.header) {\n    const headers = Array.isArray(config.header) ? config.header : [config.header];\n    for (const header of headers) {\n      const lower = header.toLowerCase();\n      const value = sanitizeIncomingId(req.headers?.[lower]);\n      if (value) return lower === 'traceparent' ? parseTraceparent(value) : value;\n    }\n  }\n\n  if (config.query) {\n    const queries = Array.isArray(config.query) ? config.query : [config.query];\n    for (const query of queries) {\n      const value = sanitizeIncomingId(req.query?.[query]);\n      if (value) return value;\n    }\n  }\n\n  if (config.body) {\n    const bodyFields = Array.isArray(config.body) ? config.body : [config.body];\n    for (const field of bodyFields) {\n      const value = sanitizeIncomingId(req.body?.[field]);\n      if (value) return value;\n    }\n  }\n\n  if (config.params) {\n    const paramFields = Array.isArray(config.params) ? config.params : [config.params];\n    for (const param of paramFields) {\n      const value = sanitizeIncomingId(req.params?.[param]);\n      if (value) return value;\n    }\n  }\n\n  return undefined;\n}\n\n/**\n * Default headers checked for incoming trace ID propagation, in priority order:\n *   traceparent (W3C/OTel) → x-trace-id → x-request-id → x-correlation-id → trace-id\n */\nexport const DEFAULT_TRACE_HEADERS = [\n  'traceparent',\n  'x-trace-id',\n  'x-request-id',\n  'x-correlation-id',\n  'trace-id',\n];\n\n/**\n * Create trace ID middleware for Express/NestJS\n */\nexport function createTraceMiddleware(config: TraceIdConfig) {\n  const defaultExtractor = {\n    header: DEFAULT_TRACE_HEADERS,\n    query: ['traceId', 'trace_id'],\n  };\n  const resolvedConfig: TraceIdConfig = {\n    ...config,\n    extractor: config?.extractor ? { ...defaultExtractor, ...config.extractor } : defaultExtractor,\n  };\n\n  _setActiveContextKey(resolvedConfig.contextKey ?? TRACE_CONTEXT_KEY);\n\n  return (req: unknown, res: unknown, next: () => void) => {\n    let traceId: string | undefined;\n\n    if (resolvedConfig.extractor) {\n      traceId = extractTraceId(req, resolvedConfig.extractor);\n    }\n\n    if (!traceId) {\n      traceId = resolvedConfig.generator ? resolvedConfig.generator() : generateTraceId();\n    }\n\n    (req as Record<string, unknown>).traceId = traceId;\n    // Echo the trace ID back on the response, tolerating different response APIs:\n    // Express/Node use res.setHeader(), Fastify replies use reply.header(). Guard\n    // both and never let a missing/!function method (or already-sent headers)\n    // crash the request — the trace ID is still propagated via async context.\n    const resObj = res as {\n      setHeader?: (k: string, v: string) => void;\n      header?: (k: string, v: string) => void;\n      headersSent?: boolean;\n    };\n    if (!resObj.headersSent) {\n      try {\n        if (typeof resObj.setHeader === 'function') {\n          resObj.setHeader('X-Trace-Id', traceId);\n        } else if (typeof resObj.header === 'function') {\n          resObj.header('X-Trace-Id', traceId);\n        }\n      } catch {\n        /* response not in a header-settable state — context propagation still works */\n      }\n    }\n\n    runWithTraceId(traceId, () => next());\n  };\n}\n"],"mappings":"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"}