@pawells/nestjs-shared 1.0.0-dev.3052c75

package/build/common/interceptors/http-instrumentation.interceptor.js

@@ -0,0 +1,148 @@
+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);
+};
+import { Injectable, HttpException, } from '@nestjs/common';
+import { ModuleRef } from '@nestjs/core';
+import { throwError } from 'rxjs';
+import { tap, catchError } from 'rxjs/operators';
+import { performance } from 'node:perf_hooks';
+import { InstrumentationRegistry } from '../registry/instrumentation-registry.js';
+/**
+ * HTTP Instrumentation Interceptor
+ *
+ * Backend-agnostic HTTP request metrics collection using InstrumentationRegistry.
+ * Records request duration, status code, and request size for all HTTP requests.
+ * Skips metrics collection for non-HTTP contexts (GraphQL, WebSocket, RPC, etc.).
+ *
+ * Metrics recorded:
+ * - `http_request_duration_seconds` — Request duration in seconds (histogram)
+ * - `http_requests_total` — Total HTTP requests (counter)
+ * - `http_request_size_bytes` — Request body size in bytes (histogram, when available)
+ *
+ * @injectable
+ *
+ * @example
+ * ```typescript
+ * // Register in your module
+ * @Module({
+ *   providers: [HTTPInstrumentationInterceptor],
+ * })
+ * export class MyModule {}
+ *
+ * // Apply globally in main.ts
+ * app.useGlobalInterceptors(app.get(HTTPInstrumentationInterceptor));
+ * ```
+ */
+let HTTPInstrumentationInterceptor = class HTTPInstrumentationInterceptor {
+    Module;
+    constructor(module) {
+        this.Module = module;
+    }
+    get Registry() {
+        return this.Module.get(InstrumentationRegistry);
+    }
+    /**
+     * Intercept HTTP requests and record instrumentation metrics.
+     * Records request duration, status code, and content length.
+     * Skips metrics collection for non-HTTP contexts.
+     *
+     * @param context - The execution context containing request/response
+     * @param next - The next handler in the chain
+     * @returns Observable of the response
+     */
+    intercept(context, next) {
+        // Skip metrics for non-HTTP contexts (GraphQL, WebSocket, RPC, etc.)
+        if (context.getType() !== 'http') {
+            return next.handle();
+        }
+        const request = context.switchToHttp().getRequest();
+        const response = context.switchToHttp().getResponse();
+        const start = performance.now();
+        const { method } = request;
+        const contentLength = this.getContentLength(request);
+        const millisecondsPerSecond = 1000;
+        return next.handle().pipe(tap(() => {
+            const route = this.getRoute(request);
+            const statusCode = String(response.statusCode);
+            const duration = (performance.now() - start) / millisecondsPerSecond; // Convert to seconds
+            this.Registry.recordMetric('http_request_duration_seconds', duration, {
+                method,
+                route,
+                status_code: statusCode,
+            });
+            this.Registry.recordMetric('http_requests_total', 1, {
+                method,
+                route,
+                status_code: statusCode,
+            });
+            if (contentLength !== undefined) {
+                this.Registry.recordMetric('http_request_size_bytes', contentLength, {
+                    method,
+                    route,
+                });
+            }
+        }), catchError((err) => {
+            const route = this.getRoute(request);
+            const statusCode = err instanceof HttpException
+                ? String(err.getStatus())
+                : '500';
+            const duration = (performance.now() - start) / millisecondsPerSecond; // Convert to seconds
+            this.Registry.recordMetric('http_request_duration_seconds', duration, {
+                method,
+                route,
+                status_code: statusCode,
+            });
+            this.Registry.recordMetric('http_requests_total', 1, {
+                method,
+                route,
+                status_code: statusCode,
+            });
+            return throwError(() => err);
+        }));
+    }
+    /**
+     * Extract route path from request
+     * Tries to get the route from Express first, then falls back to URL path
+     *
+     * @private
+     * @param request - The Express request object
+     * @returns The route path or fallback value
+     */
+    getRoute(request) {
+        // Try to get route from Express
+        const { route } = request;
+        if (route?.path) {
+            return route.path;
+        }
+        // Fallback to URL path
+        return request.path || request.url || '/unknown';
+    }
+    /**
+     * Get request content length from headers
+     * Parses the content-length header and returns it as a number
+     *
+     * @private
+     * @param request - The Express request object
+     * @returns The content length in bytes, or undefined if not available
+     */
+    getContentLength(request) {
+        const contentLength = request.headers['content-length'];
+        if (contentLength) {
+            const length = parseInt(contentLength, 10);
+            return isNaN(length) ? undefined : length;
+        }
+        return undefined;
+    }
+};
+HTTPInstrumentationInterceptor = __decorate([
+    Injectable(),
+    __metadata("design:paramtypes", [ModuleRef])
+], HTTPInstrumentationInterceptor);
+export { HTTPInstrumentationInterceptor };
+//# sourceMappingURL=http-instrumentation.interceptor.js.map

package/build/common/interceptors/http-instrumentation.interceptor.js.map

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

package/build/common/interceptors/http-metrics.interceptor.d.ts

@@ -0,0 +1,46 @@
+import { NestInterceptor, ExecutionContext, CallHandler } from '@nestjs/common';
+import { ModuleRef } from '@nestjs/core';
+import { Observable } from 'rxjs';
+import { LazyModuleRefService } from '../utils/lazy-getter.types.js';
+/**
+ * HTTP Metrics Interceptor.
+ * Automatically collects and records HTTP request metrics for Prometheus.
+ *
+ * Metrics collected:
+ * - Request duration histogram (in seconds)
+ * - Request count counter (total requests)
+ * - Request size histogram (in bytes)
+ *
+ * Labels for all metrics:
+ * - method: HTTP method (GET, POST, etc.)
+ * - route: URL path (normalized to collapse dynamic segments like UUIDs)
+ * - status_code: HTTP status code
+ * - status_class: Status class (2xx, 4xx, 5xx)
+ *
+ * @remarks
+ * - Skips non-HTTP contexts (GraphQL, WebSocket, RPC, etc.)
+ * - Normalizes dynamic path segments (UUIDs, ObjectIDs, numeric IDs) to :id to prevent unbounded cardinality
+ * - Records metrics even when requests fail or throw errors
+ */
+export declare class HTTPMetricsInterceptor implements NestInterceptor, LazyModuleRefService {
+    readonly Module: ModuleRef;
+    constructor(module: ModuleRef);
+    private get MetricsService();
+    intercept(context: ExecutionContext, next: CallHandler): Observable<any>;
+    /**
+     * Extract route path from request.
+     * Prefers the Express route pattern (e.g., /users/:id) over the raw URL path
+     * to prevent unbounded metric cardinality from dynamic path parameters.
+     */
+    private getRoute;
+    /**
+     * Normalize a URL path by replacing dynamic segments (UUIDs, ObjectIDs, numeric IDs)
+     * with placeholder tokens to prevent unbounded metric cardinality.
+     */
+    private normalizePath;
+    /**
+     * Get request content length
+     */
+    private getContentLength;
+}
+//# sourceMappingURL=http-metrics.interceptor.d.ts.map

package/build/common/interceptors/http-metrics.interceptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-metrics.interceptor.d.ts","sourceRoot":"","sources":["../../../src/common/interceptors/http-metrics.interceptor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,eAAe,EAAE,gBAAgB,EAAE,WAAW,EAAiB,MAAM,gBAAgB,CAAC;AAC3G,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,UAAU,EAAc,MAAM,MAAM,CAAC;AAI9C,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAIrE;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,qBACa,sBAAuB,YAAW,eAAe,EAAE,oBAAoB;IACnF,SAAgB,MAAM,EAAE,SAAS,CAAC;gBAEtB,MAAM,EAAE,SAAS;IAI7B,OAAO,KAAK,cAAc,GAEzB;IAEM,SAAS,CAAC,OAAO,EAAE,gBAAgB,EAAE,IAAI,EAAE,WAAW,GAAG,UAAU,CAAC,GAAG,CAAC;IAyC/E;;;;OAIG;IACH,OAAO,CAAC,QAAQ;IAahB;;;OAGG;IACH,OAAO,CAAC,aAAa;IAUrB;;OAEG;IACH,OAAO,CAAC,gBAAgB;CAQxB"}

package/build/common/interceptors/http-metrics.interceptor.js

@@ -0,0 +1,120 @@
+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);
+};
+import { Injectable, HttpException } from '@nestjs/common';
+import { ModuleRef } from '@nestjs/core';
+import { throwError } from 'rxjs';
+import { tap, catchError } from 'rxjs/operators';
+import { MetricsRegistryService } from '../services/metrics-registry.service.js';
+const DEFAULT_ERROR_STATUS_CODE = 500;
+/**
+ * HTTP Metrics Interceptor.
+ * Automatically collects and records HTTP request metrics for Prometheus.
+ *
+ * Metrics collected:
+ * - Request duration histogram (in seconds)
+ * - Request count counter (total requests)
+ * - Request size histogram (in bytes)
+ *
+ * Labels for all metrics:
+ * - method: HTTP method (GET, POST, etc.)
+ * - route: URL path (normalized to collapse dynamic segments like UUIDs)
+ * - status_code: HTTP status code
+ * - status_class: Status class (2xx, 4xx, 5xx)
+ *
+ * @remarks
+ * - Skips non-HTTP contexts (GraphQL, WebSocket, RPC, etc.)
+ * - Normalizes dynamic path segments (UUIDs, ObjectIDs, numeric IDs) to :id to prevent unbounded cardinality
+ * - Records metrics even when requests fail or throw errors
+ */
+let HTTPMetricsInterceptor = class HTTPMetricsInterceptor {
+    Module;
+    constructor(module) {
+        this.Module = module;
+    }
+    get MetricsService() {
+        return this.Module.get(MetricsRegistryService);
+    }
+    intercept(context, next) {
+        // Skip metrics for non-HTTP contexts (GraphQL, WebSocket, RPC, etc.)
+        if (context.getType() !== 'http') {
+            return next.handle();
+        }
+        const request = context.switchToHttp().getRequest();
+        const response = context.switchToHttp().getResponse();
+        // Additional safety check for request object
+        if (!request?.method) {
+            return next.handle();
+        }
+        const startTime = Date.now();
+        // Extract route information
+        const { method } = request;
+        const route = this.getRoute(request);
+        return next.handle().pipe(tap(() => {
+            const duration = Date.now() - startTime;
+            const contentLength = this.getContentLength(request);
+            const statusCode = response.statusCode ?? DEFAULT_ERROR_STATUS_CODE;
+            // Record metrics
+            this.MetricsService.recordHttpRequest(method, route, statusCode, duration, contentLength);
+        }), catchError((error) => {
+            const duration = Date.now() - startTime;
+            const contentLength = this.getContentLength(request);
+            const statusCode = (error instanceof HttpException ? error.getStatus() : undefined) ?? response.statusCode ?? DEFAULT_ERROR_STATUS_CODE;
+            // Record metrics even on error (use status code from HttpException if available, then response, then default)
+            this.MetricsService.recordHttpRequest(method, route, statusCode, duration, contentLength);
+            return throwError(() => error);
+        }));
+    }
+    /**
+     * Extract route path from request.
+     * Prefers the Express route pattern (e.g., /users/:id) over the raw URL path
+     * to prevent unbounded metric cardinality from dynamic path parameters.
+     */
+    getRoute(request) {
+        // Try to get route pattern from Express (e.g., /users/:id instead of /users/123)
+        const { route } = request;
+        if (route?.path) {
+            return route.path;
+        }
+        // Fallback: normalize the path to collapse UUIDs, ObjectIDs, and numeric IDs
+        // to prevent unbounded metric label cardinality
+        const rawPath = request.path || request.url || '/unknown';
+        return this.normalizePath(rawPath);
+    }
+    /**
+     * Normalize a URL path by replacing dynamic segments (UUIDs, ObjectIDs, numeric IDs)
+     * with placeholder tokens to prevent unbounded metric cardinality.
+     */
+    normalizePath(path) {
+        return path
+            // Replace UUIDs (v1-v5)
+            .replace(/[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}/gi, ':id')
+            // Replace MongoDB ObjectIDs (24 hex chars)
+            .replace(/\/[0-9a-f]{24}(?=\/|$)/gi, '/:id')
+            // Replace purely numeric path segments
+            .replace(/\/\d+(?=\/|$)/g, '/:id');
+    }
+    /**
+     * Get request content length
+     */
+    getContentLength(request) {
+        const contentLength = request.headers['content-length'];
+        if (contentLength) {
+            const length = parseInt(contentLength, 10);
+            return isNaN(length) ? undefined : length;
+        }
+        return undefined;
+    }
+};
+HTTPMetricsInterceptor = __decorate([
+    Injectable(),
+    __metadata("design:paramtypes", [ModuleRef])
+], HTTPMetricsInterceptor);
+export { HTTPMetricsInterceptor };
+//# sourceMappingURL=http-metrics.interceptor.js.map

package/build/common/interceptors/http-metrics.interceptor.js.map

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

package/build/common/interceptors/logging.interceptor.d.ts

@@ -0,0 +1,22 @@
+import { NestInterceptor, ExecutionContext, CallHandler } from '@nestjs/common';
+import { ModuleRef } from '@nestjs/core';
+import { Observable } from 'rxjs';
+import { LazyModuleRefService } from '../utils/lazy-getter.types.js';
+/**
+ * Logging Interceptor.
+ * Logs incoming HTTP requests and outgoing responses with timing information.
+ * Uses DEBUG level for health/metrics endpoints to reduce noise.
+ * Automatically logs request details: method, URL, IP address, and response time.
+ *
+ * @remarks
+ * - Skips logging for non-HTTP contexts (GraphQL, WebSocket, etc.)
+ * - Uses DEBUG level for /health and /metrics endpoints
+ * - Uses INFO level for other requests
+ */
+export declare class LoggingInterceptor implements NestInterceptor, LazyModuleRefService {
+    readonly Module: ModuleRef;
+    constructor(module: ModuleRef);
+    private get Logger();
+    intercept(context: ExecutionContext, next: CallHandler): Observable<any>;
+}
+//# sourceMappingURL=logging.interceptor.d.ts.map

package/build/common/interceptors/logging.interceptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logging.interceptor.d.ts","sourceRoot":"","sources":["../../../src/common/interceptors/logging.interceptor.ts"],"names":[],"mappings":"AAAA,OAAO,EAEN,eAAe,EACf,gBAAgB,EAChB,WAAW,EACX,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,UAAU,EAAc,MAAM,MAAM,CAAC;AAI9C,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAIrE;;;;;;;;;;GAUG;AACH,qBACa,kBAAmB,YAAW,eAAe,EAAE,oBAAoB;IAC/E,SAAgB,MAAM,EAAE,SAAS,CAAC;gBAEtB,MAAM,EAAE,SAAS;IAI7B,OAAO,KAAK,MAAM,GAEjB;IAEM,SAAS,CAAC,OAAO,EAAE,gBAAgB,EAAE,IAAI,EAAE,WAAW,GAAG,UAAU,CAAC,GAAG,CAAC;CAwC/E"}

package/build/common/interceptors/logging.interceptor.js

@@ -0,0 +1,67 @@
+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);
+};
+import { Injectable, } from '@nestjs/common';
+import { ModuleRef } from '@nestjs/core';
+import { throwError } from 'rxjs';
+import { tap, catchError } from 'rxjs/operators';
+import { AppLogger } from '../services/logger.service.js';
+import { escapeNewlines } from '../utils/sanitization.utils.js';
+import { getErrorMessage } from '../utils/error.utils.js';
+/**
+ * Logging Interceptor.
+ * Logs incoming HTTP requests and outgoing responses with timing information.
+ * Uses DEBUG level for health/metrics endpoints to reduce noise.
+ * Automatically logs request details: method, URL, IP address, and response time.
+ *
+ * @remarks
+ * - Skips logging for non-HTTP contexts (GraphQL, WebSocket, etc.)
+ * - Uses DEBUG level for /health and /metrics endpoints
+ * - Uses INFO level for other requests
+ */
+let LoggingInterceptor = class LoggingInterceptor {
+    Module;
+    constructor(module) {
+        this.Module = module;
+    }
+    get Logger() {
+        return this.Module.get(AppLogger);
+    }
+    intercept(context, next) {
+        // Skip logging for non-HTTP contexts (e.g., GraphQL)
+        if (context.getType() !== 'http') {
+            return next.handle();
+        }
+        const request = context.switchToHttp().getRequest();
+        const { method, url, ip } = request;
+        const startTime = Date.now();
+        // Use DEBUG level for health checks and metrics endpoints to reduce noise
+        const isHealthOrMetrics = url.includes('/health') || url.includes('/metrics');
+        // Note: Dynamic profiling tags are not supported by @pyroscope/nodejs
+        // Use static tags in config during initialization instead
+        const logFn = isHealthOrMetrics ? this.Logger.debug.bind(this.Logger) : this.Logger.info.bind(this.Logger);
+        logFn(`Incoming request: ${escapeNewlines(method)} ${escapeNewlines(url)} from ${escapeNewlines(ip ?? 'unknown')}`, 'LoggingInterceptor');
+        return next.handle().pipe(tap(() => {
+            const duration = Date.now() - startTime;
+            const response = context.switchToHttp().getResponse();
+            const { statusCode } = response;
+            logFn(`Request completed: ${escapeNewlines(method)} ${escapeNewlines(url)} - ${statusCode} - ${duration}ms`, 'LoggingInterceptor');
+        }), catchError((error) => {
+            const duration = Date.now() - startTime;
+            this.Logger.error(`Request failed: ${escapeNewlines(method)} ${escapeNewlines(url)} - ${duration}ms - ${getErrorMessage(error)}`, 'LoggingInterceptor');
+            return throwError(() => error);
+        }));
+    }
+};
+LoggingInterceptor = __decorate([
+    Injectable(),
+    __metadata("design:paramtypes", [ModuleRef])
+], LoggingInterceptor);
+export { LoggingInterceptor };
+//# sourceMappingURL=logging.interceptor.js.map

package/build/common/interceptors/logging.interceptor.js.map

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

package/build/common/interfaces/cache-provider.interface.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Cache provider interface for token blacklisting and caching
+ * Decouples auth module from specific cache implementations (Redis, memory, etc)
+ *
+ * This interface allows auth module to work with any cache backend
+ * without creating circular dependencies with GraphQL module
+ */
+export interface ICacheProvider {
+    /**
+     * Set a cache value with optional TTL
+     * @param key Cache key
+     * @param value Value to cache
+     * @param ttlSeconds Time-to-live in seconds (optional)
+     */
+    set(key: string, value: any, ttlSeconds?: number): Promise<void>;
+    /**
+     * Get a cache value
+     * @param key Cache key
+     * @returns Cached value or null if not found
+     */
+    get(key: string): Promise<any>;
+    /**
+     * Check if a key exists in cache
+     * @param key Cache key
+     * @returns True if key exists
+     */
+    exists(key: string): Promise<boolean>;
+    /**
+     * Delete a cache value
+     * @param key Cache key
+     */
+    del(key: string): Promise<void>;
+    /**
+     * Clear all cache values
+     */
+    clear(): Promise<void>;
+    /**
+     * Execute an atomic script/command (e.g. Redis Lua script) on the cache backend.
+     * This is optional — implementations backed by Redis should provide it;
+     * in-memory or other backends may leave it undefined.
+     *
+     * @param script The script to execute (Lua for Redis)
+     * @param keys Array of cache keys the script operates on
+     * @param args Array of string arguments passed to the script
+     * @returns The result from the script execution
+     */
+    executeScript?(script: string, keys: readonly string[], args: readonly string[]): Promise<unknown>;
+}
+/**
+ * Token for injecting cache provider
+ * Used in AuthModule and services that need caching
+ */
+export declare const CACHE_PROVIDER: unique symbol;
+//# sourceMappingURL=cache-provider.interface.d.ts.map

package/build/common/interfaces/cache-provider.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-provider.interface.d.ts","sourceRoot":"","sources":["../../../src/common/interfaces/cache-provider.interface.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,WAAW,cAAc;IAC9B;;;;;OAKG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjE;;;;OAIG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAE/B;;;;OAIG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEtC;;;OAGG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEhC;;OAEG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvB;;;;;;;;;OASG;IACH,aAAa,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACnG;AAED;;;GAGG;AACH,eAAO,MAAM,cAAc,eAA2B,CAAC"}

package/build/common/interfaces/cache-provider.interface.js

@@ -0,0 +1,6 @@
+/**
+ * Token for injecting cache provider
+ * Used in AuthModule and services that need caching
+ */
+export const CACHE_PROVIDER = Symbol('CACHE_PROVIDER');
+//# sourceMappingURL=cache-provider.interface.js.map

package/build/common/interfaces/cache-provider.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-provider.interface.js","sourceRoot":"","sources":["../../../src/common/interfaces/cache-provider.interface.ts"],"names":[],"mappings":"AAsDA;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,MAAM,CAAC,gBAAgB,CAAC,CAAC"}

package/build/common/interfaces/index.d.ts

@@ -0,0 +1,7 @@
+export type { LogContext } from './log-context.interface.js';
+export type { ILogger, IContextualLogger } from './logger.interface.js';
+export type { LogEntry, LogMetadata } from './log-entry.interface.js';
+export { LogLevel, LOG_LEVEL_STRINGS, LOG_LEVEL_FROM_STRING } from './log-entry.interface.js';
+export type { ICacheProvider } from './cache-provider.interface.js';
+export { CACHE_PROVIDER } from './cache-provider.interface.js';
+//# sourceMappingURL=index.d.ts.map

package/build/common/interfaces/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/common/interfaces/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAC7D,YAAY,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AACxE,YAAY,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACtE,OAAO,EAAE,QAAQ,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAC9F,YAAY,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC"}

package/build/common/interfaces/index.js

@@ -0,0 +1,3 @@
+export { LogLevel, LOG_LEVEL_STRINGS, LOG_LEVEL_FROM_STRING } from './log-entry.interface.js';
+export { CACHE_PROVIDER } from './cache-provider.interface.js';
+//# sourceMappingURL=index.js.map

package/build/common/interfaces/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/common/interfaces/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,QAAQ,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAE9F,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC"}

package/build/common/interfaces/log-context.interface.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Structured logging context for distributed tracing and monitoring
+ *
+ * Provides base fields for structured JSON logging compatible with Loki and other
+ * observability platforms. All fields are optional to support flexible usage patterns.
+ *
+ * @example
+ * // Basic usage
+ * const context: LogContext = {
+ *   correlationId: 'req-123',
+ *   userId: 'user-456',
+ *   action: 'CreateStream',
+ *   status: 'success'
+ * };
+ *
+ * @example
+ * // Extending with domain-specific fields
+ * interface StreamingContext extends LogContext {
+ *   streamId: string;
+ *   bitrate: number;
+ *   codec: string;
+ * }
+ *
+ * const streamContext: StreamingContext = {
+ *   correlationId: 'req-123',
+ *   userId: 'user-456',
+ *   streamId: 'stream-789',
+ *   action: 'StartStream',
+ *   duration: 1250,
+ *   status: 'success',
+ *   bitrate: 5000,
+ *   codec: 'h264'
+ * };
+ */
+export interface LogContext {
+    /**
+     * Request correlation ID for distributed tracing
+     * Used to correlate logs across multiple services
+     */
+    correlationId?: string;
+    /**
+     * Authenticated user ID
+     * Identifies which user initiated the operation
+     */
+    userId?: string;
+    /**
+     * Stream or resource identifier
+     * Domain-specific identifier for the primary resource being operated on
+     */
+    streamId?: string;
+    /**
+     * Viewer or client identifier
+     * Identifies the viewer/client consuming a stream or resource
+     */
+    viewerId?: string;
+    /**
+     * Operation or action being performed
+     * Examples: 'CreateStream', 'StartBroadcast', 'UpdateMetadata'
+     */
+    action?: string;
+    /**
+     * Operation duration in milliseconds
+     * Useful for performance monitoring and SLO tracking
+     */
+    duration?: number;
+    /**
+     * Operation or request status
+     * Examples: 'success', 'failed', 'pending', 'completed'
+     */
+    status?: string;
+    /**
+     * Support for custom/domain-specific fields
+     * Allows extending the interface with additional context data
+     */
+    [key: string]: any;
+}
+//# sourceMappingURL=log-context.interface.d.ts.map

package/build/common/interfaces/log-context.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-context.interface.d.ts","sourceRoot":"","sources":["../../../src/common/interfaces/log-context.interface.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,MAAM,WAAW,UAAU;IAC1B;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACnB"}

package/build/common/interfaces/log-context.interface.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=log-context.interface.js.map

package/build/common/interfaces/log-context.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-context.interface.js","sourceRoot":"","sources":["../../../src/common/interfaces/log-context.interface.ts"],"names":[],"mappings":""}

package/build/common/interfaces/log-entry.interface.d.ts

@@ -0,0 +1,26 @@
+export interface LogEntry {
+    timestamp: string;
+    level: string;
+    service: string;
+    context: string;
+    message: string;
+    metadata?: Record<string, any>;
+    traceId?: string;
+    spanId?: string;
+    environment: string;
+}
+export interface LogMetadata {
+    [key: string]: any;
+}
+export declare enum LogLevel {
+    DEBUG = 0,
+    INFO = 1,
+    WARN = 2,
+    ERROR = 3,
+    FATAL = 4,
+    /** Suppresses all log output. */
+    SILENT = 5
+}
+export declare const LOG_LEVEL_STRINGS: Record<LogLevel, string>;
+export declare const LOG_LEVEL_FROM_STRING: Record<string, LogLevel>;
+//# sourceMappingURL=log-entry.interface.d.ts.map

package/build/common/interfaces/log-entry.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-entry.interface.d.ts","sourceRoot":"","sources":["../../../src/common/interfaces/log-entry.interface.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,QAAQ;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC3B,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACnB;AASD,oBAAY,QAAQ;IACnB,KAAK,IAAc;IACnB,IAAI,IAAa;IACjB,IAAI,IAAa;IACjB,KAAK,IAAc;IACnB,KAAK,IAAc;IACnB,iCAAiC;IACjC,MAAM,IAAe;CACrB;AAED,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,CAOtD,CAAC;AAEF,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAO1D,CAAC"}