evlog 1.6.0 → 1.8.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)`
@@ -494,6 +589,7 @@ Initialize the logger. Required for standalone usage, automatic with Nuxt/Nitro
 
 ```typescript
 initLogger({
+  enabled: boolean       // (optional) Enable/disable all logging (default: true)
   env: {
     service: string      // Service name
     environment: string  // 'production' | 'development' | 'test'

package/dist/_http-DVDwNag0.mjs

@@ -0,0 +1,76 @@
+import { createRequire } from "node:module";
+
+//#region \0rolldown/runtime.js
+var __require = /* @__PURE__ */ createRequire(import.meta.url);
+
+//#endregion
+//#region src/adapters/_config.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;
+	}
+}
+function resolveAdapterConfig(namespace, fields, overrides) {
+	const runtimeConfig = getRuntimeConfig();
+	const evlogNs = runtimeConfig?.evlog?.[namespace];
+	const rootNs = runtimeConfig?.[namespace];
+	const config = {};
+	for (const { key, env } of fields) config[key] = overrides?.[key] ?? evlogNs?.[key] ?? rootNs?.[key] ?? resolveEnv(env);
+	return config;
+}
+function resolveEnv(envKeys) {
+	if (!envKeys) return void 0;
+	for (const key of envKeys) {
+		const val = process.env[key];
+		if (val) return val;
+	}
+}
+
+//#endregion
+//#region src/adapters/_drain.ts
+function defineDrain(options) {
+	return async (ctx) => {
+		const contexts = Array.isArray(ctx) ? ctx : [ctx];
+		if (contexts.length === 0) return;
+		const config = options.resolve();
+		if (!config) return;
+		try {
+			await options.send(contexts.map((c) => c.event), config);
+		} catch (error) {
+			console.error(`[evlog/${options.name}] Failed to send events:`, error);
+		}
+	};
+}
+
+//#endregion
+//#region src/adapters/_http.ts
+async function httpPost({ url, headers, body, timeout, label }) {
+	const controller = new AbortController();
+	const timeoutId = setTimeout(() => controller.abort(), timeout);
+	try {
+		const response = await fetch(url, {
+			method: "POST",
+			headers,
+			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(`${label} API error: ${response.status} ${response.statusText} - ${safeText}`);
+		}
+	} finally {
+		clearTimeout(timeoutId);
+	}
+}
+
+//#endregion
+export { defineDrain as n, resolveAdapterConfig as r, httpPost as t };
+//# sourceMappingURL=_http-DVDwNag0.mjs.map

package/dist/_http-DVDwNag0.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"_http-DVDwNag0.mjs","names":[],"sources":["../src/adapters/_config.ts","../src/adapters/_drain.ts","../src/adapters/_http.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\nexport interface ConfigField<T> {\n  key: keyof T & string\n  env?: string[]\n}\n\nexport function resolveAdapterConfig<T>(\n  namespace: string,\n  fields: ConfigField<T>[],\n  overrides?: Partial<T>,\n): Partial<T> {\n  const runtimeConfig = getRuntimeConfig()\n  const evlogNs = runtimeConfig?.evlog?.[namespace]\n  const rootNs = runtimeConfig?.[namespace]\n\n  const config: Record<string, unknown> = {}\n\n  for (const { key, env } of fields) {\n    config[key] =\n      overrides?.[key]\n      ?? evlogNs?.[key]\n      ?? rootNs?.[key]\n      ?? resolveEnv(env)\n  }\n\n  return config as Partial<T>\n}\n\nfunction resolveEnv(envKeys?: string[]): string | undefined {\n  if (!envKeys) return undefined\n  for (const key of envKeys) {\n    const val = process.env[key]\n    if (val) return val\n  }\n  return undefined\n}\n","import type { DrainContext, WideEvent } from '../types'\n\nexport interface DrainOptions<TConfig> {\n  name: string\n  resolve: () => TConfig | null\n  send: (events: WideEvent[], config: TConfig) => Promise<void>\n}\n\nexport function defineDrain<TConfig>(options: DrainOptions<TConfig>): (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 config = options.resolve()\n    if (!config) return\n\n    try {\n      await options.send(contexts.map(c => c.event), config)\n    } catch (error) {\n      console.error(`[evlog/${options.name}] Failed to send events:`, error)\n    }\n  }\n}\n","export interface HttpPostOptions {\n  url: string\n  headers: Record<string, string>\n  body: string\n  timeout: number\n  label: string\n}\n\nexport async function httpPost({ url, headers, body, timeout, label }: HttpPostOptions): Promise<void> {\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,\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(`${label} API error: ${response.status} ${response.statusText} - ${safeText}`)\n    }\n  } finally {\n    clearTimeout(timeoutId)\n  }\n}\n"],"mappings":";;;;;;;;;;;AAIA,SAAgB,mBAAoD;AAClE,KAAI;EAEF,MAAM,EAAE,+BAA6B,oBAAoB;AACzD,SAAO,kBAAkB;SACnB;AACN;;;AASJ,SAAgB,qBACd,WACA,QACA,WACY;CACZ,MAAM,gBAAgB,kBAAkB;CACxC,MAAM,UAAU,eAAe,QAAQ;CACvC,MAAM,SAAS,gBAAgB;CAE/B,MAAM,SAAkC,EAAE;AAE1C,MAAK,MAAM,EAAE,KAAK,SAAS,OACzB,QAAO,OACL,YAAY,QACT,UAAU,QACV,SAAS,QACT,WAAW,IAAI;AAGtB,QAAO;;AAGT,SAAS,WAAW,SAAwC;AAC1D,KAAI,CAAC,QAAS,QAAO;AACrB,MAAK,MAAM,OAAO,SAAS;EACzB,MAAM,MAAM,QAAQ,IAAI;AACxB,MAAI,IAAK,QAAO;;;;;;ACrCpB,SAAgB,YAAqB,SAAuF;AAC1H,QAAO,OAAO,QAAuC;EACnD,MAAM,WAAW,MAAM,QAAQ,IAAI,GAAG,MAAM,CAAC,IAAI;AACjD,MAAI,SAAS,WAAW,EAAG;EAE3B,MAAM,SAAS,QAAQ,SAAS;AAChC,MAAI,CAAC,OAAQ;AAEb,MAAI;AACF,SAAM,QAAQ,KAAK,SAAS,KAAI,MAAK,EAAE,MAAM,EAAE,OAAO;WAC/C,OAAO;AACd,WAAQ,MAAM,UAAU,QAAQ,KAAK,2BAA2B,MAAM;;;;;;;ACX5E,eAAsB,SAAS,EAAE,KAAK,SAAS,MAAM,SAAS,SAAyC;CACrG,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;GACA,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,GAAG,MAAM,cAAc,SAAS,OAAO,GAAG,SAAS,WAAW,KAAK,WAAW;;WAExF;AACR,eAAa,UAAU"}

package/dist/_severity-CXfyvxQi.mjs

@@ -0,0 +1,17 @@
+//#region src/adapters/_severity.ts
+const OTEL_SEVERITY_NUMBER = {
+	debug: 5,
+	info: 9,
+	warn: 13,
+	error: 17
+};
+const OTEL_SEVERITY_TEXT = {
+	debug: "DEBUG",
+	info: "INFO",
+	warn: "WARN",
+	error: "ERROR"
+};
+
+//#endregion
+export { OTEL_SEVERITY_TEXT as n, OTEL_SEVERITY_NUMBER as t };
+//# sourceMappingURL=_severity-CXfyvxQi.mjs.map

package/dist/_severity-CXfyvxQi.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"_severity-CXfyvxQi.mjs","names":[],"sources":["../src/adapters/_severity.ts"],"sourcesContent":["import type { LogLevel } from '../types'\n\nexport const OTEL_SEVERITY_NUMBER: Record<LogLevel, number> = {\n  debug: 5,\n  info: 9,\n  warn: 13,\n  error: 17,\n}\n\nexport const OTEL_SEVERITY_TEXT: Record<LogLevel, string> = {\n  debug: 'DEBUG',\n  info: 'INFO',\n  warn: 'WARN',\n  error: 'ERROR',\n}\n"],"mappings":";AAEA,MAAa,uBAAiD;CAC5D,OAAO;CACP,MAAM;CACN,MAAM;CACN,OAAO;CACR;AAED,MAAa,qBAA+C;CAC1D,OAAO;CACP,MAAM;CACN,MAAM;CACN,OAAO;CACR"}

package/dist/adapters/axiom.d.mts

@@ -1,16 +1,18 @@
-import { DrainContext, WideEvent } from '../types.mjs';
+import { DrainContext, WideEvent } from "../types.mjs";
+import "../index.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 +34,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 +59,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":";;;;UAMiB,WAAA;;EAEf,OAAA;EAFe;EAIf,KAAA;;EAEA,KAAA;EAJA;EAMA,OAAA;EAFA;EAIA,OAAA;AAAA;;;AA+BF;;;;;;;;;;;;;;;;;;iBAAgB,gBAAA,CAAiB,SAAA,GAAY,OAAA,CAAQ,WAAA,KAAY,GAAA,EAAb,YAAA,GAAa,YAAA,OAAA,OAAA;AA0BjE;;;;;;;;;;;AAAA,iBAAsB,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,100 @@
-import { g as getRuntimeConfig } from '../shared/evlog.Bc35pxiY.mjs';
+import { n as defineDrain, r as resolveAdapterConfig, t as httpPost } from "../_http-DVDwNag0.mjs";
 
+//#region src/adapters/axiom.ts
+const AXIOM_FIELDS = [
+	{
+		key: "dataset",
+		env: ["NUXT_AXIOM_DATASET", "AXIOM_DATASET"]
+	},
+	{
+		key: "token",
+		env: ["NUXT_AXIOM_TOKEN", "AXIOM_TOKEN"]
+	},
+	{
+		key: "orgId",
+		env: ["NUXT_AXIOM_ORG_ID", "AXIOM_ORG_ID"]
+	},
+	{
+		key: "baseUrl",
+		env: ["NUXT_AXIOM_URL", "AXIOM_URL"]
+	},
+	{ key: "timeout" }
+];
+/**
+* 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 defineDrain({
+		name: "axiom",
+		resolve: () => {
+			const config = resolveAdapterConfig("axiom", AXIOM_FIELDS, overrides);
+			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 null;
+			}
+			return config;
+		},
+		send: sendBatchToAxiom
+	});
 }
+/**
+* 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 url = `${config.baseUrl ?? "https://api.axiom.co"}/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;
+	await httpPost({
+		url,
+		headers,
+		body: JSON.stringify(events),
+		timeout: config.timeout ?? 5e3,
+		label: "Axiom"
+	});
 }
 
+//#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 { WideEvent } from '../types'\nimport type { ConfigField } from './_config'\nimport { resolveAdapterConfig } from './_config'\nimport { defineDrain } from './_drain'\nimport { httpPost } from './_http'\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\nconst AXIOM_FIELDS: ConfigField<AxiomConfig>[] = [\n  { key: 'dataset', env: ['NUXT_AXIOM_DATASET', 'AXIOM_DATASET'] },\n  { key: 'token', env: ['NUXT_AXIOM_TOKEN', 'AXIOM_TOKEN'] },\n  { key: 'orgId', env: ['NUXT_AXIOM_ORG_ID', 'AXIOM_ORG_ID'] },\n  { key: 'baseUrl', env: ['NUXT_AXIOM_URL', 'AXIOM_URL'] },\n  { key: 'timeout' },\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>) {\n  return defineDrain<AxiomConfig>({\n    name: 'axiom',\n    resolve: () => {\n      const config = resolveAdapterConfig<AxiomConfig>('axiom', AXIOM_FIELDS, overrides)\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 null\n      }\n      return config as AxiomConfig\n    },\n    send: sendBatchToAxiom,\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 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  await httpPost({\n    url,\n    headers,\n    body: JSON.stringify(events),\n    timeout: config.timeout ?? 5000,\n    label: 'Axiom',\n  })\n}\n"],"mappings":";;;AAmBA,MAAM,eAA2C;CAC/C;EAAE,KAAK;EAAW,KAAK,CAAC,sBAAsB,gBAAgB;EAAE;CAChE;EAAE,KAAK;EAAS,KAAK,CAAC,oBAAoB,cAAc;EAAE;CAC1D;EAAE,KAAK;EAAS,KAAK,CAAC,qBAAqB,eAAe;EAAE;CAC5D;EAAE,KAAK;EAAW,KAAK,CAAC,kBAAkB,YAAY;EAAE;CACxD,EAAE,KAAK,WAAW;CACnB;;;;;;;;;;;;;;;;;;;;;AAsBD,SAAgB,iBAAiB,WAAkC;AACjE,QAAO,YAAyB;EAC9B,MAAM;EACN,eAAe;GACb,MAAM,SAAS,qBAAkC,SAAS,cAAc,UAAU;AAClF,OAAI,CAAC,OAAO,WAAW,CAAC,OAAO,OAAO;AACpC,YAAQ,MAAM,yHAAyH;AACvI,WAAO;;AAET,UAAO;;EAET,MAAM;EACP,CAAC;;;;;;;;;;;;;AAcJ,eAAsB,YAAY,OAAkB,QAAoC;AACtF,OAAM,iBAAiB,CAAC,MAAM,EAAE,OAAO;;;;;;;;;;;;;AAczC,eAAsB,iBAAiB,QAAqB,QAAoC;CAE9F,MAAM,MAAM,GADI,OAAO,WAAW,uBACX,eAAe,mBAAmB,OAAO,QAAQ,CAAC;CAEzE,MAAM,UAAkC;EACtC,gBAAgB;EAChB,iBAAiB,UAAU,OAAO;EACnC;AAED,KAAI,OAAO,MACT,SAAQ,oBAAoB,OAAO;AAGrC,OAAM,SAAS;EACb;EACA;EACA,MAAM,KAAK,UAAU,OAAO;EAC5B,SAAS,OAAO,WAAW;EAC3B,OAAO;EACR,CAAC"}

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

@@ -0,0 +1,63 @@
+import { DrainContext, WideEvent } from "../types.mjs";
+import "../index.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":";;;;UAMiB,iBAAA;;EAEf,WAAA;EAFe;EAIf,QAAA;;EAEA,OAAA;AAAA;;;;;iBAac,kBAAA,CAAmB,KAAA,EAAO,SAAA,GAAY,MAAA;;;;;;;;;AAyBtD;;;;;;;;;;;;iBAAgB,sBAAA,CAAuB,SAAA,GAAY,OAAA,CAAQ,iBAAA,KAAkB,GAAA,EAAnB,YAAA,GAAmB,YAAA,OAAA,OAAA;;;;;;;AAyB7E;;;;iBAAsB,iBAAA,CAAkB,KAAA,EAAO,SAAA,EAAW,MAAA,EAAQ,iBAAA,GAAoB,OAAA;;;;;;;;;;;iBAchE,sBAAA,CAAuB,MAAA,EAAQ,SAAA,IAAa,MAAA,EAAQ,iBAAA,GAAoB,OAAA"}

package/dist/adapters/better-stack.mjs

@@ -0,0 +1,98 @@
+import { n as defineDrain, r as resolveAdapterConfig, t as httpPost } from "../_http-DVDwNag0.mjs";
+
+//#region src/adapters/better-stack.ts
+const BETTER_STACK_FIELDS = [
+	{
+		key: "sourceToken",
+		env: ["NUXT_BETTER_STACK_SOURCE_TOKEN", "BETTER_STACK_SOURCE_TOKEN"]
+	},
+	{
+		key: "endpoint",
+		env: ["NUXT_BETTER_STACK_ENDPOINT", "BETTER_STACK_ENDPOINT"]
+	},
+	{ key: "timeout" }
+];
+/**
+* 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 defineDrain({
+		name: "better-stack",
+		resolve: () => {
+			const config = resolveAdapterConfig("betterStack", BETTER_STACK_FIELDS, overrides);
+			if (!config.sourceToken) {
+				console.error("[evlog/better-stack] Missing source token. Set NUXT_BETTER_STACK_SOURCE_TOKEN env var or pass to createBetterStackDrain()");
+				return null;
+			}
+			return config;
+		},
+		send: sendBatchToBetterStack
+	});
+}
+/**
+* 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) {
+	await httpPost({
+		url: (config.endpoint ?? "https://in.logs.betterstack.com").replace(/\/+$/, ""),
+		headers: {
+			"Content-Type": "application/json",
+			"Authorization": `Bearer ${config.sourceToken}`
+		},
+		body: JSON.stringify(events.map(toBetterStackEvent)),
+		timeout: config.timeout ?? 5e3,
+		label: "Better Stack"
+	});
+}
+
+//#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 { WideEvent } from '../types'\nimport type { ConfigField } from './_config'\nimport { resolveAdapterConfig } from './_config'\nimport { defineDrain } from './_drain'\nimport { httpPost } from './_http'\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\nconst BETTER_STACK_FIELDS: ConfigField<BetterStackConfig>[] = [\n  { key: 'sourceToken', env: ['NUXT_BETTER_STACK_SOURCE_TOKEN', 'BETTER_STACK_SOURCE_TOKEN'] },\n  { key: 'endpoint', env: ['NUXT_BETTER_STACK_ENDPOINT', 'BETTER_STACK_ENDPOINT'] },\n  { key: 'timeout' },\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>) {\n  return defineDrain<BetterStackConfig>({\n    name: 'better-stack',\n    resolve: () => {\n      const config = resolveAdapterConfig<BetterStackConfig>('betterStack', BETTER_STACK_FIELDS, overrides)\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 null\n      }\n      return config as BetterStackConfig\n    },\n    send: sendBatchToBetterStack,\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\n  await httpPost({\n    url: endpoint,\n    headers: {\n      'Content-Type': 'application/json',\n      'Authorization': `Bearer ${config.sourceToken}`,\n    },\n    body: JSON.stringify(events.map(toBetterStackEvent)),\n    timeout: config.timeout ?? 5000,\n    label: 'Better Stack',\n  })\n}\n"],"mappings":";;;AAeA,MAAM,sBAAwD;CAC5D;EAAE,KAAK;EAAe,KAAK,CAAC,kCAAkC,4BAA4B;EAAE;CAC5F;EAAE,KAAK;EAAY,KAAK,CAAC,8BAA8B,wBAAwB;EAAE;CACjF,EAAE,KAAK,WAAW;CACnB;;;;;AAMD,SAAgB,mBAAmB,OAA2C;CAC5E,MAAM,EAAE,WAAW,GAAG,SAAS;AAC/B,QAAO;EAAE,GAAG;EAAM,IAAI;EAAW;;;;;;;;;;;;;;;;;;;;;;AAuBnC,SAAgB,uBAAuB,WAAwC;AAC7E,QAAO,YAA+B;EACpC,MAAM;EACN,eAAe;GACb,MAAM,SAAS,qBAAwC,eAAe,qBAAqB,UAAU;AACrG,OAAI,CAAC,OAAO,aAAa;AACvB,YAAQ,MAAM,4HAA4H;AAC1I,WAAO;;AAET,UAAO;;EAET,MAAM;EACP,CAAC;;;;;;;;;;;;AAaJ,eAAsB,kBAAkB,OAAkB,QAA0C;AAClG,OAAM,uBAAuB,CAAC,MAAM,EAAE,OAAO;;;;;;;;;;;;AAa/C,eAAsB,uBAAuB,QAAqB,QAA0C;AAG1G,OAAM,SAAS;EACb,MAHgB,OAAO,YAAY,mCAAmC,QAAQ,QAAQ,GAAG;EAIzF,SAAS;GACP,gBAAgB;GAChB,iBAAiB,UAAU,OAAO;GACnC;EACD,MAAM,KAAK,UAAU,OAAO,IAAI,mBAAmB,CAAC;EACpD,SAAS,OAAO,WAAW;EAC3B,OAAO;EACR,CAAC"}