evlog 2.12.0 → 2.13.0

package/README.md

@@ -1,3 +1,7 @@
+<p align="center">
+  <img src="https://raw.githubusercontent.com/HugoRCD/evlog/main/assets/evlog-banner.gif" width="100%" alt="evlog — Digging through logs is not observability. It's hope" />
+</p>
+
 # evlog
 
 [![npm version](https://img.shields.io/npm/v/evlog?color=black)](https://npmjs.com/package/evlog)
@@ -1062,6 +1066,40 @@ log.emit()                         // Emit final event
 log.getContext()                   // Get current context
 ```
 
+### Wide event lifecycle and `log.fork()`
+
+The framework emits **one wide event per HTTP request** when the response finishes (or on error). After `emit()` runs — including when head sampling drops the event (`emit()` returns `null`) — that logger instance is **sealed**: further `set`, `error`, `info`, and `warn` calls are ignored and emit a **`[evlog]` console warning** listing dropped keys. A second `emit()` is ignored with a warning. This avoids silent data loss when async work (unawaited promises, `setTimeout`, etc.) still resolves `useLogger()` to the same logger via `AsyncLocalStorage` after the response has already been logged.
+
+**`log.fork(label, fn)`** runs work under a **child** request logger: inside `fn`, `useLogger()` returns the child. When `fn` settles, the child emits its **own** wide event with `operation` set to `label` and `_parentRequestId` set to the parent’s `requestId` (query and dashboard correlation). The parent event may be emitted **before** the child event; they are two separate events ordered by time.
+
+`fork` is attached by integrations that use `AsyncLocalStorage` for `useLogger()`. Standalone `createLogger()` instances do not have `fork`.
+
+| Integration | `log.fork()` |
+|-------------|----------------|
+| Express, Fastify, NestJS, SvelteKit, React Router, Elysia | Yes |
+| Next.js `withEvlog` | Yes |
+| Hono (`c.get('log')` only) | Not yet |
+| Nitro / Nuxt `useLogger(event)` | Not yet — use post-emit warnings; see [Wide events](https://evlog.dev/logging/wide-events) |
+
+```typescript
+import { evlog, useLogger } from 'evlog/express'
+
+app.post('/checkout', (req, res) => {
+  const log = req.log
+  log.set({ order_dispatched: true })
+
+  log.fork!('process_order', async () => {
+    const childLog = useLogger()
+    childLog.set({ inventory_checked: true })
+    // child emits automatically when this async function completes
+  })
+
+  res.json({ ok: true })
+})
+```
+
+Use optional chaining if `fork` might be absent: `log.fork?.('task', async () => { ... })`.
+
 ### `initWorkersLogger(options?)`
 
 Initialize evlog for Cloudflare Workers (object logs + correct severity).

package/dist/adapters/axiom.d.mts

@@ -1,4 +1,4 @@
-import { E as WideEvent, r as DrainContext } from "../types-D5OwxZCw.mjs";
+import { E as WideEvent, r as DrainContext } from "../types-DbzDln7O.mjs";
 //#region src/adapters/axiom.d.ts
 interface BaseAxiomConfig {
   /** Axiom dataset name */

package/dist/adapters/better-stack.d.mts

@@ -1,4 +1,4 @@
-import { E as WideEvent, r as DrainContext } from "../types-D5OwxZCw.mjs";
+import { E as WideEvent, r as DrainContext } from "../types-DbzDln7O.mjs";
 //#region src/adapters/better-stack.d.ts
 interface BetterStackConfig {
   /** Better Stack source token */

package/dist/adapters/datadog.d.mts

@@ -1,4 +1,4 @@
-import { E as WideEvent, r as DrainContext } from "../types-D5OwxZCw.mjs";
+import { E as WideEvent, r as DrainContext } from "../types-DbzDln7O.mjs";
 //#region src/adapters/datadog.d.ts
 interface DatadogConfig {
   /** Datadog API key with Logs intake permission */

package/dist/adapters/fs.d.mts

@@ -1,4 +1,4 @@
-import { E as WideEvent, r as DrainContext } from "../types-D5OwxZCw.mjs";
+import { E as WideEvent, r as DrainContext } from "../types-DbzDln7O.mjs";
 //#region src/adapters/fs.d.ts
 interface FsConfig {
   /** Directory for log files */

package/dist/adapters/hyperdx.d.mts

@@ -1,4 +1,4 @@
-import { E as WideEvent, r as DrainContext } from "../types-D5OwxZCw.mjs";
+import { E as WideEvent, r as DrainContext } from "../types-DbzDln7O.mjs";
 import { OTLPConfig } from "./otlp.mjs";
 
 //#region src/adapters/hyperdx.d.ts

package/dist/adapters/otlp.d.mts

@@ -1,4 +1,4 @@
-import { E as WideEvent, r as DrainContext } from "../types-D5OwxZCw.mjs";
+import { E as WideEvent, r as DrainContext } from "../types-DbzDln7O.mjs";
 //#region src/adapters/otlp.d.ts
 interface OTLPConfig {
   /** OTLP HTTP endpoint (e.g., http://localhost:4318) */

package/dist/adapters/posthog.d.mts

@@ -1,4 +1,4 @@
-import { E as WideEvent, r as DrainContext } from "../types-D5OwxZCw.mjs";
+import { E as WideEvent, r as DrainContext } from "../types-DbzDln7O.mjs";
 //#region src/adapters/posthog.d.ts
 interface PostHogConfig {
   /** PostHog project API key */

package/dist/adapters/sentry.d.mts

@@ -1,4 +1,4 @@
-import { E as WideEvent, r as DrainContext } from "../types-D5OwxZCw.mjs";
+import { E as WideEvent, r as DrainContext } from "../types-DbzDln7O.mjs";
 //#region src/adapters/sentry.d.ts
 interface SentryConfig {
   /** Sentry DSN */

package/dist/ai/index.d.mts

@@ -1,4 +1,4 @@
-import { _ as RequestLogger } from "../types-D5OwxZCw.mjs";
+import { _ as RequestLogger } from "../types-DbzDln7O.mjs";
 import { GatewayModelId, TelemetryIntegration } from "ai";
 import { LanguageModelV3, LanguageModelV3Middleware } from "@ai-sdk/provider";
 

package/dist/better-auth/index.d.mts

@@ -0,0 +1,220 @@
+import { _ as RequestLogger } from "../types-DbzDln7O.mjs";
+
+//#region src/better-auth/index.d.ts
+/**
+ * Minimal type for the Better Auth instance.
+ * Only requires `api.getSession` — compatible with any Better Auth configuration.
+ */
+interface BetterAuthInstance {
+  api: {
+    getSession: (opts: {
+      headers: Headers | Record<string, string | string[] | undefined>;
+    }) => Promise<{
+      user: Record<string, unknown>;
+      session: Record<string, unknown>;
+    } | null>;
+  };
+}
+/**
+ * User fields extracted from a Better Auth session.
+ */
+interface AuthUserData {
+  id: string;
+  name?: string;
+  email?: string;
+  image?: string;
+  emailVerified?: boolean;
+  createdAt?: string;
+}
+/**
+ * Session fields extracted from a Better Auth session.
+ */
+interface AuthSessionData {
+  id: string;
+  expiresAt?: string;
+  ipAddress?: string;
+  userAgent?: string;
+  createdAt?: string;
+}
+/**
+ * Options for `identifyUser`.
+ */
+interface IdentifyOptions {
+  /**
+   * Whether to mask the user email (e.g. `h***@domain.com`).
+   * @default false
+   */
+  maskEmail?: boolean;
+  /**
+   * Whether to include session metadata on the wide event.
+   * @default true
+   */
+  session?: boolean;
+  /**
+   * Whitelist of user fields to include.
+   * @default ['id', 'name', 'email', 'image', 'emailVerified', 'createdAt']
+   */
+  fields?: string[];
+  /**
+   * Extend the wide event with additional fields derived from the session.
+   * Useful for Better Auth plugins (organizations, roles, etc.).
+   *
+   * @example
+   * ```ts
+   * identifyUser(log, session, {
+   *   extend: (session) => ({
+   *     organization: session.user.activeOrganization,
+   *     role: session.user.role,
+   *   }),
+   * })
+   * ```
+   */
+  extend?: (session: {
+    user: Record<string, unknown>;
+    session: Record<string, unknown>;
+  }) => Record<string, unknown> | undefined;
+}
+/**
+ * Options for `createAuthMiddleware`.
+ */
+interface AuthMiddlewareOptions extends IdentifyOptions {
+  /**
+   * Route patterns to skip session resolution (glob).
+   * @default ['/api/auth/**']
+   */
+  exclude?: string[];
+  /**
+   * Route patterns to apply session resolution (glob).
+   * If set, only matching routes are resolved.
+   */
+  include?: string[];
+  /**
+   * Called after a user is successfully identified.
+   * Use to add conditional logic based on user data (e.g. force-keep logs for premium users).
+   */
+  onIdentify?: (log: RequestLogger, session: {
+    user: Record<string, unknown>;
+    session: Record<string, unknown>;
+  }) => void | Promise<void>;
+  /**
+   * Called when no session is found (anonymous request).
+   */
+  onAnonymous?: (log: RequestLogger) => void | Promise<void>;
+}
+/**
+ * Options for `createAuthIdentifier`.
+ */
+type AuthIdentifierOptions = AuthMiddlewareOptions;
+/**
+ * Mask an email address for safe logging: `hugo@example.com` -> `h***@example.com`.
+ */
+declare function maskEmail(email: string): string;
+/**
+ * Identify a user on a wide event from a Better Auth session result.
+ *
+ * Sets `userId`, `user`, and optionally `session` fields on the logger.
+ * Safe by default — only extracts whitelisted fields and never logs passwords or tokens.
+ *
+ * Returns `true` if the user was identified, `false` if session data was missing.
+ *
+ * @example
+ * ```ts
+ * import { identifyUser } from 'evlog/better-auth'
+ *
+ * const session = await auth.api.getSession({ headers: event.headers })
+ * if (session) {
+ *   identifyUser(log, session)
+ * }
+ * ```
+ *
+ * @example With email masking
+ * ```ts
+ * identifyUser(log, session, { maskEmail: true })
+ * // user.email → "h***@example.com"
+ * ```
+ *
+ * @example With extend for Better Auth plugins
+ * ```ts
+ * identifyUser(log, session, {
+ *   extend: (s) => ({
+ *     organization: s.user.activeOrganization,
+ *     role: s.user.role,
+ *   }),
+ * })
+ * ```
+ */
+declare function identifyUser(log: RequestLogger, session: {
+  user: Record<string, unknown>;
+  session: Record<string, unknown>;
+}, options?: IdentifyOptions): boolean;
+/**
+ * Create an async function that resolves a Better Auth session from headers
+ * and identifies the user on the logger.
+ *
+ * Works with any framework — just pass the auth instance and call the returned
+ * function with a logger and headers. Supports `include`/`exclude` route patterns
+ * and lifecycle hooks (`onIdentify`, `onAnonymous`).
+ *
+ * @example Nuxt server middleware
+ * ```ts
+ * import { createAuthMiddleware } from 'evlog/better-auth'
+ *
+ * const identify = createAuthMiddleware(auth, {
+ *   exclude: ['/api/auth/**', '/api/public/**'],
+ * })
+ *
+ * export default defineEventHandler(async (event) => {
+ *   if (!event.context.log) return
+ *   await identify(event.context.log, event.headers, event.path)
+ * })
+ * ```
+ *
+ * @example Express
+ * ```ts
+ * const identify = createAuthMiddleware(auth, { maskEmail: true })
+ *
+ * app.use(async (req, res, next) => {
+ *   await identify(req.log, req.headers, req.path)
+ *   next()
+ * })
+ * ```
+ */
+declare function createAuthMiddleware(auth: BetterAuthInstance, options?: AuthMiddlewareOptions): (log: RequestLogger, headers: Headers | Record<string, string | string[] | undefined>, path?: string) => Promise<boolean>;
+/**
+ * Create a Nitro `request` hook that auto-identifies users from Better Auth sessions.
+ *
+ * Resolves the session from request cookies on every request and sets user/session
+ * context on the evlog logger. Skips `/api/auth/**` by default to avoid resolving
+ * sessions during auth flows.
+ *
+ * @example
+ * ```ts
+ * // server/plugins/evlog-auth.ts
+ * import { createAuthIdentifier } from 'evlog/better-auth'
+ * import { auth } from '~/lib/auth'
+ *
+ * export default defineNitroPlugin((nitroApp) => {
+ *   nitroApp.hooks.hook('request', createAuthIdentifier(auth))
+ * })
+ * ```
+ *
+ * @example With options
+ * ```ts
+ * nitroApp.hooks.hook('request', createAuthIdentifier(auth, {
+ *   maskEmail: true,
+ *   exclude: ['/api/auth/**', '/api/public/**'],
+ * }))
+ * ```
+ */
+declare function createAuthIdentifier(auth: BetterAuthInstance, options?: AuthIdentifierOptions): (event: {
+  path: string;
+  headers: Headers | {
+    get(name: string): string | null;
+  };
+  context: {
+    log?: RequestLogger;
+  };
+}) => Promise<void>;
+//#endregion
+export { AuthIdentifierOptions, AuthMiddlewareOptions, AuthSessionData, AuthUserData, BetterAuthInstance, IdentifyOptions, createAuthIdentifier, createAuthMiddleware, identifyUser, maskEmail };
+//# sourceMappingURL=index.d.mts.map

package/dist/better-auth/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/better-auth/index.ts"],"mappings":";;;;;AAOA;;UAAiB,kBAAA;EACf,GAAA;IACE,UAAA,GAAa,IAAA;MACX,OAAA,EAAS,OAAA,GAAU,MAAA;IAAA,MACf,OAAA;MACJ,IAAA,EAAM,MAAA;MACN,OAAA,EAAS,MAAA;IAAA;EAAA;AAAA;;;;UAQE,YAAA;EACf,EAAA;EACA,IAAA;EACA,KAAA;EACA,KAAA;EACA,aAAA;EACA,SAAA;AAAA;AANF;;;AAAA,UAYiB,eAAA;EACf,EAAA;EACA,SAAA;EACA,SAAA;EACA,SAAA;EACA,SAAA;AAAA;;;AALF;UAWiB,eAAA;;;;;EAKf,SAAA;EAZA;;;;EAiBA,OAAA;EAV8B;;;;EAe9B,MAAA;EAeiG;;;;;;;;;;;;;;EAAjG,MAAA,IAAU,OAAA;IAAW,IAAA,EAAM,MAAA;IAAyB,OAAA,EAAS,MAAA;EAAA,MAA8B,MAAA;AAAA;;;;UAM5E,qBAAA,SAA8B,eAAA;EAAA;;;;EAK7C,OAAA;EAKA;;;;EAAA,OAAA;EAKmD;;;;EAAnD,UAAA,IAAc,GAAA,EAAK,aAAA,EAAe,OAAA;IAAW,IAAA,EAAM,MAAA;IAAyB,OAAA,EAAS,MAAA;EAAA,aAAqC,OAAA;EAI7E;;;EAA7C,WAAA,IAAe,GAAA,EAAK,aAAA,YAAyB,OAAA;AAAA;;;;KAMnC,qBAAA,GAAwB,qBAAA;;;;iBASpB,SAAA,CAAU,KAAA;AAyF1B;;;;;;;;;;;;;;;;;;;;AA4EA;;;;;;;;;;;;;;AA5EA,iBAAgB,YAAA,CACd,GAAA,EAAK,aAAA,EACL,OAAA;EAAW,IAAA,EAAM,MAAA;EAAyB,OAAA,EAAS,MAAA;AAAA,GACnD,OAAA,GAAU,eAAA;;;;;;;AAqIZ;;;;;;;;;;;;;;;;;;;;;;;;;;iBA5DgB,oBAAA,CACd,IAAA,EAAM,kBAAA,EACN,OAAA,GAAU,qBAAA,IACR,GAAA,EAAK,aAAA,EAAe,OAAA,EAAS,OAAA,GAAU,MAAA,yCAA+C,IAAA,cAAkB,OAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAyD5F,oBAAA,CACd,IAAA,EAAM,kBAAA,EACN,OAAA,GAAU,qBAAA,IACR,KAAA;EAAS,IAAA;EAAc,OAAA,EAAS,OAAA;IAAY,GAAA,CAAI,IAAA;EAAA;EAAgC,OAAA;IAAW,GAAA,GAAM,aAAA;EAAA;AAAA,MAAsB,OAAA"}

package/dist/better-auth/index.mjs

@@ -0,0 +1,205 @@
+import { matchesPattern } from "../utils.mjs";
+//#region src/better-auth/index.ts
+const DEFAULT_USER_FIELDS = [
+	"id",
+	"name",
+	"email",
+	"image",
+	"emailVerified",
+	"createdAt"
+];
+const isDev = typeof process !== "undefined" && process.env?.NODE_ENV !== "production";
+/**
+* Mask an email address for safe logging: `hugo@example.com` -> `h***@example.com`.
+*/
+function maskEmail(email) {
+	const atIndex = email.indexOf("@");
+	if (atIndex <= 0) return "***";
+	return `${email[0]}***${email.slice(atIndex)}`;
+}
+function extractUserData(user, options) {
+	const fields = options?.fields ?? DEFAULT_USER_FIELDS;
+	const data = {};
+	if (user.id !== void 0 && user.id !== null) data.id = user.id;
+	for (const field of fields) {
+		if (field === "id") continue;
+		const value = user[field];
+		if (value === void 0 || value === null) continue;
+		if (field === "email" && options?.maskEmail && typeof value === "string") data[field] = maskEmail(value);
+		else if (field === "createdAt" && value instanceof Date) data[field] = value.toISOString();
+		else data[field] = value;
+	}
+	return data;
+}
+function extractSessionData(session) {
+	const data = { id: String(session.id) };
+	if (session.expiresAt) data.expiresAt = session.expiresAt instanceof Date ? session.expiresAt.toISOString() : String(session.expiresAt);
+	if (typeof session.ipAddress === "string") data.ipAddress = session.ipAddress;
+	if (typeof session.userAgent === "string") data.userAgent = session.userAgent;
+	if (session.createdAt) data.createdAt = session.createdAt instanceof Date ? session.createdAt.toISOString() : String(session.createdAt);
+	return data;
+}
+/**
+* Identify a user on a wide event from a Better Auth session result.
+*
+* Sets `userId`, `user`, and optionally `session` fields on the logger.
+* Safe by default — only extracts whitelisted fields and never logs passwords or tokens.
+*
+* Returns `true` if the user was identified, `false` if session data was missing.
+*
+* @example
+* ```ts
+* import { identifyUser } from 'evlog/better-auth'
+*
+* const session = await auth.api.getSession({ headers: event.headers })
+* if (session) {
+*   identifyUser(log, session)
+* }
+* ```
+*
+* @example With email masking
+* ```ts
+* identifyUser(log, session, { maskEmail: true })
+* // user.email → "h***@example.com"
+* ```
+*
+* @example With extend for Better Auth plugins
+* ```ts
+* identifyUser(log, session, {
+*   extend: (s) => ({
+*     organization: s.user.activeOrganization,
+*     role: s.user.role,
+*   }),
+* })
+* ```
+*/
+function identifyUser(log, session, options) {
+	const user = extractUserData(session.user, options);
+	if (!user.id) return false;
+	const includeSession = options?.session !== false;
+	const data = {
+		userId: user.id,
+		user
+	};
+	if (includeSession) data.session = extractSessionData(session.session);
+	if (options?.extend) {
+		const extra = options.extend(session);
+		if (extra) Object.assign(data, extra);
+	}
+	log.set(data);
+	return true;
+}
+function shouldResolve(path, options) {
+	const exclude = options?.exclude ?? ["/api/auth/**"];
+	for (const pattern of exclude) if (matchesPattern(path, pattern)) return false;
+	if (options?.include) {
+		for (const pattern of options.include) if (matchesPattern(path, pattern)) return true;
+		return false;
+	}
+	return true;
+}
+/**
+* Create an async function that resolves a Better Auth session from headers
+* and identifies the user on the logger.
+*
+* Works with any framework — just pass the auth instance and call the returned
+* function with a logger and headers. Supports `include`/`exclude` route patterns
+* and lifecycle hooks (`onIdentify`, `onAnonymous`).
+*
+* @example Nuxt server middleware
+* ```ts
+* import { createAuthMiddleware } from 'evlog/better-auth'
+*
+* const identify = createAuthMiddleware(auth, {
+*   exclude: ['/api/auth/**', '/api/public/**'],
+* })
+*
+* export default defineEventHandler(async (event) => {
+*   if (!event.context.log) return
+*   await identify(event.context.log, event.headers, event.path)
+* })
+* ```
+*
+* @example Express
+* ```ts
+* const identify = createAuthMiddleware(auth, { maskEmail: true })
+*
+* app.use(async (req, res, next) => {
+*   await identify(req.log, req.headers, req.path)
+*   next()
+* })
+* ```
+*/
+function createAuthMiddleware(auth, options) {
+	return async (log, headers, path) => {
+		if (path && !shouldResolve(path, options)) return false;
+		const start = Date.now();
+		try {
+			const session = await auth.api.getSession({ headers });
+			const resolvedIn = Date.now() - start;
+			if (session) {
+				if (identifyUser(log, session, options)) {
+					log.set({ auth: {
+						resolvedIn,
+						identified: true
+					} });
+					if (options?.onIdentify) await options.onIdentify(log, session);
+					return true;
+				}
+			}
+			log.set({ auth: {
+				resolvedIn,
+				identified: false
+			} });
+			if (options?.onAnonymous) await options.onAnonymous(log);
+			return false;
+		} catch (err) {
+			const resolvedIn = Date.now() - start;
+			log.set({ auth: {
+				resolvedIn,
+				identified: false,
+				error: true
+			} });
+			if (isDev) console.warn("[evlog/better-auth] Session resolution failed:", err);
+			if (options?.onAnonymous) await options.onAnonymous(log);
+			return false;
+		}
+	};
+}
+/**
+* Create a Nitro `request` hook that auto-identifies users from Better Auth sessions.
+*
+* Resolves the session from request cookies on every request and sets user/session
+* context on the evlog logger. Skips `/api/auth/**` by default to avoid resolving
+* sessions during auth flows.
+*
+* @example
+* ```ts
+* // server/plugins/evlog-auth.ts
+* import { createAuthIdentifier } from 'evlog/better-auth'
+* import { auth } from '~/lib/auth'
+*
+* export default defineNitroPlugin((nitroApp) => {
+*   nitroApp.hooks.hook('request', createAuthIdentifier(auth))
+* })
+* ```
+*
+* @example With options
+* ```ts
+* nitroApp.hooks.hook('request', createAuthIdentifier(auth, {
+*   maskEmail: true,
+*   exclude: ['/api/auth/**', '/api/public/**'],
+* }))
+* ```
+*/
+function createAuthIdentifier(auth, options) {
+	const middleware = createAuthMiddleware(auth, options);
+	return async (event) => {
+		if (!event.context.log) return;
+		await middleware(event.context.log, event.headers, event.path);
+	};
+}
+//#endregion
+export { createAuthIdentifier, createAuthMiddleware, identifyUser, maskEmail };
+
+//# sourceMappingURL=index.mjs.map

package/dist/better-auth/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../../src/better-auth/index.ts"],"sourcesContent":["import type { RequestLogger } from '../types'\nimport { matchesPattern } from '../utils'\n\n/**\n * Minimal type for the Better Auth instance.\n * Only requires `api.getSession` — compatible with any Better Auth configuration.\n */\nexport interface BetterAuthInstance {\n  api: {\n    getSession: (opts: {\n      headers: Headers | Record<string, string | string[] | undefined>\n    }) => Promise<{\n      user: Record<string, unknown>\n      session: Record<string, unknown>\n    } | null>\n  }\n}\n\n/**\n * User fields extracted from a Better Auth session.\n */\nexport interface AuthUserData {\n  id: string\n  name?: string\n  email?: string\n  image?: string\n  emailVerified?: boolean\n  createdAt?: string\n}\n\n/**\n * Session fields extracted from a Better Auth session.\n */\nexport interface AuthSessionData {\n  id: string\n  expiresAt?: string\n  ipAddress?: string\n  userAgent?: string\n  createdAt?: string\n}\n\n/**\n * Options for `identifyUser`.\n */\nexport interface IdentifyOptions {\n  /**\n   * Whether to mask the user email (e.g. `h***@domain.com`).\n   * @default false\n   */\n  maskEmail?: boolean\n  /**\n   * Whether to include session metadata on the wide event.\n   * @default true\n   */\n  session?: boolean\n  /**\n   * Whitelist of user fields to include.\n   * @default ['id', 'name', 'email', 'image', 'emailVerified', 'createdAt']\n   */\n  fields?: string[]\n  /**\n   * Extend the wide event with additional fields derived from the session.\n   * Useful for Better Auth plugins (organizations, roles, etc.).\n   *\n   * @example\n   * ```ts\n   * identifyUser(log, session, {\n   *   extend: (session) => ({\n   *     organization: session.user.activeOrganization,\n   *     role: session.user.role,\n   *   }),\n   * })\n   * ```\n   */\n  extend?: (session: { user: Record<string, unknown>, session: Record<string, unknown> }) => Record<string, unknown> | undefined\n}\n\n/**\n * Options for `createAuthMiddleware`.\n */\nexport interface AuthMiddlewareOptions extends IdentifyOptions {\n  /**\n   * Route patterns to skip session resolution (glob).\n   * @default ['/api/auth/**']\n   */\n  exclude?: string[]\n  /**\n   * Route patterns to apply session resolution (glob).\n   * If set, only matching routes are resolved.\n   */\n  include?: string[]\n  /**\n   * Called after a user is successfully identified.\n   * Use to add conditional logic based on user data (e.g. force-keep logs for premium users).\n   */\n  onIdentify?: (log: RequestLogger, session: { user: Record<string, unknown>, session: Record<string, unknown> }) => void | Promise<void>\n  /**\n   * Called when no session is found (anonymous request).\n   */\n  onAnonymous?: (log: RequestLogger) => void | Promise<void>\n}\n\n/**\n * Options for `createAuthIdentifier`.\n */\nexport type AuthIdentifierOptions = AuthMiddlewareOptions\n\nconst DEFAULT_USER_FIELDS = ['id', 'name', 'email', 'image', 'emailVerified', 'createdAt']\n\nconst isDev = typeof process !== 'undefined' && process.env?.NODE_ENV !== 'production'\n\n/**\n * Mask an email address for safe logging: `hugo@example.com` -> `h***@example.com`.\n */\nexport function maskEmail(email: string): string {\n  const atIndex = email.indexOf('@')\n  if (atIndex <= 0) return '***'\n  return `${email[0]}***${email.slice(atIndex)}`\n}\n\nfunction extractUserData(\n  user: Record<string, unknown>,\n  options?: IdentifyOptions,\n): AuthUserData {\n  const fields = options?.fields ?? DEFAULT_USER_FIELDS\n  const data: Record<string, unknown> = {}\n\n  if (user.id !== undefined && user.id !== null) {\n    data.id = user.id\n  }\n\n  for (const field of fields) {\n    if (field === 'id') continue\n    const value = user[field]\n    if (value === undefined || value === null) continue\n\n    if (field === 'email' && options?.maskEmail && typeof value === 'string') {\n      data[field] = maskEmail(value)\n    } else if (field === 'createdAt' && value instanceof Date) {\n      data[field] = value.toISOString()\n    } else {\n      data[field] = value\n    }\n  }\n\n  return data as unknown as AuthUserData\n}\n\nfunction extractSessionData(\n  session: Record<string, unknown>,\n): AuthSessionData {\n  const data: AuthSessionData = { id: String(session.id) }\n\n  if (session.expiresAt) {\n    data.expiresAt = session.expiresAt instanceof Date\n      ? session.expiresAt.toISOString()\n      : String(session.expiresAt)\n  }\n  if (typeof session.ipAddress === 'string') data.ipAddress = session.ipAddress\n  if (typeof session.userAgent === 'string') data.userAgent = session.userAgent\n  if (session.createdAt) {\n    data.createdAt = session.createdAt instanceof Date\n      ? session.createdAt.toISOString()\n      : String(session.createdAt)\n  }\n\n  return data\n}\n\n/**\n * Identify a user on a wide event from a Better Auth session result.\n *\n * Sets `userId`, `user`, and optionally `session` fields on the logger.\n * Safe by default — only extracts whitelisted fields and never logs passwords or tokens.\n *\n * Returns `true` if the user was identified, `false` if session data was missing.\n *\n * @example\n * ```ts\n * import { identifyUser } from 'evlog/better-auth'\n *\n * const session = await auth.api.getSession({ headers: event.headers })\n * if (session) {\n *   identifyUser(log, session)\n * }\n * ```\n *\n * @example With email masking\n * ```ts\n * identifyUser(log, session, { maskEmail: true })\n * // user.email → \"h***@example.com\"\n * ```\n *\n * @example With extend for Better Auth plugins\n * ```ts\n * identifyUser(log, session, {\n *   extend: (s) => ({\n *     organization: s.user.activeOrganization,\n *     role: s.user.role,\n *   }),\n * })\n * ```\n */\nexport function identifyUser(\n  log: RequestLogger,\n  session: { user: Record<string, unknown>, session: Record<string, unknown> },\n  options?: IdentifyOptions,\n): boolean {\n  const user = extractUserData(session.user, options)\n  if (!user.id) return false\n\n  const includeSession = options?.session !== false\n\n  const data: Record<string, unknown> = {\n    userId: user.id,\n    user,\n  }\n\n  if (includeSession) {\n    data.session = extractSessionData(session.session)\n  }\n\n  if (options?.extend) {\n    const extra = options.extend(session)\n    if (extra) Object.assign(data, extra)\n  }\n\n  log.set(data)\n  return true\n}\n\nfunction shouldResolve(path: string, options?: { exclude?: string[], include?: string[] }): boolean {\n  const exclude = options?.exclude ?? ['/api/auth/**']\n  for (const pattern of exclude) {\n    if (matchesPattern(path, pattern)) return false\n  }\n\n  if (options?.include) {\n    for (const pattern of options.include) {\n      if (matchesPattern(path, pattern)) return true\n    }\n    return false\n  }\n\n  return true\n}\n\n/**\n * Create an async function that resolves a Better Auth session from headers\n * and identifies the user on the logger.\n *\n * Works with any framework — just pass the auth instance and call the returned\n * function with a logger and headers. Supports `include`/`exclude` route patterns\n * and lifecycle hooks (`onIdentify`, `onAnonymous`).\n *\n * @example Nuxt server middleware\n * ```ts\n * import { createAuthMiddleware } from 'evlog/better-auth'\n *\n * const identify = createAuthMiddleware(auth, {\n *   exclude: ['/api/auth/**', '/api/public/**'],\n * })\n *\n * export default defineEventHandler(async (event) => {\n *   if (!event.context.log) return\n *   await identify(event.context.log, event.headers, event.path)\n * })\n * ```\n *\n * @example Express\n * ```ts\n * const identify = createAuthMiddleware(auth, { maskEmail: true })\n *\n * app.use(async (req, res, next) => {\n *   await identify(req.log, req.headers, req.path)\n *   next()\n * })\n * ```\n */\nexport function createAuthMiddleware(\n  auth: BetterAuthInstance,\n  options?: AuthMiddlewareOptions,\n): (log: RequestLogger, headers: Headers | Record<string, string | string[] | undefined>, path?: string) => Promise<boolean> {\n  return async (log, headers, path?) => {\n    if (path && !shouldResolve(path, options)) return false\n\n    const start = Date.now()\n    try {\n      const session = await auth.api.getSession({ headers })\n      const resolvedIn = Date.now() - start\n\n      if (session) {\n        const identified = identifyUser(log, session, options)\n        if (identified) {\n          log.set({ auth: { resolvedIn, identified: true } } as Record<string, unknown>)\n          if (options?.onIdentify) await options.onIdentify(log, session)\n          return true\n        }\n      }\n\n      log.set({ auth: { resolvedIn, identified: false } } as Record<string, unknown>)\n      if (options?.onAnonymous) await options.onAnonymous(log)\n      return false\n    } catch (err) {\n      const resolvedIn = Date.now() - start\n      log.set({ auth: { resolvedIn, identified: false, error: true } } as Record<string, unknown>)\n      if (isDev) console.warn('[evlog/better-auth] Session resolution failed:', err)\n      if (options?.onAnonymous) await options.onAnonymous(log)\n      return false\n    }\n  }\n}\n\n/**\n * Create a Nitro `request` hook that auto-identifies users from Better Auth sessions.\n *\n * Resolves the session from request cookies on every request and sets user/session\n * context on the evlog logger. Skips `/api/auth/**` by default to avoid resolving\n * sessions during auth flows.\n *\n * @example\n * ```ts\n * // server/plugins/evlog-auth.ts\n * import { createAuthIdentifier } from 'evlog/better-auth'\n * import { auth } from '~/lib/auth'\n *\n * export default defineNitroPlugin((nitroApp) => {\n *   nitroApp.hooks.hook('request', createAuthIdentifier(auth))\n * })\n * ```\n *\n * @example With options\n * ```ts\n * nitroApp.hooks.hook('request', createAuthIdentifier(auth, {\n *   maskEmail: true,\n *   exclude: ['/api/auth/**', '/api/public/**'],\n * }))\n * ```\n */\nexport function createAuthIdentifier(\n  auth: BetterAuthInstance,\n  options?: AuthIdentifierOptions,\n): (event: { path: string, headers: Headers | { get(name: string): string | null }, context: { log?: RequestLogger } }) => Promise<void> {\n  const middleware = createAuthMiddleware(auth, options)\n\n  return async (event) => {\n    if (!event.context.log) return\n    await middleware(event.context.log, event.headers as Headers, event.path)\n  }\n}\n"],"mappings":"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"}

package/dist/browser.d.mts

@@ -1,4 +1,4 @@
-import { r as DrainContext } from "./types-D5OwxZCw.mjs";
+import { r as DrainContext } from "./types-DbzDln7O.mjs";
 import { PipelineDrainFn } from "./pipeline.mjs";
 import { HttpDrainConfig, HttpLogDrainOptions } from "./http.mjs";
 

package/dist/elysia/index.d.mts

@@ -1,5 +1,5 @@
-import { _ as RequestLogger } from "../types-D5OwxZCw.mjs";
-import { t as BaseEvlogOptions } from "../middleware-D_igVy93.mjs";
+import { _ as RequestLogger } from "../types-DbzDln7O.mjs";
+import { t as BaseEvlogOptions } from "../middleware-FgC1OdOD.mjs";
 import { Elysia } from "elysia";
 
 //#region src/elysia/index.d.ts

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/elysia/index.ts"],"mappings":";;;;;KAeY,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":";;;;;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"}

package/dist/elysia/index.mjs

@@ -1,5 +1,6 @@
 import { filterSafeHeaders } from "../utils.mjs";
-import { r as createMiddlewareLogger } from "../headers-ht4yS2mx.mjs";
+import { t as createMiddlewareLogger } from "../middleware-BtBuosFV.mjs";
+import { t as attachForkToLogger } from "../fork-Y4z8iHti.mjs";
 import { AsyncLocalStorage } from "node:async_hooks";
 import { Elysia } from "elysia";
 //#region src/elysia/index.ts
@@ -32,14 +33,25 @@ 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 { logger, finish, skipped } = createMiddlewareLogger({
+		const middlewareOpts = {
 			method: request.method,
 			path,
 			requestId: headers["x-request-id"] || crypto.randomUUID(),
 			headers: filterSafeHeaders(headers),
 			...options
-		});
-		if (!skipped) activeLoggers.add(logger);
+		};
+		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);
+		}
 		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 { 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 { logger, finish, skipped } = createMiddlewareLogger({\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\n      if (!skipped) activeLoggers.add(logger)\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":";;;;;AAOA,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,EAAE,QAAQ,QAAQ,YAAY,uBAAuB;GACzD,QAAQ,QAAQ;GAChB;GACA,WAAW,QAAQ,mBAAmB,OAAO,YAAY;GAGzD,SAAS,kBAAkB,QAAkC;GAC7D,GAAG;GACJ,CAAC;AAEF,MAAI,CAAC,QAAS,eAAc,IAAI,OAAO;AACvC,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 { 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"}