evlog 2.18.1 → 2.19.1

package/dist/index.d.mts

@@ -1,9 +1,9 @@
-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-DVdkntSO.mjs";
-import { n as createError, t as EvlogError } from "./error-CVtn5U7b.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-ZSRQP_BI.mjs";
-import { c as isEnabled, f as shouldKeep, i as getEnvironment, n as createLogger, r as createRequestLogger, s as initLogger, t as _log } from "./logger-CTcvd5Cc.mjs";
-import { m as isLevelEnabled } from "./utils-DxqvIOyR.mjs";
-import { t as useLogger } from "./useLogger-CqvH6qOf.mjs";
-import { t as parseError } from "./parseError-D4PIxEWo.mjs";
-import { i as toMiddlewareOptions, n as defineEvlog, r as toLoggerConfig, t as EvlogConfig } from "./define-D-BVMf2l.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 };
+import { $ as RedactConfig, A as AuditActionDefinition, B as DrainContext, C as buildAuditFields, Ct as enricherPlugin, D as withAudit, E as signed, F as AuditPatchOp, G as FieldContext, H as EnvironmentContext, I as AuditSeverity, J as InternalFields, K as H3EventContext, L as AuditTarget, M as AuditChanges, N as AuditFields, O as withAuditMethods, P as AuditLoggerMethod, Q as ParsedError, R as BaseWideEvent, S as auditRedactPreset, St as drainPlugin, T as mockAudit, U as ErrorCode, V as EnrichContext, W as ErrorOptions, X as LogLevel, Y as Log, Z as LoggerConfig, _ as WithAuditOptions, _t as PluginSetupContext, a as AuditInput, b as auditEnricher, c as AuditOnlyOptions, ct as ServerEvent, d as DefinedAuditAction, dt as TransportConfig, et as RegisteredAuditCatalogs, f as DrainFn, ft as WideEvent, g as WithAuditContext, gt as PluginRunner, h as SignedOptions, ht as EvlogPlugin, i as AuditEnricherOptions, it as RequestLoggerOptions, j as AuditActor, k as AuditAction, l as AuditableLogger, lt as TailSamplingCondition, m as SignedChainState, mt as ClientLogContext, n as AuditDeniedError, o as AuditMatcher, ot as SamplingConfig, p as MockAudit, q as IngestPayload, r as AuditDiffOptions, rt as RequestLogger, s as AuditMethod, st as SamplingRates, t as AUDIT_SCHEMA_VERSION, tt as RegisteredErrorCatalogs, u as DefineAuditActionOptions, ut as TailSamplingContext, v as audit, vt as RequestFinishContext, w as defineAuditAction, x as auditOnly, xt as definePlugin, y as auditDiff, yt as RequestLifecycleContext, z as DeepPartial } from "./audit-D7v6JHj0.mjs";
+import { n as createError, t as EvlogError } from "./error-CpghjrkY.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-EvnrXvQM.mjs";
+import { a as getEnvironment, c as initLogger, i as createRequestLogger, l as isEnabled, m as shouldKeep, n as _log, r as createLogger } from "./logger-mHIWxBhJ.mjs";
+import { h as isLevelEnabled } from "./utils-CJJG0ZYW.mjs";
+import { t as useLogger } from "./useLogger-Cfv8Ck8b.mjs";
+import { t as parseError } from "./parseError-BeBXEd2V.mjs";
+import { i as toMiddlewareOptions, n as defineEvlog, r as toLoggerConfig, t as EvlogConfig } from "./define-DTQpu4f6.mjs";
+export { AUDIT_SCHEMA_VERSION, AuditAction, AuditActionDefinition, AuditActor, AuditCatalog, AuditCatalogEntry, AuditCatalogMap, AuditChanges, AuditDeniedError, AuditDiffOptions, AuditEnricherOptions, AuditFields, AuditInput, AuditLoggerMethod, AuditMatcher, AuditMethod, AuditOnlyOptions, AuditPatchOp, AuditSeverity, AuditTarget, AuditableLogger, BaseWideEvent, ClientLogContext, DeepPartial, DefineAuditActionOptions, 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 };

package/dist/index.mjs

@@ -1,9 +1,9 @@
-import { D as definePlugin, O as drainPlugin, T as shouldKeep, _ as getEnvironment, a as auditEnricher, b as initLogger, c as buildAuditFields, d as signed, f as withAudit, g as createRequestLogger, h as createLogger, i as auditDiff, k as enricherPlugin, l as defineAuditAction, m as _log, n as AuditDeniedError, o as auditOnly, p as withAuditMethods, r as audit, s as auditRedactPreset, t as AUDIT_SCHEMA_VERSION, u as mockAudit, x as isEnabled } from "./audit-BUI3af4w.mjs";
 import { isLevelEnabled } from "./utils.mjs";
+import { A as enricherPlugin, E as shouldKeep, O as definePlugin, _ as getEnvironment, a as auditEnricher, b as initLogger, c as buildAuditFields, d as signed, f as withAudit, g as createRequestLogger, h as createLogger, i as auditDiff, k as drainPlugin, l as defineAuditAction, m as _log, n as AuditDeniedError, o as auditOnly, p as withAuditMethods, r as audit, s as auditRedactPreset, t as AUDIT_SCHEMA_VERSION, u as mockAudit, x as isEnabled } from "./audit-BQt8yAHo.mjs";
 import { EvlogError, createError } from "./error.mjs";
 import { useLogger } from "./runtime/server/useLogger.mjs";
 import { parseError } from "./runtime/utils/parseError.mjs";
-import { n as toLoggerConfig, r as toMiddlewareOptions, t as defineEvlog } from "./define-D6OJdSUH.mjs";
+import { n as toLoggerConfig, r as toMiddlewareOptions, t as defineEvlog } from "./define-Bpaymi-h.mjs";
 //#region src/catalog.ts
 function buildEvlogError(code, entry, rawArgs) {
 	const { message: messageOverride, status, why, fix, link, cause, internal: callInternal, ...maybeParams } = rawArgs ?? {};
@@ -161,7 +161,12 @@ function defineErrorCatalog(prefix, map) {
 * import { defineAuditCatalog } from 'evlog'
 *
 * export const billingAudit = defineAuditCatalog('billing', {
-*   INVOICE_REFUND: { target: 'invoice' },
+*   INVOICE_REFUND: {
+*     target: 'invoice',
+*     severity: 'high',
+*     requiresChanges: true,
+*     description: 'Refund an invoice to the customer',
+*   },
 *   INVOICE_CREATE: { target: 'invoice' },
 * })
 *
@@ -183,18 +188,7 @@ function defineAuditCatalog(prefix, map) {
 	for (const key of Object.keys(map)) {
 		const action = `${prefix}.${key}`;
 		const entry = map[key];
-		const fn = defineAuditAction(action, entry.target ? { target: entry.target } : void 0);
-		Object.defineProperties(fn, {
-			action: {
-				value: action,
-				enumerable: true
-			},
-			target: {
-				value: entry.target,
-				enumerable: true
-			}
-		});
-		out[key] = fn;
+		out[key] = defineAuditAction(action, entry);
 		actions.push(action);
 	}
 	Object.defineProperties(out, {

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../src/catalog.ts"],"sourcesContent":["import type { AuditInput } from './audit'\nimport type { AuditTarget } from './types'\nimport { defineAuditAction } from './audit'\nimport { EvlogError } from './error'\n\n/**\n * Static metadata for a single entry in an error catalog.\n *\n * `message` is either a constant string or a function that receives required\n * params at the call site (typed). All other fields are templated defaults\n * that can be overridden at the call site.\n */\nexport interface ErrorCatalogEntry {\n  /** HTTP status code (default: 500). */\n  status?: number\n  /**\n   * Either a constant string or a typed function whose params become required\n   * arguments at the call site (`factory({ available, required })`).\n   */\n  message: string | ((params: never) => string)\n  /** Why this error occurred (technical reason). */\n  why?: string\n  /** Actionable fix shown to the user. */\n  fix?: string\n  /** Link to documentation. */\n  link?: string\n  /** Free-form metadata for grouping / filtering (not surfaced on the wire). */\n  tags?: readonly string[]\n  /**\n   * Backend-only context defaults. Merged with call-site `internal` (call-site wins).\n   */\n  internal?: Record<string, unknown>\n}\n\n/**\n * Subset of {@link import('./types').ErrorOptions} that callers may override\n * when invoking a catalog factory. `code` is always derived from the catalog\n * and intentionally excluded — pass `cause` here for error chaining.\n */\nexport interface ErrorFactoryOverrides {\n  message?: string\n  status?: number\n  why?: string\n  fix?: string\n  link?: string\n  internal?: Record<string, unknown>\n  cause?: Error\n}\n\n/** @internal Extract the params object type from a templated message function. */\ntype MessageParams<TMessage> = TMessage extends (params: infer P) => string ? P : Record<string, never>\n\n/**\n * Call-site argument type for a catalog factory:\n * - if `message` is a function: required params object merged with overrides\n * - if `message` is a string: optional overrides only\n */\nexport type ErrorFactoryOpts<TEntry extends ErrorCatalogEntry> =\n  TEntry['message'] extends (params: infer _P) => string\n    ? MessageParams<TEntry['message']> & ErrorFactoryOverrides\n    : ErrorFactoryOverrides\n\n/** @internal When message is a string, the call-site argument is optional. */\ntype FactoryArgs<TEntry extends ErrorCatalogEntry> =\n  TEntry['message'] extends (params: never) => string\n    ? [opts: ErrorFactoryOpts<TEntry>]\n    : [opts?: ErrorFactoryOpts<TEntry>]\n\n/**\n * A factory produced by {@link defineError} or each entry of\n * {@link defineErrorCatalog}. Calling it returns a fully-formed\n * {@link EvlogError} with the catalog's defaults applied. Static metadata\n * is exposed as readonly properties for introspection / refactor-safe\n * comparisons (`err.code === MyError.code`).\n */\nexport type DefinedError<TCode extends string, TEntry extends ErrorCatalogEntry> =\n  & ((...args: FactoryArgs<TEntry>) => EvlogError)\n  & {\n    readonly code: TCode\n    readonly status: number\n    readonly message: TEntry['message']\n    readonly why: TEntry['why']\n    readonly fix: TEntry['fix']\n    readonly link: TEntry['link']\n    readonly tags: TEntry['tags']\n    readonly internal: TEntry['internal']\n  }\n\nfunction buildEvlogError(\n  code: string,\n  entry: ErrorCatalogEntry,\n  rawArgs: Record<string, unknown> | undefined,\n): EvlogError {\n  const args = rawArgs ?? {}\n  const {\n    message: messageOverride,\n    status,\n    why,\n    fix,\n    link,\n    cause,\n    internal: callInternal,\n    ...maybeParams\n  } = args as ErrorFactoryOverrides & Record<string, unknown>\n\n  let message: string\n  if (typeof messageOverride === 'string') {\n    message = messageOverride\n  } else if (typeof entry.message === 'function') {\n    message = (entry.message as (p: unknown) => string)(maybeParams)\n  } else {\n    ({ message } = entry as { message: string })\n  }\n\n  let internal: Record<string, unknown> | undefined\n  if (entry.internal || callInternal) {\n    internal = { ...(entry.internal ?? {}), ...(callInternal ?? {}) }\n  }\n\n  return new EvlogError({\n    code,\n    message,\n    status: status ?? entry.status ?? 500,\n    why: why ?? entry.why,\n    fix: fix ?? entry.fix,\n    link: link ?? entry.link,\n    cause: cause as Error | undefined,\n    internal,\n  })\n}\n\n/**\n * Define a single, standalone error factory bound to a stable `code`.\n *\n * Each factory produces an {@link EvlogError} with the entry's defaults\n * applied. Call-site overrides (`cause`, `internal`, `message`, ...) are\n * shallow-merged onto those defaults.\n *\n * @example\n * ```ts\n * import { defineError } from 'evlog'\n *\n * export const PaymentDeclined = defineError('billing.PAYMENT_DECLINED', {\n *   status: 402,\n *   message: 'Card declined',\n *   why: 'Issuer declined the charge',\n *   fix: 'Try another card',\n * })\n *\n * throw PaymentDeclined()\n * throw PaymentDeclined({ cause: stripeErr, internal: { ref: 'ch_x' } })\n * ```\n *\n * @example Templated message with typed params\n * ```ts\n * export const InsufficientFunds = defineError('billing.INSUFFICIENT_FUNDS', {\n *   status: 402,\n *   message: ({ available, required }: { available: number, required: number }) =>\n *     `Insufficient funds: $${available}/$${required}`,\n * })\n *\n * throw InsufficientFunds({ available: 5, required: 100 })\n * ```\n */\nexport function defineError<\n  const TCode extends string,\n  const TEntry extends ErrorCatalogEntry,\n>(code: TCode, entry: TEntry): DefinedError<TCode, TEntry> {\n  const factory = ((...args: unknown[]) =>\n    buildEvlogError(code, entry, args[0] as Record<string, unknown> | undefined)) as unknown as DefinedError<TCode, TEntry>\n\n  Object.defineProperties(factory, {\n    code: { value: code, enumerable: true },\n    status: { value: entry.status ?? 500, enumerable: true },\n    message: { value: entry.message, enumerable: true },\n    why: { value: entry.why, enumerable: true },\n    fix: { value: entry.fix, enumerable: true },\n    link: { value: entry.link, enumerable: true },\n    tags: { value: entry.tags, enumerable: true },\n    internal: { value: entry.internal, enumerable: true },\n  })\n\n  return factory\n}\n\n/** Map of error catalog entries keyed by their (UPPER_SNAKE) name. */\nexport interface ErrorCatalogMap {\n  readonly [key: string]: ErrorCatalogEntry\n}\n\n/**\n * The object returned by {@link defineErrorCatalog}. Each map key becomes a\n * dot-accessed factory whose `code` is `${prefix}.${key}` (preserved casing).\n *\n * Catalog metadata (`_prefix`, `_codes`) is exposed as non-enumerable readonly\n * properties so it does not pollute iteration but is available for typing\n * (`declare module 'evlog'`) and runtime introspection.\n */\nexport type ErrorCatalog<TPrefix extends string, TMap extends ErrorCatalogMap> =\n  & { [K in keyof TMap & string]: DefinedError<`${TPrefix}.${K}`, TMap[K]> }\n  & {\n    readonly _prefix: TPrefix\n    readonly _codes: ReadonlyArray<`${TPrefix}.${keyof TMap & string}`>\n  }\n\n/**\n * Define a bundle of errors that share a common prefix. The wire `code` for\n * each entry is `${prefix}.${KEY}` (the key's casing is preserved — convention\n * is `UPPER_SNAKE_CASE`).\n *\n * Pair with `declare module 'evlog'` to surface autocomplete + literal-typed\n * `code` everywhere across the codebase.\n *\n * @example\n * ```ts\n * import { defineErrorCatalog } from 'evlog'\n *\n * export const billingErrors = defineErrorCatalog('billing', {\n *   PAYMENT_DECLINED: { status: 402, message: 'Card declined' },\n *   INSUFFICIENT_FUNDS: {\n *     status: 402,\n *     message: ({ available, required }: { available: number, required: number }) =>\n *       `Insufficient funds: $${available}/$${required}`,\n *   },\n * })\n *\n * declare module 'evlog' {\n *   interface RegisteredErrorCatalogs {\n *     billing: typeof billingErrors\n *   }\n * }\n *\n * throw billingErrors.PAYMENT_DECLINED()\n * throw billingErrors.INSUFFICIENT_FUNDS({ available: 5, required: 100 })\n * ```\n */\nexport function defineErrorCatalog<\n  const TPrefix extends string,\n  const TMap extends ErrorCatalogMap,\n>(prefix: TPrefix, map: TMap): ErrorCatalog<TPrefix, TMap> {\n  const out: Record<string, unknown> = {}\n  const codes: string[] = []\n\n  for (const key of Object.keys(map)) {\n    const code = `${prefix}.${key}`\n    out[key] = defineError(code, map[key])\n    codes.push(code)\n  }\n\n  Object.defineProperties(out, {\n    _prefix: { value: prefix, enumerable: false },\n    _codes: { value: Object.freeze(codes), enumerable: false },\n  })\n\n  return out as ErrorCatalog<TPrefix, TMap>\n}\n\n/** Static metadata for a single entry in an audit catalog. */\nexport interface AuditCatalogEntry {\n  /** Default `target.type` for every audit emitted from this action. */\n  target?: string\n}\n\n/** Map of audit catalog entries keyed by their (UPPER_SNAKE) name. */\nexport interface AuditCatalogMap {\n  readonly [key: string]: AuditCatalogEntry\n}\n\n/** A factory produced by an audit catalog entry. Returns an {@link AuditInput}. */\nexport type DefinedCatalogAudit<TAction extends string, TEntry extends AuditCatalogEntry> =\n  & ((\n    input: TEntry['target'] extends string\n      ? Omit<AuditInput, 'action' | 'target'> & { target?: Omit<AuditTarget, 'type'> & { type?: TEntry['target'] } }\n      : Omit<AuditInput, 'action'>,\n  ) => AuditInput)\n  & {\n    readonly action: TAction\n    readonly target: TEntry['target']\n  }\n\n/**\n * The object returned by {@link defineAuditCatalog}. Mirrors\n * {@link ErrorCatalog} but each factory produces an {@link AuditInput}\n * (typically passed to `log.audit(...)`).\n */\nexport type AuditCatalog<TPrefix extends string, TMap extends AuditCatalogMap> =\n  & { [K in keyof TMap & string]: DefinedCatalogAudit<`${TPrefix}.${K}`, TMap[K]> }\n  & {\n    readonly _prefix: TPrefix\n    readonly _actions: ReadonlyArray<`${TPrefix}.${keyof TMap & string}`>\n  }\n\n/**\n * Define a bundle of audit actions that share a common prefix. The wire\n * `action` for each entry is `${prefix}.${KEY}`.\n *\n * Each entry produces a thin wrapper around {@link defineAuditAction} (target\n * type is fixed at definition time, action name is auto-prefixed).\n *\n * @example\n * ```ts\n * import { defineAuditCatalog } from 'evlog'\n *\n * export const billingAudit = defineAuditCatalog('billing', {\n *   INVOICE_REFUND: { target: 'invoice' },\n *   INVOICE_CREATE: { target: 'invoice' },\n * })\n *\n * declare module 'evlog' {\n *   interface RegisteredAuditCatalogs {\n *     billing: typeof billingAudit\n *   }\n * }\n *\n * log.audit(billingAudit.INVOICE_REFUND({\n *   actor: { type: 'user', id: u.id },\n *   target: { id: 'inv_889' },\n * }))\n * ```\n */\nexport function defineAuditCatalog<\n  const TPrefix extends string,\n  const TMap extends AuditCatalogMap,\n>(prefix: TPrefix, map: TMap): AuditCatalog<TPrefix, TMap> {\n  const out: Record<string, unknown> = {}\n  const actions: string[] = []\n\n  for (const key of Object.keys(map)) {\n    const action = `${prefix}.${key}`\n    const entry = map[key]\n    const fn = defineAuditAction(action, entry.target ? { target: entry.target } : undefined) as ((input: unknown) => AuditInput) & { action: string, target?: string }\n    Object.defineProperties(fn, {\n      action: { value: action, enumerable: true },\n      target: { value: entry.target, enumerable: true },\n    })\n    out[key] = fn\n    actions.push(action)\n  }\n\n  Object.defineProperties(out, {\n    _prefix: { value: prefix, enumerable: false },\n    _actions: { value: Object.freeze(actions), enumerable: false },\n  })\n\n  return out as AuditCatalog<TPrefix, TMap>\n}\n"],"mappings":";;;;;;;AAwFA,SAAS,gBACP,MACA,OACA,SACY;CAEZ,MAAM,EACJ,SAAS,iBACT,QACA,KACA,KACA,MACA,OACA,UAAU,cACV,GAAG,gBATQ,WAAW,EAAE;CAY1B,IAAI;AACJ,KAAI,OAAO,oBAAoB,SAC7B,WAAU;UACD,OAAO,MAAM,YAAY,WAClC,WAAW,MAAM,QAAmC,YAAY;KAEhE,EAAC,CAAE,WAAY;CAGjB,IAAI;AACJ,KAAI,MAAM,YAAY,aACpB,YAAW;EAAE,GAAI,MAAM,YAAY,EAAE;EAAG,GAAI,gBAAgB,EAAE;EAAG;AAGnE,QAAO,IAAI,WAAW;EACpB;EACA;EACA,QAAQ,UAAU,MAAM,UAAU;EAClC,KAAK,OAAO,MAAM;EAClB,KAAK,OAAO,MAAM;EAClB,MAAM,QAAQ,MAAM;EACb;EACP;EACD,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAoCJ,SAAgB,YAGd,MAAa,OAA4C;CACzD,MAAM,YAAY,GAAG,SACnB,gBAAgB,MAAM,OAAO,KAAK,GAA0C;AAE9E,QAAO,iBAAiB,SAAS;EAC/B,MAAM;GAAE,OAAO;GAAM,YAAY;GAAM;EACvC,QAAQ;GAAE,OAAO,MAAM,UAAU;GAAK,YAAY;GAAM;EACxD,SAAS;GAAE,OAAO,MAAM;GAAS,YAAY;GAAM;EACnD,KAAK;GAAE,OAAO,MAAM;GAAK,YAAY;GAAM;EAC3C,KAAK;GAAE,OAAO,MAAM;GAAK,YAAY;GAAM;EAC3C,MAAM;GAAE,OAAO,MAAM;GAAM,YAAY;GAAM;EAC7C,MAAM;GAAE,OAAO,MAAM;GAAM,YAAY;GAAM;EAC7C,UAAU;GAAE,OAAO,MAAM;GAAU,YAAY;GAAM;EACtD,CAAC;AAEF,QAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAsDT,SAAgB,mBAGd,QAAiB,KAAwC;CACzD,MAAM,MAA+B,EAAE;CACvC,MAAM,QAAkB,EAAE;AAE1B,MAAK,MAAM,OAAO,OAAO,KAAK,IAAI,EAAE;EAClC,MAAM,OAAO,GAAG,OAAO,GAAG;AAC1B,MAAI,OAAO,YAAY,MAAM,IAAI,KAAK;AACtC,QAAM,KAAK,KAAK;;AAGlB,QAAO,iBAAiB,KAAK;EAC3B,SAAS;GAAE,OAAO;GAAQ,YAAY;GAAO;EAC7C,QAAQ;GAAE,OAAO,OAAO,OAAO,MAAM;GAAE,YAAY;GAAO;EAC3D,CAAC;AAEF,QAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkET,SAAgB,mBAGd,QAAiB,KAAwC;CACzD,MAAM,MAA+B,EAAE;CACvC,MAAM,UAAoB,EAAE;AAE5B,MAAK,MAAM,OAAO,OAAO,KAAK,IAAI,EAAE;EAClC,MAAM,SAAS,GAAG,OAAO,GAAG;EAC5B,MAAM,QAAQ,IAAI;EAClB,MAAM,KAAK,kBAAkB,QAAQ,MAAM,SAAS,EAAE,QAAQ,MAAM,QAAQ,GAAG,KAAA,EAAU;AACzF,SAAO,iBAAiB,IAAI;GAC1B,QAAQ;IAAE,OAAO;IAAQ,YAAY;IAAM;GAC3C,QAAQ;IAAE,OAAO,MAAM;IAAQ,YAAY;IAAM;GAClD,CAAC;AACF,MAAI,OAAO;AACX,UAAQ,KAAK,OAAO;;AAGtB,QAAO,iBAAiB,KAAK;EAC3B,SAAS;GAAE,OAAO;GAAQ,YAAY;GAAO;EAC7C,UAAU;GAAE,OAAO,OAAO,OAAO,QAAQ;GAAE,YAAY;GAAO;EAC/D,CAAC;AAEF,QAAO"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/catalog.ts"],"sourcesContent":["import type { AuditActionDefinition, AuditTarget } from './types'\nimport { defineAuditAction } from './audit'\nimport { EvlogError } from './error'\n\n/**\n * Static metadata for a single entry in an error catalog.\n *\n * `message` is either a constant string or a function that receives required\n * params at the call site (typed). All other fields are templated defaults\n * that can be overridden at the call site.\n */\nexport interface ErrorCatalogEntry {\n  /** HTTP status code (default: 500). */\n  status?: number\n  /**\n   * Either a constant string or a typed function whose params become required\n   * arguments at the call site (`factory({ available, required })`).\n   */\n  message: string | ((params: never) => string)\n  /** Why this error occurred (technical reason). */\n  why?: string\n  /** Actionable fix shown to the user. */\n  fix?: string\n  /** Link to documentation. */\n  link?: string\n  /** Free-form metadata for grouping / filtering (not surfaced on the wire). */\n  tags?: readonly string[]\n  /**\n   * Backend-only context defaults. Merged with call-site `internal` (call-site wins).\n   */\n  internal?: Record<string, unknown>\n}\n\n/**\n * Subset of {@link import('./types').ErrorOptions} that callers may override\n * when invoking a catalog factory. `code` is always derived from the catalog\n * and intentionally excluded — pass `cause` here for error chaining.\n */\nexport interface ErrorFactoryOverrides {\n  message?: string\n  status?: number\n  why?: string\n  fix?: string\n  link?: string\n  internal?: Record<string, unknown>\n  cause?: Error\n}\n\n/** @internal Extract the params object type from a templated message function. */\ntype MessageParams<TMessage> = TMessage extends (params: infer P) => string ? P : Record<string, never>\n\n/**\n * Call-site argument type for a catalog factory:\n * - if `message` is a function: required params object merged with overrides\n * - if `message` is a string: optional overrides only\n */\nexport type ErrorFactoryOpts<TEntry extends ErrorCatalogEntry> =\n  TEntry['message'] extends (params: infer _P) => string\n    ? MessageParams<TEntry['message']> & ErrorFactoryOverrides\n    : ErrorFactoryOverrides\n\n/** @internal When message is a string, the call-site argument is optional. */\ntype FactoryArgs<TEntry extends ErrorCatalogEntry> =\n  TEntry['message'] extends (params: never) => string\n    ? [opts: ErrorFactoryOpts<TEntry>]\n    : [opts?: ErrorFactoryOpts<TEntry>]\n\n/**\n * A factory produced by {@link defineError} or each entry of\n * {@link defineErrorCatalog}. Calling it returns a fully-formed\n * {@link EvlogError} with the catalog's defaults applied. Static metadata\n * is exposed as readonly properties for introspection / refactor-safe\n * comparisons (`err.code === MyError.code`).\n */\nexport type DefinedError<TCode extends string, TEntry extends ErrorCatalogEntry> =\n  & ((...args: FactoryArgs<TEntry>) => EvlogError)\n  & {\n    readonly code: TCode\n    readonly status: number\n    readonly message: TEntry['message']\n    readonly why: TEntry['why']\n    readonly fix: TEntry['fix']\n    readonly link: TEntry['link']\n    readonly tags: TEntry['tags']\n    readonly internal: TEntry['internal']\n  }\n\nfunction buildEvlogError(\n  code: string,\n  entry: ErrorCatalogEntry,\n  rawArgs: Record<string, unknown> | undefined,\n): EvlogError {\n  const args = rawArgs ?? {}\n  const {\n    message: messageOverride,\n    status,\n    why,\n    fix,\n    link,\n    cause,\n    internal: callInternal,\n    ...maybeParams\n  } = args as ErrorFactoryOverrides & Record<string, unknown>\n\n  let message: string\n  if (typeof messageOverride === 'string') {\n    message = messageOverride\n  } else if (typeof entry.message === 'function') {\n    message = (entry.message as (p: unknown) => string)(maybeParams)\n  } else {\n    ({ message } = entry as { message: string })\n  }\n\n  let internal: Record<string, unknown> | undefined\n  if (entry.internal || callInternal) {\n    internal = { ...(entry.internal ?? {}), ...(callInternal ?? {}) }\n  }\n\n  return new EvlogError({\n    code,\n    message,\n    status: status ?? entry.status ?? 500,\n    why: why ?? entry.why,\n    fix: fix ?? entry.fix,\n    link: link ?? entry.link,\n    cause: cause as Error | undefined,\n    internal,\n  })\n}\n\n/**\n * Define a single, standalone error factory bound to a stable `code`.\n *\n * Each factory produces an {@link EvlogError} with the entry's defaults\n * applied. Call-site overrides (`cause`, `internal`, `message`, ...) are\n * shallow-merged onto those defaults.\n *\n * @example\n * ```ts\n * import { defineError } from 'evlog'\n *\n * export const PaymentDeclined = defineError('billing.PAYMENT_DECLINED', {\n *   status: 402,\n *   message: 'Card declined',\n *   why: 'Issuer declined the charge',\n *   fix: 'Try another card',\n * })\n *\n * throw PaymentDeclined()\n * throw PaymentDeclined({ cause: stripeErr, internal: { ref: 'ch_x' } })\n * ```\n *\n * @example Templated message with typed params\n * ```ts\n * export const InsufficientFunds = defineError('billing.INSUFFICIENT_FUNDS', {\n *   status: 402,\n *   message: ({ available, required }: { available: number, required: number }) =>\n *     `Insufficient funds: $${available}/$${required}`,\n * })\n *\n * throw InsufficientFunds({ available: 5, required: 100 })\n * ```\n */\nexport function defineError<\n  const TCode extends string,\n  const TEntry extends ErrorCatalogEntry,\n>(code: TCode, entry: TEntry): DefinedError<TCode, TEntry> {\n  const factory = ((...args: unknown[]) =>\n    buildEvlogError(code, entry, args[0] as Record<string, unknown> | undefined)) as unknown as DefinedError<TCode, TEntry>\n\n  Object.defineProperties(factory, {\n    code: { value: code, enumerable: true },\n    status: { value: entry.status ?? 500, enumerable: true },\n    message: { value: entry.message, enumerable: true },\n    why: { value: entry.why, enumerable: true },\n    fix: { value: entry.fix, enumerable: true },\n    link: { value: entry.link, enumerable: true },\n    tags: { value: entry.tags, enumerable: true },\n    internal: { value: entry.internal, enumerable: true },\n  })\n\n  return factory\n}\n\n/** Map of error catalog entries keyed by their (UPPER_SNAKE) name. */\nexport interface ErrorCatalogMap {\n  readonly [key: string]: ErrorCatalogEntry\n}\n\n/**\n * The object returned by {@link defineErrorCatalog}. Each map key becomes a\n * dot-accessed factory whose `code` is `${prefix}.${key}` (preserved casing).\n *\n * Catalog metadata (`_prefix`, `_codes`) is exposed as non-enumerable readonly\n * properties so it does not pollute iteration but is available for typing\n * (`declare module 'evlog'`) and runtime introspection.\n */\nexport type ErrorCatalog<TPrefix extends string, TMap extends ErrorCatalogMap> =\n  & { [K in keyof TMap & string]: DefinedError<`${TPrefix}.${K}`, TMap[K]> }\n  & {\n    readonly _prefix: TPrefix\n    readonly _codes: ReadonlyArray<`${TPrefix}.${keyof TMap & string}`>\n  }\n\n/**\n * Define a bundle of errors that share a common prefix. The wire `code` for\n * each entry is `${prefix}.${KEY}` (the key's casing is preserved — convention\n * is `UPPER_SNAKE_CASE`).\n *\n * Pair with `declare module 'evlog'` to surface autocomplete + literal-typed\n * `code` everywhere across the codebase.\n *\n * @example\n * ```ts\n * import { defineErrorCatalog } from 'evlog'\n *\n * export const billingErrors = defineErrorCatalog('billing', {\n *   PAYMENT_DECLINED: { status: 402, message: 'Card declined' },\n *   INSUFFICIENT_FUNDS: {\n *     status: 402,\n *     message: ({ available, required }: { available: number, required: number }) =>\n *       `Insufficient funds: $${available}/$${required}`,\n *   },\n * })\n *\n * declare module 'evlog' {\n *   interface RegisteredErrorCatalogs {\n *     billing: typeof billingErrors\n *   }\n * }\n *\n * throw billingErrors.PAYMENT_DECLINED()\n * throw billingErrors.INSUFFICIENT_FUNDS({ available: 5, required: 100 })\n * ```\n */\nexport function defineErrorCatalog<\n  const TPrefix extends string,\n  const TMap extends ErrorCatalogMap,\n>(prefix: TPrefix, map: TMap): ErrorCatalog<TPrefix, TMap> {\n  const out: Record<string, unknown> = {}\n  const codes: string[] = []\n\n  for (const key of Object.keys(map)) {\n    const code = `${prefix}.${key}`\n    out[key] = defineError(code, map[key])\n    codes.push(code)\n  }\n\n  Object.defineProperties(out, {\n    _prefix: { value: prefix, enumerable: false },\n    _codes: { value: Object.freeze(codes), enumerable: false },\n  })\n\n  return out as ErrorCatalog<TPrefix, TMap>\n}\n\n/** Static metadata for a single entry in an audit catalog. */\nexport type AuditCatalogEntry = AuditActionDefinition\n\n/** Map of audit catalog entries keyed by their (UPPER_SNAKE) name. */\nexport interface AuditCatalogMap {\n  readonly [key: string]: AuditCatalogEntry\n}\n\n/** A factory produced by an audit catalog entry. Returns an {@link AuditInput}. */\nexport type DefinedCatalogAudit<TAction extends string, TEntry extends AuditCatalogEntry> =\n  & ((\n    input: TEntry['target'] extends string\n      ? Omit<AuditInput, 'action' | 'target'> & { target?: Omit<AuditTarget, 'type'> & { type?: TEntry['target'] } }\n      : Omit<AuditInput, 'action'>,\n  ) => AuditInput)\n  & {\n    readonly action: TAction\n    readonly target: TEntry['target']\n    readonly description: TEntry['description']\n    readonly severity: TEntry['severity']\n    readonly requiresChanges: TEntry['requiresChanges']\n    readonly requiresReason: TEntry['requiresReason']\n    readonly redactPaths: TEntry['redactPaths']\n  }\n\n/**\n * The object returned by {@link defineAuditCatalog}. Mirrors\n * {@link ErrorCatalog} but each factory produces an {@link AuditInput}\n * (typically passed to `log.audit(...)`).\n */\nexport type AuditCatalog<TPrefix extends string, TMap extends AuditCatalogMap> =\n  & { [K in keyof TMap & string]: DefinedCatalogAudit<`${TPrefix}.${K}`, TMap[K]> }\n  & {\n    readonly _prefix: TPrefix\n    readonly _actions: ReadonlyArray<`${TPrefix}.${keyof TMap & string}`>\n  }\n\n/**\n * Define a bundle of audit actions that share a common prefix. The wire\n * `action` for each entry is `${prefix}.${KEY}`.\n *\n * Each entry produces a thin wrapper around {@link defineAuditAction} (target\n * type is fixed at definition time, action name is auto-prefixed).\n *\n * @example\n * ```ts\n * import { defineAuditCatalog } from 'evlog'\n *\n * export const billingAudit = defineAuditCatalog('billing', {\n *   INVOICE_REFUND: {\n *     target: 'invoice',\n *     severity: 'high',\n *     requiresChanges: true,\n *     description: 'Refund an invoice to the customer',\n *   },\n *   INVOICE_CREATE: { target: 'invoice' },\n * })\n *\n * declare module 'evlog' {\n *   interface RegisteredAuditCatalogs {\n *     billing: typeof billingAudit\n *   }\n * }\n *\n * log.audit(billingAudit.INVOICE_REFUND({\n *   actor: { type: 'user', id: u.id },\n *   target: { id: 'inv_889' },\n * }))\n * ```\n */\nexport function defineAuditCatalog<\n  const TPrefix extends string,\n  const TMap extends AuditCatalogMap,\n>(prefix: TPrefix, map: TMap): AuditCatalog<TPrefix, TMap> {\n  const out: Record<string, unknown> = {}\n  const actions: string[] = []\n\n  for (const key of Object.keys(map)) {\n    const action = `${prefix}.${key}`\n    const entry = map[key]\n    out[key] = defineAuditAction(action, entry)\n    actions.push(action)\n  }\n\n  Object.defineProperties(out, {\n    _prefix: { value: prefix, enumerable: false },\n    _actions: { value: Object.freeze(actions), enumerable: false },\n  })\n\n  return out as AuditCatalog<TPrefix, TMap>\n}\n"],"mappings":";;;;;;;AAuFA,SAAS,gBACP,MACA,OACA,SACY;CAEZ,MAAM,EACJ,SAAS,iBACT,QACA,KACA,KACA,MACA,OACA,UAAU,cACV,GAAG,gBATQ,WAAW,EAAE;CAY1B,IAAI;AACJ,KAAI,OAAO,oBAAoB,SAC7B,WAAU;UACD,OAAO,MAAM,YAAY,WAClC,WAAW,MAAM,QAAmC,YAAY;KAEhE,EAAC,CAAE,WAAY;CAGjB,IAAI;AACJ,KAAI,MAAM,YAAY,aACpB,YAAW;EAAE,GAAI,MAAM,YAAY,EAAE;EAAG,GAAI,gBAAgB,EAAE;EAAG;AAGnE,QAAO,IAAI,WAAW;EACpB;EACA;EACA,QAAQ,UAAU,MAAM,UAAU;EAClC,KAAK,OAAO,MAAM;EAClB,KAAK,OAAO,MAAM;EAClB,MAAM,QAAQ,MAAM;EACb;EACP;EACD,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAoCJ,SAAgB,YAGd,MAAa,OAA4C;CACzD,MAAM,YAAY,GAAG,SACnB,gBAAgB,MAAM,OAAO,KAAK,GAA0C;AAE9E,QAAO,iBAAiB,SAAS;EAC/B,MAAM;GAAE,OAAO;GAAM,YAAY;GAAM;EACvC,QAAQ;GAAE,OAAO,MAAM,UAAU;GAAK,YAAY;GAAM;EACxD,SAAS;GAAE,OAAO,MAAM;GAAS,YAAY;GAAM;EACnD,KAAK;GAAE,OAAO,MAAM;GAAK,YAAY;GAAM;EAC3C,KAAK;GAAE,OAAO,MAAM;GAAK,YAAY;GAAM;EAC3C,MAAM;GAAE,OAAO,MAAM;GAAM,YAAY;GAAM;EAC7C,MAAM;GAAE,OAAO,MAAM;GAAM,YAAY;GAAM;EAC7C,UAAU;GAAE,OAAO,MAAM;GAAU,YAAY;GAAM;EACtD,CAAC;AAEF,QAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAsDT,SAAgB,mBAGd,QAAiB,KAAwC;CACzD,MAAM,MAA+B,EAAE;CACvC,MAAM,QAAkB,EAAE;AAE1B,MAAK,MAAM,OAAO,OAAO,KAAK,IAAI,EAAE;EAClC,MAAM,OAAO,GAAG,OAAO,GAAG;AAC1B,MAAI,OAAO,YAAY,MAAM,IAAI,KAAK;AACtC,QAAM,KAAK,KAAK;;AAGlB,QAAO,iBAAiB,KAAK;EAC3B,SAAS;GAAE,OAAO;GAAQ,YAAY;GAAO;EAC7C,QAAQ;GAAE,OAAO,OAAO,OAAO,MAAM;GAAE,YAAY;GAAO;EAC3D,CAAC;AAEF,QAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyET,SAAgB,mBAGd,QAAiB,KAAwC;CACzD,MAAM,MAA+B,EAAE;CACvC,MAAM,UAAoB,EAAE;AAE5B,MAAK,MAAM,OAAO,OAAO,KAAK,IAAI,EAAE;EAClC,MAAM,SAAS,GAAG,OAAO,GAAG;EAC5B,MAAM,QAAQ,IAAI;AAClB,MAAI,OAAO,kBAAkB,QAAQ,MAAM;AAC3C,UAAQ,KAAK,OAAO;;AAGtB,QAAO,iBAAiB,KAAK;EAC3B,SAAS;GAAE,OAAO;GAAQ,YAAY;GAAO;EAC7C,UAAU;GAAE,OAAO,OAAO,OAAO,QAAQ;GAAE,YAAY;GAAO;EAC/D,CAAC;AAEF,QAAO"}

package/dist/instrumentation-create-BrjQtSKD.d.mts

@@ -0,0 +1,115 @@
+import { B as DrainContext, H as EnvironmentContext, X as LogLevel, ot as SamplingConfig } from "./audit-D7v6JHj0.mjs";
+
+//#region src/next/instrumentation-gate.d.ts
+/** Request payload passed to Next.js `onRequestError` (App Router). */
+interface NextInstrumentationRequest {
+  path: string;
+  method: string;
+  headers: Record<string, string>;
+}
+/** Routing context passed to Next.js `onRequestError`. */
+interface NextInstrumentationErrorContext {
+  routerKind: string;
+  routePath: string;
+  routeType: string;
+  renderSource: string;
+}
+/**
+ * What your instrumentation module should export for use with {@link defineNodeInstrumentation}
+ * (typically the return values of `createInstrumentation()` from `evlog/next/instrumentation/create`).
+ */
+interface NodeInstrumentationModule {
+  register: () => void | Promise<void>;
+  onRequestError: (error: {
+    digest?: string;
+  } & Error, request: NextInstrumentationRequest, context: NextInstrumentationErrorContext) => void | Promise<void>;
+}
+/**
+ * Hooks returned by {@link defineNodeInstrumentation} for root `instrumentation.ts`.
+ *
+ * - `register` — async startup hook; initializes the global logger on Node.js only.
+ * - `onRequestError` — logs SSR/RSC errors outside `withEvlog` via {@link NextInstrumentationRequest}
+ *   and {@link NextInstrumentationErrorContext}.
+ */
+type NodeInstrumentationHooks = {
+  /** Next.js instrumentation startup hook (Node.js runtime only). */register: () => Promise<void>; /** Next.js global request error handler (Node.js runtime only). */
+  onRequestError: (error: {
+    digest?: string;
+  } & Error, request: NextInstrumentationRequest, context: NextInstrumentationErrorContext) => Promise<void>;
+};
+/** Options for {@link defineNodeInstrumentation} or a custom Node-only module loader. */
+type DefineNodeInstrumentationInput = InstrumentationOptions | (() => Promise<NodeInstrumentationModule>);
+/**
+ * Root `instrumentation.ts` entry: load evlog only in the Node.js runtime so Edge bundles stay clean.
+ * Caches the dynamic `import()` so `register` and repeated `onRequestError` share one module instance.
+ *
+ * @example
+ * ```ts
+ * // instrumentation.ts
+ * import { defineNodeInstrumentation } from 'evlog/next/instrumentation'
+ *
+ * export const { register, onRequestError } = defineNodeInstrumentation({
+ *   service: 'my-app',
+ *   captureOutput: true,
+ * })
+ * ```
+ */
+declare function defineNodeInstrumentation(loaderOrOptions: DefineNodeInstrumentationInput): NodeInstrumentationHooks;
+//#endregion
+//#region src/next/instrumentation-create.d.ts
+/** Options for capturing process stdout/stderr as structured log events. */
+interface CaptureOutputOptions {
+  /** Capture stdout writes. @default true */
+  stdout?: boolean;
+  /** Capture stderr writes. @default true */
+  stderr?: boolean;
+  /**
+   * Skip re-emitting chunks that match these patterns as log events.
+   * When omitted, known Next.js Edge bundler warnings are ignored by default.
+   */
+  ignore?: Array<string | RegExp>;
+}
+/** Default patterns skipped by {@link CaptureOutputOptions.ignore}. */
+declare const DEFAULT_CAPTURE_OUTPUT_IGNORE: Array<string | RegExp>;
+/**
+ * Configuration for {@link createInstrumentation} and {@link defineNodeInstrumentation}.
+ * Controls global logger options and optional stdout/stderr capture (Node.js only).
+ */
+interface InstrumentationOptions {
+  /** Enable or disable all logging globally. @default true */
+  enabled?: boolean;
+  /** Service name for all logged events. */
+  service?: string;
+  /** Environment context overrides. */
+  env?: Partial<EnvironmentContext>;
+  /** Enable pretty printing. @default true in development */
+  pretty?: boolean;
+  /** Suppress built-in console output. @default false */
+  silent?: boolean;
+  /** Sampling configuration for filtering logs. */
+  sampling?: SamplingConfig;
+  /** Minimum severity for the global `log` API. @default 'debug' */
+  minLevel?: LogLevel;
+  /** When pretty is disabled, emit JSON strings or raw objects. @default true */
+  stringify?: boolean;
+  /** Drain callback called with every emitted event. */
+  drain?: (ctx: DrainContext) => void | Promise<void>;
+  /** Capture stdout/stderr as structured log events (Node.js only). */
+  captureOutput?: boolean | CaptureOutputOptions;
+}
+interface InstrumentationResult {
+  register: () => void | Promise<void>;
+  onRequestError: (error: {
+    digest?: string;
+  } & Error, request: NextInstrumentationRequest, context: NextInstrumentationErrorContext) => void | Promise<void>;
+}
+/**
+ * Create Next.js instrumentation hooks (`register`, `onRequestError`).
+ *
+ * Load via dynamic `import()` from root `instrumentation.ts` (Node.js runtime only).
+ * Load via dynamic `import()` from root `instrumentation.ts` with {@link defineNodeInstrumentation}.
+ */
+declare function createInstrumentation(options?: InstrumentationOptions): InstrumentationResult;
+//#endregion
+export { DefineNodeInstrumentationInput as a, NodeInstrumentationHooks as c, createInstrumentation as i, NodeInstrumentationModule as l, DEFAULT_CAPTURE_OUTPUT_IGNORE as n, NextInstrumentationErrorContext as o, InstrumentationOptions as r, NextInstrumentationRequest as s, CaptureOutputOptions as t, defineNodeInstrumentation as u };
+//# sourceMappingURL=instrumentation-create-BrjQtSKD.d.mts.map

package/dist/instrumentation-create-BrjQtSKD.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instrumentation-create-BrjQtSKD.d.mts","names":[],"sources":["../src/next/instrumentation-gate.ts","../src/next/instrumentation-create.ts"],"mappings":";;;;UAGiB,0BAAA;EACf,IAAA;EACA,MAAA;EACA,OAAA,EAAS,MAAA;AAAA;;UAIM,+BAAA;EACf,UAAA;EACA,SAAA;EACA,SAAA;EACA,YAAA;AAAA;;;;;UAOe,yBAAA;EACf,QAAA,eAAuB,OAAA;EACvB,cAAA,GACE,KAAA;IAAS,MAAA;EAAA,IAAoB,KAAA,EAC7B,OAAA,EAAS,0BAAA,EACT,OAAA,EAAS,+BAAA,YACC,OAAA;AAAA;;;;;;;;KAgCF,wBAAA;EAhCS,mEAkCnB,QAAA,QAAgB,OAAA,QAvCO;EAyCvB,cAAA,GACE,KAAA;IAAS,MAAA;EAAA,IAAoB,KAAA,EAC7B,OAAA,EAAS,0BAAA,EACT,OAAA,EAAS,+BAAA,KACN,OAAA;AAAA;;KAIK,8BAAA,GACR,sBAAA,UACO,OAAA,CAAQ,yBAAA;;;;;;AAdnB;;;;;;;;;;iBA+BgB,yBAAA,CACd,eAAA,EAAiB,8BAAA,GAChB,wBAAA;;;;UClFc,oBAAA;EDP0B;ECSzC,MAAA;EDNe;ECQf,MAAA;EDTA;;;;ECcA,MAAA,GAAS,KAAA,UAAe,MAAA;AAAA;;cAIb,6BAAA,EAA+B,KAAA,UAAe,MAAA;;;;;UAiB1C,sBAAA;ED1BH;EC4BZ,OAAA;EDrBe;ECuBf,OAAA;;EAEA,GAAA,GAAM,OAAA,CAAQ,kBAAA;EDtBiB;ECwB/B,MAAA;EDtBW;ECwBX,MAAA;EDvBmB;ECyBnB,QAAA,GAAW,cAAA;ED9BX;ECgCA,QAAA,GAAW,QAAA;ED/BX;ECiCA,SAAA;EDhC+B;ECkC/B,KAAA,IAAS,GAAA,EAAK,YAAA,YAAwB,OAAA;EDjC3B;ECmCX,aAAA,aAA0B,oBAAA;AAAA;AAAA,UAGlB,qBAAA;EACR,QAAA,eAAuB,OAAA;EACvB,cAAA,GACE,KAAA;IAAS,MAAA;EAAA,IAAoB,KAAA,EAC7B,OAAA,EAAS,0BAAA,EACT,OAAA,EAAS,+BAAA,YACC,OAAA;AAAA;;;;;;;iBAkHE,qBAAA,CAAsB,OAAA,GAAS,sBAAA,GAA8B,qBAAA"}

package/dist/{integration-Dhig7ae6.mjs → integration-DYp2uw8O.mjs}

@@ -1,5 +1,5 @@
-import { n as extractSafeNodeHeaders, t as extractSafeHeaders } from "./headers-CU-QqnYg.mjs";
-import { r as createMiddlewareLogger, t as attachForkToLogger } from "./fork-Bga8x-X4.mjs";
+import { n as extractSafeNodeHeaders, t as extractSafeHeaders } from "./headers-VtmnWcfn.mjs";
+import { r as createMiddlewareLogger, t as attachForkToLogger } from "./fork-CgGlAaHa.mjs";
 //#region src/shared/integration.ts
 function normalizeHeaders(headers) {
 	if (!headers) return void 0;
@@ -72,4 +72,4 @@ function defineFrameworkIntegration(spec) {
 //#endregion
 export { defineFrameworkIntegration as t };
 
-//# sourceMappingURL=integration-Dhig7ae6.mjs.map
+//# sourceMappingURL=integration-DYp2uw8O.mjs.map

package/dist/{integration-Dhig7ae6.mjs.map → integration-DYp2uw8O.mjs.map}

@@ -1 +1 @@
-{"version":3,"file":"integration-Dhig7ae6.mjs","names":[],"sources":["../src/shared/integration.ts"],"sourcesContent":["import type { AsyncLocalStorage } from 'node:async_hooks'\nimport type { RequestLogger } from '../types'\nimport { attachForkToLogger } from './fork'\nimport { extractSafeHeaders, extractSafeNodeHeaders } from './headers'\nimport type { BaseEvlogOptions, MiddlewareLoggerOptions, MiddlewareLoggerResult } from './middleware'\nimport { createMiddlewareLogger } from './middleware'\n\n/** Request shape extracted from a framework context. */\nexport interface ExtractedRequest {\n  method: string\n  path: string\n  /**\n   * Either a Web `Headers` (Hono / Elysia / Fetch) or a Node-style\n   * `IncomingHttpHeaders` record (Express / Fastify). Whichever is native\n   * to the framework — it gets filtered through the safe-header helpers.\n   */\n  headers?: Headers | Record<string, string | string[] | undefined>\n  /** Used as-is when present, otherwise auto-generated. */\n  requestId?: string\n}\n\n/** Manifest passed to {@link defineFrameworkIntegration}. */\nexport interface FrameworkIntegrationSpec<TCtx> {\n  /** Stable identifier used in error messages. */\n  name: string\n  extractRequest: (ctx: TCtx) => ExtractedRequest\n  /** Attach the request logger to the framework context (`c.set('log', logger)`). */\n  attachLogger: (ctx: TCtx, logger: RequestLogger) => void\n  /**\n   * AsyncLocalStorage instance backing `useLogger()`. Required for frameworks\n   * where the logger is accessed off the request context (Express, Fastify,\n   * NestJS). When set, `log.fork()` is auto-attached to the request logger.\n   */\n  storage?: AsyncLocalStorage<RequestLogger>\n  /** Fork lifecycle hooks (only used when `storage` is set). */\n  forkLifecycle?: import('./fork').ForkLifecycle\n}\n\n/** Result returned by {@link FrameworkIntegrationHelpers.start}. */\nexport interface FrameworkRequestHandle extends MiddlewareLoggerResult {\n  middlewareOptions: MiddlewareLoggerOptions\n  /**\n   * Run the downstream handler inside the integration's storage. When no\n   * storage is configured, the callback is invoked directly.\n   */\n  runWith: <T>(fn: () => T | Promise<T>) => Promise<T>\n}\n\n/** Helpers returned by {@link defineFrameworkIntegration}. */\nexport interface FrameworkIntegrationHelpers<TCtx> {\n  start: (ctx: TCtx, options?: BaseEvlogOptions) => FrameworkRequestHandle\n}\n\nfunction normalizeHeaders(headers: ExtractedRequest['headers']): Record<string, string> | undefined {\n  if (!headers) return undefined\n  if (typeof (headers as Headers).forEach === 'function' && typeof (headers as Headers).get === 'function') {\n    return extractSafeHeaders(headers as Headers)\n  }\n  return extractSafeNodeHeaders(headers as Record<string, string | string[] | undefined>)\n}\n\n/**\n * Build a manifest-driven framework integration. Captures the boilerplate\n * every middleware shares (request extraction, logger setup, attachment,\n * optional AsyncLocalStorage wrapping). The framework still owns its own\n * middleware function — it just declares *what* to extract and *where* to\n * attach the logger.\n *\n * @example\n * ```ts\n * const integration = defineFrameworkIntegration<HonoContext>({\n *   name: 'hono',\n *   extractRequest: (c) => ({\n *     method: c.req.method,\n *     path: c.req.path,\n *     headers: c.req.raw.headers,\n *     requestId: c.req.header('x-request-id'),\n *   }),\n *   attachLogger: (c, logger) => c.set('log', logger),\n * })\n *\n * export function evlog(options?: BaseEvlogOptions): MiddlewareHandler {\n *   return async (c, next) => {\n *     const { skipped, finish, runWith } = integration.start(c, options)\n *     if (skipped) return next()\n *     try {\n *       await runWith(() => next())\n *       await finish({ status: c.res.status })\n *     } catch (error) {\n *       await finish({ error: error as Error })\n *       throw error\n *     }\n *   }\n * }\n * ```\n */\nexport function defineFrameworkIntegration<TCtx>(\n  spec: FrameworkIntegrationSpec<TCtx>,\n): FrameworkIntegrationHelpers<TCtx> {\n  return {\n    start(ctx, options = {}) {\n      const extracted = spec.extractRequest(ctx)\n      const headers = normalizeHeaders(extracted.headers)\n      const middlewareOptions: MiddlewareLoggerOptions = {\n        method: extracted.method,\n        path: extracted.path,\n        requestId: extracted.requestId || crypto.randomUUID(),\n        headers,\n        ...options,\n      }\n      const result = createMiddlewareLogger(middlewareOptions)\n\n      if (!result.skipped) {\n        if (spec.storage) {\n          attachForkToLogger(spec.storage, result.logger, middlewareOptions, spec.forkLifecycle)\n        }\n        spec.attachLogger(ctx, result.logger)\n      }\n\n      const { storage } = spec\n      const runWith = async <T>(fn: () => T | Promise<T>): Promise<T> => {\n        if (!storage || result.skipped) return await fn()\n        return await storage.run(result.logger, fn)\n      }\n\n      return { ...result, middlewareOptions, runWith }\n    },\n  }\n}\n"],"mappings":";;;AAqDA,SAAS,iBAAiB,SAA0E;AAClG,KAAI,CAAC,QAAS,QAAO,KAAA;AACrB,KAAI,OAAQ,QAAoB,YAAY,cAAc,OAAQ,QAAoB,QAAQ,WAC5F,QAAO,mBAAmB,QAAmB;AAE/C,QAAO,uBAAuB,QAAyD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAsCzF,SAAgB,2BACd,MACmC;AACnC,QAAO,EACL,MAAM,KAAK,UAAU,EAAE,EAAE;EACvB,MAAM,YAAY,KAAK,eAAe,IAAI;EAC1C,MAAM,UAAU,iBAAiB,UAAU,QAAQ;EACnD,MAAM,oBAA6C;GACjD,QAAQ,UAAU;GAClB,MAAM,UAAU;GAChB,WAAW,UAAU,aAAa,OAAO,YAAY;GACrD;GACA,GAAG;GACJ;EACD,MAAM,SAAS,uBAAuB,kBAAkB;AAExD,MAAI,CAAC,OAAO,SAAS;AACnB,OAAI,KAAK,QACP,oBAAmB,KAAK,SAAS,OAAO,QAAQ,mBAAmB,KAAK,cAAc;AAExF,QAAK,aAAa,KAAK,OAAO,OAAO;;EAGvC,MAAM,EAAE,YAAY;EACpB,MAAM,UAAU,OAAU,OAAyC;AACjE,OAAI,CAAC,WAAW,OAAO,QAAS,QAAO,MAAM,IAAI;AACjD,UAAO,MAAM,QAAQ,IAAI,OAAO,QAAQ,GAAG;;AAG7C,SAAO;GAAE,GAAG;GAAQ;GAAmB;GAAS;IAEnD"}
+{"version":3,"file":"integration-DYp2uw8O.mjs","names":[],"sources":["../src/shared/integration.ts"],"sourcesContent":["import type { AsyncLocalStorage } from 'node:async_hooks'\nimport type { RequestLogger } from '../types'\nimport { attachForkToLogger } from './fork'\nimport { extractSafeHeaders, extractSafeNodeHeaders } from './headers'\nimport type { BaseEvlogOptions, MiddlewareLoggerOptions, MiddlewareLoggerResult } from './middleware'\nimport { createMiddlewareLogger } from './middleware'\n\n/** Request shape extracted from a framework context. */\nexport interface ExtractedRequest {\n  method: string\n  path: string\n  /**\n   * Either a Web `Headers` (Hono / Elysia / Fetch) or a Node-style\n   * `IncomingHttpHeaders` record (Express / Fastify). Whichever is native\n   * to the framework — it gets filtered through the safe-header helpers.\n   */\n  headers?: Headers | Record<string, string | string[] | undefined>\n  /** Used as-is when present, otherwise auto-generated. */\n  requestId?: string\n}\n\n/** Manifest passed to {@link defineFrameworkIntegration}. */\nexport interface FrameworkIntegrationSpec<TCtx> {\n  /** Stable identifier used in error messages. */\n  name: string\n  extractRequest: (ctx: TCtx) => ExtractedRequest\n  /** Attach the request logger to the framework context (`c.set('log', logger)`). */\n  attachLogger: (ctx: TCtx, logger: RequestLogger) => void\n  /**\n   * AsyncLocalStorage instance backing `useLogger()`. Required for frameworks\n   * where the logger is accessed off the request context (Express, Fastify,\n   * NestJS). When set, `log.fork()` is auto-attached to the request logger.\n   */\n  storage?: AsyncLocalStorage<RequestLogger>\n  /** Fork lifecycle hooks (only used when `storage` is set). */\n  forkLifecycle?: import('./fork').ForkLifecycle\n}\n\n/** Result returned by {@link FrameworkIntegrationHelpers.start}. */\nexport interface FrameworkRequestHandle extends MiddlewareLoggerResult {\n  middlewareOptions: MiddlewareLoggerOptions\n  /**\n   * Run the downstream handler inside the integration's storage. When no\n   * storage is configured, the callback is invoked directly.\n   */\n  runWith: <T>(fn: () => T | Promise<T>) => Promise<T>\n}\n\n/** Helpers returned by {@link defineFrameworkIntegration}. */\nexport interface FrameworkIntegrationHelpers<TCtx> {\n  start: (ctx: TCtx, options?: BaseEvlogOptions) => FrameworkRequestHandle\n}\n\nfunction normalizeHeaders(headers: ExtractedRequest['headers']): Record<string, string> | undefined {\n  if (!headers) return undefined\n  if (typeof (headers as Headers).forEach === 'function' && typeof (headers as Headers).get === 'function') {\n    return extractSafeHeaders(headers as Headers)\n  }\n  return extractSafeNodeHeaders(headers as Record<string, string | string[] | undefined>)\n}\n\n/**\n * Build a manifest-driven framework integration. Captures the boilerplate\n * every middleware shares (request extraction, logger setup, attachment,\n * optional AsyncLocalStorage wrapping). The framework still owns its own\n * middleware function — it just declares *what* to extract and *where* to\n * attach the logger.\n *\n * @example\n * ```ts\n * const integration = defineFrameworkIntegration<HonoContext>({\n *   name: 'hono',\n *   extractRequest: (c) => ({\n *     method: c.req.method,\n *     path: c.req.path,\n *     headers: c.req.raw.headers,\n *     requestId: c.req.header('x-request-id'),\n *   }),\n *   attachLogger: (c, logger) => c.set('log', logger),\n * })\n *\n * export function evlog(options?: BaseEvlogOptions): MiddlewareHandler {\n *   return async (c, next) => {\n *     const { skipped, finish, runWith } = integration.start(c, options)\n *     if (skipped) return next()\n *     try {\n *       await runWith(() => next())\n *       await finish({ status: c.res.status })\n *     } catch (error) {\n *       await finish({ error: error as Error })\n *       throw error\n *     }\n *   }\n * }\n * ```\n */\nexport function defineFrameworkIntegration<TCtx>(\n  spec: FrameworkIntegrationSpec<TCtx>,\n): FrameworkIntegrationHelpers<TCtx> {\n  return {\n    start(ctx, options = {}) {\n      const extracted = spec.extractRequest(ctx)\n      const headers = normalizeHeaders(extracted.headers)\n      const middlewareOptions: MiddlewareLoggerOptions = {\n        method: extracted.method,\n        path: extracted.path,\n        requestId: extracted.requestId || crypto.randomUUID(),\n        headers,\n        ...options,\n      }\n      const result = createMiddlewareLogger(middlewareOptions)\n\n      if (!result.skipped) {\n        if (spec.storage) {\n          attachForkToLogger(spec.storage, result.logger, middlewareOptions, spec.forkLifecycle)\n        }\n        spec.attachLogger(ctx, result.logger)\n      }\n\n      const { storage } = spec\n      const runWith = async <T>(fn: () => T | Promise<T>): Promise<T> => {\n        if (!storage || result.skipped) return await fn()\n        return await storage.run(result.logger, fn)\n      }\n\n      return { ...result, middlewareOptions, runWith }\n    },\n  }\n}\n"],"mappings":";;;AAqDA,SAAS,iBAAiB,SAA0E;AAClG,KAAI,CAAC,QAAS,QAAO,KAAA;AACrB,KAAI,OAAQ,QAAoB,YAAY,cAAc,OAAQ,QAAoB,QAAQ,WAC5F,QAAO,mBAAmB,QAAmB;AAE/C,QAAO,uBAAuB,QAAyD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAsCzF,SAAgB,2BACd,MACmC;AACnC,QAAO,EACL,MAAM,KAAK,UAAU,EAAE,EAAE;EACvB,MAAM,YAAY,KAAK,eAAe,IAAI;EAC1C,MAAM,UAAU,iBAAiB,UAAU,QAAQ;EACnD,MAAM,oBAA6C;GACjD,QAAQ,UAAU;GAClB,MAAM,UAAU;GAChB,WAAW,UAAU,aAAa,OAAO,YAAY;GACrD;GACA,GAAG;GACJ;EACD,MAAM,SAAS,uBAAuB,kBAAkB;AAExD,MAAI,CAAC,OAAO,SAAS;AACnB,OAAI,KAAK,QACP,oBAAmB,KAAK,SAAS,OAAO,QAAQ,mBAAmB,KAAK,cAAc;AAExF,QAAK,aAAa,KAAK,OAAO,OAAO;;EAGvC,MAAM,EAAE,YAAY;EACpB,MAAM,UAAU,OAAU,OAAyC;AACjE,OAAI,CAAC,WAAW,OAAO,QAAS,QAAO,MAAM,IAAI;AACjD,UAAO,MAAM,QAAQ,IAAI,OAAO,QAAQ,GAAG;;AAG7C,SAAO;GAAE,GAAG;GAAQ;GAAmB;GAAS;IAEnD"}

package/dist/{logger-CTcvd5Cc.d.mts → logger-mHIWxBhJ.d.mts}

@@ -1,10 +1,18 @@
-import { G as Log, I as DrainContext, R as EnvironmentContext, dt as PluginRunner, et as RequestLoggerOptions, ot as TailSamplingContext, q as LoggerConfig, u as AuditableLogger } from "./audit-DVdkntSO.mjs";
+import { B as DrainContext, H as EnvironmentContext, Y as Log, Z as LoggerConfig, ft as WideEvent, gt as PluginRunner, it as RequestLoggerOptions, l as AuditableLogger, ut as TailSamplingContext } from "./audit-D7v6JHj0.mjs";
 
 //#region src/logger.d.ts
+/** Cross-bundle global slot for the native stdout write registered by captureOutput patching. */
+interface EvlogProcessOutputGlobal {
+  __evlogNativeStdoutWrite?: typeof process.stdout.write;
+}
 declare function mergeInto(target: Record<string, unknown>, source: Record<string, unknown>): void;
 /**
- * @internal Wide-event field merge — exported for test mocks that mirror emit accumulation.
+ * Mark a wide event as past the post-emit AI merge window so late `log.set({ ai })`
+ * calls warn again. Called by framework enrich/drain pipelines before drain runs.
+ *
+ * @internal Used by middleware and framework integrations.
  */
+declare function markWideEventDrainStarted(event: WideEvent | null): void;
 /**
  * Initialize the logger with configuration.
  * Call this once at application startup.
@@ -114,5 +122,5 @@ declare function createRequestLogger<T extends object = Record<string, unknown>>
  */
 declare function getEnvironment(): EnvironmentContext;
 //#endregion
-export { getGlobalDrain as a, isEnabled as c, mergeInto as d, shouldKeep as f, getEnvironment as i, isLoggerLocked as l, createLogger as n, getGlobalPluginRunner as o, createRequestLogger as r, initLogger as s, _log as t, lockLogger as u };
-//# sourceMappingURL=logger-CTcvd5Cc.d.mts.map
+export { getEnvironment as a, initLogger as c, lockLogger as d, markWideEventDrainStarted as f, createRequestLogger as i, isEnabled as l, shouldKeep as m, _log as n, getGlobalDrain as o, mergeInto as p, createLogger as r, getGlobalPluginRunner as s, EvlogProcessOutputGlobal as t, isLoggerLocked as u };
+//# sourceMappingURL=logger-mHIWxBhJ.d.mts.map

package/dist/logger-mHIWxBhJ.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger-mHIWxBhJ.d.mts","names":[],"sources":["../src/logger.ts"],"mappings":";;;AAkBA;AAAA,UAAiB,wBAAA;EACf,wBAAA,UAAkC,OAAA,CAAQ,MAAA,CAAO,KAAA;AAAA;AAAA,iBA6B1C,SAAA,CAAU,MAAA,EAAQ,MAAA,mBAAyB,MAAA,EAAQ,MAAA;;;;;;AA5B3D;iBAwDe,yBAAA,CAA0B,KAAA,EAAO,SAAA;;;;;iBAsCjC,UAAA,CAAW,MAAA,GAAQ,YAAA;;;;;AAAnC;iBA+CgB,qBAAA,CAAA,GAAyB,YAAA;;;;iBAOzB,SAAA,CAAA;;;;;AAAhB;iBASgB,UAAA,CAAA;;;;iBAOA,cAAA,CAAA;;;;;AAAhB;iBASgB,cAAA,CAAA,KAAoB,GAAA,EAAK,YAAA,YAAwB,OAAA;;;;AAAjE;iBA8BgB,UAAA,CAAW,GAAA,EAAK,mBAAA;;;;;;;;AAAhC;;cA4gBM,IAAA,EAAM,GAAA;;AA5fX;;UAwhBS,2BAAA;EA5BE;;AAOU;;EA0BpB,WAAA;EAI6B;;;EAA7B,SAAA,IAAa,OAAA,EAAS,OAAA;AAAA;;;AAkBxB;;;;;;;;;;;;;iBAAgB,YAAA,oBAAgC,MAAA,kBAAA,CAAyB,cAAA,GAAgB,MAAA,mBAA8B,eAAA,GAAkB,2BAAA,GAA8B,eAAA,CAAgB,CAAA;;;;;;;AAiOvL;;;;;;;;;;;;;;;;;;;;AAeA;iBAfgB,mBAAA,oBAAuC,MAAA,kBAAA,CAAyB,OAAA,GAAS,oBAAA,EAA2B,eAAA,GAAkB,2BAAA,GAA8B,eAAA,CAAgB,CAAA;;;;iBAepK,cAAA,CAAA,GAAkB,kBAAA"}

package/dist/logger.d.mts

@@ -1,2 +1,2 @@
-import { a as getGlobalDrain, c as isEnabled, d as mergeInto, f as shouldKeep, i as getEnvironment, l as isLoggerLocked, n as createLogger, o as getGlobalPluginRunner, r as createRequestLogger, s as initLogger, t as _log, u as lockLogger } from "./logger-CTcvd5Cc.mjs";
-export { createLogger, createRequestLogger, getEnvironment, getGlobalDrain, getGlobalPluginRunner, initLogger, isEnabled, isLoggerLocked, lockLogger, _log as log, mergeInto as mergeWideEventFields, shouldKeep };
+import { a as getEnvironment, c as initLogger, d as lockLogger, f as markWideEventDrainStarted, i as createRequestLogger, l as isEnabled, m as shouldKeep, n as _log, o as getGlobalDrain, p as mergeInto, r as createLogger, s as getGlobalPluginRunner, t as EvlogProcessOutputGlobal, u as isLoggerLocked } from "./logger-mHIWxBhJ.mjs";
+export { EvlogProcessOutputGlobal, createLogger, createRequestLogger, getEnvironment, getGlobalDrain, getGlobalPluginRunner, initLogger, isEnabled, isLoggerLocked, lockLogger, _log as log, markWideEventDrainStarted, mergeInto as mergeWideEventFields, shouldKeep };

package/dist/logger.mjs

@@ -1,2 +1,2 @@
-import { C as lockLogger, S as isLoggerLocked, T as shouldKeep, _ as getEnvironment, b as initLogger, g as createRequestLogger, h as createLogger, m as _log, v as getGlobalDrain, w as mergeInto, x as isEnabled, y as getGlobalPluginRunner } from "./audit-BUI3af4w.mjs";
-export { createLogger, createRequestLogger, getEnvironment, getGlobalDrain, getGlobalPluginRunner, initLogger, isEnabled, isLoggerLocked, lockLogger, _log as log, mergeInto as mergeWideEventFields, shouldKeep };
+import { C as lockLogger, E as shouldKeep, S as isLoggerLocked, T as mergeInto, _ as getEnvironment, b as initLogger, g as createRequestLogger, h as createLogger, m as _log, v as getGlobalDrain, w as markWideEventDrainStarted, x as isEnabled, y as getGlobalPluginRunner } from "./audit-BQt8yAHo.mjs";
+export { createLogger, createRequestLogger, getEnvironment, getGlobalDrain, getGlobalPluginRunner, initLogger, isEnabled, isLoggerLocked, lockLogger, _log as log, markWideEventDrainStarted, mergeInto as mergeWideEventFields, shouldKeep };

package/dist/{middleware-31KhtiEF.d.mts → middleware-B_k4Mrzg.d.mts}

@@ -1,4 +1,4 @@
-import { $ as RequestLogger, I as DrainContext, L as EnrichContext, Y as RedactConfig, ct as WideEvent, dt as PluginRunner, ot as TailSamplingContext, tt as RouteConfig, ut as EvlogPlugin } from "./audit-DVdkntSO.mjs";
+import { $ as RedactConfig, B as DrainContext, V as EnrichContext, at as RouteConfig, ft as WideEvent, gt as PluginRunner, ht as EvlogPlugin, rt as RequestLogger, ut as TailSamplingContext } from "./audit-D7v6JHj0.mjs";
 
 //#region src/shared/middleware.d.ts
 /**
@@ -40,6 +40,13 @@ interface MiddlewareLoggerResult {
     status?: number;
     error?: Error;
   }) => Promise<WideEvent | null>;
+  /**
+   * Finish request logging, deferring emit until a streaming response body completes.
+   * Returns the original response or a wrapped copy when the body is a stream.
+   */
+  finishResponse: (response: Response, opts?: {
+    status?: number;
+  }) => Promise<Response>;
   skipped: boolean;
 }
 /**
@@ -69,4 +76,4 @@ declare function runEnrichAndDrain(emittedEvent: WideEvent, options: MiddlewareL
 declare function createMiddlewareLogger(options: MiddlewareLoggerOptions): MiddlewareLoggerResult;
 //#endregion
 export { resolveMiddlewarePluginRunner as a, createMiddlewareLogger as i, MiddlewareLoggerOptions as n, runEnrichAndDrain as o, MiddlewareLoggerResult as r, BaseEvlogOptions as t };
-//# sourceMappingURL=middleware-31KhtiEF.d.mts.map
+//# sourceMappingURL=middleware-B_k4Mrzg.d.mts.map

package/dist/middleware-B_k4Mrzg.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware-B_k4Mrzg.d.mts","names":[],"sources":["../src/shared/middleware.ts"],"mappings":";;;;AAaA;;;UAAiB,gBAAA;EAMN;EAJT,OAAA;EAMsC;EAJtC,OAAA;EAMwC;EAJxC,MAAA,GAAS,MAAA,SAAe,WAAA;EAMoB;EAJ5C,KAAA,IAAS,GAAA,EAAK,YAAA,YAAwB,OAAA;EAW5B;EATV,MAAA,IAAU,GAAA,EAAK,aAAA,YAAyB,OAAA;EASnB;EAPrB,IAAA,IAAQ,GAAA,EAAK,mBAAA,YAA+B,OAAA;EAR5C;;;;EAaA,MAAA,aAAmB,YAAA;EATL;EAWd,OAAA,GAAU,WAAA;AAAA;;UAIK,uBAAA,SAAgC,gBAAA;EAC/C,MAAA;EACA,IAAA;EACA,SAAA;EAda;EAgBb,OAAA,GAAU,MAAA;AAAA;AAAA,UAGK,sBAAA;EACf,MAAA,EAAQ,aAAA;EACR,MAAA,GAAS,IAAA;IAAS,MAAA;IAAiB,KAAA,GAAQ,KAAA;EAAA,MAAY,OAAA,CAAQ,SAAA;EAVhD;;;;EAef,cAAA,GAAiB,QAAA,EAAU,QAAA,EAAU,IAAA;IAAS,MAAA;EAAA,MAAsB,OAAA,CAAQ,QAAA;EAC5E,OAAA;AAAA;;;;AARF;iBAuCgB,6BAAA,CAA8B,OAAA;EAAW,OAAA,GAAU,WAAA;AAAA,IAAkB,YAAA;;;;;iBAiC/D,iBAAA,CACpB,YAAA,EAAc,SAAA,EACd,OAAA,EAAS,uBAAA,EACT,WAAA;EAAe,MAAA;EAAgB,IAAA;EAAc,SAAA;AAAA,GAC7C,cAAA,WACA,OAAA,GAAU,YAAA,GACT,OAAA;;;;;;;;;iBAgEa,sBAAA,CAAuB,OAAA,EAAS,uBAAA,GAA0B,sBAAA"}

package/dist/nestjs/index.d.mts

@@ -1,5 +1,5 @@
-import { $ as RequestLogger } from "../audit-DVdkntSO.mjs";
-import { t as BaseEvlogOptions } from "../middleware-31KhtiEF.mjs";
+import { rt as RequestLogger } from "../audit-D7v6JHj0.mjs";
+import { t as BaseEvlogOptions } from "../middleware-B_k4Mrzg.mjs";
 import { DynamicModule, MiddlewareConsumer, NestModule } from "@nestjs/common";
 
 //#region src/nestjs/index.d.ts

package/dist/nestjs/index.mjs

@@ -1,7 +1,7 @@
-import { n as extractSafeNodeHeaders } from "../headers-CU-QqnYg.mjs";
-import { r as createMiddlewareLogger, t as attachForkToLogger } from "../fork-Bga8x-X4.mjs";
-import { t as bindNodeResponseLifecycle } from "../nodeResponse-BkkionWl.mjs";
-import { t as createLoggerStorage } from "../storage-BNubsWwz.mjs";
+import { n as extractSafeNodeHeaders } from "../headers-VtmnWcfn.mjs";
+import { r as createMiddlewareLogger, t as attachForkToLogger } from "../fork-CgGlAaHa.mjs";
+import { t as bindNodeResponseLifecycle } from "../nodeResponse-CIEEbrNE.mjs";
+import { t as createLoggerStorage } from "../storage-7X37OToT.mjs";
 //#region src/nestjs/index.ts
 const { storage, useLogger } = createLoggerStorage("middleware context. Make sure EvlogModule.forRoot() is imported in your AppModule.");
 function createEvlogMiddleware(getOptions) {

package/dist/next/client.d.mts

@@ -1,4 +1,4 @@
-import { K as LogLevel, st as TransportConfig } from "../audit-DVdkntSO.mjs";
+import { X as LogLevel, dt as TransportConfig } from "../audit-D7v6JHj0.mjs";
 import { clearIdentity, log as _clientLog, setIdentity, setMinLevel } from "../runtime/client/log.mjs";
 import * as _$react from "react";
 

package/dist/next/index.d.mts

@@ -1,7 +1,7 @@
-import { $ as RequestLogger, G as Log, K as LogLevel, R as EnvironmentContext, nt as SamplingConfig } from "../audit-DVdkntSO.mjs";
-import { n as createError } from "../error-CVtn5U7b.mjs";
-import { t as _log } from "../logger-CTcvd5Cc.mjs";
-import { t as BaseEvlogOptions } from "../middleware-31KhtiEF.mjs";
+import { H as EnvironmentContext, X as LogLevel, Y as Log, ot as SamplingConfig, rt as RequestLogger } from "../audit-D7v6JHj0.mjs";
+import { n as createError } from "../error-CpghjrkY.mjs";
+import { n as _log } from "../logger-mHIWxBhJ.mjs";
+import { t as BaseEvlogOptions } from "../middleware-B_k4Mrzg.mjs";
 import { AsyncLocalStorage } from "node:async_hooks";
 
 //#region src/next/types.d.ts

package/dist/next/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/next/types.ts","../../src/next/storage.ts","../../src/next/middleware.ts","../../src/next/index.ts"],"mappings":";;;;;;;UAGiB,gBAAA,SAAyB,gBAAA;;;;;EAKxC,OAAA;EALe;;;EAUf,GAAA,GAAM,OAAA,CAAQ,kBAAA;EAAR;;;;EAMN,MAAA;EAhBwD;;;;EAsBxD,OAAA;EAZc;;;EAiBd,QAAA,GAAW,cAAA;EAAA;;;;EAMX,QAAA,GAAW,QAAA;EAaL;;AAGR;;EAVE,SAAA;EAeA;;;;;EARA,MAAA;AAAA;AAAA,UAGe,qBAAA;EChC4B;;;;EDqC3C,OAAA;ECrCwB;;;;ED2CxB,OAAA;AAAA;;;;;;;;AA5DF;;;;;;;;;;iBCiBgB,SAAA,oBAA6B,MAAA,kBAAA,CAAA,GAA4B,aAAA,CAAc,CAAA;;;KCjBlF,WAAA;EACH,OAAA;IAAW,QAAA;EAAA;EACX,OAAA;IAAW,GAAA,CAAI,IAAA;EAAA;AAAA;AAAA,KAGZ,YAAA;EACH,OAAA;IACE,GAAA,CAAI,IAAA,UAAc,KAAA;IAClB,GAAA,CAAI,IAAA;EAAA;AAAA;;;;;;;;;;;;;;iBAqBQ,eAAA,CAAgB,MAAA,GAAS,qBAAA,IACzB,OAAA,EAAS,WAAA,KAAW,OAAA,CAAA,YAAA;;;AF9BpC;;;;;;;;;;;;;;;;;;;;;;;;;AAiDA;;;;AAjDA,iBGuCgB,WAAA,CAAY,OAAA,GAAS,gBAAA;6DAW43E,IAAA,EAAA,KAAA,KAAA,OAAA,SAAkC,IAAA,EAAA,KAAA,KAAA,OAAA,CAAA,OAAA,CAAA,OAAA"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/next/types.ts","../../src/next/storage.ts","../../src/next/middleware.ts","../../src/next/index.ts"],"mappings":";;;;;;;UAGiB,gBAAA,SAAyB,gBAAA;;;;;EAKxC,OAAA;EALe;;;EAUf,GAAA,GAAM,OAAA,CAAQ,kBAAA;EAAR;;;;EAMN,MAAA;EAhBwD;;;;EAsBxD,OAAA;EAZc;;;EAiBd,QAAA,GAAW,cAAA;EAAA;;;;EAMX,QAAA,GAAW,QAAA;EAaL;;AAGR;;EAVE,SAAA;EAeA;;;;;EARA,MAAA;AAAA;AAAA,UAGe,qBAAA;EChC4B;;;;EDqC3C,OAAA;ECrCwB;;;;ED2CxB,OAAA;AAAA;;;;;;;;AA5DF;;;;;;;;;;iBCiBgB,SAAA,oBAA6B,MAAA,kBAAA,CAAA,GAA4B,aAAA,CAAc,CAAA;;;KCjBlF,WAAA;EACH,OAAA;IAAW,QAAA;EAAA;EACX,OAAA;IAAW,GAAA,CAAI,IAAA;EAAA;AAAA;AAAA,KAGZ,YAAA;EACH,OAAA;IACE,GAAA,CAAI,IAAA,UAAc,KAAA;IAClB,GAAA,CAAI,IAAA;EAAA;AAAA;;;;;;;;;;;;;;iBAqBQ,eAAA,CAAgB,MAAA,GAAS,qBAAA,IACzB,OAAA,EAAS,WAAA,KAAW,OAAA,CAAA,YAAA;;;AF9BpC;;;;;;;;;;;;;;;;;;;;;;;;;AAiDA;;;;AAjDA,iBGuCgB,WAAA,CAAY,OAAA,GAAS,gBAAA;6DAW04G,IAAA,EAAA,KAAA,KAAA,OAAA,SAAkC,IAAA,EAAA,KAAA,KAAA,OAAA,CAAA,OAAA,CAAA,OAAA"}

package/dist/next/index.mjs

@@ -1,9 +1,21 @@
-import { S as isLoggerLocked, b as initLogger, g as createRequestLogger, m as _log, v as getGlobalDrain, x as isEnabled } from "../audit-BUI3af4w.mjs";
 import { filterSafeHeaders } from "../utils.mjs";
+import { S as isLoggerLocked, b as initLogger, g as createRequestLogger, m as _log, v as getGlobalDrain, w as markWideEventDrainStarted, x as isEnabled } from "../audit-BQt8yAHo.mjs";
 import { EvlogError, createError } from "../error.mjs";
-import { n as shouldLog, t as getServiceForPath } from "../routes-CnIgYWf8.mjs";
-import { t as attachForkToLogger } from "../fork-Bga8x-X4.mjs";
+import { n as shouldLog, t as getServiceForPath } from "../routes-4rMzRyTk.mjs";
+import { r as shouldDeferEmitForResponse, t as bindStreamingResponseLifecycle } from "../streamResponse-CmQ3qUbF.mjs";
+import { t as attachForkToLogger } from "../fork-CgGlAaHa.mjs";
 import { AsyncLocalStorage } from "node:async_hooks";
+//#region src/next/enrich-error-stack.ts
+/**
+* Source-map stack enrichment for Next.js dev — isolated from Nitro to avoid bundling nitropack/youch.
+*/
+async function enrichNextErrorStackForDev(error, options = {}) {
+	if (process.env.NODE_ENV === "production") return;
+	if (options.pretty === false) return;
+	const { enrichErrorStackFromNextDev } = await import("../enrich-error-stack-next.node-Dgm_rCf5.mjs");
+	enrichErrorStackFromNextDev(error);
+}
+//#endregion
 //#region src/next/storage.ts
 const evlogStorage = new AsyncLocalStorage();
 /**
@@ -81,6 +93,7 @@ async function callEnrichAndDrain(emittedEvent, requestInfo, headers, responseSt
 				console.error("[evlog] enrich failed:", err);
 			}
 		}
+		markWideEventDrainStarted(emittedEvent);
 		if (drain) {
 			const drainCtx = {
 				event: emittedEvent,
@@ -103,6 +116,23 @@ async function callEnrichAndDrain(emittedEvent, requestInfo, headers, responseSt
 	} catch {}
 	run().catch(() => {});
 }
+async function emitRequestEvent(logger, requestInfo, headers, status) {
+	let forceKeep = false;
+	if (state.options.keep) try {
+		const tailCtx = {
+			status,
+			path: requestInfo.path,
+			method: requestInfo.method,
+			context: logger.getContext(),
+			shouldKeep: false
+		};
+		await state.options.keep(tailCtx);
+		forceKeep = tailCtx.shouldKeep ?? false;
+	} catch (err) {
+		console.error("[evlog] keep callback failed:", err);
+	}
+	await callEnrichAndDrain(logger.emit({ _forceKeep: forceKeep }), requestInfo, headers, status);
+}
 /**
 * Wrap a Next.js route handler or server action with evlog request-scoped logging.
 *
@@ -165,48 +195,29 @@ function createWithEvlog(options) {
 			}
 			try {
 				const result = await evlogStorage.run(logger, () => handler(...args));
-				let { status } = { status: 200 };
-				if (result instanceof Response) ({status} = result);
-				logger.set({ status });
-				let forceKeep = false;
-				if (state.options.keep) try {
-					const tailCtx = {
-						status,
-						path,
-						method,
-						context: logger.getContext(),
-						shouldKeep: false
-					};
-					await state.options.keep(tailCtx);
-					forceKeep = tailCtx.shouldKeep ?? false;
-				} catch (err) {
-					console.error("[evlog] keep callback failed:", err);
-				}
-				await callEnrichAndDrain(logger.emit({ _forceKeep: forceKeep }), {
+				const requestInfo = {
 					method,
 					path,
 					requestId
-				}, headers, status);
+				};
+				if (result instanceof Response && shouldDeferEmitForResponse(result)) return bindStreamingResponseLifecycle(result, async (meta) => {
+					if (meta.error) logger.error(meta.error);
+					const finalStatus = meta.status ?? result.status;
+					logger.set({ status: finalStatus });
+					await emitRequestEvent(logger, requestInfo, headers, finalStatus);
+				});
+				let { status } = { status: 200 };
+				if (result instanceof Response) ({status} = result);
+				logger.set({ status });
+				await emitRequestEvent(logger, requestInfo, headers, status);
 				return result;
 			} catch (error) {
-				logger.error(error instanceof Error ? error : new Error(String(error)));
+				const err = error instanceof Error ? error : new Error(String(error));
+				await enrichNextErrorStackForDev(err, { pretty: state.options.pretty });
+				logger.error(err);
 				const errorStatus = error.status ?? error.statusCode ?? 500;
 				logger.set({ status: errorStatus });
-				let forceKeep = false;
-				if (state.options.keep) try {
-					const tailCtx = {
-						status: errorStatus,
-						path,
-						method,
-						context: logger.getContext(),
-						shouldKeep: false
-					};
-					await state.options.keep(tailCtx);
-					forceKeep = tailCtx.shouldKeep ?? false;
-				} catch (err) {
-					console.error("[evlog] keep callback failed:", err);
-				}
-				await callEnrichAndDrain(logger.emit({ _forceKeep: forceKeep }), {
+				await emitRequestEvent(logger, {
 					method,
 					path,
 					requestId