@bufferlog/sdk-node 1.0.0

package/dist/integrations/pino.js

@@ -0,0 +1,86 @@
+/**
+ * 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 { BufferLogContext } from '../context/async-context.js';
+import { LogLevel, createLogEvent } from '../core/log-event.js';
+/**
+ * Pino numeric levels (same convention: lower = more severe):
+ * { fatal: 60, error: 50, warn: 40, info: 30, debug: 20, trace: 10 }
+ *
+ * Map to BufferLog's LogLevel enum.
+ */
+const PINO_LEVEL_MAP = {
+    10: LogLevel.TRACE,
+    20: LogLevel.DEBUG,
+    30: LogLevel.INFO,
+    40: LogLevel.WARN,
+    50: LogLevel.ERROR,
+    60: LogLevel.FATAL,
+};
+const PINO_FLUSH_LEVELS = new Set([50, 60]); // error, fatal
+/**
+ * Create a Pino-compatible destination stream that routes logs through BufferLog.
+ */
+export function createBufferLogDestination(options) {
+    const flashController = options.flashController;
+    const fallback = options.fallbackDestination ?? process.stdout;
+    const flushLevels = new Set(options.flushOnLevels ?? PINO_FLUSH_LEVELS);
+    const scrubber = options.scrubber;
+    return new Writable({
+        write(chunk, _encoding, callback) {
+            try {
+                const raw = typeof chunk === 'string' ? chunk : chunk.toString();
+                // Pino writes newline-delimited JSON
+                const parsed = JSON.parse(raw);
+                const pinoLevel = parsed.level ?? 30;
+                const ctx = BufferLogContext.current();
+                // No active context → fail-open
+                if (!ctx) {
+                    fallback.write(chunk);
+                    callback();
+                    return;
+                }
+                // Extract fields
+                let message = parsed.msg ?? parsed.message ?? '';
+                const { level: _l, msg: _m, message: _msg, time: _t, pid: _p, hostname: _h, ...rest } = parsed;
+                let metadata = Object.keys(rest).length > 0 ? rest : undefined;
+                // Apply scrubber
+                if (scrubber) {
+                    const scrubbed = scrubber(message, metadata);
+                    message = scrubbed.message;
+                    metadata = scrubbed.metadata;
+                }
+                const bufferLogLevel = PINO_LEVEL_MAP[pinoLevel] ?? LogLevel.INFO;
+                const logEvent = createLogEvent(bufferLogLevel, message, ctx.contextId, metadata);
+                if (flushLevels.has(pinoLevel)) {
+                    flashController.trigger(ctx, logEvent);
+                }
+                else {
+                    ctx.buffer.push(logEvent);
+                }
+                callback();
+            }
+            catch (err) {
+                // Parse failure or unexpected error → fail-open
+                fallback.write(chunk);
+                callback();
+            }
+        },
+    });
+}
+//# sourceMappingURL=pino.js.map

package/dist/integrations/pino.js.map

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

package/dist/integrations/winston.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Winston Integration — Custom BufferLog Transport
+ *
+ * Intercepts all Winston log calls and routes them through BufferLog:
+ * - Levels below ERROR → pushed to the request's ring buffer (buffered)
+ * - ERROR and above → triggers the flash controller to flush the entire buffer
+ * - No active context → fail-open, forward to fallback transport
+ *
+ * Usage:
+ * ```ts
+ * import winston from 'winston';
+ * import { BufferLogTransport } from '@bufferlog/sdk-node/winston';
+ *
+ * const logger = winston.createLogger({
+ *   transports: [
+ *     new BufferLogTransport({
+ *       flashController,
+ *       fallbackTransport: new winston.transports.Console(),
+ *     }),
+ *   ],
+ * });
+ * ```
+ */
+import Transport from 'winston-transport';
+import type { FlashController } from '../flash/flash-controller.js';
+import type { ResolvedConfig } from '../config.js';
+export interface BufferLogTransportOptions extends Transport.TransportStreamOptions {
+    /** The flash controller to use for error-triggered flushes */
+    flashController: FlashController;
+    /** Fallback transport used when no BufferLog context is active */
+    fallbackTransport?: Transport;
+    /** Resolved BufferLog config. If not provided, defaults are used. */
+    config?: ResolvedConfig;
+    /** PII scrubber function */
+    scrubber?: (message: string, metadata?: Record<string, unknown>) => {
+        message: string;
+        metadata?: Record<string, unknown>;
+    };
+}
+export declare class BufferLogTransport extends Transport {
+    private readonly flashController;
+    private readonly fallbackTransport?;
+    private readonly scrubber?;
+    private readonly flushOnLevels;
+    private _buffered;
+    private _flushed;
+    private _passedThrough;
+    constructor(options: BufferLogTransportOptions);
+    /**
+     * Winston calls this for every log statement.
+     * This is the hot path — must be as fast as possible.
+     */
+    log(info: Record<string, unknown>, callback: () => void): void;
+    /** Number of log events buffered (success path) */
+    get bufferedCount(): number;
+    /** Number of flush triggers */
+    get flushedCount(): number;
+    /** Number of log events passed through (no context) */
+    get passedThroughCount(): number;
+}
+//# sourceMappingURL=winston.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"winston.d.ts","sourceRoot":"","sources":["../../src/integrations/winston.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,SAAS,MAAM,mBAAmB,CAAC;AAG1C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAkBnD,MAAM,WAAW,yBAA0B,SAAQ,SAAS,CAAC,sBAAsB;IACjF,8DAA8D;IAC9D,eAAe,EAAE,eAAe,CAAC;IAEjC,kEAAkE;IAClE,iBAAiB,CAAC,EAAE,SAAS,CAAC;IAE9B,qEAAqE;IACrE,MAAM,CAAC,EAAE,cAAc,CAAC;IAExB,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,qBAAa,kBAAmB,SAAQ,SAAS;IAC/C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAkB;IAClD,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAY;IAC/C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAwC;IAClE,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAsB;IAGpD,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,cAAc,CAAK;gBAEf,OAAO,EAAE,yBAAyB;IAQ9C;;;OAGG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI;IA0D9D,mDAAmD;IACnD,IAAI,aAAa,IAAI,MAAM,CAE1B;IAED,+BAA+B;IAC/B,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED,uDAAuD;IACvD,IAAI,kBAAkB,IAAI,MAAM,CAE/B;CACF"}

package/dist/integrations/winston.js

@@ -0,0 +1,120 @@
+/**
+ * Winston Integration — Custom BufferLog Transport
+ *
+ * Intercepts all Winston log calls and routes them through BufferLog:
+ * - Levels below ERROR → pushed to the request's ring buffer (buffered)
+ * - ERROR and above → triggers the flash controller to flush the entire buffer
+ * - No active context → fail-open, forward to fallback transport
+ *
+ * Usage:
+ * ```ts
+ * import winston from 'winston';
+ * import { BufferLogTransport } from '@bufferlog/sdk-node/winston';
+ *
+ * const logger = winston.createLogger({
+ *   transports: [
+ *     new BufferLogTransport({
+ *       flashController,
+ *       fallbackTransport: new winston.transports.Console(),
+ *     }),
+ *   ],
+ * });
+ * ```
+ */
+import Transport from 'winston-transport';
+import { BufferLogContext } from '../context/async-context.js';
+import { LogLevel, LOG_LEVEL_FROM_STRING, createLogEvent } from '../core/log-event.js';
+/**
+ * Winston uses its own numeric level system (lower = more severe):
+ * { error: 0, warn: 1, info: 2, http: 3, verbose: 4, debug: 5, silly: 6 }
+ *
+ * We map to BufferLog's LogLevel enum.
+ */
+const WINSTON_LEVEL_MAP = {
+    error: LogLevel.ERROR,
+    warn: LogLevel.WARN,
+    info: LogLevel.INFO,
+    http: LogLevel.INFO,
+    verbose: LogLevel.DEBUG,
+    debug: LogLevel.DEBUG,
+    silly: LogLevel.TRACE,
+};
+export class BufferLogTransport extends Transport {
+    flashController;
+    fallbackTransport;
+    scrubber;
+    flushOnLevels;
+    // Metrics
+    _buffered = 0;
+    _flushed = 0;
+    _passedThrough = 0;
+    constructor(options) {
+        super(options);
+        this.flashController = options.flashController;
+        this.fallbackTransport = options.fallbackTransport;
+        this.scrubber = options.scrubber ?? options.config?.scrubber;
+        this.flushOnLevels = options.config?.flushOnLevels ?? new Set(['error', 'fatal']);
+    }
+    /**
+     * Winston calls this for every log statement.
+     * This is the hot path — must be as fast as possible.
+     */
+    log(info, callback) {
+        // Extract Winston's level string
+        const winstonLevel = (info.level ?? '').toLowerCase();
+        // Remove ANSI color codes if present (Winston colorize format adds these)
+        const cleanLevel = winstonLevel.replace(/\u001b\[\d+m/g, '');
+        const ctx = BufferLogContext.current();
+        // --- No active context: fail-open ---
+        if (!ctx) {
+            this._passedThrough++;
+            if (this.fallbackTransport) {
+                this.fallbackTransport.log(info, callback);
+            }
+            else {
+                callback();
+            }
+            return;
+        }
+        // Map Winston level to BufferLog level
+        const bufferLogLevel = WINSTON_LEVEL_MAP[cleanLevel]
+            ?? LOG_LEVEL_FROM_STRING[cleanLevel]
+            ?? LogLevel.INFO;
+        // Extract message and metadata
+        let message = info.message ?? '';
+        const { level: _level, message: _msg, ...rest } = info;
+        let metadata = Object.keys(rest).length > 0 ? rest : undefined;
+        // Apply PII scrubber if configured
+        if (this.scrubber) {
+            const scrubbed = this.scrubber(message, metadata);
+            message = scrubbed.message;
+            metadata = scrubbed.metadata;
+        }
+        // Create the internal log event
+        const logEvent = createLogEvent(bufferLogLevel, message, ctx.contextId, metadata);
+        // --- Check if this level triggers a flush ---
+        if (this.flushOnLevels.has(cleanLevel)) {
+            this._flushed++;
+            this.flashController.trigger(ctx, logEvent);
+        }
+        else {
+            // Normal path: buffer it
+            this._buffered++;
+            ctx.buffer.push(logEvent);
+        }
+        callback();
+    }
+    /** Number of log events buffered (success path) */
+    get bufferedCount() {
+        return this._buffered;
+    }
+    /** Number of flush triggers */
+    get flushedCount() {
+        return this._flushed;
+    }
+    /** Number of log events passed through (no context) */
+    get passedThroughCount() {
+        return this._passedThrough;
+    }
+}
+//# sourceMappingURL=winston.js.map

package/dist/integrations/winston.js.map

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

package/dist/middleware/express.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Express Middleware — Wraps each request in a BufferLog context.
+ *
+ * Responsibilities:
+ * 1. Generate a unique context ID for each request
+ * 2. Create a ring buffer for the request
+ * 3. Run the request handler inside an AsyncLocalStorage scope
+ * 4. On response finish:
+ *    - If status >= 500 → flush the buffer (error path)
+ *    - Otherwise → discard the buffer (success path, saves money)
+ *
+ * Usage:
+ * ```ts
+ * import express from 'express';
+ * import { bufferLogMiddleware } from '@bufferlog/sdk-node/express';
+ *
+ * const app = express();
+ * app.use(bufferLogMiddleware({ bufferManager, flashController, config }));
+ * ```
+ */
+import type { Request, RequestHandler } from 'express';
+import type { BufferManager } from '../core/buffer-manager.js';
+import type { FlashController } from '../flash/flash-controller.js';
+import type { ResolvedConfig } from '../config.js';
+export interface ExpressMiddlewareOptions {
+    /** Buffer manager instance */
+    bufferManager: BufferManager;
+    /** Flash controller instance */
+    flashController: FlashController;
+    /** Resolved BufferLog configuration */
+    config: ResolvedConfig;
+    /**
+     * Custom context ID generator.
+     * Defaults to nanoid(). Override if you want to use trace IDs, request IDs, etc.
+     */
+    contextIdGenerator?: (req: Request) => string;
+    /**
+     * Custom tags extractor.
+     * Returns key-value pairs to attach to the request context (e.g., userId, route).
+     */
+    tagsExtractor?: (req: Request) => Record<string, string>;
+}
+/**
+ * Create Express middleware that wraps each request in a BufferLog context.
+ */
+export declare function bufferLogMiddleware(options: ExpressMiddlewareOptions): RequestHandler;
+//# sourceMappingURL=express.d.ts.map

package/dist/middleware/express.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"express.d.ts","sourceRoot":"","sources":["../../src/middleware/express.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAA0B,cAAc,EAAE,MAAM,SAAS,CAAC;AAG/E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAGnD,MAAM,WAAW,wBAAwB;IACvC,8BAA8B;IAC9B,aAAa,EAAE,aAAa,CAAC;IAE7B,gCAAgC;IAChC,eAAe,EAAE,eAAe,CAAC;IAEjC,uCAAuC;IACvC,MAAM,EAAE,cAAc,CAAC;IAEvB;;;OAGG;IACH,kBAAkB,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,MAAM,CAAC;IAE9C;;;OAGG;IACH,aAAa,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC1D;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,wBAAwB,GAAG,cAAc,CA8DrF"}

package/dist/middleware/express.js

@@ -0,0 +1,71 @@
+/**
+ * Express Middleware — Wraps each request in a BufferLog context.
+ *
+ * Responsibilities:
+ * 1. Generate a unique context ID for each request
+ * 2. Create a ring buffer for the request
+ * 3. Run the request handler inside an AsyncLocalStorage scope
+ * 4. On response finish:
+ *    - If status >= 500 → flush the buffer (error path)
+ *    - Otherwise → discard the buffer (success path, saves money)
+ *
+ * Usage:
+ * ```ts
+ * import express from 'express';
+ * import { bufferLogMiddleware } from '@bufferlog/sdk-node/express';
+ *
+ * const app = express();
+ * app.use(bufferLogMiddleware({ bufferManager, flashController, config }));
+ * ```
+ */
+import { nanoid } from 'nanoid';
+import { BufferLogContext } from '../context/async-context.js';
+import { LogLevel, createLogEvent } from '../core/log-event.js';
+/**
+ * Create Express middleware that wraps each request in a BufferLog context.
+ */
+export function bufferLogMiddleware(options) {
+    const { bufferManager, flashController, config, contextIdGenerator, tagsExtractor, } = options;
+    return (req, res, next) => {
+        // Skip if BufferLog is disabled
+        if (!config.enabled) {
+            next();
+            return;
+        }
+        const contextId = contextIdGenerator
+            ? contextIdGenerator(req)
+            : nanoid();
+        const buffer = bufferManager.createBuffer(contextId, config.bufferCapacity);
+        const tags = tagsExtractor ? tagsExtractor(req) : undefined;
+        // Run the rest of the middleware chain inside the BufferLog context
+        BufferLogContext.run(contextId, buffer, () => {
+            // Listen for response completion
+            res.on('finish', () => {
+                if (config.flushOnStatusCodes.has(res.statusCode)) {
+                    // Error path: create a synthetic error event with request context
+                    const errorEvent = createLogEvent(LogLevel.ERROR, `HTTP ${res.statusCode} ${req.method} ${req.originalUrl}`, contextId, {
+                        httpMethod: req.method,
+                        httpUrl: req.originalUrl,
+                        httpStatusCode: res.statusCode,
+                        ...(tags ?? {}),
+                    });
+                    flashController.trigger(BufferLogContext.current() ?? { contextId, buffer, startTime: Date.now() }, errorEvent);
+                    bufferManager.discardBuffer(contextId);
+                }
+                else {
+                    // Success path: discard the buffer (this is where we save money!)
+                    bufferManager.discardBuffer(contextId);
+                }
+            });
+            // Handle unexpected connection close (request aborted)
+            res.on('close', () => {
+                if (!res.writableFinished) {
+                    // Request was aborted before finishing — clean up the buffer
+                    bufferManager.discardBuffer(contextId);
+                }
+            });
+            next();
+        }, tags);
+    };
+}
+//# sourceMappingURL=express.js.map

package/dist/middleware/express.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"express.js","sourceRoot":"","sources":["../../src/middleware/express.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAGH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAI/D,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAyBhE;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAAiC;IACnE,MAAM,EACJ,aAAa,EACb,eAAe,EACf,MAAM,EACN,kBAAkB,EAClB,aAAa,GACd,GAAG,OAAO,CAAC;IAEZ,OAAO,CAAC,GAAY,EAAE,GAAa,EAAE,IAAkB,EAAQ,EAAE;QAC/D,gCAAgC;QAChC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,IAAI,EAAE,CAAC;YACP,OAAO;QACT,CAAC;QAED,MAAM,SAAS,GAAG,kBAAkB;YAClC,CAAC,CAAC,kBAAkB,CAAC,GAAG,CAAC;YACzB,CAAC,CAAC,MAAM,EAAE,CAAC;QAEb,MAAM,MAAM,GAAG,aAAa,CAAC,YAAY,CAAC,SAAS,EAAE,MAAM,CAAC,cAAc,CAAC,CAAC;QAC5E,MAAM,IAAI,GAAG,aAAa,CAAC,CAAC,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAE5D,oEAAoE;QACpE,gBAAgB,CAAC,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE;YAC3C,iCAAiC;YACjC,GAAG,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE;gBACpB,IAAI,MAAM,CAAC,kBAAkB,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;oBAClD,kEAAkE;oBAClE,MAAM,UAAU,GAAG,cAAc,CAC/B,QAAQ,CAAC,KAAK,EACd,QAAQ,GAAG,CAAC,UAAU,IAAI,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,WAAW,EAAE,EACzD,SAAS,EACT;wBACE,UAAU,EAAE,GAAG,CAAC,MAAM;wBACtB,OAAO,EAAE,GAAG,CAAC,WAAW;wBACxB,cAAc,EAAE,GAAG,CAAC,UAAU;wBAC9B,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC;qBAChB,CACF,CAAC;oBACF,eAAe,CAAC,OAAO,CACrB,gBAAgB,CAAC,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,EAC1E,UAAU,CACX,CAAC;oBACF,aAAa,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC;gBACzC,CAAC;qBAAM,CAAC;oBACN,kEAAkE;oBAClE,aAAa,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC;gBACzC,CAAC;YACH,CAAC,CAAC,CAAC;YAEH,uDAAuD;YACvD,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;gBACnB,IAAI,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;oBAC1B,6DAA6D;oBAC7D,aAAa,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC;gBACzC,CAAC;YACH,CAAC,CAAC,CAAC;YAEH,IAAI,EAAE,CAAC;QACT,CAAC,EAAE,IAAI,CAAC,CAAC;IACX,CAAC,CAAC;AACJ,CAAC"}

package/dist/middleware/fastify.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Fastify Plugin — Wraps each request in a BufferLog context.
+ *
+ * Uses Fastify's hook system instead of Express-style middleware.
+ * Hooks into `onRequest` (start context), `onResponse` (discard/flush), and
+ * `onError` (trigger flush on unhandled errors).
+ *
+ * Usage:
+ * ```ts
+ * import Fastify from 'fastify';
+ * import { bufferLogPlugin } from '@bufferlog/sdk-node/fastify';
+ *
+ * const app = Fastify();
+ * app.register(bufferLogPlugin, { bufferManager, flashController, config });
+ * ```
+ */
+import type { FastifyRequest, FastifyPluginCallback } from 'fastify';
+import type { BufferManager } from '../core/buffer-manager.js';
+import type { FlashController } from '../flash/flash-controller.js';
+import type { ResolvedConfig } from '../config.js';
+export interface FastifyPluginOptions {
+    bufferManager: BufferManager;
+    flashController: FlashController;
+    config: ResolvedConfig;
+    contextIdGenerator?: (req: FastifyRequest) => string;
+    tagsExtractor?: (req: FastifyRequest) => Record<string, string>;
+}
+/**
+ * Fastify plugin that wraps each request in a BufferLog context.
+ */
+export declare const bufferLogPlugin: FastifyPluginCallback<FastifyPluginOptions>;
+//# sourceMappingURL=fastify.d.ts.map

package/dist/middleware/fastify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fastify.d.ts","sourceRoot":"","sources":["../../src/middleware/fastify.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAmB,cAAc,EAAgB,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAGpG,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAGnD,MAAM,WAAW,oBAAoB;IACnC,aAAa,EAAE,aAAa,CAAC;IAC7B,eAAe,EAAE,eAAe,CAAC;IACjC,MAAM,EAAE,cAAc,CAAC;IACvB,kBAAkB,CAAC,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK,MAAM,CAAC;IACrD,aAAa,CAAC,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjE;AAED;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,qBAAqB,CAAC,oBAAoB,CAwGvE,CAAC"}

package/dist/middleware/fastify.js

@@ -0,0 +1,91 @@
+/**
+ * Fastify Plugin — Wraps each request in a BufferLog context.
+ *
+ * Uses Fastify's hook system instead of Express-style middleware.
+ * Hooks into `onRequest` (start context), `onResponse` (discard/flush), and
+ * `onError` (trigger flush on unhandled errors).
+ *
+ * Usage:
+ * ```ts
+ * import Fastify from 'fastify';
+ * import { bufferLogPlugin } from '@bufferlog/sdk-node/fastify';
+ *
+ * const app = Fastify();
+ * app.register(bufferLogPlugin, { bufferManager, flashController, config });
+ * ```
+ */
+import { nanoid } from 'nanoid';
+import { BufferLogContext } from '../context/async-context.js';
+import { LogLevel, createLogEvent } from '../core/log-event.js';
+/**
+ * Fastify plugin that wraps each request in a BufferLog context.
+ */
+export const bufferLogPlugin = (fastify, options, done) => {
+    const { bufferManager, flashController, config, contextIdGenerator, tagsExtractor, } = options;
+    // Use Fastify's `onRequest` hook to start the BufferLog context
+    fastify.addHook('onRequest', (request, _reply, hookDone) => {
+        if (!config.enabled) {
+            hookDone();
+            return;
+        }
+        const contextId = contextIdGenerator
+            ? contextIdGenerator(request)
+            : nanoid();
+        const buffer = bufferManager.createBuffer(contextId, config.bufferCapacity);
+        const tags = tagsExtractor ? tagsExtractor(request) : undefined;
+        // Store contextId on the request for later hooks
+        request.__bufferlog_ctx_id = contextId;
+        request.__bufferlog_tags = tags;
+        // Run subsequent hooks within the BufferLog context
+        BufferLogContext.run(contextId, buffer, () => {
+            hookDone();
+        }, tags);
+    });
+    // Use `onResponse` to handle the success/error path
+    fastify.addHook('onResponse', (request, reply, hookDone) => {
+        const contextId = request.__bufferlog_ctx_id;
+        if (!contextId) {
+            hookDone();
+            return;
+        }
+        if (config.flushOnStatusCodes.has(reply.statusCode)) {
+            const tags = request.__bufferlog_tags;
+            const buffer = bufferManager.getBuffer(contextId);
+            if (buffer) {
+                const errorEvent = createLogEvent(LogLevel.ERROR, `HTTP ${reply.statusCode} ${request.method} ${request.url}`, contextId, {
+                    httpMethod: request.method,
+                    httpUrl: request.url,
+                    httpStatusCode: reply.statusCode,
+                    ...(tags ?? {}),
+                });
+                flashController.trigger({ contextId, buffer, startTime: Date.now(), tags }, errorEvent);
+            }
+            bufferManager.discardBuffer(contextId);
+        }
+        else {
+            bufferManager.discardBuffer(contextId);
+        }
+        hookDone();
+    });
+    // Use `onError` to flush on unhandled exceptions
+    fastify.addHook('onError', (request, _reply, error, hookDone) => {
+        const contextId = request.__bufferlog_ctx_id;
+        if (!contextId) {
+            hookDone();
+            return;
+        }
+        const tags = request.__bufferlog_tags;
+        const buffer = bufferManager.getBuffer(contextId);
+        if (buffer) {
+            const errorEvent = createLogEvent(LogLevel.ERROR, `Unhandled error: ${error.message}`, contextId, {
+                errorName: error.name,
+                errorStack: error.stack,
+                ...(tags ?? {}),
+            });
+            flashController.trigger({ contextId, buffer, startTime: Date.now(), tags }, errorEvent);
+        }
+        hookDone();
+    });
+    done();
+};
+//# sourceMappingURL=fastify.js.map

package/dist/middleware/fastify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fastify.js","sourceRoot":"","sources":["../../src/middleware/fastify.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAI/D,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAUhE;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAgD,CAC1E,OAAwB,EACxB,OAA6B,EAC7B,IAA2B,EAC3B,EAAE;IACF,MAAM,EACJ,aAAa,EACb,eAAe,EACf,MAAM,EACN,kBAAkB,EAClB,aAAa,GACd,GAAG,OAAO,CAAC;IAEZ,gEAAgE;IAChE,OAAO,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,OAAuB,EAAE,MAAoB,EAAE,QAAQ,EAAE,EAAE;QACvF,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,QAAQ,EAAE,CAAC;YACX,OAAO;QACT,CAAC;QAED,MAAM,SAAS,GAAG,kBAAkB;YAClC,CAAC,CAAC,kBAAkB,CAAC,OAAO,CAAC;YAC7B,CAAC,CAAC,MAAM,EAAE,CAAC;QAEb,MAAM,MAAM,GAAG,aAAa,CAAC,YAAY,CAAC,SAAS,EAAE,MAAM,CAAC,cAAc,CAAC,CAAC;QAC5E,MAAM,IAAI,GAAG,aAAa,CAAC,CAAC,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAEhE,iDAAiD;QAChD,OAA8C,CAAC,kBAAkB,GAAG,SAAS,CAAC;QAC9E,OAA8C,CAAC,gBAAgB,GAAG,IAAI,CAAC;QAExE,oDAAoD;QACpD,gBAAgB,CAAC,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE;YAC3C,QAAQ,EAAE,CAAC;QACb,CAAC,EAAE,IAAI,CAAC,CAAC;IACX,CAAC,CAAC,CAAC;IAEH,oDAAoD;IACpD,OAAO,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC,OAAuB,EAAE,KAAmB,EAAE,QAAQ,EAAE,EAAE;QACvF,MAAM,SAAS,GAAI,OAA8C,CAAC,kBAAwC,CAAC;QAC3G,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,QAAQ,EAAE,CAAC;YACX,OAAO;QACT,CAAC;QAED,IAAI,MAAM,CAAC,kBAAkB,CAAC,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,CAAC;YACpD,MAAM,IAAI,GAAI,OAA8C,CAAC,gBAAsD,CAAC;YACpH,MAAM,MAAM,GAAG,aAAa,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;YAClD,IAAI,MAAM,EAAE,CAAC;gBACX,MAAM,UAAU,GAAG,cAAc,CAC/B,QAAQ,CAAC,KAAK,EACd,QAAQ,KAAK,CAAC,UAAU,IAAI,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,GAAG,EAAE,EAC3D,SAAS,EACT;oBACE,UAAU,EAAE,OAAO,CAAC,MAAM;oBAC1B,OAAO,EAAE,OAAO,CAAC,GAAG;oBACpB,cAAc,EAAE,KAAK,CAAC,UAAU;oBAChC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC;iBAChB,CACF,CAAC;gBACF,eAAe,CAAC,OAAO,CACrB,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,EAClD,UAAU,CACX,CAAC;YACJ,CAAC;YACD,aAAa,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC;QACzC,CAAC;aAAM,CAAC;YACN,aAAa,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC;QACzC,CAAC;QAED,QAAQ,EAAE,CAAC;IACb,CAAC,CAAC,CAAC;IAEH,iDAAiD;IACjD,OAAO,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC,OAAuB,EAAE,MAAoB,EAAE,KAAY,EAAE,QAAQ,EAAE,EAAE;QACnG,MAAM,SAAS,GAAI,OAA8C,CAAC,kBAAwC,CAAC;QAC3G,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,QAAQ,EAAE,CAAC;YACX,OAAO;QACT,CAAC;QAED,MAAM,IAAI,GAAI,OAA8C,CAAC,gBAAsD,CAAC;QACpH,MAAM,MAAM,GAAG,aAAa,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;QAClD,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,UAAU,GAAG,cAAc,CAC/B,QAAQ,CAAC,KAAK,EACd,oBAAoB,KAAK,CAAC,OAAO,EAAE,EACnC,SAAS,EACT;gBACE,SAAS,EAAE,KAAK,CAAC,IAAI;gBACrB,UAAU,EAAE,KAAK,CAAC,KAAK;gBACvB,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC;aAChB,CACF,CAAC;YACF,eAAe,CAAC,OAAO,CACrB,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,EAClD,UAAU,CACX,CAAC;QACJ,CAAC;QAED,QAAQ,EAAE,CAAC;IACb,CAAC,CAAC,CAAC;IAEH,IAAI,EAAE,CAAC;AACT,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,82 @@
+{
+  "name": "@bufferlog/sdk-node",
+  "version": "1.0.0",
+  "description": "BufferLog.io Node.js SDK — Buffer logs in memory, flush only on errors",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./winston": {
+      "import": "./dist/integrations/winston.js",
+      "types": "./dist/integrations/winston.d.ts"
+    },
+    "./pino": {
+      "import": "./dist/integrations/pino.js",
+      "types": "./dist/integrations/pino.d.ts"
+    },
+    "./express": {
+      "import": "./dist/middleware/express.js",
+      "types": "./dist/middleware/express.d.ts"
+    },
+    "./fastify": {
+      "import": "./dist/middleware/fastify.js",
+      "types": "./dist/middleware/fastify.d.ts"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "bench": "tsx benchmarks/ring-buffer.bench.ts",
+    "prepublishOnly": "npm run build"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/lehan0328/bufferlog.git",
+    "directory": "packages/sdk-node"
+  },
+  "homepage": "https://github.com/lehan0328/bufferlog/tree/main/packages/sdk-node#readme",
+  "bugs": {
+    "url": "https://github.com/lehan0328/bufferlog/issues"
+  },
+  "keywords": ["logging", "apm", "buffer", "datadog", "splunk", "observability", "cost-reduction"],
+  "license": "MIT",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "nanoid": "^5.0.9"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "@types/express": "^5.0.0",
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0",
+    "tsx": "^4.19.0",
+    "winston": "^3.17.0",
+    "pino": "^9.6.0",
+    "express": "^4.21.0",
+    "fastify": "^5.2.0"
+  },
+  "peerDependencies": {
+    "winston": "^3.0.0",
+    "pino": "^8.0.0 || ^9.0.0",
+    "express": "^4.0.0 || ^5.0.0",
+    "fastify": "^4.0.0 || ^5.0.0"
+  },
+  "peerDependenciesMeta": {
+    "winston": { "optional": true },
+    "pino": { "optional": true },
+    "express": { "optional": true },
+    "fastify": { "optional": true }
+  }
+}