evlog 1.5.0 → 1.7.0

package/dist/logger.mjs

@@ -1,203 +1,234 @@
-import { defu } from 'defu';
-import { isDev, detectEnvironment, formatDuration, matchesPattern, getConsoleMethod, colors, getLevelColor } from './utils.mjs';
+import { colors, detectEnvironment, formatDuration, getConsoleMethod, getLevelColor, isDev, matchesPattern } from "./utils.mjs";
 
+//#region src/logger.ts
+function isPlainObject(val) {
+	return val !== null && typeof val === "object" && !Array.isArray(val);
+}
+function deepDefaults(base, defaults) {
+	const result = { ...base };
+	for (const key in defaults) {
+		const baseVal = result[key];
+		const defaultVal = defaults[key];
+		if (baseVal === void 0 || baseVal === null) result[key] = defaultVal;
+		else if (isPlainObject(baseVal) && isPlainObject(defaultVal)) result[key] = deepDefaults(baseVal, defaultVal);
+	}
+	return result;
+}
 let globalEnv = {
-  service: "app",
-  environment: "development"
+	service: "app",
+	environment: "development"
 };
 let globalPretty = isDev();
 let globalSampling = {};
 let globalStringify = true;
+let globalDrain;
+/**
+* Initialize the logger with configuration.
+* Call this once at application startup.
+*/
 function initLogger(config = {}) {
-  const detected = detectEnvironment();
-  globalEnv = {
-    service: config.env?.service ?? detected.service ?? "app",
-    environment: config.env?.environment ?? detected.environment ?? "development",
-    version: config.env?.version ?? detected.version,
-    commitHash: config.env?.commitHash ?? detected.commitHash,
-    region: config.env?.region ?? detected.region
-  };
-  globalPretty = config.pretty ?? isDev();
-  globalSampling = config.sampling ?? {};
-  globalStringify = config.stringify ?? true;
+	const detected = detectEnvironment();
+	globalEnv = {
+		service: config.env?.service ?? detected.service ?? "app",
+		environment: config.env?.environment ?? detected.environment ?? "development",
+		version: config.env?.version ?? detected.version,
+		commitHash: config.env?.commitHash ?? detected.commitHash,
+		region: config.env?.region ?? detected.region
+	};
+	globalPretty = config.pretty ?? isDev();
+	globalSampling = config.sampling ?? {};
+	globalStringify = config.stringify ?? true;
+	globalDrain = config.drain;
 }
+/**
+* Determine if a log at the given level should be emitted based on sampling config.
+* Error level defaults to 100% (always logged) unless explicitly configured otherwise.
+*/
 function shouldSample(level) {
-  const { rates } = globalSampling;
-  if (!rates) {
-    return true;
-  }
-  const percentage = level === "error" && rates.error === void 0 ? 100 : rates[level] ?? 100;
-  if (percentage <= 0) return false;
-  if (percentage >= 100) return true;
-  return Math.random() * 100 < percentage;
+	const { rates } = globalSampling;
+	if (!rates) return true;
+	const percentage = level === "error" && rates.error === void 0 ? 100 : rates[level] ?? 100;
+	if (percentage <= 0) return false;
+	if (percentage >= 100) return true;
+	return Math.random() * 100 < percentage;
 }
+/**
+* Evaluate tail sampling conditions to determine if a log should be force-kept.
+* Returns true if ANY condition matches (OR logic).
+*/
 function shouldKeep(ctx) {
-  const { keep } = globalSampling;
-  if (!keep?.length) return false;
-  return keep.some((condition) => {
-    if (condition.status !== void 0 && ctx.status !== void 0 && ctx.status >= condition.status) {
-      return true;
-    }
-    if (condition.duration !== void 0 && ctx.duration !== void 0 && ctx.duration >= condition.duration) {
-      return true;
-    }
-    if (condition.path && ctx.path && matchesPattern(ctx.path, condition.path)) {
-      return true;
-    }
-    return false;
-  });
+	const { keep } = globalSampling;
+	if (!keep?.length) return false;
+	return keep.some((condition) => {
+		if (condition.status !== void 0 && ctx.status !== void 0 && ctx.status >= condition.status) return true;
+		if (condition.duration !== void 0 && ctx.duration !== void 0 && ctx.duration >= condition.duration) return true;
+		if (condition.path && ctx.path && matchesPattern(ctx.path, condition.path)) return true;
+		return false;
+	});
 }
 function emitWideEvent(level, event, skipSamplingCheck = false) {
-  if (!skipSamplingCheck && !shouldSample(level)) {
-    return null;
-  }
-  const formatted = {
-    timestamp: (/* @__PURE__ */ new Date()).toISOString(),
-    level,
-    ...globalEnv,
-    ...event
-  };
-  if (globalPretty) {
-    prettyPrintWideEvent(formatted);
-  } else if (globalStringify) {
-    console[getConsoleMethod(level)](JSON.stringify(formatted));
-  } else {
-    console[getConsoleMethod(level)](formatted);
-  }
-  return formatted;
+	if (!skipSamplingCheck && !shouldSample(level)) return null;
+	const formatted = {
+		timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+		level,
+		...globalEnv,
+		...event
+	};
+	if (globalPretty) prettyPrintWideEvent(formatted);
+	else if (globalStringify) console[getConsoleMethod(level)](JSON.stringify(formatted));
+	else console[getConsoleMethod(level)](formatted);
+	if (globalDrain) Promise.resolve(globalDrain({ event: formatted })).catch((err) => {
+		console.error("[evlog] drain failed:", err);
+	});
+	return formatted;
 }
 function emitTaggedLog(level, tag, message) {
-  if (globalPretty) {
-    if (!shouldSample(level)) {
-      return;
-    }
-    const color = getLevelColor(level);
-    const timestamp = (/* @__PURE__ */ new Date()).toISOString().slice(11, 23);
-    console.log(`${colors.dim}${timestamp}${colors.reset} ${color}[${tag}]${colors.reset} ${message}`);
-    return;
-  }
-  emitWideEvent(level, { tag, message });
+	if (globalPretty) {
+		if (!shouldSample(level)) return;
+		const color = getLevelColor(level);
+		const timestamp = (/* @__PURE__ */ new Date()).toISOString().slice(11, 23);
+		console.log(`${colors.dim}${timestamp}${colors.reset} ${color}[${tag}]${colors.reset} ${message}`);
+		return;
+	}
+	emitWideEvent(level, {
+		tag,
+		message
+	});
 }
 function formatValue(value) {
-  if (value === null || value === void 0) {
-    return String(value);
-  }
-  if (typeof value === "object") {
-    const pairs = [];
-    for (const [k, v] of Object.entries(value)) {
-      if (v !== void 0 && v !== null) {
-        if (typeof v === "object") {
-          pairs.push(`${k}=${JSON.stringify(v)}`);
-        } else {
-          pairs.push(`${k}=${v}`);
-        }
-      }
-    }
-    return pairs.join(" ");
-  }
-  return String(value);
+	if (value === null || value === void 0) return String(value);
+	if (typeof value === "object") {
+		const pairs = [];
+		for (const [k, v] of Object.entries(value)) if (v !== void 0 && v !== null) if (typeof v === "object") pairs.push(`${k}=${JSON.stringify(v)}`);
+		else pairs.push(`${k}=${v}`);
+		return pairs.join(" ");
+	}
+	return String(value);
 }
 function prettyPrintWideEvent(event) {
-  const { timestamp, level, service, environment, version, ...rest } = event;
-  const levelColor = getLevelColor(level);
-  const ts = timestamp.slice(11, 23);
-  let header = `${colors.dim}${ts}${colors.reset} ${levelColor}${level.toUpperCase()}${colors.reset}`;
-  header += ` ${colors.cyan}[${service}]${colors.reset}`;
-  if (rest.method && rest.path) {
-    header += ` ${rest.method} ${rest.path}`;
-    delete rest.method;
-    delete rest.path;
-  }
-  if (rest.status) {
-    const statusColor = rest.status >= 400 ? colors.red : colors.green;
-    header += ` ${statusColor}${rest.status}${colors.reset}`;
-    delete rest.status;
-  }
-  if (rest.duration) {
-    header += ` ${colors.dim}in ${rest.duration}${colors.reset}`;
-    delete rest.duration;
-  }
-  console.log(header);
-  const entries = Object.entries(rest).filter(([_, v]) => v !== void 0);
-  const lastIndex = entries.length - 1;
-  entries.forEach(([key, value], index) => {
-    const isLast = index === lastIndex;
-    const prefix = isLast ? "\u2514\u2500" : "\u251C\u2500";
-    const formatted = formatValue(value);
-    console.log(`  ${colors.dim}${prefix}${colors.reset} ${colors.cyan}${key}:${colors.reset} ${formatted}`);
-  });
+	const { timestamp, level, service, environment, version, ...rest } = event;
+	const levelColor = getLevelColor(level);
+	const ts = timestamp.slice(11, 23);
+	let header = `${colors.dim}${ts}${colors.reset} ${levelColor}${level.toUpperCase()}${colors.reset}`;
+	header += ` ${colors.cyan}[${service}]${colors.reset}`;
+	if (rest.method && rest.path) {
+		header += ` ${rest.method} ${rest.path}`;
+		delete rest.method;
+		delete rest.path;
+	}
+	if (rest.status) {
+		const statusColor = rest.status >= 400 ? colors.red : colors.green;
+		header += ` ${statusColor}${rest.status}${colors.reset}`;
+		delete rest.status;
+	}
+	if (rest.duration) {
+		header += ` ${colors.dim}in ${rest.duration}${colors.reset}`;
+		delete rest.duration;
+	}
+	console.log(header);
+	const entries = Object.entries(rest).filter(([_, v]) => v !== void 0);
+	const lastIndex = entries.length - 1;
+	entries.forEach(([key, value], index) => {
+		const prefix = index === lastIndex ? "└─" : "├─";
+		const formatted = formatValue(value);
+		console.log(`  ${colors.dim}${prefix}${colors.reset} ${colors.cyan}${key}:${colors.reset} ${formatted}`);
+	});
 }
 function createLogMethod(level) {
-  return function logMethod(tagOrEvent, message) {
-    if (typeof tagOrEvent === "string" && message !== void 0) {
-      emitTaggedLog(level, tagOrEvent, message);
-    } else if (typeof tagOrEvent === "object") {
-      emitWideEvent(level, tagOrEvent);
-    } else {
-      emitTaggedLog(level, "log", String(tagOrEvent));
-    }
-  };
+	return function logMethod(tagOrEvent, message) {
+		if (typeof tagOrEvent === "string" && message !== void 0) emitTaggedLog(level, tagOrEvent, message);
+		else if (typeof tagOrEvent === "object") emitWideEvent(level, tagOrEvent);
+		else emitTaggedLog(level, "log", String(tagOrEvent));
+	};
 }
+/**
+* Simple logging API - as easy as console.log
+*
+* @example
+* ```ts
+* log.info('auth', 'User logged in')
+* log.error({ action: 'payment', error: 'failed' })
+* ```
+*/
 const log = {
-  info: createLogMethod("info"),
-  error: createLogMethod("error"),
-  warn: createLogMethod("warn"),
-  debug: createLogMethod("debug")
+	info: createLogMethod("info"),
+	error: createLogMethod("error"),
+	warn: createLogMethod("warn"),
+	debug: createLogMethod("debug")
 };
+/**
+* Create a request-scoped logger for building wide events.
+*
+* @example
+* ```ts
+* const log = createRequestLogger({ method: 'POST', path: '/checkout' })
+* log.set({ user: { id: '123' } })
+* log.set({ cart: { items: 3 } })
+* log.emit()
+* ```
+*/
 function createRequestLogger(options = {}) {
-  const startTime = Date.now();
-  let context = {
-    method: options.method,
-    path: options.path,
-    requestId: options.requestId
-  };
-  let hasError = false;
-  return {
-    set(data) {
-      context = defu(data, context);
-    },
-    error(error, errorContext) {
-      hasError = true;
-      const err = typeof error === "string" ? new Error(error) : error;
-      const errorData = {
-        ...errorContext,
-        error: {
-          name: err.name,
-          message: err.message,
-          stack: err.stack
-        }
-      };
-      context = defu(errorData, context);
-    },
-    emit(overrides) {
-      const durationMs = Date.now() - startTime;
-      const duration = formatDuration(durationMs);
-      const level = hasError ? "error" : "info";
-      const { _forceKeep, ...restOverrides } = overrides ?? {};
-      const tailCtx = {
-        status: context.status ?? restOverrides.status,
-        duration: durationMs,
-        path: context.path,
-        method: context.method,
-        context: { ...context, ...restOverrides }
-      };
-      const forceKeep = _forceKeep || shouldKeep(tailCtx);
-      if (!forceKeep && !shouldSample(level)) {
-        return null;
-      }
-      return emitWideEvent(level, {
-        ...context,
-        ...restOverrides,
-        duration
-      }, true);
-    },
-    getContext() {
-      return { ...context };
-    }
-  };
+	const startTime = Date.now();
+	let context = {
+		method: options.method,
+		path: options.path,
+		requestId: options.requestId
+	};
+	let hasError = false;
+	return {
+		set(data) {
+			context = deepDefaults(data, context);
+		},
+		error(error, errorContext) {
+			hasError = true;
+			const err = typeof error === "string" ? new Error(error) : error;
+			context = deepDefaults({
+				...errorContext,
+				error: {
+					name: err.name,
+					message: err.message,
+					stack: err.stack,
+					..."statusCode" in err && { statusCode: err.statusCode },
+					..."statusMessage" in err && { statusMessage: err.statusMessage },
+					..."data" in err && { data: err.data },
+					..."cause" in err && { cause: err.cause }
+				}
+			}, context);
+		},
+		emit(overrides) {
+			const durationMs = Date.now() - startTime;
+			const duration = formatDuration(durationMs);
+			const level = hasError ? "error" : "info";
+			const { _forceKeep, ...restOverrides } = overrides ?? {};
+			const tailCtx = {
+				status: context.status ?? restOverrides.status,
+				duration: durationMs,
+				path: context.path,
+				method: context.method,
+				context: {
+					...context,
+					...restOverrides
+				}
+			};
+			if (!(_forceKeep || shouldKeep(tailCtx)) && !shouldSample(level)) return null;
+			return emitWideEvent(level, {
+				...context,
+				...restOverrides,
+				duration
+			}, true);
+		},
+		getContext() {
+			return { ...context };
+		}
+	};
 }
+/**
+* Get the current environment context.
+*/
 function getEnvironment() {
-  return { ...globalEnv };
+	return { ...globalEnv };
 }
 
+//#endregion
 export { createRequestLogger, getEnvironment, initLogger, log, shouldKeep };
+//# sourceMappingURL=logger.mjs.map

package/dist/logger.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.mjs","names":[],"sources":["../src/logger.ts"],"sourcesContent":["import type { DrainContext, EnvironmentContext, FieldContext, Log, LogLevel, LoggerConfig, RequestLogger, RequestLoggerOptions, SamplingConfig, TailSamplingContext, WideEvent } from './types'\nimport { colors, detectEnvironment, formatDuration, getConsoleMethod, getLevelColor, isDev, matchesPattern } from './utils'\n\nfunction isPlainObject(val: unknown): val is Record<string, unknown> {\n  return val !== null && typeof val === 'object' && !Array.isArray(val)\n}\n\nfunction deepDefaults(base: Record<string, unknown>, defaults: Record<string, unknown>): Record<string, unknown> {\n  const result = { ...base }\n  for (const key in defaults) {\n    const baseVal = result[key]\n    const defaultVal = defaults[key]\n    if (baseVal === undefined || baseVal === null) {\n      result[key] = defaultVal\n    } else if (isPlainObject(baseVal) && isPlainObject(defaultVal)) {\n      result[key] = deepDefaults(baseVal, defaultVal)\n    }\n  }\n  return result\n}\n\nlet globalEnv: EnvironmentContext = {\n  service: 'app',\n  environment: 'development',\n}\n\nlet globalPretty = isDev()\nlet globalSampling: SamplingConfig = {}\nlet globalStringify = true\nlet globalDrain: ((ctx: DrainContext) => void | Promise<void>) | undefined\n\n/**\n * Initialize the logger with configuration.\n * Call this once at application startup.\n */\nexport function initLogger(config: LoggerConfig = {}): void {\n  const detected = detectEnvironment()\n\n  globalEnv = {\n    service: config.env?.service ?? detected.service ?? 'app',\n    environment: config.env?.environment ?? detected.environment ?? 'development',\n    version: config.env?.version ?? detected.version,\n    commitHash: config.env?.commitHash ?? detected.commitHash,\n    region: config.env?.region ?? detected.region,\n  }\n\n  globalPretty = config.pretty ?? isDev()\n  globalSampling = config.sampling ?? {}\n  globalStringify = config.stringify ?? true\n  globalDrain = config.drain\n}\n\n/**\n * Determine if a log at the given level should be emitted based on sampling config.\n * Error level defaults to 100% (always logged) unless explicitly configured otherwise.\n */\nfunction shouldSample(level: LogLevel): boolean {\n  const { rates } = globalSampling\n  if (!rates) {\n    return true // No sampling configured, log everything\n  }\n\n  // Error defaults to 100% unless explicitly set\n  const percentage = level === 'error' && rates.error === undefined\n    ? 100\n    : rates[level] ?? 100\n\n  // 0% = never log, 100% = always log\n  if (percentage <= 0) return false\n  if (percentage >= 100) return true\n\n  return Math.random() * 100 < percentage\n}\n\n/**\n * Evaluate tail sampling conditions to determine if a log should be force-kept.\n * Returns true if ANY condition matches (OR logic).\n */\nexport function shouldKeep(ctx: TailSamplingContext): boolean {\n  const { keep } = globalSampling\n  if (!keep?.length) return false\n\n  return keep.some((condition) => {\n    if (condition.status !== undefined && ctx.status !== undefined && ctx.status >= condition.status) {\n      return true\n    }\n    if (condition.duration !== undefined && ctx.duration !== undefined && ctx.duration >= condition.duration) {\n      return true\n    }\n    if (condition.path && ctx.path && matchesPattern(ctx.path, condition.path)) {\n      return true\n    }\n    return false\n  })\n}\n\nfunction emitWideEvent(level: LogLevel, event: Record<string, unknown>, skipSamplingCheck = false): WideEvent | null {\n  if (!skipSamplingCheck && !shouldSample(level)) {\n    return null\n  }\n\n  const formatted: WideEvent = {\n    timestamp: new Date().toISOString(),\n    level,\n    ...globalEnv,\n    ...event,\n  }\n\n  if (globalPretty) {\n    prettyPrintWideEvent(formatted)\n  } else if (globalStringify) {\n    console[getConsoleMethod(level)](JSON.stringify(formatted))\n  } else {\n    console[getConsoleMethod(level)](formatted)\n  }\n\n  if (globalDrain) {\n    Promise.resolve(globalDrain({ event: formatted })).catch((err) => {\n      console.error('[evlog] drain failed:', err)\n    })\n  }\n\n  return formatted\n}\n\nfunction emitTaggedLog(level: LogLevel, tag: string, message: string): void {\n  if (globalPretty) {\n    if (!shouldSample(level)) {\n      return\n    }\n    const color = getLevelColor(level)\n    const timestamp = new Date().toISOString().slice(11, 23)\n    console.log(`${colors.dim}${timestamp}${colors.reset} ${color}[${tag}]${colors.reset} ${message}`)\n    return\n  }\n  emitWideEvent(level, { tag, message })\n}\n\nfunction formatValue(value: unknown): string {\n  if (value === null || value === undefined) {\n    return String(value)\n  }\n  if (typeof value === 'object') {\n    // Flatten object to key=value pairs\n    const pairs: string[] = []\n    for (const [k, v] of Object.entries(value as Record<string, unknown>)) {\n      if (v !== undefined && v !== null) {\n        if (typeof v === 'object') {\n          // For nested objects, show as JSON\n          pairs.push(`${k}=${JSON.stringify(v)}`)\n        } else {\n          pairs.push(`${k}=${v}`)\n        }\n      }\n    }\n    return pairs.join(' ')\n  }\n  return String(value)\n}\n\nfunction prettyPrintWideEvent(event: Record<string, unknown>): void {\n  const { timestamp, level, service, environment, version, ...rest } = event\n  const levelColor = getLevelColor(level as string)\n  const ts = (timestamp as string).slice(11, 23)\n\n  let header = `${colors.dim}${ts}${colors.reset} ${levelColor}${(level as string).toUpperCase()}${colors.reset}`\n  header += ` ${colors.cyan}[${service}]${colors.reset}`\n\n  if (rest.method && rest.path) {\n    header += ` ${rest.method} ${rest.path}`\n    delete rest.method\n    delete rest.path\n  }\n\n  if (rest.status) {\n    const statusColor = (rest.status as number) >= 400 ? colors.red : colors.green\n    header += ` ${statusColor}${rest.status}${colors.reset}`\n    delete rest.status\n  }\n\n  if (rest.duration) {\n    header += ` ${colors.dim}in ${rest.duration}${colors.reset}`\n    delete rest.duration\n  }\n\n  console.log(header)\n\n  const entries = Object.entries(rest).filter(([_, v]) => v !== undefined)\n  const lastIndex = entries.length - 1\n\n  entries.forEach(([key, value], index) => {\n    const isLast = index === lastIndex\n    const prefix = isLast ? '└─' : '├─'\n    const formatted = formatValue(value)\n    console.log(`  ${colors.dim}${prefix}${colors.reset} ${colors.cyan}${key}:${colors.reset} ${formatted}`)\n  })\n}\n\nfunction createLogMethod(level: LogLevel) {\n  return function logMethod(tagOrEvent: string | Record<string, unknown>, message?: string): void {\n    if (typeof tagOrEvent === 'string' && message !== undefined) {\n      emitTaggedLog(level, tagOrEvent, message)\n    } else if (typeof tagOrEvent === 'object') {\n      emitWideEvent(level, tagOrEvent)\n    } else {\n      emitTaggedLog(level, 'log', String(tagOrEvent))\n    }\n  }\n}\n\n/**\n * Simple logging API - as easy as console.log\n *\n * @example\n * ```ts\n * log.info('auth', 'User logged in')\n * log.error({ action: 'payment', error: 'failed' })\n * ```\n */\nexport const log: Log = {\n  info: createLogMethod('info'),\n  error: createLogMethod('error'),\n  warn: createLogMethod('warn'),\n  debug: createLogMethod('debug'),\n}\n\n/**\n * Create a request-scoped logger for building wide events.\n *\n * @example\n * ```ts\n * const log = createRequestLogger({ method: 'POST', path: '/checkout' })\n * log.set({ user: { id: '123' } })\n * log.set({ cart: { items: 3 } })\n * log.emit()\n * ```\n */\nexport function createRequestLogger<T extends object = Record<string, unknown>>(options: RequestLoggerOptions = {}): RequestLogger<T> {\n  const startTime = Date.now()\n  let context: Record<string, unknown> = {\n    method: options.method,\n    path: options.path,\n    requestId: options.requestId,\n  }\n  let hasError = false\n\n  return {\n    set(data: FieldContext<T>): void {\n      context = deepDefaults(data as Record<string, unknown>, context) as Record<string, unknown>\n    },\n\n    error(error: Error | string, errorContext?: FieldContext<T>): void {\n      hasError = true\n      const err = typeof error === 'string' ? new Error(error) : error\n\n      const errorData = {\n        ...(errorContext as Record<string, unknown>),\n        error: {\n          name: err.name,\n          message: err.message,\n          stack: err.stack,\n          ...('statusCode' in err && { statusCode: (err as Record<string, unknown>).statusCode }),\n          ...('statusMessage' in err && { statusMessage: (err as Record<string, unknown>).statusMessage }),\n          ...('data' in err && { data: (err as Record<string, unknown>).data }),\n          ...('cause' in err && { cause: (err as unknown as Record<string, unknown>).cause }),\n        },\n      }\n      context = deepDefaults(errorData, context) as Record<string, unknown>\n    },\n\n    emit(overrides?: FieldContext<T> & { _forceKeep?: boolean }): WideEvent | null {\n      const durationMs = Date.now() - startTime\n      const duration = formatDuration(durationMs)\n      const level: LogLevel = hasError ? 'error' : 'info'\n\n      // Extract _forceKeep from overrides (set by evlog:emit:keep hook)\n      const { _forceKeep, ...restOverrides } = (overrides ?? {}) as Record<string, unknown> & { _forceKeep?: boolean }\n\n      // Build tail sampling context\n      const tailCtx: TailSamplingContext = {\n        status: (context.status ?? restOverrides.status) as number | undefined,\n        duration: durationMs,\n        path: context.path as string | undefined,\n        method: context.method as string | undefined,\n        context: { ...context, ...restOverrides },\n      }\n\n      // Tail sampling: force keep if hook or built-in conditions match\n      const forceKeep = _forceKeep || shouldKeep(tailCtx)\n\n      // Apply head sampling only if not force-kept\n      if (!forceKeep && !shouldSample(level)) {\n        return null\n      }\n\n      return emitWideEvent(level, {\n        ...context,\n        ...restOverrides,\n        duration,\n      }, true)\n    },\n\n    getContext(): FieldContext<T> & Record<string, unknown> {\n      return { ...context }\n    },\n  }\n}\n\n/**\n * Get the current environment context.\n */\nexport function getEnvironment(): EnvironmentContext {\n  return { ...globalEnv }\n}\n"],"mappings":";;;AAGA,SAAS,cAAc,KAA8C;AACnE,QAAO,QAAQ,QAAQ,OAAO,QAAQ,YAAY,CAAC,MAAM,QAAQ,IAAI;;AAGvE,SAAS,aAAa,MAA+B,UAA4D;CAC/G,MAAM,SAAS,EAAE,GAAG,MAAM;AAC1B,MAAK,MAAM,OAAO,UAAU;EAC1B,MAAM,UAAU,OAAO;EACvB,MAAM,aAAa,SAAS;AAC5B,MAAI,YAAY,UAAa,YAAY,KACvC,QAAO,OAAO;WACL,cAAc,QAAQ,IAAI,cAAc,WAAW,CAC5D,QAAO,OAAO,aAAa,SAAS,WAAW;;AAGnD,QAAO;;AAGT,IAAI,YAAgC;CAClC,SAAS;CACT,aAAa;CACd;AAED,IAAI,eAAe,OAAO;AAC1B,IAAI,iBAAiC,EAAE;AACvC,IAAI,kBAAkB;AACtB,IAAI;;;;;AAMJ,SAAgB,WAAW,SAAuB,EAAE,EAAQ;CAC1D,MAAM,WAAW,mBAAmB;AAEpC,aAAY;EACV,SAAS,OAAO,KAAK,WAAW,SAAS,WAAW;EACpD,aAAa,OAAO,KAAK,eAAe,SAAS,eAAe;EAChE,SAAS,OAAO,KAAK,WAAW,SAAS;EACzC,YAAY,OAAO,KAAK,cAAc,SAAS;EAC/C,QAAQ,OAAO,KAAK,UAAU,SAAS;EACxC;AAED,gBAAe,OAAO,UAAU,OAAO;AACvC,kBAAiB,OAAO,YAAY,EAAE;AACtC,mBAAkB,OAAO,aAAa;AACtC,eAAc,OAAO;;;;;;AAOvB,SAAS,aAAa,OAA0B;CAC9C,MAAM,EAAE,UAAU;AAClB,KAAI,CAAC,MACH,QAAO;CAIT,MAAM,aAAa,UAAU,WAAW,MAAM,UAAU,SACpD,MACA,MAAM,UAAU;AAGpB,KAAI,cAAc,EAAG,QAAO;AAC5B,KAAI,cAAc,IAAK,QAAO;AAE9B,QAAO,KAAK,QAAQ,GAAG,MAAM;;;;;;AAO/B,SAAgB,WAAW,KAAmC;CAC5D,MAAM,EAAE,SAAS;AACjB,KAAI,CAAC,MAAM,OAAQ,QAAO;AAE1B,QAAO,KAAK,MAAM,cAAc;AAC9B,MAAI,UAAU,WAAW,UAAa,IAAI,WAAW,UAAa,IAAI,UAAU,UAAU,OACxF,QAAO;AAET,MAAI,UAAU,aAAa,UAAa,IAAI,aAAa,UAAa,IAAI,YAAY,UAAU,SAC9F,QAAO;AAET,MAAI,UAAU,QAAQ,IAAI,QAAQ,eAAe,IAAI,MAAM,UAAU,KAAK,CACxE,QAAO;AAET,SAAO;GACP;;AAGJ,SAAS,cAAc,OAAiB,OAAgC,oBAAoB,OAAyB;AACnH,KAAI,CAAC,qBAAqB,CAAC,aAAa,MAAM,CAC5C,QAAO;CAGT,MAAM,YAAuB;EAC3B,4BAAW,IAAI,MAAM,EAAC,aAAa;EACnC;EACA,GAAG;EACH,GAAG;EACJ;AAED,KAAI,aACF,sBAAqB,UAAU;UACtB,gBACT,SAAQ,iBAAiB,MAAM,EAAE,KAAK,UAAU,UAAU,CAAC;KAE3D,SAAQ,iBAAiB,MAAM,EAAE,UAAU;AAG7C,KAAI,YACF,SAAQ,QAAQ,YAAY,EAAE,OAAO,WAAW,CAAC,CAAC,CAAC,OAAO,QAAQ;AAChE,UAAQ,MAAM,yBAAyB,IAAI;GAC3C;AAGJ,QAAO;;AAGT,SAAS,cAAc,OAAiB,KAAa,SAAuB;AAC1E,KAAI,cAAc;AAChB,MAAI,CAAC,aAAa,MAAM,CACtB;EAEF,MAAM,QAAQ,cAAc,MAAM;EAClC,MAAM,6BAAY,IAAI,MAAM,EAAC,aAAa,CAAC,MAAM,IAAI,GAAG;AACxD,UAAQ,IAAI,GAAG,OAAO,MAAM,YAAY,OAAO,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,OAAO,MAAM,GAAG,UAAU;AAClG;;AAEF,eAAc,OAAO;EAAE;EAAK;EAAS,CAAC;;AAGxC,SAAS,YAAY,OAAwB;AAC3C,KAAI,UAAU,QAAQ,UAAU,OAC9B,QAAO,OAAO,MAAM;AAEtB,KAAI,OAAO,UAAU,UAAU;EAE7B,MAAM,QAAkB,EAAE;AAC1B,OAAK,MAAM,CAAC,GAAG,MAAM,OAAO,QAAQ,MAAiC,CACnE,KAAI,MAAM,UAAa,MAAM,KAC3B,KAAI,OAAO,MAAM,SAEf,OAAM,KAAK,GAAG,EAAE,GAAG,KAAK,UAAU,EAAE,GAAG;MAEvC,OAAM,KAAK,GAAG,EAAE,GAAG,IAAI;AAI7B,SAAO,MAAM,KAAK,IAAI;;AAExB,QAAO,OAAO,MAAM;;AAGtB,SAAS,qBAAqB,OAAsC;CAClE,MAAM,EAAE,WAAW,OAAO,SAAS,aAAa,SAAS,GAAG,SAAS;CACrE,MAAM,aAAa,cAAc,MAAgB;CACjD,MAAM,KAAM,UAAqB,MAAM,IAAI,GAAG;CAE9C,IAAI,SAAS,GAAG,OAAO,MAAM,KAAK,OAAO,MAAM,GAAG,aAAc,MAAiB,aAAa,GAAG,OAAO;AACxG,WAAU,IAAI,OAAO,KAAK,GAAG,QAAQ,GAAG,OAAO;AAE/C,KAAI,KAAK,UAAU,KAAK,MAAM;AAC5B,YAAU,IAAI,KAAK,OAAO,GAAG,KAAK;AAClC,SAAO,KAAK;AACZ,SAAO,KAAK;;AAGd,KAAI,KAAK,QAAQ;EACf,MAAM,cAAe,KAAK,UAAqB,MAAM,OAAO,MAAM,OAAO;AACzE,YAAU,IAAI,cAAc,KAAK,SAAS,OAAO;AACjD,SAAO,KAAK;;AAGd,KAAI,KAAK,UAAU;AACjB,YAAU,IAAI,OAAO,IAAI,KAAK,KAAK,WAAW,OAAO;AACrD,SAAO,KAAK;;AAGd,SAAQ,IAAI,OAAO;CAEnB,MAAM,UAAU,OAAO,QAAQ,KAAK,CAAC,QAAQ,CAAC,GAAG,OAAO,MAAM,OAAU;CACxE,MAAM,YAAY,QAAQ,SAAS;AAEnC,SAAQ,SAAS,CAAC,KAAK,QAAQ,UAAU;EAEvC,MAAM,SADS,UAAU,YACD,OAAO;EAC/B,MAAM,YAAY,YAAY,MAAM;AACpC,UAAQ,IAAI,KAAK,OAAO,MAAM,SAAS,OAAO,MAAM,GAAG,OAAO,OAAO,IAAI,GAAG,OAAO,MAAM,GAAG,YAAY;GACxG;;AAGJ,SAAS,gBAAgB,OAAiB;AACxC,QAAO,SAAS,UAAU,YAA8C,SAAwB;AAC9F,MAAI,OAAO,eAAe,YAAY,YAAY,OAChD,eAAc,OAAO,YAAY,QAAQ;WAChC,OAAO,eAAe,SAC/B,eAAc,OAAO,WAAW;MAEhC,eAAc,OAAO,OAAO,OAAO,WAAW,CAAC;;;;;;;;;;;;AAcrD,MAAa,MAAW;CACtB,MAAM,gBAAgB,OAAO;CAC7B,OAAO,gBAAgB,QAAQ;CAC/B,MAAM,gBAAgB,OAAO;CAC7B,OAAO,gBAAgB,QAAQ;CAChC;;;;;;;;;;;;AAaD,SAAgB,oBAAgE,UAAgC,EAAE,EAAoB;CACpI,MAAM,YAAY,KAAK,KAAK;CAC5B,IAAI,UAAmC;EACrC,QAAQ,QAAQ;EAChB,MAAM,QAAQ;EACd,WAAW,QAAQ;EACpB;CACD,IAAI,WAAW;AAEf,QAAO;EACL,IAAI,MAA6B;AAC/B,aAAU,aAAa,MAAiC,QAAQ;;EAGlE,MAAM,OAAuB,cAAsC;AACjE,cAAW;GACX,MAAM,MAAM,OAAO,UAAU,WAAW,IAAI,MAAM,MAAM,GAAG;AAc3D,aAAU,aAZQ;IAChB,GAAI;IACJ,OAAO;KACL,MAAM,IAAI;KACV,SAAS,IAAI;KACb,OAAO,IAAI;KACX,GAAI,gBAAgB,OAAO,EAAE,YAAa,IAAgC,YAAY;KACtF,GAAI,mBAAmB,OAAO,EAAE,eAAgB,IAAgC,eAAe;KAC/F,GAAI,UAAU,OAAO,EAAE,MAAO,IAAgC,MAAM;KACpE,GAAI,WAAW,OAAO,EAAE,OAAQ,IAA2C,OAAO;KACnF;IACF,EACiC,QAAQ;;EAG5C,KAAK,WAA0E;GAC7E,MAAM,aAAa,KAAK,KAAK,GAAG;GAChC,MAAM,WAAW,eAAe,WAAW;GAC3C,MAAM,QAAkB,WAAW,UAAU;GAG7C,MAAM,EAAE,YAAY,GAAG,kBAAmB,aAAa,EAAE;GAGzD,MAAM,UAA+B;IACnC,QAAS,QAAQ,UAAU,cAAc;IACzC,UAAU;IACV,MAAM,QAAQ;IACd,QAAQ,QAAQ;IAChB,SAAS;KAAE,GAAG;KAAS,GAAG;KAAe;IAC1C;AAMD,OAAI,EAHc,cAAc,WAAW,QAAQ,KAGjC,CAAC,aAAa,MAAM,CACpC,QAAO;AAGT,UAAO,cAAc,OAAO;IAC1B,GAAG;IACH,GAAG;IACH;IACD,EAAE,KAAK;;EAGV,aAAwD;AACtD,UAAO,EAAE,GAAG,SAAS;;EAExB;;;;;AAMH,SAAgB,iBAAqC;AACnD,QAAO,EAAE,GAAG,WAAW"}

package/dist/nitro/errorHandler.d.mts

@@ -1,5 +1,6 @@
-import * as nitropack from 'nitropack';
+import * as nitropack from "nitropack";
 
+//#region src/nitro/errorHandler.d.ts
 /**
  * Custom Nitro error handler that properly serializes EvlogError.
  * This ensures that 'data' (containing 'why', 'fix', 'link') is preserved
@@ -9,5 +10,6 @@ import * as nitropack from 'nitropack';
  * sanitizing internal error details in production for 5xx errors.
  */
 declare const _default: nitropack.NitroErrorHandler;
-
+//#endregion
 export { _default as default };
+//# sourceMappingURL=errorHandler.d.mts.map

package/dist/nitro/errorHandler.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errorHandler.d.mts","names":[],"sources":["../../src/nitro/errorHandler.ts"],"mappings":""}

package/dist/nitro/errorHandler.mjs

@@ -1,41 +1,52 @@
-import { defineNitroErrorHandler } from 'nitropack/runtime';
-import { getRequestURL, setResponseStatus, setResponseHeader, send } from 'h3';
+import { defineNitroErrorHandler } from "nitropack/runtime";
+import { getRequestURL, send, setResponseHeader, setResponseStatus } from "h3";
 
-const errorHandler = defineNitroErrorHandler((error, event) => {
-  const evlogError = error.name === "EvlogError" ? error : error.cause?.name === "EvlogError" ? error.cause : null;
-  const isDev = process.env.NODE_ENV === "development";
-  const url = getRequestURL(event, { xForwardedHost: true }).pathname;
-  if (!evlogError) {
-    const status2 = error.statusCode ?? error.status ?? 500;
-    const rawMessage = (error.statusText ?? error.statusMessage ?? error.message) || "Internal Server Error";
-    const message = isDev ? rawMessage : status2 >= 500 ? "Internal Server Error" : rawMessage;
-    setResponseStatus(event, status2);
-    setResponseHeader(event, "Content-Type", "application/json");
-    return send(event, JSON.stringify({
-      url,
-      status: status2,
-      statusCode: status2,
-      statusText: message,
-      statusMessage: message,
-      message,
-      error: true
-    }));
-  }
-  const status = evlogError.status ?? evlogError.statusCode ?? 500;
-  setResponseStatus(event, status);
-  setResponseHeader(event, "Content-Type", "application/json");
-  const { data } = evlogError;
-  const statusMessage = evlogError.statusMessage || evlogError.message;
-  return send(event, JSON.stringify({
-    url,
-    status,
-    statusCode: status,
-    statusText: statusMessage,
-    statusMessage,
-    message: evlogError.message,
-    error: true,
-    ...data !== void 0 && { data }
-  }));
+//#region src/nitro/errorHandler.ts
+/**
+* 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.
+*
+* For non-EvlogError, it preserves Nitro's default response shape while
+* sanitizing internal error details in production for 5xx errors.
+*/
+var errorHandler_default = defineNitroErrorHandler((error, event) => {
+	const evlogError = error.name === "EvlogError" ? error : error.cause?.name === "EvlogError" ? error.cause : null;
+	const isDev = process.env.NODE_ENV === "development";
+	const url = getRequestURL(event, { xForwardedHost: true }).pathname;
+	if (!evlogError) {
+		const status = error.statusCode ?? error.status ?? 500;
+		const rawMessage = (error.statusText ?? error.statusMessage ?? error.message) || "Internal Server Error";
+		const message = isDev ? rawMessage : status >= 500 ? "Internal Server Error" : rawMessage;
+		setResponseStatus(event, status);
+		setResponseHeader(event, "Content-Type", "application/json");
+		return send(event, JSON.stringify({
+			url,
+			status,
+			statusCode: status,
+			statusText: message,
+			statusMessage: message,
+			message,
+			error: true
+		}));
+	}
+	const status = evlogError.status ?? evlogError.statusCode ?? 500;
+	setResponseStatus(event, status);
+	setResponseHeader(event, "Content-Type", "application/json");
+	const { data } = evlogError;
+	const statusMessage = evlogError.statusMessage || evlogError.message;
+	return send(event, JSON.stringify({
+		url,
+		status,
+		statusCode: status,
+		statusText: statusMessage,
+		statusMessage,
+		message: evlogError.message,
+		error: true,
+		...data !== void 0 && { data }
+	}));
 });
 
-export { errorHandler as default };
+//#endregion
+export { errorHandler_default as default };
+//# sourceMappingURL=errorHandler.mjs.map

package/dist/nitro/errorHandler.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"errorHandler.mjs","names":[],"sources":["../../src/nitro/errorHandler.ts"],"sourcesContent":["import { defineNitroErrorHandler } from 'nitropack/runtime'\nimport { getRequestURL, setResponseHeader, setResponseStatus, send } from 'h3'\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((error, event) => {\n  // Check if this is an EvlogError (by name or by checking cause)\n  const evlogError = error.name === 'EvlogError'\n    ? error\n    : (error.cause as Error)?.name === 'EvlogError'\n      ? error.cause as Error\n      : null\n\n  const isDev = process.env.NODE_ENV === 'development'\n  const url = getRequestURL(event, { xForwardedHost: true }).pathname\n\n  // For non-EvlogError, preserve Nitro's default response shape\n  if (!evlogError) {\n    const status = (error as { statusCode?: number }).statusCode\n      ?? (error as { status?: number }).status\n      ?? 500\n\n    // Derive message from statusText/statusMessage/message for cross-version compatibility\n    const rawMessage = ((error as { statusText?: string }).statusText\n      ?? (error as { statusMessage?: string }).statusMessage\n      ?? error.message) || 'Internal Server Error'\n\n    // Sanitize internal error details in production for 5xx errors\n    const message = isDev\n      ? rawMessage\n      : (status >= 500 ? 'Internal Server Error' : rawMessage)\n\n    setResponseStatus(event, status)\n    setResponseHeader(event, 'Content-Type', 'application/json')\n\n    // Preserve Nitro's default response shape with both legacy and modern fields\n    return send(event, JSON.stringify({\n      url,\n      status,\n      statusCode: status,\n      statusText: message,\n      statusMessage: message,\n      message,\n      error: true,\n    }))\n  }\n\n  // Derive status from evlogError to ensure consistency between\n  // HTTP response status and response body\n  const status = (evlogError as { status?: number }).status\n    ?? (evlogError as { statusCode?: number }).statusCode\n    ?? 500\n\n  setResponseStatus(event, status)\n  setResponseHeader(event, 'Content-Type', 'application/json')\n\n  // Serialize EvlogError with all its data, preserving Nitro's response shape\n  const { data } = evlogError as { data?: unknown }\n  const statusMessage = (evlogError as { statusMessage?: string }).statusMessage || evlogError.message\n  return send(event, JSON.stringify({\n    url,\n    status,\n    statusCode: status,\n    statusText: statusMessage,\n    statusMessage,\n    message: evlogError.message,\n    error: true,\n    ...(data !== undefined && { data }),\n  }))\n})\n"],"mappings":";;;;;;;;;;;;AAWA,2BAAe,yBAAyB,OAAO,UAAU;CAEvD,MAAM,aAAa,MAAM,SAAS,eAC9B,QACC,MAAM,OAAiB,SAAS,eAC/B,MAAM,QACN;CAEN,MAAM,QAAQ,QAAQ,IAAI,aAAa;CACvC,MAAM,MAAM,cAAc,OAAO,EAAE,gBAAgB,MAAM,CAAC,CAAC;AAG3D,KAAI,CAAC,YAAY;EACf,MAAM,SAAU,MAAkC,cAC5C,MAA8B,UAC/B;EAGL,MAAM,cAAe,MAAkC,cACjD,MAAqC,iBACtC,MAAM,YAAY;EAGvB,MAAM,UAAU,QACZ,aACC,UAAU,MAAM,0BAA0B;AAE/C,oBAAkB,OAAO,OAAO;AAChC,oBAAkB,OAAO,gBAAgB,mBAAmB;AAG5D,SAAO,KAAK,OAAO,KAAK,UAAU;GAChC;GACA;GACA,YAAY;GACZ,YAAY;GACZ,eAAe;GACf;GACA,OAAO;GACR,CAAC,CAAC;;CAKL,MAAM,SAAU,WAAmC,UAC7C,WAAuC,cACxC;AAEL,mBAAkB,OAAO,OAAO;AAChC,mBAAkB,OAAO,gBAAgB,mBAAmB;CAG5D,MAAM,EAAE,SAAS;CACjB,MAAM,gBAAiB,WAA0C,iBAAiB,WAAW;AAC7F,QAAO,KAAK,OAAO,KAAK,UAAU;EAChC;EACA;EACA,YAAY;EACZ,YAAY;EACZ;EACA,SAAS,WAAW;EACpB,OAAO;EACP,GAAI,SAAS,UAAa,EAAE,MAAM;EACnC,CAAC,CAAC;EACH"}

package/dist/nitro/plugin.d.mts

@@ -1,5 +1,7 @@
-import * as nitropack from 'nitropack';
+import * as nitropack from "nitropack";
 
+//#region src/nitro/plugin.d.ts
 declare const _default: nitropack.NitroAppPlugin;
-
+//#endregion
 export { _default as default };
+//# sourceMappingURL=plugin.d.mts.map

package/dist/nitro/plugin.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.mts","names":[],"sources":["../../src/nitro/plugin.ts"],"mappings":""}