evlog 1.6.0 → 1.7.0

package/README.md

@@ -390,6 +390,44 @@ Notes:
 - `request.cf` is included (colo, country, asn) unless disabled
 - Use `headerAllowlist` to avoid logging sensitive headers
 
+## Enrichment Hook
+
+Use the `evlog:enrich` hook to add derived context after emit, before drain.
+
+```typescript
+// server/plugins/evlog-enrich.ts
+export default defineNitroPlugin((nitroApp) => {
+  nitroApp.hooks.hook('evlog:enrich', (ctx) => {
+    ctx.event.deploymentId = process.env.DEPLOYMENT_ID
+  })
+})
+```
+
+### Built-in Enrichers
+
+```typescript
+// server/plugins/evlog-enrich.ts
+import {
+  createGeoEnricher,
+  createRequestSizeEnricher,
+  createTraceContextEnricher,
+  createUserAgentEnricher,
+} from 'evlog/enrichers'
+
+export default defineNitroPlugin((nitroApp) => {
+  const enrich = [
+    createUserAgentEnricher(),
+    createGeoEnricher(),
+    createRequestSizeEnricher(),
+    createTraceContextEnricher(),
+  ]
+
+  nitroApp.hooks.hook('evlog:enrich', (ctx) => {
+    for (const enricher of enrich) enricher(ctx)
+  })
+})
+```
+
 ## Adapters
 
 Send your logs to external observability platforms with built-in adapters.
@@ -486,6 +524,63 @@ export default defineNitroPlugin((nitroApp) => {
 
 > See the [full documentation](https://evlog.hrcd.fr/adapters/overview) for adapter configuration options, troubleshooting, and advanced patterns.
 
+## Drain Pipeline
+
+For production use, wrap your drain adapter with `createDrainPipeline` to get **batching**, **retry with backoff**, and **buffer overflow protection**.
+
+Without a pipeline, each event triggers a separate network call. The pipeline buffers events and sends them in batches, reducing overhead and handling transient failures automatically.
+
+```typescript
+// server/plugins/evlog-drain.ts
+import type { DrainContext } from 'evlog'
+import { createDrainPipeline } from 'evlog/pipeline'
+import { createAxiomDrain } from 'evlog/axiom'
+
+export default defineNitroPlugin((nitroApp) => {
+  const pipeline = createDrainPipeline<DrainContext>({
+    batch: { size: 50, intervalMs: 5000 },
+    retry: { maxAttempts: 3, backoff: 'exponential', initialDelayMs: 1000 },
+    onDropped: (events, error) => {
+      console.error(`[evlog] Dropped ${events.length} events:`, error?.message)
+    },
+  })
+
+  const drain = pipeline(createAxiomDrain())
+
+  nitroApp.hooks.hook('evlog:drain', drain)
+  nitroApp.hooks.hook('close', () => drain.flush())
+})
+```
+
+### How it works
+
+1. Events are buffered in memory as they arrive
+2. A batch is flushed when either the **batch size** is reached or the **interval** expires (whichever comes first)
+3. If the drain function fails, the batch is retried with the configured **backoff strategy**
+4. If all retries are exhausted, `onDropped` is called with the lost events
+5. If the buffer exceeds `maxBufferSize`, the oldest events are dropped to prevent memory leaks
+
+### Options
+
+| Option | Default | Description |
+|--------|---------|-------------|
+| `batch.size` | `50` | Maximum events per batch |
+| `batch.intervalMs` | `5000` | Max time (ms) before flushing a partial batch |
+| `retry.maxAttempts` | `3` | Total attempts (including first) |
+| `retry.backoff` | `'exponential'` | `'exponential'` \| `'linear'` \| `'fixed'` |
+| `retry.initialDelayMs` | `1000` | Base delay for first retry |
+| `retry.maxDelayMs` | `30000` | Upper bound for any retry delay |
+| `maxBufferSize` | `1000` | Max buffered events before dropping oldest |
+| `onDropped` | — | Callback when events are dropped |
+
+### Returned drain function
+
+The function returned by `pipeline(drain)` is hook-compatible and exposes:
+
+- **`drain(ctx)`** — Push a single event into the buffer
+- **`drain.flush()`** — Force-flush all buffered events (call on server shutdown)
+- **`drain.pending`** — Number of events currently buffered
+
 ## API Reference
 
 ### `initLogger(config)`

package/dist/_utils-DZA9nou3.mjs

@@ -0,0 +1,23 @@
+import { createRequire } from "node:module";
+
+//#region \0rolldown/runtime.js
+var __require = /* @__PURE__ */ createRequire(import.meta.url);
+
+//#endregion
+//#region src/adapters/_utils.ts
+/**
+* Try to get runtime config from Nitro/Nuxt environment.
+* Returns undefined if not in a Nitro context.
+*/
+function getRuntimeConfig() {
+	try {
+		const { useRuntimeConfig } = __require("nitropack/runtime");
+		return useRuntimeConfig();
+	} catch {
+		return;
+	}
+}
+
+//#endregion
+export { getRuntimeConfig as t };
+//# sourceMappingURL=_utils-DZA9nou3.mjs.map

package/dist/_utils-DZA9nou3.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"_utils-DZA9nou3.mjs","names":[],"sources":["../src/adapters/_utils.ts"],"sourcesContent":["/**\n * Try to get runtime config from Nitro/Nuxt environment.\n * Returns undefined if not in a Nitro context.\n */\nexport function getRuntimeConfig(): Record<string, any> | undefined {\n  try {\n    // eslint-disable-next-line @typescript-eslint/no-require-imports\n    const { useRuntimeConfig } = require('nitropack/runtime')\n    return useRuntimeConfig()\n  } catch {\n    return undefined\n  }\n}\n"],"mappings":";;;;;;;;;;;AAIA,SAAgB,mBAAoD;AAClE,KAAI;EAEF,MAAM,EAAE,+BAA6B,oBAAoB;AACzD,SAAO,kBAAkB;SACnB;AACN"}

package/dist/adapters/axiom.d.mts

@@ -1,16 +1,17 @@
-import { DrainContext, WideEvent } from '../types.mjs';
+import { DrainContext, WideEvent } from "../types.mjs";
 
+//#region src/adapters/axiom.d.ts
 interface AxiomConfig {
-    /** Axiom dataset name */
-    dataset: string;
-    /** Axiom API token */
-    token: string;
-    /** Organization ID (required for Personal Access Tokens) */
-    orgId?: string;
-    /** Base URL for Axiom API. Default: https://api.axiom.co */
-    baseUrl?: string;
-    /** Request timeout in milliseconds. Default: 5000 */
-    timeout?: number;
+  /** Axiom dataset name */
+  dataset: string;
+  /** Axiom API token */
+  token: string;
+  /** Organization ID (required for Personal Access Tokens) */
+  orgId?: string;
+  /** Base URL for Axiom API. Default: https://api.axiom.co */
+  baseUrl?: string;
+  /** Request timeout in milliseconds. Default: 5000 */
+  timeout?: number;
 }
 /**
  * Create a drain function for sending logs to Axiom.
@@ -32,7 +33,7 @@ interface AxiomConfig {
  * }))
  * ```
  */
-declare function createAxiomDrain(overrides?: Partial<AxiomConfig>): (ctx: DrainContext) => Promise<void>;
+declare function createAxiomDrain(overrides?: Partial<AxiomConfig>): (ctx: DrainContext | DrainContext[]) => Promise<void>;
 /**
  * Send a single event to Axiom.
  *
@@ -57,6 +58,6 @@ declare function sendToAxiom(event: WideEvent, config: AxiomConfig): Promise<voi
  * ```
  */
 declare function sendBatchToAxiom(events: WideEvent[], config: AxiomConfig): Promise<void>;
-
-export { createAxiomDrain, sendBatchToAxiom, sendToAxiom };
-export type { AxiomConfig };
+//#endregion
+export { AxiomConfig, createAxiomDrain, sendBatchToAxiom, sendToAxiom };
+//# sourceMappingURL=axiom.d.mts.map

package/dist/adapters/axiom.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"axiom.d.mts","names":[],"sources":["../../src/adapters/axiom.ts"],"mappings":";;;UAGiB,WAAA;;EAEf,OAAA;EAF0B;EAI1B,KAAA;EAJ0B;EAM1B,KAAA;EAFA;EAIA,OAAA;EAAA;EAEA,OAAA;AAAA;;AAuBF;;;;;;;;;;;;;;;;;;;iBAAgB,gBAAA,CAAiB,SAAA,GAAY,OAAA,CAAQ,WAAA,KAAgB,GAAA,EAAK,YAAA,GAAe,YAAA,OAAmB,OAAA;;;;;;;;;;;;iBA2CtF,WAAA,CAAY,KAAA,EAAO,SAAA,EAAW,MAAA,EAAQ,WAAA,GAAc,OAAA;;;AAe1E;;;;;;;;;iBAAsB,gBAAA,CAAiB,MAAA,EAAQ,SAAA,IAAa,MAAA,EAAQ,WAAA,GAAc,OAAA"}

package/dist/adapters/axiom.mjs

@@ -1,59 +1,104 @@
-import { g as getRuntimeConfig } from '../shared/evlog.Bc35pxiY.mjs';
+import { t as getRuntimeConfig } from "../_utils-DZA9nou3.mjs";
 
+//#region src/adapters/axiom.ts
+/**
+* Create a drain function for sending logs to Axiom.
+*
+* Configuration priority (highest to lowest):
+* 1. Overrides passed to createAxiomDrain()
+* 2. runtimeConfig.evlog.axiom
+* 3. runtimeConfig.axiom
+* 4. Environment variables: NUXT_AXIOM_*, AXIOM_*
+*
+* @example
+* ```ts
+* // Zero config - just set NUXT_AXIOM_TOKEN and NUXT_AXIOM_DATASET env vars
+* nitroApp.hooks.hook('evlog:drain', createAxiomDrain())
+*
+* // With overrides
+* nitroApp.hooks.hook('evlog:drain', createAxiomDrain({
+*   dataset: 'my-dataset',
+* }))
+* ```
+*/
 function createAxiomDrain(overrides) {
-  return async (ctx) => {
-    const runtimeConfig = getRuntimeConfig();
-    const evlogAxiom = runtimeConfig?.evlog?.axiom;
-    const rootAxiom = runtimeConfig?.axiom;
-    const config = {
-      dataset: overrides?.dataset ?? evlogAxiom?.dataset ?? rootAxiom?.dataset ?? process.env.NUXT_AXIOM_DATASET ?? process.env.AXIOM_DATASET,
-      token: overrides?.token ?? evlogAxiom?.token ?? rootAxiom?.token ?? process.env.NUXT_AXIOM_TOKEN ?? process.env.AXIOM_TOKEN,
-      orgId: overrides?.orgId ?? evlogAxiom?.orgId ?? rootAxiom?.orgId ?? process.env.NUXT_AXIOM_ORG_ID ?? process.env.AXIOM_ORG_ID,
-      baseUrl: overrides?.baseUrl ?? evlogAxiom?.baseUrl ?? rootAxiom?.baseUrl ?? process.env.NUXT_AXIOM_URL ?? process.env.AXIOM_URL,
-      timeout: overrides?.timeout ?? evlogAxiom?.timeout ?? rootAxiom?.timeout
-    };
-    if (!config.dataset || !config.token) {
-      console.error("[evlog/axiom] Missing dataset or token. Set NUXT_AXIOM_TOKEN/NUXT_AXIOM_DATASET env vars or pass to createAxiomDrain()");
-      return;
-    }
-    try {
-      await sendToAxiom(ctx.event, config);
-    } catch (error) {
-      console.error("[evlog/axiom] Failed to send event:", error);
-    }
-  };
+	return async (ctx) => {
+		const contexts = Array.isArray(ctx) ? ctx : [ctx];
+		if (contexts.length === 0) return;
+		const runtimeConfig = getRuntimeConfig();
+		const evlogAxiom = runtimeConfig?.evlog?.axiom;
+		const rootAxiom = runtimeConfig?.axiom;
+		const config = {
+			dataset: overrides?.dataset ?? evlogAxiom?.dataset ?? rootAxiom?.dataset ?? process.env.NUXT_AXIOM_DATASET ?? process.env.AXIOM_DATASET,
+			token: overrides?.token ?? evlogAxiom?.token ?? rootAxiom?.token ?? process.env.NUXT_AXIOM_TOKEN ?? process.env.AXIOM_TOKEN,
+			orgId: overrides?.orgId ?? evlogAxiom?.orgId ?? rootAxiom?.orgId ?? process.env.NUXT_AXIOM_ORG_ID ?? process.env.AXIOM_ORG_ID,
+			baseUrl: overrides?.baseUrl ?? evlogAxiom?.baseUrl ?? rootAxiom?.baseUrl ?? process.env.NUXT_AXIOM_URL ?? process.env.AXIOM_URL,
+			timeout: overrides?.timeout ?? evlogAxiom?.timeout ?? rootAxiom?.timeout
+		};
+		if (!config.dataset || !config.token) {
+			console.error("[evlog/axiom] Missing dataset or token. Set NUXT_AXIOM_TOKEN/NUXT_AXIOM_DATASET env vars or pass to createAxiomDrain()");
+			return;
+		}
+		try {
+			await sendBatchToAxiom(contexts.map((c) => c.event), config);
+		} catch (error) {
+			console.error("[evlog/axiom] Failed to send events to Axiom:", error);
+		}
+	};
 }
+/**
+* Send a single event to Axiom.
+*
+* @example
+* ```ts
+* await sendToAxiom(event, {
+*   dataset: 'my-logs',
+*   token: process.env.AXIOM_TOKEN!,
+* })
+* ```
+*/
 async function sendToAxiom(event, config) {
-  await sendBatchToAxiom([event], config);
+	await sendBatchToAxiom([event], config);
 }
+/**
+* Send a batch of events to Axiom.
+*
+* @example
+* ```ts
+* await sendBatchToAxiom(events, {
+*   dataset: 'my-logs',
+*   token: process.env.AXIOM_TOKEN!,
+* })
+* ```
+*/
 async function sendBatchToAxiom(events, config) {
-  const baseUrl = config.baseUrl ?? "https://api.axiom.co";
-  const timeout = config.timeout ?? 5e3;
-  const url = `${baseUrl}/v1/datasets/${encodeURIComponent(config.dataset)}/ingest`;
-  const headers = {
-    "Content-Type": "application/json",
-    "Authorization": `Bearer ${config.token}`
-  };
-  if (config.orgId) {
-    headers["X-Axiom-Org-Id"] = config.orgId;
-  }
-  const controller = new AbortController();
-  const timeoutId = setTimeout(() => controller.abort(), timeout);
-  try {
-    const response = await fetch(url, {
-      method: "POST",
-      headers,
-      body: JSON.stringify(events),
-      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(`Axiom API error: ${response.status} ${response.statusText} - ${safeText}`);
-    }
-  } finally {
-    clearTimeout(timeoutId);
-  }
+	const baseUrl = config.baseUrl ?? "https://api.axiom.co";
+	const timeout = config.timeout ?? 5e3;
+	const url = `${baseUrl}/v1/datasets/${encodeURIComponent(config.dataset)}/ingest`;
+	const headers = {
+		"Content-Type": "application/json",
+		"Authorization": `Bearer ${config.token}`
+	};
+	if (config.orgId) headers["X-Axiom-Org-Id"] = config.orgId;
+	const controller = new AbortController();
+	const timeoutId = setTimeout(() => controller.abort(), timeout);
+	try {
+		const response = await fetch(url, {
+			method: "POST",
+			headers,
+			body: JSON.stringify(events),
+			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(`Axiom API error: ${response.status} ${response.statusText} - ${safeText}`);
+		}
+	} finally {
+		clearTimeout(timeoutId);
+	}
 }
 
+//#endregion
 export { createAxiomDrain, sendBatchToAxiom, sendToAxiom };
+//# sourceMappingURL=axiom.mjs.map

package/dist/adapters/axiom.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"axiom.mjs","names":[],"sources":["../../src/adapters/axiom.ts"],"sourcesContent":["import type { DrainContext, WideEvent } from '../types'\nimport { getRuntimeConfig } from './_utils'\n\nexport interface AxiomConfig {\n  /** Axiom dataset name */\n  dataset: string\n  /** Axiom API token */\n  token: string\n  /** Organization ID (required for Personal Access Tokens) */\n  orgId?: string\n  /** Base URL for Axiom API. Default: https://api.axiom.co */\n  baseUrl?: string\n  /** Request timeout in milliseconds. Default: 5000 */\n  timeout?: number\n}\n\n/**\n * Create a drain function for sending logs to Axiom.\n *\n * Configuration priority (highest to lowest):\n * 1. Overrides passed to createAxiomDrain()\n * 2. runtimeConfig.evlog.axiom\n * 3. runtimeConfig.axiom\n * 4. Environment variables: NUXT_AXIOM_*, AXIOM_*\n *\n * @example\n * ```ts\n * // Zero config - just set NUXT_AXIOM_TOKEN and NUXT_AXIOM_DATASET env vars\n * nitroApp.hooks.hook('evlog:drain', createAxiomDrain())\n *\n * // With overrides\n * nitroApp.hooks.hook('evlog:drain', createAxiomDrain({\n *   dataset: 'my-dataset',\n * }))\n * ```\n */\nexport function createAxiomDrain(overrides?: Partial<AxiomConfig>): (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    // Support both runtimeConfig.evlog.axiom and runtimeConfig.axiom\n    const evlogAxiom = runtimeConfig?.evlog?.axiom\n    const rootAxiom = runtimeConfig?.axiom\n\n    // Build config with fallbacks: overrides > evlog.axiom > axiom > env vars (NUXT_AXIOM_* or AXIOM_*)\n    const config: Partial<AxiomConfig> = {\n      dataset: overrides?.dataset ?? evlogAxiom?.dataset ?? rootAxiom?.dataset ?? process.env.NUXT_AXIOM_DATASET ?? process.env.AXIOM_DATASET,\n      token: overrides?.token ?? evlogAxiom?.token ?? rootAxiom?.token ?? process.env.NUXT_AXIOM_TOKEN ?? process.env.AXIOM_TOKEN,\n      orgId: overrides?.orgId ?? evlogAxiom?.orgId ?? rootAxiom?.orgId ?? process.env.NUXT_AXIOM_ORG_ID ?? process.env.AXIOM_ORG_ID,\n      baseUrl: overrides?.baseUrl ?? evlogAxiom?.baseUrl ?? rootAxiom?.baseUrl ?? process.env.NUXT_AXIOM_URL ?? process.env.AXIOM_URL,\n      timeout: overrides?.timeout ?? evlogAxiom?.timeout ?? rootAxiom?.timeout,\n    }\n\n    if (!config.dataset || !config.token) {\n      console.error('[evlog/axiom] Missing dataset or token. Set NUXT_AXIOM_TOKEN/NUXT_AXIOM_DATASET env vars or pass to createAxiomDrain()')\n      return\n    }\n\n    try {\n      await sendBatchToAxiom(contexts.map(c => c.event), config as AxiomConfig)\n    } catch (error) {\n      console.error('[evlog/axiom] Failed to send events to Axiom:', error)\n    }\n  }\n}\n\n/**\n * Send a single event to Axiom.\n *\n * @example\n * ```ts\n * await sendToAxiom(event, {\n *   dataset: 'my-logs',\n *   token: process.env.AXIOM_TOKEN!,\n * })\n * ```\n */\nexport async function sendToAxiom(event: WideEvent, config: AxiomConfig): Promise<void> {\n  await sendBatchToAxiom([event], config)\n}\n\n/**\n * Send a batch of events to Axiom.\n *\n * @example\n * ```ts\n * await sendBatchToAxiom(events, {\n *   dataset: 'my-logs',\n *   token: process.env.AXIOM_TOKEN!,\n * })\n * ```\n */\nexport async function sendBatchToAxiom(events: WideEvent[], config: AxiomConfig): Promise<void> {\n  const baseUrl = config.baseUrl ?? 'https://api.axiom.co'\n  const timeout = config.timeout ?? 5000\n  const url = `${baseUrl}/v1/datasets/${encodeURIComponent(config.dataset)}/ingest`\n\n  const headers: Record<string, string> = {\n    'Content-Type': 'application/json',\n    'Authorization': `Bearer ${config.token}`,\n  }\n\n  if (config.orgId) {\n    headers['X-Axiom-Org-Id'] = config.orgId\n  }\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      body: JSON.stringify(events),\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(`Axiom API error: ${response.status} ${response.statusText} - ${safeText}`)\n    }\n  } finally {\n    clearTimeout(timeoutId)\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAoCA,SAAgB,iBAAiB,WAAyF;AACxH,QAAO,OAAO,QAAuC;EACnD,MAAM,WAAW,MAAM,QAAQ,IAAI,GAAG,MAAM,CAAC,IAAI;AACjD,MAAI,SAAS,WAAW,EAAG;EAE3B,MAAM,gBAAgB,kBAAkB;EAExC,MAAM,aAAa,eAAe,OAAO;EACzC,MAAM,YAAY,eAAe;EAGjC,MAAM,SAA+B;GACnC,SAAS,WAAW,WAAW,YAAY,WAAW,WAAW,WAAW,QAAQ,IAAI,sBAAsB,QAAQ,IAAI;GAC1H,OAAO,WAAW,SAAS,YAAY,SAAS,WAAW,SAAS,QAAQ,IAAI,oBAAoB,QAAQ,IAAI;GAChH,OAAO,WAAW,SAAS,YAAY,SAAS,WAAW,SAAS,QAAQ,IAAI,qBAAqB,QAAQ,IAAI;GACjH,SAAS,WAAW,WAAW,YAAY,WAAW,WAAW,WAAW,QAAQ,IAAI,kBAAkB,QAAQ,IAAI;GACtH,SAAS,WAAW,WAAW,YAAY,WAAW,WAAW;GAClE;AAED,MAAI,CAAC,OAAO,WAAW,CAAC,OAAO,OAAO;AACpC,WAAQ,MAAM,yHAAyH;AACvI;;AAGF,MAAI;AACF,SAAM,iBAAiB,SAAS,KAAI,MAAK,EAAE,MAAM,EAAE,OAAsB;WAClE,OAAO;AACd,WAAQ,MAAM,iDAAiD,MAAM;;;;;;;;;;;;;;;AAgB3E,eAAsB,YAAY,OAAkB,QAAoC;AACtF,OAAM,iBAAiB,CAAC,MAAM,EAAE,OAAO;;;;;;;;;;;;;AAczC,eAAsB,iBAAiB,QAAqB,QAAoC;CAC9F,MAAM,UAAU,OAAO,WAAW;CAClC,MAAM,UAAU,OAAO,WAAW;CAClC,MAAM,MAAM,GAAG,QAAQ,eAAe,mBAAmB,OAAO,QAAQ,CAAC;CAEzE,MAAM,UAAkC;EACtC,gBAAgB;EAChB,iBAAiB,UAAU,OAAO;EACnC;AAED,KAAI,OAAO,MACT,SAAQ,oBAAoB,OAAO;CAGrC,MAAM,aAAa,IAAI,iBAAiB;CACxC,MAAM,YAAY,iBAAiB,WAAW,OAAO,EAAE,QAAQ;AAE/D,KAAI;EACF,MAAM,WAAW,MAAM,MAAM,KAAK;GAChC,QAAQ;GACR;GACA,MAAM,KAAK,UAAU,OAAO;GAC5B,QAAQ,WAAW;GACpB,CAAC;AAEF,MAAI,CAAC,SAAS,IAAI;GAChB,MAAM,OAAO,MAAM,SAAS,MAAM,CAAC,YAAY,gBAAgB;GAC/D,MAAM,WAAW,KAAK,SAAS,MAAM,GAAG,KAAK,MAAM,GAAG,IAAI,CAAC,kBAAkB;AAC7E,SAAM,IAAI,MAAM,oBAAoB,SAAS,OAAO,GAAG,SAAS,WAAW,KAAK,WAAW;;WAErF;AACR,eAAa,UAAU"}

package/dist/adapters/better-stack.d.mts

@@ -0,0 +1,62 @@
+import { DrainContext, WideEvent } from "../types.mjs";
+
+//#region src/adapters/better-stack.d.ts
+interface BetterStackConfig {
+  /** Better Stack source token */
+  sourceToken: string;
+  /** Logtail ingestion endpoint. Default: https://in.logs.betterstack.com */
+  endpoint?: string;
+  /** Request timeout in milliseconds. Default: 5000 */
+  timeout?: number;
+}
+/**
+ * Transform an evlog wide event into a Better Stack event.
+ * Maps `timestamp` to `dt` (Better Stack's expected field).
+ */
+declare function toBetterStackEvent(event: WideEvent): Record<string, unknown>;
+/**
+ * Create a drain function for sending logs to Better Stack.
+ *
+ * Configuration priority (highest to lowest):
+ * 1. Overrides passed to createBetterStackDrain()
+ * 2. runtimeConfig.evlog.betterStack
+ * 3. runtimeConfig.betterStack
+ * 4. Environment variables: NUXT_BETTER_STACK_*, BETTER_STACK_*
+ *
+ * @example
+ * ```ts
+ * // Zero config - just set NUXT_BETTER_STACK_SOURCE_TOKEN env var
+ * nitroApp.hooks.hook('evlog:drain', createBetterStackDrain())
+ *
+ * // With overrides
+ * nitroApp.hooks.hook('evlog:drain', createBetterStackDrain({
+ *   sourceToken: 'my-token',
+ * }))
+ * ```
+ */
+declare function createBetterStackDrain(overrides?: Partial<BetterStackConfig>): (ctx: DrainContext | DrainContext[]) => Promise<void>;
+/**
+ * Send a single event to Better Stack.
+ *
+ * @example
+ * ```ts
+ * await sendToBetterStack(event, {
+ *   sourceToken: process.env.BETTER_STACK_SOURCE_TOKEN!,
+ * })
+ * ```
+ */
+declare function sendToBetterStack(event: WideEvent, config: BetterStackConfig): Promise<void>;
+/**
+ * Send a batch of events to Better Stack.
+ *
+ * @example
+ * ```ts
+ * await sendBatchToBetterStack(events, {
+ *   sourceToken: process.env.BETTER_STACK_SOURCE_TOKEN!,
+ * })
+ * ```
+ */
+declare function sendBatchToBetterStack(events: WideEvent[], config: BetterStackConfig): Promise<void>;
+//#endregion
+export { BetterStackConfig, createBetterStackDrain, sendBatchToBetterStack, sendToBetterStack, toBetterStackEvent };
+//# sourceMappingURL=better-stack.d.mts.map

package/dist/adapters/better-stack.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"better-stack.d.mts","names":[],"sources":["../../src/adapters/better-stack.ts"],"mappings":";;;UAGiB,iBAAA;;EAEf,WAAA;EAFgC;EAIhC,QAAA;EAJgC;EAMhC,OAAA;AAAA;;;;AAOF;iBAAgB,kBAAA,CAAmB,KAAA,EAAO,SAAA,GAAY,MAAA;;;;;;;;AAyBtD;;;;;;;;;;;;;iBAAgB,sBAAA,CAAuB,SAAA,GAAY,OAAA,CAAQ,iBAAA,KAAsB,GAAA,EAAK,YAAA,GAAe,YAAA,OAAmB,OAAA;;;;;;AAsCxH;;;;;iBAAsB,iBAAA,CAAkB,KAAA,EAAO,SAAA,EAAW,MAAA,EAAQ,iBAAA,GAAoB,OAAA;;;;;;;;;;AActF;iBAAsB,sBAAA,CAAuB,MAAA,EAAQ,SAAA,IAAa,MAAA,EAAQ,iBAAA,GAAoB,OAAA"}

package/dist/adapters/better-stack.mjs

@@ -0,0 +1,109 @@
+import { t as getRuntimeConfig } from "../_utils-DZA9nou3.mjs";
+
+//#region src/adapters/better-stack.ts
+/**
+* Transform an evlog wide event into a Better Stack event.
+* Maps `timestamp` to `dt` (Better Stack's expected field).
+*/
+function toBetterStackEvent(event) {
+	const { timestamp, ...rest } = event;
+	return {
+		...rest,
+		dt: timestamp
+	};
+}
+/**
+* Create a drain function for sending logs to Better Stack.
+*
+* Configuration priority (highest to lowest):
+* 1. Overrides passed to createBetterStackDrain()
+* 2. runtimeConfig.evlog.betterStack
+* 3. runtimeConfig.betterStack
+* 4. Environment variables: NUXT_BETTER_STACK_*, BETTER_STACK_*
+*
+* @example
+* ```ts
+* // Zero config - just set NUXT_BETTER_STACK_SOURCE_TOKEN env var
+* nitroApp.hooks.hook('evlog:drain', createBetterStackDrain())
+*
+* // With overrides
+* nitroApp.hooks.hook('evlog:drain', createBetterStackDrain({
+*   sourceToken: 'my-token',
+* }))
+* ```
+*/
+function createBetterStackDrain(overrides) {
+	return async (ctx) => {
+		const contexts = Array.isArray(ctx) ? ctx : [ctx];
+		if (contexts.length === 0) return;
+		const runtimeConfig = getRuntimeConfig();
+		const evlogBetterStack = runtimeConfig?.evlog?.betterStack;
+		const rootBetterStack = runtimeConfig?.betterStack;
+		const config = {
+			sourceToken: overrides?.sourceToken ?? evlogBetterStack?.sourceToken ?? rootBetterStack?.sourceToken ?? process.env.NUXT_BETTER_STACK_SOURCE_TOKEN ?? process.env.BETTER_STACK_SOURCE_TOKEN,
+			endpoint: overrides?.endpoint ?? evlogBetterStack?.endpoint ?? rootBetterStack?.endpoint ?? process.env.NUXT_BETTER_STACK_ENDPOINT ?? process.env.BETTER_STACK_ENDPOINT,
+			timeout: overrides?.timeout ?? evlogBetterStack?.timeout ?? rootBetterStack?.timeout
+		};
+		if (!config.sourceToken) {
+			console.error("[evlog/better-stack] Missing source token. Set NUXT_BETTER_STACK_SOURCE_TOKEN env var or pass to createBetterStackDrain()");
+			return;
+		}
+		try {
+			await sendBatchToBetterStack(contexts.map((c) => c.event), config);
+		} catch (error) {
+			console.error("[evlog/better-stack] Failed to send events to Better Stack:", error);
+		}
+	};
+}
+/**
+* Send a single event to Better Stack.
+*
+* @example
+* ```ts
+* await sendToBetterStack(event, {
+*   sourceToken: process.env.BETTER_STACK_SOURCE_TOKEN!,
+* })
+* ```
+*/
+async function sendToBetterStack(event, config) {
+	await sendBatchToBetterStack([event], config);
+}
+/**
+* Send a batch of events to Better Stack.
+*
+* @example
+* ```ts
+* await sendBatchToBetterStack(events, {
+*   sourceToken: process.env.BETTER_STACK_SOURCE_TOKEN!,
+* })
+* ```
+*/
+async function sendBatchToBetterStack(events, config) {
+	const endpoint = (config.endpoint ?? "https://in.logs.betterstack.com").replace(/\/+$/, "");
+	const timeout = config.timeout ?? 5e3;
+	const headers = {
+		"Content-Type": "application/json",
+		"Authorization": `Bearer ${config.sourceToken}`
+	};
+	const controller = new AbortController();
+	const timeoutId = setTimeout(() => controller.abort(), timeout);
+	try {
+		const response = await fetch(endpoint, {
+			method: "POST",
+			headers,
+			body: JSON.stringify(events.map(toBetterStackEvent)),
+			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(`Better Stack API error: ${response.status} ${response.statusText} - ${safeText}`);
+		}
+	} finally {
+		clearTimeout(timeoutId);
+	}
+}
+
+//#endregion
+export { createBetterStackDrain, sendBatchToBetterStack, sendToBetterStack, toBetterStackEvent };
+//# sourceMappingURL=better-stack.mjs.map

package/dist/adapters/better-stack.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"better-stack.mjs","names":[],"sources":["../../src/adapters/better-stack.ts"],"sourcesContent":["import type { DrainContext, WideEvent } from '../types'\nimport { getRuntimeConfig } from './_utils'\n\nexport interface BetterStackConfig {\n  /** Better Stack source token */\n  sourceToken: string\n  /** Logtail ingestion endpoint. Default: https://in.logs.betterstack.com */\n  endpoint?: string\n  /** Request timeout in milliseconds. Default: 5000 */\n  timeout?: number\n}\n\n/**\n * Transform an evlog wide event into a Better Stack event.\n * Maps `timestamp` to `dt` (Better Stack's expected field).\n */\nexport function toBetterStackEvent(event: WideEvent): Record<string, unknown> {\n  const { timestamp, ...rest } = event\n  return { ...rest, dt: timestamp }\n}\n\n/**\n * Create a drain function for sending logs to Better Stack.\n *\n * Configuration priority (highest to lowest):\n * 1. Overrides passed to createBetterStackDrain()\n * 2. runtimeConfig.evlog.betterStack\n * 3. runtimeConfig.betterStack\n * 4. Environment variables: NUXT_BETTER_STACK_*, BETTER_STACK_*\n *\n * @example\n * ```ts\n * // Zero config - just set NUXT_BETTER_STACK_SOURCE_TOKEN env var\n * nitroApp.hooks.hook('evlog:drain', createBetterStackDrain())\n *\n * // With overrides\n * nitroApp.hooks.hook('evlog:drain', createBetterStackDrain({\n *   sourceToken: 'my-token',\n * }))\n * ```\n */\nexport function createBetterStackDrain(overrides?: Partial<BetterStackConfig>): (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 evlogBetterStack = runtimeConfig?.evlog?.betterStack\n    const rootBetterStack = runtimeConfig?.betterStack\n\n    const config: Partial<BetterStackConfig> = {\n      sourceToken: overrides?.sourceToken ?? evlogBetterStack?.sourceToken ?? rootBetterStack?.sourceToken ?? process.env.NUXT_BETTER_STACK_SOURCE_TOKEN ?? process.env.BETTER_STACK_SOURCE_TOKEN,\n      endpoint: overrides?.endpoint ?? evlogBetterStack?.endpoint ?? rootBetterStack?.endpoint ?? process.env.NUXT_BETTER_STACK_ENDPOINT ?? process.env.BETTER_STACK_ENDPOINT,\n      timeout: overrides?.timeout ?? evlogBetterStack?.timeout ?? rootBetterStack?.timeout,\n    }\n\n    if (!config.sourceToken) {\n      console.error('[evlog/better-stack] Missing source token. Set NUXT_BETTER_STACK_SOURCE_TOKEN env var or pass to createBetterStackDrain()')\n      return\n    }\n\n    try {\n      await sendBatchToBetterStack(contexts.map(c => c.event), config as BetterStackConfig)\n    } catch (error) {\n      console.error('[evlog/better-stack] Failed to send events to Better Stack:', error)\n    }\n  }\n}\n\n/**\n * Send a single event to Better Stack.\n *\n * @example\n * ```ts\n * await sendToBetterStack(event, {\n *   sourceToken: process.env.BETTER_STACK_SOURCE_TOKEN!,\n * })\n * ```\n */\nexport async function sendToBetterStack(event: WideEvent, config: BetterStackConfig): Promise<void> {\n  await sendBatchToBetterStack([event], config)\n}\n\n/**\n * Send a batch of events to Better Stack.\n *\n * @example\n * ```ts\n * await sendBatchToBetterStack(events, {\n *   sourceToken: process.env.BETTER_STACK_SOURCE_TOKEN!,\n * })\n * ```\n */\nexport async function sendBatchToBetterStack(events: WideEvent[], config: BetterStackConfig): Promise<void> {\n  const endpoint = (config.endpoint ?? 'https://in.logs.betterstack.com').replace(/\\/+$/, '')\n  const timeout = config.timeout ?? 5000\n\n  const headers: Record<string, string> = {\n    'Content-Type': 'application/json',\n    'Authorization': `Bearer ${config.sourceToken}`,\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,\n      body: JSON.stringify(events.map(toBetterStackEvent)),\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(`Better Stack API error: ${response.status} ${response.statusText} - ${safeText}`)\n    }\n  } finally {\n    clearTimeout(timeoutId)\n  }\n}\n"],"mappings":";;;;;;;AAgBA,SAAgB,mBAAmB,OAA2C;CAC5E,MAAM,EAAE,WAAW,GAAG,SAAS;AAC/B,QAAO;EAAE,GAAG;EAAM,IAAI;EAAW;;;;;;;;;;;;;;;;;;;;;;AAuBnC,SAAgB,uBAAuB,WAA+F;AACpI,QAAO,OAAO,QAAuC;EACnD,MAAM,WAAW,MAAM,QAAQ,IAAI,GAAG,MAAM,CAAC,IAAI;AACjD,MAAI,SAAS,WAAW,EAAG;EAE3B,MAAM,gBAAgB,kBAAkB;EACxC,MAAM,mBAAmB,eAAe,OAAO;EAC/C,MAAM,kBAAkB,eAAe;EAEvC,MAAM,SAAqC;GACzC,aAAa,WAAW,eAAe,kBAAkB,eAAe,iBAAiB,eAAe,QAAQ,IAAI,kCAAkC,QAAQ,IAAI;GAClK,UAAU,WAAW,YAAY,kBAAkB,YAAY,iBAAiB,YAAY,QAAQ,IAAI,8BAA8B,QAAQ,IAAI;GAClJ,SAAS,WAAW,WAAW,kBAAkB,WAAW,iBAAiB;GAC9E;AAED,MAAI,CAAC,OAAO,aAAa;AACvB,WAAQ,MAAM,4HAA4H;AAC1I;;AAGF,MAAI;AACF,SAAM,uBAAuB,SAAS,KAAI,MAAK,EAAE,MAAM,EAAE,OAA4B;WAC9E,OAAO;AACd,WAAQ,MAAM,+DAA+D,MAAM;;;;;;;;;;;;;;AAezF,eAAsB,kBAAkB,OAAkB,QAA0C;AAClG,OAAM,uBAAuB,CAAC,MAAM,EAAE,OAAO;;;;;;;;;;;;AAa/C,eAAsB,uBAAuB,QAAqB,QAA0C;CAC1G,MAAM,YAAY,OAAO,YAAY,mCAAmC,QAAQ,QAAQ,GAAG;CAC3F,MAAM,UAAU,OAAO,WAAW;CAElC,MAAM,UAAkC;EACtC,gBAAgB;EAChB,iBAAiB,UAAU,OAAO;EACnC;CAED,MAAM,aAAa,IAAI,iBAAiB;CACxC,MAAM,YAAY,iBAAiB,WAAW,OAAO,EAAE,QAAQ;AAE/D,KAAI;EACF,MAAM,WAAW,MAAM,MAAM,UAAU;GACrC,QAAQ;GACR;GACA,MAAM,KAAK,UAAU,OAAO,IAAI,mBAAmB,CAAC;GACpD,QAAQ,WAAW;GACpB,CAAC;AAEF,MAAI,CAAC,SAAS,IAAI;GAChB,MAAM,OAAO,MAAM,SAAS,MAAM,CAAC,YAAY,gBAAgB;GAC/D,MAAM,WAAW,KAAK,SAAS,MAAM,GAAG,KAAK,MAAM,GAAG,IAAI,CAAC,kBAAkB;AAC7E,SAAM,IAAI,MAAM,2BAA2B,SAAS,OAAO,GAAG,SAAS,WAAW,KAAK,WAAW;;WAE5F;AACR,eAAa,UAAU"}

package/dist/adapters/otlp.d.mts

@@ -1,35 +1,36 @@
-import { DrainContext, WideEvent } from '../types.mjs';
+import { DrainContext, WideEvent } from "../types.mjs";
 
+//#region src/adapters/otlp.d.ts
 interface OTLPConfig {
-    /** OTLP HTTP endpoint (e.g., http://localhost:4318) */
-    endpoint: string;
-    /** Override service name (defaults to event.service) */
-    serviceName?: string;
-    /** Additional resource attributes */
-    resourceAttributes?: Record<string, string | number | boolean>;
-    /** Custom headers (e.g., for authentication) */
-    headers?: Record<string, string>;
-    /** Request timeout in milliseconds. Default: 5000 */
-    timeout?: number;
+  /** OTLP HTTP endpoint (e.g., http://localhost:4318) */
+  endpoint: string;
+  /** Override service name (defaults to event.service) */
+  serviceName?: string;
+  /** Additional resource attributes */
+  resourceAttributes?: Record<string, string | number | boolean>;
+  /** Custom headers (e.g., for authentication) */
+  headers?: Record<string, string>;
+  /** Request timeout in milliseconds. Default: 5000 */
+  timeout?: number;
 }
 /** OTLP Log Record structure */
 interface OTLPLogRecord {
-    timeUnixNano: string;
-    severityNumber: number;
-    severityText: string;
-    body: {
-        stringValue: string;
+  timeUnixNano: string;
+  severityNumber: number;
+  severityText: string;
+  body: {
+    stringValue: string;
+  };
+  attributes: Array<{
+    key: string;
+    value: {
+      stringValue?: string;
+      intValue?: string;
+      boolValue?: boolean;
     };
-    attributes: Array<{
-        key: string;
-        value: {
-            stringValue?: string;
-            intValue?: string;
-            boolValue?: boolean;
-        };
-    }>;
-    traceId?: string;
-    spanId?: string;
+  }>;
+  traceId?: string;
+  spanId?: string;
 }
 /**
  * Convert an evlog WideEvent to an OTLP LogRecord.
@@ -55,7 +56,7 @@ declare function toOTLPLogRecord(event: WideEvent): OTLPLogRecord;
  * }))
  * ```
  */
-declare function createOTLPDrain(overrides?: Partial<OTLPConfig>): (ctx: DrainContext) => Promise<void>;
+declare function createOTLPDrain(overrides?: Partial<OTLPConfig>): (ctx: DrainContext | DrainContext[]) => Promise<void>;
 /**
  * Send a single event to an OTLP endpoint.
  *
@@ -78,6 +79,6 @@ declare function sendToOTLP(event: WideEvent, config: OTLPConfig): Promise<void>
  * ```
  */
 declare function sendBatchToOTLP(events: WideEvent[], config: OTLPConfig): Promise<void>;
-
-export { createOTLPDrain, sendBatchToOTLP, sendToOTLP, toOTLPLogRecord };
-export type { OTLPConfig, OTLPLogRecord };
+//#endregion
+export { OTLPConfig, OTLPLogRecord, createOTLPDrain, sendBatchToOTLP, sendToOTLP, toOTLPLogRecord };
+//# sourceMappingURL=otlp.d.mts.map

package/dist/adapters/otlp.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"otlp.d.mts","names":[],"sources":["../../src/adapters/otlp.ts"],"mappings":";;;UAGiB,UAAA;;EAEf,QAAA;EAFyB;EAIzB,WAAA;EAIgB;EAFhB,kBAAA,GAAqB,MAAA;EAFrB;EAIA,OAAA,GAAU,MAAA;EAFW;EAIrB,OAAA;AAAA;;UAIe,aAAA;EACf,YAAA;EACA,cAAA;EACA,YAAA;EACA,IAAA;IAAQ,WAAA;EAAA;EACR,UAAA,EAAY,KAAA;IACV,GAAA;IACA,KAAA;MAAS,WAAA;MAAsB,QAAA;MAAmB,SAAA;IAAA;EAAA;EAEpD,OAAA;EACA,MAAA;AAAA;;;;iBAkEc,eAAA,CAAgB,KAAA,EAAO,SAAA,GAAY,aAAA;AAAnD;;;;;;;;;AA4HA;;;;;;;;;;;AA5HA,iBA4HgB,eAAA,CAAgB,SAAA,GAAY,OAAA,CAAQ,UAAA,KAAe,GAAA,EAAK,YAAA,GAAe,YAAA,OAAmB,OAAA;;;;;;;;AA0E1G;;;iBAAsB,UAAA,CAAW,KAAA,EAAO,SAAA,EAAW,MAAA,EAAQ,UAAA,GAAa,OAAA;;;;;;;;;;;iBAclD,eAAA,CAAgB,MAAA,EAAQ,SAAA,IAAa,MAAA,EAAQ,UAAA,GAAa,OAAA"}