evlog 2.14.1 → 2.16.0

package/dist/drain-ByWUeOQC.mjs

@@ -0,0 +1,160 @@
+import { t as getNitroRuntimeConfigRecord } from "./nitroConfigBridge-aZ1e5upQ.mjs";
+//#region src/shared/config.ts
+/** Read the full Nitro `useRuntimeConfig()` record (or `undefined` outside Nitro). */
+function getRuntimeConfig() {
+	return getNitroRuntimeConfigRecord();
+}
+/**
+* Resolve adapter configuration with the standard priority chain:
+*
+* 1. `overrides` passed to the drain factory
+* 2. `runtimeConfig.evlog.{namespace}.{key}` (Nitro)
+* 3. `runtimeConfig.{namespace}.{key}` (Nitro)
+* 4. `process.env[envKey]` for each env in `field.env`
+*/
+async function resolveAdapterConfig(namespace, fields, overrides) {
+	const runtimeConfig = shouldProbeRuntimeConfig(fields, overrides) ? await getRuntimeConfig() : void 0;
+	const evlogNs = runtimeConfig?.evlog?.[namespace];
+	const rootNs = runtimeConfig?.[namespace];
+	const config = {};
+	for (const { key, env } of fields) config[key] = overrides?.[key] ?? evlogNs?.[key] ?? rootNs?.[key] ?? resolveEnv(env);
+	return config;
+}
+function shouldProbeRuntimeConfig(fields, overrides) {
+	return fields.some(({ key, env }) => {
+		if (overrides?.[key] !== void 0) return false;
+		if (!env) return false;
+		return resolveEnv(env) === void 0;
+	});
+}
+function resolveEnv(envKeys) {
+	if (!envKeys) return void 0;
+	for (const key of envKeys) {
+		const val = process.env[key];
+		if (val) return val;
+	}
+}
+//#endregion
+//#region src/shared/http.ts
+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 }) {
+	const normalizedRetries = Number.isFinite(retries) && retries >= 0 ? Math.floor(retries) : 2;
+	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,
+				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
+//#region src/shared/drain.ts
+/**
+* Build a drain callback. Errors raised by `send` are logged with the drain
+* name and swallowed, so a failing drain never breaks the request pipeline.
+*
+* @example
+* ```ts
+* export function createMyDrain(overrides?: Partial<MyConfig>) {
+*   return defineDrain<MyConfig>({
+*     name: 'my-drain',
+*     resolve: () => ({ url: process.env.MY_URL ?? null }),
+*     send: async (events, config) => { ... },
+*   })
+* }
+* ```
+*/
+function defineDrain(options) {
+	return async (ctx) => {
+		const contexts = Array.isArray(ctx) ? ctx : [ctx];
+		if (contexts.length === 0) return;
+		const config = await options.resolve();
+		if (!config) return;
+		try {
+			await options.send(contexts.map((c) => c.event), config);
+		} catch (error) {
+			console.error(`[evlog/${options.name}] Failed to send events:`, error);
+		}
+	};
+}
+const DEFAULT_HTTP_TIMEOUT = 5e3;
+/**
+* Build an HTTP drain. Timeouts/retries are resolved from the config (with
+* overrides via `resolveTimeout` / `resolveRetries`) and forwarded to
+* {@link httpPost}.
+*
+* @example
+* ```ts
+* export function createMyDrain(overrides?: Partial<MyConfig>) {
+*   return defineHttpDrain<MyConfig>({
+*     name: 'my',
+*     resolve: async () => {
+*       const cfg = await resolveAdapterConfig<MyConfig>('my', FIELDS, overrides)
+*       return cfg.apiKey ? cfg as MyConfig : null
+*     },
+*     encode: (events, config) => ({
+*       url: `${config.endpoint ?? 'https://api.my.com'}/ingest`,
+*       headers: { 'Content-Type': 'application/json', Authorization: `Bearer ${config.apiKey}` },
+*       body: JSON.stringify(events),
+*     }),
+*   })
+* }
+* ```
+*/
+function defineHttpDrain(options) {
+	return defineDrain({
+		name: options.name,
+		resolve: options.resolve,
+		send: async (events, config) => {
+			if (events.length === 0) return;
+			const request = options.encode(events, config);
+			if (!request) return;
+			const timeout = options.resolveTimeout?.(config) ?? config.timeout ?? options.timeout ?? DEFAULT_HTTP_TIMEOUT;
+			const retries = options.resolveRetries?.(config) ?? config.retries ?? options.retries;
+			await httpPost({
+				url: request.url,
+				headers: request.headers,
+				body: request.body,
+				timeout,
+				retries,
+				label: options.name
+			});
+		}
+	});
+}
+//#endregion
+export { resolveAdapterConfig as a, getRuntimeConfig as i, defineHttpDrain as n, httpPost as r, defineDrain as t };
+
+//# sourceMappingURL=drain-ByWUeOQC.mjs.map

package/dist/drain-ByWUeOQC.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"drain-ByWUeOQC.mjs","names":[],"sources":["../src/shared/config.ts","../src/shared/http.ts","../src/shared/drain.ts"],"sourcesContent":["import { getNitroRuntimeConfigRecord } from './nitroConfigBridge'\n\n/** Read the full Nitro `useRuntimeConfig()` record (or `undefined` outside Nitro). */\nexport function getRuntimeConfig(): Promise<Record<string, any> | undefined> {\n  return getNitroRuntimeConfigRecord()\n}\n\n/**\n * Description of a single adapter config field. `env` is the ordered list of\n * environment variables to fall back to, e.g. `['NUXT_AXIOM_TOKEN', 'AXIOM_TOKEN']`.\n */\nexport interface ConfigField<T> {\n  key: keyof T & string\n  env?: string[]\n}\n\n/**\n * Resolve adapter configuration with the standard priority chain:\n *\n * 1. `overrides` passed to the drain factory\n * 2. `runtimeConfig.evlog.{namespace}.{key}` (Nitro)\n * 3. `runtimeConfig.{namespace}.{key}` (Nitro)\n * 4. `process.env[envKey]` for each env in `field.env`\n */\nexport async function resolveAdapterConfig<T>(\n  namespace: string,\n  fields: ConfigField<T>[],\n  overrides?: Partial<T>,\n): Promise<Partial<T>> {\n  const runtimeConfig = shouldProbeRuntimeConfig(fields, overrides)\n    ? await getRuntimeConfig()\n    : undefined\n  const evlogNs = runtimeConfig?.evlog?.[namespace]\n  const rootNs = runtimeConfig?.[namespace]\n\n  const config: Record<string, unknown> = {}\n\n  for (const { key, env } of fields) {\n    config[key] =\n      overrides?.[key]\n      ?? evlogNs?.[key]\n      ?? rootNs?.[key]\n      ?? resolveEnv(env)\n  }\n\n  return config as Partial<T>\n}\n\n// Avoid the Nitro virtual-module import when env/overrides already resolve\n// every env-backed field — optional tuning fields (timeout, retries) should\n// not trigger a runtime probe in non-Nitro runtimes.\nfunction shouldProbeRuntimeConfig<T>(\n  fields: ConfigField<T>[],\n  overrides?: Partial<T>,\n): boolean {\n  return fields.some(({ key, env }) => {\n    if (overrides?.[key] !== undefined) return false\n    if (!env) return false\n    return resolveEnv(env) === undefined\n  })\n}\n\nfunction resolveEnv(envKeys?: string[]): string | undefined {\n  if (!envKeys) return undefined\n  for (const key of envKeys) {\n    const val = process.env[key]\n    if (val) return val\n  }\n  return undefined\n}\n","/**\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\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\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 }: HttpPostOptions): Promise<void> {\n  const normalizedRetries = Number.isFinite(retries) && retries >= 0 ? Math.floor(retries) : 2\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,\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","import type { DrainContext, WideEvent } from '../types'\nimport { httpPost } from './http'\n\n/**\n * Drain definition backed by an arbitrary `send` function. Use this for\n * non-HTTP transports (filesystem, in-memory queue, native SDK). For HTTP\n * backends, use `defineHttpDrain` instead.\n */\nexport interface DrainOptions<TConfig> {\n  /** Stable identifier used in error logs. */\n  name: string\n  /** Return `null` to skip draining (e.g. missing API key in dev). */\n  resolve: () => TConfig | null | Promise<TConfig | null>\n  send: (events: WideEvent[], config: TConfig) => Promise<void>\n}\n\n/**\n * Build a drain callback. Errors raised by `send` are logged with the drain\n * name and swallowed, so a failing drain never breaks the request pipeline.\n *\n * @example\n * ```ts\n * export function createMyDrain(overrides?: Partial<MyConfig>) {\n *   return defineDrain<MyConfig>({\n *     name: 'my-drain',\n *     resolve: () => ({ url: process.env.MY_URL ?? null }),\n *     send: async (events, config) => { ... },\n *   })\n * }\n * ```\n */\nexport function defineDrain<TConfig>(options: DrainOptions<TConfig>): (ctx: DrainContext | DrainContext[]) => Promise<void> {\n  return async (ctx: DrainContext | DrainContext[]) => {\n    const contexts = Array.isArray(ctx) ? ctx : [ctx]\n    if (contexts.length === 0) return\n\n    const config = await options.resolve()\n    if (!config) return\n\n    try {\n      await options.send(contexts.map(c => c.event), config)\n    } catch (error) {\n      console.error(`[evlog/${options.name}] Failed to send events:`, error)\n    }\n  }\n}\n\nexport interface HttpDrainRequest {\n  url: string\n  /** Caller is responsible for `Content-Type`. */\n  headers: Record<string, string>\n  body: string\n}\n\n/** Adapters only need to ship config + `encode()` — no manual `fetch`. */\nexport interface HttpDrainOptions<TConfig> {\n  /** Stable identifier used in error logs. */\n  name: string\n  /** Return `null` to skip draining (e.g. missing API key in dev). */\n  resolve: () => TConfig | null | Promise<TConfig | null>\n  /** Return `null` to skip the batch without raising. */\n  encode: (events: WideEvent[], config: TConfig) => HttpDrainRequest | null\n  /** @default 5000 */\n  timeout?: number\n  /** @default 2 */\n  retries?: number\n  /** Read the timeout off the resolved config (falls back to `timeout`). */\n  resolveTimeout?: (config: TConfig) => number | undefined\n  /** Read the retry count off the resolved config (falls back to `retries`). */\n  resolveRetries?: (config: TConfig) => number | undefined\n}\n\nconst DEFAULT_HTTP_TIMEOUT = 5000\n\n/**\n * Build an HTTP drain. Timeouts/retries are resolved from the config (with\n * overrides via `resolveTimeout` / `resolveRetries`) and forwarded to\n * {@link httpPost}.\n *\n * @example\n * ```ts\n * export function createMyDrain(overrides?: Partial<MyConfig>) {\n *   return defineHttpDrain<MyConfig>({\n *     name: 'my',\n *     resolve: async () => {\n *       const cfg = await resolveAdapterConfig<MyConfig>('my', FIELDS, overrides)\n *       return cfg.apiKey ? cfg as MyConfig : null\n *     },\n *     encode: (events, config) => ({\n *       url: `${config.endpoint ?? 'https://api.my.com'}/ingest`,\n *       headers: { 'Content-Type': 'application/json', Authorization: `Bearer ${config.apiKey}` },\n *       body: JSON.stringify(events),\n *     }),\n *   })\n * }\n * ```\n */\nexport function defineHttpDrain<TConfig>(options: HttpDrainOptions<TConfig>): (ctx: DrainContext | DrainContext[]) => Promise<void> {\n  return defineDrain<TConfig>({\n    name: options.name,\n    resolve: options.resolve,\n    send: async (events, config) => {\n      if (events.length === 0) return\n      const request = options.encode(events, config)\n      if (!request) return\n      const timeout = options.resolveTimeout?.(config)\n        ?? (config as { timeout?: number }).timeout\n        ?? options.timeout\n        ?? DEFAULT_HTTP_TIMEOUT\n      const retries = options.resolveRetries?.(config)\n        ?? (config as { retries?: number }).retries\n        ?? options.retries\n      await httpPost({\n        url: request.url,\n        headers: request.headers,\n        body: request.body,\n        timeout,\n        retries,\n        label: options.name,\n      })\n    },\n  })\n}\n"],"mappings":";;;AAGA,SAAgB,mBAA6D;AAC3E,QAAO,6BAA6B;;;;;;;;;;AAoBtC,eAAsB,qBACpB,WACA,QACA,WACqB;CACrB,MAAM,gBAAgB,yBAAyB,QAAQ,UAAU,GAC7D,MAAM,kBAAkB,GACxB,KAAA;CACJ,MAAM,UAAU,eAAe,QAAQ;CACvC,MAAM,SAAS,gBAAgB;CAE/B,MAAM,SAAkC,EAAE;AAE1C,MAAK,MAAM,EAAE,KAAK,SAAS,OACzB,QAAO,OACL,YAAY,QACT,UAAU,QACV,SAAS,QACT,WAAW,IAAI;AAGtB,QAAO;;AAMT,SAAS,yBACP,QACA,WACS;AACT,QAAO,OAAO,MAAM,EAAE,KAAK,UAAU;AACnC,MAAI,YAAY,SAAS,KAAA,EAAW,QAAO;AAC3C,MAAI,CAAC,IAAK,QAAO;AACjB,SAAO,WAAW,IAAI,KAAK,KAAA;GAC3B;;AAGJ,SAAS,WAAW,SAAwC;AAC1D,KAAI,CAAC,QAAS,QAAO,KAAA;AACrB,MAAK,MAAM,OAAO,SAAS;EACzB,MAAM,MAAM,QAAQ,IAAI;AACxB,MAAI,IAAK,QAAO;;;;;AC5CpB,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,KAAqC;CAClH,MAAM,oBAAoB,OAAO,SAAS,QAAQ,IAAI,WAAW,IAAI,KAAK,MAAM,QAAQ,GAAG;CAE3F,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;IACA;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;;;;;;;;;;;;;;;;;;;AC/CR,SAAgB,YAAqB,SAAuF;AAC1H,QAAO,OAAO,QAAuC;EACnD,MAAM,WAAW,MAAM,QAAQ,IAAI,GAAG,MAAM,CAAC,IAAI;AACjD,MAAI,SAAS,WAAW,EAAG;EAE3B,MAAM,SAAS,MAAM,QAAQ,SAAS;AACtC,MAAI,CAAC,OAAQ;AAEb,MAAI;AACF,SAAM,QAAQ,KAAK,SAAS,KAAI,MAAK,EAAE,MAAM,EAAE,OAAO;WAC/C,OAAO;AACd,WAAQ,MAAM,UAAU,QAAQ,KAAK,2BAA2B,MAAM;;;;AA8B5E,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;AAyB7B,SAAgB,gBAAyB,SAA2F;AAClI,QAAO,YAAqB;EAC1B,MAAM,QAAQ;EACd,SAAS,QAAQ;EACjB,MAAM,OAAO,QAAQ,WAAW;AAC9B,OAAI,OAAO,WAAW,EAAG;GACzB,MAAM,UAAU,QAAQ,OAAO,QAAQ,OAAO;AAC9C,OAAI,CAAC,QAAS;GACd,MAAM,UAAU,QAAQ,iBAAiB,OAAO,IAC1C,OAAgC,WACjC,QAAQ,WACR;GACL,MAAM,UAAU,QAAQ,iBAAiB,OAAO,IAC1C,OAAgC,WACjC,QAAQ;AACb,SAAM,SAAS;IACb,KAAK,QAAQ;IACb,SAAS,QAAQ;IACjB,MAAM,QAAQ;IACd;IACA;IACA,OAAO,QAAQ;IAChB,CAAC;;EAEL,CAAC"}

package/dist/elysia/index.d.mts

@@ -1,5 +1,5 @@
-import { Y as RequestLogger } from "../audit-CTIviX3P.mjs";
-import { t as BaseEvlogOptions } from "../middleware-CTnDsST-.mjs";
+import { Y as RequestLogger } from "../audit-X1uUukm3.mjs";
+import { t as BaseEvlogOptions } from "../middleware-CAQHJRN1.mjs";
 import { Elysia } from "elysia";
 
 //#region src/elysia/index.d.ts
@@ -23,6 +23,29 @@ type EvlogElysiaOptions = BaseEvlogOptions;
  * ```
  */
 declare function useLogger<T extends object = Record<string, unknown>>(): RequestLogger<T>;
+/**
+ * Create an evlog plugin for Elysia.
+ *
+ * @example
+ * ```ts
+ * import { Elysia } from 'elysia'
+ * import { evlog } from 'evlog/elysia'
+ * import { createAxiomDrain } from 'evlog/axiom'
+ *
+ * const app = new Elysia()
+ *   .use(evlog({
+ *     drain: createAxiomDrain(),
+ *     enrich: (ctx) => {
+ *       ctx.event.region = process.env.FLY_REGION
+ *     },
+ *   }))
+ *   .get('/health', ({ log }) => {
+ *     log.set({ route: 'health' })
+ *     return { ok: true }
+ *   })
+ *   .listen(3000)
+ * ```
+ */
 declare function evlog(options?: EvlogElysiaOptions): Elysia<"", {
   decorator: {};
   store: {};

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/elysia/index.ts"],"mappings":";;;;;KAgBY,kBAAA,GAAqB,gBAAA;;AAAjC;;;;;AAoBA;;;;;;;;;;;;iBAAgB,SAAA,oBAA6B,MAAA,kBAAA,CAAA,GAA4B,aAAA,CAAc,CAAA;AAAA,iBAwCvE,KAAA,CAAM,OAAA,GAAS,kBAAA,GAAuB,MAAA"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/elysia/index.ts"],"mappings":";;;;;KAWY,kBAAA,GAAqB,gBAAA;;AAAjC;;;;;AAoBA;;;;;;;;;;;;iBAAgB,SAAA,oBAA6B,MAAA,kBAAA,CAAA,GAA4B,aAAA,CAAc,CAAA;;AAuEvF;;;;;;;;;;;;;;;;;;;;;;iBAAgB,KAAA,CAAM,OAAA,GAAS,kBAAA,GAAuB,MAAA"}

package/dist/elysia/index.mjs

@@ -1,6 +1,5 @@
-import { filterSafeHeaders } from "../utils.mjs";
-import { t as createMiddlewareLogger } from "../middleware-oAccqyPp.mjs";
-import { t as attachForkToLogger } from "../fork-D1j1Fuzy.mjs";
+import { t as attachForkToLogger } from "../fork-DPN8aL8O.mjs";
+import { t as defineFrameworkIntegration } from "../integration-DSZPbI9N.mjs";
 import { AsyncLocalStorage } from "node:async_hooks";
 import { Elysia } from "elysia";
 //#region src/elysia/index.ts
@@ -29,29 +28,63 @@ function useLogger() {
 	if (!logger || !activeLoggers.has(logger)) throw new Error("[evlog] useLogger() was called outside of an evlog plugin context. Make sure app.use(evlog()) is registered before your routes.");
 	return logger;
 }
+const integration = defineFrameworkIntegration({
+	name: "elysia",
+	extractRequest: ({ request, path, headers }) => ({
+		method: request.method,
+		path,
+		headers,
+		requestId: headers["x-request-id"]
+	}),
+	attachLogger: ({ request, path, headers }, logger) => {
+		attachForkToLogger(storage, logger, {
+			method: request.method,
+			path,
+			requestId: headers["x-request-id"]
+		}, {
+			onChildEnter: (child) => {
+				activeLoggers.add(child);
+			},
+			onChildExit: (child) => {
+				activeLoggers.delete(child);
+			}
+		});
+		activeLoggers.add(logger);
+	}
+});
+/**
+* Create an evlog plugin for Elysia.
+*
+* @example
+* ```ts
+* import { Elysia } from 'elysia'
+* import { evlog } from 'evlog/elysia'
+* import { createAxiomDrain } from 'evlog/axiom'
+*
+* const app = new Elysia()
+*   .use(evlog({
+*     drain: createAxiomDrain(),
+*     enrich: (ctx) => {
+*       ctx.event.region = process.env.FLY_REGION
+*     },
+*   }))
+*   .get('/health', ({ log }) => {
+*     log.set({ route: 'health' })
+*     return { ok: true }
+*   })
+*   .listen(3000)
+* ```
+*/
 function evlog(options = {}) {
 	const emitted = /* @__PURE__ */ new WeakSet();
 	const requestState = /* @__PURE__ */ new WeakMap();
 	return new Elysia({ name: "evlog" }).derive({ as: "global" }, ({ request, path, headers }) => {
-		const middlewareOpts = {
-			method: request.method,
+		const ctx = {
+			request,
 			path,
-			requestId: headers["x-request-id"] || crypto.randomUUID(),
-			headers: filterSafeHeaders(headers),
-			...options
+			headers
 		};
-		const { logger, finish, skipped } = createMiddlewareLogger(middlewareOpts);
-		if (!skipped) {
-			attachForkToLogger(storage, logger, middlewareOpts, {
-				onChildEnter: (child) => {
-					activeLoggers.add(child);
-				},
-				onChildExit: (child) => {
-					activeLoggers.delete(child);
-				}
-			});
-			activeLoggers.add(logger);
-		}
+		const { logger, finish, skipped } = integration.start(ctx, options);
 		storage.enterWith(logger);
 		requestState.set(request, {
 			finish,

package/dist/elysia/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../../src/elysia/index.ts"],"sourcesContent":["import { AsyncLocalStorage } from 'node:async_hooks'\nimport { Elysia } from 'elysia'\nimport type { RequestLogger } from '../types'\nimport { createMiddlewareLogger, type BaseEvlogOptions } from '../shared/middleware'\nimport { attachForkToLogger } from '../shared/fork'\nimport { extractSafeHeaders } from '../shared/headers'\nimport { filterSafeHeaders } from '../utils'\n\nconst storage = new AsyncLocalStorage<RequestLogger>()\n\n// Tracks loggers that are currently active (within a live request).\n// Elysia uses storage.enterWith() which persists in the async context\n// even after the request ends, so we use this set to distinguish\n// an in-flight logger from a stale one.\nconst activeLoggers = new WeakSet<RequestLogger>()\n\nexport type EvlogElysiaOptions = BaseEvlogOptions\n\n/**\n * Get the request-scoped logger from anywhere in the call stack.\n * Must be called inside a request handled by the `evlog()` plugin.\n *\n * Unlike other frameworks, Elysia uses `storage.enterWith()` which persists\n * beyond the request lifecycle. This accessor additionally checks `activeLoggers`\n * to ensure the logger belongs to an in-flight request.\n *\n * @example\n * ```ts\n * import { useLogger } from 'evlog/elysia'\n *\n * function findUser(id: string) {\n *   const log = useLogger()\n *   log.set({ user: { id } })\n * }\n * ```\n */\nexport function useLogger<T extends object = Record<string, unknown>>(): RequestLogger<T> {\n  const logger = storage.getStore()\n  if (!logger || !activeLoggers.has(logger)) {\n    throw new Error(\n      '[evlog] useLogger() was called outside of an evlog plugin context. '\n      + 'Make sure app.use(evlog()) is registered before your routes.',\n    )\n  }\n  return logger as RequestLogger<T>\n}\n\n/**\n * Create an evlog plugin for Elysia.\n *\n * @example\n * ```ts\n * import { Elysia } from 'elysia'\n * import { evlog } from 'evlog/elysia'\n * import { createAxiomDrain } from 'evlog/axiom'\n *\n * const app = new Elysia()\n *   .use(evlog({\n *     drain: createAxiomDrain(),\n *     enrich: (ctx) => {\n *       ctx.event.region = process.env.FLY_REGION\n *     },\n *   }))\n *   .get('/health', ({ log }) => {\n *     log.set({ route: 'health' })\n *     return { ok: true }\n *   })\n *   .listen(3000)\n * ```\n */\ninterface RequestState {\n  finish: (opts?: { status?: number; error?: Error }) => Promise<unknown>\n  skipped: boolean\n  logger: RequestLogger\n}\n\nexport function evlog(options: EvlogElysiaOptions = {}) {\n  const emitted = new WeakSet<Request>()\n  const requestState = new WeakMap<Request, RequestState>()\n\n  return new Elysia({ name: 'evlog' })\n    .derive({ as: 'global' }, ({ request, path, headers }) => {\n      const middlewareOpts = {\n        method: request.method,\n        path,\n        requestId: headers['x-request-id'] || crypto.randomUUID(),\n        // It's recommended to use context.headers instead of context.request.headers\n        // because Elysia has fast path for getting headers on Bun\n        headers: filterSafeHeaders(headers as Record<string, string>),\n        ...options,\n      }\n      const { logger, finish, skipped } = createMiddlewareLogger(middlewareOpts)\n\n      if (!skipped) {\n        attachForkToLogger(storage, logger, middlewareOpts, {\n          onChildEnter: (child) => {\n            activeLoggers.add(child)\n          },\n          onChildExit: (child) => {\n            activeLoggers.delete(child)\n          },\n        })\n        activeLoggers.add(logger)\n      }\n      storage.enterWith(logger)\n      requestState.set(request, { finish, skipped, logger })\n\n      return { log: logger }\n    })\n    .onAfterResponse({ as: 'global' }, async ({ request, set }) => {\n      const state = requestState.get(request)\n      if (!state || state.skipped || emitted.has(request)) return\n      emitted.add(request)\n      await state.finish({ status: set.status as number || 200 })\n      activeLoggers.delete(state.logger)\n      storage.enterWith(undefined as unknown as RequestLogger)\n    })\n    .onError({ as: 'global' }, async ({ request, error }) => {\n      const state = requestState.get(request)\n      if (!state || state.skipped || emitted.has(request)) return\n      emitted.add(request)\n      const err = error instanceof Error ? error : new Error(String(error))\n      state.logger.error(err)\n      await state.finish({ error: err })\n      activeLoggers.delete(state.logger)\n      storage.enterWith(undefined as unknown as RequestLogger)\n    })\n}\n"],"mappings":";;;;;;AAQA,MAAM,UAAU,IAAI,mBAAkC;AAMtD,MAAM,gCAAgB,IAAI,SAAwB;;;;;;;;;;;;;;;;;;;AAsBlD,SAAgB,YAA0E;CACxF,MAAM,SAAS,QAAQ,UAAU;AACjC,KAAI,CAAC,UAAU,CAAC,cAAc,IAAI,OAAO,CACvC,OAAM,IAAI,MACR,kIAED;AAEH,QAAO;;AAgCT,SAAgB,MAAM,UAA8B,EAAE,EAAE;CACtD,MAAM,0BAAU,IAAI,SAAkB;CACtC,MAAM,+BAAe,IAAI,SAAgC;AAEzD,QAAO,IAAI,OAAO,EAAE,MAAM,SAAS,CAAC,CACjC,OAAO,EAAE,IAAI,UAAU,GAAG,EAAE,SAAS,MAAM,cAAc;EACxD,MAAM,iBAAiB;GACrB,QAAQ,QAAQ;GAChB;GACA,WAAW,QAAQ,mBAAmB,OAAO,YAAY;GAGzD,SAAS,kBAAkB,QAAkC;GAC7D,GAAG;GACJ;EACD,MAAM,EAAE,QAAQ,QAAQ,YAAY,uBAAuB,eAAe;AAE1E,MAAI,CAAC,SAAS;AACZ,sBAAmB,SAAS,QAAQ,gBAAgB;IAClD,eAAe,UAAU;AACvB,mBAAc,IAAI,MAAM;;IAE1B,cAAc,UAAU;AACtB,mBAAc,OAAO,MAAM;;IAE9B,CAAC;AACF,iBAAc,IAAI,OAAO;;AAE3B,UAAQ,UAAU,OAAO;AACzB,eAAa,IAAI,SAAS;GAAE;GAAQ;GAAS;GAAQ,CAAC;AAEtD,SAAO,EAAE,KAAK,QAAQ;GACtB,CACD,gBAAgB,EAAE,IAAI,UAAU,EAAE,OAAO,EAAE,SAAS,UAAU;EAC7D,MAAM,QAAQ,aAAa,IAAI,QAAQ;AACvC,MAAI,CAAC,SAAS,MAAM,WAAW,QAAQ,IAAI,QAAQ,CAAE;AACrD,UAAQ,IAAI,QAAQ;AACpB,QAAM,MAAM,OAAO,EAAE,QAAQ,IAAI,UAAoB,KAAK,CAAC;AAC3D,gBAAc,OAAO,MAAM,OAAO;AAClC,UAAQ,UAAU,KAAA,EAAsC;GACxD,CACD,QAAQ,EAAE,IAAI,UAAU,EAAE,OAAO,EAAE,SAAS,YAAY;EACvD,MAAM,QAAQ,aAAa,IAAI,QAAQ;AACvC,MAAI,CAAC,SAAS,MAAM,WAAW,QAAQ,IAAI,QAAQ,CAAE;AACrD,UAAQ,IAAI,QAAQ;EACpB,MAAM,MAAM,iBAAiB,QAAQ,QAAQ,IAAI,MAAM,OAAO,MAAM,CAAC;AACrE,QAAM,OAAO,MAAM,IAAI;AACvB,QAAM,MAAM,OAAO,EAAE,OAAO,KAAK,CAAC;AAClC,gBAAc,OAAO,MAAM,OAAO;AAClC,UAAQ,UAAU,KAAA,EAAsC;GACxD"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../../src/elysia/index.ts"],"sourcesContent":["import { AsyncLocalStorage } from 'node:async_hooks'\nimport { Elysia } from 'elysia'\nimport type { RequestLogger } from '../types'\nimport { defineFrameworkIntegration } from '../shared/integration'\nimport type { BaseEvlogOptions } from '../shared/middleware'\nimport { attachForkToLogger } from '../shared/fork'\n\nconst storage = new AsyncLocalStorage<RequestLogger>()\n\nconst activeLoggers = new WeakSet<RequestLogger>()\n\nexport type EvlogElysiaOptions = BaseEvlogOptions\n\n/**\n * Get the request-scoped logger from anywhere in the call stack.\n * Must be called inside a request handled by the `evlog()` plugin.\n *\n * Unlike other frameworks, Elysia uses `storage.enterWith()` which persists\n * beyond the request lifecycle. This accessor additionally checks `activeLoggers`\n * to ensure the logger belongs to an in-flight request.\n *\n * @example\n * ```ts\n * import { useLogger } from 'evlog/elysia'\n *\n * function findUser(id: string) {\n *   const log = useLogger()\n *   log.set({ user: { id } })\n * }\n * ```\n */\nexport function useLogger<T extends object = Record<string, unknown>>(): RequestLogger<T> {\n  const logger = storage.getStore()\n  if (!logger || !activeLoggers.has(logger)) {\n    throw new Error(\n      '[evlog] useLogger() was called outside of an evlog plugin context. '\n      + 'Make sure app.use(evlog()) is registered before your routes.',\n    )\n  }\n  return logger as RequestLogger<T>\n}\n\ninterface ElysiaContext {\n  request: Request\n  path: string\n  headers: Record<string, string>\n}\n\nconst integration = defineFrameworkIntegration<ElysiaContext>({\n  name: 'elysia',\n  extractRequest: ({ request, path, headers }) => ({\n    method: request.method,\n    path,\n    headers,\n    requestId: headers['x-request-id'],\n  }),\n  attachLogger: ({ request, path, headers }, logger) => {\n    attachForkToLogger(storage, logger, {\n      method: request.method,\n      path,\n      requestId: headers['x-request-id'],\n    }, {\n      onChildEnter: (child) => {\n        activeLoggers.add(child)\n      },\n      onChildExit: (child) => {\n        activeLoggers.delete(child)\n      },\n    })\n    activeLoggers.add(logger)\n  },\n})\n\ninterface RequestState {\n  finish: (opts?: { status?: number; error?: Error }) => Promise<unknown>\n  skipped: boolean\n  logger: RequestLogger\n}\n\n/**\n * Create an evlog plugin for Elysia.\n *\n * @example\n * ```ts\n * import { Elysia } from 'elysia'\n * import { evlog } from 'evlog/elysia'\n * import { createAxiomDrain } from 'evlog/axiom'\n *\n * const app = new Elysia()\n *   .use(evlog({\n *     drain: createAxiomDrain(),\n *     enrich: (ctx) => {\n *       ctx.event.region = process.env.FLY_REGION\n *     },\n *   }))\n *   .get('/health', ({ log }) => {\n *     log.set({ route: 'health' })\n *     return { ok: true }\n *   })\n *   .listen(3000)\n * ```\n */\nexport function evlog(options: EvlogElysiaOptions = {}) {\n  const emitted = new WeakSet<Request>()\n  const requestState = new WeakMap<Request, RequestState>()\n\n  return new Elysia({ name: 'evlog' })\n    .derive({ as: 'global' }, ({ request, path, headers }) => {\n      const ctx: ElysiaContext = { request, path, headers: headers as Record<string, string> }\n      const { logger, finish, skipped } = integration.start(ctx, options)\n      storage.enterWith(logger)\n      requestState.set(request, { finish, skipped, logger })\n      return { log: logger }\n    })\n    .onAfterResponse({ as: 'global' }, async ({ request, set }) => {\n      const state = requestState.get(request)\n      if (!state || state.skipped || emitted.has(request)) return\n      emitted.add(request)\n      await state.finish({ status: set.status as number || 200 })\n      activeLoggers.delete(state.logger)\n      storage.enterWith(undefined as unknown as RequestLogger)\n    })\n    .onError({ as: 'global' }, async ({ request, error }) => {\n      const state = requestState.get(request)\n      if (!state || state.skipped || emitted.has(request)) return\n      emitted.add(request)\n      const err = error instanceof Error ? error : new Error(String(error))\n      state.logger.error(err)\n      await state.finish({ error: err })\n      activeLoggers.delete(state.logger)\n      storage.enterWith(undefined as unknown as RequestLogger)\n    })\n}\n"],"mappings":";;;;;AAOA,MAAM,UAAU,IAAI,mBAAkC;AAEtD,MAAM,gCAAgB,IAAI,SAAwB;;;;;;;;;;;;;;;;;;;AAsBlD,SAAgB,YAA0E;CACxF,MAAM,SAAS,QAAQ,UAAU;AACjC,KAAI,CAAC,UAAU,CAAC,cAAc,IAAI,OAAO,CACvC,OAAM,IAAI,MACR,kIAED;AAEH,QAAO;;AAST,MAAM,cAAc,2BAA0C;CAC5D,MAAM;CACN,iBAAiB,EAAE,SAAS,MAAM,eAAe;EAC/C,QAAQ,QAAQ;EAChB;EACA;EACA,WAAW,QAAQ;EACpB;CACD,eAAe,EAAE,SAAS,MAAM,WAAW,WAAW;AACpD,qBAAmB,SAAS,QAAQ;GAClC,QAAQ,QAAQ;GAChB;GACA,WAAW,QAAQ;GACpB,EAAE;GACD,eAAe,UAAU;AACvB,kBAAc,IAAI,MAAM;;GAE1B,cAAc,UAAU;AACtB,kBAAc,OAAO,MAAM;;GAE9B,CAAC;AACF,gBAAc,IAAI,OAAO;;CAE5B,CAAC;;;;;;;;;;;;;;;;;;;;;;;;AA+BF,SAAgB,MAAM,UAA8B,EAAE,EAAE;CACtD,MAAM,0BAAU,IAAI,SAAkB;CACtC,MAAM,+BAAe,IAAI,SAAgC;AAEzD,QAAO,IAAI,OAAO,EAAE,MAAM,SAAS,CAAC,CACjC,OAAO,EAAE,IAAI,UAAU,GAAG,EAAE,SAAS,MAAM,cAAc;EACxD,MAAM,MAAqB;GAAE;GAAS;GAAe;GAAmC;EACxF,MAAM,EAAE,QAAQ,QAAQ,YAAY,YAAY,MAAM,KAAK,QAAQ;AACnE,UAAQ,UAAU,OAAO;AACzB,eAAa,IAAI,SAAS;GAAE;GAAQ;GAAS;GAAQ,CAAC;AACtD,SAAO,EAAE,KAAK,QAAQ;GACtB,CACD,gBAAgB,EAAE,IAAI,UAAU,EAAE,OAAO,EAAE,SAAS,UAAU;EAC7D,MAAM,QAAQ,aAAa,IAAI,QAAQ;AACvC,MAAI,CAAC,SAAS,MAAM,WAAW,QAAQ,IAAI,QAAQ,CAAE;AACrD,UAAQ,IAAI,QAAQ;AACpB,QAAM,MAAM,OAAO,EAAE,QAAQ,IAAI,UAAoB,KAAK,CAAC;AAC3D,gBAAc,OAAO,MAAM,OAAO;AAClC,UAAQ,UAAU,KAAA,EAAsC;GACxD,CACD,QAAQ,EAAE,IAAI,UAAU,EAAE,OAAO,EAAE,SAAS,YAAY;EACvD,MAAM,QAAQ,aAAa,IAAI,QAAQ;AACvC,MAAI,CAAC,SAAS,MAAM,WAAW,QAAQ,IAAI,QAAQ,CAAE;AACrD,UAAQ,IAAI,QAAQ;EACpB,MAAM,MAAM,iBAAiB,QAAQ,QAAQ,IAAI,MAAM,OAAO,MAAM,CAAC;AACrE,QAAM,OAAO,MAAM,IAAI;AACvB,QAAM,MAAM,OAAO,EAAE,OAAO,KAAK,CAAC;AAClC,gBAAc,OAAO,MAAM,OAAO;AAClC,UAAQ,UAAU,KAAA,EAAsC;GACxD"}

package/dist/enricher-DYTr9I16.d.mts

@@ -0,0 +1,42 @@
+import { I as EnrichContext, it as WideEvent } from "./audit-X1uUukm3.mjs";
+
+//#region src/shared/enricher.d.ts
+interface EnricherOptions {
+  /**
+   * Replace existing event fields with the computed value. Defaults to `false`
+   * so user-provided context (e.g. `log.set({ geo: ... })`) wins.
+   */
+  overwrite?: boolean;
+}
+interface EnricherDefinition<T> {
+  /** Stable identifier used in error logs. */
+  name: string;
+  /**
+   * Top-level event field to merge into. Omit when the enricher writes to
+   * multiple fields and handles its own merging inside `compute`.
+   */
+  field?: keyof WideEvent & string;
+  /** Return `undefined` to skip enrichment (e.g. when a required header is missing). */
+  compute: (ctx: EnrichContext) => T | undefined;
+}
+/**
+ * Build an enricher: skips when `compute` returns `undefined`, merges with
+ * {@link mergeEventField} respecting `overwrite`, and isolates errors under
+ * `[evlog/{name}]`.
+ *
+ * @example
+ * ```ts
+ * export const tenantEnricher = defineEnricher<{ id: string }>({
+ *   name: 'tenant',
+ *   field: 'tenant',
+ *   compute({ headers }) {
+ *     const id = getHeader(headers, 'x-tenant-id')
+ *     return id ? { id } : undefined
+ *   },
+ * })
+ * ```
+ */
+declare function defineEnricher<T>(def: EnricherDefinition<T>, options?: EnricherOptions): (ctx: EnrichContext) => void;
+//#endregion
+export { EnricherOptions as n, defineEnricher as r, EnricherDefinition as t };
+//# sourceMappingURL=enricher-DYTr9I16.d.mts.map

package/dist/enricher-DYTr9I16.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enricher-DYTr9I16.d.mts","names":[],"sources":["../src/shared/enricher.ts"],"mappings":";;;UAGiB,eAAA;;AAAjB;;;EAKE,SAAA;AAAA;AAAA,UAGe,kBAAA;EAAkB;EAEjC,IAAA;EAKc;;;;EAAd,KAAA,SAAc,SAAA;EAPoB;EASlC,OAAA,GAAU,GAAA,EAAK,aAAA,KAAkB,CAAA;AAAA;;;;;;;;AAoBnC;;;;;;;;;;iBAAgB,cAAA,GAAA,CACd,GAAA,EAAK,kBAAA,CAAmB,CAAA,GACxB,OAAA,GAAS,eAAA,IACP,GAAA,EAAK,aAAA"}

package/dist/enricher-Dy06T17G.mjs

@@ -0,0 +1,95 @@
+import { t as mergeEventField } from "./event-DcHmEm3O.mjs";
+//#region src/shared/compose.ts
+/**
+* Compose enricher callbacks into one. Runs in registration order; errors are
+* caught per-callback so one buggy enricher never blocks the others.
+*/
+function composeEnrichers(enrichers, options = {}) {
+	const label = options.name ?? "compose-enrichers";
+	return async (ctx) => {
+		for (const enricher of enrichers) try {
+			await enricher(ctx);
+		} catch (err) {
+			console.error(`[evlog/${label}] enrich failed:`, err);
+		}
+	};
+}
+/**
+* Fan out to multiple drains concurrently (`Promise.allSettled`). A slow
+* Sentry drain never blocks an Axiom drain on the same event.
+*/
+function composeDrains(drains, options = {}) {
+	const label = options.name ?? "compose-drains";
+	return async (ctx) => {
+		if (drains.length === 0) return;
+		await Promise.allSettled(drains.map(async (drain) => {
+			try {
+				await drain(ctx);
+			} catch (err) {
+				console.error(`[evlog/${label}] drain failed:`, err);
+			}
+		}));
+	};
+}
+/**
+* Compose tail-sampling `keep` callbacks. `ctx.shouldKeep` is true after the
+* run if any callback set it. Errors are isolated.
+*/
+function composeKeep(keepers, options = {}) {
+	const label = options.name ?? "compose-keep";
+	return async (ctx) => {
+		for (const keep of keepers) try {
+			await keep(ctx);
+		} catch (err) {
+			console.error(`[evlog/${label}] keep failed:`, err);
+		}
+	};
+}
+/** Merge plugin lists. Later registrations override earlier ones by `name`. */
+function composePlugins(...lists) {
+	const merged = /* @__PURE__ */ new Map();
+	for (const list of lists) {
+		if (!list) continue;
+		for (const plugin of list) merged.set(plugin.name, plugin);
+	}
+	return Array.from(merged.values());
+}
+//#endregion
+//#region src/shared/enricher.ts
+/**
+* Build an enricher: skips when `compute` returns `undefined`, merges with
+* {@link mergeEventField} respecting `overwrite`, and isolates errors under
+* `[evlog/{name}]`.
+*
+* @example
+* ```ts
+* export const tenantEnricher = defineEnricher<{ id: string }>({
+*   name: 'tenant',
+*   field: 'tenant',
+*   compute({ headers }) {
+*     const id = getHeader(headers, 'x-tenant-id')
+*     return id ? { id } : undefined
+*   },
+* })
+* ```
+*/
+function defineEnricher(def, options = {}) {
+	const { name, field, compute } = def;
+	return (ctx) => {
+		let computed;
+		try {
+			computed = compute(ctx);
+		} catch (err) {
+			console.error(`[evlog/${name}] enrich failed:`, err);
+			return;
+		}
+		if (computed === void 0) return;
+		if (!field) return;
+		const target = ctx.event[field];
+		ctx.event[field] = mergeEventField(target, computed, options.overwrite);
+	};
+}
+//#endregion
+export { composePlugins as a, composeKeep as i, composeDrains as n, composeEnrichers as r, defineEnricher as t };
+
+//# sourceMappingURL=enricher-Dy06T17G.mjs.map

package/dist/enricher-Dy06T17G.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"enricher-Dy06T17G.mjs","names":[],"sources":["../src/shared/compose.ts","../src/shared/enricher.ts"],"sourcesContent":["import type { DrainContext, EnrichContext, TailSamplingContext } from '../types'\nimport type { EvlogPlugin } from './plugin'\n\n/**\n * Compose enricher callbacks into one. Runs in registration order; errors are\n * caught per-callback so one buggy enricher never blocks the others.\n */\nexport function composeEnrichers(\n  enrichers: Array<(ctx: EnrichContext) => void | Promise<void>>,\n  options: { name?: string } = {},\n): (ctx: EnrichContext) => Promise<void> {\n  const label = options.name ?? 'compose-enrichers'\n  return async (ctx) => {\n    for (const enricher of enrichers) {\n      try {\n        await enricher(ctx)\n      } catch (err) {\n        console.error(`[evlog/${label}] enrich failed:`, err)\n      }\n    }\n  }\n}\n\n/**\n * Fan out to multiple drains concurrently (`Promise.allSettled`). A slow\n * Sentry drain never blocks an Axiom drain on the same event.\n */\nexport function composeDrains(\n  drains: Array<(ctx: DrainContext) => void | Promise<void>>,\n  options: { name?: string } = {},\n): (ctx: DrainContext) => Promise<void> {\n  const label = options.name ?? 'compose-drains'\n  return async (ctx) => {\n    if (drains.length === 0) return\n    await Promise.allSettled(\n      drains.map(async (drain) => {\n        try {\n          await drain(ctx)\n        } catch (err) {\n          console.error(`[evlog/${label}] drain failed:`, err)\n        }\n      }),\n    )\n  }\n}\n\n/**\n * Compose tail-sampling `keep` callbacks. `ctx.shouldKeep` is true after the\n * run if any callback set it. Errors are isolated.\n */\nexport function composeKeep(\n  keepers: Array<(ctx: TailSamplingContext) => void | Promise<void>>,\n  options: { name?: string } = {},\n): (ctx: TailSamplingContext) => Promise<void> {\n  const label = options.name ?? 'compose-keep'\n  return async (ctx) => {\n    for (const keep of keepers) {\n      try {\n        await keep(ctx)\n      } catch (err) {\n        console.error(`[evlog/${label}] keep failed:`, err)\n      }\n    }\n  }\n}\n\n/** Merge plugin lists. Later registrations override earlier ones by `name`. */\nexport function composePlugins(...lists: Array<EvlogPlugin[] | undefined>): EvlogPlugin[] {\n  const merged = new Map<string, EvlogPlugin>()\n  for (const list of lists) {\n    if (!list) continue\n    for (const plugin of list) {\n      merged.set(plugin.name, plugin)\n    }\n  }\n  return Array.from(merged.values())\n}\n","import type { EnrichContext, WideEvent } from '../types'\nimport { mergeEventField } from './event'\n\nexport interface EnricherOptions {\n  /**\n   * Replace existing event fields with the computed value. Defaults to `false`\n   * so user-provided context (e.g. `log.set({ geo: ... })`) wins.\n   */\n  overwrite?: boolean\n}\n\nexport interface EnricherDefinition<T> {\n  /** Stable identifier used in error logs. */\n  name: string\n  /**\n   * Top-level event field to merge into. Omit when the enricher writes to\n   * multiple fields and handles its own merging inside `compute`.\n   */\n  field?: keyof WideEvent & string\n  /** Return `undefined` to skip enrichment (e.g. when a required header is missing). */\n  compute: (ctx: EnrichContext) => T | undefined\n}\n\n/**\n * Build an enricher: skips when `compute` returns `undefined`, merges with\n * {@link mergeEventField} respecting `overwrite`, and isolates errors under\n * `[evlog/{name}]`.\n *\n * @example\n * ```ts\n * export const tenantEnricher = defineEnricher<{ id: string }>({\n *   name: 'tenant',\n *   field: 'tenant',\n *   compute({ headers }) {\n *     const id = getHeader(headers, 'x-tenant-id')\n *     return id ? { id } : undefined\n *   },\n * })\n * ```\n */\nexport function defineEnricher<T>(\n  def: EnricherDefinition<T>,\n  options: EnricherOptions = {},\n): (ctx: EnrichContext) => void {\n  const { name, field, compute } = def\n  return (ctx) => {\n    let computed: T | undefined\n    try {\n      computed = compute(ctx)\n    } catch (err) {\n      console.error(`[evlog/${name}] enrich failed:`, err)\n      return\n    }\n    if (computed === undefined) return\n    if (!field) return\n    const target = ctx.event[field]\n    ctx.event[field] = mergeEventField<T>(target, computed, options.overwrite)\n  }\n}\n"],"mappings":";;;;;;AAOA,SAAgB,iBACd,WACA,UAA6B,EAAE,EACQ;CACvC,MAAM,QAAQ,QAAQ,QAAQ;AAC9B,QAAO,OAAO,QAAQ;AACpB,OAAK,MAAM,YAAY,UACrB,KAAI;AACF,SAAM,SAAS,IAAI;WACZ,KAAK;AACZ,WAAQ,MAAM,UAAU,MAAM,mBAAmB,IAAI;;;;;;;;AAU7D,SAAgB,cACd,QACA,UAA6B,EAAE,EACO;CACtC,MAAM,QAAQ,QAAQ,QAAQ;AAC9B,QAAO,OAAO,QAAQ;AACpB,MAAI,OAAO,WAAW,EAAG;AACzB,QAAM,QAAQ,WACZ,OAAO,IAAI,OAAO,UAAU;AAC1B,OAAI;AACF,UAAM,MAAM,IAAI;YACT,KAAK;AACZ,YAAQ,MAAM,UAAU,MAAM,kBAAkB,IAAI;;IAEtD,CACH;;;;;;;AAQL,SAAgB,YACd,SACA,UAA6B,EAAE,EACc;CAC7C,MAAM,QAAQ,QAAQ,QAAQ;AAC9B,QAAO,OAAO,QAAQ;AACpB,OAAK,MAAM,QAAQ,QACjB,KAAI;AACF,SAAM,KAAK,IAAI;WACR,KAAK;AACZ,WAAQ,MAAM,UAAU,MAAM,iBAAiB,IAAI;;;;;AAO3D,SAAgB,eAAe,GAAG,OAAwD;CACxF,MAAM,yBAAS,IAAI,KAA0B;AAC7C,MAAK,MAAM,QAAQ,OAAO;AACxB,MAAI,CAAC,KAAM;AACX,OAAK,MAAM,UAAU,KACnB,QAAO,IAAI,OAAO,MAAM,OAAO;;AAGnC,QAAO,MAAM,KAAK,OAAO,QAAQ,CAAC;;;;;;;;;;;;;;;;;;;;;ACnCpC,SAAgB,eACd,KACA,UAA2B,EAAE,EACC;CAC9B,MAAM,EAAE,MAAM,OAAO,YAAY;AACjC,SAAQ,QAAQ;EACd,IAAI;AACJ,MAAI;AACF,cAAW,QAAQ,IAAI;WAChB,KAAK;AACZ,WAAQ,MAAM,UAAU,KAAK,mBAAmB,IAAI;AACpD;;AAEF,MAAI,aAAa,KAAA,EAAW;AAC5B,MAAI,CAAC,MAAO;EACZ,MAAM,SAAS,IAAI,MAAM;AACzB,MAAI,MAAM,SAAS,gBAAmB,QAAQ,UAAU,QAAQ,UAAU"}

package/dist/enrichers.d.mts

@@ -1,13 +1,7 @@
-import { I as EnrichContext } from "./audit-CTIviX3P.mjs";
+import { I as EnrichContext } from "./audit-X1uUukm3.mjs";
+import { n as EnricherOptions } from "./enricher-DYTr9I16.mjs";
 
 //#region src/enrichers/index.d.ts
-interface EnricherOptions {
-  /**
-   * When true, overwrite any existing fields in the event.
-   * Defaults to false to preserve user-provided data.
-   */
-  overwrite?: boolean;
-}
 interface UserAgentInfo {
   raw: string;
   browser?: {
@@ -69,6 +63,19 @@ declare function createRequestSizeEnricher(options?: EnricherOptions): (ctx: Enr
  * Also sets `event.traceId` and `event.spanId` at the top level.
  */
 declare function createTraceContextEnricher(options?: EnricherOptions): (ctx: EnrichContext) => void;
+/**
+ * Compose every built-in enricher into a single async enricher, in the order
+ * `userAgent → geo → requestSize → traceContext`.
+ *
+ * Drop-in shorthand for the most common middleware setup:
+ *
+ * ```ts
+ * import { createDefaultEnrichers } from 'evlog/enrichers'
+ *
+ * app.use(evlog({ enrich: createDefaultEnrichers() }))
+ * ```
+ */
+declare function createDefaultEnrichers(options?: EnricherOptions): (ctx: EnrichContext) => Promise<void>;
 //#endregion
-export { EnricherOptions, GeoInfo, RequestSizeInfo, TraceContextInfo, UserAgentInfo, createGeoEnricher, createRequestSizeEnricher, createTraceContextEnricher, createUserAgentEnricher };
+export { type EnricherOptions, GeoInfo, RequestSizeInfo, TraceContextInfo, UserAgentInfo, createDefaultEnrichers, createGeoEnricher, createRequestSizeEnricher, createTraceContextEnricher, createUserAgentEnricher };
 //# sourceMappingURL=enrichers.d.mts.map

package/dist/enrichers.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"enrichers.d.mts","names":[],"sources":["../src/enrichers/index.ts"],"mappings":";;;UAEiB,eAAA;;AAAjB;;;EAKE,SAAA;AAAA;AAAA,UAGe,aAAA;EACf,GAAA;EACA,OAAA;IAAY,IAAA;IAAc,OAAA;EAAA;EAC1B,EAAA;IAAO,IAAA;IAAc,OAAA;EAAA;EACrB,MAAA;IAAW,IAAA;EAAA;AAAA;AAAA,UAGI,OAAA;EACf,OAAA;EACA,MAAA;EACA,UAAA;EACA,IAAA;EACA,QAAA;EACA,SAAA;AAAA;AAAA,UAGe,eAAA;EACf,YAAA;EACA,aAAA;AAAA;AAAA,UAGe,gBAAA;EACf,WAAA;EACA,UAAA;EACA,OAAA;EACA,MAAA;AAAA;AAJF;;;;AAAA,iBAoGgB,uBAAA,CAAwB,OAAA,GAAS,eAAA,IAAwB,GAAA,EAAK,aAAA;;;;;;AAA9E;;;;;;;iBAqBgB,iBAAA,CAAkB,OAAA,GAAS,eAAA,IAAwB,GAAA,EAAK,aAAA;;;AAAxE;;iBAuBgB,yBAAA,CAA0B,OAAA,GAAS,eAAA,IAAwB,GAAA,EAAK,aAAA;;;;;;iBAoBhE,0BAAA,CAA2B,OAAA,GAAS,eAAA,IAAwB,GAAA,EAAK,aAAA"}
+{"version":3,"file":"enrichers.d.mts","names":[],"sources":["../src/enrichers/index.ts"],"mappings":";;;;UAOiB,aAAA;EACf,GAAA;EACA,OAAA;IAAY,IAAA;IAAc,OAAA;EAAA;EAC1B,EAAA;IAAO,IAAA;IAAc,OAAA;EAAA;EACrB,MAAA;IAAW,IAAA;EAAA;AAAA;AAAA,UAGI,OAAA;EACf,OAAA;EACA,MAAA;EACA,UAAA;EACA,IAAA;EACA,QAAA;EACA,SAAA;AAAA;AAAA,UAGe,eAAA;EACf,YAAA;EACA,aAAA;AAAA;AAAA,UAGe,gBAAA;EACf,WAAA;EACA,UAAA;EACA,OAAA;EACA,MAAA;AAAA;;AAJF;;;iBAwEgB,uBAAA,CAAwB,OAAA,GAAS,eAAA,IAAwB,GAAA,EAAK,aAAA;;;;;;;AAA9E;;;;;;iBAuBgB,iBAAA,CAAkB,OAAA,GAAS,eAAA,IAAwB,GAAA,EAAK,aAAA;;;;AAAxE;iBAuBgB,yBAAA,CAA0B,OAAA,GAAS,eAAA,IAAwB,GAAA,EAAK,aAAA;;;;;;iBAkBhE,0BAAA,CAA2B,OAAA,GAAS,eAAA,IAAwB,GAAA,EAAK,aAAA;;;AAlBjF;;;;;;;;;;iBA+DgB,sBAAA,CAAuB,OAAA,GAAS,eAAA,IAAwB,GAAA,EAAK,aAAA,KAAkB,OAAA"}