evlog 1.6.0 → 1.8.0

package/dist/enrichers.mjs

@@ -0,0 +1,172 @@
+//#region src/enrichers/index.ts
+function getHeader(headers, name) {
+	if (!headers) return void 0;
+	if (headers[name] !== void 0) return headers[name];
+	const lowerName = name.toLowerCase();
+	if (headers[lowerName] !== void 0) return headers[lowerName];
+	for (const [key, value] of Object.entries(headers)) if (key.toLowerCase() === lowerName) return value;
+}
+function parseUserAgent(ua) {
+	const lower = ua.toLowerCase();
+	let deviceType = { type: "unknown" };
+	if (/bot|crawl|spider|slurp|bingpreview/.test(lower)) deviceType = { type: "bot" };
+	else if (/ipad|tablet/.test(lower)) deviceType = { type: "tablet" };
+	else if (/mobi|iphone|android/.test(lower)) deviceType = { type: "mobile" };
+	else if (ua.length > 0) deviceType = { type: "desktop" };
+	const browserMatchers = [
+		{
+			name: "Edge",
+			regex: /edg\/([\d.]+)/i
+		},
+		{
+			name: "Chrome",
+			regex: /chrome\/([\d.]+)/i
+		},
+		{
+			name: "Firefox",
+			regex: /firefox\/([\d.]+)/i
+		},
+		{
+			name: "Safari",
+			regex: /version\/([\d.]+).*safari/i
+		}
+	];
+	let browser;
+	for (const matcher of browserMatchers) {
+		const match = ua.match(matcher.regex);
+		if (match) {
+			browser = {
+				name: matcher.name,
+				version: match[1]
+			};
+			break;
+		}
+	}
+	let os;
+	if (/windows nt/i.test(ua)) os = {
+		name: "Windows",
+		version: ua.match(/windows nt ([\d.]+)/i)?.[1]
+	};
+	else if (/mac os x/i.test(ua) && !/iphone|ipad|ipod/i.test(ua)) os = {
+		name: "macOS",
+		version: ua.match(/mac os x ([\d_]+)/i)?.[1]?.replace(/_/g, ".")
+	};
+	else if (/iphone|ipad|ipod/i.test(ua)) os = {
+		name: "iOS",
+		version: ua.match(/os ([\d_]+)/i)?.[1]?.replace(/_/g, ".")
+	};
+	else if (/android/i.test(ua)) os = {
+		name: "Android",
+		version: ua.match(/android ([\d.]+)/i)?.[1]
+	};
+	else if (/linux/i.test(ua)) os = { name: "Linux" };
+	return {
+		raw: ua,
+		browser,
+		os,
+		device: deviceType
+	};
+}
+function parseTraceparent(traceparent) {
+	const match = traceparent.match(/^[\da-f]{2}-([\da-f]{32})-([\da-f]{16})-[\da-f]{2}$/i);
+	if (!match) return void 0;
+	return {
+		traceId: match[1],
+		spanId: match[2]
+	};
+}
+function mergeEventField(existing, computed, overwrite) {
+	if (overwrite || existing === void 0 || existing === null || typeof existing !== "object") return computed;
+	return {
+		...computed,
+		...existing
+	};
+}
+function normalizeNumber(value) {
+	if (!value) return void 0;
+	const parsed = Number(value);
+	return Number.isFinite(parsed) ? parsed : void 0;
+}
+/**
+* Enrich events with parsed user agent data.
+* Sets `event.userAgent` with `UserAgentInfo` shape: `{ raw, browser?, os?, device? }`.
+*/
+function createUserAgentEnricher(options = {}) {
+	return (ctx) => {
+		const ua = getHeader(ctx.headers, "user-agent");
+		if (!ua) return;
+		const info = parseUserAgent(ua);
+		ctx.event.userAgent = mergeEventField(ctx.event.userAgent, info, options.overwrite);
+	};
+}
+/**
+* Enrich events with geo data from platform headers.
+* Sets `event.geo` with `GeoInfo` shape: `{ country?, region?, regionCode?, city?, latitude?, longitude? }`.
+*
+* Supports Vercel (`x-vercel-ip-*`) headers out of the box.
+*
+* **Cloudflare note:** Only `cf-ipcountry` is an actual HTTP header added by Cloudflare.
+* The `cf-region`, `cf-city`, `cf-latitude`, `cf-longitude` headers are NOT standard
+* Cloudflare headers — they are properties of `request.cf` which is not exposed as HTTP
+* headers. For full geo data on Cloudflare, write a custom enricher that reads `request.cf`
+* or use a Workers middleware to copy `cf` properties into custom headers.
+*/
+function createGeoEnricher(options = {}) {
+	return (ctx) => {
+		const { headers } = ctx;
+		if (!headers) return;
+		const geo = {
+			country: getHeader(headers, "x-vercel-ip-country") ?? getHeader(headers, "cf-ipcountry"),
+			region: getHeader(headers, "x-vercel-ip-country-region") ?? getHeader(headers, "cf-region"),
+			regionCode: getHeader(headers, "x-vercel-ip-country-region-code") ?? getHeader(headers, "cf-region-code"),
+			city: getHeader(headers, "x-vercel-ip-city") ?? getHeader(headers, "cf-city"),
+			latitude: normalizeNumber(getHeader(headers, "x-vercel-ip-latitude") ?? getHeader(headers, "cf-latitude")),
+			longitude: normalizeNumber(getHeader(headers, "x-vercel-ip-longitude") ?? getHeader(headers, "cf-longitude"))
+		};
+		if (Object.values(geo).every((value) => value === void 0)) return;
+		ctx.event.geo = mergeEventField(ctx.event.geo, geo, options.overwrite);
+	};
+}
+/**
+* Enrich events with request/response payload sizes.
+* Sets `event.requestSize` with `RequestSizeInfo` shape: `{ requestBytes?, responseBytes? }`.
+*/
+function createRequestSizeEnricher(options = {}) {
+	return (ctx) => {
+		const requestBytes = normalizeNumber(getHeader(ctx.headers, "content-length"));
+		const responseBytes = normalizeNumber(getHeader(ctx.response?.headers, "content-length"));
+		const sizes = {
+			requestBytes,
+			responseBytes
+		};
+		if (requestBytes === void 0 && responseBytes === void 0) return;
+		ctx.event.requestSize = mergeEventField(ctx.event.requestSize, sizes, options.overwrite);
+	};
+}
+/**
+* Enrich events with W3C trace context data.
+* Sets `event.traceContext` with `TraceContextInfo` shape: `{ traceparent?, tracestate?, traceId?, spanId? }`.
+* Also sets `event.traceId` and `event.spanId` at the top level.
+*/
+function createTraceContextEnricher(options = {}) {
+	return (ctx) => {
+		const traceparent = getHeader(ctx.headers, "traceparent");
+		const tracestate = getHeader(ctx.headers, "tracestate");
+		if (!traceparent && !tracestate) return;
+		const parsed = traceparent ? parseTraceparent(traceparent) : void 0;
+		const incomingTraceContext = {
+			traceparent,
+			tracestate,
+			traceId: parsed?.traceId ?? ctx.event.traceId,
+			spanId: parsed?.spanId ?? ctx.event.spanId
+		};
+		const mergedTraceContext = mergeEventField(ctx.event.traceContext, incomingTraceContext, options.overwrite);
+		ctx.event.traceContext = mergedTraceContext;
+		if (mergedTraceContext.traceId && (options.overwrite || ctx.event.traceId === void 0)) ctx.event.traceId = mergedTraceContext.traceId;
+		if (mergedTraceContext.spanId && (options.overwrite || ctx.event.spanId === void 0)) ctx.event.spanId = mergedTraceContext.spanId;
+	};
+}
+
+//#endregion
+export { createGeoEnricher, createRequestSizeEnricher, createTraceContextEnricher, createUserAgentEnricher };
+//# sourceMappingURL=enrichers.mjs.map

package/dist/enrichers.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"enrichers.mjs","names":[],"sources":["../src/enrichers/index.ts"],"sourcesContent":["import type { EnrichContext } from '../types'\n\nexport interface EnricherOptions {\n  /**\n   * When true, overwrite any existing fields in the event.\n   * Defaults to false to preserve user-provided data.\n   */\n  overwrite?: boolean\n}\n\nexport interface UserAgentInfo {\n  raw: string\n  browser?: { name: string; version?: string }\n  os?: { name: string; version?: string }\n  device?: { type: 'mobile' | 'tablet' | 'desktop' | 'bot' | 'unknown' }\n}\n\nexport interface GeoInfo {\n  country?: string\n  region?: string\n  regionCode?: string\n  city?: string\n  latitude?: number\n  longitude?: number\n}\n\nexport interface RequestSizeInfo {\n  requestBytes?: number\n  responseBytes?: number\n}\n\nexport interface TraceContextInfo {\n  traceparent?: string\n  tracestate?: string\n  traceId?: string\n  spanId?: string\n}\n\nfunction getHeader(headers: Record<string, string> | undefined, name: string): string | undefined {\n  if (!headers) return undefined\n  if (headers[name] !== undefined) return headers[name]\n  const lowerName = name.toLowerCase()\n  if (headers[lowerName] !== undefined) return headers[lowerName]\n  for (const [key, value] of Object.entries(headers)) {\n    if (key.toLowerCase() === lowerName) return value\n  }\n  return undefined\n}\n\nfunction parseUserAgent(ua: string): UserAgentInfo {\n  const lower = ua.toLowerCase()\n\n  let deviceType: UserAgentInfo['device'] = { type: 'unknown' }\n  if (/bot|crawl|spider|slurp|bingpreview/.test(lower)) {\n    deviceType = { type: 'bot' }\n  } else if (/ipad|tablet/.test(lower)) {\n    deviceType = { type: 'tablet' }\n  } else if (/mobi|iphone|android/.test(lower)) {\n    deviceType = { type: 'mobile' }\n  } else if (ua.length > 0) {\n    deviceType = { type: 'desktop' }\n  }\n\n  const browserMatchers: Array<{ name: string, regex: RegExp }> = [\n    { name: 'Edge', regex: /edg\\/([\\d.]+)/i },\n    { name: 'Chrome', regex: /chrome\\/([\\d.]+)/i },\n    { name: 'Firefox', regex: /firefox\\/([\\d.]+)/i },\n    { name: 'Safari', regex: /version\\/([\\d.]+).*safari/i },\n  ]\n\n  let browser: UserAgentInfo['browser']\n  for (const matcher of browserMatchers) {\n    const match = ua.match(matcher.regex)\n    if (match) {\n      browser = { name: matcher.name, version: match[1] }\n      break\n    }\n  }\n\n  let os: UserAgentInfo['os']\n  if (/windows nt/i.test(ua)) {\n    const match = ua.match(/windows nt ([\\d.]+)/i)\n    os = { name: 'Windows', version: match?.[1] }\n  } else if (/mac os x/i.test(ua) && !/iphone|ipad|ipod/i.test(ua)) {\n    const match = ua.match(/mac os x ([\\d_]+)/i)\n    os = { name: 'macOS', version: match?.[1]?.replace(/_/g, '.') }\n  } else if (/iphone|ipad|ipod/i.test(ua)) {\n    const match = ua.match(/os ([\\d_]+)/i)\n    os = { name: 'iOS', version: match?.[1]?.replace(/_/g, '.') }\n  } else if (/android/i.test(ua)) {\n    const match = ua.match(/android ([\\d.]+)/i)\n    os = { name: 'Android', version: match?.[1] }\n  } else if (/linux/i.test(ua)) {\n    os = { name: 'Linux' }\n  }\n\n  return {\n    raw: ua,\n    browser,\n    os,\n    device: deviceType,\n  }\n}\n\nfunction parseTraceparent(traceparent: string): Pick<TraceContextInfo, 'traceId' | 'spanId'> | undefined {\n  const match = traceparent.match(/^[\\da-f]{2}-([\\da-f]{32})-([\\da-f]{16})-[\\da-f]{2}$/i)\n  if (!match) return undefined\n  return { traceId: match[1], spanId: match[2] }\n}\n\nfunction mergeEventField<T extends object>(\n  existing: unknown,\n  computed: T,\n  overwrite?: boolean,\n): T {\n  if (overwrite || existing === undefined || existing === null || typeof existing !== 'object') {\n    return computed\n  }\n  return { ...computed, ...(existing as T) }\n}\n\nfunction normalizeNumber(value: string | undefined): number | undefined {\n  if (!value) return undefined\n  const parsed = Number(value)\n  return Number.isFinite(parsed) ? parsed : undefined\n}\n\n/**\n * Enrich events with parsed user agent data.\n * Sets `event.userAgent` with `UserAgentInfo` shape: `{ raw, browser?, os?, device? }`.\n */\nexport function createUserAgentEnricher(options: EnricherOptions = {}): (ctx: EnrichContext) => void {\n  return (ctx) => {\n    const ua = getHeader(ctx.headers, 'user-agent')\n    if (!ua) return\n    const info = parseUserAgent(ua)\n    ctx.event.userAgent = mergeEventField<UserAgentInfo>(ctx.event.userAgent, info, options.overwrite)\n  }\n}\n\n/**\n * Enrich events with geo data from platform headers.\n * Sets `event.geo` with `GeoInfo` shape: `{ country?, region?, regionCode?, city?, latitude?, longitude? }`.\n *\n * Supports Vercel (`x-vercel-ip-*`) headers out of the box.\n *\n * **Cloudflare note:** Only `cf-ipcountry` is an actual HTTP header added by Cloudflare.\n * The `cf-region`, `cf-city`, `cf-latitude`, `cf-longitude` headers are NOT standard\n * Cloudflare headers — they are properties of `request.cf` which is not exposed as HTTP\n * headers. For full geo data on Cloudflare, write a custom enricher that reads `request.cf`\n * or use a Workers middleware to copy `cf` properties into custom headers.\n */\nexport function createGeoEnricher(options: EnricherOptions = {}): (ctx: EnrichContext) => void {\n  return (ctx) => {\n    const { headers } = ctx\n    if (!headers) return\n\n    const geo: GeoInfo = {\n      country: getHeader(headers, 'x-vercel-ip-country') ?? getHeader(headers, 'cf-ipcountry'),\n      region: getHeader(headers, 'x-vercel-ip-country-region') ?? getHeader(headers, 'cf-region'),\n      regionCode: getHeader(headers, 'x-vercel-ip-country-region-code') ?? getHeader(headers, 'cf-region-code'),\n      city: getHeader(headers, 'x-vercel-ip-city') ?? getHeader(headers, 'cf-city'),\n      latitude: normalizeNumber(getHeader(headers, 'x-vercel-ip-latitude') ?? getHeader(headers, 'cf-latitude')),\n      longitude: normalizeNumber(getHeader(headers, 'x-vercel-ip-longitude') ?? getHeader(headers, 'cf-longitude')),\n    }\n\n    if (Object.values(geo).every(value => value === undefined)) return\n    ctx.event.geo = mergeEventField<GeoInfo>(ctx.event.geo, geo, options.overwrite)\n  }\n}\n\n/**\n * Enrich events with request/response payload sizes.\n * Sets `event.requestSize` with `RequestSizeInfo` shape: `{ requestBytes?, responseBytes? }`.\n */\nexport function createRequestSizeEnricher(options: EnricherOptions = {}): (ctx: EnrichContext) => void {\n  return (ctx) => {\n    const requestBytes = normalizeNumber(getHeader(ctx.headers, 'content-length'))\n    const responseBytes = normalizeNumber(getHeader(ctx.response?.headers, 'content-length'))\n\n    const sizes: RequestSizeInfo = {\n      requestBytes,\n      responseBytes,\n    }\n\n    if (requestBytes === undefined && responseBytes === undefined) return\n    ctx.event.requestSize = mergeEventField<RequestSizeInfo>(ctx.event.requestSize, sizes, options.overwrite)\n  }\n}\n\n/**\n * Enrich events with W3C trace context data.\n * Sets `event.traceContext` with `TraceContextInfo` shape: `{ traceparent?, tracestate?, traceId?, spanId? }`.\n * Also sets `event.traceId` and `event.spanId` at the top level.\n */\nexport function createTraceContextEnricher(options: EnricherOptions = {}): (ctx: EnrichContext) => void {\n  return (ctx) => {\n    const traceparent = getHeader(ctx.headers, 'traceparent')\n    const tracestate = getHeader(ctx.headers, 'tracestate')\n    if (!traceparent && !tracestate) return\n\n    const parsed = traceparent ? parseTraceparent(traceparent) : undefined\n    const incomingTraceContext: TraceContextInfo = {\n      traceparent,\n      tracestate,\n      traceId: parsed?.traceId ?? (ctx.event.traceId as string | undefined),\n      spanId: parsed?.spanId ?? (ctx.event.spanId as string | undefined),\n    }\n\n    const mergedTraceContext = mergeEventField<TraceContextInfo>(\n      ctx.event.traceContext,\n      incomingTraceContext,\n      options.overwrite,\n    )\n    ctx.event.traceContext = mergedTraceContext\n\n    if (mergedTraceContext.traceId && (options.overwrite || ctx.event.traceId === undefined)) {\n      ctx.event.traceId = mergedTraceContext.traceId\n    }\n    if (mergedTraceContext.spanId && (options.overwrite || ctx.event.spanId === undefined)) {\n      ctx.event.spanId = mergedTraceContext.spanId\n    }\n  }\n}\n"],"mappings":"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"}

package/dist/error.d.mts

@@ -1,5 +1,6 @@
-import { ErrorOptions } from './types.mjs';
+import { ErrorOptions } from "./types.mjs";
 
+//#region src/error.d.ts
 /**
  * Structured error with context for better debugging
  *
@@ -16,26 +17,26 @@ import { ErrorOptions } from './types.mjs';
  * ```
  */
 declare class EvlogError extends Error {
-    /** HTTP status code */
-    readonly status: number;
-    readonly why?: string;
-    readonly fix?: string;
-    readonly link?: string;
-    constructor(options: ErrorOptions | string);
-    /** HTTP status text (alias for message) */
-    get statusText(): string;
-    /** HTTP status code (alias for compatibility) */
-    get statusCode(): number;
-    /** HTTP status message (alias for compatibility) */
-    get statusMessage(): string;
-    /** Structured data for serialization */
-    get data(): {
-        why?: string;
-        fix?: string;
-        link?: string;
-    } | undefined;
-    toString(): string;
-    toJSON(): Record<string, unknown>;
+  /** HTTP status code */
+  readonly status: number;
+  readonly why?: string;
+  readonly fix?: string;
+  readonly link?: string;
+  constructor(options: ErrorOptions | string);
+  /** HTTP status text (alias for message) */
+  get statusText(): string;
+  /** HTTP status code (alias for compatibility) */
+  get statusCode(): number;
+  /** HTTP status message (alias for compatibility) */
+  get statusMessage(): string;
+  /** Structured data for serialization */
+  get data(): {
+    why?: string;
+    fix?: string;
+    link?: string;
+  } | undefined;
+  toString(): string;
+  toJSON(): Record<string, unknown>;
 }
 /**
  * Create a structured error with context for debugging and user-facing messages.
@@ -59,5 +60,6 @@ declare class EvlogError extends Error {
  * ```
  */
 declare function createError(options: ErrorOptions | string): EvlogError;
-
+//#endregion
 export { EvlogError, createError, createError as createEvlogError };
+//# sourceMappingURL=error.d.mts.map

package/dist/error.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.d.mts","names":[],"sources":["../src/error.ts"],"mappings":";;;;;AAkBA;;;;;;;;;;;;;cAAa,UAAA,SAAmB,KAAA;EAQT;EAAA,SALZ,MAAA;EAAA,SACA,GAAA;EAAA,SACA,GAAA;EAAA,SACA,IAAA;cAEG,OAAA,EAAS,YAAA;EAiCP;EAAA,IAfV,UAAA,CAAA;EAesC;EAAA,IAVtC,UAAA,CAAA;EAkDJ;EAAA,IA7CI,aAAA,CAAA;EA6CY;EAAA,IAxCZ,IAAA,CAAA;IAAU,GAAA;IAAc,GAAA;IAAc,IAAA;EAAA;EAOjC,QAAA,CAAA;EAiCT,MAAA,CAAA,GAAU,MAAA;AAAA;;;;;;;;;;;;;;;;;;;;;;iBAoCI,WAAA,CAAY,OAAA,EAAS,YAAA,YAAwB,UAAA"}

package/dist/error.mjs

@@ -1,81 +1,112 @@
-import { colors, isServer } from './utils.mjs';
+import { colors, isServer } from "./utils.mjs";
 
-class EvlogError extends Error {
-  /** HTTP status code */
-  status;
-  why;
-  fix;
-  link;
-  constructor(options) {
-    const opts = typeof options === "string" ? { message: options } : options;
-    super(opts.message, { cause: opts.cause });
-    this.name = "EvlogError";
-    this.status = opts.status ?? 500;
-    this.why = opts.why;
-    this.fix = opts.fix;
-    this.link = opts.link;
-    if (Error.captureStackTrace) {
-      Error.captureStackTrace(this, EvlogError);
-    }
-  }
-  /** HTTP status text (alias for message) */
-  get statusText() {
-    return this.message;
-  }
-  /** HTTP status code (alias for compatibility) */
-  get statusCode() {
-    return this.status;
-  }
-  /** HTTP status message (alias for compatibility) */
-  get statusMessage() {
-    return this.message;
-  }
-  /** Structured data for serialization */
-  get data() {
-    if (this.why || this.fix || this.link) {
-      return { why: this.why, fix: this.fix, link: this.link };
-    }
-    return void 0;
-  }
-  toString() {
-    const useColors = isServer();
-    const red = useColors ? colors.red : "";
-    const yellow = useColors ? colors.yellow : "";
-    const cyan = useColors ? colors.cyan : "";
-    const dim = useColors ? colors.dim : "";
-    const reset = useColors ? colors.reset : "";
-    const bold = useColors ? colors.bold : "";
-    const lines = [];
-    lines.push(`${red}${bold}Error:${reset} ${this.message}`);
-    if (this.why) {
-      lines.push(`${yellow}Why:${reset} ${this.why}`);
-    }
-    if (this.fix) {
-      lines.push(`${cyan}Fix:${reset} ${this.fix}`);
-    }
-    if (this.link) {
-      lines.push(`${dim}More info:${reset} ${this.link}`);
-    }
-    if (this.cause) {
-      lines.push(`${dim}Caused by:${reset} ${this.cause.message}`);
-    }
-    return lines.join("\n");
-  }
-  toJSON() {
-    const { data } = this;
-    return {
-      name: this.name,
-      message: this.message,
-      status: this.status,
-      ...data && { data },
-      ...this.cause instanceof Error && {
-        cause: { name: this.cause.name, message: this.cause.message }
-      }
-    };
-  }
-}
+//#region src/error.ts
+/**
+* Structured error with context for better debugging
+*
+* @example
+* ```ts
+* throw new EvlogError({
+*   message: 'Failed to sync repository',
+*   status: 503,
+*   why: 'GitHub API rate limit exceeded',
+*   fix: 'Wait 1 hour or use a different token',
+*   link: 'https://docs.github.com/en/rest/rate-limit',
+*   cause: originalError,
+* })
+* ```
+*/
+var EvlogError = class EvlogError extends Error {
+	/** HTTP status code */
+	status;
+	why;
+	fix;
+	link;
+	constructor(options) {
+		const opts = typeof options === "string" ? { message: options } : options;
+		super(opts.message, { cause: opts.cause });
+		this.name = "EvlogError";
+		this.status = opts.status ?? 500;
+		this.why = opts.why;
+		this.fix = opts.fix;
+		this.link = opts.link;
+		if (Error.captureStackTrace) Error.captureStackTrace(this, EvlogError);
+	}
+	/** HTTP status text (alias for message) */
+	get statusText() {
+		return this.message;
+	}
+	/** HTTP status code (alias for compatibility) */
+	get statusCode() {
+		return this.status;
+	}
+	/** HTTP status message (alias for compatibility) */
+	get statusMessage() {
+		return this.message;
+	}
+	/** Structured data for serialization */
+	get data() {
+		if (this.why || this.fix || this.link) return {
+			why: this.why,
+			fix: this.fix,
+			link: this.link
+		};
+	}
+	toString() {
+		const useColors = isServer();
+		const red = useColors ? colors.red : "";
+		const yellow = useColors ? colors.yellow : "";
+		const cyan = useColors ? colors.cyan : "";
+		const dim = useColors ? colors.dim : "";
+		const reset = useColors ? colors.reset : "";
+		const bold = useColors ? colors.bold : "";
+		const lines = [];
+		lines.push(`${red}${bold}Error:${reset} ${this.message}`);
+		if (this.why) lines.push(`${yellow}Why:${reset} ${this.why}`);
+		if (this.fix) lines.push(`${cyan}Fix:${reset} ${this.fix}`);
+		if (this.link) lines.push(`${dim}More info:${reset} ${this.link}`);
+		if (this.cause) lines.push(`${dim}Caused by:${reset} ${this.cause.message}`);
+		return lines.join("\n");
+	}
+	toJSON() {
+		const { data } = this;
+		return {
+			name: this.name,
+			message: this.message,
+			status: this.status,
+			...data && { data },
+			...this.cause instanceof Error && { cause: {
+				name: this.cause.name,
+				message: this.cause.message
+			} }
+		};
+	}
+};
+/**
+* Create a structured error with context for debugging and user-facing messages.
+*
+* @param options - Error message string or full options object
+* @returns EvlogError with HTTP metadata (`status`, `statusText`) and `data`; also includes `statusCode` and `statusMessage` for legacy compatibility
+*
+* @example
+* ```ts
+* // Simple error
+* throw createError('Something went wrong')
+*
+* // Structured error with context
+* throw createError({
+*   message: 'Payment failed',
+*   status: 402,
+*   why: 'Card declined by issuer',
+*   fix: 'Try a different payment method',
+*   link: 'https://docs.example.com/payments',
+* })
+* ```
+*/
 function createError(options) {
-  return new EvlogError(options);
+	return new EvlogError(options);
 }
 
+//#endregion
 export { EvlogError, createError, createError as createEvlogError };
+//# sourceMappingURL=error.mjs.map

package/dist/error.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.mjs","names":[],"sources":["../src/error.ts"],"sourcesContent":["import type { ErrorOptions } from './types'\nimport { colors, isServer } from './utils'\n\n/**\n * Structured error with context for better debugging\n *\n * @example\n * ```ts\n * throw new EvlogError({\n *   message: 'Failed to sync repository',\n *   status: 503,\n *   why: 'GitHub API rate limit exceeded',\n *   fix: 'Wait 1 hour or use a different token',\n *   link: 'https://docs.github.com/en/rest/rate-limit',\n *   cause: originalError,\n * })\n * ```\n */\nexport class EvlogError extends Error {\n\n  /** HTTP status code */\n  readonly status: number\n  readonly why?: string\n  readonly fix?: string\n  readonly link?: string\n\n  constructor(options: ErrorOptions | string) {\n    const opts = typeof options === 'string' ? { message: options } : options\n\n    super(opts.message, { cause: opts.cause })\n\n    this.name = 'EvlogError'\n    this.status = opts.status ?? 500\n    this.why = opts.why\n    this.fix = opts.fix\n    this.link = opts.link\n\n    // Maintain proper stack trace in V8\n    if (Error.captureStackTrace) {\n      Error.captureStackTrace(this, EvlogError)\n    }\n  }\n\n  /** HTTP status text (alias for message) */\n  get statusText(): string {\n    return this.message\n  }\n\n  /** HTTP status code (alias for compatibility) */\n  get statusCode(): number {\n    return this.status\n  }\n\n  /** HTTP status message (alias for compatibility) */\n  get statusMessage(): string {\n    return this.message\n  }\n\n  /** Structured data for serialization */\n  get data(): { why?: string, fix?: string, link?: string } | undefined {\n    if (this.why || this.fix || this.link) {\n      return { why: this.why, fix: this.fix, link: this.link }\n    }\n    return undefined\n  }\n\n  override toString(): string {\n    const useColors = isServer()\n\n    const red = useColors ? colors.red : ''\n    const yellow = useColors ? colors.yellow : ''\n    const cyan = useColors ? colors.cyan : ''\n    const dim = useColors ? colors.dim : ''\n    const reset = useColors ? colors.reset : ''\n    const bold = useColors ? colors.bold : ''\n\n    const lines: string[] = []\n\n    lines.push(`${red}${bold}Error:${reset} ${this.message}`)\n\n    if (this.why) {\n      lines.push(`${yellow}Why:${reset} ${this.why}`)\n    }\n\n    if (this.fix) {\n      lines.push(`${cyan}Fix:${reset} ${this.fix}`)\n    }\n\n    if (this.link) {\n      lines.push(`${dim}More info:${reset} ${this.link}`)\n    }\n\n    if (this.cause) {\n      lines.push(`${dim}Caused by:${reset} ${(this.cause as Error).message}`)\n    }\n\n    return lines.join('\\n')\n  }\n\n  toJSON(): Record<string, unknown> {\n    const { data } = this\n    return {\n      name: this.name,\n      message: this.message,\n      status: this.status,\n      ...(data && { data }),\n      ...(this.cause instanceof Error && {\n        cause: { name: this.cause.name, message: this.cause.message },\n      }),\n    }\n  }\n\n}\n\n/**\n * Create a structured error with context for debugging and user-facing messages.\n *\n * @param options - Error message string or full options object\n * @returns EvlogError with HTTP metadata (`status`, `statusText`) and `data`; also includes `statusCode` and `statusMessage` for legacy compatibility\n *\n * @example\n * ```ts\n * // Simple error\n * throw createError('Something went wrong')\n *\n * // Structured error with context\n * throw createError({\n *   message: 'Payment failed',\n *   status: 402,\n *   why: 'Card declined by issuer',\n *   fix: 'Try a different payment method',\n *   link: 'https://docs.example.com/payments',\n * })\n * ```\n */\nexport function createError(options: ErrorOptions | string): EvlogError {\n  return new EvlogError(options)\n}\n\nexport { createError as createEvlogError }\n"],"mappings":";;;;;;;;;;;;;;;;;;AAkBA,IAAa,aAAb,MAAa,mBAAmB,MAAM;;CAGpC,AAAS;CACT,AAAS;CACT,AAAS;CACT,AAAS;CAET,YAAY,SAAgC;EAC1C,MAAM,OAAO,OAAO,YAAY,WAAW,EAAE,SAAS,SAAS,GAAG;AAElE,QAAM,KAAK,SAAS,EAAE,OAAO,KAAK,OAAO,CAAC;AAE1C,OAAK,OAAO;AACZ,OAAK,SAAS,KAAK,UAAU;AAC7B,OAAK,MAAM,KAAK;AAChB,OAAK,MAAM,KAAK;AAChB,OAAK,OAAO,KAAK;AAGjB,MAAI,MAAM,kBACR,OAAM,kBAAkB,MAAM,WAAW;;;CAK7C,IAAI,aAAqB;AACvB,SAAO,KAAK;;;CAId,IAAI,aAAqB;AACvB,SAAO,KAAK;;;CAId,IAAI,gBAAwB;AAC1B,SAAO,KAAK;;;CAId,IAAI,OAAkE;AACpE,MAAI,KAAK,OAAO,KAAK,OAAO,KAAK,KAC/B,QAAO;GAAE,KAAK,KAAK;GAAK,KAAK,KAAK;GAAK,MAAM,KAAK;GAAM;;CAK5D,AAAS,WAAmB;EAC1B,MAAM,YAAY,UAAU;EAE5B,MAAM,MAAM,YAAY,OAAO,MAAM;EACrC,MAAM,SAAS,YAAY,OAAO,SAAS;EAC3C,MAAM,OAAO,YAAY,OAAO,OAAO;EACvC,MAAM,MAAM,YAAY,OAAO,MAAM;EACrC,MAAM,QAAQ,YAAY,OAAO,QAAQ;EACzC,MAAM,OAAO,YAAY,OAAO,OAAO;EAEvC,MAAM,QAAkB,EAAE;AAE1B,QAAM,KAAK,GAAG,MAAM,KAAK,QAAQ,MAAM,GAAG,KAAK,UAAU;AAEzD,MAAI,KAAK,IACP,OAAM,KAAK,GAAG,OAAO,MAAM,MAAM,GAAG,KAAK,MAAM;AAGjD,MAAI,KAAK,IACP,OAAM,KAAK,GAAG,KAAK,MAAM,MAAM,GAAG,KAAK,MAAM;AAG/C,MAAI,KAAK,KACP,OAAM,KAAK,GAAG,IAAI,YAAY,MAAM,GAAG,KAAK,OAAO;AAGrD,MAAI,KAAK,MACP,OAAM,KAAK,GAAG,IAAI,YAAY,MAAM,GAAI,KAAK,MAAgB,UAAU;AAGzE,SAAO,MAAM,KAAK,KAAK;;CAGzB,SAAkC;EAChC,MAAM,EAAE,SAAS;AACjB,SAAO;GACL,MAAM,KAAK;GACX,SAAS,KAAK;GACd,QAAQ,KAAK;GACb,GAAI,QAAQ,EAAE,MAAM;GACpB,GAAI,KAAK,iBAAiB,SAAS,EACjC,OAAO;IAAE,MAAM,KAAK,MAAM;IAAM,SAAS,KAAK,MAAM;IAAS,EAC9D;GACF;;;;;;;;;;;;;;;;;;;;;;;;AA0BL,SAAgB,YAAY,SAA4C;AACtE,QAAO,IAAI,WAAW,QAAQ"}

package/dist/index.d.mts

@@ -1,5 +1,6 @@
-export { EvlogError, createError, createError as createEvlogError } from './error.mjs';
-export { createRequestLogger, getEnvironment, initLogger, log, shouldKeep } from './logger.mjs';
-export { useLogger } from './runtime/server/useLogger.mjs';
-export { parseError } from './runtime/utils/parseError.mjs';
-export { BaseWideEvent, DrainContext, EnvironmentContext, ErrorOptions, H3EventContext, IngestPayload, Log, LogLevel, LoggerConfig, ParsedError, RequestLogger, RequestLoggerOptions, SamplingConfig, SamplingRates, ServerEvent, TailSamplingCondition, TailSamplingContext, TransportConfig, WideEvent } from './types.mjs';
+import { BaseWideEvent, DeepPartial, DrainContext, EnrichContext, EnvironmentContext, ErrorOptions, FieldContext, H3EventContext, IngestPayload, InternalFields, Log, LogLevel, LoggerConfig, ParsedError, RequestLogger, RequestLoggerOptions, SamplingConfig, SamplingRates, ServerEvent, TailSamplingCondition, TailSamplingContext, TransportConfig, WideEvent } from "./types.mjs";
+import { EvlogError, createError } from "./error.mjs";
+import { createRequestLogger, getEnvironment, initLogger, isEnabled, log as _log, shouldKeep } from "./logger.mjs";
+import { useLogger } from "./runtime/server/useLogger.mjs";
+import { parseError } from "./runtime/utils/parseError.mjs";
+export { type BaseWideEvent, type DeepPartial, type DrainContext, type EnrichContext, type EnvironmentContext, type ErrorOptions, EvlogError, type FieldContext, type H3EventContext, type IngestPayload, type InternalFields, type Log, type LogLevel, type LoggerConfig, type ParsedError, type RequestLogger, type RequestLoggerOptions, type SamplingConfig, type SamplingRates, type ServerEvent, type TailSamplingCondition, type TailSamplingContext, type TransportConfig, type WideEvent, createError, createError as createEvlogError, createRequestLogger, getEnvironment, initLogger, isEnabled, _log as log, parseError, shouldKeep, useLogger };

package/dist/index.mjs

@@ -1,5 +1,6 @@
-export { EvlogError, createError, createError as createEvlogError } from './error.mjs';
-export { createRequestLogger, getEnvironment, initLogger, log, shouldKeep } from './logger.mjs';
-export { useLogger } from './runtime/server/useLogger.mjs';
-export { parseError } from './runtime/utils/parseError.mjs';
-import './utils.mjs';
+import { EvlogError, createError } from "./error.mjs";
+import { createRequestLogger, getEnvironment, initLogger, isEnabled, log as _log, shouldKeep } from "./logger.mjs";
+import { useLogger } from "./runtime/server/useLogger.mjs";
+import { parseError } from "./runtime/utils/parseError.mjs";
+
+export { EvlogError, createError, createError as createEvlogError, createRequestLogger, getEnvironment, initLogger, isEnabled, _log as log, parseError, shouldKeep, useLogger };

package/dist/logger.d.mts

@@ -1,10 +1,15 @@
-import { RequestLoggerOptions, RequestLogger, EnvironmentContext, LoggerConfig, Log, TailSamplingContext } from './types.mjs';
+import { EnvironmentContext, Log, LoggerConfig, RequestLogger, RequestLoggerOptions, TailSamplingContext } from "./types.mjs";
 
+//#region src/logger.d.ts
 /**
  * Initialize the logger with configuration.
  * Call this once at application startup.
  */
 declare function initLogger(config?: LoggerConfig): void;
+/**
+ * Check if logging is globally enabled.
+ */
+declare function isEnabled(): boolean;
 /**
  * Evaluate tail sampling conditions to determine if a log should be force-kept.
  * Returns true if ANY condition matches (OR logic).
@@ -19,7 +24,7 @@ declare function shouldKeep(ctx: TailSamplingContext): boolean;
  * log.error({ action: 'payment', error: 'failed' })
  * ```
  */
-declare const log: Log;
+declare const _log: Log;
 /**
  * Create a request-scoped logger for building wide events.
  *
@@ -31,10 +36,11 @@ declare const log: Log;
  * log.emit()
  * ```
  */
-declare function createRequestLogger(options?: RequestLoggerOptions): RequestLogger;
+declare function createRequestLogger<T extends object = Record<string, unknown>>(options?: RequestLoggerOptions): RequestLogger<T>;
 /**
  * Get the current environment context.
  */
 declare function getEnvironment(): EnvironmentContext;
-
-export { createRequestLogger, getEnvironment, initLogger, log, shouldKeep };
+//#endregion
+export { createRequestLogger, getEnvironment, initLogger, isEnabled, _log as log, shouldKeep };
+//# sourceMappingURL=logger.d.mts.map

package/dist/logger.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.mts","names":[],"sources":["../src/logger.ts"],"mappings":";;;;;AAoCA;;iBAAgB,UAAA,CAAW,MAAA,GAAQ,YAAA;;;AAqBnC;iBAAgB,SAAA,CAAA;;;;AA8BhB;iBAAgB,UAAA,CAAW,GAAA,EAAK,mBAAA;;;;AAgB/B;;;;;AAkKD;cAjCM,IAAA,EAAM,GAAA;;;;;;;;;;;;iBAiCI,mBAAA,oBAAuC,MAAA,kBAAA,CAAyB,OAAA,GAAS,oBAAA,GAA4B,aAAA,CAAc,CAAA;;;AAiHnI;iBAAgB,cAAA,CAAA,GAAkB,kBAAA"}