evlog 2.19.0 → 2.19.2

package/dist/next/instrumentation/create.mjs

@@ -0,0 +1,157 @@
+import { t as registerDiskPrettyErrorSnippetReader } from "../../register-disk-snippet-B_JyhodL.mjs";
+//#region src/next/instrumentation-create.ts
+/** Default patterns skipped by {@link CaptureOutputOptions.ignore}. */
+const DEFAULT_CAPTURE_OUTPUT_IGNORE = [
+	"node-module-in-edge-runtime",
+	"Edge Instrumentation",
+	"https://nextjs.org/docs/messages/node-module-in-edge-runtime",
+	"https://nextjs.org/docs/api-reference/edge-runtime",
+	"Ecmascript file had an error",
+	"A Node.js module is loaded",
+	"A Node.js API is used",
+	"not supported in the Edge Runtime",
+	"not supported inthe Edge Runtime",
+	"Import trace:"
+];
+let patching = false;
+let loggerPromise;
+let stdoutPatched = false;
+let stderrPatched = false;
+let activeCaptureOutput;
+function loadLogger() {
+	loggerPromise ??= import("../../logger.mjs");
+	return loggerPromise;
+}
+function resolveCaptureOutputOptions(captureOutput) {
+	if (!captureOutput) return void 0;
+	if (captureOutput === true) return {
+		stdout: true,
+		stderr: true,
+		ignore: DEFAULT_CAPTURE_OUTPUT_IGNORE
+	};
+	return {
+		stdout: captureOutput.stdout ?? true,
+		stderr: captureOutput.stderr ?? true,
+		ignore: captureOutput.ignore ?? DEFAULT_CAPTURE_OUTPUT_IGNORE
+	};
+}
+function shouldIgnoreCapturedOutput(message, ignore) {
+	return ignore.some((pattern) => {
+		if (typeof pattern === "string") return message.includes(pattern);
+		return pattern.test(message);
+	});
+}
+function applyCaptureOutput(config, logApi, silent) {
+	activeCaptureOutput = {
+		log: logApi,
+		ignore: config.ignore ?? DEFAULT_CAPTURE_OUTPUT_IGNORE,
+		stdout: config.stdout !== false,
+		stderr: config.stderr !== false,
+		silent
+	};
+	const proc = globalThis.process;
+	if (activeCaptureOutput.stdout && !stdoutPatched) {
+		const originalStdoutWrite = proc.stdout.write.bind(proc.stdout);
+		globalThis.__evlogNativeStdoutWrite = originalStdoutWrite;
+		stdoutPatched = true;
+		proc.stdout.write = function(chunk, ...args) {
+			const message = String(chunk).trimEnd();
+			const active = activeCaptureOutput;
+			if (!patching && message.length > 0 && active?.stdout && !shouldIgnoreCapturedOutput(message, active.ignore)) {
+				patching = true;
+				try {
+					active.log.info({
+						source: "stdout",
+						message
+					});
+				} finally {
+					patching = false;
+				}
+				if (!active.silent) return true;
+			}
+			return originalStdoutWrite(chunk, ...args);
+		};
+	}
+	if (activeCaptureOutput.stderr && !stderrPatched) {
+		const originalStderrWrite = proc.stderr.write.bind(proc.stderr);
+		stderrPatched = true;
+		proc.stderr.write = function(chunk, ...args) {
+			const message = String(chunk).trimEnd();
+			const active = activeCaptureOutput;
+			if (!patching && message.length > 0 && active?.stderr && !shouldIgnoreCapturedOutput(message, active.ignore)) {
+				patching = true;
+				try {
+					active.log.error({
+						source: "stderr",
+						message
+					});
+				} finally {
+					patching = false;
+				}
+				if (!active.silent) return true;
+			}
+			return originalStderrWrite(chunk, ...args);
+		};
+	}
+}
+/**
+* Create Next.js instrumentation hooks (`register`, `onRequestError`).
+*
+* Load via dynamic `import()` from root `instrumentation.ts` (Node.js runtime only).
+* Load via dynamic `import()` from root `instrumentation.ts` with {@link defineNodeInstrumentation}.
+*/
+function createInstrumentation(options = {}) {
+	let registered = false;
+	let registerPromise;
+	const captureOutputOptions = resolveCaptureOutputOptions(options.captureOutput);
+	function register() {
+		if (registered) return;
+		if (registerPromise) return registerPromise;
+		registerPromise = loadLogger().then(async ({ initLogger, lockLogger, log }) => {
+			initLogger({
+				enabled: options.enabled,
+				env: {
+					service: options.service,
+					...options.env
+				},
+				pretty: options.pretty,
+				silent: options.silent,
+				sampling: options.sampling,
+				minLevel: options.minLevel,
+				stringify: options.stringify,
+				drain: options.drain
+			});
+			lockLogger();
+			if (process.env.NEXT_RUNTIME === "nodejs") await registerDiskPrettyErrorSnippetReader();
+			if (captureOutputOptions && process.env.NEXT_RUNTIME === "nodejs") applyCaptureOutput(captureOutputOptions, log, options.silent ?? false);
+			registered = true;
+		}).catch((error) => {
+			registerPromise = void 0;
+			throw error;
+		});
+		return registerPromise;
+	}
+	function onRequestError(error, request, context) {
+		return loadLogger().then(({ log }) => {
+			log.error({
+				message: error.message,
+				digest: error.digest,
+				stack: error.stack,
+				path: request.path,
+				method: request.method,
+				routerKind: context.routerKind,
+				routePath: context.routePath,
+				routeType: context.routeType,
+				renderSource: context.renderSource
+			});
+		});
+	}
+	return {
+		register,
+		onRequestError
+	};
+}
+//#endregion
+export { DEFAULT_CAPTURE_OUTPUT_IGNORE, createInstrumentation };
+
+//# sourceMappingURL=create.mjs.map

package/dist/next/instrumentation/create.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.mjs","names":[],"sources":["../../../src/next/instrumentation-create.ts"],"sourcesContent":["import { registerDiskPrettyErrorSnippetReader } from '../shared/register-disk-snippet'\nimport type { DrainContext, EnvironmentContext, LogLevel, Log, SamplingConfig } from '../types'\nimport type {\n  NextInstrumentationErrorContext,\n  NextInstrumentationRequest,\n} from './instrumentation-gate'\n\ntype LoggerModule = typeof import('../logger')\ntype EvlogProcessOutputGlobal = import('../logger').EvlogProcessOutputGlobal\n\n/** Options for capturing process stdout/stderr as structured log events. */\nexport interface CaptureOutputOptions {\n  /** Capture stdout writes. @default true */\n  stdout?: boolean\n  /** Capture stderr writes. @default true */\n  stderr?: boolean\n  /**\n   * Skip re-emitting chunks that match these patterns as log events.\n   * When omitted, known Next.js Edge bundler warnings are ignored by default.\n   */\n  ignore?: Array<string | RegExp>\n}\n\n/** Default patterns skipped by {@link CaptureOutputOptions.ignore}. */\nexport const DEFAULT_CAPTURE_OUTPUT_IGNORE: Array<string | RegExp> = [\n  'node-module-in-edge-runtime',\n  'Edge Instrumentation',\n  'https://nextjs.org/docs/messages/node-module-in-edge-runtime',\n  'https://nextjs.org/docs/api-reference/edge-runtime',\n  'Ecmascript file had an error',\n  'A Node.js module is loaded',\n  'A Node.js API is used',\n  'not supported in the Edge Runtime',\n  'not supported inthe Edge Runtime',\n  'Import trace:',\n]\n\n/**\n * Configuration for {@link createInstrumentation} and {@link defineNodeInstrumentation}.\n * Controls global logger options and optional stdout/stderr capture (Node.js only).\n */\nexport interface InstrumentationOptions {\n  /** Enable or disable all logging globally. @default true */\n  enabled?: boolean\n  /** Service name for all logged events. */\n  service?: string\n  /** Environment context overrides. */\n  env?: Partial<EnvironmentContext>\n  /** Enable pretty printing. @default true in development */\n  pretty?: boolean\n  /** Suppress built-in console output. @default false */\n  silent?: boolean\n  /** Sampling configuration for filtering logs. */\n  sampling?: SamplingConfig\n  /** Minimum severity for the global `log` API. @default 'debug' */\n  minLevel?: LogLevel\n  /** When pretty is disabled, emit JSON strings or raw objects. @default true */\n  stringify?: boolean\n  /** Drain callback called with every emitted event. */\n  drain?: (ctx: DrainContext) => void | Promise<void>\n  /** Capture stdout/stderr as structured log events (Node.js only). */\n  captureOutput?: boolean | CaptureOutputOptions\n}\n\ninterface InstrumentationResult {\n  register: () => void | Promise<void>\n  onRequestError: (\n    error: { digest?: string } & Error,\n    request: NextInstrumentationRequest,\n    context: NextInstrumentationErrorContext,\n  ) => void | Promise<void>\n}\n\nlet patching = false\nlet loggerPromise: Promise<LoggerModule> | undefined\nlet stdoutPatched = false\nlet stderrPatched = false\nlet activeCaptureOutput:\n  | {\n      log: Log\n      ignore: Array<string | RegExp>\n      stdout: boolean\n      stderr: boolean\n      silent: boolean\n    }\n  | undefined\n\nfunction loadLogger(): Promise<LoggerModule> {\n  loggerPromise ??= import('../logger')\n  return loggerPromise\n}\n\nfunction resolveCaptureOutputOptions(\n  captureOutput: InstrumentationOptions['captureOutput'],\n): CaptureOutputOptions | undefined {\n  if (!captureOutput) return undefined\n  if (captureOutput === true) {\n    return { stdout: true, stderr: true, ignore: DEFAULT_CAPTURE_OUTPUT_IGNORE }\n  }\n  return {\n    stdout: captureOutput.stdout ?? true,\n    stderr: captureOutput.stderr ?? true,\n    ignore: captureOutput.ignore ?? DEFAULT_CAPTURE_OUTPUT_IGNORE,\n  }\n}\n\nfunction shouldIgnoreCapturedOutput(message: string, ignore: Array<string | RegExp>): boolean {\n  return ignore.some((pattern) => {\n    if (typeof pattern === 'string') return message.includes(pattern)\n    return pattern.test(message)\n  })\n}\n\nfunction applyCaptureOutput(config: CaptureOutputOptions, logApi: Log, silent: boolean): void {\n  activeCaptureOutput = {\n    log: logApi,\n    ignore: config.ignore ?? DEFAULT_CAPTURE_OUTPUT_IGNORE,\n    stdout: config.stdout !== false,\n    stderr: config.stderr !== false,\n    silent,\n  }\n\n  const proc = globalThis.process\n\n  if (activeCaptureOutput.stdout && !stdoutPatched) {\n    const originalStdoutWrite = proc.stdout.write.bind(proc.stdout)\n    ;(globalThis as EvlogProcessOutputGlobal).__evlogNativeStdoutWrite = originalStdoutWrite\n    stdoutPatched = true\n    proc.stdout.write = function(chunk: unknown, ...args: unknown[]): boolean {\n      const message = String(chunk).trimEnd()\n      const active = activeCaptureOutput\n      if (\n        !patching\n        && message.length > 0\n        && active?.stdout\n        && !shouldIgnoreCapturedOutput(message, active.ignore)\n      ) {\n        patching = true\n        try {\n          active.log.info({ source: 'stdout', message })\n        } finally {\n          patching = false\n        }\n        if (!active.silent) {\n          return true\n        }\n      }\n      return originalStdoutWrite(chunk as string, ...args as [])\n    } as typeof process.stdout.write\n  }\n\n  if (activeCaptureOutput.stderr && !stderrPatched) {\n    const originalStderrWrite = proc.stderr.write.bind(proc.stderr)\n    stderrPatched = true\n    proc.stderr.write = function(chunk: unknown, ...args: unknown[]): boolean {\n      const message = String(chunk).trimEnd()\n      const active = activeCaptureOutput\n      if (\n        !patching\n        && message.length > 0\n        && active?.stderr\n        && !shouldIgnoreCapturedOutput(message, active.ignore)\n      ) {\n        patching = true\n        try {\n          active.log.error({ source: 'stderr', message })\n        } finally {\n          patching = false\n        }\n        if (!active.silent) {\n          return true\n        }\n      }\n      return originalStderrWrite(chunk as string, ...args as [])\n    } as typeof process.stderr.write\n  }\n}\n\n/**\n * Create Next.js instrumentation hooks (`register`, `onRequestError`).\n *\n * Load via dynamic `import()` from root `instrumentation.ts` (Node.js runtime only).\n * Load via dynamic `import()` from root `instrumentation.ts` with {@link defineNodeInstrumentation}.\n */\nexport function createInstrumentation(options: InstrumentationOptions = {}): InstrumentationResult {\n  let registered = false\n  let registerPromise: Promise<void> | undefined\n  const captureOutputOptions = resolveCaptureOutputOptions(options.captureOutput)\n\n  function register(): void | Promise<void> {\n    if (registered) return\n    if (registerPromise) return registerPromise\n\n    registerPromise = loadLogger().then(async ({ initLogger, lockLogger, log }) => {\n      initLogger({\n        enabled: options.enabled,\n        env: {\n          service: options.service,\n          ...options.env,\n        },\n        pretty: options.pretty,\n        silent: options.silent,\n        sampling: options.sampling,\n        minLevel: options.minLevel,\n        stringify: options.stringify,\n        drain: options.drain,\n      })\n      lockLogger()\n      if (process.env.NEXT_RUNTIME === 'nodejs') {\n        await registerDiskPrettyErrorSnippetReader()\n      }\n\n      if (captureOutputOptions && process.env.NEXT_RUNTIME === 'nodejs') {\n        applyCaptureOutput(captureOutputOptions, log, options.silent ?? false)\n      }\n      registered = true\n    }).catch((error) => {\n      registerPromise = undefined\n      throw error\n    })\n    return registerPromise\n  }\n\n  function onRequestError(\n    error: { digest?: string } & Error,\n    request: { path: string; method: string; headers: Record<string, string> },\n    context: { routerKind: string; routePath: string; routeType: string; renderSource: string },\n  ): void | Promise<void> {\n    return loadLogger().then(({ log }) => {\n      log.error({\n        message: error.message,\n        digest: error.digest,\n        stack: error.stack,\n        path: request.path,\n        method: request.method,\n        routerKind: context.routerKind,\n        routePath: context.routePath,\n        routeType: context.routeType,\n        renderSource: context.renderSource,\n      })\n    })\n  }\n\n  return { register, onRequestError }\n}\n"],"mappings":"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"}

package/dist/next/instrumentation.d.mts

@@ -1,77 +1,2 @@
-import { B as DrainContext, H as EnvironmentContext, X as LogLevel, ot as SamplingConfig } from "../audit-BUAajsPU.mjs";
-
-//#region src/next/instrumentation.d.ts
-/** Request payload passed to Next.js `onRequestError` (App Router). */
-interface NextInstrumentationRequest {
-  path: string;
-  method: string;
-  headers: Record<string, string>;
-}
-/** Routing context passed to Next.js `onRequestError`. */
-interface NextInstrumentationErrorContext {
-  routerKind: string;
-  routePath: string;
-  routeType: string;
-  renderSource: string;
-}
-/**
- * What `lib/evlog.ts` should export for use with {@link defineNodeInstrumentation}
- * (typically the return values of `createInstrumentation()`).
- */
-interface NodeInstrumentationModule {
-  register: () => void | Promise<void>;
-  onRequestError: (error: {
-    digest?: string;
-  } & Error, request: NextInstrumentationRequest, context: NextInstrumentationErrorContext) => void | Promise<void>;
-}
-/**
- * Root `instrumentation.ts` entry: load your real config only in the Node.js runtime so Edge
- * bundles never pull Node-only drains/adapters. Caches the dynamic `import()` so `register` and
- * repeated `onRequestError` calls share one module instance (avoids re-importing on every error).
- *
- * @example
- * ```ts
- * // instrumentation.ts
- * import { defineNodeInstrumentation } from 'evlog/next/instrumentation'
- *
- * export const { register, onRequestError } = defineNodeInstrumentation(() => import('./lib/evlog'))
- * ```
- */
-declare function defineNodeInstrumentation(loader: () => Promise<NodeInstrumentationModule>): {
-  register(): Promise<void>;
-  onRequestError(error: {
-    digest?: string;
-  } & Error, request: NextInstrumentationRequest, context: NextInstrumentationErrorContext): Promise<void>;
-};
-interface InstrumentationOptions {
-  /** Enable or disable all logging globally. @default true */
-  enabled?: boolean;
-  /** Service name for all logged events. */
-  service?: string;
-  /** Environment context overrides. */
-  env?: Partial<EnvironmentContext>;
-  /** Enable pretty printing. @default true in development */
-  pretty?: boolean;
-  /** Suppress built-in console output. @default false */
-  silent?: boolean;
-  /** Sampling configuration for filtering logs. */
-  sampling?: SamplingConfig;
-  /** Minimum severity for the global `log` API. @default 'debug' */
-  minLevel?: LogLevel;
-  /** When pretty is disabled, emit JSON strings or raw objects. @default true */
-  stringify?: boolean;
-  /** Drain callback called with every emitted event. */
-  drain?: (ctx: DrainContext) => void | Promise<void>;
-  /** Capture stdout/stderr output as log events (Node.js only). */
-  captureOutput?: boolean;
-}
-interface InstrumentationResult {
-  register: () => void;
-  onRequestError: (error: {
-    digest?: string;
-  } & Error, request: NextInstrumentationRequest, context: NextInstrumentationErrorContext) => void;
-}
-declare function createInstrumentation(options?: InstrumentationOptions): InstrumentationResult;
-//#endregion
-export { InstrumentationOptions, NextInstrumentationErrorContext, NextInstrumentationRequest, NodeInstrumentationModule, createInstrumentation, defineNodeInstrumentation };
-//# sourceMappingURL=instrumentation.d.mts.map
+import { a as DefineNodeInstrumentationInput, c as NodeInstrumentationHooks, l as NodeInstrumentationModule, o as NextInstrumentationErrorContext, r as InstrumentationOptions, s as NextInstrumentationRequest, t as CaptureOutputOptions, u as defineNodeInstrumentation } from "../instrumentation-create-STGmQGQt.mjs";
+export { type CaptureOutputOptions, type DefineNodeInstrumentationInput, type InstrumentationOptions, type NextInstrumentationErrorContext, type NextInstrumentationRequest, type NodeInstrumentationHooks, type NodeInstrumentationModule, defineNodeInstrumentation };

package/dist/next/instrumentation.mjs

@@ -1,19 +1,43 @@
-import { C as lockLogger, b as initLogger, m as _log } from "../audit-BFwTUxBJ.mjs";
-//#region src/next/instrumentation.ts
+//#region src/next/instrumentation-gate.ts
+/** @internal Non-literal specifier so Turbopack does not pull the logger into the Edge bundle. */
+const CREATE_ENTRY = [
+	"evlog",
+	"next",
+	"instrumentation",
+	"create"
+].join("/");
+function importCreateModule() {
+	return import(
+		/* webpackIgnore: true */
+		CREATE_ENTRY
+);
+}
+function isLoader(value) {
+	return typeof value === "function";
+}
+function createOptionsLoader(options) {
+	return async () => {
+		const { createInstrumentation } = await importCreateModule();
+		return createInstrumentation(options);
+	};
+}
 /**
-* Root `instrumentation.ts` entry: load your real config only in the Node.js runtime so Edge
-* bundles never pull Node-only drains/adapters. Caches the dynamic `import()` so `register` and
-* repeated `onRequestError` calls share one module instance (avoids re-importing on every error).
+* Root `instrumentation.ts` entry: load evlog only in the Node.js runtime so Edge bundles stay clean.
+* Caches the dynamic `import()` so `register` and repeated `onRequestError` share one module instance.
 *
 * @example
 * ```ts
 * // instrumentation.ts
 * import { defineNodeInstrumentation } from 'evlog/next/instrumentation'
 *
-* export const { register, onRequestError } = defineNodeInstrumentation(() => import('./lib/evlog'))
+* export const { register, onRequestError } = defineNodeInstrumentation({
+*   service: 'my-app',
+*   captureOutput: true,
+* })
 * ```
 */
-function defineNodeInstrumentation(loader) {
+function defineNodeInstrumentation(loaderOrOptions) {
+	const loader = isLoader(loaderOrOptions) ? loaderOrOptions : createOptionsLoader(loaderOrOptions);
 	let cached;
 	function load() {
 		cached ??= loader();
@@ -30,80 +54,7 @@ function defineNodeInstrumentation(loader) {
 		}
 	};
 }
-let patching = false;
-function createInstrumentation(options = {}) {
-	let registered = false;
-	function register() {
-		if (registered) return;
-		registered = true;
-		initLogger({
-			enabled: options.enabled,
-			env: {
-				service: options.service,
-				...options.env
-			},
-			pretty: options.pretty,
-			silent: options.silent,
-			sampling: options.sampling,
-			minLevel: options.minLevel,
-			stringify: options.stringify,
-			drain: options.drain
-		});
-		lockLogger();
-		if (options.captureOutput && process.env.NEXT_RUNTIME === "nodejs") patchOutput();
-	}
-	function patchOutput() {
-		const proc = globalThis.process;
-		const originalStdoutWrite = proc.stdout.write.bind(proc.stdout);
-		const originalStderrWrite = proc.stderr.write.bind(proc.stderr);
-		proc.stdout.write = function(chunk, ...args) {
-			if (!patching) {
-				patching = true;
-				try {
-					_log.info({
-						source: "stdout",
-						message: String(chunk).trimEnd()
-					});
-				} finally {
-					patching = false;
-				}
-			}
-			return originalStdoutWrite(chunk, ...args);
-		};
-		proc.stderr.write = function(chunk, ...args) {
-			if (!patching) {
-				patching = true;
-				try {
-					_log.error({
-						source: "stderr",
-						message: String(chunk).trimEnd()
-					});
-				} finally {
-					patching = false;
-				}
-			}
-			return originalStderrWrite(chunk, ...args);
-		};
-	}
-	function onRequestError(error, request, context) {
-		_log.error({
-			message: error.message,
-			digest: error.digest,
-			stack: error.stack,
-			path: request.path,
-			method: request.method,
-			routerKind: context.routerKind,
-			routePath: context.routePath,
-			routeType: context.routeType,
-			renderSource: context.renderSource
-		});
-	}
-	return {
-		register,
-		onRequestError
-	};
-}
 //#endregion
-export { createInstrumentation, defineNodeInstrumentation };
+export { defineNodeInstrumentation };
 
 //# sourceMappingURL=instrumentation.mjs.map

package/dist/next/instrumentation.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"instrumentation.mjs","names":[],"sources":["../../src/next/instrumentation.ts"],"sourcesContent":["import type { DrainContext, EnvironmentContext, LogLevel, SamplingConfig } from '../types'\nimport { initLogger, log, lockLogger } from '../logger'\n\n/** Request payload passed to Next.js `onRequestError` (App Router). */\nexport interface NextInstrumentationRequest {\n  path: string\n  method: string\n  headers: Record<string, string>\n}\n\n/** Routing context passed to Next.js `onRequestError`. */\nexport interface NextInstrumentationErrorContext {\n  routerKind: string\n  routePath: string\n  routeType: string\n  renderSource: string\n}\n\n/**\n * What `lib/evlog.ts` should export for use with {@link defineNodeInstrumentation}\n * (typically the return values of `createInstrumentation()`).\n */\nexport interface NodeInstrumentationModule {\n  register: () => void | Promise<void>\n  onRequestError: (\n    error: { digest?: string } & Error,\n    request: NextInstrumentationRequest,\n    context: NextInstrumentationErrorContext,\n  ) => void | Promise<void>\n}\n\n/**\n * Root `instrumentation.ts` entry: load your real config only in the Node.js runtime so Edge\n * bundles never pull Node-only drains/adapters. Caches the dynamic `import()` so `register` and\n * repeated `onRequestError` calls share one module instance (avoids re-importing on every error).\n *\n * @example\n * ```ts\n * // instrumentation.ts\n * import { defineNodeInstrumentation } from 'evlog/next/instrumentation'\n *\n * export const { register, onRequestError } = defineNodeInstrumentation(() => import('./lib/evlog'))\n * ```\n */\nexport function defineNodeInstrumentation(loader: () => Promise<NodeInstrumentationModule>) {\n  let cached: Promise<NodeInstrumentationModule> | undefined\n\n  function load(): Promise<NodeInstrumentationModule> {\n    cached ??= loader()\n    return cached\n  }\n\n  return {\n    async register() {\n      if (process.env.NEXT_RUNTIME !== 'nodejs') return\n      const mod = await load()\n      await mod.register()\n    },\n    async onRequestError(\n      error: { digest?: string } & Error,\n      request: NextInstrumentationRequest,\n      context: NextInstrumentationErrorContext,\n    ) {\n      if (process.env.NEXT_RUNTIME !== 'nodejs') return\n      const mod = await load()\n      await mod.onRequestError(error, request, context)\n    },\n  }\n}\n\nexport interface InstrumentationOptions {\n  /** Enable or disable all logging globally. @default true */\n  enabled?: boolean\n  /** Service name for all logged events. */\n  service?: string\n  /** Environment context overrides. */\n  env?: Partial<EnvironmentContext>\n  /** Enable pretty printing. @default true in development */\n  pretty?: boolean\n  /** Suppress built-in console output. @default false */\n  silent?: boolean\n  /** Sampling configuration for filtering logs. */\n  sampling?: SamplingConfig\n  /** Minimum severity for the global `log` API. @default 'debug' */\n  minLevel?: LogLevel\n  /** When pretty is disabled, emit JSON strings or raw objects. @default true */\n  stringify?: boolean\n  /** Drain callback called with every emitted event. */\n  drain?: (ctx: DrainContext) => void | Promise<void>\n  /** Capture stdout/stderr output as log events (Node.js only). */\n  captureOutput?: boolean\n}\n\ninterface InstrumentationResult {\n  register: () => void\n  onRequestError: (\n    error: { digest?: string } & Error,\n    request: NextInstrumentationRequest,\n    context: NextInstrumentationErrorContext,\n  ) => void\n}\n\nlet patching = false\n\nexport function createInstrumentation(options: InstrumentationOptions = {}): InstrumentationResult {\n  let registered = false\n\n  function register(): void {\n    if (registered) return\n    registered = true\n\n    initLogger({\n      enabled: options.enabled,\n      env: {\n        service: options.service,\n        ...options.env,\n      },\n      pretty: options.pretty,\n      silent: options.silent,\n      sampling: options.sampling,\n      minLevel: options.minLevel,\n      stringify: options.stringify,\n      drain: options.drain,\n    })\n    lockLogger()\n\n    if (options.captureOutput && process.env.NEXT_RUNTIME === 'nodejs') {\n      patchOutput()\n    }\n  }\n\n  function patchOutput(): void {\n    const proc = globalThis.process\n    const originalStdoutWrite = proc.stdout.write.bind(proc.stdout)\n    const originalStderrWrite = proc.stderr.write.bind(proc.stderr)\n\n    proc.stdout.write = function(chunk: unknown, ...args: unknown[]): boolean {\n      if (!patching) {\n        patching = true\n        try {\n          log.info({ source: 'stdout', message: String(chunk).trimEnd() })\n        } finally {\n          patching = false\n        }\n      }\n      return originalStdoutWrite(chunk as string, ...args as [])\n    } as typeof process.stdout.write\n\n    proc.stderr.write = function(chunk: unknown, ...args: unknown[]): boolean {\n      if (!patching) {\n        patching = true\n        try {\n          log.error({ source: 'stderr', message: String(chunk).trimEnd() })\n        } finally {\n          patching = false\n        }\n      }\n      return originalStderrWrite(chunk as string, ...args as [])\n    } as typeof process.stderr.write\n  }\n\n  function onRequestError(\n    error: { digest?: string } & Error,\n    request: { path: string; method: string; headers: Record<string, string> },\n    context: { routerKind: string; routePath: string; routeType: string; renderSource: string },\n  ): void {\n    log.error({\n      message: error.message,\n      digest: error.digest,\n      stack: error.stack,\n      path: request.path,\n      method: request.method,\n      routerKind: context.routerKind,\n      routePath: context.routePath,\n      routeType: context.routeType,\n      renderSource: context.renderSource,\n    })\n  }\n\n  return { register, onRequestError }\n}\n"],"mappings":";;;;;;;;;;;;;;;AA4CA,SAAgB,0BAA0B,QAAkD;CAC1F,IAAI;CAEJ,SAAS,OAA2C;AAClD,aAAW,QAAQ;AACnB,SAAO;;AAGT,QAAO;EACL,MAAM,WAAW;AACf,OAAI,QAAQ,IAAI,iBAAiB,SAAU;AAE3C,UAAM,MADY,MAAM,EACd,UAAU;;EAEtB,MAAM,eACJ,OACA,SACA,SACA;AACA,OAAI,QAAQ,IAAI,iBAAiB,SAAU;AAE3C,UAAM,MADY,MAAM,EACd,eAAe,OAAO,SAAS,QAAQ;;EAEpD;;AAmCH,IAAI,WAAW;AAEf,SAAgB,sBAAsB,UAAkC,EAAE,EAAyB;CACjG,IAAI,aAAa;CAEjB,SAAS,WAAiB;AACxB,MAAI,WAAY;AAChB,eAAa;AAEb,aAAW;GACT,SAAS,QAAQ;GACjB,KAAK;IACH,SAAS,QAAQ;IACjB,GAAG,QAAQ;IACZ;GACD,QAAQ,QAAQ;GAChB,QAAQ,QAAQ;GAChB,UAAU,QAAQ;GAClB,UAAU,QAAQ;GAClB,WAAW,QAAQ;GACnB,OAAO,QAAQ;GAChB,CAAC;AACF,cAAY;AAEZ,MAAI,QAAQ,iBAAiB,QAAQ,IAAI,iBAAiB,SACxD,cAAa;;CAIjB,SAAS,cAAoB;EAC3B,MAAM,OAAO,WAAW;EACxB,MAAM,sBAAsB,KAAK,OAAO,MAAM,KAAK,KAAK,OAAO;EAC/D,MAAM,sBAAsB,KAAK,OAAO,MAAM,KAAK,KAAK,OAAO;AAE/D,OAAK,OAAO,QAAQ,SAAS,OAAgB,GAAG,MAA0B;AACxE,OAAI,CAAC,UAAU;AACb,eAAW;AACX,QAAI;AACF,UAAI,KAAK;MAAE,QAAQ;MAAU,SAAS,OAAO,MAAM,CAAC,SAAS;MAAE,CAAC;cACxD;AACR,gBAAW;;;AAGf,UAAO,oBAAoB,OAAiB,GAAG,KAAW;;AAG5D,OAAK,OAAO,QAAQ,SAAS,OAAgB,GAAG,MAA0B;AACxE,OAAI,CAAC,UAAU;AACb,eAAW;AACX,QAAI;AACF,UAAI,MAAM;MAAE,QAAQ;MAAU,SAAS,OAAO,MAAM,CAAC,SAAS;MAAE,CAAC;cACzD;AACR,gBAAW;;;AAGf,UAAO,oBAAoB,OAAiB,GAAG,KAAW;;;CAI9D,SAAS,eACP,OACA,SACA,SACM;AACN,OAAI,MAAM;GACR,SAAS,MAAM;GACf,QAAQ,MAAM;GACd,OAAO,MAAM;GACb,MAAM,QAAQ;GACd,QAAQ,QAAQ;GAChB,YAAY,QAAQ;GACpB,WAAW,QAAQ;GACnB,WAAW,QAAQ;GACnB,cAAc,QAAQ;GACvB,CAAC;;AAGJ,QAAO;EAAE;EAAU;EAAgB"}
+{"version":3,"file":"instrumentation.mjs","names":[],"sources":["../../src/next/instrumentation-gate.ts"],"sourcesContent":["import type { InstrumentationOptions } from './instrumentation-create'\n\n/** Request payload passed to Next.js `onRequestError` (App Router). */\nexport interface NextInstrumentationRequest {\n  path: string\n  method: string\n  headers: Record<string, string>\n}\n\n/** Routing context passed to Next.js `onRequestError`. */\nexport interface NextInstrumentationErrorContext {\n  routerKind: string\n  routePath: string\n  routeType: string\n  renderSource: string\n}\n\n/**\n * What your instrumentation module should export for use with {@link defineNodeInstrumentation}\n * (typically the return values of `createInstrumentation()` from `evlog/next/instrumentation/create`).\n */\nexport interface NodeInstrumentationModule {\n  register: () => void | Promise<void>\n  onRequestError: (\n    error: { digest?: string } & Error,\n    request: NextInstrumentationRequest,\n    context: NextInstrumentationErrorContext,\n  ) => void | Promise<void>\n}\n\ntype CreateInstrumentationModule = typeof import('./instrumentation-create')\n\n/** @internal Non-literal specifier so Turbopack does not pull the logger into the Edge bundle. */\nconst CREATE_ENTRY = ['evlog', 'next', 'instrumentation', 'create'].join('/')\n\nfunction importCreateModule(): Promise<CreateInstrumentationModule> {\n  return import(/* webpackIgnore: true */ CREATE_ENTRY) as Promise<CreateInstrumentationModule>\n}\n\nfunction isLoader(\n  value: (() => Promise<NodeInstrumentationModule>) | InstrumentationOptions,\n): value is () => Promise<NodeInstrumentationModule> {\n  return typeof value === 'function'\n}\n\nfunction createOptionsLoader(options: InstrumentationOptions): () => Promise<NodeInstrumentationModule> {\n  return async () => {\n    const { createInstrumentation } = await importCreateModule()\n    return createInstrumentation(options)\n  }\n}\n\n/**\n * Hooks returned by {@link defineNodeInstrumentation} for root `instrumentation.ts`.\n *\n * - `register` — async startup hook; initializes the global logger on Node.js only.\n * - `onRequestError` — logs SSR/RSC errors outside `withEvlog` via {@link NextInstrumentationRequest}\n *   and {@link NextInstrumentationErrorContext}.\n */\nexport type NodeInstrumentationHooks = {\n  /** Next.js instrumentation startup hook (Node.js runtime only). */\n  register: () => Promise<void>\n  /** Next.js global request error handler (Node.js runtime only). */\n  onRequestError: (\n    error: { digest?: string } & Error,\n    request: NextInstrumentationRequest,\n    context: NextInstrumentationErrorContext,\n  ) => Promise<void>\n}\n\n/** Options for {@link defineNodeInstrumentation} or a custom Node-only module loader. */\nexport type DefineNodeInstrumentationInput =\n  | InstrumentationOptions\n  | (() => Promise<NodeInstrumentationModule>)\n\n/**\n * Root `instrumentation.ts` entry: load evlog only in the Node.js runtime so Edge bundles stay clean.\n * Caches the dynamic `import()` so `register` and repeated `onRequestError` share one module instance.\n *\n * @example\n * ```ts\n * // instrumentation.ts\n * import { defineNodeInstrumentation } from 'evlog/next/instrumentation'\n *\n * export const { register, onRequestError } = defineNodeInstrumentation({\n *   service: 'my-app',\n *   captureOutput: true,\n * })\n * ```\n */\nexport function defineNodeInstrumentation(\n  loaderOrOptions: DefineNodeInstrumentationInput,\n): NodeInstrumentationHooks {\n  const loader = isLoader(loaderOrOptions) ? loaderOrOptions : createOptionsLoader(loaderOrOptions)\n  let cached: Promise<NodeInstrumentationModule> | undefined\n\n  function load(): Promise<NodeInstrumentationModule> {\n    cached ??= loader()\n    return cached\n  }\n\n  return {\n    async register() {\n      if (process.env.NEXT_RUNTIME !== 'nodejs') return\n      const mod = await load()\n      await mod.register()\n    },\n    async onRequestError(\n      error: { digest?: string } & Error,\n      request: NextInstrumentationRequest,\n      context: NextInstrumentationErrorContext,\n    ) {\n      if (process.env.NEXT_RUNTIME !== 'nodejs') return\n      const mod = await load()\n      await mod.onRequestError(error, request, context)\n    },\n  }\n}\n"],"mappings":";;AAiCA,MAAM,eAAe;CAAC;CAAS;CAAQ;CAAmB;CAAS,CAAC,KAAK,IAAI;AAE7E,SAAS,qBAA2D;AAClE,QAAO;;EAAiC;;;AAG1C,SAAS,SACP,OACmD;AACnD,QAAO,OAAO,UAAU;;AAG1B,SAAS,oBAAoB,SAA2E;AACtG,QAAO,YAAY;EACjB,MAAM,EAAE,0BAA0B,MAAM,oBAAoB;AAC5D,SAAO,sBAAsB,QAAQ;;;;;;;;;;;;;;;;;;AA0CzC,SAAgB,0BACd,iBAC0B;CAC1B,MAAM,SAAS,SAAS,gBAAgB,GAAG,kBAAkB,oBAAoB,gBAAgB;CACjG,IAAI;CAEJ,SAAS,OAA2C;AAClD,aAAW,QAAQ;AACnB,SAAO;;AAGT,QAAO;EACL,MAAM,WAAW;AACf,OAAI,QAAQ,IAAI,iBAAiB,SAAU;AAE3C,UAAM,MADY,MAAM,EACd,UAAU;;EAEtB,MAAM,eACJ,OACA,SACA,SACA;AACA,OAAI,QAAQ,IAAI,iBAAiB,SAAU;AAE3C,UAAM,MADY,MAAM,EACd,eAAe,OAAO,SAAS,QAAQ;;EAEpD"}

package/dist/next/stream.d.mts

@@ -1,4 +1,4 @@
-import { InstrumentationOptions, createInstrumentation } from "./instrumentation.mjs";
+import { i as createInstrumentation, r as InstrumentationOptions } from "../instrumentation-create-STGmQGQt.mjs";
 import { StreamServerOptions } from "../stream.mjs";
 
 //#region src/next/stream.d.ts

package/dist/next/stream.mjs

@@ -1,5 +1,5 @@
 import { startStreamServer } from "../stream.mjs";
-import { createInstrumentation } from "./instrumentation.mjs";
+import { createInstrumentation } from "./instrumentation/create.mjs";
 //#region src/next/stream.ts
 /**
 * Next.js helper that wires the local stream server into the standard
@@ -54,7 +54,7 @@ function defineStreamedInstrumentation(options = {}) {
 			}
 		}
 		const composedDrain = composeDrains(userDrain, serverDrain);
-		createInstrumentation({
+		await createInstrumentation({
 			...rest,
 			drain: composedDrain
 		}).register();

package/dist/next/stream.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"stream.mjs","names":[],"sources":["../../src/next/stream.ts"],"sourcesContent":["/**\n * Next.js helper that wires the local stream server into the standard\n * `instrumentation.ts` pattern. Strict opt-in: nothing starts unless\n * `stream: true` (or a config object) is passed explicitly.\n *\n * @example\n * ```ts\n * // lib/evlog.ts\n * import { defineStreamedInstrumentation } from 'evlog/next/stream'\n *\n * export const { register, onRequestError } = defineStreamedInstrumentation({\n *   service: 'my-app',\n *   stream: true,            // opt in to the local SSE stream server\n * })\n * ```\n *\n * ```ts\n * // instrumentation.ts\n * import { defineNodeInstrumentation } from 'evlog/next/instrumentation'\n *\n * export const { register, onRequestError } = defineNodeInstrumentation(() =>\n *   import('./lib/evlog')\n * )\n * ```\n *\n * When enabled, the mini server boots on first `register()` call and prints\n * `[evlog] Stream → http://127.0.0.1:<port>`. Without `stream`, this is a\n * straight pass-through to `createInstrumentation()`.\n */\n\nimport { startStreamServer, type StreamServerOptions } from '../stream'\nimport type { DrainContext } from '../types'\nimport { createInstrumentation, type InstrumentationOptions } from './instrumentation'\n\nexport interface StreamedInstrumentationOptions extends InstrumentationOptions {\n  /**\n   * Live stream server.\n   *\n   * Strict opt-in — nothing starts unless this is set explicitly.\n   *\n   * - `true` — enable with defaults\n   * - `false` — off (same as omitting)\n   * - `StreamServerOptions` — full config (port, host, token, ...)\n   * - `undefined` (default) — off\n   */\n  stream?: boolean | StreamServerOptions\n}\n\ninterface InstrumentationResult {\n  register: () => Promise<void>\n  onRequestError: ReturnType<typeof createInstrumentation>['onRequestError']\n}\n\n/**\n * Drop-in replacement for `createInstrumentation` that adds the local\n * stream server lifecycle.\n */\nexport function defineStreamedInstrumentation(options: StreamedInstrumentationOptions = {}): InstrumentationResult {\n  const { stream: streamOpt, drain: userDrain, ...rest } = options\n\n  function shouldStartServer(): boolean {\n    if (streamOpt === true) return true\n    if (streamOpt && typeof streamOpt === 'object') return true\n    return false\n  }\n\n  const start: boolean = shouldStartServer()\n  let serverDrain: ((ctx: DrainContext) => void | Promise<void>) | null = null\n\n  async function register(): Promise<void> {\n    if (start) {\n      const cfg: StreamServerOptions = streamOpt && typeof streamOpt === 'object' ? streamOpt : {}\n      try {\n        const server = await startStreamServer(cfg)\n        serverDrain = ctx => server.drain(ctx)\n      } catch (err) {\n        console.error('[evlog/next] failed to start stream server:', err)\n      }\n    }\n\n    const composedDrain = composeDrains(userDrain, serverDrain)\n    const inner = createInstrumentation({ ...rest, drain: composedDrain })\n    inner.register()\n  }\n\n  // We intentionally instantiate a \"zero-time\" inner just for onRequestError —\n  // it wires `log.error` which doesn't depend on the drain.\n  const errorOnly = createInstrumentation({ ...rest })\n\n  return {\n    register,\n    onRequestError: errorOnly.onRequestError,\n  }\n}\n\nfunction composeDrains(\n  user: ((ctx: DrainContext) => void | Promise<void>) | undefined,\n  server: ((ctx: DrainContext) => void | Promise<void>) | null,\n): ((ctx: DrainContext) => void | Promise<void>) | undefined {\n  if (!user && !server) return undefined\n  if (!user) return server!\n  if (!server) return user\n  return async (ctx) => {\n    await Promise.all([\n      Promise.resolve(user(ctx)),\n      Promise.resolve(server(ctx)),\n    ])\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyDA,SAAgB,8BAA8B,UAA0C,EAAE,EAAyB;CACjH,MAAM,EAAE,QAAQ,WAAW,OAAO,WAAW,GAAG,SAAS;CAEzD,SAAS,oBAA6B;AACpC,MAAI,cAAc,KAAM,QAAO;AAC/B,MAAI,aAAa,OAAO,cAAc,SAAU,QAAO;AACvD,SAAO;;CAGT,MAAM,QAAiB,mBAAmB;CAC1C,IAAI,cAAoE;CAExE,eAAe,WAA0B;AACvC,MAAI,OAAO;GACT,MAAM,MAA2B,aAAa,OAAO,cAAc,WAAW,YAAY,EAAE;AAC5F,OAAI;IACF,MAAM,SAAS,MAAM,kBAAkB,IAAI;AAC3C,mBAAc,QAAO,OAAO,MAAM,IAAI;YAC/B,KAAK;AACZ,YAAQ,MAAM,+CAA+C,IAAI;;;EAIrE,MAAM,gBAAgB,cAAc,WAAW,YAAY;AAC7C,wBAAsB;GAAE,GAAG;GAAM,OAAO;GAAe,CAChE,CAAC,UAAU;;AAOlB,QAAO;EACL;EACA,gBAJgB,sBAAsB,EAAE,GAAG,MAAM,CAIxB,CAAC;EAC3B;;AAGH,SAAS,cACP,MACA,QAC2D;AAC3D,KAAI,CAAC,QAAQ,CAAC,OAAQ,QAAO,KAAA;AAC7B,KAAI,CAAC,KAAM,QAAO;AAClB,KAAI,CAAC,OAAQ,QAAO;AACpB,QAAO,OAAO,QAAQ;AACpB,QAAM,QAAQ,IAAI,CAChB,QAAQ,QAAQ,KAAK,IAAI,CAAC,EAC1B,QAAQ,QAAQ,OAAO,IAAI,CAAC,CAC7B,CAAC"}
+{"version":3,"file":"stream.mjs","names":[],"sources":["../../src/next/stream.ts"],"sourcesContent":["/**\n * Next.js helper that wires the local stream server into the standard\n * `instrumentation.ts` pattern. Strict opt-in: nothing starts unless\n * `stream: true` (or a config object) is passed explicitly.\n *\n * @example\n * ```ts\n * // lib/evlog.ts\n * import { defineStreamedInstrumentation } from 'evlog/next/stream'\n *\n * export const { register, onRequestError } = defineStreamedInstrumentation({\n *   service: 'my-app',\n *   stream: true,            // opt in to the local SSE stream server\n * })\n * ```\n *\n * ```ts\n * // instrumentation.ts\n * import { defineNodeInstrumentation } from 'evlog/next/instrumentation'\n *\n * export const { register, onRequestError } = defineNodeInstrumentation(() =>\n *   import('./lib/evlog')\n * )\n * ```\n *\n * When enabled, the mini server boots on first `register()` call and prints\n * `[evlog] Stream → http://127.0.0.1:<port>`. Without `stream`, this is a\n * straight pass-through to `createInstrumentation()`.\n */\n\nimport { startStreamServer, type StreamServerOptions } from '../stream'\nimport type { DrainContext } from '../types'\nimport { createInstrumentation, type InstrumentationOptions } from './instrumentation-create'\n\nexport interface StreamedInstrumentationOptions extends InstrumentationOptions {\n  /**\n   * Live stream server.\n   *\n   * Strict opt-in — nothing starts unless this is set explicitly.\n   *\n   * - `true` — enable with defaults\n   * - `false` — off (same as omitting)\n   * - `StreamServerOptions` — full config (port, host, token, ...)\n   * - `undefined` (default) — off\n   */\n  stream?: boolean | StreamServerOptions\n}\n\ninterface InstrumentationResult {\n  register: () => Promise<void>\n  onRequestError: ReturnType<typeof createInstrumentation>['onRequestError']\n}\n\n/**\n * Drop-in replacement for `createInstrumentation` that adds the local\n * stream server lifecycle.\n */\nexport function defineStreamedInstrumentation(options: StreamedInstrumentationOptions = {}): InstrumentationResult {\n  const { stream: streamOpt, drain: userDrain, ...rest } = options\n\n  function shouldStartServer(): boolean {\n    if (streamOpt === true) return true\n    if (streamOpt && typeof streamOpt === 'object') return true\n    return false\n  }\n\n  const start: boolean = shouldStartServer()\n  let serverDrain: ((ctx: DrainContext) => void | Promise<void>) | null = null\n\n  async function register(): Promise<void> {\n    if (start) {\n      const cfg: StreamServerOptions = streamOpt && typeof streamOpt === 'object' ? streamOpt : {}\n      try {\n        const server = await startStreamServer(cfg)\n        serverDrain = ctx => server.drain(ctx)\n      } catch (err) {\n        console.error('[evlog/next] failed to start stream server:', err)\n      }\n    }\n\n    const composedDrain = composeDrains(userDrain, serverDrain)\n    const inner = createInstrumentation({ ...rest, drain: composedDrain })\n    await inner.register()\n  }\n\n  // We intentionally instantiate a \"zero-time\" inner just for onRequestError —\n  // it wires `log.error` which doesn't depend on the drain.\n  const errorOnly = createInstrumentation({ ...rest })\n\n  return {\n    register,\n    onRequestError: errorOnly.onRequestError,\n  }\n}\n\nfunction composeDrains(\n  user: ((ctx: DrainContext) => void | Promise<void>) | undefined,\n  server: ((ctx: DrainContext) => void | Promise<void>) | null,\n): ((ctx: DrainContext) => void | Promise<void>) | undefined {\n  if (!user && !server) return undefined\n  if (!user) return server!\n  if (!server) return user\n  return async (ctx) => {\n    await Promise.all([\n      Promise.resolve(user(ctx)),\n      Promise.resolve(server(ctx)),\n    ])\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyDA,SAAgB,8BAA8B,UAA0C,EAAE,EAAyB;CACjH,MAAM,EAAE,QAAQ,WAAW,OAAO,WAAW,GAAG,SAAS;CAEzD,SAAS,oBAA6B;AACpC,MAAI,cAAc,KAAM,QAAO;AAC/B,MAAI,aAAa,OAAO,cAAc,SAAU,QAAO;AACvD,SAAO;;CAGT,MAAM,QAAiB,mBAAmB;CAC1C,IAAI,cAAoE;CAExE,eAAe,WAA0B;AACvC,MAAI,OAAO;GACT,MAAM,MAA2B,aAAa,OAAO,cAAc,WAAW,YAAY,EAAE;AAC5F,OAAI;IACF,MAAM,SAAS,MAAM,kBAAkB,IAAI;AAC3C,mBAAc,QAAO,OAAO,MAAM,IAAI;YAC/B,KAAK;AACZ,YAAQ,MAAM,+CAA+C,IAAI;;;EAIrE,MAAM,gBAAgB,cAAc,WAAW,YAAY;AAE3D,QADc,sBAAsB;GAAE,GAAG;GAAM,OAAO;GAAe,CAC1D,CAAC,UAAU;;AAOxB,QAAO;EACL;EACA,gBAJgB,sBAAsB,EAAE,GAAG,MAAM,CAIxB,CAAC;EAC3B;;AAGH,SAAS,cACP,MACA,QAC2D;AAC3D,KAAI,CAAC,QAAQ,CAAC,OAAQ,QAAO,KAAA;AAC7B,KAAI,CAAC,KAAM,QAAO;AAClB,KAAI,CAAC,OAAQ,QAAO;AACpB,QAAO,OAAO,QAAQ;AACpB,QAAM,QAAQ,IAAI,CAChB,QAAQ,QAAQ,KAAK,IAAI,CAAC,EAC1B,QAAQ,QAAQ,OAAO,IAAI,CAAC,CAC7B,CAAC"}

package/dist/nitro/errorHandler.mjs

@@ -1,9 +1,20 @@
 import { t as extractErrorStatus } from "../errors-DA0cyr8q.mjs";
-import { a as serializeEvlogErrorResponse, i as resolveEvlogError, n as markH3ErrorHandled, o as shouldSuppressNitroDevOverlay, s as suppressNitroDevOverlay, t as buildPlainNitroErrorBody } from "../nitro-ClRZLD1g.mjs";
-import { getRequestURL, send, setResponseHeader, setResponseStatus } from "h3";
+import { a as serializeEvlogErrorResponse, c as suppressNitroDevOverlay, i as resolveEvlogError, n as markH3ErrorHandled, o as shouldSerializeNitroErrorAsJson, s as shouldSuppressNitroDevOverlay, t as buildPlainNitroErrorBody } from "../nitro-ClHmVj1H.mjs";
+import { getRequestHeader, getRequestURL, setResponseHeader, setResponseStatus } from "h3";
 import { defineNitroErrorHandler } from "nitropack/runtime/internal/error/utils";
 //#region src/nitro/errorHandler.ts
 /**
+* Flush the error response by ending the Node response directly.
+*
+* h3 v1's `send()` is a no-op once the event is marked handled, and the event
+* must be marked handled *before* responding so Nitro's chained dev handler
+* (Youch overlay) does not run after us. Ending the Node response directly
+* resolves that tension: the flush is synchronous and unconditional (#374).
+*/
+function endNodeResponse(event, body) {
+	if (!event.node.res.writableEnded) event.node.res.end(body);
+}
+/**
 * Custom Nitro error handler that properly serializes EvlogError.
 * This ensures that 'data' (containing 'why', 'fix', 'link') is preserved
 * in the JSON response regardless of the underlying HTTP framework.
@@ -12,22 +23,27 @@ import { defineNitroErrorHandler } from "nitropack/runtime/internal/error/utils"
 * sanitizing internal error details in production for 5xx errors.
 */
 var errorHandler_default = defineNitroErrorHandler(async (error, event, ctx) => {
+	const evlogError = resolveEvlogError(error);
+	const requestUrl = getRequestURL(event, { xForwardedHost: true });
+	if (!shouldSerializeNitroErrorAsJson({
+		pathname: requestUrl.pathname,
+		getHeader: (name) => getRequestHeader(event, name)
+	}, evlogError)) return;
 	const suppressOverlay = shouldSuppressNitroDevOverlay();
-	if (!suppressOverlay) await ctx.defaultHandler(error, event, { silent: false });
+	if (!suppressOverlay && ctx?.defaultHandler) await ctx.defaultHandler(error, event, { silent: false });
 	markH3ErrorHandled(event);
 	if (suppressOverlay) suppressNitroDevOverlay(error);
-	const evlogError = resolveEvlogError(error);
 	const isDev = process.env.NODE_ENV === "development";
-	const url = getRequestURL(event, { xForwardedHost: true }).pathname;
+	const url = requestUrl.pathname;
 	if (!evlogError) {
 		const body = buildPlainNitroErrorBody(error, url, isDev);
 		setResponseStatus(event, body.status);
 		setResponseHeader(event, "Content-Type", "application/json");
-		return send(event, JSON.stringify(body));
+		return endNodeResponse(event, JSON.stringify(body));
 	}
 	setResponseStatus(event, extractErrorStatus(evlogError));
 	setResponseHeader(event, "Content-Type", "application/json");
-	return send(event, JSON.stringify(serializeEvlogErrorResponse(evlogError, url)));
+	return endNodeResponse(event, JSON.stringify(serializeEvlogErrorResponse(evlogError, url)));
 });
 //#endregion
 export { errorHandler_default as default };

package/dist/nitro/errorHandler.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"errorHandler.mjs","names":[],"sources":["../../src/nitro/errorHandler.ts"],"sourcesContent":["// Import from specific subpath — the barrel 'nitropack/runtime' re-exports from\n// internal/app.mjs which imports virtual modules that crash outside rollup builds.\nimport { defineNitroErrorHandler } from 'nitropack/runtime/internal/error/utils'\nimport { getRequestURL, setResponseHeader, setResponseStatus, send } from 'h3'\nimport {\n  resolveEvlogError,\n  extractErrorStatus,\n  buildPlainNitroErrorBody,\n  serializeEvlogErrorResponse,\n  markH3ErrorHandled,\n  shouldSuppressNitroDevOverlay,\n  suppressNitroDevOverlay,\n} from '../nitro'\nimport type { NitroErrorHandlerContext } from '../shared/nitro-types'\n\n/**\n * Custom Nitro error handler that properly serializes EvlogError.\n * This ensures that 'data' (containing 'why', 'fix', 'link') is preserved\n * in the JSON response regardless of the underlying HTTP framework.\n *\n * For non-EvlogError, it preserves Nitro's default response shape while\n * sanitizing internal error details in production for 5xx errors.\n */\nexport default defineNitroErrorHandler(async (error, event, ctx: NitroErrorHandlerContext) => {\n  const suppressOverlay = shouldSuppressNitroDevOverlay()\n\n  if (!suppressOverlay) {\n    await ctx.defaultHandler(error, event, { silent: false })\n  }\n\n  markH3ErrorHandled(event)\n  if (suppressOverlay) {\n    suppressNitroDevOverlay(error)\n  }\n\n  const evlogError = resolveEvlogError(error)\n\n  const isDev = process.env.NODE_ENV === 'development'\n  const url = getRequestURL(event, { xForwardedHost: true }).pathname\n\n  if (!evlogError) {\n    const body = buildPlainNitroErrorBody(error, url, isDev)\n    setResponseStatus(event, body.status as number)\n    setResponseHeader(event, 'Content-Type', 'application/json')\n    return send(event, JSON.stringify(body))\n  }\n\n  const status = extractErrorStatus(evlogError)\n\n  setResponseStatus(event, status)\n  setResponseHeader(event, 'Content-Type', 'application/json')\n\n  return send(event, JSON.stringify(serializeEvlogErrorResponse(evlogError, url)))\n})\n"],"mappings":";;;;;;;;;;;;;AAuBA,IAAA,uBAAe,wBAAwB,OAAO,OAAO,OAAO,QAAkC;CAC5F,MAAM,kBAAkB,+BAA+B;AAEvD,KAAI,CAAC,gBACH,OAAM,IAAI,eAAe,OAAO,OAAO,EAAE,QAAQ,OAAO,CAAC;AAG3D,oBAAmB,MAAM;AACzB,KAAI,gBACF,yBAAwB,MAAM;CAGhC,MAAM,aAAa,kBAAkB,MAAM;CAE3C,MAAM,QAAQ,QAAQ,IAAI,aAAa;CACvC,MAAM,MAAM,cAAc,OAAO,EAAE,gBAAgB,MAAM,CAAC,CAAC;AAE3D,KAAI,CAAC,YAAY;EACf,MAAM,OAAO,yBAAyB,OAAO,KAAK,MAAM;AACxD,oBAAkB,OAAO,KAAK,OAAiB;AAC/C,oBAAkB,OAAO,gBAAgB,mBAAmB;AAC5D,SAAO,KAAK,OAAO,KAAK,UAAU,KAAK,CAAC;;AAK1C,mBAAkB,OAFH,mBAAmB,WAEH,CAAC;AAChC,mBAAkB,OAAO,gBAAgB,mBAAmB;AAE5D,QAAO,KAAK,OAAO,KAAK,UAAU,4BAA4B,YAAY,IAAI,CAAC,CAAC;EAChF"}
+{"version":3,"file":"errorHandler.mjs","names":[],"sources":["../../src/nitro/errorHandler.ts"],"sourcesContent":["// Import from specific subpath — the barrel 'nitropack/runtime' re-exports from\n// internal/app.mjs which imports virtual modules that crash outside rollup builds.\nimport { defineNitroErrorHandler } from 'nitropack/runtime/internal/error/utils'\nimport { getRequestHeader, getRequestURL, setResponseHeader, setResponseStatus } from 'h3'\nimport type { H3Event } from 'h3'\nimport {\n  resolveEvlogError,\n  extractErrorStatus,\n  buildPlainNitroErrorBody,\n  serializeEvlogErrorResponse,\n  markH3ErrorHandled,\n  shouldSerializeNitroErrorAsJson,\n  shouldSuppressNitroDevOverlay,\n  suppressNitroDevOverlay,\n} from '../nitro'\n\n/**\n * Flush the error response by ending the Node response directly.\n *\n * h3 v1's `send()` is a no-op once the event is marked handled, and the event\n * must be marked handled *before* responding so Nitro's chained dev handler\n * (Youch overlay) does not run after us. Ending the Node response directly\n * resolves that tension: the flush is synchronous and unconditional (#374).\n */\nfunction endNodeResponse(event: H3Event, body: string): void {\n  if (!event.node.res.writableEnded) {\n    event.node.res.end(body)\n  }\n}\n\n/**\n * Custom Nitro error handler that properly serializes EvlogError.\n * This ensures that 'data' (containing 'why', 'fix', 'link') is preserved\n * in the JSON response regardless of the underlying HTTP framework.\n *\n * For non-EvlogError, it preserves Nitro's default response shape while\n * sanitizing internal error details in production for 5xx errors.\n */\nexport default defineNitroErrorHandler(async (error, event, ctx) => {\n  const evlogError = resolveEvlogError(error)\n  const requestUrl = getRequestURL(event, { xForwardedHost: true })\n\n  if (!shouldSerializeNitroErrorAsJson({\n    pathname: requestUrl.pathname,\n    getHeader: name => getRequestHeader(event, name),\n  }, evlogError)) {\n    return\n  }\n\n  const suppressOverlay = shouldSuppressNitroDevOverlay()\n\n  // Nitro v2 always passes `ctx`, but a missing context (e.g. the handler\n  // invoked directly) must degrade to a flushed response, not a crash.\n  if (!suppressOverlay && ctx?.defaultHandler) {\n    await ctx.defaultHandler(error, event, { silent: false })\n  }\n\n  markH3ErrorHandled(event)\n  if (suppressOverlay) {\n    suppressNitroDevOverlay(error)\n  }\n\n  const isDev = process.env.NODE_ENV === 'development'\n  const url = requestUrl.pathname\n\n  if (!evlogError) {\n    const body = buildPlainNitroErrorBody(error, url, isDev)\n    setResponseStatus(event, body.status as number)\n    setResponseHeader(event, 'Content-Type', 'application/json')\n    return endNodeResponse(event, JSON.stringify(body))\n  }\n\n  const status = extractErrorStatus(evlogError)\n\n  setResponseStatus(event, status)\n  setResponseHeader(event, 'Content-Type', 'application/json')\n\n  return endNodeResponse(event, JSON.stringify(serializeEvlogErrorResponse(evlogError, url)))\n})\n"],"mappings":";;;;;;;;;;;;;AAwBA,SAAS,gBAAgB,OAAgB,MAAoB;AAC3D,KAAI,CAAC,MAAM,KAAK,IAAI,cAClB,OAAM,KAAK,IAAI,IAAI,KAAK;;;;;;;;;;AAY5B,IAAA,uBAAe,wBAAwB,OAAO,OAAO,OAAO,QAAQ;CAClE,MAAM,aAAa,kBAAkB,MAAM;CAC3C,MAAM,aAAa,cAAc,OAAO,EAAE,gBAAgB,MAAM,CAAC;AAEjE,KAAI,CAAC,gCAAgC;EACnC,UAAU,WAAW;EACrB,YAAW,SAAQ,iBAAiB,OAAO,KAAK;EACjD,EAAE,WAAW,CACZ;CAGF,MAAM,kBAAkB,+BAA+B;AAIvD,KAAI,CAAC,mBAAmB,KAAK,eAC3B,OAAM,IAAI,eAAe,OAAO,OAAO,EAAE,QAAQ,OAAO,CAAC;AAG3D,oBAAmB,MAAM;AACzB,KAAI,gBACF,yBAAwB,MAAM;CAGhC,MAAM,QAAQ,QAAQ,IAAI,aAAa;CACvC,MAAM,MAAM,WAAW;AAEvB,KAAI,CAAC,YAAY;EACf,MAAM,OAAO,yBAAyB,OAAO,KAAK,MAAM;AACxD,oBAAkB,OAAO,KAAK,OAAiB;AAC/C,oBAAkB,OAAO,gBAAgB,mBAAmB;AAC5D,SAAO,gBAAgB,OAAO,KAAK,UAAU,KAAK,CAAC;;AAKrD,mBAAkB,OAFH,mBAAmB,WAEH,CAAC;AAChC,mBAAkB,OAAO,gBAAgB,mBAAmB;AAE5D,QAAO,gBAAgB,OAAO,KAAK,UAAU,4BAA4B,YAAY,IAAI,CAAC,CAAC;EAC3F"}

package/dist/nitro/module.d.mts

@@ -1,5 +1,5 @@
-import { t as useLogger } from "../useLogger-Dv52PDpH.mjs";
-import { t as NitroModuleOptions } from "../nitro-zCXTylj4.mjs";
+import { t as useLogger } from "../useLogger-DiRWGD33.mjs";
+import { t as NitroModuleOptions } from "../nitro--E4op34w.mjs";
 import { Nitro } from "nitropack";
 
 //#region src/nitro/module.d.ts

package/dist/nitro/module.mjs

@@ -1,5 +1,5 @@
 import { useLogger } from "../runtime/server/useLogger.mjs";
-import { r as prependNitroErrorHandler } from "../nitro-ClRZLD1g.mjs";
+import { r as prependNitroErrorHandler } from "../nitro-ClHmVj1H.mjs";
 import { dirname, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 //#region src/nitro/module.ts