@bufferlog/sdk-node 1.0.0

package/dist/core/log-event.js

@@ -0,0 +1,78 @@
+/**
+ * BufferLog Log Event Schema
+ *
+ * Lightweight internal representation of a log event.
+ * Designed for minimal allocation in the hot path:
+ * - Numeric timestamp (not ISO string)
+ * - Numeric enum for level (fast comparison)
+ * - Optional metadata to avoid empty object allocation
+ */
+/**
+ * Log severity levels as numeric enum for fast comparison.
+ * Usage: `if (event.level >= LogLevel.ERROR)` triggers a flush.
+ */
+export var LogLevel;
+(function (LogLevel) {
+    LogLevel[LogLevel["TRACE"] = 0] = "TRACE";
+    LogLevel[LogLevel["DEBUG"] = 10] = "DEBUG";
+    LogLevel[LogLevel["INFO"] = 20] = "INFO";
+    LogLevel[LogLevel["WARN"] = 30] = "WARN";
+    LogLevel[LogLevel["ERROR"] = 40] = "ERROR";
+    LogLevel[LogLevel["FATAL"] = 50] = "FATAL";
+})(LogLevel || (LogLevel = {}));
+/**
+ * Human-readable label map for serialization.
+ */
+export const LOG_LEVEL_LABELS = {
+    [LogLevel.TRACE]: 'TRACE',
+    [LogLevel.DEBUG]: 'DEBUG',
+    [LogLevel.INFO]: 'INFO',
+    [LogLevel.WARN]: 'WARN',
+    [LogLevel.ERROR]: 'ERROR',
+    [LogLevel.FATAL]: 'FATAL',
+};
+/**
+ * Reverse lookup: string label → LogLevel.
+ * Used when parsing levels from external logging libraries (e.g., Winston's 'info' → LogLevel.INFO).
+ */
+export const LOG_LEVEL_FROM_STRING = {
+    trace: LogLevel.TRACE,
+    debug: LogLevel.DEBUG,
+    info: LogLevel.INFO,
+    warn: LogLevel.WARN,
+    warning: LogLevel.WARN,
+    error: LogLevel.ERROR,
+    fatal: LogLevel.FATAL,
+    crit: LogLevel.FATAL,
+    emerg: LogLevel.FATAL,
+    // Winston-specific numeric levels (lower = more severe in Winston)
+    // We handle these in the Winston transport via explicit mapping
+};
+/**
+ * Convert an internal LogEvent to its serialized downstream format.
+ * Called only on the flush path (not hot path), so string allocation is acceptable.
+ */
+export function serializeLogEvent(event) {
+    return {
+        timestamp: new Date(event.timestamp).toISOString(),
+        level: LOG_LEVEL_LABELS[event.level] ?? 'UNKNOWN',
+        message: event.message,
+        ...(event.metadata && { metadata: event.metadata }),
+        contextId: event.contextId,
+        source: 'bufferlog',
+    };
+}
+/**
+ * Factory for creating LogEvents with minimal ceremony.
+ * Captures timestamp at call time.
+ */
+export function createLogEvent(level, message, contextId, metadata) {
+    return {
+        timestamp: Date.now(),
+        level,
+        message,
+        contextId,
+        ...(metadata && { metadata }),
+    };
+}
+//# sourceMappingURL=log-event.js.map

package/dist/core/log-event.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-event.js","sourceRoot":"","sources":["../../src/core/log-event.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;GAGG;AACH,MAAM,CAAN,IAAY,QAOX;AAPD,WAAY,QAAQ;IAClB,yCAAS,CAAA;IACT,0CAAU,CAAA;IACV,wCAAS,CAAA;IACT,wCAAS,CAAA;IACT,0CAAU,CAAA;IACV,0CAAU,CAAA;AACZ,CAAC,EAPW,QAAQ,KAAR,QAAQ,QAOnB;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAA6B;IACxD,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO;IACzB,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO;IACzB,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM;IACvB,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM;IACvB,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO;IACzB,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO;CAC1B,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAA6B;IAC7D,KAAK,EAAE,QAAQ,CAAC,KAAK;IACrB,KAAK,EAAE,QAAQ,CAAC,KAAK;IACrB,IAAI,EAAE,QAAQ,CAAC,IAAI;IACnB,IAAI,EAAE,QAAQ,CAAC,IAAI;IACnB,OAAO,EAAE,QAAQ,CAAC,IAAI;IACtB,KAAK,EAAE,QAAQ,CAAC,KAAK;IACrB,KAAK,EAAE,QAAQ,CAAC,KAAK;IACrB,IAAI,EAAE,QAAQ,CAAC,KAAK;IACpB,KAAK,EAAE,QAAQ,CAAC,KAAK;IACrB,mEAAmE;IACnE,gEAAgE;CACjE,CAAC;AAuCF;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAe;IAC/C,OAAO;QACL,SAAS,EAAE,IAAI,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE;QAClD,KAAK,EAAE,gBAAgB,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,SAAS;QACjD,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,GAAG,CAAC,KAAK,CAAC,QAAQ,IAAI,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC;QACnD,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,MAAM,EAAE,WAAW;KACpB,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAC5B,KAAe,EACf,OAAe,EACf,SAAiB,EACjB,QAAkC;IAElC,OAAO;QACL,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;QACrB,KAAK;QACL,OAAO;QACP,SAAS;QACT,GAAG,CAAC,QAAQ,IAAI,EAAE,QAAQ,EAAE,CAAC;KAC9B,CAAC;AACJ,CAAC"}

package/dist/core/ring-buffer.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Ring Buffer — Fixed-size circular buffer for log events.
+ *
+ * Design goals:
+ * - O(1) push with zero allocation (pre-allocated array slots)
+ * - O(n) drain that returns items in chronological (insertion) order
+ * - Overwrites oldest entries when full (ring/circular behavior)
+ * - Minimal GC pressure: `clear()` resets pointers, doesn't deallocate
+ *
+ * Node.js is single-threaded per event loop, so no mutex is needed.
+ * However, `drain()` is designed to be atomic within a single tick —
+ * no interleaving with `push()` can occur in the same microtask.
+ */
+export declare class RingBuffer<T> {
+    private readonly capacity;
+    private readonly buffer;
+    private head;
+    private _size;
+    /**
+     * @param capacity Maximum number of items before oldest are overwritten.
+     *                 Must be a positive integer.
+     */
+    constructor(capacity: number);
+    /**
+     * Push an item into the buffer. O(1).
+     * If the buffer is full, the oldest item is silently overwritten.
+     */
+    push(item: T): void;
+    /**
+     * Drain all items from the buffer in chronological (insertion) order.
+     * Resets the buffer to empty after draining.
+     *
+     * @returns Array of items ordered from oldest to newest.
+     */
+    drain(): T[];
+    /**
+     * Peek at all items without draining. Returns items in chronological order.
+     * Useful for testing and debugging.
+     */
+    peek(): T[];
+    /**
+     * Clear the buffer. Resets pointers only — slots are reused, not deallocated.
+     * This minimizes GC pressure: the underlying array stays allocated.
+     */
+    clear(): void;
+    /**
+     * Clear the buffer AND release all references (allows GC of stored items).
+     * Use this when the buffer itself will persist but stored items should be freed.
+     */
+    clearFull(): void;
+    /** Current number of items in the buffer. */
+    get size(): number;
+    /** Whether the buffer has reached its maximum capacity. */
+    get isFull(): boolean;
+    /** Whether the buffer contains no items. */
+    get isEmpty(): boolean;
+    /** Maximum capacity of the buffer. */
+    get maxCapacity(): number;
+}
+//# sourceMappingURL=ring-buffer.d.ts.map

package/dist/core/ring-buffer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ring-buffer.d.ts","sourceRoot":"","sources":["../../src/core/ring-buffer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,qBAAa,UAAU,CAAC,CAAC;IASX,OAAO,CAAC,QAAQ,CAAC,QAAQ;IARrC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoB;IAC3C,OAAO,CAAC,IAAI,CAAa;IACzB,OAAO,CAAC,KAAK,CAAa;IAE1B;;;OAGG;gBAC0B,QAAQ,EAAE,MAAM;IAQ7C;;;OAGG;IACH,IAAI,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI;IAUnB;;;;;OAKG;IACH,KAAK,IAAI,CAAC,EAAE;IAuBZ;;;OAGG;IACH,IAAI,IAAI,CAAC,EAAE;IAgBX;;;OAGG;IACH,KAAK,IAAI,IAAI;IAQb;;;OAGG;IACH,SAAS,IAAI,IAAI;IAMjB,6CAA6C;IAC7C,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,2DAA2D;IAC3D,IAAI,MAAM,IAAI,OAAO,CAEpB;IAED,4CAA4C;IAC5C,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,sCAAsC;IACtC,IAAI,WAAW,IAAI,MAAM,CAExB;CACF"}

package/dist/core/ring-buffer.js

@@ -0,0 +1,120 @@
+/**
+ * Ring Buffer — Fixed-size circular buffer for log events.
+ *
+ * Design goals:
+ * - O(1) push with zero allocation (pre-allocated array slots)
+ * - O(n) drain that returns items in chronological (insertion) order
+ * - Overwrites oldest entries when full (ring/circular behavior)
+ * - Minimal GC pressure: `clear()` resets pointers, doesn't deallocate
+ *
+ * Node.js is single-threaded per event loop, so no mutex is needed.
+ * However, `drain()` is designed to be atomic within a single tick —
+ * no interleaving with `push()` can occur in the same microtask.
+ */
+export class RingBuffer {
+    capacity;
+    buffer;
+    head = 0; // Next write position
+    _size = 0; // Current number of items
+    /**
+     * @param capacity Maximum number of items before oldest are overwritten.
+     *                 Must be a positive integer.
+     */
+    constructor(capacity) {
+        this.capacity = capacity;
+        if (capacity <= 0 || !Number.isInteger(capacity)) {
+            throw new Error(`RingBuffer capacity must be a positive integer, got: ${capacity}`);
+        }
+        // Pre-allocate all slots to avoid dynamic resizing
+        this.buffer = new Array(capacity).fill(undefined);
+    }
+    /**
+     * Push an item into the buffer. O(1).
+     * If the buffer is full, the oldest item is silently overwritten.
+     */
+    push(item) {
+        this.buffer[this.head] = item;
+        this.head = (this.head + 1) % this.capacity;
+        if (this._size < this.capacity) {
+            this._size++;
+        }
+        // When _size === capacity, head has wrapped and is now pointing
+        // at the oldest item (which we just overwrote). _size stays at capacity.
+    }
+    /**
+     * Drain all items from the buffer in chronological (insertion) order.
+     * Resets the buffer to empty after draining.
+     *
+     * @returns Array of items ordered from oldest to newest.
+     */
+    drain() {
+        if (this._size === 0) {
+            return [];
+        }
+        const result = new Array(this._size);
+        // Calculate the start position (oldest item)
+        // If buffer hasn't wrapped: start = 0
+        // If buffer has wrapped: start = head (which points to the oldest after overwrite)
+        const start = this._size < this.capacity ? 0 : this.head;
+        for (let i = 0; i < this._size; i++) {
+            const idx = (start + i) % this.capacity;
+            result[i] = this.buffer[idx];
+        }
+        // Reset the buffer
+        this.clear();
+        return result;
+    }
+    /**
+     * Peek at all items without draining. Returns items in chronological order.
+     * Useful for testing and debugging.
+     */
+    peek() {
+        if (this._size === 0) {
+            return [];
+        }
+        const result = new Array(this._size);
+        const start = this._size < this.capacity ? 0 : this.head;
+        for (let i = 0; i < this._size; i++) {
+            const idx = (start + i) % this.capacity;
+            result[i] = this.buffer[idx];
+        }
+        return result;
+    }
+    /**
+     * Clear the buffer. Resets pointers only — slots are reused, not deallocated.
+     * This minimizes GC pressure: the underlying array stays allocated.
+     */
+    clear() {
+        this.head = 0;
+        this._size = 0;
+        // Intentionally NOT clearing buffer slots to avoid allocation.
+        // Old references will be overwritten on next push() cycle.
+        // If you need to release references for GC (e.g., large objects), use clearFull().
+    }
+    /**
+     * Clear the buffer AND release all references (allows GC of stored items).
+     * Use this when the buffer itself will persist but stored items should be freed.
+     */
+    clearFull() {
+        this.buffer.fill(undefined);
+        this.head = 0;
+        this._size = 0;
+    }
+    /** Current number of items in the buffer. */
+    get size() {
+        return this._size;
+    }
+    /** Whether the buffer has reached its maximum capacity. */
+    get isFull() {
+        return this._size === this.capacity;
+    }
+    /** Whether the buffer contains no items. */
+    get isEmpty() {
+        return this._size === 0;
+    }
+    /** Maximum capacity of the buffer. */
+    get maxCapacity() {
+        return this.capacity;
+    }
+}
+//# sourceMappingURL=ring-buffer.js.map

package/dist/core/ring-buffer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ring-buffer.js","sourceRoot":"","sources":["../../src/core/ring-buffer.ts"],"names":[],"mappings":"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"}

package/dist/flash/adapters/datadog.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Datadog HTTP Intake Adapter
+ *
+ * Sends flushed log events to Datadog's HTTP Intake API.
+ * API Docs: https://docs.datadoghq.com/api/latest/logs/#send-logs
+ *
+ * Endpoint: POST https://http-intake.logs.{site}/api/v2/logs
+ * Auth: DD-API-KEY header
+ */
+import type { SerializedLogEvent } from '../../core/log-event.js';
+import type { DownstreamAdapter } from './types.js';
+export interface DatadogAdapterOptions {
+    /** Datadog API key */
+    apiKey: string;
+    /**
+     * Datadog site.
+     * @default 'datadoghq.com'
+     */
+    site?: string;
+    /** Service name to tag logs with */
+    service?: string;
+    /** Source tag (e.g., 'nodejs') */
+    source?: string;
+    /** Additional tags to apply to all events (e.g., 'env:production') */
+    tags?: string[];
+    /** Request timeout in ms. @default 10000 */
+    timeoutMs?: number;
+}
+export declare class DatadogAdapter implements DownstreamAdapter {
+    readonly name = "datadog";
+    private readonly apiKey;
+    private readonly endpoint;
+    private readonly service;
+    private readonly source;
+    private readonly tags;
+    private readonly timeoutMs;
+    constructor(options: DatadogAdapterOptions);
+    send(events: SerializedLogEvent[], contextId: string): Promise<void>;
+}
+//# sourceMappingURL=datadog.d.ts.map

package/dist/flash/adapters/datadog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"datadog.d.ts","sourceRoot":"","sources":["../../../src/flash/adapters/datadog.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpD,MAAM,WAAW,qBAAqB;IACpC,sBAAsB;IACtB,MAAM,EAAE,MAAM,CAAC;IAEf;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,oCAAoC;IACpC,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,kCAAkC;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,sEAAsE;IACtE,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAEhB,4CAA4C;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,cAAe,YAAW,iBAAiB;IACtD,QAAQ,CAAC,IAAI,aAAa;IAE1B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEvB,OAAO,EAAE,qBAAqB;IAUpC,IAAI,CAAC,MAAM,EAAE,kBAAkB,EAAE,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CA2C3E"}

package/dist/flash/adapters/datadog.js

@@ -0,0 +1,67 @@
+/**
+ * Datadog HTTP Intake Adapter
+ *
+ * Sends flushed log events to Datadog's HTTP Intake API.
+ * API Docs: https://docs.datadoghq.com/api/latest/logs/#send-logs
+ *
+ * Endpoint: POST https://http-intake.logs.{site}/api/v2/logs
+ * Auth: DD-API-KEY header
+ */
+export class DatadogAdapter {
+    name = 'datadog';
+    apiKey;
+    endpoint;
+    service;
+    source;
+    tags;
+    timeoutMs;
+    constructor(options) {
+        this.apiKey = options.apiKey;
+        const site = options.site ?? 'datadoghq.com';
+        this.endpoint = `https://http-intake.logs.${site}/api/v2/logs`;
+        this.service = options.service ?? 'bufferlog';
+        this.source = options.source ?? 'nodejs';
+        this.tags = (options.tags ?? []).join(',');
+        this.timeoutMs = options.timeoutMs ?? 10_000;
+    }
+    async send(events, contextId) {
+        // Transform to Datadog's expected log format
+        const ddLogs = events.map((event) => ({
+            ddsource: this.source,
+            ddtags: this.tags
+                ? `${this.tags},bufferlog.context_id:${contextId}`
+                : `bufferlog.context_id:${contextId}`,
+            hostname: process.env.HOSTNAME ?? 'unknown',
+            service: this.service,
+            status: event.level.toLowerCase(),
+            message: event.message,
+            timestamp: event.timestamp,
+            ...event.metadata,
+            bufferlog: {
+                contextId,
+                source: 'bufferlog-flush',
+            },
+        }));
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), this.timeoutMs);
+        try {
+            const response = await fetch(this.endpoint, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    'DD-API-KEY': this.apiKey,
+                },
+                body: JSON.stringify(ddLogs),
+                signal: controller.signal,
+            });
+            if (!response.ok) {
+                const body = await response.text().catch(() => 'unknown');
+                throw new Error(`Datadog API returned ${response.status}: ${body}`);
+            }
+        }
+        finally {
+            clearTimeout(timeout);
+        }
+    }
+}
+//# sourceMappingURL=datadog.js.map

package/dist/flash/adapters/datadog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"datadog.js","sourceRoot":"","sources":["../../../src/flash/adapters/datadog.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AA4BH,MAAM,OAAO,cAAc;IAChB,IAAI,GAAG,SAAS,CAAC;IAET,MAAM,CAAS;IACf,QAAQ,CAAS;IACjB,OAAO,CAAS;IAChB,MAAM,CAAS;IACf,IAAI,CAAS;IACb,SAAS,CAAS;IAEnC,YAAY,OAA8B;QACxC,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC7B,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,eAAe,CAAC;QAC7C,IAAI,CAAC,QAAQ,GAAG,4BAA4B,IAAI,cAAc,CAAC;QAC/D,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,WAAW,CAAC;QAC9C,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,QAAQ,CAAC;QACzC,IAAI,CAAC,IAAI,GAAG,CAAC,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC3C,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,MAAM,CAAC;IAC/C,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,MAA4B,EAAE,SAAiB;QACxD,6CAA6C;QAC7C,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YACpC,QAAQ,EAAE,IAAI,CAAC,MAAM;YACrB,MAAM,EAAE,IAAI,CAAC,IAAI;gBACf,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,yBAAyB,SAAS,EAAE;gBAClD,CAAC,CAAC,wBAAwB,SAAS,EAAE;YACvC,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,QAAQ,IAAI,SAAS;YAC3C,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,MAAM,EAAE,KAAK,CAAC,KAAK,CAAC,WAAW,EAAE;YACjC,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,GAAG,KAAK,CAAC,QAAQ;YACjB,SAAS,EAAE;gBACT,SAAS;gBACT,MAAM,EAAE,iBAAiB;aAC1B;SACF,CAAC,CAAC,CAAC;QAEJ,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;QAErE,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE;gBAC1C,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE;oBACP,cAAc,EAAE,kBAAkB;oBAClC,YAAY,EAAE,IAAI,CAAC,MAAM;iBAC1B;gBACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC;gBAC5B,MAAM,EAAE,UAAU,CAAC,MAAM;aAC1B,CAAC,CAAC;YAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;gBAC1D,MAAM,IAAI,KAAK,CACb,wBAAwB,QAAQ,CAAC,MAAM,KAAK,IAAI,EAAE,CACnD,CAAC;YACJ,CAAC;QACH,CAAC;gBAAS,CAAC;YACT,YAAY,CAAC,OAAO,CAAC,CAAC;QACxB,CAAC;IACH,CAAC;CACF"}

package/dist/flash/adapters/splunk.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Splunk HTTP Event Collector (HEC) Adapter
+ *
+ * Sends flushed log events to Splunk via the HEC endpoint.
+ * API Docs: https://docs.splunk.com/Documentation/Splunk/latest/Data/UsetheHTTPEventCollector
+ *
+ * Endpoint: POST https://{host}:{port}/services/collector/event
+ * Auth: Splunk {token} in Authorization header
+ */
+import type { SerializedLogEvent } from '../../core/log-event.js';
+import type { DownstreamAdapter } from './types.js';
+export interface SplunkAdapterOptions {
+    /** Splunk HEC token */
+    token: string;
+    /**
+     * Splunk HEC endpoint URL (including port).
+     * @example 'https://splunk.example.com:8088'
+     */
+    url: string;
+    /** Splunk index to write to. If not set, uses the HEC token's default index. */
+    index?: string;
+    /** Source type for the events. @default '_json' */
+    sourceType?: string;
+    /** Source identifier. @default 'bufferlog' */
+    source?: string;
+    /** Request timeout in ms. @default 10000 */
+    timeoutMs?: number;
+    /**
+     * Whether to skip TLS certificate verification.
+     * Useful for self-signed certs in development.
+     * @default false
+     */
+    insecure?: boolean;
+}
+export declare class SplunkAdapter implements DownstreamAdapter {
+    readonly name = "splunk";
+    private readonly token;
+    private readonly endpoint;
+    private readonly index?;
+    private readonly sourceType;
+    private readonly source;
+    private readonly timeoutMs;
+    constructor(options: SplunkAdapterOptions);
+    send(events: SerializedLogEvent[], contextId: string): Promise<void>;
+}
+//# sourceMappingURL=splunk.d.ts.map

package/dist/flash/adapters/splunk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"splunk.d.ts","sourceRoot":"","sources":["../../../src/flash/adapters/splunk.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpD,MAAM,WAAW,oBAAoB;IACnC,uBAAuB;IACvB,KAAK,EAAE,MAAM,CAAC;IAEd;;;OAGG;IACH,GAAG,EAAE,MAAM,CAAC;IAEZ,gFAAgF;IAChF,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,mDAAmD;IACnD,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,8CAA8C;IAC9C,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,4CAA4C;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,qBAAa,aAAc,YAAW,iBAAiB;IACrD,QAAQ,CAAC,IAAI,YAAY;IAEzB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEvB,OAAO,EAAE,oBAAoB;IAWnC,IAAI,CAAC,MAAM,EAAE,kBAAkB,EAAE,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CA+C3E"}

package/dist/flash/adapters/splunk.js

@@ -0,0 +1,71 @@
+/**
+ * Splunk HTTP Event Collector (HEC) Adapter
+ *
+ * Sends flushed log events to Splunk via the HEC endpoint.
+ * API Docs: https://docs.splunk.com/Documentation/Splunk/latest/Data/UsetheHTTPEventCollector
+ *
+ * Endpoint: POST https://{host}:{port}/services/collector/event
+ * Auth: Splunk {token} in Authorization header
+ */
+export class SplunkAdapter {
+    name = 'splunk';
+    token;
+    endpoint;
+    index;
+    sourceType;
+    source;
+    timeoutMs;
+    constructor(options) {
+        this.token = options.token;
+        // Ensure the URL ends with the collector path
+        const baseUrl = options.url.replace(/\/+$/, '');
+        this.endpoint = `${baseUrl}/services/collector/event`;
+        this.index = options.index;
+        this.sourceType = options.sourceType ?? '_json';
+        this.source = options.source ?? 'bufferlog';
+        this.timeoutMs = options.timeoutMs ?? 10_000;
+    }
+    async send(events, contextId) {
+        // Splunk HEC expects newline-delimited JSON events (batch mode)
+        // Each event is a separate JSON object on its own line
+        const hecEvents = events.map((event) => ({
+            time: new Date(event.timestamp).getTime() / 1000, // Splunk expects epoch seconds
+            host: process.env.HOSTNAME ?? 'unknown',
+            source: this.source,
+            sourcetype: this.sourceType,
+            ...(this.index && { index: this.index }),
+            event: {
+                level: event.level,
+                message: event.message,
+                contextId,
+                ...event.metadata,
+                bufferlog: {
+                    source: 'bufferlog-flush',
+                },
+            },
+        }));
+        // Splunk HEC batch format: newline-delimited JSON
+        const body = hecEvents.map((e) => JSON.stringify(e)).join('\n');
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), this.timeoutMs);
+        try {
+            const response = await fetch(this.endpoint, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    'Authorization': `Splunk ${this.token}`,
+                },
+                body,
+                signal: controller.signal,
+            });
+            if (!response.ok) {
+                const respBody = await response.text().catch(() => 'unknown');
+                throw new Error(`Splunk HEC returned ${response.status}: ${respBody}`);
+            }
+        }
+        finally {
+            clearTimeout(timeout);
+        }
+    }
+}
+//# sourceMappingURL=splunk.js.map

package/dist/flash/adapters/splunk.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"splunk.js","sourceRoot":"","sources":["../../../src/flash/adapters/splunk.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAmCH,MAAM,OAAO,aAAa;IACf,IAAI,GAAG,QAAQ,CAAC;IAER,KAAK,CAAS;IACd,QAAQ,CAAS;IACjB,KAAK,CAAU;IACf,UAAU,CAAS;IACnB,MAAM,CAAS;IACf,SAAS,CAAS;IAEnC,YAAY,OAA6B;QACvC,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAC3B,8CAA8C;QAC9C,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAChD,IAAI,CAAC,QAAQ,GAAG,GAAG,OAAO,2BAA2B,CAAC;QACtD,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAC3B,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,OAAO,CAAC;QAChD,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,WAAW,CAAC;QAC5C,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,MAAM,CAAC;IAC/C,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,MAA4B,EAAE,SAAiB;QACxD,gEAAgE;QAChE,uDAAuD;QACvD,MAAM,SAAS,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YACvC,IAAI,EAAE,IAAI,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,GAAG,IAAI,EAAE,+BAA+B;YACjF,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,QAAQ,IAAI,SAAS;YACvC,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,GAAG,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC;YACxC,KAAK,EAAE;gBACL,KAAK,EAAE,KAAK,CAAC,KAAK;gBAClB,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,SAAS;gBACT,GAAG,KAAK,CAAC,QAAQ;gBACjB,SAAS,EAAE;oBACT,MAAM,EAAE,iBAAiB;iBAC1B;aACF;SACF,CAAC,CAAC,CAAC;QAEJ,kDAAkD;QAClD,MAAM,IAAI,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEhE,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;QAErE,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE;gBAC1C,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE;oBACP,cAAc,EAAE,kBAAkB;oBAClC,eAAe,EAAE,UAAU,IAAI,CAAC,KAAK,EAAE;iBACxC;gBACD,IAAI;gBACJ,MAAM,EAAE,UAAU,CAAC,MAAM;aAC1B,CAAC,CAAC;YAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;gBAC9D,MAAM,IAAI,KAAK,CACb,uBAAuB,QAAQ,CAAC,MAAM,KAAK,QAAQ,EAAE,CACtD,CAAC;YACJ,CAAC;QACH,CAAC;gBAAS,CAAC;YACT,YAAY,CAAC,OAAO,CAAC,CAAC;QACxB,CAAC;IACH,CAAC;CACF"}

package/dist/flash/adapters/stdout.d.ts

@@ -0,0 +1,25 @@
+/**
+ * StdOut Adapter — Simple JSON-line output to stdout.
+ *
+ * Default fallback adapter. Writes each log event as a single JSON line,
+ * making it compatible with container log aggregation (Docker, K8s).
+ */
+import type { SerializedLogEvent } from '../../core/log-event.js';
+import type { DownstreamAdapter } from './types.js';
+export interface StdOutAdapterOptions {
+    /** Use stderr instead of stdout. Default: false */
+    useStderr?: boolean;
+    /** Pretty-print JSON (useful for development). Default: false */
+    pretty?: boolean;
+    /** Optional prefix for each line (e.g., '[BufferLog]') */
+    prefix?: string;
+}
+export declare class StdOutAdapter implements DownstreamAdapter {
+    readonly name = "stdout";
+    private readonly stream;
+    private readonly pretty;
+    private readonly prefix;
+    constructor(options?: StdOutAdapterOptions);
+    send(events: SerializedLogEvent[], contextId: string): Promise<void>;
+}
+//# sourceMappingURL=stdout.d.ts.map

package/dist/flash/adapters/stdout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdout.d.ts","sourceRoot":"","sources":["../../../src/flash/adapters/stdout.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpD,MAAM,WAAW,oBAAoB;IACnC,mDAAmD;IACnD,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB,iEAAiE;IACjE,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB,0DAA0D;IAC1D,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,aAAc,YAAW,iBAAiB;IACrD,QAAQ,CAAC,IAAI,YAAY;IAEzB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAC5C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAU;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAEpB,OAAO,GAAE,oBAAyB;IAMxC,IAAI,CAAC,MAAM,EAAE,kBAAkB,EAAE,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAc3E"}

package/dist/flash/adapters/stdout.js

@@ -0,0 +1,29 @@
+/**
+ * StdOut Adapter — Simple JSON-line output to stdout.
+ *
+ * Default fallback adapter. Writes each log event as a single JSON line,
+ * making it compatible with container log aggregation (Docker, K8s).
+ */
+export class StdOutAdapter {
+    name = 'stdout';
+    stream;
+    pretty;
+    prefix;
+    constructor(options = {}) {
+        this.stream = options.useStderr ? process.stderr : process.stdout;
+        this.pretty = options.pretty ?? false;
+        this.prefix = options.prefix ?? '';
+    }
+    async send(events, contextId) {
+        const separator = `--- BufferLog Flush [${contextId}] (${events.length} events) ---`;
+        this.stream.write(this.prefix + separator + '\n');
+        for (const event of events) {
+            const line = this.pretty
+                ? JSON.stringify(event, null, 2)
+                : JSON.stringify(event);
+            this.stream.write(this.prefix + line + '\n');
+        }
+        this.stream.write(this.prefix + '--- End Flush ---\n');
+    }
+}
+//# sourceMappingURL=stdout.js.map

package/dist/flash/adapters/stdout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdout.js","sourceRoot":"","sources":["../../../src/flash/adapters/stdout.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAgBH,MAAM,OAAO,aAAa;IACf,IAAI,GAAG,QAAQ,CAAC;IAER,MAAM,CAAqB;IAC3B,MAAM,CAAU;IAChB,MAAM,CAAS;IAEhC,YAAY,UAAgC,EAAE;QAC5C,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;QAClE,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,KAAK,CAAC;QACtC,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC;IACrC,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,MAA4B,EAAE,SAAiB;QACxD,MAAM,SAAS,GAAG,wBAAwB,SAAS,MAAM,MAAM,CAAC,MAAM,cAAc,CAAC;QAErF,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,SAAS,GAAG,IAAI,CAAC,CAAC;QAElD,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM;gBACtB,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;gBAChC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;YAC1B,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC;QAC/C,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,qBAAqB,CAAC,CAAC;IACzD,CAAC;CACF"}

package/dist/flash/adapters/types.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Downstream Adapter Interface
+ *
+ * All adapters implement this interface to send flushed log events
+ * to an APM/aggregator (Datadog, Splunk, stdout, etc.).
+ *
+ * Adapters are called only on the error path (flush), never on the hot path.
+ */
+import type { SerializedLogEvent } from '../../core/log-event.js';
+/**
+ * A downstream target that receives flushed log events.
+ */
+export interface DownstreamAdapter {
+    /** Human-readable name for logging/debugging (e.g., 'datadog', 'splunk', 'stdout') */
+    readonly name: string;
+    /**
+     * Send a batch of serialized log events to the downstream target.
+     *
+     * @param events - Log events in chronological order (oldest first, error last)
+     * @param contextId - The request context ID for correlation
+     * @throws Should throw on unrecoverable errors (FlashController handles retries/fallbacks)
+     */
+    send(events: SerializedLogEvent[], contextId: string): Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/flash/adapters/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/flash/adapters/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAElE;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,sFAAsF;IACtF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;;;;;OAMG;IACH,IAAI,CAAC,MAAM,EAAE,kBAAkB,EAAE,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACtE"}

package/dist/flash/adapters/types.js

@@ -0,0 +1,10 @@
+/**
+ * Downstream Adapter Interface
+ *
+ * All adapters implement this interface to send flushed log events
+ * to an APM/aggregator (Datadog, Splunk, stdout, etc.).
+ *
+ * Adapters are called only on the error path (flush), never on the hot path.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/flash/adapters/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/flash/adapters/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}