@pawells/nestjs-shared 1.0.0-dev.4c8c698

package/build/common/common.module.d.ts

@@ -0,0 +1,49 @@
+import { OnModuleInit } from '@nestjs/common';
+import { ModuleRef } from '@nestjs/core';
+import { AppLogger } from './services/logger.service.js';
+import { InstrumentationRegistry } from './registry/instrumentation-registry.js';
+/**
+ * Common Module.
+ * Global module providing foundational infrastructure for NestJS applications:
+ * - Filters: GlobalExceptionFilter, HttpExceptionFilter
+ * - Interceptors: LoggingInterceptor, HTTPMetricsInterceptor
+ * - Pipes: ValidationPipe
+ * - Services: AppLogger, AuditLoggerService, CSRFService, ErrorCategorizerService, ErrorSanitizerService, HttpClientService, MetricsRegistryService, HealthCheckService
+ *
+ * @important ConfigModule MUST be imported before CommonModule in your application.
+ * Failure to do so will cause initialization errors at startup.
+ *
+ * @remarks
+ * - Automatically registers global filters, interceptors, and pipes
+ * - Exports all services for use in feature modules
+ * - Initializes AppLogger and RequestProperty decorator at module init
+ * - Validates ConfigService availability to catch import order issues
+ * - Global flag ensures exports are available application-wide without explicit imports
+ *
+ * @example
+ * ```typescript
+ * // Correct import order
+ * @Module({
+ *   imports: [
+ *     ConfigModule.forRoot({}),    // MUST come first
+ *     CommonModule,                // Depends on ConfigModule
+ *     // ... feature modules
+ *   ]
+ * })
+ * export class AppModule {}
+ * ```
+ */
+export declare class CommonModule implements OnModuleInit {
+    private readonly appLogger;
+    private readonly registry;
+    private readonly moduleRef;
+    private initialized;
+    constructor(appLogger: AppLogger, registry: InstrumentationRegistry, moduleRef: ModuleRef);
+    onModuleInit(): void;
+    /**
+     * Verify that ConfigService from the config module is registered in the application.
+     * This helps catch import order issues where CommonModule is imported before ConfigModule.
+     */
+    private verifyConfigServiceAvailable;
+}
+//# sourceMappingURL=common.module.d.ts.map

package/build/common/common.module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.module.d.ts","sourceRoot":"","sources":["../../src/common/common.module.ts"],"names":[],"mappings":"AAAA,OAAO,EAA0B,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACtE,OAAO,EAAyC,SAAS,EAAE,MAAM,cAAc,CAAC;AAMhF,OAAO,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAWzD,OAAO,EAAE,uBAAuB,EAAE,MAAM,wCAAwC,CAAC;AAGjF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,qBA0Da,YAAa,YAAW,YAAY;IAI/C,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAL3B,OAAO,CAAC,WAAW,CAAS;gBAGV,SAAS,EAAE,SAAS,EACpB,QAAQ,EAAE,uBAAuB,EACjC,SAAS,EAAE,SAAS;IAG/B,YAAY,IAAI,IAAI;IAiB3B;;;OAGG;IACH,OAAO,CAAC,4BAA4B;CAyBpC"}

package/build/common/common.module.js

@@ -0,0 +1,178 @@
+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 { Module, Logger, Global } from '@nestjs/common';
+import { APP_FILTER, APP_INTERCEPTOR, APP_PIPE, ModuleRef } from '@nestjs/core';
+import { HttpExceptionFilter } from './filters/http-exception.filter.js';
+import { GlobalExceptionFilter } from './filters/global-exception.filter.js';
+import { LoggingInterceptor } from './interceptors/logging.interceptor.js';
+import { HTTPMetricsInterceptor } from './interceptors/http-metrics.interceptor.js';
+import { ValidationPipe } from './pipes/validation.pipe.js';
+import { AppLogger } from './services/logger.service.js';
+import { ErrorSanitizerService } from './services/error-sanitizer.service.js';
+import { AuditLoggerService } from './services/audit-logger.service.js';
+import { CSRFService } from './services/csrf.service.js';
+import { CSRFGuard } from './guards/csrf.guard.js';
+import { ErrorCategorizerService } from './services/error-categorizer.service.js';
+import { HttpClientService } from './services/http-client.service.js';
+import { HealthCheckService } from './services/health-check.service.js';
+import { SetRequestPropertyDecoratorLogger } from './decorators/request-property.decorator.js';
+import { InstrumentationRegistryHolder } from './decorators/instrument.decorator.js';
+import { ConfigService } from '../config/index.js';
+import { InstrumentationRegistry } from './registry/instrumentation-registry.js';
+import { getErrorMessage } from './utils/error.utils.js';
+/**
+ * Common Module.
+ * Global module providing foundational infrastructure for NestJS applications:
+ * - Filters: GlobalExceptionFilter, HttpExceptionFilter
+ * - Interceptors: LoggingInterceptor, HTTPMetricsInterceptor
+ * - Pipes: ValidationPipe
+ * - Services: AppLogger, AuditLoggerService, CSRFService, ErrorCategorizerService, ErrorSanitizerService, HttpClientService, MetricsRegistryService, HealthCheckService
+ *
+ * @important ConfigModule MUST be imported before CommonModule in your application.
+ * Failure to do so will cause initialization errors at startup.
+ *
+ * @remarks
+ * - Automatically registers global filters, interceptors, and pipes
+ * - Exports all services for use in feature modules
+ * - Initializes AppLogger and RequestProperty decorator at module init
+ * - Validates ConfigService availability to catch import order issues
+ * - Global flag ensures exports are available application-wide without explicit imports
+ *
+ * @example
+ * ```typescript
+ * // Correct import order
+ * @Module({
+ *   imports: [
+ *     ConfigModule.forRoot({}),    // MUST come first
+ *     CommonModule,                // Depends on ConfigModule
+ *     // ... feature modules
+ *   ]
+ * })
+ * export class AppModule {}
+ * ```
+ */
+let CommonModule = class CommonModule {
+    appLogger;
+    registry;
+    moduleRef;
+    initialized = false;
+    constructor(appLogger, registry, moduleRef) {
+        this.appLogger = appLogger;
+        this.registry = registry;
+        this.moduleRef = moduleRef;
+    }
+    onModuleInit() {
+        if (this.initialized) {
+            return;
+        }
+        this.initialized = true;
+        // Initialize the RequestProperty decorator with the AppLogger instance
+        // This ensures structured logging is available before any route handlers are processed
+        SetRequestPropertyDecoratorLogger(this.appLogger);
+        // Set the InstrumentationRegistry instance in the holder for @Instrument() decorator access
+        InstrumentationRegistryHolder.setInstance(this.registry);
+        // Verify ConfigService is available to help developers catch import order issues early
+        this.verifyConfigServiceAvailable();
+    }
+    /**
+     * Verify that ConfigService from the config module is registered in the application.
+     * This helps catch import order issues where CommonModule is imported before ConfigModule.
+     */
+    verifyConfigServiceAvailable() {
+        try {
+            const configService = this.moduleRef.get(ConfigService, { strict: false });
+            if (!configService) {
+                throw new Error('ConfigService is null or undefined');
+            }
+        }
+        catch (error) {
+            const errorMessage = `
+Failed to initialize CommonModule: ConfigService is not registered in the module hierarchy.
+
+CommonModule requires ConfigModule to be imported first in your application.
+Ensure your AppModule imports ConfigModule before CommonModule:
+
+  @Module({
+    imports: [ConfigModule, CommonModule],
+  })
+  export class AppModule {}
+
+Importing in the wrong order will cause services to fail during initialization.
+Error details: ${getErrorMessage(error)}
+			`.trim();
+            throw new Error(errorMessage, { cause: error });
+        }
+    }
+};
+CommonModule = __decorate([
+    Global(),
+    Module({
+        // Note: PyroscopeModule is imported by TracingModule - do not duplicate here
+        providers: [
+            {
+                provide: APP_FILTER,
+                useClass: HttpExceptionFilter,
+            },
+            {
+                provide: APP_FILTER,
+                useClass: GlobalExceptionFilter,
+            },
+            {
+                provide: APP_INTERCEPTOR,
+                useClass: LoggingInterceptor,
+            },
+            {
+                provide: APP_INTERCEPTOR,
+                useClass: HTTPMetricsInterceptor,
+            },
+            {
+                provide: APP_PIPE,
+                useClass: ValidationPipe,
+            },
+            // Also exported below as standalone classes for direct injection in feature modules
+            GlobalExceptionFilter,
+            HttpExceptionFilter,
+            LoggingInterceptor,
+            HTTPMetricsInterceptor,
+            ValidationPipe,
+            AppLogger,
+            ErrorSanitizerService,
+            AuditLoggerService,
+            CSRFService,
+            CSRFGuard,
+            ErrorCategorizerService,
+            HttpClientService,
+            HealthCheckService,
+            InstrumentationRegistry,
+            Logger,
+        ],
+        exports: [
+            GlobalExceptionFilter,
+            HttpExceptionFilter,
+            LoggingInterceptor,
+            HTTPMetricsInterceptor,
+            ValidationPipe,
+            AppLogger,
+            ErrorSanitizerService,
+            AuditLoggerService,
+            CSRFService,
+            CSRFGuard,
+            ErrorCategorizerService,
+            HttpClientService,
+            HealthCheckService,
+            InstrumentationRegistry,
+        ],
+    }),
+    __metadata("design:paramtypes", [AppLogger,
+        InstrumentationRegistry,
+        ModuleRef])
+], CommonModule);
+export { CommonModule };
+//# sourceMappingURL=common.module.js.map

package/build/common/common.module.js.map

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

package/build/common/constants/histogram-buckets.constants.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Histogram Bucket Constants for Prometheus Metrics
+ *
+ * Prometheus-compliant bucket definitions for timing and size metrics.
+ * Note: Bucket values follow standard Prometheus patterns for observability.
+ */
+export declare const HTTP_DURATION_BUCKETS: number[];
+export declare const HTTP_REQUEST_SIZE_BUCKETS: number[];
+export declare const MILLISECONDS_TO_SECONDS = 1000;
+export declare const BYTES_PER_KILOBYTE = 1024;
+export declare const BYTES_PER_MEGABYTE: number;
+//# sourceMappingURL=histogram-buckets.constants.d.ts.map

package/build/common/constants/histogram-buckets.constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"histogram-buckets.constants.d.ts","sourceRoot":"","sources":["../../../src/common/constants/histogram-buckets.constants.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAeH,eAAO,MAAM,qBAAqB,UAWjC,CAAC;AAUF,eAAO,MAAM,yBAAyB,UAMrC,CAAC;AAGF,eAAO,MAAM,uBAAuB,OAAQ,CAAC;AAI7C,eAAO,MAAM,kBAAkB,OAAiB,CAAC;AACjD,eAAO,MAAM,kBAAkB,QAAkC,CAAC"}

package/build/common/constants/histogram-buckets.constants.js

@@ -0,0 +1,51 @@
+/**
+ * Histogram Bucket Constants for Prometheus Metrics
+ *
+ * Prometheus-compliant bucket definitions for timing and size metrics.
+ * Note: Bucket values follow standard Prometheus patterns for observability.
+ */
+// Duration bucket values in seconds
+const MILLISECONDS_TO_SECONDS_DUR = 0.001;
+const MILLISECONDS_TO_SECONDS_DUR_2 = 0.005;
+const MILLISECONDS_TO_SECONDS_DUR_3 = 0.01;
+const MILLISECONDS_TO_SECONDS_DUR_4 = 0.05;
+const MILLISECONDS_TO_SECONDS_DUR_5 = 0.1;
+const MILLISECONDS_TO_SECONDS_DUR_6 = 0.5;
+const MILLISECONDS_TO_SECONDS_DUR_7 = 1;
+const MILLISECONDS_TO_SECONDS_DUR_8 = 2.5;
+const MILLISECONDS_TO_SECONDS_DUR_9 = 5;
+const MILLISECONDS_TO_SECONDS_DUR_10 = 10;
+// HTTP request duration histogram buckets (seconds)
+export const HTTP_DURATION_BUCKETS = [
+    MILLISECONDS_TO_SECONDS_DUR,
+    MILLISECONDS_TO_SECONDS_DUR_2,
+    MILLISECONDS_TO_SECONDS_DUR_3,
+    MILLISECONDS_TO_SECONDS_DUR_4,
+    MILLISECONDS_TO_SECONDS_DUR_5,
+    MILLISECONDS_TO_SECONDS_DUR_6,
+    MILLISECONDS_TO_SECONDS_DUR_7,
+    MILLISECONDS_TO_SECONDS_DUR_8,
+    MILLISECONDS_TO_SECONDS_DUR_9,
+    MILLISECONDS_TO_SECONDS_DUR_10,
+];
+// Request size bucket values in bytes
+const HTTP_REQUEST_SIZE_100 = 100;
+const HTTP_REQUEST_SIZE_1000 = 1_000;
+const HTTP_REQUEST_SIZE_10000 = 10_000;
+const HTTP_REQUEST_SIZE_100000 = 100_000;
+const HTTP_REQUEST_SIZE_1000000 = 1_000_000;
+// HTTP request size histogram buckets (bytes)
+export const HTTP_REQUEST_SIZE_BUCKETS = [
+    HTTP_REQUEST_SIZE_100,
+    HTTP_REQUEST_SIZE_1000,
+    HTTP_REQUEST_SIZE_10000,
+    HTTP_REQUEST_SIZE_100000,
+    HTTP_REQUEST_SIZE_1000000,
+];
+// Time conversion constant
+export const MILLISECONDS_TO_SECONDS = 1_000;
+// Memory conversion constants
+const KILOBYTE_BYTES = 1_024;
+export const BYTES_PER_KILOBYTE = KILOBYTE_BYTES;
+export const BYTES_PER_MEGABYTE = KILOBYTE_BYTES * KILOBYTE_BYTES;
+//# sourceMappingURL=histogram-buckets.constants.js.map

package/build/common/constants/histogram-buckets.constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"histogram-buckets.constants.js","sourceRoot":"","sources":["../../../src/common/constants/histogram-buckets.constants.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,oCAAoC;AACpC,MAAM,2BAA2B,GAAG,KAAK,CAAC;AAC1C,MAAM,6BAA6B,GAAG,KAAK,CAAC;AAC5C,MAAM,6BAA6B,GAAG,IAAI,CAAC;AAC3C,MAAM,6BAA6B,GAAG,IAAI,CAAC;AAC3C,MAAM,6BAA6B,GAAG,GAAG,CAAC;AAC1C,MAAM,6BAA6B,GAAG,GAAG,CAAC;AAC1C,MAAM,6BAA6B,GAAG,CAAC,CAAC;AACxC,MAAM,6BAA6B,GAAG,GAAG,CAAC;AAC1C,MAAM,6BAA6B,GAAG,CAAC,CAAC;AACxC,MAAM,8BAA8B,GAAG,EAAE,CAAC;AAE1C,oDAAoD;AACpD,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACpC,2BAA2B;IAC3B,6BAA6B;IAC7B,6BAA6B;IAC7B,6BAA6B;IAC7B,6BAA6B;IAC7B,6BAA6B;IAC7B,6BAA6B;IAC7B,6BAA6B;IAC7B,6BAA6B;IAC7B,8BAA8B;CAC9B,CAAC;AAEF,sCAAsC;AACtC,MAAM,qBAAqB,GAAG,GAAG,CAAC;AAClC,MAAM,sBAAsB,GAAG,KAAK,CAAC;AACrC,MAAM,uBAAuB,GAAG,MAAM,CAAC;AACvC,MAAM,wBAAwB,GAAG,OAAO,CAAC;AACzC,MAAM,yBAAyB,GAAG,SAAS,CAAC;AAE5C,8CAA8C;AAC9C,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACxC,qBAAqB;IACrB,sBAAsB;IACtB,uBAAuB;IACvB,wBAAwB;IACxB,yBAAyB;CACzB,CAAC;AAEF,2BAA2B;AAC3B,MAAM,CAAC,MAAM,uBAAuB,GAAG,KAAK,CAAC;AAE7C,8BAA8B;AAC9B,MAAM,cAAc,GAAG,KAAK,CAAC;AAC7B,MAAM,CAAC,MAAM,kBAAkB,GAAG,cAAc,CAAC;AACjD,MAAM,CAAC,MAAM,kBAAkB,GAAG,cAAc,GAAG,cAAc,CAAC"}

package/build/common/constants/http-status.constants.d.ts

@@ -0,0 +1,27 @@
+/**
+ * HTTP Status Code Constants
+ * Standard HTTP status codes used across error handling and responses
+ */
+/** HTTP 200 OK status code */
+export declare const HTTP_STATUS_OK = 200;
+/** HTTP 400 Bad Request status code */
+export declare const HTTP_STATUS_BAD_REQUEST = 400;
+/** HTTP 401 Unauthorized status code */
+export declare const HTTP_STATUS_UNAUTHORIZED = 401;
+/** HTTP 403 Forbidden status code */
+export declare const HTTP_STATUS_FORBIDDEN = 403;
+/** HTTP 404 Not Found status code */
+export declare const HTTP_STATUS_NOT_FOUND = 404;
+/** HTTP 429 Too Many Requests (rate limit) status code */
+export declare const HTTP_STATUS_TOO_MANY_REQUESTS = 429;
+/** HTTP 422 Unprocessable Entity status code */
+export declare const HTTP_STATUS_UNPROCESSABLE_ENTITY = 422;
+/** HTTP 500 Internal Server Error status code */
+export declare const HTTP_STATUS_INTERNAL_SERVER_ERROR = 500;
+/** HTTP 502 Bad Gateway status code */
+export declare const HTTP_STATUS_BAD_GATEWAY = 502;
+/** HTTP 503 Service Unavailable status code */
+export declare const HTTP_STATUS_SERVICE_UNAVAILABLE = 503;
+/** HTTP 504 Gateway Timeout status code */
+export declare const HTTP_STATUS_GATEWAY_TIMEOUT = 504;
+//# sourceMappingURL=http-status.constants.d.ts.map

package/build/common/constants/http-status.constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-status.constants.d.ts","sourceRoot":"","sources":["../../../src/common/constants/http-status.constants.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,8BAA8B;AAC9B,eAAO,MAAM,cAAc,MAAM,CAAC;AAElC,uCAAuC;AACvC,eAAO,MAAM,uBAAuB,MAAM,CAAC;AAE3C,wCAAwC;AACxC,eAAO,MAAM,wBAAwB,MAAM,CAAC;AAE5C,qCAAqC;AACrC,eAAO,MAAM,qBAAqB,MAAM,CAAC;AAEzC,qCAAqC;AACrC,eAAO,MAAM,qBAAqB,MAAM,CAAC;AAEzC,0DAA0D;AAC1D,eAAO,MAAM,6BAA6B,MAAM,CAAC;AAEjD,gDAAgD;AAChD,eAAO,MAAM,gCAAgC,MAAM,CAAC;AAEpD,iDAAiD;AACjD,eAAO,MAAM,iCAAiC,MAAM,CAAC;AAErD,uCAAuC;AACvC,eAAO,MAAM,uBAAuB,MAAM,CAAC;AAE3C,+CAA+C;AAC/C,eAAO,MAAM,+BAA+B,MAAM,CAAC;AAEnD,2CAA2C;AAC3C,eAAO,MAAM,2BAA2B,MAAM,CAAC"}

package/build/common/constants/http-status.constants.js

@@ -0,0 +1,27 @@
+/**
+ * HTTP Status Code Constants
+ * Standard HTTP status codes used across error handling and responses
+ */
+/** HTTP 200 OK status code */
+export const HTTP_STATUS_OK = 200;
+/** HTTP 400 Bad Request status code */
+export const HTTP_STATUS_BAD_REQUEST = 400;
+/** HTTP 401 Unauthorized status code */
+export const HTTP_STATUS_UNAUTHORIZED = 401;
+/** HTTP 403 Forbidden status code */
+export const HTTP_STATUS_FORBIDDEN = 403;
+/** HTTP 404 Not Found status code */
+export const HTTP_STATUS_NOT_FOUND = 404;
+/** HTTP 429 Too Many Requests (rate limit) status code */
+export const HTTP_STATUS_TOO_MANY_REQUESTS = 429;
+/** HTTP 422 Unprocessable Entity status code */
+export const HTTP_STATUS_UNPROCESSABLE_ENTITY = 422;
+/** HTTP 500 Internal Server Error status code */
+export const HTTP_STATUS_INTERNAL_SERVER_ERROR = 500;
+/** HTTP 502 Bad Gateway status code */
+export const HTTP_STATUS_BAD_GATEWAY = 502;
+/** HTTP 503 Service Unavailable status code */
+export const HTTP_STATUS_SERVICE_UNAVAILABLE = 503;
+/** HTTP 504 Gateway Timeout status code */
+export const HTTP_STATUS_GATEWAY_TIMEOUT = 504;
+//# sourceMappingURL=http-status.constants.js.map

package/build/common/constants/http-status.constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-status.constants.js","sourceRoot":"","sources":["../../../src/common/constants/http-status.constants.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,8BAA8B;AAC9B,MAAM,CAAC,MAAM,cAAc,GAAG,GAAG,CAAC;AAElC,uCAAuC;AACvC,MAAM,CAAC,MAAM,uBAAuB,GAAG,GAAG,CAAC;AAE3C,wCAAwC;AACxC,MAAM,CAAC,MAAM,wBAAwB,GAAG,GAAG,CAAC;AAE5C,qCAAqC;AACrC,MAAM,CAAC,MAAM,qBAAqB,GAAG,GAAG,CAAC;AAEzC,qCAAqC;AACrC,MAAM,CAAC,MAAM,qBAAqB,GAAG,GAAG,CAAC;AAEzC,0DAA0D;AAC1D,MAAM,CAAC,MAAM,6BAA6B,GAAG,GAAG,CAAC;AAEjD,gDAAgD;AAChD,MAAM,CAAC,MAAM,gCAAgC,GAAG,GAAG,CAAC;AAEpD,iDAAiD;AACjD,MAAM,CAAC,MAAM,iCAAiC,GAAG,GAAG,CAAC;AAErD,uCAAuC;AACvC,MAAM,CAAC,MAAM,uBAAuB,GAAG,GAAG,CAAC;AAE3C,+CAA+C;AAC/C,MAAM,CAAC,MAAM,+BAA+B,GAAG,GAAG,CAAC;AAEnD,2CAA2C;AAC3C,MAAM,CAAC,MAAM,2BAA2B,GAAG,GAAG,CAAC"}

package/build/common/constants/timeout.constants.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Service Timeout Constants
+ * Timeout values for various external services and operations
+ * All timeouts can be overridden via environment variables for operational flexibility
+ * All timeout getters are functions to allow runtime override via process.env
+ */
+/** Grafana API request timeout in milliseconds (configurable via GRAFANA_TIMEOUT env var) */
+export declare function getGrafanaTimeout(): number;
+/** Loki API request timeout in milliseconds (configurable via LOKI_TIMEOUT env var) */
+export declare function getLokiTimeout(): number;
+/** Prometheus API request timeout in milliseconds (configurable via PROMETHEUS_TIMEOUT env var) */
+export declare function getPrometheusTimeout(): number;
+/** HTTP client default timeout in milliseconds (configurable via HTTP_CLIENT_TIMEOUT env var, default: 30 seconds) */
+export declare function getHttpClientTimeout(): number;
+/** Config validation timeout in milliseconds (configurable via CONFIG_VALIDATION_TIMEOUT env var) */
+export declare function getConfigValidationTimeout(): number;
+/** Deprecated: Use getGrafanaTimeout() instead. Will be removed in next major version. */
+export declare const GRAFANA_TIMEOUT: number;
+/** Deprecated: Use getLokiTimeout() instead. Will be removed in next major version. */
+export declare const LOKI_TIMEOUT: number;
+/** Deprecated: Use getPrometheusTimeout() instead. Will be removed in next major version. */
+export declare const PROMETHEUS_TIMEOUT: number;
+/** Deprecated: Use getHttpClientTimeout() instead. Will be removed in next major version. */
+export declare const HTTP_CLIENT_TIMEOUT: number;
+/** Deprecated: Use getConfigValidationTimeout() instead. Will be removed in next major version. */
+export declare const CONFIG_VALIDATION_TIMEOUT: number;
+/** Time conversion: microseconds to nanoseconds */
+export declare const MICROSECONDS_TO_NANOSECONDS = 1000000;
+//# sourceMappingURL=timeout.constants.d.ts.map

package/build/common/constants/timeout.constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeout.constants.d.ts","sourceRoot":"","sources":["../../../src/common/constants/timeout.constants.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AASH,6FAA6F;AAC7F,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED,uFAAuF;AACvF,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED,mGAAmG;AACnG,wBAAgB,oBAAoB,IAAI,MAAM,CAE7C;AAED,sHAAsH;AACtH,wBAAgB,oBAAoB,IAAI,MAAM,CAE7C;AAED,qGAAqG;AACrG,wBAAgB,0BAA0B,IAAI,MAAM,CAEnD;AAED,0FAA0F;AAC1F,eAAO,MAAM,eAAe,QAAsB,CAAC;AAEnD,uFAAuF;AACvF,eAAO,MAAM,YAAY,QAAmB,CAAC;AAE7C,6FAA6F;AAC7F,eAAO,MAAM,kBAAkB,QAAyB,CAAC;AAEzD,6FAA6F;AAC7F,eAAO,MAAM,mBAAmB,QAAyB,CAAC;AAE1D,mGAAmG;AACnG,eAAO,MAAM,yBAAyB,QAA+B,CAAC;AAEtE,mDAAmD;AACnD,eAAO,MAAM,2BAA2B,UAAY,CAAC"}

package/build/common/constants/timeout.constants.js

@@ -0,0 +1,45 @@
+/**
+ * Service Timeout Constants
+ * Timeout values for various external services and operations
+ * All timeouts can be overridden via environment variables for operational flexibility
+ * All timeout getters are functions to allow runtime override via process.env
+ */
+// Default timeout values in milliseconds
+const DEFAULT_GRAFANA_TIMEOUT_MS = 1_000;
+const DEFAULT_LOKI_TIMEOUT_MS = 1_000;
+const DEFAULT_PROMETHEUS_TIMEOUT_MS = 1_000;
+const DEFAULT_HTTP_CLIENT_TIMEOUT_MS = 30_000;
+const DEFAULT_CONFIG_VALIDATION_TIMEOUT_MS = 3_000;
+/** Grafana API request timeout in milliseconds (configurable via GRAFANA_TIMEOUT env var) */
+export function getGrafanaTimeout() {
+    return Number(process.env['GRAFANA_TIMEOUT'] ?? DEFAULT_GRAFANA_TIMEOUT_MS);
+}
+/** Loki API request timeout in milliseconds (configurable via LOKI_TIMEOUT env var) */
+export function getLokiTimeout() {
+    return Number(process.env['LOKI_TIMEOUT'] ?? DEFAULT_LOKI_TIMEOUT_MS);
+}
+/** Prometheus API request timeout in milliseconds (configurable via PROMETHEUS_TIMEOUT env var) */
+export function getPrometheusTimeout() {
+    return Number(process.env['PROMETHEUS_TIMEOUT'] ?? DEFAULT_PROMETHEUS_TIMEOUT_MS);
+}
+/** HTTP client default timeout in milliseconds (configurable via HTTP_CLIENT_TIMEOUT env var, default: 30 seconds) */
+export function getHttpClientTimeout() {
+    return Number(process.env['HTTP_CLIENT_TIMEOUT'] ?? DEFAULT_HTTP_CLIENT_TIMEOUT_MS);
+}
+/** Config validation timeout in milliseconds (configurable via CONFIG_VALIDATION_TIMEOUT env var) */
+export function getConfigValidationTimeout() {
+    return Number(process.env['CONFIG_VALIDATION_TIMEOUT'] ?? DEFAULT_CONFIG_VALIDATION_TIMEOUT_MS);
+}
+/** Deprecated: Use getGrafanaTimeout() instead. Will be removed in next major version. */
+export const GRAFANA_TIMEOUT = getGrafanaTimeout();
+/** Deprecated: Use getLokiTimeout() instead. Will be removed in next major version. */
+export const LOKI_TIMEOUT = getLokiTimeout();
+/** Deprecated: Use getPrometheusTimeout() instead. Will be removed in next major version. */
+export const PROMETHEUS_TIMEOUT = getPrometheusTimeout();
+/** Deprecated: Use getHttpClientTimeout() instead. Will be removed in next major version. */
+export const HTTP_CLIENT_TIMEOUT = getHttpClientTimeout();
+/** Deprecated: Use getConfigValidationTimeout() instead. Will be removed in next major version. */
+export const CONFIG_VALIDATION_TIMEOUT = getConfigValidationTimeout();
+/** Time conversion: microseconds to nanoseconds */
+export const MICROSECONDS_TO_NANOSECONDS = 1_000_000;
+//# sourceMappingURL=timeout.constants.js.map

package/build/common/constants/timeout.constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeout.constants.js","sourceRoot":"","sources":["../../../src/common/constants/timeout.constants.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,yCAAyC;AACzC,MAAM,0BAA0B,GAAG,KAAK,CAAC;AACzC,MAAM,uBAAuB,GAAG,KAAK,CAAC;AACtC,MAAM,6BAA6B,GAAG,KAAK,CAAC;AAC5C,MAAM,8BAA8B,GAAG,MAAM,CAAC;AAC9C,MAAM,oCAAoC,GAAG,KAAK,CAAC;AAEnD,6FAA6F;AAC7F,MAAM,UAAU,iBAAiB;IAChC,OAAO,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,IAAI,0BAA0B,CAAC,CAAC;AAC7E,CAAC;AAED,uFAAuF;AACvF,MAAM,UAAU,cAAc;IAC7B,OAAO,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,uBAAuB,CAAC,CAAC;AACvE,CAAC;AAED,mGAAmG;AACnG,MAAM,UAAU,oBAAoB;IACnC,OAAO,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,IAAI,6BAA6B,CAAC,CAAC;AACnF,CAAC;AAED,sHAAsH;AACtH,MAAM,UAAU,oBAAoB;IACnC,OAAO,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC,IAAI,8BAA8B,CAAC,CAAC;AACrF,CAAC;AAED,qGAAqG;AACrG,MAAM,UAAU,0BAA0B;IACzC,OAAO,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,2BAA2B,CAAC,IAAI,oCAAoC,CAAC,CAAC;AACjG,CAAC;AAED,0FAA0F;AAC1F,MAAM,CAAC,MAAM,eAAe,GAAG,iBAAiB,EAAE,CAAC;AAEnD,uFAAuF;AACvF,MAAM,CAAC,MAAM,YAAY,GAAG,cAAc,EAAE,CAAC;AAE7C,6FAA6F;AAC7F,MAAM,CAAC,MAAM,kBAAkB,GAAG,oBAAoB,EAAE,CAAC;AAEzD,6FAA6F;AAC7F,MAAM,CAAC,MAAM,mBAAmB,GAAG,oBAAoB,EAAE,CAAC;AAE1D,mGAAmG;AACnG,MAAM,CAAC,MAAM,yBAAyB,GAAG,0BAA0B,EAAE,CAAC;AAEtE,mDAAmD;AACnD,MAAM,CAAC,MAAM,2BAA2B,GAAG,SAAS,CAAC"}

package/build/common/controllers/metrics.controller.d.ts

@@ -0,0 +1,23 @@
+import type { Response } from 'express';
+import { MetricsRegistryService } from '../services/metrics-registry.service.js';
+import { AppLogger } from '../services/logger.service.js';
+/**
+ * Exposes Prometheus metrics at GET /metrics.
+ *
+ * IMPORTANT: This endpoint should be restricted to internal/monitoring networks
+ * via reverse proxy (nginx, Traefik, etc.) or firewall rules. Do not expose
+ * this endpoint publicly in production.
+ */
+export declare class MetricsController {
+    private readonly metricsService;
+    private readonly logger;
+    constructor(metricsService: MetricsRegistryService, logger: AppLogger);
+    /**
+     * GET /metrics
+     *
+     * Returns Prometheus metrics in text format for scraping.
+     * This endpoint should be configured for pull-based monitoring.
+     */
+    getMetrics(response: Response): Promise<void>;
+}
+//# sourceMappingURL=metrics.controller.d.ts.map

package/build/common/controllers/metrics.controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.controller.d.ts","sourceRoot":"","sources":["../../../src/common/controllers/metrics.controller.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACxC,OAAO,EAAE,sBAAsB,EAAE,MAAM,yCAAyC,CAAC;AACjF,OAAO,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAI1D;;;;;;GAMG;AACH,qBACa,iBAAiB;IAE5B,OAAO,CAAC,QAAQ,CAAC,cAAc;IACZ,OAAO,CAAC,QAAQ,CAAC,MAAM;gBADzB,cAAc,EAAE,sBAAsB,EACnB,MAAM,EAAE,SAAS;IAGtD;;;;;OAKG;IAIU,UAAU,CAAQ,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;CAUjE"}

package/build/common/controllers/metrics.controller.js

@@ -0,0 +1,66 @@
+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); }
+};
+import { Controller, Get, Header, Res, Inject } from '@nestjs/common';
+import { MetricsRegistryService } from '../services/metrics-registry.service.js';
+import { AppLogger } from '../services/logger.service.js';
+import { HTTP_STATUS_INTERNAL_SERVER_ERROR } from '../constants/http-status.constants.js';
+import { getErrorMessage } from '../utils/error.utils.js';
+/**
+ * Exposes Prometheus metrics at GET /metrics.
+ *
+ * IMPORTANT: This endpoint should be restricted to internal/monitoring networks
+ * via reverse proxy (nginx, Traefik, etc.) or firewall rules. Do not expose
+ * this endpoint publicly in production.
+ */
+let MetricsController = class MetricsController {
+    metricsService;
+    logger;
+    constructor(metricsService, logger) {
+        this.metricsService = metricsService;
+        this.logger = logger;
+    }
+    /**
+     * GET /metrics
+     *
+     * Returns Prometheus metrics in text format for scraping.
+     * This endpoint should be configured for pull-based monitoring.
+     */
+    async getMetrics(response) {
+        try {
+            const metrics = await this.metricsService.getMetrics();
+            response.send(metrics);
+        }
+        catch (error) {
+            this.logger.error('Failed to collect metrics', getErrorMessage(error));
+            // Return empty metrics on error to avoid breaking scrapers
+            response.status(HTTP_STATUS_INTERNAL_SERVER_ERROR).send('# Error collecting metrics\n');
+        }
+    }
+};
+__decorate([
+    Get('metrics'),
+    Header('Content-Type', 'text/plain; version=0.0.4; charset=utf-8'),
+    Header('X-Robots-Tag', 'noindex, nofollow'),
+    __param(0, Res()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", Promise)
+], MetricsController.prototype, "getMetrics", null);
+MetricsController = __decorate([
+    Controller(),
+    __param(1, Inject(AppLogger)),
+    __metadata("design:paramtypes", [MetricsRegistryService,
+        AppLogger])
+], MetricsController);
+export { MetricsController };
+//# sourceMappingURL=metrics.controller.js.map

package/build/common/controllers/metrics.controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.controller.js","sourceRoot":"","sources":["../../../src/common/controllers/metrics.controller.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAEtE,OAAO,EAAE,sBAAsB,EAAE,MAAM,yCAAyC,CAAC;AACjF,OAAO,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAC1D,OAAO,EAAE,iCAAiC,EAAE,MAAM,uCAAuC,CAAC;AAC1F,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE1D;;;;;;GAMG;AAEI,IAAM,iBAAiB,GAAvB,MAAM,iBAAiB;IAEX;IACmB;IAFrC,YACkB,cAAsC,EACnB,MAAiB;QADpC,mBAAc,GAAd,cAAc,CAAwB;QACnB,WAAM,GAAN,MAAM,CAAW;IACnD,CAAC;IAEJ;;;;;OAKG;IAIU,AAAN,KAAK,CAAC,UAAU,CAAQ,QAAkB;QAChD,IAAI,CAAC;YACJ,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,UAAU,EAAE,CAAC;YACvD,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACxB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,2BAA2B,EAAE,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC;YACvE,2DAA2D;YAC3D,QAAQ,CAAC,MAAM,CAAC,iCAAiC,CAAC,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;QACzF,CAAC;IACF,CAAC;CACD,CAAA;AAVa;IAHZ,GAAG,CAAC,SAAS,CAAC;IACd,MAAM,CAAC,cAAc,EAAE,0CAA0C,CAAC;IAClE,MAAM,CAAC,cAAc,EAAE,mBAAmB,CAAC;IACnB,WAAA,GAAG,EAAE,CAAA;;;;mDAS7B;AAxBW,iBAAiB;IAD7B,UAAU,EAAE;IAIV,WAAA,MAAM,CAAC,SAAS,CAAC,CAAA;qCADe,sBAAsB;QACX,SAAS;GAH1C,iBAAiB,CAyB7B"}

package/build/common/decorators/common-decorators.d.ts

@@ -0,0 +1,90 @@
+/**
+ * Extract query parameters from HTTP request.
+ * @param key - Specific query parameter key (optional - extracts all if not specified)
+ * @returns Parameter decorator
+ *
+ * @example
+ * ```typescript
+ * // Extract all query parameters
+ * @Get()
+ * getData(@Query() query: any) {}
+ *
+ * // Extract specific query parameter
+ * @Get()
+ * getData(@Query('limit') limit: number) {}
+ * ```
+ */
+export declare function Query(key?: string): ParameterDecorator;
+/**
+ * Extract route parameters from HTTP request.
+ * @param key - Specific route parameter key (optional - extracts all if not specified)
+ * @returns Parameter decorator
+ *
+ * @example
+ * ```typescript
+ * // Extract all route parameters
+ * @Get(':id')
+ * getUser(@Params() params: any) {}
+ *
+ * // Extract specific route parameter
+ * @Get(':id')
+ * getUser(@Params('id') id: string) {}
+ * ```
+ */
+export declare function Params(key?: string): ParameterDecorator;
+/**
+ * Extract request body from HTTP request.
+ * @param key - Specific body property key (optional - extracts all if not specified)
+ * @returns Parameter decorator
+ *
+ * @example
+ * ```typescript
+ * // Extract entire body
+ * @Post()
+ * createUser(@Body() userData: CreateUserDto) {}
+ *
+ * // Extract specific body property
+ * @Patch(':id')
+ * updateUser(@Body('email') email: string) {}
+ * ```
+ */
+export declare function Body(key?: string): ParameterDecorator;
+/**
+ * Extract request headers from HTTP request.
+ * @param key - Specific header key (optional - extracts all if not specified)
+ * @returns Parameter decorator
+ *
+ * @remarks Header names are case-insensitive in HTTP/1.1.
+ *
+ * @example
+ * ```typescript
+ * // Extract all headers
+ * @Get()
+ * getData(@Headers() headers: any) {}
+ *
+ * // Extract specific header
+ * @Get()
+ * getData(@Headers('authorization') auth: string) {}
+ * ```
+ */
+export declare function Headers(key?: string): ParameterDecorator;
+/**
+ * Extract cookies from HTTP request.
+ * @param key - Specific cookie key (optional - extracts all if not specified)
+ * @returns Parameter decorator
+ *
+ * @remarks Requires cookie-parser middleware to be enabled.
+ *
+ * @example
+ * ```typescript
+ * // Extract all cookies
+ * @Get()
+ * getData(@Cookies() cookies: any) {}
+ *
+ * // Extract specific cookie
+ * @Get()
+ * getData(@Cookies('sessionId') sessionId: string) {}
+ * ```
+ */
+export declare function Cookies(key?: string): ParameterDecorator;
+//# sourceMappingURL=common-decorators.d.ts.map