@safaricom-mxl/log 0.0.3

package/dist/adapters/sentry.mjs

@@ -0,0 +1,221 @@
+import { n as defineDrain, r as resolveAdapterConfig, t as httpPost } from "../_http-DmaJ426Z.mjs";
+import { t as OTEL_SEVERITY_NUMBER } from "../_severity-D_IU9-90.mjs";
+
+//#region src/adapters/sentry.ts
+const SENTRY_FIELDS = [
+	{
+		key: "dsn",
+		env: ["NUXT_SENTRY_DSN", "SENTRY_DSN"]
+	},
+	{
+		key: "environment",
+		env: ["NUXT_SENTRY_ENVIRONMENT", "SENTRY_ENVIRONMENT"]
+	},
+	{
+		key: "release",
+		env: ["NUXT_SENTRY_RELEASE", "SENTRY_RELEASE"]
+	},
+	{ key: "tags" },
+	{ key: "timeout" }
+];
+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
+	};
+}
+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=mxllog`;
+	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("");
+}
+function getFirstStringValue(event, keys) {
+	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;
+	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"
+	]) ?? "@safaricom-mxl/log 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: OTEL_SEVERITY_NUMBER[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) {
+	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.mxllog.sentry
+* 3. runtimeConfig.sentry
+* 4. Environment variables: NUXT_SENTRY_*, SENTRY_*
+*
+* @example
+* ```ts
+* // Zero config - just set NUXT_SENTRY_DSN env var
+* nitroApp.hooks.hook('@safaricom-mxl/log:drain', createSentryDrain())
+*
+* // With overrides
+* nitroApp.hooks.hook('@safaricom-mxl/log:drain', createSentryDrain({
+*   dsn: 'https://public@o0.ingest.sentry.io/123',
+* }))
+* ```
+*/
+function createSentryDrain(overrides) {
+	return defineDrain({
+		name: "sentry",
+		resolve: () => {
+			const config = resolveAdapterConfig("sentry", SENTRY_FIELDS, overrides);
+			if (!config.dsn) {
+				console.error("[mxllog/sentry] Missing DSN. Set NUXT_SENTRY_DSN/SENTRY_DSN env var or pass to createSentryDrain()");
+				return null;
+			}
+			return config;
+		},
+		send: sendBatchToSentry
+	});
+}
+/**
+* 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);
+}
+/**
+* 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 body = buildEnvelopeBody(events.map((event) => toSentryLog(event, config)), config.dsn);
+	await httpPost({
+		url,
+		headers: {
+			"Content-Type": "application/x-sentry-envelope",
+			"X-Sentry-Auth": authHeader
+		},
+		body,
+		timeout: config.timeout ?? 5e3,
+		label: "Sentry"
+	});
+}
+
+//#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 { WideEvent } from '../types'\nimport type { ConfigField } from './_config'\nimport { resolveAdapterConfig } from './_config'\nimport { defineDrain } from './_drain'\nimport { httpPost } from './_http'\nimport { OTEL_SEVERITY_NUMBER } from './_severity'\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\nconst SENTRY_FIELDS: ConfigField<SentryConfig>[] = [\n  { key: 'dsn', env: ['NUXT_SENTRY_DSN', 'SENTRY_DSN'] },\n  { key: 'environment', env: ['NUXT_SENTRY_ENVIRONMENT', 'SENTRY_ENVIRONMENT'] },\n  { key: 'release', env: ['NUXT_SENTRY_RELEASE', 'SENTRY_RELEASE'] },\n  { key: 'tags' },\n  { key: 'timeout' },\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=mxllog`\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    ?? '@safaricom-mxl/log 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: OTEL_SEVERITY_NUMBER[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.mxllog.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('@safaricom-mxl/log:drain', createSentryDrain())\n *\n * // With overrides\n * nitroApp.hooks.hook('@safaricom-mxl/log:drain', createSentryDrain({\n *   dsn: 'https://public@o0.ingest.sentry.io/123',\n * }))\n * ```\n */\nexport function createSentryDrain(overrides?: Partial<SentryConfig>) {\n  return defineDrain<SentryConfig>({\n    name: 'sentry',\n    resolve: () => {\n      const config = resolveAdapterConfig<SentryConfig>('sentry', SENTRY_FIELDS, overrides)\n      if (!config.dsn) {\n        console.error('[mxllog/sentry] Missing DSN. Set NUXT_SENTRY_DSN/SENTRY_DSN env var or pass to createSentryDrain()')\n        return null\n      }\n      return config as SentryConfig\n    },\n    send: sendBatchToSentry,\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\n  const logs = events.map(event => toSentryLog(event, config))\n  const body = buildEnvelopeBody(logs, config.dsn)\n\n  await httpPost({\n    url,\n    headers: {\n      'Content-Type': 'application/x-sentry-envelope',\n      'X-Sentry-Auth': authHeader,\n    },\n    body,\n    timeout: config.timeout ?? 5000,\n    label: 'Sentry',\n  })\n}\n"],"mappings":"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"}

package/dist/browser.d.mts

@@ -0,0 +1,63 @@
+import { DrainContext } from "./types.mjs";
+import { DrainPipelineOptions, PipelineDrainFn } from "./pipeline.mjs";
+
+//#region src/browser.d.ts
+interface BrowserDrainConfig {
+  /** URL of the server ingest endpoint */
+  endpoint: string;
+  /** Custom headers sent with each fetch request (e.g. Authorization, X-API-Key). Not applied to sendBeacon — see `useBeacon`. */
+  headers?: Record<string, string>;
+  /** Request timeout in milliseconds. @default 5000 */
+  timeout?: number;
+  /** Use sendBeacon when the page is hidden. @default true */
+  useBeacon?: boolean;
+}
+interface BrowserLogDrainOptions {
+  /** Browser drain configuration (endpoint is required) */
+  drain: BrowserDrainConfig;
+  /** Pipeline configuration overrides */
+  pipeline?: DrainPipelineOptions<DrainContext>;
+  /** Auto-register visibilitychange flush listener. @default true */
+  autoFlush?: boolean;
+}
+/**
+ * Create a low-level browser drain transport function.
+ *
+ * Returns a function compatible with `createDrainPipeline` that sends batches
+ * to the configured endpoint via `fetch` (with `keepalive: true`) or
+ * `navigator.sendBeacon` when the page is hidden.
+ *
+ * @example
+ * ```ts
+ * import { createBrowserDrain } from '@safaricom-mxl/log/browser'
+ * import { createDrainPipeline } from '@safaricom-mxl/log/pipeline'
+ *
+ * const pipeline = createDrainPipeline({ batch: { size: 50 } })
+ * const drain = pipeline(createBrowserDrain({ endpoint: '/api/logs' }))
+ * ```
+ */
+declare function createBrowserDrain(config: BrowserDrainConfig): (batch: DrainContext[]) => Promise<void>;
+/**
+ * Create a pre-composed browser log drain with pipeline, batching, and auto-flush.
+ *
+ * Returns a `PipelineDrainFn<DrainContext>` directly usable with `initLogger({ drain })`.
+ *
+ * @example
+ * ```ts
+ * import { initLogger, log } from '@safaricom-mxl/log'
+ * import { createBrowserLogDrain } from '@safaricom-mxl/log/browser'
+ *
+ * const drain = createBrowserLogDrain({
+ *   drain: { endpoint: '/api/logs' },
+ * })
+ * initLogger({ drain })
+ *
+ * log.info({ action: 'page_view', path: location.pathname })
+ * ```
+ */
+declare function createBrowserLogDrain(options: BrowserLogDrainOptions): PipelineDrainFn<DrainContext> & {
+  dispose: () => void;
+};
+//#endregion
+export { BrowserDrainConfig, BrowserLogDrainOptions, createBrowserDrain, createBrowserLogDrain };
+//# sourceMappingURL=browser.d.mts.map

package/dist/browser.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.d.mts","names":[],"sources":["../src/browser.ts"],"mappings":";;;;UAIiB,kBAAA;;EAEf,QAAA;EAFiC;EAIjC,OAAA,GAAU,MAAA;EAAM;EAEhB,OAAA;EAFA;EAIA,SAAA;AAAA;AAAA,UAGe,sBAAA;EAHN;EAKT,KAAA,EAAO,kBAAA;EAFQ;EAIf,QAAA,GAAW,oBAAA,CAAqB,YAAA;;EAEhC,SAAA;AAAA;;;;;;;;;;;;AAmBF;;;;;iBAAgB,kBAAA,CAAmB,MAAA,EAAQ,kBAAA,IAAsB,KAAA,EAAO,YAAA,OAAmB,OAAA;;;;;;;;;;AA8D3F;;;;;;;;;iBAAgB,qBAAA,CAAsB,OAAA,EAAS,sBAAA,GAAyB,eAAA,CAAgB,YAAA;EAAkB,OAAA;AAAA"}

package/dist/browser.mjs

@@ -0,0 +1,95 @@
+import { createDrainPipeline } from "./pipeline.mjs";
+
+//#region src/browser.ts
+/**
+* Create a low-level browser drain transport function.
+*
+* Returns a function compatible with `createDrainPipeline` that sends batches
+* to the configured endpoint via `fetch` (with `keepalive: true`) or
+* `navigator.sendBeacon` when the page is hidden.
+*
+* @example
+* ```ts
+* import { createBrowserDrain } from '@safaricom-mxl/log/browser'
+* import { createDrainPipeline } from '@safaricom-mxl/log/pipeline'
+*
+* const pipeline = createDrainPipeline({ batch: { size: 50 } })
+* const drain = pipeline(createBrowserDrain({ endpoint: '/api/logs' }))
+* ```
+*/
+function createBrowserDrain(config) {
+	const { endpoint, headers: customHeaders, timeout = 5e3, useBeacon = true } = config;
+	return async (batch) => {
+		if (batch.length === 0) return;
+		const body = JSON.stringify(batch);
+		if (useBeacon && typeof document !== "undefined" && document.visibilityState === "hidden" && typeof navigator !== "undefined" && typeof navigator.sendBeacon === "function") {
+			if (!navigator.sendBeacon(endpoint, new Blob([body], { type: "application/json" }))) throw new Error("[mxllog/browser] sendBeacon failed — payload may exceed browser limit");
+			return;
+		}
+		const controller = new AbortController();
+		const timeoutId = setTimeout(() => controller.abort(), timeout);
+		try {
+			const response = await fetch(endpoint, {
+				method: "POST",
+				headers: {
+					"Content-Type": "application/json",
+					...customHeaders
+				},
+				body,
+				signal: controller.signal,
+				keepalive: true,
+				credentials: "same-origin"
+			});
+			if (!response.ok) throw new Error(`[mxllog/browser] Server responded with ${response.status}`);
+		} finally {
+			clearTimeout(timeoutId);
+		}
+	};
+}
+/**
+* Create a pre-composed browser log drain with pipeline, batching, and auto-flush.
+*
+* Returns a `PipelineDrainFn<DrainContext>` directly usable with `initLogger({ drain })`.
+*
+* @example
+* ```ts
+* import { initLogger, log } from '@safaricom-mxl/log'
+* import { createBrowserLogDrain } from '@safaricom-mxl/log/browser'
+*
+* const drain = createBrowserLogDrain({
+*   drain: { endpoint: '/api/logs' },
+* })
+* initLogger({ drain })
+*
+* log.info({ action: 'page_view', path: location.pathname })
+* ```
+*/
+function createBrowserLogDrain(options) {
+	const { autoFlush = true } = options;
+	const drain = createDrainPipeline({
+		batch: {
+			size: 25,
+			intervalMs: 2e3
+		},
+		retry: { maxAttempts: 2 },
+		...options.pipeline
+	})(createBrowserDrain(options.drain));
+	let onVisibilityChange;
+	if (autoFlush && typeof document !== "undefined") {
+		onVisibilityChange = () => {
+			if (document.visibilityState === "hidden") drain.flush();
+		};
+		document.addEventListener("visibilitychange", onVisibilityChange);
+	}
+	drain.dispose = () => {
+		if (onVisibilityChange) {
+			document.removeEventListener("visibilitychange", onVisibilityChange);
+			onVisibilityChange = void 0;
+		}
+	};
+	return drain;
+}
+
+//#endregion
+export { createBrowserDrain, createBrowserLogDrain };
+//# sourceMappingURL=browser.mjs.map

package/dist/browser.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.mjs","names":[],"sources":["../src/browser.ts"],"sourcesContent":["import type { DrainContext } from './types'\nimport type { DrainPipelineOptions, PipelineDrainFn } from './pipeline'\nimport { createDrainPipeline } from './pipeline'\n\nexport interface BrowserDrainConfig {\n  /** URL of the server ingest endpoint */\n  endpoint: string\n  /** Custom headers sent with each fetch request (e.g. Authorization, X-API-Key). Not applied to sendBeacon — see `useBeacon`. */\n  headers?: Record<string, string>\n  /** Request timeout in milliseconds. @default 5000 */\n  timeout?: number\n  /** Use sendBeacon when the page is hidden. @default true */\n  useBeacon?: boolean\n}\n\nexport interface BrowserLogDrainOptions {\n  /** Browser drain configuration (endpoint is required) */\n  drain: BrowserDrainConfig\n  /** Pipeline configuration overrides */\n  pipeline?: DrainPipelineOptions<DrainContext>\n  /** Auto-register visibilitychange flush listener. @default true */\n  autoFlush?: boolean\n}\n\n/**\n * Create a low-level browser drain transport function.\n *\n * Returns a function compatible with `createDrainPipeline` that sends batches\n * to the configured endpoint via `fetch` (with `keepalive: true`) or\n * `navigator.sendBeacon` when the page is hidden.\n *\n * @example\n * ```ts\n * import { createBrowserDrain } from '@safaricom-mxl/log/browser'\n * import { createDrainPipeline } from '@safaricom-mxl/log/pipeline'\n *\n * const pipeline = createDrainPipeline({ batch: { size: 50 } })\n * const drain = pipeline(createBrowserDrain({ endpoint: '/api/logs' }))\n * ```\n */\nexport function createBrowserDrain(config: BrowserDrainConfig): (batch: DrainContext[]) => Promise<void> {\n  const { endpoint, headers: customHeaders, timeout = 5000, useBeacon = true } = config\n\n  return async (batch: DrainContext[]): Promise<void> => {\n    if (batch.length === 0) return\n\n    const body = JSON.stringify(batch)\n\n    if (\n      useBeacon\n      && typeof document !== 'undefined'\n      && document.visibilityState === 'hidden'\n      && typeof navigator !== 'undefined'\n      && typeof navigator.sendBeacon === 'function'\n    ) {\n      const queued = navigator.sendBeacon(endpoint, new Blob([body], { type: 'application/json' }))\n      if (!queued) {\n        throw new Error('[mxllog/browser] sendBeacon failed — payload may exceed browser limit')\n      }\n      return\n    }\n\n    const controller = new AbortController()\n    const timeoutId = setTimeout(() => controller.abort(), timeout)\n\n    try {\n      const response = await fetch(endpoint, {\n        method: 'POST',\n        headers: { 'Content-Type': 'application/json', ...customHeaders },\n        body,\n        signal: controller.signal,\n        keepalive: true,\n        credentials: 'same-origin',\n      })\n\n      if (!response.ok) {\n        throw new Error(`[mxllog/browser] Server responded with ${response.status}`)\n      }\n    } finally {\n      clearTimeout(timeoutId)\n    }\n  }\n}\n\n/**\n * Create a pre-composed browser log drain with pipeline, batching, and auto-flush.\n *\n * Returns a `PipelineDrainFn<DrainContext>` directly usable with `initLogger({ drain })`.\n *\n * @example\n * ```ts\n * import { initLogger, log } from '@safaricom-mxl/log'\n * import { createBrowserLogDrain } from '@safaricom-mxl/log/browser'\n *\n * const drain = createBrowserLogDrain({\n *   drain: { endpoint: '/api/logs' },\n * })\n * initLogger({ drain })\n *\n * log.info({ action: 'page_view', path: location.pathname })\n * ```\n */\nexport function createBrowserLogDrain(options: BrowserLogDrainOptions): PipelineDrainFn<DrainContext> & { dispose: () => void } {\n  const { autoFlush = true } = options\n\n  const pipeline = createDrainPipeline<DrainContext>({\n    batch: { size: 25, intervalMs: 2000 },\n    retry: { maxAttempts: 2 },\n    ...options.pipeline,\n  })\n\n  const drain = pipeline(createBrowserDrain(options.drain)) as PipelineDrainFn<DrainContext> & { dispose: () => void }\n\n  let onVisibilityChange: (() => void) | undefined\n\n  if (autoFlush && typeof document !== 'undefined') {\n    onVisibilityChange = () => {\n      if (document.visibilityState === 'hidden') {\n        drain.flush()\n      }\n    }\n    document.addEventListener('visibilitychange', onVisibilityChange)\n  }\n\n  drain.dispose = () => {\n    if (onVisibilityChange) {\n      document.removeEventListener('visibilitychange', onVisibilityChange)\n      onVisibilityChange = undefined\n    }\n  }\n\n  return drain\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAwCA,SAAgB,mBAAmB,QAAsE;CACvG,MAAM,EAAE,UAAU,SAAS,eAAe,UAAU,KAAM,YAAY,SAAS;AAE/E,QAAO,OAAO,UAAyC;AACrD,MAAI,MAAM,WAAW,EAAG;EAExB,MAAM,OAAO,KAAK,UAAU,MAAM;AAElC,MACE,aACG,OAAO,aAAa,eACpB,SAAS,oBAAoB,YAC7B,OAAO,cAAc,eACrB,OAAO,UAAU,eAAe,YACnC;AAEA,OAAI,CADW,UAAU,WAAW,UAAU,IAAI,KAAK,CAAC,KAAK,EAAE,EAAE,MAAM,oBAAoB,CAAC,CAAC,CAE3F,OAAM,IAAI,MAAM,wEAAwE;AAE1F;;EAGF,MAAM,aAAa,IAAI,iBAAiB;EACxC,MAAM,YAAY,iBAAiB,WAAW,OAAO,EAAE,QAAQ;AAE/D,MAAI;GACF,MAAM,WAAW,MAAM,MAAM,UAAU;IACrC,QAAQ;IACR,SAAS;KAAE,gBAAgB;KAAoB,GAAG;KAAe;IACjE;IACA,QAAQ,WAAW;IACnB,WAAW;IACX,aAAa;IACd,CAAC;AAEF,OAAI,CAAC,SAAS,GACZ,OAAM,IAAI,MAAM,0CAA0C,SAAS,SAAS;YAEtE;AACR,gBAAa,UAAU;;;;;;;;;;;;;;;;;;;;;;AAuB7B,SAAgB,sBAAsB,SAA0F;CAC9H,MAAM,EAAE,YAAY,SAAS;CAQ7B,MAAM,QANW,oBAAkC;EACjD,OAAO;GAAE,MAAM;GAAI,YAAY;GAAM;EACrC,OAAO,EAAE,aAAa,GAAG;EACzB,GAAG,QAAQ;EACZ,CAAC,CAEqB,mBAAmB,QAAQ,MAAM,CAAC;CAEzD,IAAI;AAEJ,KAAI,aAAa,OAAO,aAAa,aAAa;AAChD,6BAA2B;AACzB,OAAI,SAAS,oBAAoB,SAC/B,OAAM,OAAO;;AAGjB,WAAS,iBAAiB,oBAAoB,mBAAmB;;AAGnE,OAAM,gBAAgB;AACpB,MAAI,oBAAoB;AACtB,YAAS,oBAAoB,oBAAoB,mBAAmB;AACpE,wBAAqB;;;AAIzB,QAAO"}

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"}

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