autotel-subscribers 45.0.0 → 46.0.0

package/dist/amplitude.cjs

@@ -84,5 +84,4 @@ var AmplitudeSubscriber = class {
 };
 
 //#endregion
-exports.AmplitudeSubscriber = AmplitudeSubscriber;
-//# sourceMappingURL=amplitude.cjs.map
+exports.AmplitudeSubscriber = AmplitudeSubscriber;

package/dist/amplitude.d.cts

@@ -24,5 +24,4 @@ declare class AmplitudeSubscriber implements EventSubscriber {
   shutdown(): Promise<void>;
 }
 //#endregion
-export { AmplitudeConfig, AmplitudeSubscriber };
-//# sourceMappingURL=amplitude.d.cts.map
+export { AmplitudeConfig, AmplitudeSubscriber };

package/dist/amplitude.d.ts

@@ -24,5 +24,4 @@ declare class AmplitudeSubscriber implements EventSubscriber {
   shutdown(): Promise<void>;
 }
 //#endregion
-export { AmplitudeConfig, AmplitudeSubscriber };
-//# sourceMappingURL=amplitude.d.ts.map
+export { AmplitudeConfig, AmplitudeSubscriber };

package/dist/amplitude.js

@@ -82,5 +82,4 @@ var AmplitudeSubscriber = class {
 };
 
 //#endregion
-export { AmplitudeSubscriber };
-//# sourceMappingURL=amplitude.js.map
+export { AmplitudeSubscriber };

package/dist/architecture-snapshot.cjs

@@ -290,5 +290,4 @@ function comparePrimitiveValues(a, b) {
 //#endregion
 exports.ARCHITECTURE_SNAPSHOT_SPEC = ARCHITECTURE_SNAPSHOT_SPEC;
 exports.ArchitectureSnapshotSubscriber = ArchitectureSnapshotSubscriber;
-exports.extractFieldPaths = extractFieldPaths;
-//# sourceMappingURL=architecture-snapshot.cjs.map
+exports.extractFieldPaths = extractFieldPaths;

package/dist/architecture-snapshot.d.cts

@@ -91,5 +91,4 @@ declare class ArchitectureSnapshotSubscriber extends EventSubscriber {
  */
 declare function extractFieldPaths(value: unknown, prefix?: string): string[];
 //#endregion
-export { ARCHITECTURE_SNAPSHOT_SPEC, ArchitectureSnapshot, ArchitectureSnapshotConfig, ArchitectureSnapshotSubscriber, EventObservation, FieldStats, extractFieldPaths };
-//# sourceMappingURL=architecture-snapshot.d.cts.map
+export { ARCHITECTURE_SNAPSHOT_SPEC, ArchitectureSnapshot, ArchitectureSnapshotConfig, ArchitectureSnapshotSubscriber, EventObservation, FieldStats, extractFieldPaths };

package/dist/architecture-snapshot.d.ts

@@ -91,5 +91,4 @@ declare class ArchitectureSnapshotSubscriber extends EventSubscriber {
  */
 declare function extractFieldPaths(value: unknown, prefix?: string): string[];
 //#endregion
-export { ARCHITECTURE_SNAPSHOT_SPEC, ArchitectureSnapshot, ArchitectureSnapshotConfig, ArchitectureSnapshotSubscriber, EventObservation, FieldStats, extractFieldPaths };
-//# sourceMappingURL=architecture-snapshot.d.ts.map
+export { ARCHITECTURE_SNAPSHOT_SPEC, ArchitectureSnapshot, ArchitectureSnapshotConfig, ArchitectureSnapshotSubscriber, EventObservation, FieldStats, extractFieldPaths };

package/dist/architecture-snapshot.js

@@ -284,5 +284,4 @@ function comparePrimitiveValues(a, b) {
 }
 
 //#endregion
-export { ARCHITECTURE_SNAPSHOT_SPEC, ArchitectureSnapshotSubscriber, extractFieldPaths };
-//# sourceMappingURL=architecture-snapshot.js.map
+export { ARCHITECTURE_SNAPSHOT_SPEC, ArchitectureSnapshotSubscriber, extractFieldPaths };

package/dist/event-subscriber-base-C_F3Ycbe.cjs

@@ -206,5 +206,4 @@ Object.defineProperty(exports, 'EventSubscriber', {
   get: function () {
     return EventSubscriber;
   }
-});
-//# sourceMappingURL=event-subscriber-base-C_F3Ycbe.cjs.map
+});

package/dist/event-subscriber-base-Day2ml6V.js

@@ -200,5 +200,4 @@ var EventSubscriber = class {
 };
 
 //#endregion
-export { EventSubscriber as t };
-//# sourceMappingURL=event-subscriber-base-Day2ml6V.js.map
+export { EventSubscriber as t };

package/dist/event-subscriber-base-DpZclJM4.d.cts

@@ -160,5 +160,4 @@ declare abstract class EventSubscriber$1 implements EventSubscriber {
   private sendWithErrorHandling;
 }
 //#endregion
-export { EventPayload as n, EventSubscriber$1 as r, AutotelEventContext$1 as t };
-//# sourceMappingURL=event-subscriber-base-DpZclJM4.d.cts.map
+export { EventPayload as n, EventSubscriber$1 as r, AutotelEventContext$1 as t };

package/dist/event-subscriber-base-DpZclJM4.d.ts

@@ -160,5 +160,4 @@ declare abstract class EventSubscriber$1 implements EventSubscriber {
   private sendWithErrorHandling;
 }
 //#endregion
-export { EventPayload as n, EventSubscriber$1 as r, AutotelEventContext$1 as t };
-//# sourceMappingURL=event-subscriber-base-DpZclJM4.d.ts.map
+export { EventPayload as n, EventSubscriber$1 as r, AutotelEventContext$1 as t };

package/dist/factories.cjs

@@ -371,5 +371,4 @@ exports.createMockSubscriber = createMockSubscriber;
 exports.createPostHogSubscriber = createPostHogSubscriber;
 exports.createSegmentSubscriber = createSegmentSubscriber;
 exports.createSlackSubscriber = createSlackSubscriber;
-exports.createWebhookSubscriber = createWebhookSubscriber;
-//# sourceMappingURL=factories.cjs.map
+exports.createWebhookSubscriber = createWebhookSubscriber;

package/dist/factories.d.cts

@@ -165,5 +165,4 @@ type ComposeSubscribersOptions = {
  */
 declare function composeSubscribers(subscribers: EventSubscriber[], options?: ComposeSubscribersOptions): EventSubscriber;
 //#endregion
-export { type AmplitudeConfig, ComposeSubscriberStrategy, ComposeSubscribersOptions, type MixpanelConfig, type PostHogConfig, type SegmentConfig, type SlackSubscriberConfig, type WebhookConfig, composeSubscribers, createAmplitudeSubscriber, createMixpanelSubscriber, createMockSubscriber, createPostHogSubscriber, createSegmentSubscriber, createSlackSubscriber, createWebhookSubscriber };
-//# sourceMappingURL=factories.d.cts.map
+export { type AmplitudeConfig, ComposeSubscriberStrategy, ComposeSubscribersOptions, type MixpanelConfig, type PostHogConfig, type SegmentConfig, type SlackSubscriberConfig, type WebhookConfig, composeSubscribers, createAmplitudeSubscriber, createMixpanelSubscriber, createMockSubscriber, createPostHogSubscriber, createSegmentSubscriber, createSlackSubscriber, createWebhookSubscriber };

package/dist/factories.d.ts

@@ -165,5 +165,4 @@ type ComposeSubscribersOptions = {
  */
 declare function composeSubscribers(subscribers: EventSubscriber[], options?: ComposeSubscribersOptions): EventSubscriber;
 //#endregion
-export { type AmplitudeConfig, ComposeSubscriberStrategy, ComposeSubscribersOptions, type MixpanelConfig, type PostHogConfig, type SegmentConfig, type SlackSubscriberConfig, type WebhookConfig, composeSubscribers, createAmplitudeSubscriber, createMixpanelSubscriber, createMockSubscriber, createPostHogSubscriber, createSegmentSubscriber, createSlackSubscriber, createWebhookSubscriber };
-//# sourceMappingURL=factories.d.ts.map
+export { type AmplitudeConfig, ComposeSubscriberStrategy, ComposeSubscribersOptions, type MixpanelConfig, type PostHogConfig, type SegmentConfig, type SlackSubscriberConfig, type WebhookConfig, composeSubscribers, createAmplitudeSubscriber, createMixpanelSubscriber, createMockSubscriber, createPostHogSubscriber, createSegmentSubscriber, createSlackSubscriber, createWebhookSubscriber };

package/dist/factories.js

@@ -363,5 +363,4 @@ function composeSubscribers(subscribers, options = {}) {
 }
 
 //#endregion
-export { composeSubscribers, createAmplitudeSubscriber, createMixpanelSubscriber, createMockSubscriber, createPostHogSubscriber, createSegmentSubscriber, createSlackSubscriber, createWebhookSubscriber };
-//# sourceMappingURL=factories.js.map
+export { composeSubscribers, createAmplitudeSubscriber, createMixpanelSubscriber, createMockSubscriber, createPostHogSubscriber, createSegmentSubscriber, createSlackSubscriber, createWebhookSubscriber };

package/dist/file.cjs

@@ -66,5 +66,4 @@ var FileSubscriber = class extends require_event_subscriber_base.EventSubscriber
 };
 
 //#endregion
-exports.FileSubscriber = FileSubscriber;
-//# sourceMappingURL=file.cjs.map
+exports.FileSubscriber = FileSubscriber;

package/dist/file.d.cts

@@ -31,5 +31,4 @@ declare class FileSubscriber extends EventSubscriber {
   shutdown(): Promise<void>;
 }
 //#endregion
-export { FileSubscriber, FileSubscriberConfig };
-//# sourceMappingURL=file.d.cts.map
+export { FileSubscriber, FileSubscriberConfig };

package/dist/file.d.ts

@@ -31,5 +31,4 @@ declare class FileSubscriber extends EventSubscriber {
   shutdown(): Promise<void>;
 }
 //#endregion
-export { FileSubscriber, FileSubscriberConfig };
-//# sourceMappingURL=file.d.ts.map
+export { FileSubscriber, FileSubscriberConfig };

package/dist/file.js

@@ -63,5 +63,4 @@ var FileSubscriber = class extends EventSubscriber {
 };
 
 //#endregion
-export { FileSubscriber };
-//# sourceMappingURL=file.js.map
+export { FileSubscriber };

package/dist/index.cjs

@@ -7,6 +7,7 @@ const require_amplitude = require('./amplitude.cjs');
 const require_slack = require('./slack.cjs');
 const require_security = require('./security.cjs');
 const require_webhook = require('./webhook.cjs');
+const require_loki = require('./loki.cjs');
 const require_architecture_snapshot = require('./architecture-snapshot.cjs');
 const require_file = require('./file.cjs');
 
@@ -185,6 +186,7 @@ exports.AmplitudeSubscriber = require_amplitude.AmplitudeSubscriber;
 exports.ArchitectureSnapshotSubscriber = require_architecture_snapshot.ArchitectureSnapshotSubscriber;
 exports.EventSubscriber = require_event_subscriber_base.EventSubscriber;
 exports.FileSubscriber = require_file.FileSubscriber;
+exports.LokiSubscriber = require_loki.LokiSubscriber;
 exports.MixpanelSubscriber = require_mixpanel.MixpanelSubscriber;
 exports.PostHogSubscriber = require_posthog.PostHogSubscriber;
 exports.SecuritySubscriber = require_security.SecuritySubscriber;
@@ -192,5 +194,4 @@ exports.SegmentSubscriber = require_segment.SegmentSubscriber;
 exports.SlackSubscriber = require_slack.SlackSubscriber;
 exports.StreamingEventSubscriber = StreamingEventSubscriber;
 exports.WebhookSubscriber = require_webhook.WebhookSubscriber;
-exports.extractFieldPaths = require_architecture_snapshot.extractFieldPaths;
-//# sourceMappingURL=index.cjs.map
+exports.extractFieldPaths = require_architecture_snapshot.extractFieldPaths;

package/dist/index.d.cts

@@ -8,6 +8,7 @@ import { WebhookConfig, WebhookSubscriber } from "./webhook.cjs";
 import { SlackSubscriber, SlackSubscriberConfig } from "./slack.cjs";
 import { FileSubscriber, FileSubscriberConfig } from "./file.cjs";
 import { SecurityAlert, SecurityAlertSeverity, SecuritySubscriber, SecuritySubscriberConfig } from "./security.cjs";
+import { LokiConfig, LokiSubscriber } from "./loki.cjs";
 //#region src/streaming-event-subscriber.d.ts
 /**
  * Buffer overflow strategy
@@ -131,5 +132,4 @@ declare abstract class StreamingEventSubscriber extends EventSubscriber {
   protected compressPayload(payload: string): Promise<Buffer | string>;
 }
 //#endregion
-export { ARCHITECTURE_SNAPSHOT_SPEC, type AmplitudeConfig, AmplitudeSubscriber, type ArchitectureSnapshot, type ArchitectureSnapshotConfig, ArchitectureSnapshotSubscriber, type EventObservation, type EventPayload, EventSubscriber, FileSubscriber, type FileSubscriberConfig, type MixpanelConfig, MixpanelSubscriber, type PostHogConfig, PostHogSubscriber, type SecurityAlert, type SecurityAlertSeverity, SecuritySubscriber, type SecuritySubscriberConfig, type SegmentConfig, SegmentSubscriber, SlackSubscriber, type SlackSubscriberConfig, StreamingEventSubscriber, type WebhookConfig, WebhookSubscriber, extractFieldPaths };
-//# sourceMappingURL=index.d.cts.map
+export { ARCHITECTURE_SNAPSHOT_SPEC, type AmplitudeConfig, AmplitudeSubscriber, type ArchitectureSnapshot, type ArchitectureSnapshotConfig, ArchitectureSnapshotSubscriber, type EventObservation, type EventPayload, EventSubscriber, FileSubscriber, type FileSubscriberConfig, type LokiConfig, LokiSubscriber, type MixpanelConfig, MixpanelSubscriber, type PostHogConfig, PostHogSubscriber, type SecurityAlert, type SecurityAlertSeverity, SecuritySubscriber, type SecuritySubscriberConfig, type SegmentConfig, SegmentSubscriber, SlackSubscriber, type SlackSubscriberConfig, StreamingEventSubscriber, type WebhookConfig, WebhookSubscriber, extractFieldPaths };

package/dist/index.d.ts

@@ -8,6 +8,7 @@ import { WebhookConfig, WebhookSubscriber } from "./webhook.js";
 import { SlackSubscriber, SlackSubscriberConfig } from "./slack.js";
 import { FileSubscriber, FileSubscriberConfig } from "./file.js";
 import { SecurityAlert, SecurityAlertSeverity, SecuritySubscriber, SecuritySubscriberConfig } from "./security.js";
+import { LokiConfig, LokiSubscriber } from "./loki.js";
 //#region src/streaming-event-subscriber.d.ts
 /**
  * Buffer overflow strategy
@@ -131,5 +132,4 @@ declare abstract class StreamingEventSubscriber extends EventSubscriber {
   protected compressPayload(payload: string): Promise<Buffer | string>;
 }
 //#endregion
-export { ARCHITECTURE_SNAPSHOT_SPEC, type AmplitudeConfig, AmplitudeSubscriber, type ArchitectureSnapshot, type ArchitectureSnapshotConfig, ArchitectureSnapshotSubscriber, type EventObservation, type EventPayload, EventSubscriber, FileSubscriber, type FileSubscriberConfig, type MixpanelConfig, MixpanelSubscriber, type PostHogConfig, PostHogSubscriber, type SecurityAlert, type SecurityAlertSeverity, SecuritySubscriber, type SecuritySubscriberConfig, type SegmentConfig, SegmentSubscriber, SlackSubscriber, type SlackSubscriberConfig, StreamingEventSubscriber, type WebhookConfig, WebhookSubscriber, extractFieldPaths };
-//# sourceMappingURL=index.d.ts.map
+export { ARCHITECTURE_SNAPSHOT_SPEC, type AmplitudeConfig, AmplitudeSubscriber, type ArchitectureSnapshot, type ArchitectureSnapshotConfig, ArchitectureSnapshotSubscriber, type EventObservation, type EventPayload, EventSubscriber, FileSubscriber, type FileSubscriberConfig, type LokiConfig, LokiSubscriber, type MixpanelConfig, MixpanelSubscriber, type PostHogConfig, PostHogSubscriber, type SecurityAlert, type SecurityAlertSeverity, SecuritySubscriber, type SecuritySubscriberConfig, type SegmentConfig, SegmentSubscriber, SlackSubscriber, type SlackSubscriberConfig, StreamingEventSubscriber, type WebhookConfig, WebhookSubscriber, extractFieldPaths };

package/dist/index.js

@@ -6,6 +6,7 @@ import { AmplitudeSubscriber } from "./amplitude.js";
 import { SlackSubscriber } from "./slack.js";
 import { SecuritySubscriber } from "./security.js";
 import { WebhookSubscriber } from "./webhook.js";
+import { LokiSubscriber } from "./loki.js";
 import { ARCHITECTURE_SNAPSHOT_SPEC, ArchitectureSnapshotSubscriber, extractFieldPaths } from "./architecture-snapshot.js";
 import { FileSubscriber } from "./file.js";
 
@@ -179,5 +180,4 @@ var StreamingEventSubscriber = class extends EventSubscriber {
 };
 
 //#endregion
-export { ARCHITECTURE_SNAPSHOT_SPEC, AmplitudeSubscriber, ArchitectureSnapshotSubscriber, EventSubscriber, FileSubscriber, MixpanelSubscriber, PostHogSubscriber, SecuritySubscriber, SegmentSubscriber, SlackSubscriber, StreamingEventSubscriber, WebhookSubscriber, extractFieldPaths };
-//# sourceMappingURL=index.js.map
+export { ARCHITECTURE_SNAPSHOT_SPEC, AmplitudeSubscriber, ArchitectureSnapshotSubscriber, EventSubscriber, FileSubscriber, LokiSubscriber, MixpanelSubscriber, PostHogSubscriber, SecuritySubscriber, SegmentSubscriber, SlackSubscriber, StreamingEventSubscriber, WebhookSubscriber, extractFieldPaths };

package/dist/loki.cjs

@@ -0,0 +1,229 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_webhook_delivery = require('./webhook-delivery-DZeUlZhi.cjs');
+
+//#region src/loki.ts
+/** Push path appended to {@link LokiConfig.endpoint}. */
+const LOKI_PUSH_PATH = "/loki/api/v1/push";
+/**
+* Fields promoted to Loki labels when none are configured. Deliberately short:
+* every distinct combination of label values is a separate stream.
+*/
+const DEFAULT_LABEL_FIELDS = [
+	"service",
+	"environment",
+	"level"
+];
+function firstEnv(...names) {
+	for (const name of names) {
+		const value = process.env[name];
+		if (value) return value;
+	}
+}
+/** Resolve the push URL, tolerating an endpoint that already carries the path. */
+function resolveLokiPushUrl(endpoint) {
+	const trimmed = endpoint.replace(/\/+$/, "");
+	return trimmed.endsWith(LOKI_PUSH_PATH) ? trimmed : `${trimmed}${LOKI_PUSH_PATH}`;
+}
+/** Loki entry timestamps are nanosecond epoch strings. */
+function toLokiTimestamp(timestamp) {
+	const parsed = timestamp ? Date.parse(timestamp) : NaN;
+	return `${Number.isFinite(parsed) ? parsed : Date.now()}000000`;
+}
+/**
+* Build the stream labels for one event.
+*
+* Only configured fields holding a string, number or boolean become labels.
+* Objects and arrays are skipped rather than stringified, because a serialised
+* object is exactly the unbounded label value that wrecks a Loki instance.
+*/
+function toLokiLabels(event, config = {}) {
+	const fields = config.labelFields ?? [...DEFAULT_LABEL_FIELDS];
+	const labels = { ...config.labels };
+	for (const field of fields) {
+		const value = event[field];
+		if (typeof value === "string" || typeof value === "number" || typeof value === "boolean") labels[field] = String(value);
+	}
+	return labels;
+}
+/**
+* Group events into streams by label set.
+*
+* Loki rejects a push whose entries run backwards within a stream, so each
+* stream's values are sorted by timestamp before they go out.
+*/
+function buildLokiPayload(events, config = {}) {
+	const byLabels = /* @__PURE__ */ new Map();
+	for (const event of events) {
+		const labels = toLokiLabels(event, config);
+		const key = JSON.stringify(Object.entries(labels).toSorted(([a], [b]) => a.localeCompare(b)));
+		const entry = [toLokiTimestamp(typeof event.timestamp === "string" ? event.timestamp : void 0), JSON.stringify(event)];
+		const existing = byLabels.get(key);
+		if (existing) existing.values.push(entry);
+		else byLabels.set(key, {
+			stream: labels,
+			values: [entry]
+		});
+	}
+	for (const stream of byLabels.values()) stream.values = stream.values.toSorted(([a], [b]) => a < b ? -1 : a > b ? 1 : 0);
+	return { streams: [...byLabels.values()] };
+}
+/** Auth and tenancy headers for a resolved config. */
+function toLokiHeaders(config) {
+	const headers = {};
+	if (config.user && config.apiKey) headers.Authorization = `Basic ${Buffer.from(`${config.user}:${config.apiKey}`).toString("base64")}`;
+	else if (config.apiKey) headers.Authorization = `Bearer ${config.apiKey}`;
+	if (config.tenantId) headers["X-Scope-OrgID"] = config.tenantId;
+	return headers;
+}
+/** Push a batch of events without going through a subscriber. */
+async function sendBatchToLoki(events, config = {}) {
+	if (events.length === 0) return;
+	const endpoint = config.endpoint ?? firstEnv("LOKI_ENDPOINT", "LOKI_URL", "LOKI_BASE_URL");
+	if (!endpoint) throw new Error("Loki endpoint is not configured");
+	const resolved = {
+		...config,
+		endpoint,
+		apiKey: config.apiKey ?? firstEnv("LOKI_API_KEY", "GRAFANA_API_KEY"),
+		user: config.user ?? firstEnv("LOKI_USER", "GRAFANA_USER"),
+		tenantId: config.tenantId ?? firstEnv("LOKI_TENANT_ID")
+	};
+	await require_webhook_delivery.postJsonWithRetry(require_webhook_delivery.createHttpClient({ timeoutMs: resolved.timeoutMs ?? 5e3 }), resolveLokiPushUrl(endpoint), buildLokiPayload(events, resolved), {
+		headers: toLokiHeaders(resolved),
+		maxRetries: resolved.maxRetries ?? 3,
+		label: "Loki"
+	});
+}
+/** Push a single event without going through a subscriber. */
+async function sendToLoki(event, config = {}) {
+	await sendBatchToLoki([event], config);
+}
+/**
+* Buffers events and pushes them to Loki as grouped streams.
+*
+* Batching is not an optimisation here so much as the shape Loki wants: one
+* request carrying several streams costs far less than one request per event,
+* and grouping is what lets entries be ordered within a stream.
+*/
+var LokiSubscriber = class {
+	name = "LokiSubscriber";
+	version = "1.0.0";
+	config;
+	endpoint;
+	enabled;
+	batchSize;
+	flushIntervalMs;
+	httpClient;
+	buffer = [];
+	timer;
+	pending = /* @__PURE__ */ new Set();
+	warnedMissingEndpoint = false;
+	constructor(config = {}) {
+		this.endpoint = config.endpoint ?? firstEnv("LOKI_ENDPOINT", "LOKI_URL", "LOKI_BASE_URL");
+		this.config = {
+			...config,
+			apiKey: config.apiKey ?? firstEnv("LOKI_API_KEY", "GRAFANA_API_KEY"),
+			user: config.user ?? firstEnv("LOKI_USER", "GRAFANA_USER"),
+			tenantId: config.tenantId ?? firstEnv("LOKI_TENANT_ID")
+		};
+		this.enabled = config.enabled ?? true;
+		this.batchSize = config.batchSize ?? 100;
+		this.flushIntervalMs = config.flushIntervalMs ?? 5e3;
+		this.httpClient = require_webhook_delivery.createHttpClient({ timeoutMs: config.timeoutMs ?? 5e3 });
+	}
+	record(event) {
+		if (!this.enabled) return;
+		if (!this.endpoint) {
+			if (!this.warnedMissingEndpoint) {
+				this.warnedMissingEndpoint = true;
+				console.warn("[autotel/loki] No endpoint configured; set LOKI_ENDPOINT or pass { endpoint }. Events are being dropped.");
+			}
+			return;
+		}
+		this.buffer.push(event);
+		if (this.buffer.length >= this.batchSize) {
+			this.track(this.flush());
+			return;
+		}
+		if (!this.timer) {
+			this.timer = setTimeout(() => {
+				this.timer = void 0;
+				this.track(this.flush());
+			}, this.flushIntervalMs);
+			this.timer.unref?.();
+		}
+	}
+	/** Push everything buffered so far. Safe to call when empty. */
+	async flush() {
+		if (this.buffer.length === 0 || !this.endpoint) return;
+		const batch = this.buffer;
+		this.buffer = [];
+		await require_webhook_delivery.postJsonWithRetry(this.httpClient, resolveLokiPushUrl(this.endpoint), buildLokiPayload(batch, this.config), {
+			headers: toLokiHeaders(this.config),
+			maxRetries: this.config.maxRetries ?? 3,
+			label: "Loki"
+		});
+	}
+	async trackEvent(name, attributes, options) {
+		this.record({
+			type: "event",
+			name,
+			...attributes,
+			timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+			...options?.autotel ? { autotel: options.autotel } : {}
+		});
+	}
+	async trackFunnelStep(funnelName, step, attributes, options) {
+		this.record({
+			type: "funnel",
+			funnel: funnelName,
+			step,
+			...attributes,
+			timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+			...options?.autotel ? { autotel: options.autotel } : {}
+		});
+	}
+	async trackOutcome(operationName, outcome, attributes, options) {
+		this.record({
+			type: "outcome",
+			operation: operationName,
+			outcome,
+			...attributes,
+			timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+			...options?.autotel ? { autotel: options.autotel } : {}
+		});
+	}
+	async trackValue(name, value, attributes, options) {
+		this.record({
+			type: "value",
+			name,
+			value,
+			...attributes,
+			timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+			...options?.autotel ? { autotel: options.autotel } : {}
+		});
+	}
+	track(request) {
+		this.pending.add(request);
+		request.catch(() => {}).finally(() => {
+			this.pending.delete(request);
+		});
+	}
+	async shutdown() {
+		if (this.timer) {
+			clearTimeout(this.timer);
+			this.timer = void 0;
+		}
+		if (this.pending.size > 0) await Promise.allSettled(this.pending);
+		await this.flush().catch(() => {});
+	}
+};
+
+//#endregion
+exports.LokiSubscriber = LokiSubscriber;
+exports.buildLokiPayload = buildLokiPayload;
+exports.resolveLokiPushUrl = resolveLokiPushUrl;
+exports.sendBatchToLoki = sendBatchToLoki;
+exports.sendToLoki = sendToLoki;
+exports.toLokiHeaders = toLokiHeaders;
+exports.toLokiLabels = toLokiLabels;
+exports.toLokiTimestamp = toLokiTimestamp;

package/dist/loki.d.cts

@@ -0,0 +1,119 @@
+import { EventAttributes, EventSubscriber, EventTrackingOptions, FunnelStatus, OutcomeStatus } from "autotel/event-subscriber";
+//#region src/loki.d.ts
+interface LokiConfig {
+  /**
+   * Base URL of the Loki instance, without the push path.
+   * Falls back to `LOKI_ENDPOINT`, `LOKI_URL`, then `LOKI_BASE_URL`.
+   *
+   * @example 'http://localhost:3100'
+   * @example 'https://logs-prod-eu-west-0.grafana.net'
+   */
+  endpoint?: string;
+  /**
+   * API token. Paired with {@link LokiConfig.user} it is sent as HTTP Basic,
+   * which is what Grafana Cloud expects. Alone it is sent as Bearer, which
+   * suits an instance behind an authenticating proxy.
+   * Falls back to `LOKI_API_KEY`, then `GRAFANA_API_KEY`.
+   */
+  apiKey?: string;
+  /**
+   * Grafana Cloud instance ID — the numeric user of the Loki datasource, not
+   * an account email. Supplying it switches authentication to Basic.
+   * Falls back to `LOKI_USER`, then `GRAFANA_USER`.
+   */
+  user?: string;
+  /**
+   * Tenant for multi-tenant self-hosted Loki, sent as `X-Scope-OrgID`.
+   * Independent of the auth mode. Falls back to `LOKI_TENANT_ID`.
+   */
+  tenantId?: string;
+  /**
+   * Event fields promoted to stream labels.
+   * Defaults to `['service', 'environment', 'level']`.
+   *
+   * Keep this short and bounded. Promoting `requestId` or `userId` creates one
+   * stream per value, which degrades and eventually breaks an instance.
+   */
+  labelFields?: string[];
+  /** Static labels merged into every stream, e.g. `{ cluster: 'prod-eu' }`. */
+  labels?: Record<string, string>;
+  /** Events buffered before a push. Default 100. */
+  batchSize?: number;
+  /** Milliseconds before a partial batch is pushed anyway. Default 5000. */
+  flushIntervalMs?: number;
+  /** Request timeout in milliseconds. Default 5000. */
+  timeoutMs?: number;
+  /** Attempts including the first. Default 3. */
+  maxRetries?: number;
+  /** Set false to construct the subscriber without sending anything. */
+  enabled?: boolean;
+}
+/** One event as it is written to the Loki line. */
+type LokiEvent = Record<string, unknown> & {
+  timestamp?: string;
+};
+interface LokiStream {
+  stream: Record<string, string>;
+  values: [string, string][];
+}
+interface LokiPayload {
+  streams: LokiStream[];
+}
+/** Resolve the push URL, tolerating an endpoint that already carries the path. */
+declare function resolveLokiPushUrl(endpoint: string): string;
+/** Loki entry timestamps are nanosecond epoch strings. */
+declare function toLokiTimestamp(timestamp?: string): string;
+/**
+ * Build the stream labels for one event.
+ *
+ * Only configured fields holding a string, number or boolean become labels.
+ * Objects and arrays are skipped rather than stringified, because a serialised
+ * object is exactly the unbounded label value that wrecks a Loki instance.
+ */
+declare function toLokiLabels(event: LokiEvent, config?: Pick<LokiConfig, 'labelFields' | 'labels'>): Record<string, string>;
+/**
+ * Group events into streams by label set.
+ *
+ * Loki rejects a push whose entries run backwards within a stream, so each
+ * stream's values are sorted by timestamp before they go out.
+ */
+declare function buildLokiPayload(events: LokiEvent[], config?: Pick<LokiConfig, 'labelFields' | 'labels'>): LokiPayload;
+/** Auth and tenancy headers for a resolved config. */
+declare function toLokiHeaders(config: Pick<LokiConfig, 'apiKey' | 'user' | 'tenantId'>): Record<string, string>;
+/** Push a batch of events without going through a subscriber. */
+declare function sendBatchToLoki(events: LokiEvent[], config?: LokiConfig): Promise<void>;
+/** Push a single event without going through a subscriber. */
+declare function sendToLoki(event: LokiEvent, config?: LokiConfig): Promise<void>;
+/**
+ * Buffers events and pushes them to Loki as grouped streams.
+ *
+ * Batching is not an optimisation here so much as the shape Loki wants: one
+ * request carrying several streams costs far less than one request per event,
+ * and grouping is what lets entries be ordered within a stream.
+ */
+declare class LokiSubscriber implements EventSubscriber {
+  readonly name = "LokiSubscriber";
+  readonly version = "1.0.0";
+  private readonly config;
+  private readonly endpoint;
+  private readonly enabled;
+  private readonly batchSize;
+  private readonly flushIntervalMs;
+  private readonly httpClient;
+  private buffer;
+  private timer;
+  private readonly pending;
+  private warnedMissingEndpoint;
+  constructor(config?: LokiConfig);
+  private record;
+  /** Push everything buffered so far. Safe to call when empty. */
+  flush(): Promise<void>;
+  trackEvent(name: string, attributes?: EventAttributes, options?: EventTrackingOptions): Promise<void>;
+  trackFunnelStep(funnelName: string, step: FunnelStatus, attributes?: EventAttributes, options?: EventTrackingOptions): Promise<void>;
+  trackOutcome(operationName: string, outcome: OutcomeStatus, attributes?: EventAttributes, options?: EventTrackingOptions): Promise<void>;
+  trackValue(name: string, value: number, attributes?: EventAttributes, options?: EventTrackingOptions): Promise<void>;
+  private track;
+  shutdown(): Promise<void>;
+}
+//#endregion
+export { LokiConfig, LokiEvent, LokiPayload, LokiSubscriber, buildLokiPayload, resolveLokiPushUrl, sendBatchToLoki, sendToLoki, toLokiHeaders, toLokiLabels, toLokiTimestamp };