nugi-ts-logs-sdk 1.0.0

package/README.md

@@ -0,0 +1,218 @@
+# nugi-ts-logs-sdk
+
+Framework-agnostic TypeScript observability SDK. One client covering the same
+surface as `nugi-logs-sdk` (Nest) — **logs, metrics, traces, errors, DB query
+capture, and cron check-ins** — with **distributed tracing**, **request
+tracking**, and a delivery pipeline that does **batching, retries and bounded
+buffering**. Ships adapters for **Express**, **Fastify**, and **NestJS**, and
+works with plain Node / JavaScript via CommonJS `require()`.
+
+Designed to never crash or block the host app: every collection and delivery
+path is fault-tolerant and non-blocking.
+
+## Install
+
+```bash
+npm install nugi-ts-logs-sdk
+```
+
+Requires Node 16+ (uses the built-in `fetch` on Node 18+; on Node 16 provide a
+global `fetch` polyfill). No mandatory runtime dependencies. `@nestjs/common`
+and `rxjs` are optional peers, only needed if you use the NestJS adapter.
+
+## Quick start
+
+```ts
+import { createClient } from 'nugi-ts-logs-sdk';
+
+export const nugi = createClient({
+  apiKey: process.env.NUGI_API_KEY!,
+  appId: process.env.NUGI_APP_ID!,
+  endpoint: process.env.NUGI_ENDPOINT, // https://logs.example.com
+  environment: process.env.NUGI_ENVIRONMENT || 'production',
+  serviceName: process.env.NUGI_SERVICE_NAME || 'api',
+  release: process.env.NUGI_RELEASE,   // optional deploy version
+  captureConsole: true,
+  captureQueries: true,                // pg / mysql2 / sequelize / typeorm
+  reportQueryErrors: true,
+  slowQueryThresholdMs: 500,
+  captureUncaught: true,
+  // batching / reliability (defaults shown)
+  batchSize: 100,
+  flushIntervalMs: 5000,
+  maxBufferSize: 10_000,
+  maxRetries: 3,
+  sampleRate: 1,
+  redact: ['ssn', 'creditCard'],
+});
+```
+
+### Logs
+
+```ts
+nugi.logger.info('order placed', { orderId, amount });
+nugi.logger.error('payment failed', { orderId, reason });
+
+const scoped = nugi.logger.child({ component: 'billing' });
+scoped.warn('retrying charge');
+```
+
+### Metrics
+
+```ts
+nugi.metrics.counter('orders.placed').add(1, { channel: 'web' });
+nugi.metrics.gauge('queue.depth').set(42);
+nugi.metrics.histogram('db.query.duration', 'ms').record(12.5);
+
+// Nest-SDK-compatible helpers
+nugi.metrics.count('orders.placed');
+nugi.metrics.distribution('latency', 12.5, { unit: 'ms' });
+nugi.metrics.setAttributes({ region: 'eu-west' });
+nugi.metrics.withScope({ tenant: 'acme' }, () => {
+  nugi.metrics.count('checkout.step');
+});
+```
+
+### Traces & distributed tracing
+
+```ts
+await nugi.tracer.startActiveSpan('charge-card', { kind: 'client' }, async (span) => {
+  span.setAttribute('gateway', 'stripe');
+  const headers = {};
+  span.inject(headers); // W3C traceparent
+  await fetch(url, { headers });
+  nugi.logger.info('charging');
+});
+
+// Continue an inbound trace (W3C + x-trace-id / B3 / ALB fallbacks)
+import { extractContext } from 'nugi-ts-logs-sdk';
+const parent = extractContext(req.headers);
+nugi.tracer.startActiveSpan('handle', { kind: 'server', parent }, () => { /* ... */ });
+```
+
+### Error tracking
+
+```ts
+try { /* ... */ } catch (err) {
+  nugi.trackError(err, { handled: true, attributes: { orderId } });
+}
+
+createClient({ /* ... */, captureUncaught: true });
+```
+
+Errors include Sentry-style stack frames with source context when available.
+
+### Database query capture
+
+Auto-patches **pg**, **mysql2**, **sequelize**, and **typeorm** when installed.
+Prisma needs an explicit wrap:
+
+```ts
+const prisma = nugi.wrapPrisma(new PrismaClient());
+```
+
+Manual:
+
+```ts
+nugi.logQuery('SELECT 1', 12, { orm: 'pg', success: true });
+```
+
+Failed queries can auto-`trackError` (`reportQueryErrors`, default on). Slow
+queries (≥ `slowQueryThresholdMs`) emit `db.query.slow` metrics and land in the
+Queries dashboard (dual-written to `/api/v1/logs` + batch `kind: 'query'`).
+
+### Cron check-ins
+
+```ts
+nugi.checkins.ok('nightly-report');
+nugi.checkins.error('nightly-report', 'DB timeout');
+nugi.checkins.capture('nightly-report', 'in_progress');
+```
+
+### Express
+
+```ts
+import { nugiExpress, nugiExpressErrorHandler } from 'nugi-ts-logs-sdk';
+
+app.use(nugiExpress(nugi));            // early
+// ... routes ...
+app.use(nugiExpressErrorHandler(nugi)); // last
+```
+
+HTTP instrumentation records access logs, server spans, RED metrics
+(`http.server.requests` / `duration` / `errors` / `client_errors`), real client
+IP (X-Forwarded-For), and a `requestId`.
+
+### Express (JavaScript / CommonJS)
+
+```js
+const { createClient, nugiExpress, nugiExpressErrorHandler } = require('nugi-ts-logs-sdk');
+const nugi = createClient({ /* ... */ });
+app.use(nugiExpress(nugi));
+app.use(nugiExpressErrorHandler(nugi));
+```
+
+### Fastify
+
+```ts
+import { nugiFastify } from 'nugi-ts-logs-sdk';
+fastify.register(nugiFastify(nugi));
+```
+
+### NestJS
+
+```ts
+import { NugiModule, NUGI_CLIENT } from 'nugi-ts-logs-sdk';
+
+@Module({
+  imports: [
+    NugiModule.forRoot({
+      apiKey: process.env.NUGI_API_KEY!,
+      appId: process.env.NUGI_APP_ID!,
+      endpoint: process.env.NUGI_ENDPOINT,
+      captureQueries: true,
+      http: { captureRequestBody: false },
+    }),
+  ],
+})
+export class AppModule {}
+```
+
+Inject the client anywhere:
+
+```ts
+constructor(@Inject(NUGI_CLIENT) private readonly nugi: NugiClient) {}
+```
+
+## Delivery guarantees
+
+- **Batching** — flush at `batchSize` or every `flushIntervalMs`.
+- **Buffering** — bounded at `maxBufferSize`; oldest dropped on overload.
+- **Retries** — exponential backoff + jitter on transient failures.
+- **Graceful shutdown** — `await nugi.shutdown()` (also wired to process signals when `flushOnExit` is on).
+- **Legacy dual-write** — DB queries also POST to `/api/v1/logs` so the Queries UI stays populated alongside the Nest SDK.
+
+## Wire format
+
+Each flush POSTs an `EventEnvelope` to `endpoint + ingestPath`
+(default `/api/v1/telemetry/batch`) with an `X-API-Key` header:
+
+```jsonc
+{
+  "resource": { "appId": "...", "serviceName": "...", "environment": "...",
+                "release": "...",
+                "host": { "hostname": "...", "serverIp": "...", "serverIps": { "ipv4": [], "ipv6": [] },
+                          "sdkVersion": "...", "nodeVersion": "...", "os": "...", "pid": 123 } },
+  "events": [ /* log | metric | span | error | query */ ],
+  "sentAt": "2026-07-05T20:00:00.000Z"
+}
+```
+
+## API surface
+
+`createClient(config)` / `new NugiClient(config)` →
+`{ logger, metrics, tracer, checkins, trackError, logQuery, wrapPrisma, flush, shutdown, resource, bufferSize }`.
+
+Also exported: query capture helpers (`startQueryCapture`, `instrumentPrisma`,
+`normalizeDbError`), stack frames (`buildStackFrames`), W3C + vendor
+propagation, sanitize helpers, and framework adapters.

package/dist/adapters/common.d.ts

@@ -0,0 +1,43 @@
+import { NugiClient } from '../client';
+import { Span } from '../signals/tracer';
+export interface HttpAdapterOptions {
+    /** Capture (sanitized) request headers. Default true. */
+    captureHeaders?: boolean;
+    /** Capture (sanitized) request body. Default false. */
+    captureRequestBody?: boolean;
+    /** Capture (sanitized) response body. Default false. */
+    captureResponseBody?: boolean;
+    /** Return true to skip instrumenting a request (e.g. health checks). */
+    ignore?: (info: NormalizedRequest) => boolean;
+    /** Override the span/transaction name. Default `HTTP <METHOD> <route|path>`. */
+    spanName?: (info: NormalizedRequest) => string;
+    /** Extra field names to redact, merged with the client's `redact` config. */
+    redact?: string[];
+}
+export interface NormalizedRequest {
+    method: string;
+    url: string;
+    path: string;
+    route?: string;
+    headers: Record<string, unknown>;
+    ip?: string;
+    userAgent?: string;
+    body?: unknown;
+    userId?: string;
+    /** Correlation id for this request (generated if inbound header absent). */
+    requestId?: string;
+    raw: unknown;
+}
+export interface NormalizedResponse {
+    statusCode: number;
+    headers?: Record<string, unknown>;
+    body?: unknown;
+}
+export declare function spanNameFor(info: NormalizedRequest, options: HttpAdapterOptions): string;
+/** Begin a server span for an inbound request, continuing any inbound trace. */
+export declare function startServerSpan(client: NugiClient, info: NormalizedRequest, options: HttpAdapterOptions): Span;
+/** Finalize the span and emit the correlated access log + duration metric. */
+export declare function completeServerSpan(client: NugiClient, span: Span, info: NormalizedRequest, response: NormalizedResponse, startedAtMs: number, options: HttpAdapterOptions): void;
+/** Normalize a variety of request shapes (Express/Fastify/Nest) into one model. */
+export declare function normalizeRequest(req: unknown): NormalizedRequest;
+//# sourceMappingURL=common.d.ts.map

package/dist/adapters/common.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../src/adapters/common.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAYzC,MAAM,WAAW,kBAAkB;IACjC,yDAAyD;IACzD,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,uDAAuD;IACvD,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,wDAAwD;IACxD,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,wEAAwE;IACxE,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,iBAAiB,KAAK,OAAO,CAAC;IAC9C,gFAAgF;IAChF,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,iBAAiB,KAAK,MAAM,CAAC;IAC/C,6EAA6E;IAC7E,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAOD,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4EAA4E;IAC5E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,OAAO,CAAC;CACd;AAED,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,wBAAgB,WAAW,CACzB,IAAI,EAAE,iBAAiB,EACvB,OAAO,EAAE,kBAAkB,GAC1B,MAAM,CASR;AAED,gFAAgF;AAChF,wBAAgB,eAAe,CAC7B,MAAM,EAAE,UAAU,EAClB,IAAI,EAAE,iBAAiB,EACvB,OAAO,EAAE,kBAAkB,GAC1B,IAAI,CAQN;AA8BD,8EAA8E;AAC9E,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,UAAU,EAClB,IAAI,EAAE,IAAI,EACV,IAAI,EAAE,iBAAiB,EACvB,QAAQ,EAAE,kBAAkB,EAC5B,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,kBAAkB,GAC1B,IAAI,CAqDN;AAED,mFAAmF;AACnF,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,iBAAiB,CAwBhE"}

package/dist/adapters/common.js

@@ -0,0 +1,153 @@
+"use strict";
+// Framework-agnostic HTTP instrumentation shared by the Express / Fastify /
+// NestJS adapters. Handles: distributed-trace continuation, server span
+// creation, request/response attribute capture, and the correlated log + metric
+// emitted when a request completes. Every function is defensive.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.spanNameFor = spanNameFor;
+exports.startServerSpan = startServerSpan;
+exports.completeServerSpan = completeServerSpan;
+exports.normalizeRequest = normalizeRequest;
+const propagation_1 = require("../internal/propagation");
+const sanitize_1 = require("../internal/sanitize");
+const http_utils_1 = require("../internal/http-utils");
+const ids_1 = require("../internal/ids");
+/** Combine the client-wide redact list with any per-adapter override. */
+function mergedRedact(client, options) {
+    return [...(client.config.redact || []), ...(options.redact || [])];
+}
+function spanNameFor(info, options) {
+    if (options.spanName) {
+        try {
+            return options.spanName(info);
+        }
+        catch {
+            /* fall through to default */
+        }
+    }
+    return `HTTP ${info.method} ${info.route || info.path}`;
+}
+/** Begin a server span for an inbound request, continuing any inbound trace. */
+function startServerSpan(client, info, options) {
+    const parent = (0, propagation_1.extractContext)(info.headers) ?? null;
+    const span = client.tracer.startSpan(spanNameFor(info, options), {
+        kind: 'server',
+        parent,
+        attributes: requestAttributes(info, options, mergedRedact(client, options)),
+    });
+    return span;
+}
+function requestAttributes(info, options, redact) {
+    const attributes = {
+        'http.method': info.method,
+        'http.url': info.url,
+        'http.target': info.path,
+        'http.route': info.route,
+        'http.user_agent': info.userAgent,
+        'net.peer.ip': info.ip,
+        'enduser.id': info.userId,
+        'http.request_id': info.requestId,
+        'http.request_content_length': (0, http_utils_1.byteLength)(info.headers['content-length'], info.body),
+    };
+    if (options.captureHeaders !== false) {
+        attributes['http.request.headers'] = (0, sanitize_1.sanitizeHeaders)(info.headers, redact);
+    }
+    if (options.captureRequestBody && info.body !== undefined) {
+        attributes['http.request.body'] = (0, sanitize_1.sanitizeBody)(info.body, redact);
+    }
+    return attributes;
+}
+/** Finalize the span and emit the correlated access log + duration metric. */
+function completeServerSpan(client, span, info, response, startedAtMs, options) {
+    try {
+        const durationMs = Math.max(0, Date.now() - startedAtMs);
+        const status = response.statusCode;
+        const isError = status >= 500;
+        const isClientError = status >= 400 && status < 500;
+        span.setAttributes({
+            'http.status_code': status,
+            'http.request_id': info.requestId,
+            'http.response_content_length': (0, http_utils_1.byteLength)(response.headers?.['content-length'], response.body),
+        });
+        if (options.captureResponseBody && response.body !== undefined) {
+            span.setAttribute('http.response.body', (0, sanitize_1.sanitizeBody)(response.body, mergedRedact(client, options)));
+        }
+        span.end({ status: isError ? 'error' : 'ok' });
+        const ctx = span.context();
+        client.logger.log(isError ? 'error' : isClientError ? 'warn' : 'info', 'http_request', {
+            'http.method': info.method,
+            'http.target': info.path,
+            'http.status_code': status,
+            duration_ms: durationMs,
+            'enduser.id': info.userId,
+            'http.request_id': info.requestId,
+            'net.peer.ip': info.ip,
+            trace_id: ctx.traceId,
+            span_id: ctx.spanId,
+        });
+        const tags = {
+            method: info.method,
+            route: info.route || info.path,
+            status_code: status,
+        };
+        client.metrics.counter('http.server.requests').add(1, tags);
+        client.metrics
+            .histogram('http.server.duration', 'ms')
+            .record(durationMs, tags);
+        if (isError) {
+            client.metrics.counter('http.server.errors').add(1, tags);
+        }
+        else if (isClientError) {
+            client.metrics.counter('http.server.client_errors').add(1, tags);
+        }
+    }
+    catch {
+        /* instrumentation must never break the response */
+    }
+}
+/** Normalize a variety of request shapes (Express/Fastify/Nest) into one model. */
+function normalizeRequest(req) {
+    const r = (req || {});
+    const headers = (0, http_utils_1.normalizeHeaders)(r.headers);
+    const method = String(r.method || 'GET').toUpperCase();
+    const url = String(r.originalUrl || r.url || '');
+    const path = safePath(url);
+    const route = extractRoute(r);
+    const inboundId = (typeof headers['x-request-id'] === 'string' && headers['x-request-id']) ||
+        (typeof headers['x-correlation-id'] === 'string' && headers['x-correlation-id']) ||
+        undefined;
+    return {
+        method,
+        url,
+        path,
+        route,
+        headers,
+        ip: (0, http_utils_1.resolveClientIp)(req) || undefined,
+        userAgent: headers['user-agent'] || undefined,
+        body: r.body,
+        userId: (0, http_utils_1.extractUserId)(req),
+        requestId: inboundId || (0, ids_1.generateSpanId)(),
+        raw: req,
+    };
+}
+function safePath(url) {
+    try {
+        return new URL(url, 'http://localhost').pathname;
+    }
+    catch {
+        const q = url.indexOf('?');
+        return q >= 0 ? url.slice(0, q) : url;
+    }
+}
+function extractRoute(r) {
+    const route = r.route;
+    if (route?.path)
+        return String(route.path);
+    const routeOptions = r.routeOptions;
+    if (routeOptions?.url)
+        return String(routeOptions.url);
+    if (typeof r.routerPath === 'string')
+        return r.routerPath;
+    return undefined;
+}
+//# sourceMappingURL=common.js.map

package/dist/adapters/common.js.map

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

package/dist/adapters/express.d.ts

@@ -0,0 +1,29 @@
+import { NugiClient } from '../client';
+import { HttpAdapterOptions } from './common';
+interface ExpressRequest {
+    [key: string]: unknown;
+}
+interface ExpressResponse {
+    statusCode: number;
+    getHeader(name: string): unknown;
+    on(event: string, listener: () => void): unknown;
+}
+type NextFunction = (err?: unknown) => void;
+type ExpressMiddleware = (req: ExpressRequest, res: ExpressResponse, next: NextFunction) => void;
+type ExpressErrorMiddleware = (err: unknown, req: ExpressRequest, res: ExpressResponse, next: NextFunction) => void;
+/**
+ * Request-tracking middleware. Continues inbound distributed traces, opens a
+ * server span for the request, runs the handler chain inside that trace context
+ * (so logs/spans correlate), and records the access log + metrics on finish.
+ *
+ * Mount early: `app.use(nugiExpress(client))`.
+ */
+export declare function nugiExpress(client: NugiClient, options?: HttpAdapterOptions): ExpressMiddleware;
+/**
+ * Error-tracking middleware. Mount after your routes:
+ * `app.use(nugiExpressErrorHandler(client))`. It records the error and re-throws
+ * it into the next handler so your own error handling still runs.
+ */
+export declare function nugiExpressErrorHandler(client: NugiClient): ExpressErrorMiddleware;
+export {};
+//# sourceMappingURL=express.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"express.d.ts","sourceRoot":"","sources":["../../src/adapters/express.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAEvC,OAAO,EAEL,kBAAkB,EAGnB,MAAM,UAAU,CAAC;AAElB,UAAU,cAAc;IACtB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AACD,UAAU,eAAe;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IACjC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC;CAClD;AACD,KAAK,YAAY,GAAG,CAAC,GAAG,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;AAC5C,KAAK,iBAAiB,GAAG,CACvB,GAAG,EAAE,cAAc,EACnB,GAAG,EAAE,eAAe,EACpB,IAAI,EAAE,YAAY,KACf,IAAI,CAAC;AACV,KAAK,sBAAsB,GAAG,CAC5B,GAAG,EAAE,OAAO,EACZ,GAAG,EAAE,cAAc,EACnB,GAAG,EAAE,eAAe,EACpB,IAAI,EAAE,YAAY,KACf,IAAI,CAAC;AAEV;;;;;;GAMG;AACH,wBAAgB,WAAW,CACzB,MAAM,EAAE,UAAU,EAClB,OAAO,GAAE,kBAAuB,GAC/B,iBAAiB,CAsCnB;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,UAAU,GACjB,sBAAsB,CAQxB"}

package/dist/adapters/express.js

@@ -0,0 +1,62 @@
+"use strict";
+// Express instrumentation. Zero hard dependency on express — typed against the
+// minimal structural shape it needs, so it works across express 4/5 and
+// compatible routers (connect, etc.).
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.nugiExpress = nugiExpress;
+exports.nugiExpressErrorHandler = nugiExpressErrorHandler;
+const context_1 = require("../internal/context");
+const common_1 = require("./common");
+/**
+ * Request-tracking middleware. Continues inbound distributed traces, opens a
+ * server span for the request, runs the handler chain inside that trace context
+ * (so logs/spans correlate), and records the access log + metrics on finish.
+ *
+ * Mount early: `app.use(nugiExpress(client))`.
+ */
+function nugiExpress(client, options = {}) {
+    return function nugiExpressMiddleware(req, res, next) {
+        let ran = false;
+        try {
+            const info = (0, common_1.normalizeRequest)(req);
+            if (options.ignore?.(info)) {
+                next();
+                return;
+            }
+            const startedAtMs = Date.now();
+            const span = (0, common_1.startServerSpan)(client, info, options);
+            res.on('finish', () => {
+                // req.user is typically populated by auth middleware after we start, so
+                // re-normalize to pick up the authenticated user id at completion.
+                const finalInfo = (0, common_1.normalizeRequest)(req);
+                (0, common_1.completeServerSpan)(client, span, finalInfo, {
+                    statusCode: res.statusCode,
+                    headers: { 'content-length': res.getHeader('content-length') },
+                }, startedAtMs, options);
+            });
+            ran = true;
+            // Propagate the trace context to the rest of the request lifecycle.
+            (0, context_1.runWithContext)({ span: span.context() }, () => next());
+        }
+        catch (error) {
+            client.trackError(error, { attributes: { source: 'nugiExpress' } });
+            if (!ran)
+                next();
+        }
+    };
+}
+/**
+ * Error-tracking middleware. Mount after your routes:
+ * `app.use(nugiExpressErrorHandler(client))`. It records the error and re-throws
+ * it into the next handler so your own error handling still runs.
+ */
+function nugiExpressErrorHandler(client) {
+    return function nugiExpressError(err, _req, _res, next) {
+        client.trackError(err, {
+            handled: false,
+            attributes: { source: 'express.error_handler' },
+        });
+        next(err);
+    };
+}
+//# sourceMappingURL=express.js.map

package/dist/adapters/express.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"express.js","sourceRoot":"","sources":["../../src/adapters/express.ts"],"names":[],"mappings":";AAAA,+EAA+E;AAC/E,wEAAwE;AACxE,sCAAsC;;AAuCtC,kCAyCC;AAOD,0DAUC;AA9FD,iDAAqD;AACrD,qCAKkB;AAuBlB;;;;;;GAMG;AACH,SAAgB,WAAW,CACzB,MAAkB,EAClB,UAA8B,EAAE;IAEhC,OAAO,SAAS,qBAAqB,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI;QAClD,IAAI,GAAG,GAAG,KAAK,CAAC;QAChB,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,IAAA,yBAAgB,EAAC,GAAG,CAAC,CAAC;YACnC,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC3B,IAAI,EAAE,CAAC;gBACP,OAAO;YACT,CAAC;YAED,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAC/B,MAAM,IAAI,GAAG,IAAA,wBAAe,EAAC,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;YAEpD,GAAG,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE;gBACpB,wEAAwE;gBACxE,mEAAmE;gBACnE,MAAM,SAAS,GAAG,IAAA,yBAAgB,EAAC,GAAG,CAAC,CAAC;gBACxC,IAAA,2BAAkB,EAChB,MAAM,EACN,IAAI,EACJ,SAAS,EACT;oBACE,UAAU,EAAE,GAAG,CAAC,UAAU;oBAC1B,OAAO,EAAE,EAAE,gBAAgB,EAAE,GAAG,CAAC,SAAS,CAAC,gBAAgB,CAAC,EAAE;iBAC/D,EACD,WAAW,EACX,OAAO,CACR,CAAC;YACJ,CAAC,CAAC,CAAC;YAEH,GAAG,GAAG,IAAI,CAAC;YACX,oEAAoE;YACpE,IAAA,wBAAc,EAAC,EAAE,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC;QACzD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,UAAU,EAAE,EAAE,MAAM,EAAE,aAAa,EAAE,EAAE,CAAC,CAAC;YACpE,IAAI,CAAC,GAAG;gBAAE,IAAI,EAAE,CAAC;QACnB,CAAC;IACH,CAAC,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,SAAgB,uBAAuB,CACrC,MAAkB;IAElB,OAAO,SAAS,gBAAgB,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI;QACpD,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE;YACrB,OAAO,EAAE,KAAK;YACd,UAAU,EAAE,EAAE,MAAM,EAAE,uBAAuB,EAAE;SAChD,CAAC,CAAC;QACH,IAAI,CAAC,GAAG,CAAC,CAAC;IACZ,CAAC,CAAC;AACJ,CAAC"}

package/dist/adapters/fastify.d.ts

@@ -0,0 +1,18 @@
+import { NugiClient } from '../client';
+import { HttpAdapterOptions } from './common';
+interface FastifyInstance {
+    addHook(name: string, handler: (...args: any[]) => unknown): unknown;
+}
+type DoneFn = (err?: unknown) => void;
+/**
+ * Fastify plugin providing request tracking, distributed tracing, error
+ * tracking and RED metrics.
+ *
+ *   fastify.register(nugiFastify(client));
+ *
+ * Hooks: onRequest (start span + enter trace context), onResponse (finish +
+ * access log/metrics), onError (record exception).
+ */
+export declare function nugiFastify(client: NugiClient, options?: HttpAdapterOptions): (fastify: FastifyInstance, _opts: unknown, done: DoneFn) => void;
+export {};
+//# sourceMappingURL=fastify.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fastify.d.ts","sourceRoot":"","sources":["../../src/adapters/fastify.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAGvC,OAAO,EAEL,kBAAkB,EAGnB,MAAM,UAAU,CAAC;AAElB,UAAU,eAAe;IAGvB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,GAAG,OAAO,CAAC;CACtE;AACD,KAAK,MAAM,GAAG,CAAC,GAAG,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;AAStC;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,GAAE,kBAAuB,aAEnE,eAAe,SACjB,OAAO,QACR,MAAM,KACX,IAAI,CAwER"}

package/dist/adapters/fastify.js

@@ -0,0 +1,78 @@
+"use strict";
+// Fastify instrumentation. Zero hard dependency on fastify — typed against the
+// minimal structural shape it needs. Registered as a plugin whose hooks apply
+// application-wide (encapsulation is skipped).
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.nugiFastify = nugiFastify;
+const context_1 = require("../internal/context");
+const common_1 = require("./common");
+const STATE = Symbol('nugi.request.state');
+/**
+ * Fastify plugin providing request tracking, distributed tracing, error
+ * tracking and RED metrics.
+ *
+ *   fastify.register(nugiFastify(client));
+ *
+ * Hooks: onRequest (start span + enter trace context), onResponse (finish +
+ * access log/metrics), onError (record exception).
+ */
+function nugiFastify(client, options = {}) {
+    const plugin = function nugiFastifyPlugin(fastify, _opts, done) {
+        fastify.addHook('onRequest', (request, _reply, hookDone) => {
+            try {
+                const info = (0, common_1.normalizeRequest)(request);
+                if (options.ignore?.(info)) {
+                    hookDone();
+                    return;
+                }
+                const span = (0, common_1.startServerSpan)(client, info, options);
+                request[STATE] = {
+                    span,
+                    startedAtMs: Date.now(),
+                };
+                // Make the span the active context for the rest of the request.
+                (0, context_1.enterContext)({ span: span.context() });
+            }
+            catch (error) {
+                client.trackError(error, { attributes: { source: 'fastify.onRequest' } });
+            }
+            hookDone();
+        });
+        fastify.addHook('onResponse', (request, reply, hookDone) => {
+            try {
+                const state = request[STATE];
+                if (state) {
+                    const info = (0, common_1.normalizeRequest)(request);
+                    const r = reply;
+                    (0, common_1.completeServerSpan)(client, state.span, info, {
+                        statusCode: r.statusCode,
+                        headers: { 'content-length': r.getHeader?.('content-length') },
+                    }, state.startedAtMs, options);
+                }
+            }
+            catch (error) {
+                client.trackError(error, { attributes: { source: 'fastify.onResponse' } });
+            }
+            hookDone();
+        });
+        fastify.addHook('onError', (request, _reply, error, hookDone) => {
+            try {
+                const state = request[STATE];
+                state?.span.recordException(error);
+                client.trackError(error, {
+                    handled: false,
+                    attributes: { source: 'fastify.onError' },
+                });
+            }
+            catch {
+                /* never break the error path */
+            }
+            hookDone();
+        });
+        done();
+    };
+    // Break Fastify encapsulation so the hooks apply to the whole application.
+    plugin[Symbol.for('skip-override')] = true;
+    return plugin;
+}
+//# sourceMappingURL=fastify.js.map

package/dist/adapters/fastify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fastify.js","sourceRoot":"","sources":["../../src/adapters/fastify.ts"],"names":[],"mappings":";AAAA,+EAA+E;AAC/E,8EAA8E;AAC9E,+CAA+C;;AAmC/C,kCA6EC;AA7GD,iDAAmD;AAEnD,qCAKkB;AASlB,MAAM,KAAK,GAAG,MAAM,CAAC,oBAAoB,CAAC,CAAC;AAO3C;;;;;;;;GAQG;AACH,SAAgB,WAAW,CAAC,MAAkB,EAAE,UAA8B,EAAE;IAC9E,MAAM,MAAM,GAAG,SAAS,iBAAiB,CACvC,OAAwB,EACxB,KAAc,EACd,IAAY;QAEZ,OAAO,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,OAAgB,EAAE,MAAe,EAAE,QAAgB,EAAE,EAAE;YACnF,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,IAAA,yBAAgB,EAAC,OAAO,CAAC,CAAC;gBACvC,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;oBAC3B,QAAQ,EAAE,CAAC;oBACX,OAAO;gBACT,CAAC;gBACD,MAAM,IAAI,GAAG,IAAA,wBAAe,EAAC,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;gBACnD,OAAmC,CAAC,KAAK,CAAC,GAAG;oBAC5C,IAAI;oBACJ,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE;iBACR,CAAC;gBAClB,gEAAgE;gBAChE,IAAA,sBAAY,EAAC,EAAE,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;YACzC,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,UAAU,EAAE,EAAE,MAAM,EAAE,mBAAmB,EAAE,EAAE,CAAC,CAAC;YAC5E,CAAC;YACD,QAAQ,EAAE,CAAC;QACb,CAAC,CAAC,CAAC;QAEH,OAAO,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC,OAAgB,EAAE,KAAc,EAAE,QAAgB,EAAE,EAAE;YACnF,IAAI,CAAC;gBACH,MAAM,KAAK,GAAI,OAAmC,CAAC,KAAK,CAE3C,CAAC;gBACd,IAAI,KAAK,EAAE,CAAC;oBACV,MAAM,IAAI,GAAG,IAAA,yBAAgB,EAAC,OAAO,CAAC,CAAC;oBACvC,MAAM,CAAC,GAAG,KAGT,CAAC;oBACF,IAAA,2BAAkB,EAChB,MAAM,EACN,KAAK,CAAC,IAAI,EACV,IAAI,EACJ;wBACE,UAAU,EAAE,CAAC,CAAC,UAAU;wBACxB,OAAO,EAAE,EAAE,gBAAgB,EAAE,CAAC,CAAC,SAAS,EAAE,CAAC,gBAAgB,CAAC,EAAE;qBAC/D,EACD,KAAK,CAAC,WAAW,EACjB,OAAO,CACR,CAAC;gBACJ,CAAC;YACH,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,UAAU,EAAE,EAAE,MAAM,EAAE,oBAAoB,EAAE,EAAE,CAAC,CAAC;YAC7E,CAAC;YACD,QAAQ,EAAE,CAAC;QACb,CAAC,CAAC,CAAC;QAEH,OAAO,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC,OAAgB,EAAE,MAAe,EAAE,KAAc,EAAE,QAAgB,EAAE,EAAE;YACjG,IAAI,CAAC;gBACH,MAAM,KAAK,GAAI,OAAmC,CAAC,KAAK,CAE3C,CAAC;gBACd,KAAK,EAAE,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;gBACnC,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE;oBACvB,OAAO,EAAE,KAAK;oBACd,UAAU,EAAE,EAAE,MAAM,EAAE,iBAAiB,EAAE;iBAC1C,CAAC,CAAC;YACL,CAAC;YAAC,MAAM,CAAC;gBACP,gCAAgC;YAClC,CAAC;YACD,QAAQ,EAAE,CAAC;QACb,CAAC,CAAC,CAAC;QAEH,IAAI,EAAE,CAAC;IACT,CAAC,CAAC;IAEF,2EAA2E;IAC1E,MAA6C,CAAC,MAAM,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,GAAG,IAAI,CAAC;IACnF,OAAO,MAAM,CAAC;AAChB,CAAC"}