@bufferlog/sdk-node 1.0.0

package/dist/flash/flash-controller.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Flash Controller — Orchestrates error-triggered log flushing.
+ *
+ * When an error condition is detected (ERROR log, HTTP 5xx, unhandled exception),
+ * the flash controller:
+ * 1. Drains the request's ring buffer
+ * 2. Appends the triggering error event
+ * 3. Serializes all events
+ * 4. Dispatches them to all configured downstream adapters
+ *
+ * Design notes:
+ * - Dispatch is non-blocking (uses setImmediate to avoid blocking the response)
+ * - Uses Promise.allSettled so one failing adapter doesn't block others
+ * - Fail-open: if all adapters fail, dumps to stderr as last resort
+ */
+import type { RequestContext } from '../context/async-context.js';
+import type { LogEvent } from '../core/log-event.js';
+import type { DownstreamAdapter } from './adapters/types.js';
+export interface FlashControllerOptions {
+    /** Downstream adapters to send flushed logs to */
+    adapters: readonly DownstreamAdapter[];
+    /** If true, dispatch asynchronously (don't block the request). Default: true */
+    async?: boolean;
+    /** If true, dump to stderr if all adapters fail. Default: true */
+    failOpen?: boolean;
+}
+export interface FlashResult {
+    /** Number of log events flushed (including the error event) */
+    eventCount: number;
+    /** Results from each adapter */
+    adapterResults: Array<{
+        adapter: string;
+        success: boolean;
+        error?: Error;
+    }>;
+}
+export declare class FlashController {
+    private readonly adapters;
+    private readonly asyncDispatch;
+    private readonly failOpen;
+    /** Metrics for telemetry */
+    private _flushCount;
+    private _eventsFlushed;
+    private _adapterErrors;
+    constructor(options: FlashControllerOptions);
+    /**
+     * Trigger a flush for the given request context.
+     *
+     * @param ctx The request context whose buffer should be flushed
+     * @param errorEvent The error log event that triggered the flush
+     */
+    trigger(ctx: RequestContext, errorEvent: LogEvent): void;
+    /**
+     * Trigger a flush with raw events (no RequestContext needed).
+     * Useful for manual flush scenarios.
+     */
+    triggerRaw(events: LogEvent[], contextId: string): void;
+    /**
+     * Dispatch serialized events to all configured adapters.
+     * Uses Promise.allSettled to ensure one failure doesn't block others.
+     */
+    private dispatch;
+    /**
+     * Last-resort fallback: dump logs to stderr so they're never truly lost.
+     */
+    private dumpToStderr;
+    /**
+     * Handle unexpected dispatch errors (shouldn't happen if adapters are well-behaved).
+     */
+    private handleDispatchFailure;
+    /** Total number of flushes triggered */
+    get flushCount(): number;
+    /** Total number of individual events flushed */
+    get eventsFlushed(): number;
+    /** Total adapter errors encountered */
+    get adapterErrors(): number;
+}
+//# sourceMappingURL=flash-controller.d.ts.map

package/dist/flash/flash-controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flash-controller.d.ts","sourceRoot":"","sources":["../../src/flash/flash-controller.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAErD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAE7D,MAAM,WAAW,sBAAsB;IACrC,kDAAkD;IAClD,QAAQ,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAEvC,gFAAgF;IAChF,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB,kEAAkE;IAClE,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,+DAA+D;IAC/D,UAAU,EAAE,MAAM,CAAC;IAEnB,gCAAgC;IAChC,cAAc,EAAE,KAAK,CAAC;QACpB,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,OAAO,CAAC;QACjB,KAAK,CAAC,EAAE,KAAK,CAAC;KACf,CAAC,CAAC;CACJ;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA+B;IACxD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAU;IACxC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAU;IAEnC,4BAA4B;IAC5B,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,cAAc,CAAK;gBAEf,OAAO,EAAE,sBAAsB;IAM3C;;;;;OAKG;IACH,OAAO,CAAC,GAAG,EAAE,cAAc,EAAE,UAAU,EAAE,QAAQ,GAAG,IAAI;IA0BxD;;;OAGG;IACH,UAAU,CAAC,MAAM,EAAE,QAAQ,EAAE,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAiBvD;;;OAGG;YACW,QAAQ;IAgDtB;;OAEG;IACH,OAAO,CAAC,YAAY;IAmBpB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAS7B,wCAAwC;IACxC,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED,gDAAgD;IAChD,IAAI,aAAa,IAAI,MAAM,CAE1B;IAED,uCAAuC;IACvC,IAAI,aAAa,IAAI,MAAM,CAE1B;CACF"}

package/dist/flash/flash-controller.js

@@ -0,0 +1,157 @@
+/**
+ * Flash Controller — Orchestrates error-triggered log flushing.
+ *
+ * When an error condition is detected (ERROR log, HTTP 5xx, unhandled exception),
+ * the flash controller:
+ * 1. Drains the request's ring buffer
+ * 2. Appends the triggering error event
+ * 3. Serializes all events
+ * 4. Dispatches them to all configured downstream adapters
+ *
+ * Design notes:
+ * - Dispatch is non-blocking (uses setImmediate to avoid blocking the response)
+ * - Uses Promise.allSettled so one failing adapter doesn't block others
+ * - Fail-open: if all adapters fail, dumps to stderr as last resort
+ */
+import { serializeLogEvent } from '../core/log-event.js';
+export class FlashController {
+    adapters;
+    asyncDispatch;
+    failOpen;
+    /** Metrics for telemetry */
+    _flushCount = 0;
+    _eventsFlushed = 0;
+    _adapterErrors = 0;
+    constructor(options) {
+        this.adapters = options.adapters;
+        this.asyncDispatch = options.async ?? true;
+        this.failOpen = options.failOpen ?? true;
+    }
+    /**
+     * Trigger a flush for the given request context.
+     *
+     * @param ctx The request context whose buffer should be flushed
+     * @param errorEvent The error log event that triggered the flush
+     */
+    trigger(ctx, errorEvent) {
+        // Drain the buffer — this removes all events from the ring buffer
+        const bufferedLogs = ctx.buffer.drain();
+        // Build the full payload: all buffered context + the triggering error
+        const payload = [...bufferedLogs, errorEvent];
+        this._flushCount++;
+        this._eventsFlushed += payload.length;
+        if (this.asyncDispatch) {
+            // Non-blocking: dispatch after the current tick completes
+            // This ensures the HTTP response isn't delayed by log shipping
+            setImmediate(() => {
+                this.dispatch(payload, ctx.contextId, ctx.tags).catch((err) => {
+                    this.handleDispatchFailure(err, payload);
+                });
+            });
+        }
+        else {
+            // Synchronous dispatch (useful for testing or critical-path logging)
+            this.dispatch(payload, ctx.contextId, ctx.tags).catch((err) => {
+                this.handleDispatchFailure(err, payload);
+            });
+        }
+    }
+    /**
+     * Trigger a flush with raw events (no RequestContext needed).
+     * Useful for manual flush scenarios.
+     */
+    triggerRaw(events, contextId) {
+        this._flushCount++;
+        this._eventsFlushed += events.length;
+        const dispatch = () => {
+            this.dispatch(events, contextId).catch((err) => {
+                this.handleDispatchFailure(err, events);
+            });
+        };
+        if (this.asyncDispatch) {
+            setImmediate(dispatch);
+        }
+        else {
+            dispatch();
+        }
+    }
+    /**
+     * Dispatch serialized events to all configured adapters.
+     * Uses Promise.allSettled to ensure one failure doesn't block others.
+     */
+    async dispatch(events, contextId, tags) {
+        const serialized = events.map(serializeLogEvent);
+        // Attach tags to each event if present
+        if (tags) {
+            for (const event of serialized) {
+                event.metadata = { ...event.metadata, ...tags };
+            }
+        }
+        const results = await Promise.allSettled(this.adapters.map((adapter) => adapter.send(serialized, contextId)));
+        const adapterResults = results.map((result, i) => {
+            const adapter = this.adapters[i];
+            if (result.status === 'fulfilled') {
+                return { adapter: adapter.name, success: true };
+            }
+            else {
+                this._adapterErrors++;
+                return {
+                    adapter: adapter.name,
+                    success: false,
+                    error: result.reason instanceof Error
+                        ? result.reason
+                        : new Error(String(result.reason)),
+                };
+            }
+        });
+        const flashResult = {
+            eventCount: events.length,
+            adapterResults,
+        };
+        // If ALL adapters failed and fail-open is enabled, dump to stderr
+        const allFailed = adapterResults.every((r) => !r.success);
+        if (allFailed && this.failOpen && this.adapters.length > 0) {
+            this.dumpToStderr(serialized, contextId, adapterResults);
+        }
+        return flashResult;
+    }
+    /**
+     * Last-resort fallback: dump logs to stderr so they're never truly lost.
+     */
+    dumpToStderr(events, contextId, failures) {
+        console.error(`[BufferLog] All adapters failed for context ${contextId}. ` +
+            `Dumping ${events.length} events to stderr.`);
+        for (const failure of failures) {
+            if (failure.error) {
+                console.error(`[BufferLog]   ${failure.adapter}: ${failure.error.message}`);
+            }
+        }
+        for (const event of events) {
+            console.error(JSON.stringify(event));
+        }
+    }
+    /**
+     * Handle unexpected dispatch errors (shouldn't happen if adapters are well-behaved).
+     */
+    handleDispatchFailure(err, events) {
+        console.error('[BufferLog] Flash dispatch encountered an unexpected error:', err);
+        if (this.failOpen) {
+            for (const event of events) {
+                console.error(JSON.stringify(serializeLogEvent(event)));
+            }
+        }
+    }
+    /** Total number of flushes triggered */
+    get flushCount() {
+        return this._flushCount;
+    }
+    /** Total number of individual events flushed */
+    get eventsFlushed() {
+        return this._eventsFlushed;
+    }
+    /** Total adapter errors encountered */
+    get adapterErrors() {
+        return this._adapterErrors;
+    }
+}
+//# sourceMappingURL=flash-controller.js.map

package/dist/flash/flash-controller.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,126 @@
+/**
+ * @bufferlog/sdk-node — Public API
+ *
+ * BufferLog.io Node.js SDK
+ * Buffer logs in memory per-request. Flush only on errors. Save 90%+ on APM costs.
+ *
+ * @example
+ * ```ts
+ * import { BufferLog } from '@bufferlog/sdk-node';
+ * import { StdOutAdapter } from '@bufferlog/sdk-node/adapters';
+ *
+ * const bufferlog = BufferLog.create({
+ *   bufferCapacity: 100,
+ *   adapters: [new StdOutAdapter({ pretty: true })],
+ * });
+ *
+ * // Express
+ * app.use(bufferlog.expressMiddleware());
+ *
+ * // Winston
+ * const logger = winston.createLogger({
+ *   transports: [bufferlog.winstonTransport()],
+ * });
+ * ```
+ */
+export { LogLevel, LOG_LEVEL_LABELS, LOG_LEVEL_FROM_STRING } from './core/log-event.js';
+export type { LogEvent, SerializedLogEvent } from './core/log-event.js';
+export { createLogEvent, serializeLogEvent } from './core/log-event.js';
+export { RingBuffer } from './core/ring-buffer.js';
+export { BufferManager } from './core/buffer-manager.js';
+export type { BufferManagerMetrics } from './core/buffer-manager.js';
+export { BufferLogContext } from './context/async-context.js';
+export type { RequestContext } from './context/async-context.js';
+export { resolveConfig } from './config.js';
+export type { BufferLogConfig, ResolvedConfig } from './config.js';
+export { FlashController } from './flash/flash-controller.js';
+export type { FlashControllerOptions, FlashResult } from './flash/flash-controller.js';
+export type { DownstreamAdapter } from './flash/adapters/types.js';
+export { StdOutAdapter } from './flash/adapters/stdout.js';
+export type { StdOutAdapterOptions } from './flash/adapters/stdout.js';
+export { DatadogAdapter } from './flash/adapters/datadog.js';
+export type { DatadogAdapterOptions } from './flash/adapters/datadog.js';
+export { SplunkAdapter } from './flash/adapters/splunk.js';
+export type { SplunkAdapterOptions } from './flash/adapters/splunk.js';
+export { BufferLogTransport } from './integrations/winston.js';
+export type { BufferLogTransportOptions } from './integrations/winston.js';
+export { createBufferLogDestination } from './integrations/pino.js';
+export type { BufferLogPinoOptions } from './integrations/pino.js';
+export { bufferLogMiddleware } from './middleware/express.js';
+export type { ExpressMiddlewareOptions } from './middleware/express.js';
+export { bufferLogPlugin } from './middleware/fastify.js';
+export type { FastifyPluginOptions } from './middleware/fastify.js';
+export { PolicyFetcher } from './control-plane/policy-fetcher.js';
+export type { PolicyFetcherOptions, RemotePolicy } from './control-plane/policy-fetcher.js';
+export { TelemetryReporter } from './control-plane/telemetry-reporter.js';
+export type { TelemetryReporterOptions } from './control-plane/telemetry-reporter.js';
+import { BufferManager } from './core/buffer-manager.js';
+import { FlashController } from './flash/flash-controller.js';
+import { BufferLogTransport } from './integrations/winston.js';
+import { PolicyFetcher } from './control-plane/policy-fetcher.js';
+import { TelemetryReporter } from './control-plane/telemetry-reporter.js';
+import type { BufferLogConfig, ResolvedConfig } from './config.js';
+import type { RequestHandler } from 'express';
+/**
+ * High-level BufferLog instance — the recommended way to use the SDK.
+ *
+ * Creates and wires together all components (BufferManager, FlashController, etc.)
+ * so you only need to call a few methods to integrate.
+ */
+export declare class BufferLog {
+    readonly config: ResolvedConfig;
+    readonly bufferManager: BufferManager;
+    readonly flashController: FlashController;
+    /** Policy fetcher — only present when controlPlane is configured */
+    readonly policyFetcher: PolicyFetcher | null;
+    /** Telemetry reporter — only present when controlPlane is configured */
+    readonly telemetryReporter: TelemetryReporter | null;
+    private constructor();
+    /**
+     * Create a new BufferLog instance with the given configuration.
+     */
+    static create(userConfig?: BufferLogConfig): BufferLog;
+    /**
+     * Get an Express middleware that wraps requests in a BufferLog context.
+     */
+    expressMiddleware(options?: Partial<import('./middleware/express.js').ExpressMiddlewareOptions>): RequestHandler;
+    /**
+     * Get a Fastify plugin that wraps requests in a BufferLog context.
+     */
+    fastifyPlugin(): import("fastify").FastifyPluginCallback<import("./middleware/fastify.js").FastifyPluginOptions>;
+    /**
+     * Get Fastify plugin options pre-configured with this instance.
+     */
+    fastifyPluginOptions(options?: Partial<import('./middleware/fastify.js').FastifyPluginOptions>): {
+        bufferManager: BufferManager;
+        flashController: FlashController;
+        config: ResolvedConfig;
+        contextIdGenerator?: (req: import("fastify").FastifyRequest) => string;
+        tagsExtractor?: (req: import("fastify").FastifyRequest) => Record<string, string>;
+    };
+    /**
+     * Create a Winston transport wired to this BufferLog instance.
+     */
+    winstonTransport(options?: Partial<import('./integrations/winston.js').BufferLogTransportOptions>): BufferLogTransport;
+    /**
+     * Create a Pino destination wired to this BufferLog instance.
+     */
+    pinoDestination(options?: Partial<import('./integrations/pino.js').BufferLogPinoOptions>): import("stream").Writable;
+    /**
+     * Get metrics from the buffer manager and flash controller.
+     */
+    getMetrics(): {
+        buffers: Readonly<import("./core/buffer-manager.js").BufferManagerMetrics>;
+        flash: {
+            flushCount: number;
+            eventsFlushed: number;
+            adapterErrors: number;
+        };
+    };
+    /**
+     * Gracefully shut down the SDK.
+     * Stops policy polling, sends a final telemetry report, and cleans up.
+     */
+    shutdown(): Promise<void>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,185 @@
+/**
+ * @bufferlog/sdk-node — Public API
+ *
+ * BufferLog.io Node.js SDK
+ * Buffer logs in memory per-request. Flush only on errors. Save 90%+ on APM costs.
+ *
+ * @example
+ * ```ts
+ * import { BufferLog } from '@bufferlog/sdk-node';
+ * import { StdOutAdapter } from '@bufferlog/sdk-node/adapters';
+ *
+ * const bufferlog = BufferLog.create({
+ *   bufferCapacity: 100,
+ *   adapters: [new StdOutAdapter({ pretty: true })],
+ * });
+ *
+ * // Express
+ * app.use(bufferlog.expressMiddleware());
+ *
+ * // Winston
+ * const logger = winston.createLogger({
+ *   transports: [bufferlog.winstonTransport()],
+ * });
+ * ```
+ */
+// Core
+export { LogLevel, LOG_LEVEL_LABELS, LOG_LEVEL_FROM_STRING } from './core/log-event.js';
+export { createLogEvent, serializeLogEvent } from './core/log-event.js';
+export { RingBuffer } from './core/ring-buffer.js';
+export { BufferManager } from './core/buffer-manager.js';
+// Context
+export { BufferLogContext } from './context/async-context.js';
+// Config
+export { resolveConfig } from './config.js';
+// Flash Controller
+export { FlashController } from './flash/flash-controller.js';
+export { StdOutAdapter } from './flash/adapters/stdout.js';
+export { DatadogAdapter } from './flash/adapters/datadog.js';
+export { SplunkAdapter } from './flash/adapters/splunk.js';
+// Integrations
+export { BufferLogTransport } from './integrations/winston.js';
+export { createBufferLogDestination } from './integrations/pino.js';
+// Middleware
+export { bufferLogMiddleware } from './middleware/express.js';
+export { bufferLogPlugin } from './middleware/fastify.js';
+// Control Plane
+export { PolicyFetcher } from './control-plane/policy-fetcher.js';
+export { TelemetryReporter } from './control-plane/telemetry-reporter.js';
+// ============================================================
+// High-Level API — Convenience wrapper for quick setup
+// ============================================================
+import { BufferManager } from './core/buffer-manager.js';
+import { FlashController } from './flash/flash-controller.js';
+import { StdOutAdapter } from './flash/adapters/stdout.js';
+import { resolveConfig } from './config.js';
+import { BufferLogTransport } from './integrations/winston.js';
+import { createBufferLogDestination } from './integrations/pino.js';
+import { bufferLogMiddleware } from './middleware/express.js';
+import { bufferLogPlugin } from './middleware/fastify.js';
+import { PolicyFetcher } from './control-plane/policy-fetcher.js';
+import { TelemetryReporter } from './control-plane/telemetry-reporter.js';
+/**
+ * High-level BufferLog instance — the recommended way to use the SDK.
+ *
+ * Creates and wires together all components (BufferManager, FlashController, etc.)
+ * so you only need to call a few methods to integrate.
+ */
+export class BufferLog {
+    config;
+    bufferManager;
+    flashController;
+    /** Policy fetcher — only present when controlPlane is configured */
+    policyFetcher = null;
+    /** Telemetry reporter — only present when controlPlane is configured */
+    telemetryReporter = null;
+    constructor(config) {
+        this.config = config;
+        this.bufferManager = new BufferManager(config.bufferCapacity);
+        // Ensure at least a stdout adapter exists
+        const adapters = config.adapters.length > 0
+            ? config.adapters
+            : [new StdOutAdapter({ pretty: true })];
+        this.flashController = new FlashController({
+            adapters,
+            failOpen: config.failOpen,
+        });
+        // Wire control plane modules if configured
+        if (config.controlPlane) {
+            this.policyFetcher = new PolicyFetcher({
+                controlPlaneUrl: config.controlPlane.url,
+                apiKey: config.controlPlane.apiKey,
+                intervalMs: config.controlPlane.pollIntervalMs,
+            });
+            this.telemetryReporter = new TelemetryReporter({
+                controlPlaneUrl: config.controlPlane.url,
+                apiKey: config.controlPlane.apiKey,
+                intervalMs: config.controlPlane.telemetryIntervalMs,
+                metricsProvider: () => this.getMetrics(),
+            });
+            this.policyFetcher.start();
+            this.telemetryReporter.start();
+        }
+    }
+    /**
+     * Create a new BufferLog instance with the given configuration.
+     */
+    static create(userConfig) {
+        const config = resolveConfig(userConfig);
+        return new BufferLog(config);
+    }
+    /**
+     * Get an Express middleware that wraps requests in a BufferLog context.
+     */
+    expressMiddleware(options) {
+        return bufferLogMiddleware({
+            bufferManager: this.bufferManager,
+            flashController: this.flashController,
+            config: this.config,
+            ...options,
+        });
+    }
+    /**
+     * Get a Fastify plugin that wraps requests in a BufferLog context.
+     */
+    fastifyPlugin() {
+        return bufferLogPlugin;
+    }
+    /**
+     * Get Fastify plugin options pre-configured with this instance.
+     */
+    fastifyPluginOptions(options) {
+        return {
+            bufferManager: this.bufferManager,
+            flashController: this.flashController,
+            config: this.config,
+            ...options,
+        };
+    }
+    /**
+     * Create a Winston transport wired to this BufferLog instance.
+     */
+    winstonTransport(options) {
+        return new BufferLogTransport({
+            flashController: this.flashController,
+            config: this.config,
+            ...options,
+        });
+    }
+    /**
+     * Create a Pino destination wired to this BufferLog instance.
+     */
+    pinoDestination(options) {
+        return createBufferLogDestination({
+            flashController: this.flashController,
+            ...options,
+        });
+    }
+    /**
+     * Get metrics from the buffer manager and flash controller.
+     */
+    getMetrics() {
+        return {
+            buffers: this.bufferManager.getMetrics(),
+            flash: {
+                flushCount: this.flashController.flushCount,
+                eventsFlushed: this.flashController.eventsFlushed,
+                adapterErrors: this.flashController.adapterErrors,
+            },
+        };
+    }
+    /**
+     * Gracefully shut down the SDK.
+     * Stops policy polling, sends a final telemetry report, and cleans up.
+     */
+    async shutdown() {
+        if (this.policyFetcher) {
+            this.policyFetcher.stop();
+        }
+        if (this.telemetryReporter) {
+            await this.telemetryReporter.send(); // Final report
+            this.telemetryReporter.stop();
+        }
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/integrations/pino.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Pino Integration — BufferLog Destination Wrapper
+ *
+ * Creates a Pino destination (writable stream) that intercepts log writes
+ * and routes them through BufferLog's buffer/flush pipeline.
+ *
+ * Usage:
+ * ```ts
+ * import pino from 'pino';
+ * import { createBufferLogDestination } from '@bufferlog/sdk-node/pino';
+ *
+ * const logger = pino(
+ *   { level: 'debug' },
+ *   createBufferLogDestination({ flashController, fallbackDestination: pino.destination(1) })
+ * );
+ * ```
+ */
+import { Writable } from 'node:stream';
+import type { FlashController } from '../flash/flash-controller.js';
+export interface BufferLogPinoOptions {
+    /** The flash controller to use for error-triggered flushes */
+    flashController: FlashController;
+    /** Fallback destination for logs outside a BufferLog context */
+    fallbackDestination?: NodeJS.WritableStream;
+    /** Pino numeric levels that trigger a flush. @default [50, 60] (error, fatal) */
+    flushOnLevels?: number[];
+    /** PII scrubber function */
+    scrubber?: (message: string, metadata?: Record<string, unknown>) => {
+        message: string;
+        metadata?: Record<string, unknown>;
+    };
+}
+/**
+ * Create a Pino-compatible destination stream that routes logs through BufferLog.
+ */
+export declare function createBufferLogDestination(options: BufferLogPinoOptions): Writable;
+//# sourceMappingURL=pino.d.ts.map

package/dist/integrations/pino.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pino.d.ts","sourceRoot":"","sources":["../../src/integrations/pino.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAGvC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAmBpE,MAAM,WAAW,oBAAoB;IACnC,8DAA8D;IAC9D,eAAe,EAAE,eAAe,CAAC;IAEjC,gEAAgE;IAChE,mBAAmB,CAAC,EAAE,MAAM,CAAC,cAAc,CAAC;IAE5C,iFAAiF;IACjF,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IAEzB,4BAA4B;IAC5B,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK;QAClE,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACpC,CAAC;CACH;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,oBAAoB,GAC5B,QAAQ,CAqDV"}