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

package/build/common/services/http-client.service.js

@@ -0,0 +1,294 @@
+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 HttpClientService_1;
+import { Injectable } from '@nestjs/common';
+import { ModuleRef } from '@nestjs/core';
+import * as https from 'https';
+import * as http from 'http';
+import { AppLogger } from './logger.service.js';
+import { getHttpClientTimeout } from '../constants/timeout.constants.js';
+import { HTTP_STATUS_OK } from '../constants/http-status.constants.js';
+/**
+ * HTTP Client Service.
+ * Provides a robust HTTP client with timeout handling, SSL/TLS configuration, payload size limits,
+ * and comprehensive logging with sensitive data redaction.
+ *
+ * Features:
+ * - Configurable timeouts (default: HTTP_CLIENT_TIMEOUT)
+ * - SSL/TLS certificate validation (default: strict)
+ * - Custom CA certificate support for self-signed certs
+ * - Payload size limit enforcement (10MB default)
+ * - Automatic content-type parsing (JSON, text)
+ * - Correlation ID support for request tracing
+ * - Sensitive data redaction in logs (passwords, tokens, auth headers)
+ * - Request/response duration tracking
+ *
+ * @remarks
+ * - Maximum payload size: 10MB (prevents memory exhaustion from large responses)
+ * - Timeout error handling with clear error messages
+ * - Content-type validation before JSON parsing
+ * - All sensitive headers (Authorization, Cookie, X-API-Key) redacted in logs
+ * - URLs with embedded credentials are sanitized before logging
+ *
+ * @example
+ * ```typescript
+ * // Simple GET request
+ * const response = await client.get('https://api.example.com/users');
+ *
+ * // POST with custom timeout and correlation ID
+ * const response = await client.post('https://api.example.com/users',
+ *   { name: 'John', email: 'john@example.com' },
+ *   { timeout: 5000, correlationId: 'req-123' }
+ * );
+ *
+ * // HTTPS with custom CA certificate
+ * const cert = fs.readFileSync('/path/to/ca.pem');
+ * const response = await client.get('https://internal-api.local/data', { ca: cert });
+ * ```
+ */
+let HttpClientService = HttpClientService_1 = class HttpClientService {
+    _contextualLogger;
+    Module;
+    constructor(module) {
+        this.Module = module;
+    }
+    get Logger() {
+        if (!this._contextualLogger) {
+            const baseLogger = this.Module.get(AppLogger);
+            this._contextualLogger = baseLogger.createContextualLogger(HttpClientService_1.name);
+        }
+        return this._contextualLogger;
+    }
+    /**
+     * Makes an HTTP request. URLs with embedded credentials and sensitive headers
+     * are sanitized before logging.
+     */
+    // eslint-disable-next-line @typescript-eslint/promise-function-async
+    request(options) {
+        const { method, url: requestUrl, headers, data, timeout = getHttpClientTimeout(), correlationId, rejectUnauthorized = true, ca } = options;
+        const startTime = Date.now();
+        const MAX_PAYLOAD_SIZE = 10_485_760; // 10MB in bytes
+        const safeUrl = this.sanitizeUrl(requestUrl);
+        this.Logger.debug('Making HTTP request', JSON.stringify({
+            method,
+            url: safeUrl,
+            headers: this.sanitizeHeaders(headers),
+            hasData: !!data,
+            timeout,
+            correlationId: correlationId ?? 'unknown',
+        }));
+        return new Promise((resolve, reject) => {
+            const parsedUrl = new URL(requestUrl); // Use raw URL for actual request
+            const isHttps = parsedUrl.protocol === 'https:';
+            const client = isHttps ? https : http;
+            const requestOptions = {
+                hostname: parsedUrl.hostname,
+                port: parsedUrl.port || undefined,
+                path: parsedUrl.pathname + parsedUrl.search,
+                method,
+                headers: headers ?? {},
+                timeout,
+            };
+            // Add SSL/TLS options for HTTPS requests
+            if (isHttps) {
+                requestOptions.rejectUnauthorized = rejectUnauthorized;
+                if (ca) {
+                    requestOptions.ca = ca;
+                }
+            }
+            const req = client.request(requestOptions, (res) => {
+                const chunks = [];
+                let totalSize = 0;
+                res.on('data', (chunk) => {
+                    totalSize += chunk.length;
+                    if (totalSize > MAX_PAYLOAD_SIZE) {
+                        const duration = Date.now() - startTime;
+                        req.destroy();
+                        const error = new Error('Payload too large');
+                        this.Logger.error('HTTP response payload exceeded size limit', JSON.stringify({
+                            method,
+                            url: safeUrl,
+                            maxSize: MAX_PAYLOAD_SIZE,
+                            actualSize: totalSize,
+                            durationMs: duration,
+                            correlationId: correlationId ?? 'unknown',
+                        }));
+                        reject(error);
+                        return;
+                    }
+                    chunks.push(chunk);
+                });
+                res.on('error', (error) => {
+                    const duration = Date.now() - startTime;
+                    this.Logger.error('HTTP response error', JSON.stringify({
+                        method,
+                        url: safeUrl,
+                        error: error.message,
+                        durationMs: duration,
+                        correlationId: correlationId ?? 'unknown',
+                    }));
+                    reject(error);
+                });
+                res.on('end', () => {
+                    const duration = Date.now() - startTime;
+                    try {
+                        const body = Buffer.concat(chunks).toString('utf-8');
+                        // Validate payload size before parsing JSON
+                        if (body.length > MAX_PAYLOAD_SIZE) {
+                            this.Logger.error('HTTP response payload exceeded size limit', JSON.stringify({
+                                method,
+                                url: safeUrl,
+                                maxSize: MAX_PAYLOAD_SIZE,
+                                actualSize: body.length,
+                                durationMs: duration,
+                                correlationId: correlationId ?? 'unknown',
+                            }));
+                            reject(new Error('Payload too large'));
+                            return;
+                        }
+                        // Validate content-type before parsing JSON
+                        const contentType = res.headers['content-type'] ?? '';
+                        let parsedData = null;
+                        if (body) {
+                            if (contentType.includes('application/json')) {
+                                parsedData = JSON.parse(body);
+                            }
+                            else if (contentType.includes('text/')) {
+                                parsedData = body;
+                            }
+                            else {
+                                // For other content types, return raw body
+                                parsedData = body;
+                            }
+                        }
+                        this.Logger.info('HTTP request successful', JSON.stringify({
+                            method,
+                            url: safeUrl,
+                            statusCode: res.statusCode,
+                            durationMs: duration,
+                            responseSize: body.length,
+                            correlationId: correlationId ?? 'unknown',
+                        }));
+                        resolve({
+                            data: parsedData,
+                            status: res.statusCode ?? HTTP_STATUS_OK,
+                            statusText: res.statusMessage ?? 'OK',
+                            headers: res.headers,
+                            duration,
+                        });
+                    }
+                    catch (error) {
+                        this.Logger.error('HTTP response parsing failed', JSON.stringify({
+                            method,
+                            url: safeUrl,
+                            statusCode: res.statusCode,
+                            error: error.message,
+                            durationMs: duration,
+                            correlationId: correlationId ?? 'unknown',
+                        }));
+                        reject(error);
+                    }
+                });
+            });
+            req.on('error', (error) => {
+                const duration = Date.now() - startTime;
+                this.Logger.error('HTTP request failed', JSON.stringify({
+                    method,
+                    url: safeUrl,
+                    error: error.message,
+                    durationMs: duration,
+                    correlationId: correlationId ?? 'unknown',
+                }));
+                reject(error);
+            });
+            req.on('timeout', () => {
+                const duration = Date.now() - startTime;
+                req.destroy();
+                this.Logger.warn('HTTP request timeout', JSON.stringify({
+                    method,
+                    url: safeUrl,
+                    timeout,
+                    durationMs: duration,
+                    correlationId: correlationId ?? 'unknown',
+                }));
+                reject(new Error('Request timeout'));
+            });
+            if (data) {
+                const bodyData = typeof data === 'string' ? data : JSON.stringify(data);
+                req.write(bodyData);
+            }
+            req.end();
+        });
+    }
+    // eslint-disable-next-line @typescript-eslint/promise-function-async
+    get(url, options = {}) {
+        return this.request({ ...options, method: 'GET', url });
+    }
+    // eslint-disable-next-line @typescript-eslint/promise-function-async
+    post(url, data, options = {}) {
+        return this.request({ ...options, method: 'POST', url, data });
+    }
+    // eslint-disable-next-line @typescript-eslint/promise-function-async
+    put(url, data, options = {}) {
+        return this.request({ ...options, method: 'PUT', url, data });
+    }
+    // eslint-disable-next-line @typescript-eslint/promise-function-async
+    delete(url, options = {}) {
+        return this.request({ ...options, method: 'DELETE', url });
+    }
+    /**
+     * Sanitize a URL to remove embedded credentials (e.g., https://user:pass@host/)
+     */
+    sanitizeUrl(url) {
+        try {
+            const parsed = new URL(url);
+            if (parsed.username || parsed.password) {
+                parsed.username = '[REDACTED]';
+                parsed.password = '[REDACTED]';
+                return parsed.toString();
+            }
+            return url;
+        }
+        catch {
+            return url;
+        }
+    }
+    /**
+     * Redacts sensitive headers (authorization, cookies, API keys, CSRF tokens)
+     * before logging.
+     */
+    sanitizeHeaders(headers) {
+        if (!headers)
+            return undefined;
+        const sensitiveHeaders = [
+            'authorization',
+            'x-api-key',
+            'cookie',
+            'set-cookie',
+            'x-auth-token',
+            'proxy-authorization',
+            'x-csrf-token',
+        ];
+        const sanitized = { ...headers };
+        // Replace sensitive headers with redacted value (case-insensitive)
+        for (const [key] of Object.entries(sanitized)) {
+            if (sensitiveHeaders.includes(key.toLowerCase())) {
+                sanitized[key] = '[REDACTED]';
+            }
+        }
+        return sanitized;
+    }
+};
+HttpClientService = HttpClientService_1 = __decorate([
+    Injectable(),
+    __metadata("design:paramtypes", [ModuleRef])
+], HttpClientService);
+export { HttpClientService };
+//# sourceMappingURL=http-client.service.js.map

package/build/common/services/http-client.service.js.map

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

package/build/common/services/logger.service.d.ts

@@ -0,0 +1,189 @@
+import { ConfigService } from '@nestjs/config';
+import { LogMetadata } from '../interfaces/log-entry.interface.js';
+import { IContextualLogger } from '../interfaces/logger.interface.js';
+/**
+ * Options object for logging methods.
+ * Provides a cleaner alternative to positional parameters.
+ */
+export interface LogOptions {
+    context?: string;
+    trace?: string;
+    metadata?: LogMetadata;
+}
+/**
+ * Centralized application logger service.
+ * Wraps @pawells/logger and respects LOG_LEVEL environment variable for filtering.
+ * Automatically redacts sensitive information (passwords, tokens, API keys) from logs.
+ * Supports structured logging with context and metadata.
+ * Integrates with OpenTelemetry for trace and span ID correlation.
+ * Implements Interface Segregation Principle with focused interfaces.
+ *
+ * @example
+ * ```typescript
+ * // Use flexible logging methods
+ * logger.info('User logged in', 'AuthService', { userId: '123' });
+ * logger.error('Database error', error.stack, 'DatabaseService', { query: '...' });
+ * logger.debug('Cache hit', { metadata: { key: 'users:123' } });
+ * ```
+ */
+export declare class AppLogger implements IContextualLogger {
+    private readonly configService?;
+    private readonly context;
+    private readonly pawellsLogger;
+    private readonly minLevel;
+    private readonly serviceName;
+    /**
+     * Set of field names that contain sensitive information requiring redaction in logs.
+     * Stored as lowercase for case-insensitive matching against object keys.
+     * Prevents leaking credentials, tokens, and other security-sensitive data into log output.
+     * Includes passwords, API keys, tokens, and payment card information.
+     */
+    private readonly sensitiveKeys;
+    constructor(configService?: ConfigService | undefined, context?: string);
+    /**
+     * Parse LOG_LEVEL environment variable
+     * @returns LogLevel enum value (numeric)
+     */
+    private parseLogLevel;
+    /**
+     * Parse LOG_FORMAT environment variable
+     * @returns Format type ('json' | 'text'), defaults to 'json'
+     */
+    private parseLogFormat;
+    /**
+     * Map nestjs-shared numeric LogLevel to @pawells/logger LogLevel
+     * @param level - Numeric LogLevel from nestjs-shared
+     * @returns String LogLevel for @pawells/logger
+     */
+    private mapNestjsLogLevelToPawells;
+    /**
+     * Check if a log level should be output
+     * @param level - Level to check
+     * @returns true if level should be logged
+     */
+    private shouldLog;
+    /**
+     * Sanitize metadata to remove sensitive information and handle circular references
+     * @param metadata - Metadata to sanitize
+     * @returns Sanitized metadata with circular references replaced by '[CIRCULAR_REF]'
+     */
+    private sanitizeMetadata;
+    /**
+     * Extract OpenTelemetry trace context
+     * @returns Object with traceId and spanId if available
+     */
+    private extractTraceContext;
+    /**
+     * Build metadata with context and trace info
+     * @param logContext - Logger context
+     * @param metadata - User-provided metadata
+     * @returns Combined metadata
+     */
+    private buildMetadata;
+    /**
+     * Log debug message
+     * @param message - Log message
+     * @param options - Optional context/metadata options
+     */
+    debug(message: string | Error, options: LogOptions): void;
+    /**
+     * Log debug message
+     * @param message - Log message
+     * @param context - Optional context override
+     * @param metadata - Optional structured metadata
+     */
+    debug(message: string | Error, context?: string, metadata?: LogMetadata): void;
+    /**
+     * Log debug message
+     * @param message - Log message
+     * @param metadata - Optional structured metadata
+     */
+    debug(message: string | Error, metadata?: LogMetadata): void;
+    /**
+     * Log info message
+     * @param message - Log message
+     * @param options - Optional context/metadata options
+     */
+    info(message: string | Error, options: LogOptions): void;
+    /**
+     * Log info message
+     * @param message - Log message
+     * @param context - Optional context override
+     * @param metadata - Optional structured metadata
+     */
+    info(message: string | Error, context?: string, metadata?: LogMetadata): void;
+    /**
+     * Log info message
+     * @param message - Log message
+     * @param metadata - Optional structured metadata
+     */
+    info(message: string | Error, metadata?: LogMetadata): void;
+    /**
+     * Log warning message
+     * @param message - Log message
+     * @param options - Optional context/metadata options
+     */
+    warn(message: string | Error, options: LogOptions): void;
+    /**
+     * Log warning message
+     * @param message - Log message
+     * @param context - Optional context override
+     * @param metadata - Optional structured metadata
+     */
+    warn(message: string | Error, context?: string, metadata?: LogMetadata): void;
+    /**
+     * Log warning message
+     * @param message - Log message
+     * @param metadata - Optional structured metadata
+     */
+    warn(message: string | Error, metadata?: LogMetadata): void;
+    /**
+     * Log error message
+     * @param message - Log message or Error object
+     * @param options - Optional context/trace/metadata options
+     */
+    error(message: string | Error, options: LogOptions): void;
+    /**
+     * Log error message
+     * @param message - Log message or Error object
+     * @param trace - Optional stack trace
+     * @param context - Optional context override
+     * @param metadata - Optional structured metadata
+     */
+    error(message: string | Error, trace?: string, context?: string, metadata?: LogMetadata): void;
+    /**
+     * Log error message
+     * @param message - Log message or Error object
+     * @param context - Optional context override
+     * @param metadata - Optional structured metadata
+     */
+    error(message: string | Error, context?: string, metadata?: LogMetadata): void;
+    /**
+     * Log fatal message
+     * @param message - Log message or Error object
+     * @param options - Optional context/trace/metadata options
+     */
+    fatal(message: string | Error, options: LogOptions): void;
+    /**
+     * Log fatal message
+     * @param message - Log message or Error object
+     * @param trace - Optional stack trace
+     * @param context - Optional context override
+     * @param metadata - Optional structured metadata
+     */
+    fatal(message: string | Error, trace?: string, context?: string, metadata?: LogMetadata): void;
+    /**
+     * Log fatal message
+     * @param message - Log message or Error object
+     * @param context - Optional context override
+     * @param metadata - Optional structured metadata
+     */
+    fatal(message: string | Error, context?: string, metadata?: LogMetadata): void;
+    /**
+     * Create a contextual logger instance
+     * @param context - Context string
+     * @returns New AppLogger instance with context
+     */
+    createContextualLogger(context: string): AppLogger;
+}
+//# sourceMappingURL=logger.service.d.ts.map

package/build/common/services/logger.service.d.ts.map

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