evlog 1.6.0 → 1.7.0

package/dist/adapters/sentry.mjs

@@ -1,176 +1,233 @@
-import { g as getRuntimeConfig } from '../shared/evlog.Bc35pxiY.mjs';
+import { t as getRuntimeConfig } from "../_utils-DZA9nou3.mjs";
 
+//#region src/adapters/sentry.ts
+/** Based on OpenTelemetry Logs Data Model specification */
 const SEVERITY_MAP = {
-  debug: 5,
-  info: 9,
-  warn: 13,
-  error: 17
+	debug: 5,
+	info: 9,
+	warn: 13,
+	error: 17
 };
 function parseSentryDsn(dsn) {
-  const url = new URL(dsn);
-  const publicKey = url.username;
-  if (!publicKey) {
-    throw new Error("Invalid Sentry DSN: missing public key");
-  }
-  const secretKey = url.password || void 0;
-  const pathParts = url.pathname.split("/").filter(Boolean);
-  const projectId = pathParts.pop();
-  if (!projectId) {
-    throw new Error("Invalid Sentry DSN: missing project ID");
-  }
-  const basePath = pathParts.length > 0 ? `/${pathParts.join("/")}` : "";
-  return {
-    publicKey,
-    secretKey,
-    projectId,
-    origin: `${url.protocol}//${url.host}`,
-    basePath
-  };
+	const url = new URL(dsn);
+	const publicKey = url.username;
+	if (!publicKey) throw new Error("Invalid Sentry DSN: missing public key");
+	const secretKey = url.password || void 0;
+	const pathParts = url.pathname.split("/").filter(Boolean);
+	const projectId = pathParts.pop();
+	if (!projectId) throw new Error("Invalid Sentry DSN: missing project ID");
+	const basePath = pathParts.length > 0 ? `/${pathParts.join("/")}` : "";
+	return {
+		publicKey,
+		secretKey,
+		projectId,
+		origin: `${url.protocol}//${url.host}`,
+		basePath
+	};
 }
 function getSentryEnvelopeUrl(dsn) {
-  const { publicKey, secretKey, projectId, origin, basePath } = parseSentryDsn(dsn);
-  const url = `${origin}${basePath}/api/${projectId}/envelope/`;
-  let authHeader = `Sentry sentry_version=7, sentry_key=${publicKey}, sentry_client=evlog`;
-  if (secretKey) {
-    authHeader += `, sentry_secret=${secretKey}`;
-  }
-  return { url, authHeader };
+	const { publicKey, secretKey, projectId, origin, basePath } = parseSentryDsn(dsn);
+	const url = `${origin}${basePath}/api/${projectId}/envelope/`;
+	let authHeader = `Sentry sentry_version=7, sentry_key=${publicKey}, sentry_client=evlog`;
+	if (secretKey) authHeader += `, sentry_secret=${secretKey}`;
+	return {
+		url,
+		authHeader
+	};
 }
 function createTraceId() {
-  if (typeof globalThis.crypto?.randomUUID === "function") {
-    return globalThis.crypto.randomUUID().replace(/-/g, "");
-  }
-  return Array.from({ length: 32 }, () => Math.floor(Math.random() * 16).toString(16)).join("");
+	if (typeof globalThis.crypto?.randomUUID === "function") return globalThis.crypto.randomUUID().replace(/-/g, "");
+	return Array.from({ length: 32 }, () => Math.floor(Math.random() * 16).toString(16)).join("");
 }
 function getFirstStringValue(event, keys) {
-  for (const key of keys) {
-    const value = event[key];
-    if (typeof value === "string" && value.length > 0) return value;
-  }
-  return void 0;
+	for (const key of keys) {
+		const value = event[key];
+		if (typeof value === "string" && value.length > 0) return value;
+	}
 }
 function toAttributeValue(value) {
-  if (value === null || value === void 0) {
-    return void 0;
-  }
-  if (typeof value === "string") {
-    return { value, type: "string" };
-  }
-  if (typeof value === "boolean") {
-    return { value, type: "boolean" };
-  }
-  if (typeof value === "number") {
-    if (Number.isInteger(value)) {
-      return { value, type: "integer" };
-    }
-    return { value, type: "double" };
-  }
-  return { value: JSON.stringify(value), type: "string" };
+	if (value === null || value === void 0) return;
+	if (typeof value === "string") return {
+		value,
+		type: "string"
+	};
+	if (typeof value === "boolean") return {
+		value,
+		type: "boolean"
+	};
+	if (typeof value === "number") {
+		if (Number.isInteger(value)) return {
+			value,
+			type: "integer"
+		};
+		return {
+			value,
+			type: "double"
+		};
+	}
+	return {
+		value: JSON.stringify(value),
+		type: "string"
+	};
 }
 function toSentryLog(event, config) {
-  const { timestamp, level, service, environment, version, ...rest } = event;
-  const body = getFirstStringValue(event, ["message", "action", "path"]) ?? "evlog wide event";
-  const traceId = typeof event.traceId === "string" && event.traceId.length > 0 ? event.traceId : createTraceId();
-  const attributes = {};
-  const env = config.environment ?? environment;
-  if (env) {
-    attributes["sentry.environment"] = { value: env, type: "string" };
-  }
-  const rel = config.release ?? version;
-  if (typeof rel === "string" && rel.length > 0) {
-    attributes["sentry.release"] = { value: rel, type: "string" };
-  }
-  attributes["service"] = { value: service, type: "string" };
-  if (config.tags) {
-    for (const [key, value] of Object.entries(config.tags)) {
-      attributes[key] = { value, type: "string" };
-    }
-  }
-  for (const [key, value] of Object.entries(rest)) {
-    if (key === "traceId" || key === "spanId") continue;
-    if (value === void 0 || value === null) continue;
-    const attr = toAttributeValue(value);
-    if (attr) {
-      attributes[key] = attr;
-    }
-  }
-  return {
-    timestamp: new Date(timestamp).getTime() / 1e3,
-    trace_id: traceId,
-    level,
-    body,
-    severity_number: SEVERITY_MAP[level] ?? 9,
-    attributes
-  };
+	const { timestamp, level, service, environment, version, ...rest } = event;
+	const body = getFirstStringValue(event, [
+		"message",
+		"action",
+		"path"
+	]) ?? "evlog wide event";
+	const traceId = typeof event.traceId === "string" && event.traceId.length > 0 ? event.traceId : createTraceId();
+	const attributes = {};
+	const env = config.environment ?? environment;
+	if (env) attributes["sentry.environment"] = {
+		value: env,
+		type: "string"
+	};
+	const rel = config.release ?? version;
+	if (typeof rel === "string" && rel.length > 0) attributes["sentry.release"] = {
+		value: rel,
+		type: "string"
+	};
+	attributes["service"] = {
+		value: service,
+		type: "string"
+	};
+	if (config.tags) for (const [key, value] of Object.entries(config.tags)) attributes[key] = {
+		value,
+		type: "string"
+	};
+	for (const [key, value] of Object.entries(rest)) {
+		if (key === "traceId" || key === "spanId") continue;
+		if (value === void 0 || value === null) continue;
+		const attr = toAttributeValue(value);
+		if (attr) attributes[key] = attr;
+	}
+	return {
+		timestamp: new Date(timestamp).getTime() / 1e3,
+		trace_id: traceId,
+		level,
+		body,
+		severity_number: SEVERITY_MAP[level] ?? 9,
+		attributes
+	};
 }
+/**
+* Build the Sentry Envelope body for a list of logs.
+*
+* Envelope format (line-delimited):
+* - Line 1: Envelope headers (dsn, sent_at)
+* - Line 2: Item header (type: log, item_count, content_type)
+* - Line 3: Item payload ({"items": [...]})
+*/
 function buildEnvelopeBody(logs, dsn) {
-  const envelopeHeader = JSON.stringify({
-    dsn,
-    sent_at: (/* @__PURE__ */ new Date()).toISOString()
-  });
-  const itemHeader = JSON.stringify({
-    type: "log",
-    item_count: logs.length,
-    content_type: "application/vnd.sentry.items.log+json"
-  });
-  const itemPayload = JSON.stringify({ items: logs });
-  return `${envelopeHeader}
-${itemHeader}
-${itemPayload}
-`;
+	return `${JSON.stringify({
+		dsn,
+		sent_at: (/* @__PURE__ */ new Date()).toISOString()
+	})}\n${JSON.stringify({
+		type: "log",
+		item_count: logs.length,
+		content_type: "application/vnd.sentry.items.log+json"
+	})}\n${JSON.stringify({ items: logs })}\n`;
 }
+/**
+* Create a drain function for sending logs to Sentry.
+*
+* Sends wide events as Sentry Structured Logs, visible in Explore > Logs
+* in the Sentry dashboard.
+*
+* Configuration priority (highest to lowest):
+* 1. Overrides passed to createSentryDrain()
+* 2. runtimeConfig.evlog.sentry
+* 3. runtimeConfig.sentry
+* 4. Environment variables: NUXT_SENTRY_*, SENTRY_*
+*
+* @example
+* ```ts
+* // Zero config - just set NUXT_SENTRY_DSN env var
+* nitroApp.hooks.hook('evlog:drain', createSentryDrain())
+*
+* // With overrides
+* nitroApp.hooks.hook('evlog:drain', createSentryDrain({
+*   dsn: 'https://public@o0.ingest.sentry.io/123',
+* }))
+* ```
+*/
 function createSentryDrain(overrides) {
-  return async (ctx) => {
-    const runtimeConfig = getRuntimeConfig();
-    const evlogSentry = runtimeConfig?.evlog?.sentry;
-    const rootSentry = runtimeConfig?.sentry;
-    const config = {
-      dsn: overrides?.dsn ?? evlogSentry?.dsn ?? rootSentry?.dsn ?? process.env.NUXT_SENTRY_DSN ?? process.env.SENTRY_DSN,
-      environment: overrides?.environment ?? evlogSentry?.environment ?? rootSentry?.environment ?? process.env.NUXT_SENTRY_ENVIRONMENT ?? process.env.SENTRY_ENVIRONMENT,
-      release: overrides?.release ?? evlogSentry?.release ?? rootSentry?.release ?? process.env.NUXT_SENTRY_RELEASE ?? process.env.SENTRY_RELEASE,
-      tags: overrides?.tags ?? evlogSentry?.tags ?? rootSentry?.tags,
-      timeout: overrides?.timeout ?? evlogSentry?.timeout ?? rootSentry?.timeout
-    };
-    if (!config.dsn) {
-      console.error("[evlog/sentry] Missing DSN. Set NUXT_SENTRY_DSN/SENTRY_DSN env var or pass to createSentryDrain()");
-      return;
-    }
-    try {
-      await sendToSentry(ctx.event, config);
-    } catch (error) {
-      console.error("[evlog/sentry] Failed to send log:", error);
-    }
-  };
+	return async (ctx) => {
+		const contexts = Array.isArray(ctx) ? ctx : [ctx];
+		if (contexts.length === 0) return;
+		const runtimeConfig = getRuntimeConfig();
+		const evlogSentry = runtimeConfig?.evlog?.sentry;
+		const rootSentry = runtimeConfig?.sentry;
+		const config = {
+			dsn: overrides?.dsn ?? evlogSentry?.dsn ?? rootSentry?.dsn ?? process.env.NUXT_SENTRY_DSN ?? process.env.SENTRY_DSN,
+			environment: overrides?.environment ?? evlogSentry?.environment ?? rootSentry?.environment ?? process.env.NUXT_SENTRY_ENVIRONMENT ?? process.env.SENTRY_ENVIRONMENT,
+			release: overrides?.release ?? evlogSentry?.release ?? rootSentry?.release ?? process.env.NUXT_SENTRY_RELEASE ?? process.env.SENTRY_RELEASE,
+			tags: overrides?.tags ?? evlogSentry?.tags ?? rootSentry?.tags,
+			timeout: overrides?.timeout ?? evlogSentry?.timeout ?? rootSentry?.timeout
+		};
+		if (!config.dsn) {
+			console.error("[evlog/sentry] Missing DSN. Set NUXT_SENTRY_DSN/SENTRY_DSN env var or pass to createSentryDrain()");
+			return;
+		}
+		try {
+			await sendBatchToSentry(contexts.map((c) => c.event), config);
+		} catch (error) {
+			console.error("[evlog/sentry] Failed to send events to Sentry:", error);
+		}
+	};
 }
+/**
+* Send a single event to Sentry as a structured log.
+*
+* @example
+* ```ts
+* await sendToSentry(event, {
+*   dsn: process.env.SENTRY_DSN!,
+* })
+* ```
+*/
 async function sendToSentry(event, config) {
-  await sendBatchToSentry([event], config);
+	await sendBatchToSentry([event], config);
 }
+/**
+* Send a batch of events to Sentry as structured logs via the Envelope endpoint.
+*
+* @example
+* ```ts
+* await sendBatchToSentry(events, {
+*   dsn: process.env.SENTRY_DSN!,
+* })
+* ```
+*/
 async function sendBatchToSentry(events, config) {
-  if (events.length === 0) return;
-  const { url, authHeader } = getSentryEnvelopeUrl(config.dsn);
-  const timeout = config.timeout ?? 5e3;
-  const logs = events.map((event) => toSentryLog(event, config));
-  const body = buildEnvelopeBody(logs, config.dsn);
-  const controller = new AbortController();
-  const timeoutId = setTimeout(() => controller.abort(), timeout);
-  try {
-    const response = await fetch(url, {
-      method: "POST",
-      headers: {
-        "Content-Type": "application/x-sentry-envelope",
-        "X-Sentry-Auth": authHeader
-      },
-      body,
-      signal: controller.signal
-    });
-    if (!response.ok) {
-      const text = await response.text().catch(() => "Unknown error");
-      const safeText = text.length > 200 ? `${text.slice(0, 200)}...[truncated]` : text;
-      throw new Error(`Sentry API error: ${response.status} ${response.statusText} - ${safeText}`);
-    }
-  } finally {
-    clearTimeout(timeoutId);
-  }
+	if (events.length === 0) return;
+	const { url, authHeader } = getSentryEnvelopeUrl(config.dsn);
+	const timeout = config.timeout ?? 5e3;
+	const body = buildEnvelopeBody(events.map((event) => toSentryLog(event, config)), config.dsn);
+	const controller = new AbortController();
+	const timeoutId = setTimeout(() => controller.abort(), timeout);
+	try {
+		const response = await fetch(url, {
+			method: "POST",
+			headers: {
+				"Content-Type": "application/x-sentry-envelope",
+				"X-Sentry-Auth": authHeader
+			},
+			body,
+			signal: controller.signal
+		});
+		if (!response.ok) {
+			const text = await response.text().catch(() => "Unknown error");
+			const safeText = text.length > 200 ? `${text.slice(0, 200)}...[truncated]` : text;
+			throw new Error(`Sentry API error: ${response.status} ${response.statusText} - ${safeText}`);
+		}
+	} finally {
+		clearTimeout(timeoutId);
+	}
 }
 
+//#endregion
 export { createSentryDrain, sendBatchToSentry, sendToSentry, toSentryLog };
+//# sourceMappingURL=sentry.mjs.map

package/dist/adapters/sentry.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"sentry.mjs","names":[],"sources":["../../src/adapters/sentry.ts"],"sourcesContent":["import type { DrainContext, LogLevel, WideEvent } from '../types'\nimport { getRuntimeConfig } from './_utils'\n\nexport interface SentryConfig {\n  /** Sentry DSN */\n  dsn: string\n  /** Environment override (defaults to event.environment) */\n  environment?: string\n  /** Release version override (defaults to event.version) */\n  release?: string\n  /** Additional tags to attach as attributes */\n  tags?: Record<string, string>\n  /** Request timeout in milliseconds. Default: 5000 */\n  timeout?: number\n}\n\n/** Sentry Log attribute value with type annotation */\nexport interface SentryAttributeValue {\n  value: string | number | boolean\n  type: 'string' | 'integer' | 'double' | 'boolean'\n}\n\n/** Sentry Structured Log payload */\nexport interface SentryLog {\n  timestamp: number\n  trace_id: string\n  level: 'trace' | 'debug' | 'info' | 'warn' | 'error' | 'fatal'\n  body: string\n  severity_number: number\n  attributes?: Record<string, SentryAttributeValue>\n}\n\ninterface SentryDsnParts {\n  publicKey: string\n  secretKey?: string\n  projectId: string\n  origin: string\n  basePath: string\n}\n\n/** Based on OpenTelemetry Logs Data Model specification */\nconst SEVERITY_MAP: Record<LogLevel, number> = {\n  debug: 5,\n  info: 9,\n  warn: 13,\n  error: 17,\n}\n\nfunction parseSentryDsn(dsn: string): SentryDsnParts {\n  const url = new URL(dsn)\n  const publicKey = url.username\n  if (!publicKey) {\n    throw new Error('Invalid Sentry DSN: missing public key')\n  }\n\n  const secretKey = url.password || undefined\n\n  const pathParts = url.pathname.split('/').filter(Boolean)\n  const projectId = pathParts.pop()\n  if (!projectId) {\n    throw new Error('Invalid Sentry DSN: missing project ID')\n  }\n\n  const basePath = pathParts.length > 0 ? `/${pathParts.join('/')}` : ''\n\n  return {\n    publicKey,\n    secretKey,\n    projectId,\n    origin: `${url.protocol}//${url.host}`,\n    basePath,\n  }\n}\n\nfunction getSentryEnvelopeUrl(dsn: string): { url: string, authHeader: string } {\n  const { publicKey, secretKey, projectId, origin, basePath } = parseSentryDsn(dsn)\n  const url = `${origin}${basePath}/api/${projectId}/envelope/`\n  let authHeader = `Sentry sentry_version=7, sentry_key=${publicKey}, sentry_client=evlog`\n  if (secretKey) {\n    authHeader += `, sentry_secret=${secretKey}`\n  }\n  return { url, authHeader }\n}\n\nfunction createTraceId(): string {\n  if (typeof globalThis.crypto?.randomUUID === 'function') {\n    return globalThis.crypto.randomUUID().replace(/-/g, '')\n  }\n\n  return Array.from({ length: 32 }, () => Math.floor(Math.random() * 16).toString(16)).join('')\n}\n\nfunction getFirstStringValue(event: WideEvent, keys: string[]): string | undefined {\n  for (const key of keys) {\n    const value = event[key]\n    if (typeof value === 'string' && value.length > 0) return value\n  }\n  return undefined\n}\n\nfunction toAttributeValue(value: unknown): SentryAttributeValue | undefined {\n  if (value === null || value === undefined) {\n    return undefined\n  }\n  if (typeof value === 'string') {\n    return { value, type: 'string' }\n  }\n  if (typeof value === 'boolean') {\n    return { value, type: 'boolean' }\n  }\n  if (typeof value === 'number') {\n    if (Number.isInteger(value)) {\n      return { value, type: 'integer' }\n    }\n    return { value, type: 'double' }\n  }\n  return { value: JSON.stringify(value), type: 'string' }\n}\n\nexport function toSentryLog(event: WideEvent, config: SentryConfig): SentryLog {\n  const { timestamp, level, service, environment, version, ...rest } = event\n\n  const body = getFirstStringValue(event, ['message', 'action', 'path'])\n    ?? 'evlog wide event'\n\n  const traceId = (typeof event.traceId === 'string' && event.traceId.length > 0)\n    ? event.traceId\n    : createTraceId()\n\n  const attributes: Record<string, SentryAttributeValue> = {}\n\n  const env = config.environment ?? environment\n  if (env) {\n    attributes['sentry.environment'] = { value: env, type: 'string' }\n  }\n\n  const rel = config.release ?? version\n  if (typeof rel === 'string' && rel.length > 0) {\n    attributes['sentry.release'] = { value: rel, type: 'string' }\n  }\n\n  attributes['service'] = { value: service, type: 'string' }\n\n  if (config.tags) {\n    for (const [key, value] of Object.entries(config.tags)) {\n      attributes[key] = { value, type: 'string' }\n    }\n  }\n\n  for (const [key, value] of Object.entries(rest)) {\n    if (key === 'traceId' || key === 'spanId') continue\n    if (value === undefined || value === null) continue\n    const attr = toAttributeValue(value)\n    if (attr) {\n      attributes[key] = attr\n    }\n  }\n\n  return {\n    timestamp: new Date(timestamp).getTime() / 1000,\n    trace_id: traceId,\n    level: level as SentryLog['level'],\n    body,\n    severity_number: SEVERITY_MAP[level] ?? 9,\n    attributes,\n  }\n}\n\n/**\n * Build the Sentry Envelope body for a list of logs.\n *\n * Envelope format (line-delimited):\n * - Line 1: Envelope headers (dsn, sent_at)\n * - Line 2: Item header (type: log, item_count, content_type)\n * - Line 3: Item payload ({\"items\": [...]})\n */\nfunction buildEnvelopeBody(logs: SentryLog[], dsn: string): string {\n  const envelopeHeader = JSON.stringify({\n    dsn,\n    sent_at: new Date().toISOString(),\n  })\n\n  const itemHeader = JSON.stringify({\n    type: 'log',\n    item_count: logs.length,\n    content_type: 'application/vnd.sentry.items.log+json',\n  })\n\n  const itemPayload = JSON.stringify({ items: logs })\n\n  return `${envelopeHeader}\\n${itemHeader}\\n${itemPayload}\\n`\n}\n\n/**\n * Create a drain function for sending logs to Sentry.\n *\n * Sends wide events as Sentry Structured Logs, visible in Explore > Logs\n * in the Sentry dashboard.\n *\n * Configuration priority (highest to lowest):\n * 1. Overrides passed to createSentryDrain()\n * 2. runtimeConfig.evlog.sentry\n * 3. runtimeConfig.sentry\n * 4. Environment variables: NUXT_SENTRY_*, SENTRY_*\n *\n * @example\n * ```ts\n * // Zero config - just set NUXT_SENTRY_DSN env var\n * nitroApp.hooks.hook('evlog:drain', createSentryDrain())\n *\n * // With overrides\n * nitroApp.hooks.hook('evlog:drain', createSentryDrain({\n *   dsn: 'https://public@o0.ingest.sentry.io/123',\n * }))\n * ```\n */\nexport function createSentryDrain(overrides?: Partial<SentryConfig>): (ctx: DrainContext | DrainContext[]) => Promise<void> {\n  return async (ctx: DrainContext | DrainContext[]) => {\n    const contexts = Array.isArray(ctx) ? ctx : [ctx]\n    if (contexts.length === 0) return\n\n    const runtimeConfig = getRuntimeConfig()\n    const evlogSentry = runtimeConfig?.evlog?.sentry\n    const rootSentry = runtimeConfig?.sentry\n\n    const config: Partial<SentryConfig> = {\n      dsn: overrides?.dsn ?? evlogSentry?.dsn ?? rootSentry?.dsn ?? process.env.NUXT_SENTRY_DSN ?? process.env.SENTRY_DSN,\n      environment: overrides?.environment ?? evlogSentry?.environment ?? rootSentry?.environment ?? process.env.NUXT_SENTRY_ENVIRONMENT ?? process.env.SENTRY_ENVIRONMENT,\n      release: overrides?.release ?? evlogSentry?.release ?? rootSentry?.release ?? process.env.NUXT_SENTRY_RELEASE ?? process.env.SENTRY_RELEASE,\n      tags: overrides?.tags ?? evlogSentry?.tags ?? rootSentry?.tags,\n      timeout: overrides?.timeout ?? evlogSentry?.timeout ?? rootSentry?.timeout,\n    }\n\n    if (!config.dsn) {\n      console.error('[evlog/sentry] Missing DSN. Set NUXT_SENTRY_DSN/SENTRY_DSN env var or pass to createSentryDrain()')\n      return\n    }\n\n    try {\n      await sendBatchToSentry(contexts.map(c => c.event), config as SentryConfig)\n    } catch (error) {\n      console.error('[evlog/sentry] Failed to send events to Sentry:', error)\n    }\n  }\n}\n\n/**\n * Send a single event to Sentry as a structured log.\n *\n * @example\n * ```ts\n * await sendToSentry(event, {\n *   dsn: process.env.SENTRY_DSN!,\n * })\n * ```\n */\nexport async function sendToSentry(event: WideEvent, config: SentryConfig): Promise<void> {\n  await sendBatchToSentry([event], config)\n}\n\n/**\n * Send a batch of events to Sentry as structured logs via the Envelope endpoint.\n *\n * @example\n * ```ts\n * await sendBatchToSentry(events, {\n *   dsn: process.env.SENTRY_DSN!,\n * })\n * ```\n */\nexport async function sendBatchToSentry(events: WideEvent[], config: SentryConfig): Promise<void> {\n  if (events.length === 0) return\n\n  const { url, authHeader } = getSentryEnvelopeUrl(config.dsn)\n  const timeout = config.timeout ?? 5000\n\n  const logs = events.map(event => toSentryLog(event, config))\n  const body = buildEnvelopeBody(logs, config.dsn)\n\n  const controller = new AbortController()\n  const timeoutId = setTimeout(() => controller.abort(), timeout)\n\n  try {\n    const response = await fetch(url, {\n      method: 'POST',\n      headers: {\n        'Content-Type': 'application/x-sentry-envelope',\n        'X-Sentry-Auth': authHeader,\n      },\n      body,\n      signal: controller.signal,\n    })\n\n    if (!response.ok) {\n      const text = await response.text().catch(() => 'Unknown error')\n      const safeText = text.length > 200 ? `${text.slice(0, 200)}...[truncated]` : text\n      throw new Error(`Sentry API error: ${response.status} ${response.statusText} - ${safeText}`)\n    }\n  } finally {\n    clearTimeout(timeoutId)\n  }\n}\n"],"mappings":"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"}

package/dist/enrichers.d.mts

@@ -0,0 +1,74 @@
+import { EnrichContext } from "./types.mjs";
+
+//#region src/enrichers/index.d.ts
+interface EnricherOptions {
+  /**
+   * When true, overwrite any existing fields in the event.
+   * Defaults to false to preserve user-provided data.
+   */
+  overwrite?: boolean;
+}
+interface UserAgentInfo {
+  raw: string;
+  browser?: {
+    name: string;
+    version?: string;
+  };
+  os?: {
+    name: string;
+    version?: string;
+  };
+  device?: {
+    type: 'mobile' | 'tablet' | 'desktop' | 'bot' | 'unknown';
+  };
+}
+interface GeoInfo {
+  country?: string;
+  region?: string;
+  regionCode?: string;
+  city?: string;
+  latitude?: number;
+  longitude?: number;
+}
+interface RequestSizeInfo {
+  requestBytes?: number;
+  responseBytes?: number;
+}
+interface TraceContextInfo {
+  traceparent?: string;
+  tracestate?: string;
+  traceId?: string;
+  spanId?: string;
+}
+/**
+ * Enrich events with parsed user agent data.
+ * Sets `event.userAgent` with `UserAgentInfo` shape: `{ raw, browser?, os?, device? }`.
+ */
+declare function createUserAgentEnricher(options?: EnricherOptions): (ctx: EnrichContext) => void;
+/**
+ * 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.
+ */
+declare function createGeoEnricher(options?: EnricherOptions): (ctx: EnrichContext) => void;
+/**
+ * Enrich events with request/response payload sizes.
+ * Sets `event.requestSize` with `RequestSizeInfo` shape: `{ requestBytes?, responseBytes? }`.
+ */
+declare function createRequestSizeEnricher(options?: EnricherOptions): (ctx: EnrichContext) => void;
+/**
+ * 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.
+ */
+declare function createTraceContextEnricher(options?: EnricherOptions): (ctx: EnrichContext) => void;
+//#endregion
+export { EnricherOptions, GeoInfo, RequestSizeInfo, TraceContextInfo, UserAgentInfo, createGeoEnricher, createRequestSizeEnricher, createTraceContextEnricher, createUserAgentEnricher };
+//# sourceMappingURL=enrichers.d.mts.map

package/dist/enrichers.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enrichers.d.mts","names":[],"sources":["../src/enrichers/index.ts"],"mappings":";;;UAEiB,eAAA;;AAAjB;;;EAKE,SAAA;AAAA;AAAA,UAGe,aAAA;EACf,GAAA;EACA,OAAA;IAAY,IAAA;IAAc,OAAA;EAAA;EAC1B,EAAA;IAAO,IAAA;IAAc,OAAA;EAAA;EACrB,MAAA;IAAW,IAAA;EAAA;AAAA;AAAA,UAGI,OAAA;EACf,OAAA;EACA,MAAA;EACA,UAAA;EACA,IAAA;EACA,QAAA;EACA,SAAA;AAAA;AAAA,UAGe,eAAA;EACf,YAAA;EACA,aAAA;AAAA;AAAA,UAGe,gBAAA;EACf,WAAA;EACA,UAAA;EACA,OAAA;EACA,MAAA;AAAA;AAJF;;;;AAAA,iBAoGgB,uBAAA,CAAwB,OAAA,GAAS,eAAA,IAAwB,GAAA,EAAK,aAAA;;;;;;AAA9E;;;;;;;iBAqBgB,iBAAA,CAAkB,OAAA,GAAS,eAAA,IAAwB,GAAA,EAAK,aAAA;;;AAAxE;;iBAuBgB,yBAAA,CAA0B,OAAA,GAAS,eAAA,IAAwB,GAAA,EAAK,aAAA;;;;;;iBAoBhE,0BAAA,CAA2B,OAAA,GAAS,eAAA,IAAwB,GAAA,EAAK,aAAA"}