evlog 2.16.0 → 2.17.0

package/dist/{fork-DPN8aL8O.mjs.map → fork-8u_zFOJq.mjs.map}

@@ -1 +1 @@
-{"version":3,"file":"fork-DPN8aL8O.mjs","names":[],"sources":["../src/shared/middleware.ts","../src/shared/fork.ts"],"sourcesContent":["import type { DrainContext, EnrichContext, RedactConfig, RequestLogger, RouteConfig, TailSamplingContext, WideEvent } from '../types'\nimport { createRequestLogger, getGlobalDrain, getGlobalPluginRunner, isEnabled, shouldKeep } from '../logger'\nimport { redactEvent, resolveRedactConfig } from '../redact'\nimport { extractErrorStatus } from './errors'\nimport type { EvlogPlugin, PluginRunner } from './plugin'\nimport { createPluginRunner, getEmptyPluginRunner } from './plugin'\nimport { shouldLog, getServiceForPath } from './routes'\n\n/**\n * Base options shared by every framework integration. Re-exported via\n * `evlog/toolkit` so custom integrations can extend it.\n */\nexport interface BaseEvlogOptions {\n  /** Route glob patterns to include. If unset, all routes are logged. */\n  include?: string[]\n  /** Route glob patterns to exclude. Takes precedence over `include`. */\n  exclude?: string[]\n  /** Per-route service overrides. */\n  routes?: Record<string, RouteConfig>\n  /** Drain callback invoked with every emitted event. */\n  drain?: (ctx: DrainContext) => void | Promise<void>\n  /** Enrich callback invoked after emit, before drain. */\n  enrich?: (ctx: EnrichContext) => void | Promise<void>\n  /** Tail sampling callback. Set `ctx.shouldKeep = true` to force-keep. */\n  keep?: (ctx: TailSamplingContext) => void | Promise<void>\n  /**\n   * PII auto-redaction. `true` enables built-in patterns; pass an object for\n   * fine-grained control. Applied before enrich/drain.\n   */\n  redact?: boolean | RedactConfig\n  /** Plugins for this middleware, merged with globally-registered ones. */\n  plugins?: EvlogPlugin[]\n}\n\n/** Internal options accepted by `createMiddlewareLogger`. */\nexport interface MiddlewareLoggerOptions extends BaseEvlogOptions {\n  method: string\n  path: string\n  requestId?: string\n  /** Pre-filtered safe request headers used for enrich/drain context. */\n  headers?: Record<string, string>\n}\n\nexport interface MiddlewareLoggerResult {\n  logger: RequestLogger\n  finish: (opts?: { status?: number; error?: Error }) => Promise<WideEvent | null>\n  skipped: boolean\n}\n\nconst noopResult: MiddlewareLoggerResult = {\n  logger: {\n    set() {},\n    error() {},\n    info() {},\n    warn() {},\n    emit() {\n      return null \n    },\n    getContext() {\n      return {} \n    },\n  },\n  finish: () => Promise.resolve(null),\n  skipped: true,\n}\n\n// Memoizes the merged runner per local plugins array (stable across requests\n// because it lives in the middleware factory closure). Invalidated when\n// `initLogger` swaps the global runner, so the merge cost is paid once.\nconst runnerCache = new WeakMap<EvlogPlugin[], { global: PluginRunner; merged: PluginRunner }>()\n\n/**\n * Resolve the plugin runner for a middleware invocation by merging local\n * plugins with the globally-registered ones (deduplicated by `name`).\n */\nexport function resolveMiddlewarePluginRunner(options: { plugins?: EvlogPlugin[] }): PluginRunner {\n  const global = getGlobalPluginRunner()\n  const local = options.plugins\n  if (!local || local.length === 0) return global\n\n  const cached = runnerCache.get(local)\n  if (cached && cached.global === global) return cached.merged\n\n  const merged = new Map<string, EvlogPlugin>()\n  for (const plugin of global.plugins) merged.set(plugin.name, plugin)\n  for (const plugin of local) merged.set(plugin.name, plugin)\n  if (merged.size === 0) return getEmptyPluginRunner()\n\n  const runner = createPluginRunner(Array.from(merged.values()))\n  runnerCache.set(local, { global, merged: runner })\n  return runner\n}\n\n/**\n * Apply redact, enrich, and drain to an emitted wide event — the same\n * pipeline used by {@link createMiddlewareLogger}'s `finish`.\n */\n// eslint-disable-next-line max-params\nexport async function runEnrichAndDrain(\n  emittedEvent: WideEvent,\n  options: MiddlewareLoggerOptions,\n  requestInfo: { method: string; path: string; requestId?: string },\n  responseStatus?: number,\n  plugins?: PluginRunner,\n): Promise<void> {\n  const runner = plugins ?? resolveMiddlewarePluginRunner(options)\n  const resolvedRedact = resolveRedactConfig(options.redact)\n  if (resolvedRedact) {\n    redactEvent(emittedEvent, resolvedRedact)\n  }\n\n  if (options.enrich || runner.hasEnrich) {\n    const enrichCtx: EnrichContext = {\n      event: emittedEvent,\n      request: requestInfo,\n      headers: options.headers,\n      response: { status: responseStatus },\n    }\n    if (options.enrich) {\n      try {\n        await options.enrich(enrichCtx)\n      } catch (err) {\n        console.error('[evlog] enrich failed:', err)\n      }\n    }\n    if (runner.hasEnrich) {\n      await runner.runEnrich(enrichCtx)\n    }\n  }\n\n  const drain = options.drain ?? getGlobalDrain()\n  const hasUserDrain = !!drain\n  const hasPluginDrain = runner.hasDrain\n  if (hasUserDrain || hasPluginDrain) {\n    const drainCtx: DrainContext = {\n      event: emittedEvent,\n      request: requestInfo,\n      headers: options.headers,\n    }\n    const tasks: Array<Promise<unknown>> = []\n    if (hasUserDrain) {\n      tasks.push(\n        (async () => {\n          try {\n            await drain!(drainCtx)\n          } catch (err) {\n            console.error('[evlog] drain failed:', err)\n          }\n        })(),\n      )\n    }\n    if (hasPluginDrain) {\n      tasks.push(runner.runDrain(drainCtx))\n    }\n    await Promise.all(tasks)\n  }\n}\n\n/**\n * Create a request logger with the full middleware pipeline: route filtering,\n * service overrides, duration tracking, tail sampling, emit, enrich, drain.\n *\n * Framework adapters extract method/path/requestId/headers, call this once\n * per request, and call `finish({ status | error })` when the response ends.\n * If `skipped` is `true`, the route was filtered out — bypass logging.\n */\nexport function createMiddlewareLogger(options: MiddlewareLoggerOptions): MiddlewareLoggerResult {\n  if (!isEnabled()) return noopResult\n\n  const { method, path, requestId, include, exclude, routes, keep } = options\n\n  if (!shouldLog(path, include, exclude)) {\n    return noopResult\n  }\n\n  const resolvedRequestId = requestId || crypto.randomUUID()\n\n  const logger = createRequestLogger({\n    method,\n    path,\n    requestId: resolvedRequestId,\n  }, { _deferDrain: true })\n\n  const routeService = getServiceForPath(path, routes)\n  if (routeService) {\n    logger.set({ service: routeService })\n  }\n\n  const pluginRunner = resolveMiddlewarePluginRunner(options)\n  if (pluginRunner.hasExtendLogger) {\n    pluginRunner.applyExtendLogger(logger)\n  }\n\n  const startTime = Date.now()\n  const requestInfo = { method, path, requestId: resolvedRequestId }\n\n  if (pluginRunner.hasRequestLifecycle) {\n    pluginRunner.runOnRequestStart({\n      logger,\n      request: requestInfo,\n      headers: options.headers,\n    })\n  }\n\n  const finish = async (opts?: { status?: number; error?: Error }): Promise<WideEvent | null> => {\n    const { status, error } = opts ?? {}\n\n    if (error) {\n      logger.error(error)\n      const errorStatus = extractErrorStatus(error)\n      logger.set({ status: errorStatus })\n    } else if (status !== undefined) {\n      logger.set({ status })\n    }\n\n    const durationMs = Date.now() - startTime\n\n    const resolvedStatus = error\n      ? extractErrorStatus(error)\n      : status ?? (logger.getContext().status as number | undefined)\n\n    const tailCtx: TailSamplingContext = {\n      status: resolvedStatus,\n      duration: durationMs,\n      path,\n      method,\n      context: logger.getContext(),\n      shouldKeep: false,\n    }\n\n    if (keep) {\n      await keep(tailCtx)\n    }\n    if (pluginRunner.hasKeep) {\n      await pluginRunner.runKeep(tailCtx)\n    }\n\n    const forceKeep = tailCtx.shouldKeep || shouldKeep(tailCtx)\n    const emittedEvent = logger.emit({ _forceKeep: forceKeep })\n\n    if (\n      emittedEvent\n      && (options.enrich || options.drain || pluginRunner.hasEnrich || pluginRunner.hasDrain || getGlobalDrain())\n    ) {\n      await runEnrichAndDrain(emittedEvent, options, requestInfo, resolvedStatus, pluginRunner)\n    }\n\n    if (pluginRunner.hasRequestLifecycle) {\n      pluginRunner.runOnRequestFinish({\n        logger,\n        request: requestInfo,\n        headers: options.headers,\n        event: emittedEvent,\n        status: resolvedStatus,\n        durationMs,\n        error,\n      })\n    }\n\n    return emittedEvent\n  }\n\n  return { logger, finish, skipped: false }\n}\n","import type { AsyncLocalStorage } from 'node:async_hooks'\nimport type { RequestLogger } from '../types'\nimport { createRequestLogger, getGlobalDrain } from '../logger'\nimport { extractErrorStatus } from './errors'\nimport type { MiddlewareLoggerOptions } from './middleware'\nimport { runEnrichAndDrain } from './middleware'\n\n/**\n * Optional hooks for integrations that track active loggers (e.g. Elysia `activeLoggers`).\n */\nexport interface ForkLifecycle {\n  /** Called after the child logger is installed in storage, before `fn` runs. */\n  onChildEnter?: (child: RequestLogger) => void\n  /** Called after the child has finished (emit + enrich/drain), success or failure. */\n  onChildExit?: (child: RequestLogger) => void\n}\n\n/**\n * Options for {@link forkBackgroundLogger}.\n *\n * @beta Part of `evlog/toolkit`\n */\nexport interface ForkBackgroundLoggerOptions {\n  storage: AsyncLocalStorage<RequestLogger>\n  parent: RequestLogger\n  middlewareOptions: MiddlewareLoggerOptions\n  label: string\n  fn: () => void | Promise<void>\n  lifecycle?: ForkLifecycle\n}\n\n/**\n * Attach {@link RequestLogger.fork} to a request logger. Replaces any existing `fork`.\n */\nexport function attachForkToLogger(\n  storage: AsyncLocalStorage<RequestLogger>,\n  parent: RequestLogger,\n  middlewareOptions: MiddlewareLoggerOptions,\n  lifecycle?: ForkLifecycle,\n): void {\n  const log = parent as RequestLogger & { fork?: (label: string, fn: () => void | Promise<void>) => void }\n  log.fork = (label: string, fn: () => void | Promise<void>) => {\n    forkBackgroundLogger({ storage, parent, middlewareOptions, label, fn, lifecycle })\n  }\n}\n\n/**\n * Run background work under a child request logger so `useLogger()` resolves to the\n * child while `fn` runs. The child emits a separate wide event when `fn` settles,\n * with `operation` and `_parentRequestId` set for correlation.\n *\n * @beta Part of `evlog/toolkit` — used by framework integrations; prefer `log.fork()`\n * on the request logger when available.\n */\nexport function forkBackgroundLogger(options: ForkBackgroundLoggerOptions): void {\n  const { storage, parent, middlewareOptions, label, fn, lifecycle } = options\n\n  const parentCtx = parent.getContext() as Record<string, unknown>\n  const parentRequestId = parentCtx.requestId\n  if (typeof parentRequestId !== 'string' || parentRequestId.length === 0) {\n    throw new Error(\n      '[evlog] log.fork() requires the parent logger to have a requestId. '\n      + 'Ensure the request was created by evlog middleware.',\n    )\n  }\n\n  const method = String(parentCtx.method ?? middlewareOptions.method)\n  const path = String(parentCtx.path ?? middlewareOptions.path)\n\n  const child = createRequestLogger(\n    {\n      method,\n      path,\n      requestId: crypto.randomUUID(),\n    },\n    { _deferDrain: true },\n  )\n\n  child.set({\n    operation: label,\n    _parentRequestId: parentRequestId,\n  })\n\n  const childRequestInfo = {\n    method,\n    path,\n    requestId: child.getContext().requestId as string,\n  }\n\n  storage.run(child, () => {\n    lifecycle?.onChildEnter?.(child)\n    void Promise.resolve()\n      .then(() => fn())\n      .then(async () => {\n        const emittedEvent = child.emit()\n        const ctxStatus = child.getContext().status\n        const status = (emittedEvent?.status\n          ?? (typeof ctxStatus === 'number' ? ctxStatus : undefined)) as number | undefined\n        if (\n          emittedEvent\n          && (middlewareOptions.enrich || middlewareOptions.drain || getGlobalDrain())\n        ) {\n          await runEnrichAndDrain(emittedEvent, middlewareOptions, childRequestInfo, status)\n        }\n      })\n      .catch(async (err: unknown) => {\n        const error = err instanceof Error ? err : new Error(String(err))\n        child.error(error)\n        child.set({ status: extractErrorStatus(error) })\n        const emittedEvent = child.emit()\n        const status = extractErrorStatus(error)\n        if (\n          emittedEvent\n          && (middlewareOptions.enrich || middlewareOptions.drain || getGlobalDrain())\n        ) {\n          await runEnrichAndDrain(emittedEvent, middlewareOptions, childRequestInfo, status)\n        }\n      })\n      .finally(() => {\n        lifecycle?.onChildExit?.(child)\n      })\n  })\n}\n"],"mappings":";;;;AAiDA,MAAM,aAAqC;CACzC,QAAQ;EACN,MAAM;EACN,QAAQ;EACR,OAAO;EACP,OAAO;EACP,OAAO;AACL,UAAO;;EAET,aAAa;AACX,UAAO,EAAE;;EAEZ;CACD,cAAc,QAAQ,QAAQ,KAAK;CACnC,SAAS;CACV;AAKD,MAAM,8BAAc,IAAI,SAAwE;;;;;AAMhG,SAAgB,8BAA8B,SAAoD;CAChG,MAAM,SAAS,uBAAuB;CACtC,MAAM,QAAQ,QAAQ;AACtB,KAAI,CAAC,SAAS,MAAM,WAAW,EAAG,QAAO;CAEzC,MAAM,SAAS,YAAY,IAAI,MAAM;AACrC,KAAI,UAAU,OAAO,WAAW,OAAQ,QAAO,OAAO;CAEtD,MAAM,yBAAS,IAAI,KAA0B;AAC7C,MAAK,MAAM,UAAU,OAAO,QAAS,QAAO,IAAI,OAAO,MAAM,OAAO;AACpE,MAAK,MAAM,UAAU,MAAO,QAAO,IAAI,OAAO,MAAM,OAAO;AAC3D,KAAI,OAAO,SAAS,EAAG,QAAO,sBAAsB;CAEpD,MAAM,SAAS,mBAAmB,MAAM,KAAK,OAAO,QAAQ,CAAC,CAAC;AAC9D,aAAY,IAAI,OAAO;EAAE;EAAQ,QAAQ;EAAQ,CAAC;AAClD,QAAO;;;;;;AAQT,eAAsB,kBACpB,cACA,SACA,aACA,gBACA,SACe;CACf,MAAM,SAAS,WAAW,8BAA8B,QAAQ;CAChE,MAAM,iBAAiB,oBAAoB,QAAQ,OAAO;AAC1D,KAAI,eACF,aAAY,cAAc,eAAe;AAG3C,KAAI,QAAQ,UAAU,OAAO,WAAW;EACtC,MAAM,YAA2B;GAC/B,OAAO;GACP,SAAS;GACT,SAAS,QAAQ;GACjB,UAAU,EAAE,QAAQ,gBAAgB;GACrC;AACD,MAAI,QAAQ,OACV,KAAI;AACF,SAAM,QAAQ,OAAO,UAAU;WACxB,KAAK;AACZ,WAAQ,MAAM,0BAA0B,IAAI;;AAGhD,MAAI,OAAO,UACT,OAAM,OAAO,UAAU,UAAU;;CAIrC,MAAM,QAAQ,QAAQ,SAAS,gBAAgB;CAC/C,MAAM,eAAe,CAAC,CAAC;CACvB,MAAM,iBAAiB,OAAO;AAC9B,KAAI,gBAAgB,gBAAgB;EAClC,MAAM,WAAyB;GAC7B,OAAO;GACP,SAAS;GACT,SAAS,QAAQ;GAClB;EACD,MAAM,QAAiC,EAAE;AACzC,MAAI,aACF,OAAM,MACH,YAAY;AACX,OAAI;AACF,UAAM,MAAO,SAAS;YACf,KAAK;AACZ,YAAQ,MAAM,yBAAyB,IAAI;;MAE3C,CACL;AAEH,MAAI,eACF,OAAM,KAAK,OAAO,SAAS,SAAS,CAAC;AAEvC,QAAM,QAAQ,IAAI,MAAM;;;;;;;;;;;AAY5B,SAAgB,uBAAuB,SAA0D;AAC/F,KAAI,CAAC,WAAW,CAAE,QAAO;CAEzB,MAAM,EAAE,QAAQ,MAAM,WAAW,SAAS,SAAS,QAAQ,SAAS;AAEpE,KAAI,CAAC,UAAU,MAAM,SAAS,QAAQ,CACpC,QAAO;CAGT,MAAM,oBAAoB,aAAa,OAAO,YAAY;CAE1D,MAAM,SAAS,oBAAoB;EACjC;EACA;EACA,WAAW;EACZ,EAAE,EAAE,aAAa,MAAM,CAAC;CAEzB,MAAM,eAAe,kBAAkB,MAAM,OAAO;AACpD,KAAI,aACF,QAAO,IAAI,EAAE,SAAS,cAAc,CAAC;CAGvC,MAAM,eAAe,8BAA8B,QAAQ;AAC3D,KAAI,aAAa,gBACf,cAAa,kBAAkB,OAAO;CAGxC,MAAM,YAAY,KAAK,KAAK;CAC5B,MAAM,cAAc;EAAE;EAAQ;EAAM,WAAW;EAAmB;AAElE,KAAI,aAAa,oBACf,cAAa,kBAAkB;EAC7B;EACA,SAAS;EACT,SAAS,QAAQ;EAClB,CAAC;CAGJ,MAAM,SAAS,OAAO,SAAyE;EAC7F,MAAM,EAAE,QAAQ,UAAU,QAAQ,EAAE;AAEpC,MAAI,OAAO;AACT,UAAO,MAAM,MAAM;GACnB,MAAM,cAAc,mBAAmB,MAAM;AAC7C,UAAO,IAAI,EAAE,QAAQ,aAAa,CAAC;aAC1B,WAAW,KAAA,EACpB,QAAO,IAAI,EAAE,QAAQ,CAAC;EAGxB,MAAM,aAAa,KAAK,KAAK,GAAG;EAEhC,MAAM,iBAAiB,QACnB,mBAAmB,MAAM,GACzB,UAAW,OAAO,YAAY,CAAC;EAEnC,MAAM,UAA+B;GACnC,QAAQ;GACR,UAAU;GACV;GACA;GACA,SAAS,OAAO,YAAY;GAC5B,YAAY;GACb;AAED,MAAI,KACF,OAAM,KAAK,QAAQ;AAErB,MAAI,aAAa,QACf,OAAM,aAAa,QAAQ,QAAQ;EAGrC,MAAM,YAAY,QAAQ,cAAc,WAAW,QAAQ;EAC3D,MAAM,eAAe,OAAO,KAAK,EAAE,YAAY,WAAW,CAAC;AAE3D,MACE,iBACI,QAAQ,UAAU,QAAQ,SAAS,aAAa,aAAa,aAAa,YAAY,gBAAgB,EAE1G,OAAM,kBAAkB,cAAc,SAAS,aAAa,gBAAgB,aAAa;AAG3F,MAAI,aAAa,oBACf,cAAa,mBAAmB;GAC9B;GACA,SAAS;GACT,SAAS,QAAQ;GACjB,OAAO;GACP,QAAQ;GACR;GACA;GACD,CAAC;AAGJ,SAAO;;AAGT,QAAO;EAAE;EAAQ;EAAQ,SAAS;EAAO;;;;;;;ACpO3C,SAAgB,mBACd,SACA,QACA,mBACA,WACM;CACN,MAAM,MAAM;AACZ,KAAI,QAAQ,OAAe,OAAmC;AAC5D,uBAAqB;GAAE;GAAS;GAAQ;GAAmB;GAAO;GAAI;GAAW,CAAC;;;;;;;;;;;AAYtF,SAAgB,qBAAqB,SAA4C;CAC/E,MAAM,EAAE,SAAS,QAAQ,mBAAmB,OAAO,IAAI,cAAc;CAErE,MAAM,YAAY,OAAO,YAAY;CACrC,MAAM,kBAAkB,UAAU;AAClC,KAAI,OAAO,oBAAoB,YAAY,gBAAgB,WAAW,EACpE,OAAM,IAAI,MACR,yHAED;CAGH,MAAM,SAAS,OAAO,UAAU,UAAU,kBAAkB,OAAO;CACnE,MAAM,OAAO,OAAO,UAAU,QAAQ,kBAAkB,KAAK;CAE7D,MAAM,QAAQ,oBACZ;EACE;EACA;EACA,WAAW,OAAO,YAAY;EAC/B,EACD,EAAE,aAAa,MAAM,CACtB;AAED,OAAM,IAAI;EACR,WAAW;EACX,kBAAkB;EACnB,CAAC;CAEF,MAAM,mBAAmB;EACvB;EACA;EACA,WAAW,MAAM,YAAY,CAAC;EAC/B;AAED,SAAQ,IAAI,aAAa;AACvB,aAAW,eAAe,MAAM;AAC3B,UAAQ,SAAS,CACnB,WAAW,IAAI,CAAC,CAChB,KAAK,YAAY;GAChB,MAAM,eAAe,MAAM,MAAM;GACjC,MAAM,YAAY,MAAM,YAAY,CAAC;GACrC,MAAM,SAAU,cAAc,WACxB,OAAO,cAAc,WAAW,YAAY,KAAA;AAClD,OACE,iBACI,kBAAkB,UAAU,kBAAkB,SAAS,gBAAgB,EAE3E,OAAM,kBAAkB,cAAc,mBAAmB,kBAAkB,OAAO;IAEpF,CACD,MAAM,OAAO,QAAiB;GAC7B,MAAM,QAAQ,eAAe,QAAQ,MAAM,IAAI,MAAM,OAAO,IAAI,CAAC;AACjE,SAAM,MAAM,MAAM;AAClB,SAAM,IAAI,EAAE,QAAQ,mBAAmB,MAAM,EAAE,CAAC;GAChD,MAAM,eAAe,MAAM,MAAM;GACjC,MAAM,SAAS,mBAAmB,MAAM;AACxC,OACE,iBACI,kBAAkB,UAAU,kBAAkB,SAAS,gBAAgB,EAE3E,OAAM,kBAAkB,cAAc,mBAAmB,kBAAkB,OAAO;IAEpF,CACD,cAAc;AACb,cAAW,cAAc,MAAM;IAC/B;GACJ"}
+{"version":3,"file":"fork-8u_zFOJq.mjs","names":[],"sources":["../src/shared/middleware.ts","../src/shared/fork.ts"],"sourcesContent":["import type { DrainContext, EnrichContext, RedactConfig, RequestLogger, RouteConfig, TailSamplingContext, WideEvent } from '../types'\nimport { createRequestLogger, getGlobalDrain, getGlobalPluginRunner, isEnabled, shouldKeep } from '../logger'\nimport { redactEvent, resolveRedactConfig } from '../redact'\nimport { extractErrorStatus } from './errors'\nimport type { EvlogPlugin, PluginRunner } from './plugin'\nimport { createPluginRunner, getEmptyPluginRunner } from './plugin'\nimport { shouldLog, getServiceForPath } from './routes'\n\n/**\n * Base options shared by every framework integration. Re-exported via\n * `evlog/toolkit` so custom integrations can extend it.\n */\nexport interface BaseEvlogOptions {\n  /** Route glob patterns to include. If unset, all routes are logged. */\n  include?: string[]\n  /** Route glob patterns to exclude. Takes precedence over `include`. */\n  exclude?: string[]\n  /** Per-route service overrides. */\n  routes?: Record<string, RouteConfig>\n  /** Drain callback invoked with every emitted event. */\n  drain?: (ctx: DrainContext) => void | Promise<void>\n  /** Enrich callback invoked after emit, before drain. */\n  enrich?: (ctx: EnrichContext) => void | Promise<void>\n  /** Tail sampling callback. Set `ctx.shouldKeep = true` to force-keep. */\n  keep?: (ctx: TailSamplingContext) => void | Promise<void>\n  /**\n   * PII auto-redaction. `true` enables built-in patterns; pass an object for\n   * fine-grained control. Applied before enrich/drain.\n   */\n  redact?: boolean | RedactConfig\n  /** Plugins for this middleware, merged with globally-registered ones. */\n  plugins?: EvlogPlugin[]\n}\n\n/** Internal options accepted by `createMiddlewareLogger`. */\nexport interface MiddlewareLoggerOptions extends BaseEvlogOptions {\n  method: string\n  path: string\n  requestId?: string\n  /** Pre-filtered safe request headers used for enrich/drain context. */\n  headers?: Record<string, string>\n}\n\nexport interface MiddlewareLoggerResult {\n  logger: RequestLogger\n  finish: (opts?: { status?: number; error?: Error }) => Promise<WideEvent | null>\n  skipped: boolean\n}\n\nconst noopResult: MiddlewareLoggerResult = {\n  logger: {\n    set() {},\n    error() {},\n    info() {},\n    warn() {},\n    emit() {\n      return null \n    },\n    getContext() {\n      return {} \n    },\n  },\n  finish: () => Promise.resolve(null),\n  skipped: true,\n}\n\n// Memoizes the merged runner per local plugins array (stable across requests\n// because it lives in the middleware factory closure). Invalidated when\n// `initLogger` swaps the global runner, so the merge cost is paid once.\nconst runnerCache = new WeakMap<EvlogPlugin[], { global: PluginRunner; merged: PluginRunner }>()\n\n/**\n * Resolve the plugin runner for a middleware invocation by merging local\n * plugins with the globally-registered ones (deduplicated by `name`).\n */\nexport function resolveMiddlewarePluginRunner(options: { plugins?: EvlogPlugin[] }): PluginRunner {\n  const global = getGlobalPluginRunner()\n  const local = options.plugins\n  if (!local || local.length === 0) return global\n\n  const cached = runnerCache.get(local)\n  if (cached && cached.global === global) return cached.merged\n\n  const merged = new Map<string, EvlogPlugin>()\n  for (const plugin of global.plugins) merged.set(plugin.name, plugin)\n  for (const plugin of local) merged.set(plugin.name, plugin)\n  if (merged.size === 0) return getEmptyPluginRunner()\n\n  const runner = createPluginRunner(Array.from(merged.values()))\n  runnerCache.set(local, { global, merged: runner })\n  return runner\n}\n\n/**\n * Apply redact, enrich, and drain to an emitted wide event — the same\n * pipeline used by {@link createMiddlewareLogger}'s `finish`.\n */\n// eslint-disable-next-line max-params\nexport async function runEnrichAndDrain(\n  emittedEvent: WideEvent,\n  options: MiddlewareLoggerOptions,\n  requestInfo: { method: string; path: string; requestId?: string },\n  responseStatus?: number,\n  plugins?: PluginRunner,\n): Promise<void> {\n  const runner = plugins ?? resolveMiddlewarePluginRunner(options)\n  const resolvedRedact = resolveRedactConfig(options.redact)\n  if (resolvedRedact) {\n    redactEvent(emittedEvent, resolvedRedact)\n  }\n\n  if (options.enrich || runner.hasEnrich) {\n    const enrichCtx: EnrichContext = {\n      event: emittedEvent,\n      request: requestInfo,\n      headers: options.headers,\n      response: { status: responseStatus },\n    }\n    if (options.enrich) {\n      try {\n        await options.enrich(enrichCtx)\n      } catch (err) {\n        console.error('[evlog] enrich failed:', err)\n      }\n    }\n    if (runner.hasEnrich) {\n      await runner.runEnrich(enrichCtx)\n    }\n  }\n\n  const drain = options.drain ?? getGlobalDrain()\n  const hasUserDrain = !!drain\n  const hasPluginDrain = runner.hasDrain\n  if (hasUserDrain || hasPluginDrain) {\n    const drainCtx: DrainContext = {\n      event: emittedEvent,\n      request: requestInfo,\n      headers: options.headers,\n    }\n    const tasks: Array<Promise<unknown>> = []\n    if (hasUserDrain) {\n      tasks.push(\n        (async () => {\n          try {\n            await drain!(drainCtx)\n          } catch (err) {\n            console.error('[evlog] drain failed:', err)\n          }\n        })(),\n      )\n    }\n    if (hasPluginDrain) {\n      tasks.push(runner.runDrain(drainCtx))\n    }\n    await Promise.all(tasks)\n  }\n}\n\n/**\n * Create a request logger with the full middleware pipeline: route filtering,\n * service overrides, duration tracking, tail sampling, emit, enrich, drain.\n *\n * Framework adapters extract method/path/requestId/headers, call this once\n * per request, and call `finish({ status | error })` when the response ends.\n * If `skipped` is `true`, the route was filtered out — bypass logging.\n */\nexport function createMiddlewareLogger(options: MiddlewareLoggerOptions): MiddlewareLoggerResult {\n  if (!isEnabled()) return noopResult\n\n  const { method, path, requestId, include, exclude, routes, keep } = options\n\n  if (!shouldLog(path, include, exclude)) {\n    return noopResult\n  }\n\n  const resolvedRequestId = requestId || crypto.randomUUID()\n\n  const logger = createRequestLogger({\n    method,\n    path,\n    requestId: resolvedRequestId,\n  }, { _deferDrain: true })\n\n  const routeService = getServiceForPath(path, routes)\n  if (routeService) {\n    logger.set({ service: routeService })\n  }\n\n  const pluginRunner = resolveMiddlewarePluginRunner(options)\n  if (pluginRunner.hasExtendLogger) {\n    pluginRunner.applyExtendLogger(logger)\n  }\n\n  const startTime = Date.now()\n  const requestInfo = { method, path, requestId: resolvedRequestId }\n\n  if (pluginRunner.hasRequestLifecycle) {\n    pluginRunner.runOnRequestStart({\n      logger,\n      request: requestInfo,\n      headers: options.headers,\n    })\n  }\n\n  const finish = async (opts?: { status?: number; error?: Error }): Promise<WideEvent | null> => {\n    const { status, error } = opts ?? {}\n\n    if (error) {\n      logger.error(error)\n      const errorStatus = extractErrorStatus(error)\n      logger.set({ status: errorStatus })\n    } else if (status !== undefined) {\n      logger.set({ status })\n    }\n\n    const durationMs = Date.now() - startTime\n\n    const resolvedStatus = error\n      ? extractErrorStatus(error)\n      : status ?? (logger.getContext().status as number | undefined)\n\n    const tailCtx: TailSamplingContext = {\n      status: resolvedStatus,\n      duration: durationMs,\n      path,\n      method,\n      context: logger.getContext(),\n      shouldKeep: false,\n    }\n\n    if (keep) {\n      await keep(tailCtx)\n    }\n    if (pluginRunner.hasKeep) {\n      await pluginRunner.runKeep(tailCtx)\n    }\n\n    const forceKeep = tailCtx.shouldKeep || shouldKeep(tailCtx)\n    const emittedEvent = logger.emit({ _forceKeep: forceKeep })\n\n    if (\n      emittedEvent\n      && (options.enrich || options.drain || pluginRunner.hasEnrich || pluginRunner.hasDrain || getGlobalDrain())\n    ) {\n      await runEnrichAndDrain(emittedEvent, options, requestInfo, resolvedStatus, pluginRunner)\n    }\n\n    if (pluginRunner.hasRequestLifecycle) {\n      pluginRunner.runOnRequestFinish({\n        logger,\n        request: requestInfo,\n        headers: options.headers,\n        event: emittedEvent,\n        status: resolvedStatus,\n        durationMs,\n        error,\n      })\n    }\n\n    return emittedEvent\n  }\n\n  return { logger, finish, skipped: false }\n}\n","import type { AsyncLocalStorage } from 'node:async_hooks'\nimport type { RequestLogger } from '../types'\nimport { createRequestLogger, getGlobalDrain } from '../logger'\nimport { extractErrorStatus } from './errors'\nimport type { MiddlewareLoggerOptions } from './middleware'\nimport { runEnrichAndDrain } from './middleware'\n\n/**\n * Optional hooks for integrations that track active loggers (e.g. Elysia `activeLoggers`).\n */\nexport interface ForkLifecycle {\n  /** Called after the child logger is installed in storage, before `fn` runs. */\n  onChildEnter?: (child: RequestLogger) => void\n  /** Called after the child has finished (emit + enrich/drain), success or failure. */\n  onChildExit?: (child: RequestLogger) => void\n}\n\n/**\n * Options for {@link forkBackgroundLogger}.\n *\n * @beta Part of `evlog/toolkit`\n */\nexport interface ForkBackgroundLoggerOptions {\n  storage: AsyncLocalStorage<RequestLogger>\n  parent: RequestLogger\n  middlewareOptions: MiddlewareLoggerOptions\n  label: string\n  fn: () => void | Promise<void>\n  lifecycle?: ForkLifecycle\n}\n\n/**\n * Attach {@link RequestLogger.fork} to a request logger. Replaces any existing `fork`.\n */\nexport function attachForkToLogger(\n  storage: AsyncLocalStorage<RequestLogger>,\n  parent: RequestLogger,\n  middlewareOptions: MiddlewareLoggerOptions,\n  lifecycle?: ForkLifecycle,\n): void {\n  const log = parent as RequestLogger & { fork?: (label: string, fn: () => void | Promise<void>) => void }\n  log.fork = (label: string, fn: () => void | Promise<void>) => {\n    forkBackgroundLogger({ storage, parent, middlewareOptions, label, fn, lifecycle })\n  }\n}\n\n/**\n * Run background work under a child request logger so `useLogger()` resolves to the\n * child while `fn` runs. The child emits a separate wide event when `fn` settles,\n * with `operation` and `_parentRequestId` set for correlation.\n *\n * @beta Part of `evlog/toolkit` — used by framework integrations; prefer `log.fork()`\n * on the request logger when available.\n */\nexport function forkBackgroundLogger(options: ForkBackgroundLoggerOptions): void {\n  const { storage, parent, middlewareOptions, label, fn, lifecycle } = options\n\n  const parentCtx = parent.getContext() as Record<string, unknown>\n  const parentRequestId = parentCtx.requestId\n  if (typeof parentRequestId !== 'string' || parentRequestId.length === 0) {\n    throw new Error(\n      '[evlog] log.fork() requires the parent logger to have a requestId. '\n      + 'Ensure the request was created by evlog middleware.',\n    )\n  }\n\n  const method = String(parentCtx.method ?? middlewareOptions.method)\n  const path = String(parentCtx.path ?? middlewareOptions.path)\n\n  const child = createRequestLogger(\n    {\n      method,\n      path,\n      requestId: crypto.randomUUID(),\n    },\n    { _deferDrain: true },\n  )\n\n  child.set({\n    operation: label,\n    _parentRequestId: parentRequestId,\n  })\n\n  const childRequestInfo = {\n    method,\n    path,\n    requestId: child.getContext().requestId as string,\n  }\n\n  storage.run(child, () => {\n    lifecycle?.onChildEnter?.(child)\n    void Promise.resolve()\n      .then(() => fn())\n      .then(async () => {\n        const emittedEvent = child.emit()\n        const ctxStatus = child.getContext().status\n        const status = (emittedEvent?.status\n          ?? (typeof ctxStatus === 'number' ? ctxStatus : undefined)) as number | undefined\n        if (\n          emittedEvent\n          && (middlewareOptions.enrich || middlewareOptions.drain || getGlobalDrain())\n        ) {\n          await runEnrichAndDrain(emittedEvent, middlewareOptions, childRequestInfo, status)\n        }\n      })\n      .catch(async (err: unknown) => {\n        const error = err instanceof Error ? err : new Error(String(err))\n        child.error(error)\n        child.set({ status: extractErrorStatus(error) })\n        const emittedEvent = child.emit()\n        const status = extractErrorStatus(error)\n        if (\n          emittedEvent\n          && (middlewareOptions.enrich || middlewareOptions.drain || getGlobalDrain())\n        ) {\n          await runEnrichAndDrain(emittedEvent, middlewareOptions, childRequestInfo, status)\n        }\n      })\n      .finally(() => {\n        lifecycle?.onChildExit?.(child)\n      })\n  })\n}\n"],"mappings":"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"}

package/dist/hono/index.d.mts

@@ -1,5 +1,5 @@
-import { Y as RequestLogger } from "../audit-X1uUukm3.mjs";
-import { t as BaseEvlogOptions } from "../middleware-CAQHJRN1.mjs";
+import { $ as RequestLogger } from "../audit-CC8nfazi.mjs";
+import { t as BaseEvlogOptions } from "../middleware-U-lIAzHg.mjs";
 import { MiddlewareHandler } from "hono";
 
 //#region src/hono/index.d.ts

package/dist/hono/index.mjs

@@ -1,4 +1,4 @@
-import { t as defineFrameworkIntegration } from "../integration-DSZPbI9N.mjs";
+import { t as defineFrameworkIntegration } from "../integration-DTZtjSqh.mjs";
 //#region src/hono/index.ts
 const integration = defineFrameworkIntegration({
 	name: "hono",

package/dist/http-6umVAKDW.mjs

@@ -0,0 +1,82 @@
+import { n as version } from "./package-v_MmOZeA.mjs";
+//#region src/shared/http.ts
+/**
+* Minimal HTTP transport for drain adapters: abort-based timeouts, exponential
+* backoff on `5xx` / network errors, response bodies truncated in error messages.
+*
+* Identifies every outgoing request as coming from evlog via:
+* - `User-Agent: evlog/<version>` (Node / server runtimes only — browsers strip this)
+* - `X-Evlog-Source: <source>` when {@link HttpPostOptions.source} is set
+*/
+/** Build-time evlog package version, e.g. `2.16.0`. */
+const EVLOG_VERSION = version;
+/** Default `User-Agent` value injected into outgoing drain requests. */
+const EVLOG_USER_AGENT = `evlog/${EVLOG_VERSION}`;
+function hasHeader(headers, target) {
+	const lower = target.toLowerCase();
+	for (const key of Object.keys(headers)) if (key.toLowerCase() === lower) return true;
+	return false;
+}
+/**
+* Returns a copy of `headers` with evlog identity headers injected when
+* absent. Caller-provided values always win.
+*
+* @internal Exposed for tests. Use {@link httpPost} from drains.
+*/
+function withEvlogIdentityHeaders(headers, { userAgent, source } = {}) {
+	const out = { ...headers };
+	if (userAgent !== false && !hasHeader(out, "user-agent")) out["User-Agent"] = typeof userAgent === "string" && userAgent.length > 0 ? userAgent : EVLOG_USER_AGENT;
+	if (source && !hasHeader(out, "x-evlog-source")) out["X-Evlog-Source"] = source;
+	return out;
+}
+function isRetryable(error) {
+	if (error instanceof DOMException && error.name === "AbortError") return true;
+	if (error instanceof TypeError) return true;
+	if (error instanceof Error) {
+		const match = error.message.match(/API error: (\d+)/);
+		if (match) return Number.parseInt(match[1]) >= 500;
+	}
+	return false;
+}
+/**
+* POST a body with timeout + retry. Throws label-prefixed errors with a
+* truncated response body. Safe to call from any drain `send()`.
+*/
+async function httpPost({ url, headers, body, timeout, label, retries = 2, userAgent, source }) {
+	const normalizedRetries = Number.isFinite(retries) && retries >= 0 ? Math.floor(retries) : 2;
+	const finalHeaders = withEvlogIdentityHeaders(headers, {
+		userAgent,
+		source
+	});
+	let lastError;
+	for (let attempt = 0; attempt <= normalizedRetries; attempt++) {
+		const controller = new AbortController();
+		const timeoutId = setTimeout(() => controller.abort(), timeout);
+		try {
+			const response = await fetch(url, {
+				method: "POST",
+				headers: finalHeaders,
+				body,
+				signal: controller.signal
+			});
+			if (!response.ok) {
+				const text = await response.text().catch(() => "Unknown error");
+				const safeText = text.length > 200 ? `${text.slice(0, 200)}...[truncated]` : text;
+				throw new Error(`${label} API error: ${response.status} ${response.statusText} - ${safeText}`);
+			}
+			clearTimeout(timeoutId);
+			return;
+		} catch (error) {
+			clearTimeout(timeoutId);
+			if (error instanceof DOMException && error.name === "AbortError") lastError = /* @__PURE__ */ new Error(`${label} request timed out after ${timeout}ms`);
+			else lastError = error;
+			if (!isRetryable(error) || attempt === normalizedRetries) throw lastError;
+			await new Promise((r) => setTimeout(r, 200 * 2 ** attempt));
+		}
+	}
+	throw lastError;
+}
+//#endregion
+export { withEvlogIdentityHeaders as i, EVLOG_VERSION as n, httpPost as r, EVLOG_USER_AGENT as t };
+
+//# sourceMappingURL=http-6umVAKDW.mjs.map

package/dist/http-6umVAKDW.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-6umVAKDW.mjs","names":["PKG_VERSION"],"sources":["../src/shared/http.ts"],"sourcesContent":["/**\n * Minimal HTTP transport for drain adapters: abort-based timeouts, exponential\n * backoff on `5xx` / network errors, response bodies truncated in error messages.\n *\n * Identifies every outgoing request as coming from evlog via:\n * - `User-Agent: evlog/<version>` (Node / server runtimes only — browsers strip this)\n * - `X-Evlog-Source: <source>` when {@link HttpPostOptions.source} is set\n */\n\nimport { version as PKG_VERSION } from '../../package.json'\n\n/** Build-time evlog package version, e.g. `2.16.0`. */\nexport const EVLOG_VERSION: string = PKG_VERSION\n\n/** Default `User-Agent` value injected into outgoing drain requests. */\nexport const EVLOG_USER_AGENT = `evlog/${EVLOG_VERSION}`\n\nexport interface HttpPostOptions {\n  url: string\n  /** Caller is responsible for `Content-Type`. */\n  headers: Record<string, string>\n  /** Pre-serialized request body. */\n  body: string\n  /** Abort the request after this many milliseconds. */\n  timeout: number\n  /** Prefix used in error messages. */\n  label: string\n  /**\n   * Retries network errors, aborts, and `5xx` responses with exponential backoff.\n   * @default 2\n   */\n  retries?: number\n  /**\n   * Override the default `User-Agent: evlog/<version>` header. Pass `false` or\n   * an empty string to suppress it entirely (e.g. when the underlying transport\n   * forbids overriding `User-Agent`).\n   */\n  userAgent?: string | false\n  /**\n   * When set, sends `X-Evlog-Source: <source>` so the receiving system can\n   * distinguish evlog traffic from other clients. Typically the adapter name\n   * (`axiom`, `datadog`, ...) or `client` for browser-originated drains.\n   */\n  source?: string\n}\n\nfunction hasHeader(headers: Record<string, string>, target: string): boolean {\n  const lower = target.toLowerCase()\n  for (const key of Object.keys(headers)) {\n    if (key.toLowerCase() === lower) return true\n  }\n  return false\n}\n\n/**\n * Returns a copy of `headers` with evlog identity headers injected when\n * absent. Caller-provided values always win.\n *\n * @internal Exposed for tests. Use {@link httpPost} from drains.\n */\nexport function withEvlogIdentityHeaders(\n  headers: Record<string, string>,\n  { userAgent, source }: { userAgent?: string | false; source?: string } = {},\n): Record<string, string> {\n  const out = { ...headers }\n  if (userAgent !== false && !hasHeader(out, 'user-agent')) {\n    const ua = typeof userAgent === 'string' && userAgent.length > 0 ? userAgent : EVLOG_USER_AGENT\n    out['User-Agent'] = ua\n  }\n  if (source && !hasHeader(out, 'x-evlog-source')) {\n    out['X-Evlog-Source'] = source\n  }\n  return out\n}\n\nfunction isRetryable(error: unknown): boolean {\n  if (error instanceof DOMException && error.name === 'AbortError') return true\n  if (error instanceof TypeError) return true\n  if (error instanceof Error) {\n    const match = error.message.match(/API error: (\\d+)/)\n    if (match) return Number.parseInt(match[1]) >= 500\n  }\n  return false\n}\n\n/**\n * POST a body with timeout + retry. Throws label-prefixed errors with a\n * truncated response body. Safe to call from any drain `send()`.\n */\nexport async function httpPost({ url, headers, body, timeout, label, retries = 2, userAgent, source }: HttpPostOptions): Promise<void> {\n  const normalizedRetries = Number.isFinite(retries) && retries >= 0 ? Math.floor(retries) : 2\n  const finalHeaders = withEvlogIdentityHeaders(headers, { userAgent, source })\n\n  let lastError: Error | undefined\n\n  for (let attempt = 0; attempt <= normalizedRetries; attempt++) {\n    const controller = new AbortController()\n    const timeoutId = setTimeout(() => controller.abort(), timeout)\n\n    try {\n      const response = await fetch(url, {\n        method: 'POST',\n        headers: finalHeaders,\n        body,\n        signal: controller.signal,\n      })\n\n      if (!response.ok) {\n        const text = await response.text().catch(() => 'Unknown error')\n        const safeText = text.length > 200 ? `${text.slice(0, 200)}...[truncated]` : text\n        throw new Error(`${label} API error: ${response.status} ${response.statusText} - ${safeText}`)\n      }\n\n      clearTimeout(timeoutId)\n      return\n    } catch (error) {\n      clearTimeout(timeoutId)\n\n      if (error instanceof DOMException && error.name === 'AbortError') {\n        lastError = new Error(`${label} request timed out after ${timeout}ms`)\n      } else {\n        lastError = error as Error\n      }\n\n      if (!isRetryable(error) || attempt === normalizedRetries) {\n        throw lastError\n      }\n\n      await new Promise<void>(r => setTimeout(r, 200 * 2 ** attempt))\n    }\n  }\n\n  throw lastError!\n}\n"],"mappings":";;;;;;;;;;;AAYA,MAAa,gBAAwBA;;AAGrC,MAAa,mBAAmB,SAAS;AA+BzC,SAAS,UAAU,SAAiC,QAAyB;CAC3E,MAAM,QAAQ,OAAO,aAAa;AAClC,MAAK,MAAM,OAAO,OAAO,KAAK,QAAQ,CACpC,KAAI,IAAI,aAAa,KAAK,MAAO,QAAO;AAE1C,QAAO;;;;;;;;AAST,SAAgB,yBACd,SACA,EAAE,WAAW,WAA4D,EAAE,EACnD;CACxB,MAAM,MAAM,EAAE,GAAG,SAAS;AAC1B,KAAI,cAAc,SAAS,CAAC,UAAU,KAAK,aAAa,CAEtD,KAAI,gBADO,OAAO,cAAc,YAAY,UAAU,SAAS,IAAI,YAAY;AAGjF,KAAI,UAAU,CAAC,UAAU,KAAK,iBAAiB,CAC7C,KAAI,oBAAoB;AAE1B,QAAO;;AAGT,SAAS,YAAY,OAAyB;AAC5C,KAAI,iBAAiB,gBAAgB,MAAM,SAAS,aAAc,QAAO;AACzE,KAAI,iBAAiB,UAAW,QAAO;AACvC,KAAI,iBAAiB,OAAO;EAC1B,MAAM,QAAQ,MAAM,QAAQ,MAAM,mBAAmB;AACrD,MAAI,MAAO,QAAO,OAAO,SAAS,MAAM,GAAG,IAAI;;AAEjD,QAAO;;;;;;AAOT,eAAsB,SAAS,EAAE,KAAK,SAAS,MAAM,SAAS,OAAO,UAAU,GAAG,WAAW,UAA0C;CACrI,MAAM,oBAAoB,OAAO,SAAS,QAAQ,IAAI,WAAW,IAAI,KAAK,MAAM,QAAQ,GAAG;CAC3F,MAAM,eAAe,yBAAyB,SAAS;EAAE;EAAW;EAAQ,CAAC;CAE7E,IAAI;AAEJ,MAAK,IAAI,UAAU,GAAG,WAAW,mBAAmB,WAAW;EAC7D,MAAM,aAAa,IAAI,iBAAiB;EACxC,MAAM,YAAY,iBAAiB,WAAW,OAAO,EAAE,QAAQ;AAE/D,MAAI;GACF,MAAM,WAAW,MAAM,MAAM,KAAK;IAChC,QAAQ;IACR,SAAS;IACT;IACA,QAAQ,WAAW;IACpB,CAAC;AAEF,OAAI,CAAC,SAAS,IAAI;IAChB,MAAM,OAAO,MAAM,SAAS,MAAM,CAAC,YAAY,gBAAgB;IAC/D,MAAM,WAAW,KAAK,SAAS,MAAM,GAAG,KAAK,MAAM,GAAG,IAAI,CAAC,kBAAkB;AAC7E,UAAM,IAAI,MAAM,GAAG,MAAM,cAAc,SAAS,OAAO,GAAG,SAAS,WAAW,KAAK,WAAW;;AAGhG,gBAAa,UAAU;AACvB;WACO,OAAO;AACd,gBAAa,UAAU;AAEvB,OAAI,iBAAiB,gBAAgB,MAAM,SAAS,aAClD,6BAAY,IAAI,MAAM,GAAG,MAAM,2BAA2B,QAAQ,IAAI;OAEtE,aAAY;AAGd,OAAI,CAAC,YAAY,MAAM,IAAI,YAAY,kBACrC,OAAM;AAGR,SAAM,IAAI,SAAc,MAAK,WAAW,GAAG,MAAM,KAAK,QAAQ,CAAC;;;AAInE,OAAM"}

package/dist/http.d.mts

@@ -1,4 +1,4 @@
-import { F as DrainContext } from "./audit-X1uUukm3.mjs";
+import { I as DrainContext } from "./audit-CC8nfazi.mjs";
 import { DrainPipelineOptions, PipelineDrainFn } from "./pipeline.mjs";
 
 //#region src/http.d.ts

package/dist/http.mjs

@@ -33,6 +33,7 @@ function createHttpDrain(config) {
 				method: "POST",
 				headers: {
 					"Content-Type": "application/json",
+					"X-Evlog-Source": "client",
 					...customHeaders
 				},
 				body,

package/dist/http.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"http.mjs","names":[],"sources":["../src/http.ts"],"sourcesContent":["import type { DrainContext } from './types'\nimport type { DrainPipelineOptions, PipelineDrainFn } from './pipeline'\nimport { createDrainPipeline } from './pipeline'\nimport { isBrowser } from './utils'\n\nexport interface HttpDrainConfig {\n  /** URL of the server ingest endpoint */\n  endpoint: string\n  /** Custom headers sent with each fetch request (e.g. Authorization, X-API-Key). Not applied to sendBeacon — see `useBeacon`. */\n  headers?: Record<string, string>\n  /** Request timeout in milliseconds. @default 5000 */\n  timeout?: number\n  /** Use sendBeacon when the page is hidden. @default true */\n  useBeacon?: boolean\n  /** Fetch credentials mode. @default 'same-origin' */\n  credentials?: RequestCredentials\n}\n\nexport interface HttpLogDrainOptions {\n  /** HTTP drain configuration (endpoint is required) */\n  drain: HttpDrainConfig\n  /** Pipeline configuration overrides */\n  pipeline?: DrainPipelineOptions<DrainContext>\n  /** Auto-register visibilitychange flush listener. @default true */\n  autoFlush?: boolean\n}\n\n/**\n * Create a low-level HTTP drain transport function (fetch / sendBeacon).\n *\n * Returns a function compatible with `createDrainPipeline` that sends batches\n * to the configured endpoint via `fetch` (with `keepalive: true`) or\n * `navigator.sendBeacon` when the page is hidden.\n *\n * @example\n * ```ts\n * import { createHttpDrain } from 'evlog/http'\n * import { createDrainPipeline } from 'evlog/pipeline'\n *\n * const pipeline = createDrainPipeline({ batch: { size: 50 } })\n * const drain = pipeline(createHttpDrain({ endpoint: '/api/logs' }))\n * ```\n */\nexport function createHttpDrain(config: HttpDrainConfig): (batch: DrainContext[]) => Promise<void> {\n  const { endpoint, headers: customHeaders, timeout = 5000, useBeacon = true, credentials = 'same-origin' } = config\n\n  return async (batch: DrainContext[]): Promise<void> => {\n    if (batch.length === 0) return\n\n    const body = JSON.stringify(batch)\n\n    if (\n      useBeacon\n      && isBrowser()\n      && document.visibilityState === 'hidden'\n      && typeof navigator.sendBeacon === 'function'\n    ) {\n      const queued = navigator.sendBeacon(endpoint, new Blob([body], { type: 'application/json' }))\n      if (!queued) {\n        throw new Error('[evlog/http] sendBeacon failed — payload may exceed browser limit')\n      }\n      return\n    }\n\n    const controller = new AbortController()\n    const timeoutId = setTimeout(() => controller.abort(), timeout)\n\n    try {\n      const response = await fetch(endpoint, {\n        method: 'POST',\n        headers: { 'Content-Type': 'application/json', ...customHeaders },\n        body,\n        signal: controller.signal,\n        keepalive: true,\n        credentials,\n      })\n\n      if (!response.ok) {\n        throw new Error(`[evlog/http] Server responded with ${response.status}`)\n      }\n    } finally {\n      clearTimeout(timeoutId)\n    }\n  }\n}\n\n/**\n * Create a pre-composed HTTP log drain with pipeline, batching, and auto-flush.\n *\n * Returns a `PipelineDrainFn<DrainContext>` directly usable with `initLogger({ drain })`.\n *\n * @example\n * ```ts\n * import { initLogger, log } from 'evlog'\n * import { createHttpLogDrain } from 'evlog/http'\n *\n * const drain = createHttpLogDrain({\n *   drain: { endpoint: '/api/logs' },\n * })\n * initLogger({ drain })\n *\n * log.info({ action: 'page_view', path: location.pathname })\n * ```\n */\nexport function createHttpLogDrain(options: HttpLogDrainOptions): PipelineDrainFn<DrainContext> & { dispose: () => void } {\n  const { autoFlush = true } = options\n\n  const pipeline = createDrainPipeline<DrainContext>({\n    batch: { size: 25, intervalMs: 2000 },\n    retry: { maxAttempts: 2 },\n    ...options.pipeline,\n  })\n\n  const drain = pipeline(createHttpDrain(options.drain)) as PipelineDrainFn<DrainContext> & { dispose: () => void }\n\n  let onVisibilityChange: (() => void) | undefined\n\n  if (autoFlush && isBrowser()) {\n    onVisibilityChange = () => {\n      if (document.visibilityState === 'hidden') {\n        drain.flush()\n      }\n    }\n    document.addEventListener('visibilitychange', onVisibilityChange)\n  }\n\n  drain.dispose = () => {\n    if (onVisibilityChange) {\n      document.removeEventListener('visibilitychange', onVisibilityChange)\n      onVisibilityChange = undefined\n    }\n  }\n\n  return drain\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AA2CA,SAAgB,gBAAgB,QAAmE;CACjG,MAAM,EAAE,UAAU,SAAS,eAAe,UAAU,KAAM,YAAY,MAAM,cAAc,kBAAkB;AAE5G,QAAO,OAAO,UAAyC;AACrD,MAAI,MAAM,WAAW,EAAG;EAExB,MAAM,OAAO,KAAK,UAAU,MAAM;AAElC,MACE,aACG,WAAW,IACX,SAAS,oBAAoB,YAC7B,OAAO,UAAU,eAAe,YACnC;AAEA,OAAI,CADW,UAAU,WAAW,UAAU,IAAI,KAAK,CAAC,KAAK,EAAE,EAAE,MAAM,oBAAoB,CAAC,CACjF,CACT,OAAM,IAAI,MAAM,oEAAoE;AAEtF;;EAGF,MAAM,aAAa,IAAI,iBAAiB;EACxC,MAAM,YAAY,iBAAiB,WAAW,OAAO,EAAE,QAAQ;AAE/D,MAAI;GACF,MAAM,WAAW,MAAM,MAAM,UAAU;IACrC,QAAQ;IACR,SAAS;KAAE,gBAAgB;KAAoB,GAAG;KAAe;IACjE;IACA,QAAQ,WAAW;IACnB,WAAW;IACX;IACD,CAAC;AAEF,OAAI,CAAC,SAAS,GACZ,OAAM,IAAI,MAAM,sCAAsC,SAAS,SAAS;YAElE;AACR,gBAAa,UAAU;;;;;;;;;;;;;;;;;;;;;;AAuB7B,SAAgB,mBAAmB,SAAuF;CACxH,MAAM,EAAE,YAAY,SAAS;CAQ7B,MAAM,QANW,oBAAkC;EACjD,OAAO;GAAE,MAAM;GAAI,YAAY;GAAM;EACrC,OAAO,EAAE,aAAa,GAAG;EACzB,GAAG,QAAQ;EACZ,CAEqB,CAAC,gBAAgB,QAAQ,MAAM,CAAC;CAEtD,IAAI;AAEJ,KAAI,aAAa,WAAW,EAAE;AAC5B,6BAA2B;AACzB,OAAI,SAAS,oBAAoB,SAC/B,OAAM,OAAO;;AAGjB,WAAS,iBAAiB,oBAAoB,mBAAmB;;AAGnE,OAAM,gBAAgB;AACpB,MAAI,oBAAoB;AACtB,YAAS,oBAAoB,oBAAoB,mBAAmB;AACpE,wBAAqB,KAAA;;;AAIzB,QAAO"}
+{"version":3,"file":"http.mjs","names":[],"sources":["../src/http.ts"],"sourcesContent":["import type { DrainContext } from './types'\nimport type { DrainPipelineOptions, PipelineDrainFn } from './pipeline'\nimport { createDrainPipeline } from './pipeline'\nimport { isBrowser } from './utils'\n\nexport interface HttpDrainConfig {\n  /** URL of the server ingest endpoint */\n  endpoint: string\n  /** Custom headers sent with each fetch request (e.g. Authorization, X-API-Key). Not applied to sendBeacon — see `useBeacon`. */\n  headers?: Record<string, string>\n  /** Request timeout in milliseconds. @default 5000 */\n  timeout?: number\n  /** Use sendBeacon when the page is hidden. @default true */\n  useBeacon?: boolean\n  /** Fetch credentials mode. @default 'same-origin' */\n  credentials?: RequestCredentials\n}\n\nexport interface HttpLogDrainOptions {\n  /** HTTP drain configuration (endpoint is required) */\n  drain: HttpDrainConfig\n  /** Pipeline configuration overrides */\n  pipeline?: DrainPipelineOptions<DrainContext>\n  /** Auto-register visibilitychange flush listener. @default true */\n  autoFlush?: boolean\n}\n\n/**\n * Create a low-level HTTP drain transport function (fetch / sendBeacon).\n *\n * Returns a function compatible with `createDrainPipeline` that sends batches\n * to the configured endpoint via `fetch` (with `keepalive: true`) or\n * `navigator.sendBeacon` when the page is hidden.\n *\n * @example\n * ```ts\n * import { createHttpDrain } from 'evlog/http'\n * import { createDrainPipeline } from 'evlog/pipeline'\n *\n * const pipeline = createDrainPipeline({ batch: { size: 50 } })\n * const drain = pipeline(createHttpDrain({ endpoint: '/api/logs' }))\n * ```\n */\nexport function createHttpDrain(config: HttpDrainConfig): (batch: DrainContext[]) => Promise<void> {\n  const { endpoint, headers: customHeaders, timeout = 5000, useBeacon = true, credentials = 'same-origin' } = config\n\n  return async (batch: DrainContext[]): Promise<void> => {\n    if (batch.length === 0) return\n\n    const body = JSON.stringify(batch)\n\n    if (\n      useBeacon\n      && isBrowser()\n      && document.visibilityState === 'hidden'\n      && typeof navigator.sendBeacon === 'function'\n    ) {\n      const queued = navigator.sendBeacon(endpoint, new Blob([body], { type: 'application/json' }))\n      if (!queued) {\n        throw new Error('[evlog/http] sendBeacon failed — payload may exceed browser limit')\n      }\n      return\n    }\n\n    const controller = new AbortController()\n    const timeoutId = setTimeout(() => controller.abort(), timeout)\n\n    try {\n      const response = await fetch(endpoint, {\n        method: 'POST',\n        headers: { 'Content-Type': 'application/json', 'X-Evlog-Source': 'client', ...customHeaders },\n        body,\n        signal: controller.signal,\n        keepalive: true,\n        credentials,\n      })\n\n      if (!response.ok) {\n        throw new Error(`[evlog/http] Server responded with ${response.status}`)\n      }\n    } finally {\n      clearTimeout(timeoutId)\n    }\n  }\n}\n\n/**\n * Create a pre-composed HTTP log drain with pipeline, batching, and auto-flush.\n *\n * Returns a `PipelineDrainFn<DrainContext>` directly usable with `initLogger({ drain })`.\n *\n * @example\n * ```ts\n * import { initLogger, log } from 'evlog'\n * import { createHttpLogDrain } from 'evlog/http'\n *\n * const drain = createHttpLogDrain({\n *   drain: { endpoint: '/api/logs' },\n * })\n * initLogger({ drain })\n *\n * log.info({ action: 'page_view', path: location.pathname })\n * ```\n */\nexport function createHttpLogDrain(options: HttpLogDrainOptions): PipelineDrainFn<DrainContext> & { dispose: () => void } {\n  const { autoFlush = true } = options\n\n  const pipeline = createDrainPipeline<DrainContext>({\n    batch: { size: 25, intervalMs: 2000 },\n    retry: { maxAttempts: 2 },\n    ...options.pipeline,\n  })\n\n  const drain = pipeline(createHttpDrain(options.drain)) as PipelineDrainFn<DrainContext> & { dispose: () => void }\n\n  let onVisibilityChange: (() => void) | undefined\n\n  if (autoFlush && isBrowser()) {\n    onVisibilityChange = () => {\n      if (document.visibilityState === 'hidden') {\n        drain.flush()\n      }\n    }\n    document.addEventListener('visibilitychange', onVisibilityChange)\n  }\n\n  drain.dispose = () => {\n    if (onVisibilityChange) {\n      document.removeEventListener('visibilitychange', onVisibilityChange)\n      onVisibilityChange = undefined\n    }\n  }\n\n  return drain\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AA2CA,SAAgB,gBAAgB,QAAmE;CACjG,MAAM,EAAE,UAAU,SAAS,eAAe,UAAU,KAAM,YAAY,MAAM,cAAc,kBAAkB;AAE5G,QAAO,OAAO,UAAyC;AACrD,MAAI,MAAM,WAAW,EAAG;EAExB,MAAM,OAAO,KAAK,UAAU,MAAM;AAElC,MACE,aACG,WAAW,IACX,SAAS,oBAAoB,YAC7B,OAAO,UAAU,eAAe,YACnC;AAEA,OAAI,CADW,UAAU,WAAW,UAAU,IAAI,KAAK,CAAC,KAAK,EAAE,EAAE,MAAM,oBAAoB,CAAC,CACjF,CACT,OAAM,IAAI,MAAM,oEAAoE;AAEtF;;EAGF,MAAM,aAAa,IAAI,iBAAiB;EACxC,MAAM,YAAY,iBAAiB,WAAW,OAAO,EAAE,QAAQ;AAE/D,MAAI;GACF,MAAM,WAAW,MAAM,MAAM,UAAU;IACrC,QAAQ;IACR,SAAS;KAAE,gBAAgB;KAAoB,kBAAkB;KAAU,GAAG;KAAe;IAC7F;IACA,QAAQ,WAAW;IACnB,WAAW;IACX;IACD,CAAC;AAEF,OAAI,CAAC,SAAS,GACZ,OAAM,IAAI,MAAM,sCAAsC,SAAS,SAAS;YAElE;AACR,gBAAa,UAAU;;;;;;;;;;;;;;;;;;;;;;AAuB7B,SAAgB,mBAAmB,SAAuF;CACxH,MAAM,EAAE,YAAY,SAAS;CAQ7B,MAAM,QANW,oBAAkC;EACjD,OAAO;GAAE,MAAM;GAAI,YAAY;GAAM;EACrC,OAAO,EAAE,aAAa,GAAG;EACzB,GAAG,QAAQ;EACZ,CAEqB,CAAC,gBAAgB,QAAQ,MAAM,CAAC;CAEtD,IAAI;AAEJ,KAAI,aAAa,WAAW,EAAE;AAC5B,6BAA2B;AACzB,OAAI,SAAS,oBAAoB,SAC/B,OAAM,OAAO;;AAGjB,WAAS,iBAAiB,oBAAoB,mBAAmB;;AAGnE,OAAM,gBAAgB;AACpB,MAAI,oBAAoB;AACtB,YAAS,oBAAoB,oBAAoB,mBAAmB;AACpE,wBAAqB,KAAA;;;AAIzB,QAAO"}

package/dist/index-o1_z4phv.d.mts

@@ -0,0 +1,213 @@
+import { N as AuditTarget, a as AuditInput } from "./audit-CC8nfazi.mjs";
+import { t as EvlogError } from "./error-CpbbtyXL.mjs";
+//#region src/catalog.d.ts
+/**
+ * Static metadata for a single entry in an error catalog.
+ *
+ * `message` is either a constant string or a function that receives required
+ * params at the call site (typed). All other fields are templated defaults
+ * that can be overridden at the call site.
+ */
+interface ErrorCatalogEntry {
+  /** HTTP status code (default: 500). */
+  status?: number;
+  /**
+   * Either a constant string or a typed function whose params become required
+   * arguments at the call site (`factory({ available, required })`).
+   */
+  message: string | ((params: never) => string);
+  /** Why this error occurred (technical reason). */
+  why?: string;
+  /** Actionable fix shown to the user. */
+  fix?: string;
+  /** Link to documentation. */
+  link?: string;
+  /** Free-form metadata for grouping / filtering (not surfaced on the wire). */
+  tags?: readonly string[];
+  /**
+   * Backend-only context defaults. Merged with call-site `internal` (call-site wins).
+   */
+  internal?: Record<string, unknown>;
+}
+/**
+ * Subset of {@link import('./types').ErrorOptions} that callers may override
+ * when invoking a catalog factory. `code` is always derived from the catalog
+ * and intentionally excluded — pass `cause` here for error chaining.
+ */
+interface ErrorFactoryOverrides {
+  message?: string;
+  status?: number;
+  why?: string;
+  fix?: string;
+  link?: string;
+  internal?: Record<string, unknown>;
+  cause?: Error;
+}
+/** @internal Extract the params object type from a templated message function. */
+type MessageParams<TMessage> = TMessage extends ((params: infer P) => string) ? P : Record<string, never>;
+/**
+ * Call-site argument type for a catalog factory:
+ * - if `message` is a function: required params object merged with overrides
+ * - if `message` is a string: optional overrides only
+ */
+type ErrorFactoryOpts<TEntry extends ErrorCatalogEntry> = TEntry['message'] extends ((params: infer _P) => string) ? MessageParams<TEntry['message']> & ErrorFactoryOverrides : ErrorFactoryOverrides;
+/** @internal When message is a string, the call-site argument is optional. */
+type FactoryArgs<TEntry extends ErrorCatalogEntry> = TEntry['message'] extends ((params: never) => string) ? [opts: ErrorFactoryOpts<TEntry>] : [opts?: ErrorFactoryOpts<TEntry>];
+/**
+ * A factory produced by {@link defineError} or each entry of
+ * {@link defineErrorCatalog}. Calling it returns a fully-formed
+ * {@link EvlogError} with the catalog's defaults applied. Static metadata
+ * is exposed as readonly properties for introspection / refactor-safe
+ * comparisons (`err.code === MyError.code`).
+ */
+type DefinedError<TCode extends string, TEntry extends ErrorCatalogEntry> = ((...args: FactoryArgs<TEntry>) => EvlogError) & {
+  readonly code: TCode;
+  readonly status: number;
+  readonly message: TEntry['message'];
+  readonly why: TEntry['why'];
+  readonly fix: TEntry['fix'];
+  readonly link: TEntry['link'];
+  readonly tags: TEntry['tags'];
+  readonly internal: TEntry['internal'];
+};
+/**
+ * Define a single, standalone error factory bound to a stable `code`.
+ *
+ * Each factory produces an {@link EvlogError} with the entry's defaults
+ * applied. Call-site overrides (`cause`, `internal`, `message`, ...) are
+ * shallow-merged onto those defaults.
+ *
+ * @example
+ * ```ts
+ * import { defineError } from 'evlog'
+ *
+ * export const PaymentDeclined = defineError('billing.PAYMENT_DECLINED', {
+ *   status: 402,
+ *   message: 'Card declined',
+ *   why: 'Issuer declined the charge',
+ *   fix: 'Try another card',
+ * })
+ *
+ * throw PaymentDeclined()
+ * throw PaymentDeclined({ cause: stripeErr, internal: { ref: 'ch_x' } })
+ * ```
+ *
+ * @example Templated message with typed params
+ * ```ts
+ * export const InsufficientFunds = defineError('billing.INSUFFICIENT_FUNDS', {
+ *   status: 402,
+ *   message: ({ available, required }: { available: number, required: number }) =>
+ *     `Insufficient funds: $${available}/$${required}`,
+ * })
+ *
+ * throw InsufficientFunds({ available: 5, required: 100 })
+ * ```
+ */
+declare function defineError<const TCode extends string, const TEntry extends ErrorCatalogEntry>(code: TCode, entry: TEntry): DefinedError<TCode, TEntry>;
+/** Map of error catalog entries keyed by their (UPPER_SNAKE) name. */
+interface ErrorCatalogMap {
+  readonly [key: string]: ErrorCatalogEntry;
+}
+/**
+ * The object returned by {@link defineErrorCatalog}. Each map key becomes a
+ * dot-accessed factory whose `code` is `${prefix}.${key}` (preserved casing).
+ *
+ * Catalog metadata (`_prefix`, `_codes`) is exposed as non-enumerable readonly
+ * properties so it does not pollute iteration but is available for typing
+ * (`declare module 'evlog'`) and runtime introspection.
+ */
+type ErrorCatalog<TPrefix extends string, TMap extends ErrorCatalogMap> = { [K in keyof TMap & string]: DefinedError<`${TPrefix}.${K}`, TMap[K]> } & {
+  readonly _prefix: TPrefix;
+  readonly _codes: ReadonlyArray<`${TPrefix}.${keyof TMap & string}`>;
+};
+/**
+ * Define a bundle of errors that share a common prefix. The wire `code` for
+ * each entry is `${prefix}.${KEY}` (the key's casing is preserved — convention
+ * is `UPPER_SNAKE_CASE`).
+ *
+ * Pair with `declare module 'evlog'` to surface autocomplete + literal-typed
+ * `code` everywhere across the codebase.
+ *
+ * @example
+ * ```ts
+ * import { defineErrorCatalog } from 'evlog'
+ *
+ * export const billingErrors = defineErrorCatalog('billing', {
+ *   PAYMENT_DECLINED: { status: 402, message: 'Card declined' },
+ *   INSUFFICIENT_FUNDS: {
+ *     status: 402,
+ *     message: ({ available, required }: { available: number, required: number }) =>
+ *       `Insufficient funds: $${available}/$${required}`,
+ *   },
+ * })
+ *
+ * declare module 'evlog' {
+ *   interface RegisteredErrorCatalogs {
+ *     billing: typeof billingErrors
+ *   }
+ * }
+ *
+ * throw billingErrors.PAYMENT_DECLINED()
+ * throw billingErrors.INSUFFICIENT_FUNDS({ available: 5, required: 100 })
+ * ```
+ */
+declare function defineErrorCatalog<const TPrefix extends string, const TMap extends ErrorCatalogMap>(prefix: TPrefix, map: TMap): ErrorCatalog<TPrefix, TMap>;
+/** Static metadata for a single entry in an audit catalog. */
+interface AuditCatalogEntry {
+  /** Default `target.type` for every audit emitted from this action. */
+  target?: string;
+}
+/** Map of audit catalog entries keyed by their (UPPER_SNAKE) name. */
+interface AuditCatalogMap {
+  readonly [key: string]: AuditCatalogEntry;
+}
+/** A factory produced by an audit catalog entry. Returns an {@link AuditInput}. */
+type DefinedCatalogAudit<TAction extends string, TEntry extends AuditCatalogEntry> = ((input: TEntry['target'] extends string ? Omit<AuditInput, 'action' | 'target'> & {
+  target?: Omit<AuditTarget, 'type'> & {
+    type?: TEntry['target'];
+  };
+} : Omit<AuditInput, 'action'>) => AuditInput) & {
+  readonly action: TAction;
+  readonly target: TEntry['target'];
+};
+/**
+ * The object returned by {@link defineAuditCatalog}. Mirrors
+ * {@link ErrorCatalog} but each factory produces an {@link AuditInput}
+ * (typically passed to `log.audit(...)`).
+ */
+type AuditCatalog<TPrefix extends string, TMap extends AuditCatalogMap> = { [K in keyof TMap & string]: DefinedCatalogAudit<`${TPrefix}.${K}`, TMap[K]> } & {
+  readonly _prefix: TPrefix;
+  readonly _actions: ReadonlyArray<`${TPrefix}.${keyof TMap & string}`>;
+};
+/**
+ * Define a bundle of audit actions that share a common prefix. The wire
+ * `action` for each entry is `${prefix}.${KEY}`.
+ *
+ * Each entry produces a thin wrapper around {@link defineAuditAction} (target
+ * type is fixed at definition time, action name is auto-prefixed).
+ *
+ * @example
+ * ```ts
+ * import { defineAuditCatalog } from 'evlog'
+ *
+ * export const billingAudit = defineAuditCatalog('billing', {
+ *   INVOICE_REFUND: { target: 'invoice' },
+ *   INVOICE_CREATE: { target: 'invoice' },
+ * })
+ *
+ * declare module 'evlog' {
+ *   interface RegisteredAuditCatalogs {
+ *     billing: typeof billingAudit
+ *   }
+ * }
+ *
+ * log.audit(billingAudit.INVOICE_REFUND({
+ *   actor: { type: 'user', id: u.id },
+ *   target: { id: 'inv_889' },
+ * }))
+ * ```
+ */
+declare function defineAuditCatalog<const TPrefix extends string, const TMap extends AuditCatalogMap>(prefix: TPrefix, map: TMap): AuditCatalog<TPrefix, TMap>;
+//#endregion
+export { DefinedError as a, ErrorCatalogMap as c, defineAuditCatalog as d, defineError as f, DefinedCatalogAudit as i, ErrorFactoryOpts as l, AuditCatalogEntry as n, ErrorCatalog as o, defineErrorCatalog as p, AuditCatalogMap as r, ErrorCatalogEntry as s, AuditCatalog as t, ErrorFactoryOverrides as u };
+//# sourceMappingURL=index-o1_z4phv.d.mts.map

package/dist/index-o1_z4phv.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-o1_z4phv.d.mts","names":[],"sources":["../src/catalog.ts"],"mappings":";;;;;;;;;AAYA;UAAiB,iBAAA;;EAEf,MAAA;EAAA;;;;EAKA,OAAA,aAAoB,MAAA;EAMpB;EAJA,GAAA;EAUA;EARA,GAAA;EAQiB;EANjB,IAAA;EAce;EAZf,IAAA;;;;EAIA,QAAA,GAAW,MAAA;AAAA;;;;;;UAQI,qBAAA;EACf,OAAA;EACA,MAAA;EACA,GAAA;EACA,GAAA;EACA,IAAA;EACA,QAAA,GAAW,MAAA;EACX,KAAA,GAAQ,KAAA;AAAA;;KAIL,aAAA,aAA0B,QAAA,WAAkB,MAAA,wBAA6B,CAAA,GAAI,MAAA;;;;;AAOlF;KAAY,gBAAA,gBAAgC,iBAAA,IAC1C,MAAA,sBAA2B,MAAA,yBACvB,aAAA,CAAc,MAAA,eAAqB,qBAAA,GACnC,qBAAA;;KAGD,WAAA,gBAA2B,iBAAA,IAC9B,MAAA,sBAA2B,MAAA,uBACtB,IAAA,EAAM,gBAAA,CAAiB,MAAA,MACvB,IAAA,GAAO,gBAAA,CAAiB,MAAA;;;;;;;;KASnB,YAAA,sCAAkD,iBAAA,SACrD,IAAA,EAAM,WAAA,CAAY,MAAA,MAAY,UAAA;EAAA,SAE1B,IAAA,EAAM,KAAA;EAAA,SACN,MAAA;EAAA,SACA,OAAA,EAAS,MAAA;EAAA,SACT,GAAA,EAAK,MAAA;EAAA,SACL,GAAA,EAAK,MAAA;EAAA,SACL,IAAA,EAAM,MAAA;EAAA,SACN,IAAA,EAAM,MAAA;EAAA,SACN,QAAA,EAAU,MAAA;AAAA;;AAzBI;;;;;;;;;;;;;;;;;;;;;;;AAe3B;;;;;;;;;iBAyFgB,WAAA,kDAEO,iBAAA,CAAA,CACrB,IAAA,EAAM,KAAA,EAAO,KAAA,EAAO,MAAA,GAAS,YAAA,CAAa,KAAA,EAAO,MAAA;;UAmBlC,eAAA;EAAA,UACL,GAAA,WAAc,iBAAA;AAAA;;;;;;;;;KAWd,YAAA,sCAAkD,eAAA,kBAC5C,IAAA,YAAgB,YAAA,IAAgB,OAAA,IAAW,CAAA,IAAK,IAAA,CAAK,CAAA;EAAA,SAE1D,OAAA,EAAS,OAAA;EAAA,SACT,MAAA,EAAQ,aAAA,IAAiB,OAAA,UAAiB,IAAA;AAAA;;;;;;;;;;;;;AAtCvD;;;;;;;;;;;;;;;;;;;iBAwEgB,kBAAA,kDAEK,eAAA,CAAA,CACnB,MAAA,EAAQ,OAAA,EAAS,GAAA,EAAK,IAAA,GAAO,YAAA,CAAa,OAAA,EAAS,IAAA;;UAmBpC,iBAAA;EA3FwC;EA6FvD,MAAA;AAAA;;UAIe,eAAA;EAAA,UACL,GAAA,WAAc,iBAAA;AAAA;;KAId,mBAAA,wCAA2D,iBAAA,MAEnE,KAAA,EAAO,MAAA,4BACH,IAAA,CAAK,UAAA;EAAqC,MAAA,GAAS,IAAA,CAAK,WAAA;IAAyB,IAAA,GAAO,MAAA;EAAA;AAAA,IACxF,IAAA,CAAK,UAAA,gBACN,UAAA;EAAA,SAEM,MAAA,EAAQ,OAAA;EAAA,SACR,MAAA,EAAQ,MAAA;AAAA;;;;;;KAQT,YAAA,sCAAkD,eAAA,kBAC5C,IAAA,YAAgB,mBAAA,IAAuB,OAAA,IAAW,CAAA,IAAK,IAAA,CAAK,CAAA;EAAA,SAEjE,OAAA,EAAS,OAAA;EAAA,SACT,QAAA,EAAU,aAAA,IAAiB,OAAA,UAAiB,IAAA;AAAA;;;;;;;;;;;;;;AArDzD;;;;;;;;;;;;;;;iBAoFgB,kBAAA,kDAEK,eAAA,CAAA,CACnB,MAAA,EAAQ,OAAA,EAAS,GAAA,EAAK,IAAA,GAAO,YAAA,CAAa,OAAA,EAAS,IAAA"}

package/dist/index.d.mts

@@ -1,8 +1,9 @@
-import { $ as SamplingRates, A as AuditFields, B as H3EventContext, C as buildAuditFields, D as withAudit, E as signed, F as DrainContext, G as LoggerConfig, H as InternalFields, I as EnrichContext, K as ParsedError, L as EnvironmentContext, M as AuditTarget, N as BaseWideEvent, O as withAuditMethods, P as DeepPartial, Q as SamplingConfig, R as ErrorOptions, S as auditRedactPreset, T as mockAudit, U as Log, V as IngestPayload, W as LogLevel, X as RequestLoggerOptions, Y as RequestLogger, _ as WithAuditOptions, a as AuditInput, at as ClientLogContext, b as auditEnricher, c as AuditOnlyOptions, ct as PluginSetupContext, d as DefinedAuditAction, et as ServerEvent, f as DrainFn, ft as definePlugin, g as WithAuditContext, h as SignedOptions, i as AuditEnricherOptions, it as WideEvent, j as AuditLoggerMethod, k as AuditActor, l as AuditPatchOp, lt as RequestFinishContext, m as SignedChainState, mt as enricherPlugin, n as AuditDeniedError, nt as TailSamplingContext, o as AuditMatcher, ot as EvlogPlugin, p as MockAudit, pt as drainPlugin, q as RedactConfig, r as AuditDiffOptions, rt as TransportConfig, s as AuditMethod, st as PluginRunner, t as AUDIT_SCHEMA_VERSION, tt as TailSamplingCondition, u as AuditableLogger, ut as RequestLifecycleContext, v as audit, w as defineAuditAction, x as auditOnly, y as auditDiff, z as FieldContext } from "./audit-X1uUukm3.mjs";
-import { n as createError, t as EvlogError } from "./error-Cpc7RVz6.mjs";
-import { c as isEnabled, d as shouldKeep, i as getEnvironment, n as createLogger, r as createRequestLogger, s as initLogger, t as _log } from "./logger-U8lgdc9x.mjs";
-import { m as isLevelEnabled } from "./utils-Db4qhBWn.mjs";
-import { t as useLogger } from "./useLogger-CoNgTjp5.mjs";
-import { t as parseError } from "./parseError-B-dKF6Fd.mjs";
-import { i as toMiddlewareOptions, n as defineEvlog, r as toLoggerConfig, t as EvlogConfig } from "./define-CuXOqecD.mjs";
-export { AUDIT_SCHEMA_VERSION, type AuditActor, AuditDeniedError, type AuditDiffOptions, type AuditEnricherOptions, type AuditFields, type AuditInput, type AuditLoggerMethod, type AuditMatcher, type AuditMethod, type AuditOnlyOptions, type AuditPatchOp, type AuditTarget, type AuditableLogger, type BaseWideEvent, type ClientLogContext, type DeepPartial, type DefinedAuditAction, type DrainContext, type DrainFn, type EnrichContext, type EnvironmentContext, type ErrorOptions, type EvlogConfig, EvlogError, type EvlogPlugin, type FieldContext, type H3EventContext, type IngestPayload, type InternalFields, type Log, type LogLevel, type LoggerConfig, type MockAudit, type ParsedError, type PluginRunner, type PluginSetupContext, type RedactConfig, type RequestFinishContext, type RequestLifecycleContext, type RequestLogger, type RequestLoggerOptions, type SamplingConfig, type SamplingRates, type ServerEvent, type SignedChainState, type SignedOptions, type TailSamplingCondition, type TailSamplingContext, type TransportConfig, type WideEvent, type WithAuditContext, type WithAuditOptions, audit, auditDiff, auditEnricher, auditOnly, auditRedactPreset, buildAuditFields, createError, createError as createEvlogError, createLogger, createRequestLogger, defineAuditAction, defineEvlog, definePlugin, drainPlugin, enricherPlugin, getEnvironment, initLogger, isEnabled, isLevelEnabled, _log as log, mockAudit, parseError, shouldKeep, signed, toLoggerConfig, toMiddlewareOptions, useLogger, withAudit, withAuditMethods };
+import { $ as RequestLogger, A as AuditActor, B as ErrorOptions, C as buildAuditFields, D as withAudit, E as signed, F as DeepPartial, G as Log, H as H3EventContext, I as DrainContext, J as ParsedError, K as LogLevel, L as EnrichContext, M as AuditLoggerMethod, N as AuditTarget, O as withAuditMethods, P as BaseWideEvent, R as EnvironmentContext, S as auditRedactPreset, T as mockAudit, U as IngestPayload, V as FieldContext, W as InternalFields, X as RegisteredAuditCatalogs, Y as RedactConfig, Z as RegisteredErrorCatalogs, _ as WithAuditOptions, _t as drainPlugin, a as AuditInput, at as TailSamplingCondition, b as auditEnricher, c as AuditOnlyOptions, ct as WideEvent, d as DefinedAuditAction, dt as PluginRunner, et as RequestLoggerOptions, f as DrainFn, ft as PluginSetupContext, g as WithAuditContext, gt as definePlugin, h as SignedOptions, i as AuditEnricherOptions, it as ServerEvent, j as AuditFields, k as AuditAction, l as AuditPatchOp, lt as ClientLogContext, m as SignedChainState, mt as RequestLifecycleContext, n as AuditDeniedError, nt as SamplingConfig, o as AuditMatcher, ot as TailSamplingContext, p as MockAudit, pt as RequestFinishContext, q as LoggerConfig, r as AuditDiffOptions, rt as SamplingRates, s as AuditMethod, st as TransportConfig, t as AUDIT_SCHEMA_VERSION, u as AuditableLogger, ut as EvlogPlugin, v as audit, vt as enricherPlugin, w as defineAuditAction, x as auditOnly, y as auditDiff, z as ErrorCode } from "./audit-CC8nfazi.mjs";
+import { n as createError, t as EvlogError } from "./error-CpbbtyXL.mjs";
+import { a as DefinedError, c as ErrorCatalogMap, d as defineAuditCatalog, f as defineError, i as DefinedCatalogAudit, l as ErrorFactoryOpts, n as AuditCatalogEntry, o as ErrorCatalog, p as defineErrorCatalog, r as AuditCatalogMap, s as ErrorCatalogEntry, t as AuditCatalog, u as ErrorFactoryOverrides } from "./index-o1_z4phv.mjs";
+import { c as isEnabled, d as shouldKeep, i as getEnvironment, n as createLogger, r as createRequestLogger, s as initLogger, t as _log } from "./logger-DntcxxHg.mjs";
+import { m as isLevelEnabled } from "./utils-DLCeShxL.mjs";
+import { t as useLogger } from "./useLogger-BsPL4AQm.mjs";
+import { t as parseError } from "./parseError-yVZ58wIK.mjs";
+import { i as toMiddlewareOptions, n as defineEvlog, r as toLoggerConfig, t as EvlogConfig } from "./define-MSdhzmXn.mjs";
+export { AUDIT_SCHEMA_VERSION, AuditAction, AuditActor, AuditCatalog, AuditCatalogEntry, AuditCatalogMap, AuditDeniedError, AuditDiffOptions, AuditEnricherOptions, AuditFields, AuditInput, AuditLoggerMethod, AuditMatcher, AuditMethod, AuditOnlyOptions, AuditPatchOp, AuditTarget, AuditableLogger, BaseWideEvent, ClientLogContext, DeepPartial, DefinedAuditAction, DefinedCatalogAudit, DefinedError, DrainContext, DrainFn, EnrichContext, EnvironmentContext, ErrorCatalog, ErrorCatalogEntry, ErrorCatalogMap, ErrorCode, ErrorFactoryOpts, ErrorFactoryOverrides, ErrorOptions, EvlogConfig, EvlogError, EvlogPlugin, FieldContext, H3EventContext, IngestPayload, InternalFields, Log, LogLevel, LoggerConfig, MockAudit, ParsedError, PluginRunner, PluginSetupContext, RedactConfig, RegisteredAuditCatalogs, RegisteredErrorCatalogs, RequestFinishContext, RequestLifecycleContext, RequestLogger, RequestLoggerOptions, SamplingConfig, SamplingRates, ServerEvent, SignedChainState, SignedOptions, TailSamplingCondition, TailSamplingContext, TransportConfig, WideEvent, WithAuditContext, WithAuditOptions, audit, auditDiff, auditEnricher, auditOnly, auditRedactPreset, buildAuditFields, createError, createError as createEvlogError, createLogger, createRequestLogger, defineAuditAction, defineAuditCatalog, defineError, defineErrorCatalog, defineEvlog, definePlugin, drainPlugin, enricherPlugin, getEnvironment, initLogger, isEnabled, isLevelEnabled, _log as log, mockAudit, parseError, shouldKeep, signed, toLoggerConfig, toMiddlewareOptions, useLogger, withAudit, withAuditMethods };