@safaricom-mxl/log 0.0.3

package/dist/_http-DmaJ426Z.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 mxllogNs = runtimeConfig?.mxllog?.[namespace];
+	const rootNs = runtimeConfig?.[namespace];
+	const config = {};
+	for (const { key, env } of fields) config[key] = overrides?.[key] ?? mxllogNs?.[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(`[mxllog/${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-DmaJ426Z.mjs.map

package/dist/_http-DmaJ426Z.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"_http-DmaJ426Z.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 mxllogNs = runtimeConfig?.mxllog?.[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      ?? mxllogNs?.[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(`[mxllog/${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,WAAW,eAAe,SAAS;CACzC,MAAM,SAAS,gBAAgB;CAE/B,MAAM,SAAkC,EAAE;AAE1C,MAAK,MAAM,EAAE,KAAK,SAAS,OACzB,QAAO,OACL,YAAY,QACT,WAAW,QACX,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,WAAW,QAAQ,KAAK,2BAA2B,MAAM;;;;;;;ACX7E,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-D_IU9-90.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-D_IU9-90.mjs.map

package/dist/_severity-D_IU9-90.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"_severity-D_IU9-90.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

@@ -0,0 +1,64 @@
+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;
+}
+/**
+ * Create a drain function for sending logs to Axiom.
+ *
+ * Configuration priority (highest to lowest):
+ * 1. Overrides passed to createAxiomDrain()
+ * 2. runtimeConfig.mxllog.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('@safaricom-mxl/log:drain', createAxiomDrain())
+ *
+ * // With overrides
+ * nitroApp.hooks.hook('@safaricom-mxl/log:drain', createAxiomDrain({
+ *   dataset: 'my-dataset',
+ * }))
+ * ```
+ */
+declare function createAxiomDrain(overrides?: Partial<AxiomConfig>): (ctx: DrainContext | DrainContext[]) => Promise<void>;
+/**
+ * Send a single event to Axiom.
+ *
+ * @example
+ * ```ts
+ * await sendToAxiom(event, {
+ *   dataset: 'my-logs',
+ *   token: process.env.AXIOM_TOKEN!,
+ * })
+ * ```
+ */
+declare function sendToAxiom(event: WideEvent, config: AxiomConfig): Promise<void>;
+/**
+ * Send a batch of events to Axiom.
+ *
+ * @example
+ * ```ts
+ * await sendBatchToAxiom(events, {
+ *   dataset: 'my-logs',
+ *   token: process.env.AXIOM_TOKEN!,
+ * })
+ * ```
+ */
+declare function sendBatchToAxiom(events: WideEvent[], config: AxiomConfig): Promise<void>;
+//#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

@@ -0,0 +1,100 @@
+import { n as defineDrain, r as resolveAdapterConfig, t as httpPost } from "../_http-DmaJ426Z.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.mxllog.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('@safaricom-mxl/log:drain', createAxiomDrain())
+*
+* // With overrides
+* nitroApp.hooks.hook('@safaricom-mxl/log:drain', createAxiomDrain({
+*   dataset: 'my-dataset',
+* }))
+* ```
+*/
+function createAxiomDrain(overrides) {
+	return defineDrain({
+		name: "axiom",
+		resolve: () => {
+			const config = resolveAdapterConfig("axiom", AXIOM_FIELDS, overrides);
+			if (!config.dataset || !config.token) {
+				console.error("[mxllog/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);
+}
+/**
+* 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 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.mxllog.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('@safaricom-mxl/log:drain', createAxiomDrain())\n *\n * // With overrides\n * nitroApp.hooks.hook('@safaricom-mxl/log: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('[mxllog/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,0HAA0H;AACxI,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 mxllog 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.mxllog.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('@safaricom-mxl/log:drain', createBetterStackDrain())
+ *
+ * // With overrides
+ * nitroApp.hooks.hook('@safaricom-mxl/log: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-DmaJ426Z.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 mxllog 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.mxllog.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('@safaricom-mxl/log:drain', createBetterStackDrain())
+*
+* // With overrides
+* nitroApp.hooks.hook('@safaricom-mxl/log: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("[mxllog/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 mxllog 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.mxllog.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('@safaricom-mxl/log:drain', createBetterStackDrain())\n *\n * // With overrides\n * nitroApp.hooks.hook('@safaricom-mxl/log: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('[mxllog/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,6HAA6H;AAC3I,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"}

package/dist/adapters/otlp.d.mts

@@ -0,0 +1,85 @@
+import { DrainContext, WideEvent } from "../types.mjs";
+import "../index.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 Log Record structure */
+interface OTLPLogRecord {
+  timeUnixNano: string;
+  severityNumber: number;
+  severityText: string;
+  body: {
+    stringValue: string;
+  };
+  attributes: Array<{
+    key: string;
+    value: {
+      stringValue?: string;
+      intValue?: string;
+      boolValue?: boolean;
+    };
+  }>;
+  traceId?: string;
+  spanId?: string;
+}
+/**
+ * Convert an mxllog WideEvent to an OTLP LogRecord.
+ */
+declare function toOTLPLogRecord(event: WideEvent): OTLPLogRecord;
+/**
+ * Create a drain function for sending logs to an OTLP endpoint.
+ *
+ * Configuration priority (highest to lowest):
+ * 1. Overrides passed to createOTLPDrain()
+ * 2. runtimeConfig.mxllog.otlp (NUXT_MXLLOG_OTLP_*)
+ * 3. runtimeConfig.otlp (NUXT_OTLP_*)
+ * 4. Environment variables: OTEL_EXPORTER_OTLP_ENDPOINT, OTEL_SERVICE_NAME
+ *
+ * @example
+ * ```ts
+ * // Zero config - reads from runtimeConfig or env vars
+ * nitroApp.hooks.hook('@safaricom-mxl/log:drain', createOTLPDrain())
+ *
+ * // With overrides
+ * nitroApp.hooks.hook('@safaricom-mxl/log:drain', createOTLPDrain({
+ *   endpoint: 'http://localhost:4318',
+ * }))
+ * ```
+ */
+declare function createOTLPDrain(overrides?: Partial<OTLPConfig>): (ctx: DrainContext | DrainContext[]) => Promise<void>;
+/**
+ * Send a single event to an OTLP endpoint.
+ *
+ * @example
+ * ```ts
+ * await sendToOTLP(event, {
+ *   endpoint: 'http://localhost:4318',
+ * })
+ * ```
+ */
+declare function sendToOTLP(event: WideEvent, config: OTLPConfig): Promise<void>;
+/**
+ * Send a batch of events to an OTLP endpoint.
+ *
+ * @example
+ * ```ts
+ * await sendBatchToOTLP(events, {
+ *   endpoint: 'http://localhost:4318',
+ * })
+ * ```
+ */
+declare function sendBatchToOTLP(events: WideEvent[], config: OTLPConfig): Promise<void>;
+//#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":";;;;UAOiB,UAAA;;EAEf,QAAA;EAFe;EAIf,WAAA;;EAEA,kBAAA,GAAqB,MAAA;EAJrB;EAMA,OAAA,GAAU,MAAA;EAFV;EAIA,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;;;;iBAwDc,eAAA,CAAgB,KAAA,EAAO,SAAA,GAAY,aAAA;;AAAnD;;;;;;;;;AA0JA;;;;;;;;;;iBAAgB,eAAA,CAAgB,SAAA,GAAY,OAAA,CAAQ,UAAA,KAAW,GAAA,EAAZ,YAAA,GAAY,YAAA,OAAA,OAAA;;;;;;;;;AA+B/D;;iBAAsB,UAAA,CAAW,KAAA,EAAO,SAAA,EAAW,MAAA,EAAQ,UAAA,GAAa,OAAA;;;;;;;;;;;iBAclD,eAAA,CAAgB,MAAA,EAAQ,SAAA,IAAa,MAAA,EAAQ,UAAA,GAAa,OAAA"}