nugi-ts-logs-sdk 1.0.0

package/dist/adapters/nestjs.d.ts

@@ -0,0 +1,93 @@
+import { ArgumentsHost, CallHandler, DynamicModule, ExceptionFilter, ExecutionContext, LoggerService, MiddlewareConsumer, NestInterceptor, NestMiddleware, NestModule, OnModuleDestroy } from '@nestjs/common';
+import { Observable } from 'rxjs';
+import { NugiClient } from '../client';
+import { NugiConfig } from '../config';
+import { HttpAdapterOptions } from './common';
+export declare const NUGI_CLIENT: unique symbol;
+export declare const NUGI_OPTIONS: unique symbol;
+export interface NugiModuleOptions extends NugiConfig {
+    /** HTTP capture options for the request middleware. */
+    http?: HttpAdapterOptions;
+}
+interface RawResponse {
+    statusCode: number;
+    getHeader(name: string): unknown;
+    on(event: string, listener: () => void): unknown;
+}
+type NextFn = (err?: unknown) => void;
+/** Per-request tracking middleware (mounted for all routes by NugiModule). */
+export declare class NugiTrackingMiddleware implements NestMiddleware {
+    private readonly client;
+    private readonly options;
+    constructor(client: NugiClient, options: HttpAdapterOptions);
+    use(req: unknown, res: RawResponse, next: NextFn): void;
+}
+/** Interceptor that records errors thrown by controllers/handlers. */
+export declare class NugiErrorInterceptor implements NestInterceptor {
+    private readonly client;
+    constructor(client: NugiClient);
+    intercept(context: ExecutionContext, next: CallHandler): Observable<unknown>;
+}
+/**
+ * Nest `LoggerService` bridge. Wire it so the framework's own logs — and any
+ * `this.logger.log()` calls — become structured telemetry (and breadcrumbs),
+ * not just stdout:
+ *
+ *   const app = await NestFactory.create(AppModule, { bufferLogs: true });
+ *   app.useLogger(app.get(NugiLoggerService));
+ *
+ * Each entry is emitted at the matching severity with the Nest `context`
+ * (usually the class name) attached. Original console-based logging is
+ * unaffected; when you route Nest through this service, its logs stop hitting
+ * the console-capture path so there's no duplication.
+ */
+export declare class NugiLoggerService implements LoggerService {
+    private readonly client;
+    constructor(client: NugiClient);
+    log(message: unknown, ...rest: unknown[]): void;
+    error(message: unknown, ...rest: unknown[]): void;
+    warn(message: unknown, ...rest: unknown[]): void;
+    debug(message: unknown, ...rest: unknown[]): void;
+    verbose(message: unknown, ...rest: unknown[]): void;
+    private emit;
+}
+/**
+ * Global exception filter that records unhandled exceptions (Sentry-style) and
+ * still returns a correct HTTP error response. Opt-in — register it yourself so
+ * it can't interfere with an existing filter chain:
+ *
+ *   app.useGlobalFilters(new NugiExceptionFilter(app.get(NUGI_CLIENT)));
+ *
+ * By default only server-side failures are captured (non-HttpException, or 5xx);
+ * expected 4xx client errors are answered but not reported. Set
+ * `captureClientErrors: true` to report those too. Response writing is
+ * feature-detected so it works on both Express and Fastify.
+ */
+export declare class NugiExceptionFilter implements ExceptionFilter {
+    private readonly client;
+    private readonly options;
+    constructor(client: NugiClient, options?: {
+        captureClientErrors?: boolean;
+    });
+    catch(exception: unknown, host: ArgumentsHost): void;
+}
+/**
+ * Root observability module.
+ *
+ *   @Module({ imports: [NugiModule.forRoot({ apiKey, appId, endpoint })] })
+ *   export class AppModule {}
+ *
+ * Provides and exports the NUGI_CLIENT token so services can inject the client
+ * to emit custom logs/metrics/spans. Flushes on application shutdown.
+ */
+export declare class NugiModule implements NestModule, OnModuleDestroy {
+    private readonly client;
+    constructor(client: NugiClient);
+    configure(consumer: MiddlewareConsumer): void;
+    onModuleDestroy(): Promise<void>;
+    static forRoot(options: NugiModuleOptions): DynamicModule;
+    /** Register an already-constructed client (e.g. shared across modules). */
+    static forClient(client: NugiClient, http?: HttpAdapterOptions): DynamicModule;
+}
+export {};
+//# sourceMappingURL=nestjs.d.ts.map

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

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

package/dist/adapters/nestjs.js

@@ -0,0 +1,310 @@
+"use strict";
+// NestJS integration: a dynamic module that provides a shared NugiClient plus
+// request-tracking middleware and an error-tracking interceptor. Works on both
+// the Express and Fastify platform adapters (middleware receives raw req/res).
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+var NugiModule_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NugiModule = exports.NugiExceptionFilter = exports.NugiLoggerService = exports.NugiErrorInterceptor = exports.NugiTrackingMiddleware = exports.NUGI_OPTIONS = exports.NUGI_CLIENT = void 0;
+const common_1 = require("@nestjs/common");
+const operators_1 = require("rxjs/operators");
+const client_1 = require("../client");
+const context_1 = require("../internal/context");
+const sanitize_1 = require("../internal/sanitize");
+const common_2 = require("./common");
+/**
+ * Build a rich, sanitized request-context object to attach to an error so the
+ * Errors view can show exactly which request (and payload) triggered it.
+ * Returns `{ request: {...} }` ready to spread into trackError attributes.
+ */
+function requestContextFrom(req) {
+    if (!req)
+        return {};
+    try {
+        const info = (0, common_2.normalizeRequest)(req);
+        const r = req;
+        return {
+            request: {
+                method: info.method,
+                url: info.url,
+                path: info.route || info.path,
+                query: r?.query,
+                params: r?.params,
+                body: (0, sanitize_1.sanitizeBody)(info.body),
+                headers: (0, sanitize_1.sanitizeHeaders)(info.headers),
+                ip: info.ip,
+                userAgent: info.userAgent,
+                userId: info.userId,
+            },
+        };
+    }
+    catch {
+        return {};
+    }
+}
+exports.NUGI_CLIENT = Symbol('NUGI_CLIENT');
+exports.NUGI_OPTIONS = Symbol('NUGI_OPTIONS');
+/** Per-request tracking middleware (mounted for all routes by NugiModule). */
+let NugiTrackingMiddleware = class NugiTrackingMiddleware {
+    constructor(client, options) {
+        this.client = client;
+        this.options = options;
+    }
+    use(req, res, next) {
+        let ran = false;
+        try {
+            const info = (0, common_2.normalizeRequest)(req);
+            if (this.options.ignore?.(info)) {
+                next();
+                return;
+            }
+            const startedAtMs = Date.now();
+            const span = (0, common_2.startServerSpan)(this.client, info, this.options);
+            res.on('finish', () => {
+                const finalInfo = (0, common_2.normalizeRequest)(req);
+                (0, common_2.completeServerSpan)(this.client, span, finalInfo, {
+                    statusCode: res.statusCode,
+                    headers: { 'content-length': res.getHeader('content-length') },
+                }, startedAtMs, this.options);
+            });
+            ran = true;
+            (0, context_1.runWithContext)({ span: span.context() }, () => next());
+        }
+        catch (error) {
+            this.client.trackError(error, { attributes: { source: 'nest.middleware' } });
+            if (!ran)
+                next();
+        }
+    }
+};
+exports.NugiTrackingMiddleware = NugiTrackingMiddleware;
+exports.NugiTrackingMiddleware = NugiTrackingMiddleware = __decorate([
+    (0, common_1.Injectable)(),
+    __param(0, (0, common_1.Inject)(exports.NUGI_CLIENT)),
+    __param(1, (0, common_1.Inject)(exports.NUGI_OPTIONS)),
+    __metadata("design:paramtypes", [client_1.NugiClient, Object])
+], NugiTrackingMiddleware);
+/** Interceptor that records errors thrown by controllers/handlers. */
+let NugiErrorInterceptor = class NugiErrorInterceptor {
+    constructor(client) {
+        this.client = client;
+    }
+    intercept(context, next) {
+        // Snapshot the request now so we can attach it if the handler throws.
+        const req = context.getType() === 'http' ? context.switchToHttp().getRequest() : undefined;
+        return next.handle().pipe((0, operators_1.tap)({
+            error: (error) => {
+                this.client.trackError(error, {
+                    handled: false,
+                    attributes: { source: 'nest.interceptor', ...requestContextFrom(req) },
+                });
+            },
+        }));
+    }
+};
+exports.NugiErrorInterceptor = NugiErrorInterceptor;
+exports.NugiErrorInterceptor = NugiErrorInterceptor = __decorate([
+    (0, common_1.Injectable)(),
+    __param(0, (0, common_1.Inject)(exports.NUGI_CLIENT)),
+    __metadata("design:paramtypes", [client_1.NugiClient])
+], NugiErrorInterceptor);
+/**
+ * Nest `LoggerService` bridge. Wire it so the framework's own logs — and any
+ * `this.logger.log()` calls — become structured telemetry (and breadcrumbs),
+ * not just stdout:
+ *
+ *   const app = await NestFactory.create(AppModule, { bufferLogs: true });
+ *   app.useLogger(app.get(NugiLoggerService));
+ *
+ * Each entry is emitted at the matching severity with the Nest `context`
+ * (usually the class name) attached. Original console-based logging is
+ * unaffected; when you route Nest through this service, its logs stop hitting
+ * the console-capture path so there's no duplication.
+ */
+let NugiLoggerService = class NugiLoggerService {
+    constructor(client) {
+        this.client = client;
+    }
+    log(message, ...rest) {
+        this.emit('info', message, rest);
+    }
+    error(message, ...rest) {
+        // Nest passes (message, stack?, context?) for errors.
+        const stack = typeof rest[0] === 'string' ? rest[0] : undefined;
+        this.emit('error', message, rest, stack);
+    }
+    warn(message, ...rest) {
+        this.emit('warn', message, rest);
+    }
+    debug(message, ...rest) {
+        this.emit('debug', message, rest);
+    }
+    verbose(message, ...rest) {
+        this.emit('debug', message, rest);
+    }
+    emit(level, message, rest, stack) {
+        try {
+            // The trailing string arg is Nest's context (the source class name).
+            const context = rest.length > 0 && typeof rest[rest.length - 1] === 'string'
+                ? rest[rest.length - 1]
+                : undefined;
+            const attributes = { origin: 'nest.logger' };
+            if (context)
+                attributes.context = context;
+            if (stack && stack !== context)
+                attributes.stack = stack;
+            this.client.logger.log(level, formatMessage(message), attributes);
+        }
+        catch {
+            /* logging must never throw into the framework */
+        }
+    }
+};
+exports.NugiLoggerService = NugiLoggerService;
+exports.NugiLoggerService = NugiLoggerService = __decorate([
+    (0, common_1.Injectable)(),
+    __param(0, (0, common_1.Inject)(exports.NUGI_CLIENT)),
+    __metadata("design:paramtypes", [client_1.NugiClient])
+], NugiLoggerService);
+function formatMessage(message) {
+    if (typeof message === 'string')
+        return message;
+    if (message instanceof Error)
+        return `${message.name}: ${message.message}`;
+    try {
+        return JSON.stringify(message);
+    }
+    catch {
+        return String(message);
+    }
+}
+/**
+ * Global exception filter that records unhandled exceptions (Sentry-style) and
+ * still returns a correct HTTP error response. Opt-in — register it yourself so
+ * it can't interfere with an existing filter chain:
+ *
+ *   app.useGlobalFilters(new NugiExceptionFilter(app.get(NUGI_CLIENT)));
+ *
+ * By default only server-side failures are captured (non-HttpException, or 5xx);
+ * expected 4xx client errors are answered but not reported. Set
+ * `captureClientErrors: true` to report those too. Response writing is
+ * feature-detected so it works on both Express and Fastify.
+ */
+let NugiExceptionFilter = class NugiExceptionFilter {
+    constructor(client, options = {}) {
+        this.client = client;
+        this.options = options;
+    }
+    catch(exception, host) {
+        const isHttp = exception instanceof common_1.HttpException;
+        const status = isHttp ? exception.getStatus() : 500;
+        const shouldCapture = !isHttp || status >= 500 || this.options.captureClientErrors === true;
+        if (shouldCapture) {
+            try {
+                const req = host.getType() === 'http' ? host.switchToHttp().getRequest() : undefined;
+                this.client.trackError(exception, {
+                    handled: false,
+                    attributes: { source: 'nest.exceptionFilter', statusCode: status, ...requestContextFrom(req) },
+                });
+            }
+            catch {
+                /* never let capture break error handling */
+            }
+        }
+        // Only HTTP contexts have a response to write; leave others to Nest.
+        if (host.getType() !== 'http')
+            return;
+        try {
+            const response = host.switchToHttp().getResponse();
+            const payload = isHttp
+                ? exception.getResponse()
+                : { statusCode: status, message: 'Internal server error' };
+            if (response && typeof response.status === 'function') {
+                const withStatus = response.status(status);
+                if (withStatus && typeof withStatus.json === 'function') {
+                    withStatus.json(payload); // Express
+                }
+                else if (withStatus && typeof withStatus.send === 'function') {
+                    withStatus.send(payload); // Fastify
+                }
+            }
+        }
+        catch {
+            /* if we can't write the response, don't mask the original error */
+        }
+    }
+};
+exports.NugiExceptionFilter = NugiExceptionFilter;
+exports.NugiExceptionFilter = NugiExceptionFilter = __decorate([
+    (0, common_1.Catch)(),
+    __metadata("design:paramtypes", [client_1.NugiClient, Object])
+], NugiExceptionFilter);
+/**
+ * Root observability module.
+ *
+ *   @Module({ imports: [NugiModule.forRoot({ apiKey, appId, endpoint })] })
+ *   export class AppModule {}
+ *
+ * Provides and exports the NUGI_CLIENT token so services can inject the client
+ * to emit custom logs/metrics/spans. Flushes on application shutdown.
+ */
+let NugiModule = NugiModule_1 = class NugiModule {
+    constructor(client) {
+        this.client = client;
+    }
+    configure(consumer) {
+        consumer.apply(NugiTrackingMiddleware).forRoutes('*');
+    }
+    async onModuleDestroy() {
+        await this.client.shutdown();
+    }
+    static forRoot(options) {
+        const { http, ...config } = options;
+        const client = new client_1.NugiClient(config);
+        return {
+            module: NugiModule_1,
+            global: true,
+            providers: [
+                { provide: exports.NUGI_CLIENT, useValue: client },
+                { provide: exports.NUGI_OPTIONS, useValue: http ?? {} },
+                NugiTrackingMiddleware,
+                NugiErrorInterceptor,
+                NugiLoggerService,
+            ],
+            exports: [exports.NUGI_CLIENT, NugiErrorInterceptor, NugiLoggerService],
+        };
+    }
+    /** Register an already-constructed client (e.g. shared across modules). */
+    static forClient(client, http = {}) {
+        return {
+            module: NugiModule_1,
+            global: true,
+            providers: [
+                { provide: exports.NUGI_CLIENT, useValue: client },
+                { provide: exports.NUGI_OPTIONS, useValue: http },
+                NugiTrackingMiddleware,
+                NugiErrorInterceptor,
+                NugiLoggerService,
+            ],
+            exports: [exports.NUGI_CLIENT, NugiErrorInterceptor, NugiLoggerService],
+        };
+    }
+};
+exports.NugiModule = NugiModule;
+exports.NugiModule = NugiModule = NugiModule_1 = __decorate([
+    (0, common_1.Module)({}),
+    __param(0, (0, common_1.Inject)(exports.NUGI_CLIENT)),
+    __metadata("design:paramtypes", [client_1.NugiClient])
+], NugiModule);
+//# sourceMappingURL=nestjs.js.map

package/dist/adapters/nestjs.js.map

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

package/dist/client.d.ts

@@ -0,0 +1,66 @@
+import { NugiConfig, ResolvedConfig } from './config';
+import { Attributes, Resource } from './types';
+import { Logger } from './signals/logger';
+import { Metrics } from './signals/metrics';
+import { Tracer } from './signals/tracer';
+import { Checkins } from './signals/checkins';
+import { type NormalizedDbError } from './instrumentation/db-error';
+export interface TrackErrorOptions {
+    handled?: boolean;
+    attributes?: Attributes;
+    code?: string | number;
+}
+/**
+ * The SDK entry point. Owns configuration, the batching transport pipeline and
+ * the signals (logs, metrics, traces, check-ins, query capture). Construction
+ * never throws beyond config validation; all runtime paths are fault-tolerant.
+ */
+export declare class NugiClient {
+    readonly config: ResolvedConfig;
+    readonly resource: Resource;
+    readonly logger: Logger;
+    readonly metrics: Metrics;
+    readonly tracer: Tracer;
+    readonly checkins: Checkins;
+    private readonly diagnostics;
+    private readonly transport;
+    private readonly batcher;
+    private readonly legacyLogs;
+    private readonly breadcrumbs;
+    private readonly consoleCapture?;
+    private readonly exitHandler?;
+    private readonly uncaughtHandler?;
+    private readonly rejectionHandler?;
+    private stopQueryCapture?;
+    private shuttingDown;
+    constructor(config: NugiConfig);
+    /**
+     * Wrap a PrismaClient so every operation is captured. Returns the extended client.
+     * Only needed when using Prisma (driver patches do not cover it).
+     */
+    wrapPrisma<T extends {
+        $extends: Function;
+    }>(prisma: T): T;
+    /** Manually record a DB query (when auto-capture is off or for custom drivers). */
+    logQuery(query: string, durationMs: number, extra?: {
+        orm?: string;
+        success?: boolean;
+        error?: string;
+        requestId?: string;
+        dbError?: NormalizedDbError;
+        cause?: unknown;
+    }): void;
+    /** Record an error/exception as a first-class telemetry event. */
+    trackError(error: unknown, options?: TrackErrorOptions): void;
+    /** Force a flush of buffered telemetry. Never rejects. */
+    flush(): Promise<void>;
+    /** Flush and tear down timers/handlers. Idempotent. Never rejects. */
+    shutdown(): Promise<void>;
+    /** Number of buffered (not-yet-sent) events. */
+    get bufferSize(): number;
+    private captureQuery;
+    private emit;
+}
+/** Convenience factory mirroring common SDK ergonomics. */
+export declare function createClient(config: NugiConfig): NugiClient;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAiB,cAAc,EAAE,MAAM,UAAU,CAAC;AACrE,OAAO,EACL,UAAU,EAGV,QAAQ,EAET,MAAM,SAAS,CAAC;AAMjB,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC5C,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAU9C,OAAO,EAEL,KAAK,iBAAiB,EACvB,MAAM,4BAA4B,CAAC;AAEpC,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CACxB;AAED;;;;GAIG;AACH,qBAAa,UAAU;IACrB,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAE5B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAc;IAC1C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAY;IACtC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;IAClC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAsB;IACjD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAmB;IAC/C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAiB;IACjD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAa;IAC1C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAyB;IAC1D,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAA4B;IAC9D,OAAO,CAAC,gBAAgB,CAAC,CAAa;IACtC,OAAO,CAAC,YAAY,CAAS;gBAEjB,MAAM,EAAE,UAAU;IAgF9B;;;OAGG;IACH,UAAU,CAAC,CAAC,SAAS;QAAE,QAAQ,EAAE,QAAQ,CAAA;KAAE,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC;IAI1D,mFAAmF;IACnF,QAAQ,CACN,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,EAClB,KAAK,CAAC,EAAE;QACN,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,OAAO,CAAC,EAAE,iBAAiB,CAAC;QAC5B,KAAK,CAAC,EAAE,OAAO,CAAC;KACjB,GACA,IAAI;IAaP,kEAAkE;IAClE,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,GAAE,iBAAsB,GAAG,IAAI;IAqCjE,0DAA0D;IACpD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B,sEAAsE;IAChE,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAuB/B,gDAAgD;IAChD,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED,OAAO,CAAC,YAAY;IA2GpB,OAAO,CAAC,IAAI;CAQb;AAED,2DAA2D;AAC3D,wBAAgB,YAAY,CAAC,MAAM,EAAE,UAAU,GAAG,UAAU,CAE3D"}