evlog 1.10.0 → 1.11.0

package/README.md

@@ -996,7 +996,7 @@ try {
 | **Analog** | Nitro v2 module setup |
 | **Vinxi** | Nitro v2 module setup |
 | **SolidStart** | Nitro v2 module setup ([example](./examples/solidstart)) |
-| **TanStack Start** | Nitro v2 module setup |
+| **TanStack Start** | Nitro v3 module setup ([example](./examples/tanstack-start)) |
 
 ## Agent Skills
 

package/dist/nitro/plugin.mjs

@@ -62,6 +62,7 @@ async function callEnrichAndDrain(nitroApp, emittedEvent, event) {
 	});
 	const waitUntilCtx = event.context.cloudflare?.context ?? event.context;
 	if (typeof waitUntilCtx?.waitUntil === "function") waitUntilCtx.waitUntil(drainPromise);
+	else await drainPromise;
 }
 var plugin_default = defineNitroPlugin(async (nitroApp) => {
 	let evlogConfig;

package/dist/nitro/plugin.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.mjs","names":[],"sources":["../../src/nitro/plugin.ts"],"sourcesContent":["import type { NitroApp } from 'nitropack/types'\n// Import from specific subpaths to avoid the barrel 'nitropack/runtime' which\n// re-exports from internal/app.mjs — that file imports #nitro-internal-virtual/*\n// modules that only exist inside rollup builds and crash when loaded externally\n// (nitropack dev loads plugins outside the bundle via Worker threads).\nimport { defineNitroPlugin } from 'nitropack/runtime/internal/plugin'\nimport { getHeaders } from 'h3'\nimport { createRequestLogger, initLogger, isEnabled } from '../logger'\nimport { shouldLog, getServiceForPath, extractErrorStatus } from '../nitro'\nimport type { EvlogConfig } from '../nitro'\nimport type { EnrichContext, RequestLogger, ServerEvent, TailSamplingContext, WideEvent } from '../types'\nimport { filterSafeHeaders } from '../utils'\n\nfunction getSafeHeaders(event: ServerEvent): Record<string, string> {\n  const allHeaders = getHeaders(event as Parameters<typeof getHeaders>[0])\n  return filterSafeHeaders(allHeaders)\n}\n\nfunction getSafeResponseHeaders(event: ServerEvent): Record<string, string> | undefined {\n  const headers: Record<string, string> = {}\n  const nodeRes = event.node?.res as { getHeaders?: () => Record<string, unknown> } | undefined\n\n  if (nodeRes?.getHeaders) {\n    for (const [key, value] of Object.entries(nodeRes.getHeaders())) {\n      if (value === undefined) continue\n      headers[key] = Array.isArray(value) ? value.join(', ') : String(value)\n    }\n  }\n\n  if (event.response?.headers) {\n    event.response.headers.forEach((value, key) => {\n      headers[key] = value\n    })\n  }\n\n  if (Object.keys(headers).length === 0) return undefined\n  return filterSafeHeaders(headers)\n}\n\nfunction getResponseStatus(event: ServerEvent): number {\n  // Node.js style\n  if (event.node?.res?.statusCode) {\n    return event.node.res.statusCode\n  }\n\n  // Web Standard\n  if (event.response?.status) {\n    return event.response.status\n  }\n\n  // Context-based\n  if (typeof event.context.status === 'number') {\n    return event.context.status\n  }\n\n  return 200\n}\n\nfunction buildHookContext(event: ServerEvent): Omit<EnrichContext, 'event'> {\n  const responseHeaders = getSafeResponseHeaders(event)\n  return {\n    request: { method: event.method, path: event.path },\n    headers: getSafeHeaders(event),\n    response: {\n      status: getResponseStatus(event),\n      headers: responseHeaders,\n    },\n  }\n}\n\nasync function callEnrichAndDrain(\n  nitroApp: NitroApp,\n  emittedEvent: WideEvent | null,\n  event: ServerEvent,\n): Promise<void> {\n  if (!emittedEvent) return\n\n  const hookContext = buildHookContext(event)\n\n  try {\n    await nitroApp.hooks.callHook('evlog:enrich', { event: emittedEvent, ...hookContext })\n  } catch (err) {\n    console.error('[evlog] enrich failed:', err)\n  }\n\n  const drainPromise = nitroApp.hooks.callHook('evlog:drain', {\n    event: emittedEvent,\n    request: hookContext.request,\n    headers: hookContext.headers,\n  }).catch((err) => {\n    console.error('[evlog] drain failed:', err)\n  })\n\n  // Use waitUntil if available (Cloudflare Workers, Vercel Edge)\n  // This ensures drains complete before the runtime terminates\n  const waitUntilCtx = event.context.cloudflare?.context ?? event.context\n  if (typeof waitUntilCtx?.waitUntil === 'function') {\n    waitUntilCtx.waitUntil(drainPromise)\n  }\n}\n\nexport default defineNitroPlugin(async (nitroApp) => {\n  // Config resolution: process.env bridge first (always set by the module),\n  // then lazy useRuntimeConfig() for production builds where env may not persist.\n  let evlogConfig: EvlogConfig | undefined\n  if (process.env.__EVLOG_CONFIG) {\n    evlogConfig = JSON.parse(process.env.__EVLOG_CONFIG)\n  } else {\n    try {\n      // nitropack/runtime/internal/config imports virtual modules —\n      // only works inside rollup-bundled output (production builds).\n      const { useRuntimeConfig } = await import('nitropack/runtime/internal/config')\n      evlogConfig = (useRuntimeConfig() as Record<string, any>).evlog\n    } catch {\n      // Expected in dev mode — virtual modules unavailable outside rollup\n    }\n  }\n\n  initLogger({\n    enabled: evlogConfig?.enabled,\n    env: evlogConfig?.env,\n    pretty: evlogConfig?.pretty,\n    sampling: evlogConfig?.sampling,\n  })\n\n  if (!isEnabled()) return\n\n  nitroApp.hooks.hook('request', (event) => {\n    const e = event as ServerEvent\n\n    // Skip logging for routes not matching include/exclude patterns\n    if (!shouldLog(e.path, evlogConfig?.include, evlogConfig?.exclude)) {\n      return\n    }\n\n    // Store start time for duration calculation in tail sampling\n    e.context._evlogStartTime = Date.now()\n\n    let requestIdOverride: string | undefined = undefined\n    if (globalThis.navigator?.userAgent === 'Cloudflare-Workers') {\n      const cfRay = getSafeHeaders(e)?.['cf-ray']\n      if (cfRay) requestIdOverride = cfRay\n    }\n\n    const requestLog = createRequestLogger({\n      method: e.method,\n      path: e.path,\n      requestId: requestIdOverride || e.context.requestId || crypto.randomUUID(),\n    })\n\n    // Apply route-based service configuration if a matching route is found\n    const routeService = getServiceForPath(e.path, evlogConfig?.routes)\n    if (routeService) {\n      requestLog.set({ service: routeService })\n    }\n\n    e.context.log = requestLog\n  })\n\n  nitroApp.hooks.hook('error', async (error, { event }) => {\n    const e = event as ServerEvent | undefined\n    if (!e) return\n\n    const requestLog = e.context.log as RequestLogger | undefined\n    if (requestLog) {\n      requestLog.error(error as Error)\n\n      const errorStatus = extractErrorStatus(error)\n      requestLog.set({ status: errorStatus })\n\n      // Build tail sampling context\n      const startTime = e.context._evlogStartTime as number | undefined\n      const durationMs = startTime ? Date.now() - startTime : undefined\n\n      const tailCtx: TailSamplingContext = {\n        status: errorStatus,\n        duration: durationMs,\n        path: e.path,\n        method: e.method,\n        context: requestLog.getContext(),\n        shouldKeep: false,\n      }\n\n      // Call evlog:emit:keep hook\n      await nitroApp.hooks.callHook('evlog:emit:keep', tailCtx)\n\n      e.context._evlogEmitted = true\n\n      const emittedEvent = requestLog.emit({ _forceKeep: tailCtx.shouldKeep })\n      await callEnrichAndDrain(nitroApp, emittedEvent, e)\n    }\n  })\n\n  nitroApp.hooks.hook('afterResponse', async (event) => {\n    const e = event as ServerEvent\n    // Skip if already emitted by error hook\n    if (e.context._evlogEmitted) return\n\n    const requestLog = e.context.log as RequestLogger | undefined\n    if (requestLog) {\n      const status = getResponseStatus(e)\n      requestLog.set({ status })\n\n      const startTime = e.context._evlogStartTime as number | undefined\n      const durationMs = startTime ? Date.now() - startTime : undefined\n\n      const tailCtx: TailSamplingContext = {\n        status,\n        duration: durationMs,\n        path: e.path,\n        method: e.method,\n        context: requestLog.getContext(),\n        shouldKeep: false,\n      }\n\n      await nitroApp.hooks.callHook('evlog:emit:keep', tailCtx)\n\n      const emittedEvent = requestLog.emit({ _forceKeep: tailCtx.shouldKeep })\n      await callEnrichAndDrain(nitroApp, emittedEvent, e)\n    }\n  })\n})\n"],"mappings":"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"}
+{"version":3,"file":"plugin.mjs","names":[],"sources":["../../src/nitro/plugin.ts"],"sourcesContent":["import type { NitroApp } from 'nitropack/types'\n// Import from specific subpaths to avoid the barrel 'nitropack/runtime' which\n// re-exports from internal/app.mjs — that file imports #nitro-internal-virtual/*\n// modules that only exist inside rollup builds and crash when loaded externally\n// (nitropack dev loads plugins outside the bundle via Worker threads).\nimport { defineNitroPlugin } from 'nitropack/runtime/internal/plugin'\nimport { getHeaders } from 'h3'\nimport { createRequestLogger, initLogger, isEnabled } from '../logger'\nimport { shouldLog, getServiceForPath, extractErrorStatus } from '../nitro'\nimport type { EvlogConfig } from '../nitro'\nimport type { EnrichContext, RequestLogger, ServerEvent, TailSamplingContext, WideEvent } from '../types'\nimport { filterSafeHeaders } from '../utils'\n\nfunction getSafeHeaders(event: ServerEvent): Record<string, string> {\n  const allHeaders = getHeaders(event as Parameters<typeof getHeaders>[0])\n  return filterSafeHeaders(allHeaders)\n}\n\nfunction getSafeResponseHeaders(event: ServerEvent): Record<string, string> | undefined {\n  const headers: Record<string, string> = {}\n  const nodeRes = event.node?.res as { getHeaders?: () => Record<string, unknown> } | undefined\n\n  if (nodeRes?.getHeaders) {\n    for (const [key, value] of Object.entries(nodeRes.getHeaders())) {\n      if (value === undefined) continue\n      headers[key] = Array.isArray(value) ? value.join(', ') : String(value)\n    }\n  }\n\n  if (event.response?.headers) {\n    event.response.headers.forEach((value, key) => {\n      headers[key] = value\n    })\n  }\n\n  if (Object.keys(headers).length === 0) return undefined\n  return filterSafeHeaders(headers)\n}\n\nfunction getResponseStatus(event: ServerEvent): number {\n  // Node.js style\n  if (event.node?.res?.statusCode) {\n    return event.node.res.statusCode\n  }\n\n  // Web Standard\n  if (event.response?.status) {\n    return event.response.status\n  }\n\n  // Context-based\n  if (typeof event.context.status === 'number') {\n    return event.context.status\n  }\n\n  return 200\n}\n\nfunction buildHookContext(event: ServerEvent): Omit<EnrichContext, 'event'> {\n  const responseHeaders = getSafeResponseHeaders(event)\n  return {\n    request: { method: event.method, path: event.path },\n    headers: getSafeHeaders(event),\n    response: {\n      status: getResponseStatus(event),\n      headers: responseHeaders,\n    },\n  }\n}\n\nasync function callEnrichAndDrain(\n  nitroApp: NitroApp,\n  emittedEvent: WideEvent | null,\n  event: ServerEvent,\n): Promise<void> {\n  if (!emittedEvent) return\n\n  const hookContext = buildHookContext(event)\n\n  try {\n    await nitroApp.hooks.callHook('evlog:enrich', { event: emittedEvent, ...hookContext })\n  } catch (err) {\n    console.error('[evlog] enrich failed:', err)\n  }\n\n  const drainPromise = nitroApp.hooks.callHook('evlog:drain', {\n    event: emittedEvent,\n    request: hookContext.request,\n    headers: hookContext.headers,\n  }).catch((err) => {\n    console.error('[evlog] drain failed:', err)\n  })\n\n  // Use waitUntil if available (Cloudflare Workers, Vercel Edge, etc.)\n  // This keeps the runtime alive for background work without blocking the response\n  const waitUntilCtx = event.context.cloudflare?.context ?? event.context\n  if (typeof waitUntilCtx?.waitUntil === 'function') {\n    waitUntilCtx.waitUntil(drainPromise)\n  } else {\n    // Fallback: await drain to prevent lost logs in serverless environments\n    // (e.g. Vercel Fluid Compute). On the normal path this runs from\n    // afterResponse (response already sent); on the error path it may run\n    // before the error response is finalized.\n    await drainPromise\n  }\n}\n\nexport default defineNitroPlugin(async (nitroApp) => {\n  // Config resolution: process.env bridge first (always set by the module),\n  // then lazy useRuntimeConfig() for production builds where env may not persist.\n  let evlogConfig: EvlogConfig | undefined\n  if (process.env.__EVLOG_CONFIG) {\n    evlogConfig = JSON.parse(process.env.__EVLOG_CONFIG)\n  } else {\n    try {\n      // nitropack/runtime/internal/config imports virtual modules —\n      // only works inside rollup-bundled output (production builds).\n      const { useRuntimeConfig } = await import('nitropack/runtime/internal/config')\n      evlogConfig = (useRuntimeConfig() as Record<string, any>).evlog\n    } catch {\n      // Expected in dev mode — virtual modules unavailable outside rollup\n    }\n  }\n\n  initLogger({\n    enabled: evlogConfig?.enabled,\n    env: evlogConfig?.env,\n    pretty: evlogConfig?.pretty,\n    sampling: evlogConfig?.sampling,\n  })\n\n  if (!isEnabled()) return\n\n  nitroApp.hooks.hook('request', (event) => {\n    const e = event as ServerEvent\n\n    // Skip logging for routes not matching include/exclude patterns\n    if (!shouldLog(e.path, evlogConfig?.include, evlogConfig?.exclude)) {\n      return\n    }\n\n    // Store start time for duration calculation in tail sampling\n    e.context._evlogStartTime = Date.now()\n\n    let requestIdOverride: string | undefined = undefined\n    if (globalThis.navigator?.userAgent === 'Cloudflare-Workers') {\n      const cfRay = getSafeHeaders(e)?.['cf-ray']\n      if (cfRay) requestIdOverride = cfRay\n    }\n\n    const requestLog = createRequestLogger({\n      method: e.method,\n      path: e.path,\n      requestId: requestIdOverride || e.context.requestId || crypto.randomUUID(),\n    })\n\n    // Apply route-based service configuration if a matching route is found\n    const routeService = getServiceForPath(e.path, evlogConfig?.routes)\n    if (routeService) {\n      requestLog.set({ service: routeService })\n    }\n\n    e.context.log = requestLog\n  })\n\n  nitroApp.hooks.hook('error', async (error, { event }) => {\n    const e = event as ServerEvent | undefined\n    if (!e) return\n\n    const requestLog = e.context.log as RequestLogger | undefined\n    if (requestLog) {\n      requestLog.error(error as Error)\n\n      const errorStatus = extractErrorStatus(error)\n      requestLog.set({ status: errorStatus })\n\n      // Build tail sampling context\n      const startTime = e.context._evlogStartTime as number | undefined\n      const durationMs = startTime ? Date.now() - startTime : undefined\n\n      const tailCtx: TailSamplingContext = {\n        status: errorStatus,\n        duration: durationMs,\n        path: e.path,\n        method: e.method,\n        context: requestLog.getContext(),\n        shouldKeep: false,\n      }\n\n      // Call evlog:emit:keep hook\n      await nitroApp.hooks.callHook('evlog:emit:keep', tailCtx)\n\n      e.context._evlogEmitted = true\n\n      const emittedEvent = requestLog.emit({ _forceKeep: tailCtx.shouldKeep })\n      await callEnrichAndDrain(nitroApp, emittedEvent, e)\n    }\n  })\n\n  nitroApp.hooks.hook('afterResponse', async (event) => {\n    const e = event as ServerEvent\n    // Skip if already emitted by error hook\n    if (e.context._evlogEmitted) return\n\n    const requestLog = e.context.log as RequestLogger | undefined\n    if (requestLog) {\n      const status = getResponseStatus(e)\n      requestLog.set({ status })\n\n      const startTime = e.context._evlogStartTime as number | undefined\n      const durationMs = startTime ? Date.now() - startTime : undefined\n\n      const tailCtx: TailSamplingContext = {\n        status,\n        duration: durationMs,\n        path: e.path,\n        method: e.method,\n        context: requestLog.getContext(),\n        shouldKeep: false,\n      }\n\n      await nitroApp.hooks.callHook('evlog:emit:keep', tailCtx)\n\n      const emittedEvent = requestLog.emit({ _forceKeep: tailCtx.shouldKeep })\n      await callEnrichAndDrain(nitroApp, emittedEvent, e)\n    }\n  })\n})\n"],"mappings":"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"}

package/dist/nitro/v3/index.d.mts

@@ -1,4 +1,5 @@
 import "../../nitro-CrFBjY1Y.mjs";
 import evlog from "./module.mjs";
 import { useLogger } from "./useLogger.mjs";
-export { evlog as default, useLogger };
+import { evlogErrorHandler } from "./middleware.mjs";
+export { evlog as default, evlogErrorHandler, useLogger };

package/dist/nitro/v3/index.mjs

@@ -1,4 +1,5 @@
 import evlog from "./module.mjs";
 import { useLogger } from "./useLogger.mjs";
+import { evlogErrorHandler } from "./middleware.mjs";
 
-export { evlog as default, useLogger };
+export { evlog as default, evlogErrorHandler, useLogger };

package/dist/nitro/v3/middleware.d.mts

@@ -0,0 +1,25 @@
+//#region src/nitro-v3/middleware.d.ts
+/**
+ * Server middleware handler that catches EvlogError and returns a structured JSON response.
+ *
+ * Frameworks like TanStack Start catch thrown errors before Nitro's error handler,
+ * stripping the `data` field (containing `why`, `fix`, `link`). This middleware
+ * intercepts EvlogErrors first, attaches them to the wide event, and throws a
+ * `Response` that the framework passes through directly.
+ *
+ * @example TanStack Start
+ * ```ts
+ * import { createMiddleware } from '@tanstack/react-start'
+ * import { evlogErrorHandler } from 'evlog/nitro/v3'
+ *
+ * const evlogMiddleware = createMiddleware().server(evlogErrorHandler)
+ *
+ * export const Route = createRootRoute({
+ *   server: { middleware: [evlogMiddleware] },
+ * })
+ * ```
+ */
+declare function evlogErrorHandler<T>(next: (...args: any[]) => Promise<T>): Promise<T>;
+//#endregion
+export { evlogErrorHandler };
+//# sourceMappingURL=middleware.d.mts.map

package/dist/nitro/v3/middleware.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.d.mts","names":[],"sources":["../../../src/nitro-v3/middleware.ts"],"mappings":";;AAyBA;;;;;;;;;;;;;;;;;;;iBAAsB,iBAAA,GAAA,CAAqB,IAAA,MAAU,IAAA,YAAgB,OAAA,CAAQ,CAAA,IAAK,OAAA,CAAQ,CAAA"}

package/dist/nitro/v3/middleware.mjs

@@ -0,0 +1,45 @@
+import { EvlogError } from "../../error.mjs";
+
+//#region src/nitro-v3/middleware.ts
+/**
+* Server middleware handler that catches EvlogError and returns a structured JSON response.
+*
+* Frameworks like TanStack Start catch thrown errors before Nitro's error handler,
+* stripping the `data` field (containing `why`, `fix`, `link`). This middleware
+* intercepts EvlogErrors first, attaches them to the wide event, and throws a
+* `Response` that the framework passes through directly.
+*
+* @example TanStack Start
+* ```ts
+* import { createMiddleware } from '@tanstack/react-start'
+* import { evlogErrorHandler } from 'evlog/nitro/v3'
+*
+* const evlogMiddleware = createMiddleware().server(evlogErrorHandler)
+*
+* export const Route = createRootRoute({
+*   server: { middleware: [evlogMiddleware] },
+* })
+* ```
+*/
+async function evlogErrorHandler(next) {
+	try {
+		return await next();
+	} catch (error) {
+		if (error instanceof EvlogError || error && typeof error === "object" && error.name === "EvlogError") {
+			const evlogError = error;
+			try {
+				const { useRequest } = await import("nitro/context");
+				(useRequest().context?.log)?.error(evlogError);
+			} catch {}
+			throw new Response(JSON.stringify(evlogError.toJSON()), {
+				status: evlogError.status || 500,
+				headers: { "Content-Type": "application/json" }
+			});
+		}
+		throw error;
+	}
+}
+
+//#endregion
+export { evlogErrorHandler };
+//# sourceMappingURL=middleware.mjs.map

package/dist/nitro/v3/middleware.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.mjs","names":[],"sources":["../../../src/nitro-v3/middleware.ts"],"sourcesContent":["import type { RequestLogger } from '../types'\nimport { EvlogError } from '../error'\nimport { serializeEvlogErrorResponse } from '../nitro'\n\n/**\n * Server middleware handler that catches EvlogError and returns a structured JSON response.\n *\n * Frameworks like TanStack Start catch thrown errors before Nitro's error handler,\n * stripping the `data` field (containing `why`, `fix`, `link`). This middleware\n * intercepts EvlogErrors first, attaches them to the wide event, and throws a\n * `Response` that the framework passes through directly.\n *\n * @example TanStack Start\n * ```ts\n * import { createMiddleware } from '@tanstack/react-start'\n * import { evlogErrorHandler } from 'evlog/nitro/v3'\n *\n * const evlogMiddleware = createMiddleware().server(evlogErrorHandler)\n *\n * export const Route = createRootRoute({\n *   server: { middleware: [evlogMiddleware] },\n * })\n * ```\n */\n\nexport async function evlogErrorHandler<T>(next: (...args: any[]) => Promise<T>): Promise<T> {\n  try {\n    return await next()\n  } catch (error: unknown) {\n    if (error instanceof EvlogError || (error && typeof error === 'object' && (error as Error).name === 'EvlogError')) {\n      const evlogError = error as EvlogError\n\n      try {\n        const { useRequest } = await import('nitro/context')\n        const req = useRequest()\n        const log = req.context?.log as RequestLogger | undefined\n        log?.error(evlogError)\n      } catch {\n        // ignore\n      }\n\n      // Throw as Response so frameworks (TanStack Start, SolidStart, etc.) pass it through\n      throw new Response(JSON.stringify(evlogError.toJSON()), {\n        status: evlogError.status || 500,\n        headers: { 'Content-Type': 'application/json' },\n      })\n    }\n    throw error\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAyBA,eAAsB,kBAAqB,MAAkD;AAC3F,KAAI;AACF,SAAO,MAAM,MAAM;UACZ,OAAgB;AACvB,MAAI,iBAAiB,cAAe,SAAS,OAAO,UAAU,YAAa,MAAgB,SAAS,cAAe;GACjH,MAAM,aAAa;AAEnB,OAAI;IACF,MAAM,EAAE,eAAe,MAAM,OAAO;AAGpC,KAFY,YAAY,CACR,SAAS,MACpB,MAAM,WAAW;WAChB;AAKR,SAAM,IAAI,SAAS,KAAK,UAAU,WAAW,QAAQ,CAAC,EAAE;IACtD,QAAQ,WAAW,UAAU;IAC7B,SAAS,EAAE,gBAAgB,oBAAoB;IAChD,CAAC;;AAEJ,QAAM"}

package/dist/nitro/v3/plugin.mjs

@@ -41,7 +41,7 @@ function buildHookContext(event, res) {
 		}
 	};
 }
-function callDrainHook(hooks, emittedEvent, event, hookContext) {
+async function callDrainHook(hooks, emittedEvent, event, hookContext) {
 	if (!emittedEvent) return;
 	let drainPromise;
 	try {
@@ -49,11 +49,15 @@ function callDrainHook(hooks, emittedEvent, event, hookContext) {
 			event: emittedEvent,
 			request: hookContext.request,
 			headers: hookContext.headers
+		})?.catch?.((err) => {
+			console.error("[evlog] drain failed:", err);
 		});
 	} catch (err) {
 		console.error("[evlog] drain failed:", err);
 	}
-	if (drainPromise && typeof event.req.waitUntil === "function") event.req.waitUntil(drainPromise);
+	if (!drainPromise) return;
+	if (typeof event.req.waitUntil === "function") event.req.waitUntil(drainPromise);
+	else await drainPromise;
 }
 async function callEnrichAndDrain(hooks, emittedEvent, event, res) {
 	if (!emittedEvent) return;
@@ -66,7 +70,7 @@ async function callEnrichAndDrain(hooks, emittedEvent, event, res) {
 	} catch (err) {
 		console.error("[evlog] enrich failed:", err);
 	}
-	callDrainHook(hooks, emittedEvent, event, hookContext);
+	await callDrainHook(hooks, emittedEvent, event, hookContext);
 }
 /**
 * Nitro v3 plugin entry point.

package/dist/nitro/v3/plugin.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.mjs","names":[],"sources":["../../../src/nitro-v3/plugin.ts"],"sourcesContent":["import { definePlugin } from 'nitro'\nimport { useRuntimeConfig } from 'nitro/runtime-config'\nimport type { CaptureError } from 'nitro/types'\nimport type { HTTPEvent } from 'nitro/h3'\nimport { parseURL } from 'ufo'\nimport { createRequestLogger, initLogger, isEnabled } from '../logger'\nimport { shouldLog, getServiceForPath, extractErrorStatus } from '../nitro'\nimport type { EvlogConfig } from '../nitro'\nimport type { EnrichContext, RequestLogger, TailSamplingContext, WideEvent } from '../types'\nimport { filterSafeHeaders } from '../utils'\n\n// Nitro v3 doesn't fully export hook types yet\n// https://github.com/nitrojs/nitro/blob/8882bc9e1dbf2d342e73097f22a2156f70f50575/src/types/runtime/nitro.ts#L48-L53\ninterface NitroV3Hooks {\n  close: () => void\n  error: CaptureError\n  request: (event: HTTPEvent) => void | Promise<void>\n  response: (res: Response, event: HTTPEvent) => void | Promise<void>\n  'evlog:emit:keep': (ctx: TailSamplingContext) => void | Promise<void>\n  'evlog:enrich': (ctx: EnrichContext) => void | Promise<void>\n  'evlog:drain': (ctx: { event: WideEvent; request?: { method?: string; path: string; requestId?: string }; headers?: Record<string, string> }) => void | Promise<void>\n}\n\ntype Hooks = {\n  hook: <T extends keyof NitroV3Hooks>(name: T, listener: NitroV3Hooks[T]) => void\n  callHook: <T extends keyof NitroV3Hooks>(name: T, ...args: Parameters<NitroV3Hooks[T]>) => Promise<void>\n}\n\nfunction getContext(event: HTTPEvent): Record<string, unknown> {\n  if (!event.req.context) {\n    event.req.context = {}\n  }\n  return event.req.context\n}\n\nfunction getSafeRequestHeaders(event: HTTPEvent): Record<string, string> {\n  const headers: Record<string, string> = {}\n  event.req.headers.forEach((value, key) => {\n    headers[key] = value\n  })\n  return filterSafeHeaders(headers)\n}\n\nfunction getSafeResponseHeaders(res: Response): Record<string, string> | undefined {\n  const headers: Record<string, string> = {}\n  res.headers.forEach((value, key) => {\n    headers[key] = value\n  })\n  if (Object.keys(headers).length === 0) return undefined\n  return filterSafeHeaders(headers)\n}\n\nfunction buildHookContext(\n  event: HTTPEvent,\n  res?: Response,\n): Omit<EnrichContext, 'event'> {\n  const { pathname } = parseURL(event.req.url)\n  const responseHeaders = res ? getSafeResponseHeaders(res) : undefined\n  return {\n    request: { method: event.req.method, path: pathname },\n    headers: getSafeRequestHeaders(event),\n    response: {\n      status: res?.status ?? 200,\n      headers: responseHeaders,\n    },\n  }\n}\n\nfunction callDrainHook(\n  hooks: Hooks,\n  emittedEvent: WideEvent | null,\n  event: HTTPEvent,\n  hookContext: Omit<EnrichContext, 'event'>,\n): void {\n  if (!emittedEvent) return\n  let drainPromise: Promise<any> | undefined\n  try {\n    drainPromise = hooks.callHook('evlog:drain', {\n      event: emittedEvent,\n      request: hookContext.request,\n      headers: hookContext.headers,\n    })\n  } catch (err) {\n    console.error('[evlog] drain failed:', err)\n  }\n\n  // Use waitUntil if available (srvx native — Cloudflare Workers, Vercel Edge, etc.)\n  // This ensures drains complete before the runtime terminates\n  if (drainPromise && typeof event.req.waitUntil === 'function') {\n    event.req.waitUntil(drainPromise)\n  }\n}\n\nasync function callEnrichAndDrain(\n  hooks: Hooks,\n  emittedEvent: WideEvent | null,\n  event: HTTPEvent,\n  res?: Response,\n): Promise<void> {\n  if (!emittedEvent) return\n\n  const hookContext = buildHookContext(event, res)\n\n  try {\n    await hooks.callHook('evlog:enrich', { event: emittedEvent, ...hookContext })\n  } catch (err) {\n    console.error('[evlog] enrich failed:', err)\n  }\n\n  callDrainHook(hooks, emittedEvent, event, hookContext)\n}\n\n/**\n * Nitro v3 plugin entry point.\n *\n * Usage in Nitro v3:\n * ```ts\n * // plugins/evlog.ts\n * export { default } from 'evlog/nitro/v3'\n * ```\n */\nexport default definePlugin((nitroApp) => {\n  // In production builds the plugin is bundled and useRuntimeConfig()\n  // resolves the virtual module correctly. In dev mode the plugin is\n  // loaded externally so useRuntimeConfig() returns a stub — fall back\n  // to the env var bridge set by the module.\n  const evlogConfig = (useRuntimeConfig().evlog ?? (process.env.__EVLOG_CONFIG ? JSON.parse(process.env.__EVLOG_CONFIG) : undefined)) as EvlogConfig | undefined\n\n  initLogger({\n    enabled: evlogConfig?.enabled,\n    env: evlogConfig?.env,\n    pretty: evlogConfig?.pretty,\n    sampling: evlogConfig?.sampling,\n  })\n\n  if (!isEnabled()) return\n\n  const hooks = nitroApp.hooks as unknown as Hooks\n\n  hooks.hook('request', (event) => {\n    const { pathname } = parseURL(event.req.url)\n\n    // Skip logging for routes not matching include/exclude patterns\n    if (!shouldLog(pathname, evlogConfig?.include, evlogConfig?.exclude)) {\n      return\n    }\n\n    const ctx = getContext(event)\n\n    // Store start time for duration calculation in tail sampling\n    ctx._evlogStartTime = Date.now()\n\n    let requestIdOverride: string | undefined = undefined\n    if (globalThis.navigator?.userAgent === 'Cloudflare-Workers') {\n      const cfRay = event.req.headers.get('cf-ray')\n      if (cfRay) requestIdOverride = cfRay\n    }\n\n    const log = createRequestLogger({\n      method: event.req.method,\n      path: pathname,\n      requestId: requestIdOverride || ctx.requestId as string | undefined || crypto.randomUUID(),\n    })\n\n    // Apply route-based service configuration if a matching route is found\n    const routeService = getServiceForPath(pathname, evlogConfig?.routes)\n    if (routeService) {\n      log.set({ service: routeService })\n    }\n\n    ctx.log = log\n  })\n\n  hooks.hook('response', async (res, event) => {\n    const ctx = event.req.context\n    // Skip if already emitted by error hook\n    if (ctx?._evlogEmitted) return\n\n    const log = ctx?.log as RequestLogger | undefined\n    if (!log || !ctx) return\n\n    const { status } = res\n    log.set({ status })\n\n    const startTime = ctx._evlogStartTime as number | undefined\n    const durationMs = startTime ? Date.now() - startTime : undefined\n\n    const { pathname } = parseURL(event.req.url)\n\n    const tailCtx: TailSamplingContext = {\n      status,\n      duration: durationMs,\n      path: pathname,\n      method: event.req.method,\n      context: log.getContext(),\n      shouldKeep: false,\n    }\n\n    await hooks.callHook('evlog:emit:keep', tailCtx)\n\n    const emittedEvent = log.emit({ _forceKeep: tailCtx.shouldKeep })\n    await callEnrichAndDrain(hooks, emittedEvent, event, res)\n  })\n\n  hooks.hook('error', async (error, { event }) => {\n    if (!event) return\n    const e = event as HTTPEvent\n\n    const ctx = e.req.context\n    const log = ctx?.log as RequestLogger | undefined\n    if (!log || !ctx) return\n\n    // Check if error.cause is an EvlogError (thrown errors get wrapped in HTTPError by nitro)\n    const actualError = (error.cause as Error)?.name === 'EvlogError' \n      ? error.cause as Error \n      : error as Error\n\n    log.error(actualError)\n\n    const errorStatus = extractErrorStatus(actualError)\n    log.set({ status: errorStatus })\n\n    const { pathname } = parseURL(e.req.url)\n    const startTime = ctx._evlogStartTime as number | undefined\n    const durationMs = startTime ? Date.now() - startTime : undefined\n\n    const tailCtx: TailSamplingContext = {\n      status: errorStatus,\n      duration: durationMs,\n      path: pathname,\n      method: e.req.method,\n      context: log.getContext(),\n      shouldKeep: false,\n    }\n\n    await hooks.callHook('evlog:emit:keep', tailCtx)\n\n    ctx._evlogEmitted = true\n\n    const emittedEvent = log.emit({ _forceKeep: tailCtx.shouldKeep })\n    await callEnrichAndDrain(hooks, emittedEvent, e)\n  })\n})\n"],"mappings":"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"}
+{"version":3,"file":"plugin.mjs","names":[],"sources":["../../../src/nitro-v3/plugin.ts"],"sourcesContent":["import { definePlugin } from 'nitro'\nimport { useRuntimeConfig } from 'nitro/runtime-config'\nimport type { CaptureError } from 'nitro/types'\nimport type { HTTPEvent } from 'nitro/h3'\nimport { parseURL } from 'ufo'\nimport { createRequestLogger, initLogger, isEnabled } from '../logger'\nimport { shouldLog, getServiceForPath, extractErrorStatus } from '../nitro'\nimport type { EvlogConfig } from '../nitro'\nimport type { EnrichContext, RequestLogger, TailSamplingContext, WideEvent } from '../types'\nimport { filterSafeHeaders } from '../utils'\n\n// Nitro v3 doesn't fully export hook types yet\n// https://github.com/nitrojs/nitro/blob/8882bc9e1dbf2d342e73097f22a2156f70f50575/src/types/runtime/nitro.ts#L48-L53\ninterface NitroV3Hooks {\n  close: () => void\n  error: CaptureError\n  request: (event: HTTPEvent) => void | Promise<void>\n  response: (res: Response, event: HTTPEvent) => void | Promise<void>\n  'evlog:emit:keep': (ctx: TailSamplingContext) => void | Promise<void>\n  'evlog:enrich': (ctx: EnrichContext) => void | Promise<void>\n  'evlog:drain': (ctx: { event: WideEvent; request?: { method?: string; path: string; requestId?: string }; headers?: Record<string, string> }) => void | Promise<void>\n}\n\ntype Hooks = {\n  hook: <T extends keyof NitroV3Hooks>(name: T, listener: NitroV3Hooks[T]) => void\n  callHook: <T extends keyof NitroV3Hooks>(name: T, ...args: Parameters<NitroV3Hooks[T]>) => Promise<void>\n}\n\nfunction getContext(event: HTTPEvent): Record<string, unknown> {\n  if (!event.req.context) {\n    event.req.context = {}\n  }\n  return event.req.context\n}\n\nfunction getSafeRequestHeaders(event: HTTPEvent): Record<string, string> {\n  const headers: Record<string, string> = {}\n  event.req.headers.forEach((value, key) => {\n    headers[key] = value\n  })\n  return filterSafeHeaders(headers)\n}\n\nfunction getSafeResponseHeaders(res: Response): Record<string, string> | undefined {\n  const headers: Record<string, string> = {}\n  res.headers.forEach((value, key) => {\n    headers[key] = value\n  })\n  if (Object.keys(headers).length === 0) return undefined\n  return filterSafeHeaders(headers)\n}\n\nfunction buildHookContext(\n  event: HTTPEvent,\n  res?: Response,\n): Omit<EnrichContext, 'event'> {\n  const { pathname } = parseURL(event.req.url)\n  const responseHeaders = res ? getSafeResponseHeaders(res) : undefined\n  return {\n    request: { method: event.req.method, path: pathname },\n    headers: getSafeRequestHeaders(event),\n    response: {\n      status: res?.status ?? 200,\n      headers: responseHeaders,\n    },\n  }\n}\n\nasync function callDrainHook(\n  hooks: Hooks,\n  emittedEvent: WideEvent | null,\n  event: HTTPEvent,\n  hookContext: Omit<EnrichContext, 'event'>,\n): Promise<void> {\n  if (!emittedEvent) return\n\n  let drainPromise: Promise<unknown> | undefined\n  try {\n    const result = hooks.callHook('evlog:drain', {\n      event: emittedEvent,\n      request: hookContext.request,\n      headers: hookContext.headers,\n    })\n    drainPromise = result?.catch?.((err: unknown) => {\n      console.error('[evlog] drain failed:', err)\n    })\n  } catch (err) {\n    console.error('[evlog] drain failed:', err)\n  }\n\n  if (!drainPromise) return\n\n  // Use waitUntil if available (srvx native — Cloudflare Workers, Vercel Edge, etc.)\n  // This keeps the runtime alive for background work without blocking the response\n  if (typeof event.req.waitUntil === 'function') {\n    event.req.waitUntil(drainPromise)\n  } else {\n    // Fallback: await drain to prevent lost logs in serverless environments\n    // (e.g. Vercel Fluid Compute). On the normal path this runs from the\n    // response hook (response already sent); on the error path it may run\n    // before the error response is finalized.\n    await drainPromise\n  }\n}\n\nasync function callEnrichAndDrain(\n  hooks: Hooks,\n  emittedEvent: WideEvent | null,\n  event: HTTPEvent,\n  res?: Response,\n): Promise<void> {\n  if (!emittedEvent) return\n\n  const hookContext = buildHookContext(event, res)\n\n  try {\n    await hooks.callHook('evlog:enrich', { event: emittedEvent, ...hookContext })\n  } catch (err) {\n    console.error('[evlog] enrich failed:', err)\n  }\n\n  await callDrainHook(hooks, emittedEvent, event, hookContext)\n}\n\n/**\n * Nitro v3 plugin entry point.\n *\n * Usage in Nitro v3:\n * ```ts\n * // plugins/evlog.ts\n * export { default } from 'evlog/nitro/v3'\n * ```\n */\nexport default definePlugin((nitroApp) => {\n  // In production builds the plugin is bundled and useRuntimeConfig()\n  // resolves the virtual module correctly. In dev mode the plugin is\n  // loaded externally so useRuntimeConfig() returns a stub — fall back\n  // to the env var bridge set by the module.\n  const evlogConfig = (useRuntimeConfig().evlog ?? (process.env.__EVLOG_CONFIG ? JSON.parse(process.env.__EVLOG_CONFIG) : undefined)) as EvlogConfig | undefined\n\n  initLogger({\n    enabled: evlogConfig?.enabled,\n    env: evlogConfig?.env,\n    pretty: evlogConfig?.pretty,\n    sampling: evlogConfig?.sampling,\n  })\n\n  if (!isEnabled()) return\n\n  const hooks = nitroApp.hooks as unknown as Hooks\n\n  hooks.hook('request', (event) => {\n    const { pathname } = parseURL(event.req.url)\n\n    // Skip logging for routes not matching include/exclude patterns\n    if (!shouldLog(pathname, evlogConfig?.include, evlogConfig?.exclude)) {\n      return\n    }\n\n    const ctx = getContext(event)\n\n    // Store start time for duration calculation in tail sampling\n    ctx._evlogStartTime = Date.now()\n\n    let requestIdOverride: string | undefined = undefined\n    if (globalThis.navigator?.userAgent === 'Cloudflare-Workers') {\n      const cfRay = event.req.headers.get('cf-ray')\n      if (cfRay) requestIdOverride = cfRay\n    }\n\n    const log = createRequestLogger({\n      method: event.req.method,\n      path: pathname,\n      requestId: requestIdOverride || ctx.requestId as string | undefined || crypto.randomUUID(),\n    })\n\n    // Apply route-based service configuration if a matching route is found\n    const routeService = getServiceForPath(pathname, evlogConfig?.routes)\n    if (routeService) {\n      log.set({ service: routeService })\n    }\n\n    ctx.log = log\n  })\n\n  hooks.hook('response', async (res, event) => {\n    const ctx = event.req.context\n    // Skip if already emitted by error hook\n    if (ctx?._evlogEmitted) return\n\n    const log = ctx?.log as RequestLogger | undefined\n    if (!log || !ctx) return\n\n    const { status } = res\n    log.set({ status })\n\n    const startTime = ctx._evlogStartTime as number | undefined\n    const durationMs = startTime ? Date.now() - startTime : undefined\n\n    const { pathname } = parseURL(event.req.url)\n\n    const tailCtx: TailSamplingContext = {\n      status,\n      duration: durationMs,\n      path: pathname,\n      method: event.req.method,\n      context: log.getContext(),\n      shouldKeep: false,\n    }\n\n    await hooks.callHook('evlog:emit:keep', tailCtx)\n\n    const emittedEvent = log.emit({ _forceKeep: tailCtx.shouldKeep })\n    await callEnrichAndDrain(hooks, emittedEvent, event, res)\n  })\n\n  hooks.hook('error', async (error, { event }) => {\n    if (!event) return\n    const e = event as HTTPEvent\n\n    const ctx = e.req.context\n    const log = ctx?.log as RequestLogger | undefined\n    if (!log || !ctx) return\n\n    // Check if error.cause is an EvlogError (thrown errors get wrapped in HTTPError by nitro)\n    const actualError = (error.cause as Error)?.name === 'EvlogError' \n      ? error.cause as Error \n      : error as Error\n\n    log.error(actualError)\n\n    const errorStatus = extractErrorStatus(actualError)\n    log.set({ status: errorStatus })\n\n    const { pathname } = parseURL(e.req.url)\n    const startTime = ctx._evlogStartTime as number | undefined\n    const durationMs = startTime ? Date.now() - startTime : undefined\n\n    const tailCtx: TailSamplingContext = {\n      status: errorStatus,\n      duration: durationMs,\n      path: pathname,\n      method: e.req.method,\n      context: log.getContext(),\n      shouldKeep: false,\n    }\n\n    await hooks.callHook('evlog:emit:keep', tailCtx)\n\n    ctx._evlogEmitted = true\n\n    const emittedEvent = log.emit({ _forceKeep: tailCtx.shouldKeep })\n    await callEnrichAndDrain(hooks, emittedEvent, e)\n  })\n})\n"],"mappings":"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"}

package/dist/nuxt/module.mjs

@@ -2,7 +2,7 @@ import { addImports, addPlugin, addServerHandler, addServerImports, addServerPlu
 
 //#region package.json
 var name = "evlog";
-var version = "1.10.0";
+var version = "1.11.0";
 
 //#endregion
 //#region src/nuxt/module.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "evlog",
-  "version": "1.10.0",
+  "version": "1.11.0",
   "description": "Wide event logging library with structured error handling. Inspired by LoggingSucks.",
   "author": "HugoRCD <contact@hrcd.fr>",
   "homepage": "https://evlog.dev",
@@ -19,6 +19,7 @@
     "nuxt",
     "nitro",
     "nextjs",
+    "tanstack-start",
     "typescript"
   ],
   "license": "MIT",