@backendkit-labs/observability 0.1.0

package/dist/index.js

@@ -0,0 +1,562 @@
+import { Injectable, Inject, Optional, Catch, Module, Logger, HttpException, HttpStatus } from '@nestjs/common';
+import { AsyncLocalStorage } from 'async_hooks';
+import { randomUUID } from 'crypto';
+import * as winston from 'winston';
+import TransportStream from 'winston-transport';
+import axios from 'axios';
+import * as http from 'http';
+import * as https from 'https';
+import { CircuitBreaker, CircuitBreakerState, CircuitBreakerOpenError } from '@backendkit-labs/circuit-breaker';
+import { Observable } from 'rxjs';
+import { tap } from 'rxjs/operators';
+
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
+  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
+}) : x)(function(x) {
+  if (typeof require !== "undefined") return require.apply(this, arguments);
+  throw Error('Dynamic require of "' + x + '" is not supported');
+});
+var __decorateClass = (decorators, target, key, kind) => {
+  var result = kind > 1 ? void 0 : kind ? __getOwnPropDesc(target, key) : target;
+  for (var i = decorators.length - 1, decorator; i >= 0; i--)
+    if (decorator = decorators[i])
+      result = (decorator(result)) || result;
+  return result;
+};
+var __decorateParam = (index, decorator) => (target, key) => decorator(target, key, index);
+
+// src/internal/otel.ts
+var otel = null;
+try {
+  otel = __require("@opentelemetry/api");
+} catch {
+}
+var getTracer = (name) => otel?.trace?.getTracer(name) ?? noopTracer;
+var getActiveSpan = () => otel ? otel.trace.getSpan(otel.context.active()) : void 0;
+var runInOtelContext = async (span, fn) => {
+  if (!otel || !span) return fn();
+  return otel.context.with(otel.trace.setSpan(otel.context.active(), span), fn);
+};
+var noopSpan = {
+  end: () => {
+  },
+  setAttribute: () => {
+  },
+  setAttributes: () => {
+  },
+  recordException: () => {
+  },
+  setStatus: () => {
+  },
+  spanContext: () => ({ traceId: "", spanId: "" })
+};
+var noopTracer = {
+  startSpan: () => noopSpan,
+  startActiveSpan: (_name, fn) => fn(noopSpan)
+};
+
+// src/correlation/correlation.service.ts
+var storage = new AsyncLocalStorage();
+var CorrelationIdService = class {
+  /**
+   * Run `fn` inside a context that carries `correlationId`.
+   * All code executed within `fn` (including async continuations) can call
+   * `get()` and receive the same ID without passing it explicitly.
+   */
+  run(correlationId, fn) {
+    return storage.run(correlationId, fn);
+  }
+  /** Current correlation ID, or a fresh UUID when called outside a context. */
+  get() {
+    return storage.getStore() ?? randomUUID();
+  }
+  /**
+   * Current correlation ID, or `undefined` when called outside a context.
+   * Prefer `get()` for logging; use this only when you need to distinguish
+   * "no context" from "context with a random ID".
+   */
+  getOrUndefined() {
+    return storage.getStore();
+  }
+  /**
+   * Active OTel trace + span IDs when @opentelemetry/api is installed and a
+   * span is active; `undefined` otherwise.
+   */
+  getTraceContext() {
+    const span = getActiveSpan();
+    if (!span) return void 0;
+    const ctx = span.spanContext?.();
+    if (!ctx?.traceId) return void 0;
+    return { traceId: ctx.traceId, spanId: ctx.spanId };
+  }
+};
+CorrelationIdService = __decorateClass([
+  Injectable()
+], CorrelationIdService);
+
+// src/observability.constants.ts
+var OBSERVABILITY_OPTIONS = "OBSERVABILITY_OPTIONS";
+var TRANSPORT_CB_DEFAULTS = {
+  failureThreshold: 60,
+  slowCallThreshold: 100,
+  slowCallDurationMs: 6e4,
+  minimumCalls: 3,
+  slidingWindowSize: 5,
+  halfOpenMaxCalls: 1,
+  openTimeoutMs: 3e4
+};
+var WinstonHttpTransport = class extends TransportStream {
+  client;
+  cb;
+  buffer = [];
+  batchSize;
+  maxBufferSize;
+  flushTimer;
+  constructor(opts) {
+    super(opts);
+    this.batchSize = opts.batchSize ?? 100;
+    this.maxBufferSize = opts.maxBufferSize ?? 2e3;
+    const keepAlive = new http.Agent({ keepAlive: true });
+    const keepAliveHttps = new https.Agent({ keepAlive: true });
+    this.client = axios.create({
+      baseURL: opts.url,
+      timeout: opts.timeoutMs ?? 5e3,
+      httpAgent: keepAlive,
+      httpsAgent: keepAliveHttps,
+      headers: {
+        "Content-Type": "application/json",
+        ...opts.authToken ? { Authorization: `Bearer ${opts.authToken}` } : {},
+        ...opts.headers
+      }
+    });
+    this.cb = new CircuitBreaker({
+      ...TRANSPORT_CB_DEFAULTS,
+      ...opts.circuitBreaker,
+      name: "WinstonHttpTransport",
+      isFailure: () => true
+    });
+    this.flushTimer = setInterval(
+      () => {
+        void this.flush();
+      },
+      opts.flushIntervalMs ?? 5e3
+    );
+    this.flushTimer.unref?.();
+  }
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  log(info, callback) {
+    setImmediate(() => this.emit("logged", info));
+    if (this.buffer.length < this.maxBufferSize) {
+      this.buffer.push(info);
+    }
+    if (this.buffer.length >= this.batchSize) {
+      void this.flush();
+    }
+    callback();
+  }
+  /** Flush remaining buffer on graceful shutdown. */
+  async close() {
+    clearInterval(this.flushTimer);
+    await this.flush();
+  }
+  async flush() {
+    if (this.buffer.length === 0) return;
+    const batch = this.buffer.splice(0, this.batchSize);
+    try {
+      await this.cb.execute(() => this.client.post("", batch));
+    } catch (err) {
+      const room = this.maxBufferSize - this.buffer.length;
+      if (room > 0) this.buffer.unshift(...batch.slice(0, room));
+      if (!(err instanceof CircuitBreakerOpenError)) {
+        console.error(`[WinstonHttpTransport] flush failed \u2014 re-queued ${batch.length} entries`, err);
+      }
+    }
+  }
+};
+
+// src/logger/logger.service.ts
+var LoggerService = class {
+  constructor(opts, correlationSvc) {
+    this.opts = opts;
+    this.correlationSvc = correlationSvc;
+    const transports2 = [
+      new winston.transports.Console({
+        format: winston.format.combine(
+          winston.format.timestamp(),
+          winston.format.colorize(),
+          winston.format.printf(({ level, message, timestamp, ...meta }) => {
+            const extra = Object.keys(meta).length ? ` ${JSON.stringify(meta)}` : "";
+            return `${timestamp} [${level}] ${message}${extra}`;
+          })
+        )
+      })
+    ];
+    if (opts.http) {
+      transports2.push(
+        new WinstonHttpTransport({
+          ...opts.http,
+          format: winston.format.json()
+        })
+      );
+    }
+    this.winston = winston.createLogger({
+      level: opts.logLevel ?? "info",
+      transports: transports2,
+      format: winston.format.json()
+    });
+  }
+  opts;
+  correlationSvc;
+  winston;
+  log(message, context) {
+    this.winston.info(message, this.buildMeta(context));
+  }
+  error(message, trace, context) {
+    this.winston.error(message, { ...this.buildMeta(context), trace });
+  }
+  warn(message, context) {
+    this.winston.warn(message, this.buildMeta(context));
+  }
+  debug(message, context) {
+    this.winston.debug(message, this.buildMeta(context));
+  }
+  verbose(message, context) {
+    this.winston.verbose(message, this.buildMeta(context));
+  }
+  /** Log with additional arbitrary metadata. */
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  logWithMeta(level, message, meta) {
+    this.winston.log(level, message, { ...this.buildMeta(), ...meta });
+  }
+  buildMeta(context) {
+    const base = {
+      service: this.opts.serviceName,
+      environment: this.opts.environment ?? "production",
+      correlationId: this.correlationSvc?.get()
+    };
+    if (context) base.context = context;
+    return base;
+  }
+};
+LoggerService = __decorateClass([
+  Injectable(),
+  __decorateParam(0, Inject(OBSERVABILITY_OPTIONS)),
+  __decorateParam(1, Optional())
+], LoggerService);
+var TRANSPORT_CB_DEFAULTS2 = {
+  failureThreshold: 60,
+  slowCallThreshold: 100,
+  slowCallDurationMs: 6e4,
+  minimumCalls: 3,
+  slidingWindowSize: 5,
+  halfOpenMaxCalls: 1,
+  openTimeoutMs: 3e4
+};
+var MetricsService = class {
+  constructor(opts, correlationSvc) {
+    this.opts = opts;
+    this.correlationSvc = correlationSvc;
+    if (!opts.metrics) return;
+    const m = opts.metrics;
+    this.maxBufferSize = m.maxBufferSize ?? 5e3;
+    const keepAlive = new http.Agent({ keepAlive: true });
+    const keepAliveHttps = new https.Agent({ keepAlive: true });
+    this.client = axios.create({
+      baseURL: m.url,
+      timeout: m.timeoutMs ?? 5e3,
+      httpAgent: keepAlive,
+      httpsAgent: keepAliveHttps,
+      headers: {
+        "Content-Type": "application/json",
+        ...m.authToken ? { Authorization: `Bearer ${m.authToken}` } : {},
+        ...m.headers
+      }
+    });
+    this.cb = new CircuitBreaker({
+      ...TRANSPORT_CB_DEFAULTS2,
+      ...m.circuitBreaker,
+      name: "MetricsService",
+      isFailure: () => true,
+      onStateChange: (from, to, metrics) => {
+        if (to === CircuitBreakerState.OPEN) {
+          this.logger.warn(
+            `[MetricsService] circuit breaker OPEN \u2014 pausing metric sends for ${(m.circuitBreaker?.openTimeoutMs ?? TRANSPORT_CB_DEFAULTS2.openTimeoutMs) / 1e3}s`,
+            metrics
+          );
+        } else if (to === CircuitBreakerState.CLOSED && from !== CircuitBreakerState.HALF_OPEN) {
+          this.logger.log(`[MetricsService] circuit breaker CLOSED \u2014 recovered`);
+        }
+        m.circuitBreaker?.onStateChange?.(from, to, metrics);
+      }
+    });
+    this.flushTimer = setInterval(
+      () => {
+        void this.flush();
+      },
+      m.flushIntervalMs ?? 1e4
+    );
+    this.flushTimer.unref?.();
+  }
+  opts;
+  correlationSvc;
+  client = null;
+  cb = null;
+  logger = new Logger(MetricsService.name);
+  buffer = [];
+  maxBufferSize = 5e3;
+  flushTimer = null;
+  /**
+   * Enqueue a metric event. Fire-and-forget; batched and sent on the next
+   * flush interval or when the buffer reaches `maxBufferSize`.
+   */
+  record(name, value, options) {
+    if (!this.client) return;
+    if (this.buffer.length >= this.maxBufferSize) {
+      this.logger.warn("[MetricsService] buffer full \u2014 dropping metric");
+      return;
+    }
+    this.buffer.push({
+      name,
+      value,
+      unit: options?.unit,
+      tags: options?.tags,
+      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+      serviceName: this.opts.serviceName,
+      environment: this.opts.environment ?? "production",
+      correlationId: this.correlationSvc?.getOrUndefined()
+    });
+  }
+  /** Flush on graceful shutdown. */
+  async onModuleDestroy() {
+    if (this.flushTimer) clearInterval(this.flushTimer);
+    await this.flush();
+  }
+  async flush() {
+    if (!this.client || this.buffer.length === 0) return;
+    const batch = this.buffer.splice(0, 500);
+    try {
+      await this.cb.execute(() => this.client.post("", batch));
+    } catch (err) {
+      const room = this.maxBufferSize - this.buffer.length;
+      if (room > 0) this.buffer.unshift(...batch.slice(0, room));
+      if (!(err instanceof CircuitBreakerOpenError)) {
+        this.logger.warn(
+          `[MetricsService] flush failed \u2014 re-queueing ${batch.length} events`,
+          err
+        );
+      }
+    }
+  }
+};
+MetricsService = __decorateClass([
+  Injectable(),
+  __decorateParam(0, Inject(OBSERVABILITY_OPTIONS)),
+  __decorateParam(1, Optional())
+], MetricsService);
+var CORRELATION_HEADER = "x-correlation-id";
+var CorrelationInterceptor = class {
+  constructor(correlationSvc) {
+    this.correlationSvc = correlationSvc;
+  }
+  correlationSvc;
+  intercept(ctx, next) {
+    const req = ctx.switchToHttp().getRequest();
+    const res = ctx.switchToHttp().getResponse();
+    const incomingId = req.headers?.[CORRELATION_HEADER];
+    const correlationId = typeof incomingId === "string" && incomingId ? incomingId : randomUUID();
+    res.setHeader(CORRELATION_HEADER, correlationId);
+    return new Observable((subscriber) => {
+      this.correlationSvc.run(correlationId, () => {
+        next.handle().pipe(
+          tap({ error: () => {
+          } })
+        ).subscribe(subscriber);
+      });
+    });
+  }
+};
+CorrelationInterceptor = __decorateClass([
+  Injectable(),
+  __decorateParam(0, Inject(CorrelationIdService))
+], CorrelationInterceptor);
+var PerformanceInterceptor = class {
+  constructor(logger, metrics, correlationSvc) {
+    this.logger = logger;
+    this.metrics = metrics;
+    this.correlationSvc = correlationSvc;
+  }
+  logger;
+  metrics;
+  correlationSvc;
+  intercept(ctx, next) {
+    const start = Date.now();
+    const req = ctx.switchToHttp().getRequest();
+    const method = req.method ?? "UNKNOWN";
+    const path = req.url ?? "UNKNOWN";
+    return next.handle().pipe(
+      tap({
+        next: () => {
+          const durationMs = Date.now() - start;
+          this.record(method, path, "success", durationMs);
+        },
+        error: () => {
+          const durationMs = Date.now() - start;
+          this.record(method, path, "error", durationMs);
+        }
+      })
+    );
+  }
+  record(method, path, outcome, durationMs) {
+    const correlationId = this.correlationSvc?.getOrUndefined();
+    const span = getActiveSpan();
+    span?.setAttribute("http.method", method);
+    span?.setAttribute("http.target", path);
+    span?.setAttribute("http.duration_ms", durationMs);
+    this.logger.logWithMeta("info", `${method} ${path} [${outcome}] ${durationMs}ms`, {
+      method,
+      path,
+      outcome,
+      durationMs,
+      correlationId
+    });
+    this.metrics?.record("http.request.duration", durationMs, {
+      unit: "ms",
+      tags: { method, path, outcome }
+    });
+  }
+};
+PerformanceInterceptor = __decorateClass([
+  Injectable(),
+  __decorateParam(0, Inject(LoggerService)),
+  __decorateParam(1, Optional()),
+  __decorateParam(1, Inject(MetricsService)),
+  __decorateParam(2, Optional()),
+  __decorateParam(2, Inject(CorrelationIdService))
+], PerformanceInterceptor);
+var AllExceptionsFilter = class {
+  constructor(logger, correlationSvc) {
+    this.logger = logger;
+    this.correlationSvc = correlationSvc;
+  }
+  logger;
+  correlationSvc;
+  mappers = [];
+  /**
+   * Register a custom error mapper.
+   * Mappers are tried in order; the first non-null result wins.
+   * Return `null` to fall through to the next mapper.
+   */
+  addMapper(mapper) {
+    this.mappers.push(mapper);
+    return this;
+  }
+  catch(exception, host) {
+    const ctx = host.switchToHttp();
+    const res = ctx.getResponse();
+    const mapped = this.resolveError(exception);
+    const correlationId = this.correlationSvc?.getOrUndefined();
+    const span = getActiveSpan();
+    span?.recordException(exception instanceof Error ? exception : new Error(String(exception)));
+    this.logger.error(
+      mapped.message,
+      exception instanceof Error ? exception.stack : void 0,
+      AllExceptionsFilter.name
+    );
+    res.status(mapped.statusCode).json({
+      ok: false,
+      statusCode: mapped.statusCode,
+      message: mapped.message,
+      code: mapped.code,
+      correlationId,
+      timestamp: (/* @__PURE__ */ new Date()).toISOString()
+    });
+  }
+  resolveError(exception) {
+    for (const mapper of this.mappers) {
+      const result = mapper(exception);
+      if (result !== null) return result;
+    }
+    if (exception instanceof HttpException) {
+      const body = exception.getResponse();
+      const message = typeof body === "string" ? body : body.message ?? exception.message;
+      return { statusCode: exception.getStatus(), message };
+    }
+    return {
+      statusCode: HttpStatus.INTERNAL_SERVER_ERROR,
+      message: "Internal server error"
+    };
+  }
+};
+AllExceptionsFilter = __decorateClass([
+  Catch(),
+  __decorateParam(0, Inject(LoggerService)),
+  __decorateParam(1, Optional()),
+  __decorateParam(1, Inject(CorrelationIdService))
+], AllExceptionsFilter);
+
+// src/observability.module.ts
+var ObservabilityModule = class {
+  static forRoot(options) {
+    const optionsProvider = {
+      provide: OBSERVABILITY_OPTIONS,
+      useValue: options
+    };
+    const providers = [
+      optionsProvider,
+      CorrelationIdService,
+      LoggerService,
+      MetricsService,
+      CorrelationInterceptor,
+      PerformanceInterceptor,
+      AllExceptionsFilter
+    ];
+    return {
+      module: ObservabilityModule,
+      global: true,
+      providers,
+      exports: [
+        CorrelationIdService,
+        LoggerService,
+        MetricsService,
+        CorrelationInterceptor,
+        PerformanceInterceptor,
+        AllExceptionsFilter
+      ]
+    };
+  }
+};
+ObservabilityModule = __decorateClass([
+  Module({})
+], ObservabilityModule);
+
+// src/decorators/track-performance.decorator.ts
+function TrackPerformance(options = {}) {
+  return function(target, propertyKey, descriptor) {
+    const original = descriptor.value;
+    const operationName = options.operation ?? `${target.constructor.name}.${String(propertyKey)}`;
+    descriptor.value = async function(...args) {
+      const tracer = getTracer("@backendkit-labs/observability");
+      const span = tracer.startSpan(operationName);
+      if (options.attributes) {
+        span.setAttributes(options.attributes);
+      }
+      try {
+        const result = await runInOtelContext(span, () => original.apply(this, args));
+        span.setStatus({ code: 1 });
+        return result;
+      } catch (err) {
+        span.recordException(err instanceof Error ? err : new Error(String(err)));
+        span.setStatus({ code: 2, message: String(err) });
+        throw err;
+      } finally {
+        span.end();
+      }
+    };
+    return descriptor;
+  };
+}
+
+export { AllExceptionsFilter, CorrelationIdService, CorrelationInterceptor, LoggerService, MetricsService, OBSERVABILITY_OPTIONS, ObservabilityModule, PerformanceInterceptor, TrackPerformance, WinstonHttpTransport };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/internal/otel.ts","../src/correlation/correlation.service.ts","../src/observability.constants.ts","../src/logger/winston-http.transport.ts","../src/logger/logger.service.ts","../src/metrics/metrics.service.ts","../src/interceptors/correlation.interceptor.ts","../src/interceptors/performance.interceptor.ts","../src/filters/all-exceptions.filter.ts","../src/observability.module.ts","../src/decorators/track-performance.decorator.ts"],"names":["transports","Injectable","TRANSPORT_CB_DEFAULTS","http2","https2","axios","CircuitBreaker","CircuitBreakerOpenError","Inject","Optional","randomUUID","tap"],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Optional OpenTelemetry shim.\n * If @opentelemetry/api is not installed all operations become no-ops,\n * so the package works without any tracing backend.\n */\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nlet otel: any = null;\n\ntry {\n  // Dynamic require keeps OTel out of the bundle when not installed\n  // eslint-disable-next-line @typescript-eslint/no-require-imports\n  otel = require('@opentelemetry/api');\n} catch {\n  // OTel not installed — spans will be no-ops\n}\n\nexport const isOtelAvailable = (): boolean => otel !== null;\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport const getTracer = (name: string): any =>\n  otel?.trace?.getTracer(name) ?? noopTracer;\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport const getActiveSpan = (): any =>\n  otel ? otel.trace.getSpan(otel.context.active()) : undefined;\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport const runInOtelContext = async <T>(span: any, fn: () => Promise<T>): Promise<T> => {\n  if (!otel || !span) return fn();\n  return otel.context.with(otel.trace.setSpan(otel.context.active(), span), fn);\n};\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nconst noopSpan: any = {\n  end:             () => {},\n  setAttribute:    () => {},\n  setAttributes:   () => {},\n  recordException: () => {},\n  setStatus:       () => {},\n  spanContext:     () => ({ traceId: '', spanId: '' }),\n};\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nconst noopTracer: any = {\n  startSpan:       () => noopSpan,\n  startActiveSpan: (_name: string, fn: (span: unknown) => unknown) => fn(noopSpan),\n};\n","import { AsyncLocalStorage } from 'node:async_hooks';\nimport { Injectable }        from '@nestjs/common';\nimport { randomUUID }        from 'node:crypto';\nimport { getActiveSpan }     from '../internal/otel.js';\n\nconst storage = new AsyncLocalStorage<string>();\n\n@Injectable()\nexport class CorrelationIdService {\n  /**\n   * Run `fn` inside a context that carries `correlationId`.\n   * All code executed within `fn` (including async continuations) can call\n   * `get()` and receive the same ID without passing it explicitly.\n   */\n  run<T>(correlationId: string, fn: () => T): T {\n    return storage.run(correlationId, fn);\n  }\n\n  /** Current correlation ID, or a fresh UUID when called outside a context. */\n  get(): string {\n    return storage.getStore() ?? randomUUID();\n  }\n\n  /**\n   * Current correlation ID, or `undefined` when called outside a context.\n   * Prefer `get()` for logging; use this only when you need to distinguish\n   * \"no context\" from \"context with a random ID\".\n   */\n  getOrUndefined(): string | undefined {\n    return storage.getStore();\n  }\n\n  /**\n   * Active OTel trace + span IDs when @opentelemetry/api is installed and a\n   * span is active; `undefined` otherwise.\n   */\n  getTraceContext(): { traceId: string; spanId: string } | undefined {\n    const span = getActiveSpan();\n    if (!span) return undefined;\n    const ctx = span.spanContext?.();\n    if (!ctx?.traceId) return undefined;\n    return { traceId: ctx.traceId, spanId: ctx.spanId };\n  }\n}\n","export const OBSERVABILITY_OPTIONS = 'OBSERVABILITY_OPTIONS' as const;\n","import TransportStream, { TransportStreamOptions }    from 'winston-transport';\nimport axios, { AxiosInstance }                        from 'axios';\nimport * as http                                       from 'node:http';\nimport * as https                                      from 'node:https';\nimport {\n  CircuitBreaker,\n  CircuitBreakerConfig,\n  CircuitBreakerOpenError,\n} from '@backendkit-labs/circuit-breaker';\n\nexport interface WinstonHttpTransportOptions extends TransportStreamOptions {\n  /** Full URL of the log-ingest endpoint. */\n  url: string;\n\n  /** Bearer token sent in `Authorization` header. */\n  authToken?: string;\n\n  /** Additional static headers merged into every request. */\n  headers?: Record<string, string>;\n\n  /** Flush batch when it reaches this many entries (default 100). */\n  batchSize?: number;\n\n  /** Maximum entries held in the in-memory buffer (default 2000). */\n  maxBufferSize?: number;\n\n  /** Flush interval in ms — also flushes on `close()` (default 5000). */\n  flushIntervalMs?: number;\n\n  /** Request timeout in ms (default 5000). */\n  timeoutMs?: number;\n\n  /**\n   * Override any circuit breaker config fields.\n   * `name` and `isFailure` are set internally and cannot be overridden.\n   *\n   * Transport defaults: failureThreshold 60%, slidingWindowSize 5,\n   * minimumCalls 3, openTimeoutMs 30 000, halfOpenMaxCalls 1.\n   */\n  circuitBreaker?: Partial<Omit<CircuitBreakerConfig, 'name' | 'isFailure'>>;\n}\n\ninterface LogEntry {\n  level:   string;\n  message: string;\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  [key: string]: any;\n}\n\nconst TRANSPORT_CB_DEFAULTS: Omit<CircuitBreakerConfig, 'name' | 'isFailure'> = {\n  failureThreshold:  60,\n  slowCallThreshold: 100,\n  slowCallDurationMs: 60_000,\n  minimumCalls:      3,\n  slidingWindowSize: 5,\n  halfOpenMaxCalls:  1,\n  openTimeoutMs:     30_000,\n};\n\nexport class WinstonHttpTransport extends TransportStream {\n  private readonly client:       AxiosInstance;\n  private readonly cb:           CircuitBreaker;\n  private readonly buffer:       LogEntry[] = [];\n  private readonly batchSize:    number;\n  private readonly maxBufferSize: number;\n  private readonly flushTimer:   ReturnType<typeof setInterval>;\n\n  constructor(opts: WinstonHttpTransportOptions) {\n    super(opts);\n\n    this.batchSize     = opts.batchSize    ?? 100;\n    this.maxBufferSize = opts.maxBufferSize ?? 2_000;\n\n    const keepAlive      = new http.Agent({ keepAlive: true });\n    const keepAliveHttps = new https.Agent({ keepAlive: true });\n\n    this.client = axios.create({\n      baseURL: opts.url,\n      timeout: opts.timeoutMs ?? 5_000,\n      httpAgent:  keepAlive,\n      httpsAgent: keepAliveHttps,\n      headers: {\n        'Content-Type': 'application/json',\n        ...(opts.authToken ? { Authorization: `Bearer ${opts.authToken}` } : {}),\n        ...opts.headers,\n      },\n    });\n\n    this.cb = new CircuitBreaker({\n      ...TRANSPORT_CB_DEFAULTS,\n      ...opts.circuitBreaker,\n      name:      'WinstonHttpTransport',\n      isFailure: () => true,\n    });\n\n    this.flushTimer = setInterval(\n      () => { void this.flush(); },\n      opts.flushIntervalMs ?? 5_000,\n    );\n    this.flushTimer.unref?.();\n  }\n\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  override log(info: any, callback: () => void): void {\n    setImmediate(() => this.emit('logged', info));\n\n    if (this.buffer.length < this.maxBufferSize) {\n      this.buffer.push(info as LogEntry);\n    }\n    // silently drop when full — buffer-full warn would cause infinite recursion\n\n    if (this.buffer.length >= this.batchSize) {\n      void this.flush();\n    }\n\n    callback();\n  }\n\n  /** Flush remaining buffer on graceful shutdown. */\n  override async close(): Promise<void> {\n    clearInterval(this.flushTimer);\n    await this.flush();\n  }\n\n  private async flush(): Promise<void> {\n    if (this.buffer.length === 0) return;\n\n    const batch = this.buffer.splice(0, this.batchSize);\n\n    try {\n      await this.cb.execute(() => this.client.post('', batch));\n    } catch (err) {\n      // Re-queue the batch (whether CB was open or the request failed)\n      const room = this.maxBufferSize - this.buffer.length;\n      if (room > 0) this.buffer.unshift(...batch.slice(0, room));\n\n      if (!(err instanceof CircuitBreakerOpenError)) {\n        // Network errors are worth logging; CB-open state was already surfaced\n        // via onStateChange in the CircuitBreaker itself\n        console.error(`[WinstonHttpTransport] flush failed — re-queued ${batch.length} entries`, err);\n      }\n    }\n  }\n}\n","import { Injectable, Inject, Optional, LoggerService as NestLoggerService } from '@nestjs/common';\nimport * as winston                                                          from 'winston';\nimport { CorrelationIdService }                                             from '../correlation/correlation.service.js';\nimport { OBSERVABILITY_OPTIONS }                                            from '../observability.constants.js';\nimport { ObservabilityOptions }                                             from '../observability.types.js';\nimport { WinstonHttpTransport }                                             from './winston-http.transport.js';\n\n@Injectable()\nexport class LoggerService implements NestLoggerService {\n  private readonly winston: winston.Logger;\n\n  constructor(\n    @Inject(OBSERVABILITY_OPTIONS)\n    private readonly opts: ObservabilityOptions,\n    @Optional()\n    private readonly correlationSvc?: CorrelationIdService,\n  ) {\n    const transports: winston.transport[] = [\n      new winston.transports.Console({\n        format: winston.format.combine(\n          winston.format.timestamp(),\n          winston.format.colorize(),\n          winston.format.printf(({ level, message, timestamp, ...meta }) => {\n            const extra = Object.keys(meta).length ? ` ${JSON.stringify(meta)}` : '';\n            return `${timestamp} [${level}] ${message}${extra}`;\n          }),\n        ),\n      }),\n    ];\n\n    if (opts.http) {\n      transports.push(\n        new WinstonHttpTransport({\n          ...opts.http,\n          format: winston.format.json(),\n        }),\n      );\n    }\n\n    this.winston = winston.createLogger({\n      level:      opts.logLevel ?? 'info',\n      transports,\n      format:     winston.format.json(),\n    });\n  }\n\n  log(message: string, context?: string): void {\n    this.winston.info(message, this.buildMeta(context));\n  }\n\n  error(message: string, trace?: string, context?: string): void {\n    this.winston.error(message, { ...this.buildMeta(context), trace });\n  }\n\n  warn(message: string, context?: string): void {\n    this.winston.warn(message, this.buildMeta(context));\n  }\n\n  debug(message: string, context?: string): void {\n    this.winston.debug(message, this.buildMeta(context));\n  }\n\n  verbose(message: string, context?: string): void {\n    this.winston.verbose(message, this.buildMeta(context));\n  }\n\n  /** Log with additional arbitrary metadata. */\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  logWithMeta(level: string, message: string, meta: Record<string, any>): void {\n    this.winston.log(level, message, { ...this.buildMeta(), ...meta });\n  }\n\n  private buildMeta(context?: string): Record<string, unknown> {\n    const base: Record<string, unknown> = {\n      service:       this.opts.serviceName,\n      environment:   this.opts.environment ?? 'production',\n      correlationId: this.correlationSvc?.get(),\n    };\n    if (context) base.context = context;\n    return base;\n  }\n}\n","import { Injectable, Inject, Optional, OnModuleDestroy, Logger } from '@nestjs/common';\nimport axios, { AxiosInstance }                                   from 'axios';\nimport * as http                                                  from 'node:http';\nimport * as https                                                 from 'node:https';\nimport {\n  CircuitBreaker,\n  CircuitBreakerConfig,\n  CircuitBreakerOpenError,\n  CircuitBreakerState,\n}                                                                 from '@backendkit-labs/circuit-breaker';\nimport { CorrelationIdService }                                   from '../correlation/correlation.service.js';\nimport { OBSERVABILITY_OPTIONS }                                  from '../observability.constants.js';\nimport { ObservabilityOptions, MetricEvent }                      from '../observability.types.js';\n\nconst TRANSPORT_CB_DEFAULTS: Omit<CircuitBreakerConfig, 'name' | 'isFailure'> = {\n  failureThreshold:  60,\n  slowCallThreshold: 100,\n  slowCallDurationMs: 60_000,\n  minimumCalls:      3,\n  slidingWindowSize: 5,\n  halfOpenMaxCalls:  1,\n  openTimeoutMs:     30_000,\n};\n\n@Injectable()\nexport class MetricsService implements OnModuleDestroy {\n  private readonly client:        AxiosInstance | null = null;\n  private readonly cb:            CircuitBreaker | null = null;\n  private readonly logger =       new Logger(MetricsService.name);\n  private readonly buffer:        MetricEvent[] = [];\n  private readonly maxBufferSize: number = 5_000;\n  private readonly flushTimer:    ReturnType<typeof setInterval> | null = null;\n\n  constructor(\n    @Inject(OBSERVABILITY_OPTIONS)\n    private readonly opts: ObservabilityOptions,\n    @Optional()\n    private readonly correlationSvc?: CorrelationIdService,\n  ) {\n    if (!opts.metrics) return;\n\n    const m = opts.metrics;\n    this.maxBufferSize = m.maxBufferSize ?? 5_000;\n\n    const keepAlive      = new http.Agent({ keepAlive: true });\n    const keepAliveHttps = new https.Agent({ keepAlive: true });\n\n    this.client = axios.create({\n      baseURL: m.url,\n      timeout: m.timeoutMs ?? 5_000,\n      httpAgent:  keepAlive,\n      httpsAgent: keepAliveHttps,\n      headers: {\n        'Content-Type': 'application/json',\n        ...(m.authToken ? { Authorization: `Bearer ${m.authToken}` } : {}),\n        ...m.headers,\n      },\n    });\n\n    this.cb = new CircuitBreaker({\n      ...TRANSPORT_CB_DEFAULTS,\n      ...m.circuitBreaker,\n      name:      'MetricsService',\n      isFailure: () => true,\n      onStateChange: (from, to, metrics) => {\n        if (to === CircuitBreakerState.OPEN) {\n          this.logger.warn(\n            `[MetricsService] circuit breaker OPEN — pausing metric sends for ${(m.circuitBreaker?.openTimeoutMs ?? TRANSPORT_CB_DEFAULTS.openTimeoutMs) / 1_000}s`,\n            metrics,\n          );\n        } else if (to === CircuitBreakerState.CLOSED && from !== CircuitBreakerState.HALF_OPEN) {\n          this.logger.log(`[MetricsService] circuit breaker CLOSED — recovered`);\n        }\n        m.circuitBreaker?.onStateChange?.(from, to, metrics);\n      },\n    });\n\n    this.flushTimer = setInterval(\n      () => { void this.flush(); },\n      m.flushIntervalMs ?? 10_000,\n    );\n    this.flushTimer.unref?.();\n  }\n\n  /**\n   * Enqueue a metric event. Fire-and-forget; batched and sent on the next\n   * flush interval or when the buffer reaches `maxBufferSize`.\n   */\n  record(\n    name: string,\n    value: number,\n    options?: { unit?: string; tags?: Record<string, string> },\n  ): void {\n    if (!this.client) return;\n\n    if (this.buffer.length >= this.maxBufferSize) {\n      this.logger.warn('[MetricsService] buffer full — dropping metric');\n      return;\n    }\n\n    this.buffer.push({\n      name,\n      value,\n      unit:          options?.unit,\n      tags:          options?.tags,\n      timestamp:     new Date().toISOString(),\n      serviceName:   this.opts.serviceName,\n      environment:   this.opts.environment ?? 'production',\n      correlationId: this.correlationSvc?.getOrUndefined(),\n    });\n  }\n\n  /** Flush on graceful shutdown. */\n  async onModuleDestroy(): Promise<void> {\n    if (this.flushTimer) clearInterval(this.flushTimer);\n    await this.flush();\n  }\n\n  private async flush(): Promise<void> {\n    if (!this.client || this.buffer.length === 0) return;\n\n    const batch = this.buffer.splice(0, 500);\n\n    try {\n      await this.cb!.execute(() => this.client!.post('', batch));\n    } catch (err) {\n      // Re-queue in both cases (CB open or network error)\n      const room = this.maxBufferSize - this.buffer.length;\n      if (room > 0) this.buffer.unshift(...batch.slice(0, room));\n\n      if (!(err instanceof CircuitBreakerOpenError)) {\n        this.logger.warn(\n          `[MetricsService] flush failed — re-queueing ${batch.length} events`,\n          err,\n        );\n      }\n    }\n  }\n}\n","import {\n  Injectable,\n  NestInterceptor,\n  ExecutionContext,\n  CallHandler,\n  Inject,\n} from '@nestjs/common';\nimport { Observable }           from 'rxjs';\nimport { tap }                  from 'rxjs/operators';\nimport { randomUUID }           from 'node:crypto';\nimport { CorrelationIdService } from '../correlation/correlation.service.js';\n\nconst CORRELATION_HEADER = 'x-correlation-id';\n\n@Injectable()\nexport class CorrelationInterceptor implements NestInterceptor {\n  constructor(\n    @Inject(CorrelationIdService)\n    private readonly correlationSvc: CorrelationIdService,\n  ) {}\n\n  intercept(ctx: ExecutionContext, next: CallHandler): Observable<unknown> {\n    const req = ctx.switchToHttp().getRequest<Record<string, unknown>>();\n    const res = ctx.switchToHttp().getResponse<{\n      setHeader(name: string, value: string): void;\n    }>();\n\n    const incomingId =\n      (req.headers as Record<string, string | undefined>)?.[CORRELATION_HEADER];\n    const correlationId = (typeof incomingId === 'string' && incomingId)\n      ? incomingId\n      : randomUUID();\n\n    res.setHeader(CORRELATION_HEADER, correlationId);\n\n    return new Observable(subscriber => {\n      this.correlationSvc.run(correlationId, () => {\n        next.handle().pipe(\n          tap({ error: () => {} }),\n        ).subscribe(subscriber);\n      });\n    });\n  }\n}\n","import {\n  Injectable,\n  NestInterceptor,\n  ExecutionContext,\n  CallHandler,\n  Inject,\n  Optional,\n} from '@nestjs/common';\nimport { Observable }           from 'rxjs';\nimport { tap }                  from 'rxjs/operators';\nimport { LoggerService }        from '../logger/logger.service.js';\nimport { MetricsService }       from '../metrics/metrics.service.js';\nimport { CorrelationIdService } from '../correlation/correlation.service.js';\nimport { getActiveSpan }        from '../internal/otel.js';\n\n@Injectable()\nexport class PerformanceInterceptor implements NestInterceptor {\n  constructor(\n    @Inject(LoggerService)\n    private readonly logger: LoggerService,\n    @Optional()\n    @Inject(MetricsService)\n    private readonly metrics: MetricsService | undefined,\n    @Optional()\n    @Inject(CorrelationIdService)\n    private readonly correlationSvc: CorrelationIdService | undefined,\n  ) {}\n\n  intercept(ctx: ExecutionContext, next: CallHandler): Observable<unknown> {\n    const start  = Date.now();\n    const req    = ctx.switchToHttp().getRequest<{\n      method: string;\n      url: string;\n    }>();\n    const method = req.method ?? 'UNKNOWN';\n    const path   = req.url   ?? 'UNKNOWN';\n\n    return next.handle().pipe(\n      tap({\n        next: () => {\n          const durationMs = Date.now() - start;\n          this.record(method, path, 'success', durationMs);\n        },\n        error: () => {\n          const durationMs = Date.now() - start;\n          this.record(method, path, 'error', durationMs);\n        },\n      }),\n    );\n  }\n\n  private record(\n    method: string,\n    path: string,\n    outcome: 'success' | 'error',\n    durationMs: number,\n  ): void {\n    const correlationId = this.correlationSvc?.getOrUndefined();\n    const span          = getActiveSpan();\n\n    span?.setAttribute('http.method', method);\n    span?.setAttribute('http.target', path);\n    span?.setAttribute('http.duration_ms', durationMs);\n\n    this.logger.logWithMeta('info', `${method} ${path} [${outcome}] ${durationMs}ms`, {\n      method,\n      path,\n      outcome,\n      durationMs,\n      correlationId,\n    });\n\n    this.metrics?.record('http.request.duration', durationMs, {\n      unit: 'ms',\n      tags: { method, path, outcome },\n    });\n  }\n}\n","import {\n  ExceptionFilter,\n  Catch,\n  ArgumentsHost,\n  HttpException,\n  HttpStatus,\n  Inject,\n  Optional,\n} from '@nestjs/common';\nimport { LoggerService }        from '../logger/logger.service.js';\nimport { CorrelationIdService } from '../correlation/correlation.service.js';\nimport { getActiveSpan }        from '../internal/otel.js';\n\nexport type ErrorMapper = (error: unknown) => {\n  statusCode: number;\n  message:    string;\n  code?:      string;\n} | null;\n\n@Catch()\nexport class AllExceptionsFilter implements ExceptionFilter {\n  private readonly mappers: ErrorMapper[] = [];\n\n  constructor(\n    @Inject(LoggerService)\n    private readonly logger: LoggerService,\n    @Optional()\n    @Inject(CorrelationIdService)\n    private readonly correlationSvc: CorrelationIdService | undefined,\n  ) {}\n\n  /**\n   * Register a custom error mapper.\n   * Mappers are tried in order; the first non-null result wins.\n   * Return `null` to fall through to the next mapper.\n   */\n  addMapper(mapper: ErrorMapper): this {\n    this.mappers.push(mapper);\n    return this;\n  }\n\n  catch(exception: unknown, host: ArgumentsHost): void {\n    const ctx  = host.switchToHttp();\n    const res  = ctx.getResponse<{\n      status(code: number): { json(body: unknown): void };\n    }>();\n\n    const mapped = this.resolveError(exception);\n\n    const correlationId = this.correlationSvc?.getOrUndefined();\n    const span          = getActiveSpan();\n    span?.recordException(exception instanceof Error ? exception : new Error(String(exception)));\n\n    this.logger.error(\n      mapped.message,\n      exception instanceof Error ? exception.stack : undefined,\n      AllExceptionsFilter.name,\n    );\n\n    res.status(mapped.statusCode).json({\n      ok:            false,\n      statusCode:    mapped.statusCode,\n      message:       mapped.message,\n      code:          mapped.code,\n      correlationId,\n      timestamp:     new Date().toISOString(),\n    });\n  }\n\n  private resolveError(exception: unknown): {\n    statusCode: number;\n    message:    string;\n    code?:      string;\n  } {\n    for (const mapper of this.mappers) {\n      const result = mapper(exception);\n      if (result !== null) return result;\n    }\n\n    if (exception instanceof HttpException) {\n      const body = exception.getResponse();\n      const message =\n        typeof body === 'string'\n          ? body\n          : (body as { message?: string }).message ?? exception.message;\n      return { statusCode: exception.getStatus(), message };\n    }\n\n    return {\n      statusCode: HttpStatus.INTERNAL_SERVER_ERROR,\n      message:    'Internal server error',\n    };\n  }\n}\n","import { DynamicModule, Module, Provider } from '@nestjs/common';\nimport { CorrelationIdService }            from './correlation/correlation.service.js';\nimport { LoggerService }                   from './logger/logger.service.js';\nimport { MetricsService }                  from './metrics/metrics.service.js';\nimport { CorrelationInterceptor }          from './interceptors/correlation.interceptor.js';\nimport { PerformanceInterceptor }          from './interceptors/performance.interceptor.js';\nimport { AllExceptionsFilter }             from './filters/all-exceptions.filter.js';\nimport { OBSERVABILITY_OPTIONS }           from './observability.constants.js';\nimport { ObservabilityOptions }            from './observability.types.js';\n\n@Module({})\nexport class ObservabilityModule {\n  static forRoot(options: ObservabilityOptions): DynamicModule {\n    const optionsProvider: Provider = {\n      provide:  OBSERVABILITY_OPTIONS,\n      useValue: options,\n    };\n\n    const providers: Provider[] = [\n      optionsProvider,\n      CorrelationIdService,\n      LoggerService,\n      MetricsService,\n      CorrelationInterceptor,\n      PerformanceInterceptor,\n      AllExceptionsFilter,\n    ];\n\n    return {\n      module:   ObservabilityModule,\n      global:   true,\n      providers,\n      exports:  [\n        CorrelationIdService,\n        LoggerService,\n        MetricsService,\n        CorrelationInterceptor,\n        PerformanceInterceptor,\n        AllExceptionsFilter,\n      ],\n    };\n  }\n}\n","import { getTracer, runInOtelContext } from '../internal/otel.js';\n\nexport interface TrackPerformanceOptions {\n  /** OTel span / log operation name. Defaults to `ClassName.methodName`. */\n  operation?: string;\n\n  /** Attributes added to the OTel span. */\n  attributes?: Record<string, string | number | boolean>;\n}\n\n/**\n * Method decorator that wraps the decorated async method in an OTel span\n * (when @opentelemetry/api is available) and records its duration.\n * Works with regular methods and NestJS service methods.\n *\n * @example\n * \\@TrackPerformance()\n * async processPayment(id: string) { ... }\n */\nexport function TrackPerformance(options: TrackPerformanceOptions = {}): MethodDecorator {\n  return function (\n    target: object,\n    propertyKey: string | symbol,\n    descriptor: PropertyDescriptor,\n  ): PropertyDescriptor {\n    const original = descriptor.value as (...args: unknown[]) => Promise<unknown>;\n    const operationName =\n      options.operation ?? `${target.constructor.name}.${String(propertyKey)}`;\n\n    descriptor.value = async function (...args: unknown[]): Promise<unknown> {\n      const tracer = getTracer('@backendkit-labs/observability');\n      const span   = tracer.startSpan(operationName);\n\n      if (options.attributes) {\n        span.setAttributes(options.attributes);\n      }\n\n      try {\n        const result = await runInOtelContext(span, () => original.apply(this, args));\n        span.setStatus({ code: 1 }); // SpanStatusCode.OK\n        return result;\n      } catch (err) {\n        span.recordException(err instanceof Error ? err : new Error(String(err)));\n        span.setStatus({ code: 2, message: String(err) }); // SpanStatusCode.ERROR\n        throw err;\n      } finally {\n        span.end();\n      }\n    };\n\n    return descriptor;\n  };\n}\n"]}