@designofadecade/server 4.0.0

package/dist/logger/Logger.js

@@ -0,0 +1,582 @@
+/**
+ * Structured logger for AWS Lambda with CloudWatch Logs
+ *
+ * @module Logger
+ * @description Provides JSON-formatted logging for better CloudWatch Insights queries
+ * with configurable log levels and structured context support. Automatically captures
+ * AWS Lambda request IDs and properly serializes Error objects.
+ *
+ * Best Practices for CloudWatch Alarms:
+ * - Add a `code` field to log entries (e.g., 'DB_CONNECTION_ERROR') for alarm filtering
+ * - Add a `source` field to track where logs originated (e.g., 'UserService.login')
+ * - Use consistent error codes across your application
+ * - Create CloudWatch metric filters based on specific codes
+ *
+ * Features:
+ * ✅ JSON-formatted logs for CloudWatch Insights
+ * ✅ Automatic error serialization (message, name, stack)
+ * ✅ AWS Lambda context (request ID, X-Ray trace ID, function name, version)
+ * ✅ Environment metadata (stage/environment tracking)
+ * ✅ Cold start detection (Lambda performance monitoring)
+ * ✅ Sensitive data redaction (passwords, tokens, API keys, etc.)
+ * ✅ Performance timing helpers (duration tracking)
+ * ✅ Error codes for alarm creation
+ * ✅ Source tracking for debugging
+ *
+ * @example
+ * import { logger } from './Logger';
+ *
+ * logger.info('User action completed', {
+ *   source: 'UserController.login',
+ *   userId: '123',
+ *   action: 'login'
+ * });
+ *
+ * // Error objects are automatically serialized with message, name, and stack
+ * // Use 'code' field for CloudWatch alarms
+ * try {
+ *   await riskyOperation();
+ * } catch (err) {
+ *   logger.error('Operation failed', {
+ *     code: 'PAYMENT_PROCESSING_ERROR', // For CloudWatch alarm filtering
+ *     source: 'PaymentService.processPayment', // For debugging
+ *     error: err
+ *   });
+ * }
+ *
+ * // Performance timing
+ * const timer = logger.startTimer();
+ * await expensiveOperation();
+ * timer.end('expensiveOperation', { source: 'MyService.process' });
+ *
+ * // Sensitive data is automatically redacted
+ * logger.info('User logged in', {
+ *   username: 'john',
+ *   password: 'secret123' // Automatically redacted as [REDACTED]
+ * });
+ */
+/**
+ * Log level enumeration
+ * Lower values indicate higher priority
+ *
+ * Log Level Guidelines:
+ *
+ * ERROR (0) - Critical failures requiring immediate attention
+ * - Application crashes or unrecoverable errors
+ * - Failed database connections or critical service failures
+ * - Data corruption or loss scenarios
+ * - Security violations or authentication failures
+ * - Use when: The application cannot continue normal operation
+ *
+ * WARN (1) - Potentially harmful situations that don't stop execution
+ * - Deprecated API usage or configuration issues
+ * - Rate limiting being approached
+ * - Retryable failures (e.g., temporary network issues)
+ * - Resource constraints (low memory, disk space)
+ * - Use when: Something unexpected happened but the app can continue
+ *
+ * INFO (2) - Informational messages highlighting application progress
+ * - Application startup/shutdown events
+ * - Successful business operations (user login, order placed)
+ * - Configuration loaded successfully
+ * - API request/response summaries
+ * - Use when: Tracking normal application flow and important milestones
+ *
+ * DEBUG (3) - Detailed diagnostic information for troubleshooting
+ * - Variable values and state changes
+ * - Cache hits/misses
+ * - Detailed request/response payloads
+ * - Function entry/exit points
+ * - Use when: Debugging issues in development or production
+ */
+export var LogLevel;
+(function (LogLevel) {
+    LogLevel[LogLevel["ERROR"] = 0] = "ERROR";
+    LogLevel[LogLevel["WARN"] = 1] = "WARN";
+    LogLevel[LogLevel["INFO"] = 2] = "INFO";
+    LogLevel[LogLevel["DEBUG"] = 3] = "DEBUG";
+})(LogLevel || (LogLevel = {}));
+/**
+ * Mapping of string log levels to numeric values
+ */
+const LOG_LEVEL_MAP = {
+    ERROR: LogLevel.ERROR,
+    WARN: LogLevel.WARN,
+    INFO: LogLevel.INFO,
+    DEBUG: LogLevel.DEBUG,
+};
+/**
+ * Structured logger class for AWS Lambda with CloudWatch Logs integration
+ *
+ * @class Logger
+ * @description Outputs JSON-formatted logs for optimal CloudWatch Insights querying.
+ * Log level can be configured via LOG_LEVEL environment variable.
+ *
+ * @example
+ * const logger = new Logger();
+ * logger.info('Processing started', { requestId: '12345' });
+ * logger.error('Failed to process', { error: 'Connection timeout', retries: 3 });
+ */
+export class Logger {
+    level;
+    // Sensitive field patterns - more specific to avoid false positives
+    sensitiveKeys = [
+        'password',
+        'passwd',
+        'pwd',
+        'token',
+        'accesstoken',
+        'refreshtoken',
+        'bearertoken',
+        'apikey',
+        'api_key',
+        'secret',
+        'secretkey',
+        'clientsecret',
+        'authorization',
+        'auth',
+        'cookie',
+        'session',
+        'sessionid',
+        'creditcard',
+        'cardnumber',
+        'cvv',
+        'ccv',
+        'ssn',
+        'socialsecurity',
+        'privatekey',
+        'private_key',
+    ];
+    isColdStart = true; // Track Lambda cold starts
+    maxLogSize = 256000; // CloudWatch limit is 256KB per log event
+    /**
+     * Creates a new Logger instance
+     * Reads LOG_LEVEL from environment variable (defaults to INFO)
+     */
+    constructor() {
+        const envLevel = (process.env.LOG_LEVEL?.toUpperCase() || 'INFO');
+        this.level = LOG_LEVEL_MAP[envLevel] ?? LogLevel.INFO;
+    }
+    /**
+     * Determines if a message at the given level should be logged
+     *
+     * @param level - The log level to check
+     * @returns True if the message should be logged
+     * @private
+     */
+    shouldLog(level) {
+        return level <= this.level;
+    }
+    /**
+     * Serializes an Error object for CloudWatch
+     * Extracts message, name, and stack trace for better CloudWatch Insights queries
+     *
+     * @param error - The error to serialize
+     * @returns Serialized error object
+     * @private
+     */
+    serializeError(error) {
+        return {
+            message: error.message,
+            name: error.name,
+            stack: error.stack,
+        };
+    }
+    /**
+     * Redacts sensitive data from log context for security/compliance
+     * Handles circular references and prevents infinite recursion
+     *
+     * @param obj - The object to redact
+     * @param seen - WeakSet to track visited objects (prevents circular references)
+     * @param depth - Current recursion depth (prevents stack overflow)
+     * @returns Redacted object
+     * @private
+     */
+    redactSensitiveData(obj, seen = new WeakSet(), depth = 0) {
+        // Prevent infinite recursion
+        if (depth > 10)
+            return '[MAX_DEPTH]';
+        if (obj === null || obj === undefined)
+            return obj;
+        // Handle primitives and special types before object check
+        if (typeof obj !== 'object') {
+            // Handle Symbol (convert to string for JSON compatibility)
+            if (typeof obj === 'symbol') {
+                return obj.toString();
+            }
+            // Handle BigInt (convert to string for JSON compatibility)
+            if (typeof obj === 'bigint') {
+                return obj.toString() + 'n';
+            }
+            // Handle functions
+            if (typeof obj === 'function') {
+                return '[Function]';
+            }
+            return obj;
+        }
+        // Handle circular references
+        if (seen.has(obj)) {
+            return '[CIRCULAR]';
+        }
+        if (Array.isArray(obj)) {
+            return obj.map((item) => this.redactSensitiveData(item, seen, depth + 1));
+        }
+        // Mark this object as seen
+        seen.add(obj);
+        const redacted = {};
+        for (const [key, value] of Object.entries(obj)) {
+            const lowerKey = key.toLowerCase();
+            const isSensitive = this.sensitiveKeys.some((sensitive) => lowerKey.includes(sensitive.toLowerCase()));
+            if (isSensitive) {
+                redacted[key] = '[REDACTED]';
+            }
+            else {
+                // Always recursively process values to handle BigInt, Symbol, Function, etc.
+                redacted[key] = this.redactSensitiveData(value, seen, depth + 1);
+            }
+        }
+        return redacted;
+    }
+    /**
+     * Processes context to handle special types (Errors) for CloudWatch compatibility
+     *
+     * @param context - The context object to process
+     * @returns Processed context
+     * @private
+     */
+    processContext(context) {
+        if (!context)
+            return {};
+        const processed = {};
+        for (const [key, value] of Object.entries(context)) {
+            if (value instanceof Error) {
+                // Serialize Error objects properly for CloudWatch
+                processed[key] = this.serializeError(value);
+            }
+            else {
+                processed[key] = value;
+            }
+        }
+        // Redact sensitive data
+        return this.redactSensitiveData(processed);
+    }
+    /**
+     * Safely stringifies an object, handling BigInt, circular refs, and other edge cases
+     *
+     * @param obj - The object to stringify
+     * @returns JSON string
+     * @private
+     */
+    safeStringify(obj) {
+        return JSON.stringify(obj, (_key, value) => {
+            // Handle BigInt (convert to string with 'n' suffix)
+            if (typeof value === 'bigint') {
+                return value.toString() + 'n';
+            }
+            // Handle Symbol (convert to string)
+            if (typeof value === 'symbol') {
+                return value.toString();
+            }
+            // Handle functions (skip them)
+            if (typeof value === 'function') {
+                return '[Function]';
+            }
+            return value;
+        });
+    }
+    /**
+     * Outputs a structured log entry to stdout optimized for CloudWatch Logs
+     * Handles CloudWatch's 256KB log size limit
+     *
+     * @param level - The log level string
+     * @param message - The log message
+     * @param context - Additional context data to include in the log entry
+     * @private
+     */
+    log(level, message, context) {
+        try {
+            const processedContext = this.processContext(context);
+            const logEntry = {
+                timestamp: new Date().toISOString(),
+                level,
+                message,
+                // AWS Lambda context
+                ...(process.env.AWS_REQUEST_ID && { requestId: process.env.AWS_REQUEST_ID }),
+                ...(process.env._X_AMZN_TRACE_ID && { traceId: process.env._X_AMZN_TRACE_ID }),
+                ...(process.env.AWS_LAMBDA_FUNCTION_NAME && {
+                    functionName: process.env.AWS_LAMBDA_FUNCTION_NAME,
+                }),
+                ...(process.env.AWS_LAMBDA_FUNCTION_VERSION && {
+                    functionVersion: process.env.AWS_LAMBDA_FUNCTION_VERSION,
+                }),
+                // Environment metadata
+                ...(process.env.ENVIRONMENT && { environment: process.env.ENVIRONMENT }),
+                ...(process.env.STAGE && { environment: process.env.STAGE }),
+                // Cold start tracking
+                ...(this.isColdStart && level !== 'DEBUG' && { coldStart: true }),
+                ...processedContext,
+            };
+            // Mark cold start as false after first log
+            if (this.isColdStart) {
+                this.isColdStart = false;
+            }
+            let logString = this.safeStringify(logEntry);
+            // CloudWatch has a 256KB limit per log event
+            if (logString.length > this.maxLogSize) {
+                const truncated = {
+                    ...logEntry,
+                    _truncated: true,
+                    _originalSize: logString.length,
+                    message: logEntry.message.substring(0, 1000),
+                };
+                // Remove large fields if still too big
+                const truncatedRecord = truncated;
+                if (truncatedRecord.error && typeof truncatedRecord.error === 'object') {
+                    delete truncatedRecord.error.stack;
+                }
+                logString = this.safeStringify(truncated);
+                // If still too large, just log basic info
+                if (logString.length > this.maxLogSize) {
+                    logString = this.safeStringify({
+                        timestamp: logEntry.timestamp,
+                        level: logEntry.level,
+                        message: 'Log too large to output',
+                        _truncated: true,
+                        _originalSize: logString.length,
+                    });
+                }
+            }
+            console.log(logString);
+        }
+        catch (err) {
+            // Fallback to plain console.log if JSON serialization fails
+            try {
+                console.log(JSON.stringify({
+                    timestamp: new Date().toISOString(),
+                    level,
+                    message,
+                    _error: 'Failed to serialize log entry',
+                    _errorMessage: err instanceof Error ? err.message : String(err),
+                }));
+            }
+            catch {
+                // Last resort fallback
+                console.log(`[${level}] ${message}`);
+            }
+        }
+    }
+    /**
+     * Logs an error message
+     *
+     * @param message - The error message
+     * @param context - Additional context data (error details, stack traces, etc.)
+     *
+     * @example
+     * // Pass Error objects directly - they'll be serialized automatically
+     * try {
+     *   await connectToDatabase();
+     * } catch (err) {
+     *   logger.error('Database connection failed', {
+     *     code: 'DB_CONNECTION_ERROR', // For CloudWatch alarms
+     *     source: 'DatabaseService.connect', // Track where error occurred
+     *     error: err, // Error object is automatically serialized
+     *     database: 'users',
+     *     retry: 3
+     *   });
+     * }
+     *
+     * @example
+     * // CloudWatch Alarm can filter on code field:
+     * // fields @timestamp, message, code
+     * // | filter code = "DB_CONNECTION_ERROR"
+     */
+    error(message, context) {
+        if (this.shouldLog(LogLevel.ERROR)) {
+            this.log('ERROR', message, context);
+        }
+    }
+    /**
+     * Logs a warning message
+     *
+     * @param message - The warning message
+     * @param context - Additional context data
+     *
+     * @example
+     * logger.warn('Rate limit approaching', {
+     *   code: 'RATE_LIMIT_WARNING',
+     *   source: 'ApiGateway.checkRateLimit',
+     *   current: 95,
+     *   limit: 100,
+     *   timeWindow: '1m'
+     * });
+     */
+    warn(message, context) {
+        if (this.shouldLog(LogLevel.WARN)) {
+            this.log('WARN', message, context);
+        }
+    }
+    /**
+     * Logs an informational message
+     *
+     * @param message - The info message
+     * @param context - Additional context data
+     *
+     * @example
+     * logger.info('Request processed successfully', {
+     *   source: 'ApiHandler.processRequest',
+     *   requestId: 'req-123',
+     *   duration: 245,
+     *   statusCode: 200
+     * });
+     */
+    info(message, context) {
+        if (this.shouldLog(LogLevel.INFO)) {
+            this.log('INFO', message, context);
+        }
+    }
+    /**
+     * Logs a debug message
+     *
+     * @param message - The debug message
+     * @param context - Additional context data
+     *
+     * @example
+     * logger.debug('Cache lookup', {
+     *   key: 'user:123',
+     *   hit: true,
+     *   ttl: 3600
+     * });
+     */
+    debug(message, context) {
+        if (this.shouldLog(LogLevel.DEBUG)) {
+            this.log('DEBUG', message, context);
+        }
+    }
+    /**
+     * Gets the current log level
+     *
+     * @returns The current log level
+     */
+    getLevel() {
+        return this.level;
+    }
+    /**
+     * Gets the current log level as a string
+     *
+     * @returns The current log level string
+     */
+    getLevelString() {
+        const entry = Object.entries(LogLevel).find(([, val]) => val === this.level);
+        return entry?.[0] || 'INFO';
+    }
+    /**
+     * Logs operation performance metrics
+     * Helper method for tracking duration of operations
+     *
+     * @param operation - Name of the operation
+     * @param durationMs - Duration in milliseconds
+     * @param context - Additional context data
+     *
+     * @example
+     * const start = Date.now();
+     * await processPayment();
+     * logger.performance('processPayment', Date.now() - start, {
+     *   source: 'PaymentService.process',
+     *   paymentId: '12345',
+     *   amount: 99.99
+     * });
+     *
+     * @example
+     * // CloudWatch Insights - Track slow operations:
+     * // fields @timestamp, message, duration, source
+     * // | filter duration > 1000
+     * // | sort duration desc
+     */
+    performance(operation, durationMs, context) {
+        this.info(`Operation completed: ${operation}`, {
+            duration: durationMs,
+            ...context,
+        });
+    }
+    /**
+     * Creates a performance timing wrapper
+     * Returns start function that returns end function for measuring duration
+     *
+     * @returns Object with start method that returns end method
+     *
+     * @example
+     * const timer = logger.startTimer();
+     * await someAsyncOperation();
+     * timer.end('someAsyncOperation', { source: 'MyService.method', userId: '123' });
+     */
+    startTimer() {
+        const startTime = Date.now();
+        return {
+            /**
+             * Ends the timer and logs performance
+             * @param operation - Name of the operation
+             * @param context - Additional context
+             */
+            end: (operation, context) => {
+                this.performance(operation, Date.now() - startTime, context);
+            },
+        };
+    }
+}
+/**
+ * Singleton logger instance
+ * Use this for all logging throughout the application
+ *
+ * Environment Variables:
+ * - LOG_LEVEL: Set log level (ERROR, WARN, INFO, DEBUG) - defaults to INFO
+ * - ENVIRONMENT or STAGE: Environment name (dev/staging/prod) - auto-included in logs
+ * - AWS_REQUEST_ID: Lambda request ID - auto-captured
+ * - _X_AMZN_TRACE_ID: X-Ray trace ID - auto-captured
+ * - AWS_LAMBDA_FUNCTION_NAME: Function name - auto-captured
+ * - AWS_LAMBDA_FUNCTION_VERSION: Function version - auto-captured
+ *
+ * @example
+ * import { logger } from './Logger';
+ *
+ * logger.info('Application started', { source: 'App.main' });
+ *
+ * logger.error('Failed to load config', {
+ *   code: 'CONFIG_LOAD_ERROR',
+ *   source: 'ConfigService.load',
+ *   error: err
+ * });
+ *
+ * // Performance tracking
+ * const timer = logger.startTimer();
+ * await processData();
+ * timer.end('processData', { source: 'DataProcessor.process', recordCount: 100 });
+ *
+ * // CloudWatch Insights query examples:
+ *
+ * // Find specific error codes:
+ * // fields @timestamp, message, code, source
+ * // | filter code = "DB_CONNECTION_ERROR"
+ * // | sort @timestamp desc
+ *
+ * // Track errors by source:
+ * // fields @timestamp, message, source
+ * // | filter source like /UserService/
+ * // | stats count() by source
+ *
+ * // Monitor cold starts:
+ * // fields @timestamp, message, coldStart, duration
+ * // | filter coldStart = true
+ * // | stats count() as coldStartCount
+ *
+ * // Track slow operations:
+ * // fields @timestamp, message, duration, source
+ * // | filter duration > 1000
+ * // | sort duration desc
+ * // | limit 20
+ */
+export const logger = new Logger();
+/**
+ * Default export for convenience
+ */
+export default logger;
+//# sourceMappingURL=Logger.js.map

package/dist/logger/Logger.js.map

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

package/dist/middleware/RequestLogger.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Request logging middleware for API routes
+ * Extends the base Logger with HTTP-specific context
+ *
+ * @module RequestLogger
+ */
+interface RequestLoggerInterface {
+    info: (message: string, context?: Record<string, any>) => void;
+    error: (message: string, context?: Record<string, any>) => void;
+    warn: (message: string, context?: Record<string, any>) => void;
+    debug: (message: string, context?: Record<string, any>) => void;
+}
+interface RequestEvent {
+    requestContext?: {
+        requestId?: string;
+        http?: {
+            method: string;
+            path: string;
+        };
+        identity?: {
+            sourceIp?: string;
+        };
+    };
+    httpMethod?: string;
+    path?: string;
+    headers?: Record<string, any>;
+    body?: string;
+    queryStringParameters?: Record<string, any>;
+    pathParameters?: Record<string, any>;
+}
+interface ResponseObject {
+    statusCode: number;
+    [key: string]: any;
+}
+/**
+ * Creates a request-scoped logger with HTTP context
+ *
+ * @param {Object} request - AWS Lambda event or custom request object
+ * @param {string} request.requestContext.requestId - Request ID
+ * @param {string} request.httpMethod - HTTP method
+ * @param {string} request.path - Request path
+ * @returns {Object} Logger with request context
+ */
+export declare function createRequestLogger(event: RequestEvent): RequestLoggerInterface;
+/**
+ * Middleware to automatically log incoming requests
+ *
+ * @param {Object} event - AWS Lambda event
+ * @returns {void}
+ */
+export declare function logRequest(event: RequestEvent): void;
+/**
+ * Middleware to log outgoing responses
+ *
+ * @param {Object} event - AWS Lambda event
+ * @param {Object} response - API response
+ * @param {number} durationMs - Request duration in milliseconds
+ * @returns {void}
+ */
+export declare function logResponse(event: RequestEvent, response: ResponseObject, durationMs: number): void;
+export {};
+//# sourceMappingURL=RequestLogger.d.ts.map

package/dist/middleware/RequestLogger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RequestLogger.d.ts","sourceRoot":"","sources":["../../src/middleware/RequestLogger.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,UAAU,sBAAsB;IAC9B,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,IAAI,CAAC;IAC/D,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,IAAI,CAAC;IAChE,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,IAAI,CAAC;IAC/D,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,IAAI,CAAC;CACjE;AAED,UAAU,YAAY;IACpB,cAAc,CAAC,EAAE;QACf,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,IAAI,CAAC,EAAE;YACL,MAAM,EAAE,MAAM,CAAC;YACf,IAAI,EAAE,MAAM,CAAC;SACd,CAAC;QACF,QAAQ,CAAC,EAAE;YACT,QAAQ,CAAC,EAAE,MAAM,CAAC;SACnB,CAAC;KACH,CAAC;IACF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qBAAqB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC5C,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CACtC;AAED,UAAU,cAAc;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,YAAY,GAAG,sBAAsB,CAuB/E;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,CAQpD;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,YAAY,EACnB,QAAQ,EAAE,cAAc,EACxB,UAAU,EAAE,MAAM,GACjB,IAAI,CAUN"}