@heavybit/logger-ts 1.0.0

package/dist/middleware/loggingMiddleware.js

@@ -0,0 +1,225 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.morganStyleMiddleware = exports.errorLoggingMiddleware = exports.loggingMiddleware = exports.createLoggingMiddleware = void 0;
+const uuid_1 = require("uuid");
+const logger_1 = require("../lib/logger");
+const config_1 = require("../config");
+const sanitize_1 = require("../utils/sanitize");
+/**
+ * Filter sensitive data from request body
+ */
+const filterSensitiveBody = (body) => {
+    return (0, sanitize_1.sanitizeData)(body);
+};
+/**
+ * Filter sensitive headers
+ */
+const filterSensitiveHeaders = (headers) => {
+    return (0, sanitize_1.sanitizeHeaders)(headers);
+};
+/**
+ * Create the Express logging middleware with configuration options
+ *
+ * @param options - Middleware configuration options
+ * @returns Express middleware function
+ */
+const createLoggingMiddleware = (options = {}) => {
+    const { skipEndpoints = [], logRequestBody = true, logResponseBody = false, requestIdGenerator = uuid_1.v4, additionalFields, } = options;
+    return (req, res, next) => {
+        const logger = (0, logger_1.getLogger)();
+        const config = (0, config_1.getConfig)();
+        // Get health check endpoint from config or options
+        const healthCheckEndpoint = config.healthCheckEndpoint || '/health';
+        const allSkipEndpoints = [...skipEndpoints, healthCheckEndpoint];
+        // Check if this endpoint should be skipped
+        if (allSkipEndpoints.some((endpoint) => req.path === endpoint || req.path.startsWith(endpoint))) {
+            return next();
+        }
+        // Generate unique request ID
+        const requestId = requestIdGenerator();
+        req.requestId = requestId;
+        // Store request body for logging
+        const requestBody = req.body;
+        // Capture start time
+        const startTime = Date.now();
+        req.startTime = startTime;
+        // Log incoming request
+        const logRequest = () => {
+            if (req.url && req.method) {
+                const logData = {
+                    level: 'info',
+                    message: 'Incoming request',
+                    requestId,
+                    method: req.method,
+                    url: req.originalUrl,
+                    timestamp: new Date().toISOString(),
+                };
+                // Add headers if not too large
+                const filteredHeaders = filterSensitiveHeaders(req.headers);
+                if (Object.keys(filteredHeaders).length <= 20) {
+                    logData.headers = filteredHeaders;
+                }
+                // Add body if enabled
+                if (logRequestBody && requestBody && Object.keys(requestBody).length > 0) {
+                    logData.body = filterSensitiveBody(requestBody);
+                }
+                // Add additional fields if provided
+                if (additionalFields) {
+                    const extra = additionalFields(req);
+                    Object.assign(logData, extra);
+                }
+                logger.info((0, logger_1.formatLogEntry)(logData));
+            }
+        };
+        // Log the incoming request
+        logRequest();
+        // Capture response body if enabled
+        let responseBody = '';
+        if (logResponseBody) {
+            const originalWrite = res.write.bind(res);
+            const originalEnd = res.end.bind(res);
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            res.write = function (chunk, ...args) {
+                if (chunk) {
+                    responseBody += String(chunk);
+                }
+                return originalWrite(chunk, ...args);
+            };
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            res.end = function (chunk, ...args) {
+                if (chunk && typeof chunk !== 'function') {
+                    responseBody += String(chunk);
+                }
+                return originalEnd(chunk, ...args);
+            };
+        }
+        // Event listener for when the response finishes
+        res.on('finish', () => {
+            const duration = Date.now() - startTime;
+            const logLevel = res.statusCode >= 400 ? 'error' : 'info';
+            const logData = {
+                level: logLevel,
+                message: 'Request completed',
+                requestId,
+                method: req.method,
+                url: req.originalUrl,
+                statusCode: res.statusCode,
+                responseTime: `${duration}ms`,
+                timestamp: new Date().toISOString(),
+            };
+            // Include request body for error responses
+            if (logLevel === 'error' && requestBody && Object.keys(requestBody).length > 0) {
+                logData.body = filterSensitiveBody(requestBody);
+            }
+            // Include response body if captured
+            if (logResponseBody && responseBody) {
+                try {
+                    const parsedBody = JSON.parse(responseBody);
+                    logData.body = {
+                        ...(logData.body || {}),
+                        response: (0, sanitize_1.sanitizeData)(parsedBody),
+                    };
+                }
+                catch {
+                    // Response is not JSON, skip
+                }
+            }
+            // Add additional fields
+            if (additionalFields) {
+                const extra = additionalFields(req);
+                Object.assign(logData, extra);
+            }
+            logger.log(logLevel, (0, logger_1.formatLogEntry)(logData));
+        });
+        // Event listener for response errors
+        res.on('error', (err) => {
+            const duration = Date.now() - startTime;
+            logger.error((0, logger_1.formatLogEntry)({
+                level: 'error',
+                message: 'Request failed',
+                requestId,
+                method: req.method,
+                url: req.originalUrl,
+                statusCode: res.statusCode,
+                responseTime: `${duration}ms`,
+                error: err.message,
+                body: filterSensitiveBody(requestBody),
+                timestamp: new Date().toISOString(),
+            }));
+        });
+        next();
+    };
+};
+exports.createLoggingMiddleware = createLoggingMiddleware;
+/**
+ * Default logging middleware (uses default configuration)
+ */
+exports.loggingMiddleware = (0, exports.createLoggingMiddleware)();
+/**
+ * Error logging middleware for Express error handling
+ */
+const errorLoggingMiddleware = (err, req, _res, next) => {
+    const logger = (0, logger_1.getLogger)();
+    const startTime = req.startTime || Date.now();
+    const duration = Date.now() - startTime;
+    logger.error((0, logger_1.formatLogEntry)({
+        level: 'error',
+        message: 'Unhandled error',
+        requestId: req.requestId,
+        method: req.method,
+        url: req.originalUrl,
+        statusCode: err.statusCode || err.status || 500,
+        responseTime: `${duration}ms`,
+        error: err.message,
+        body: (0, sanitize_1.sanitizeData)(req.body),
+        timestamp: new Date().toISOString(),
+    }));
+    // Pass to next error handler
+    next(err);
+};
+exports.errorLoggingMiddleware = errorLoggingMiddleware;
+/**
+ * Morgan-style request logging format
+ * Returns a middleware that logs in a standardized format
+ */
+const morganStyleMiddleware = (format = 'dev') => {
+    return (req, res, next) => {
+        const logger = (0, logger_1.getLogger)();
+        const startTime = Date.now();
+        const requestId = (0, uuid_1.v4)();
+        req.requestId = requestId;
+        res.on('finish', () => {
+            const duration = Date.now() - startTime;
+            let logMessage = '';
+            switch (format) {
+                case 'combined':
+                    logMessage = `${req.ip} - - [${new Date().toISOString()}] "${req.method} ${req.originalUrl} HTTP/${req.httpVersion}" ${res.statusCode} - "${req.get('referer') || '-'}" "${req.get('user-agent') || '-'}"`;
+                    break;
+                case 'common':
+                    logMessage = `${req.ip} - - [${new Date().toISOString()}] "${req.method} ${req.originalUrl} HTTP/${req.httpVersion}" ${res.statusCode} -`;
+                    break;
+                case 'dev':
+                    logMessage = `${req.method} ${req.originalUrl} ${res.statusCode} ${duration}ms`;
+                    break;
+                case 'short':
+                    logMessage = `${req.ip} ${req.method} ${req.originalUrl} ${res.statusCode} - ${duration}ms`;
+                    break;
+                case 'tiny':
+                    logMessage = `${req.method} ${req.originalUrl} ${res.statusCode} - ${duration}ms`;
+                    break;
+            }
+            const level = res.statusCode >= 400 ? 'error' : 'info';
+            logger.log(level, logMessage, {
+                requestId,
+                method: req.method,
+                url: req.originalUrl,
+                statusCode: res.statusCode,
+                responseTime: `${duration}ms`,
+            });
+        });
+        next();
+    };
+};
+exports.morganStyleMiddleware = morganStyleMiddleware;
+exports.default = exports.loggingMiddleware;
+//# sourceMappingURL=loggingMiddleware.js.map

package/dist/middleware/loggingMiddleware.js.map

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

package/dist/types/index.d.ts

@@ -0,0 +1,208 @@
+import { Request, Response, NextFunction } from 'express';
+import winston from 'winston';
+/**
+ * Supported log levels
+ */
+export type LogLevel = 'error' | 'warn' | 'info' | 'http' | 'verbose' | 'debug' | 'silly';
+/**
+ * Types of application classes for context-aware logging
+ */
+export type ClassType = 'controllers' | 'services' | 'repositories' | 'utils' | 'middleware' | 'routes' | 'configuration' | 'validators' | 'eventListeners' | 'helpers' | 'jobs' | 'models' | 'transformers' | 'default' | 'unknown';
+/**
+ * Log output targets
+ */
+export type LogTarget = 'stdout' | 'file' | 'both';
+/**
+ * Configuration for file-based logging
+ */
+export interface FileLogConfig {
+    /** Directory for log files (default: 'logs') */
+    directory: string;
+    /** Maximum size of log file before rotation (default: '50m') */
+    maxSize: string;
+    /** Maximum retention period for log files (default: '30d') */
+    maxFiles: string;
+    /** Whether to compress archived logs (default: true) */
+    zippedArchive: boolean;
+    /** Date pattern for log file naming (default: 'YYYY-MM-DD') */
+    datePattern: string;
+    /** Log level for file output (default: 'info') */
+    level: LogLevel;
+}
+/**
+ * Configuration for console/stdout logging
+ */
+export interface ConsoleLogConfig {
+    /** Whether to colorize console output (default: true in development) */
+    colorize: boolean;
+    /** Log level for console output (default: 'debug') */
+    level: LogLevel;
+}
+/**
+ * Main logger configuration
+ */
+export interface LoggerConfig {
+    /** Where to output logs: 'stdout', 'file', or 'both' */
+    target: LogTarget;
+    /** Default log level if not specified by class type */
+    defaultLevel: LogLevel;
+    /** Console/stdout configuration */
+    console: ConsoleLogConfig;
+    /** File logging configuration */
+    file: FileLogConfig;
+    /** Log levels per class type */
+    classLevels: Partial<Record<ClassType, LogLevel>>;
+    /** Application name for log identification */
+    appName?: string;
+    /** Environment name (development, staging, production) */
+    environment?: string;
+    /** Custom sensitive fields to redact */
+    sensitiveFields?: string[];
+    /** Health check endpoint to skip logging */
+    healthCheckEndpoint?: string;
+}
+/**
+ * Base log entry structure
+ */
+export interface BaseLogEntry {
+    level?: LogLevel;
+    message: string;
+    timestamp?: string;
+    [key: string]: unknown;
+}
+/**
+ * HTTP request log entry
+ */
+export interface RequestLogEntry extends BaseLogEntry {
+    requestId?: string;
+    method?: string;
+    url?: string;
+    statusCode?: number;
+    responseTime?: string;
+    body?: Record<string, unknown>;
+    headers?: Record<string, unknown>;
+    error?: string | Error;
+}
+/**
+ * AOP context for method logging
+ */
+export interface AOPContext {
+    methodName: string;
+    methodType: string;
+    classType: ClassType;
+    className: string;
+    startTime: number;
+    endTime?: number;
+    executionTime?: number;
+    url?: string;
+    method?: string;
+    body?: Record<string, unknown>;
+    result?: unknown;
+    responseBody?: unknown;
+    statusCode?: number;
+    message?: string;
+    error?: Error;
+    level?: LogLevel;
+    logType?: 'info' | 'error';
+}
+/**
+ * Advice type for AOP logging
+ */
+export type AdviceType = 'before' | 'after' | 'around';
+/**
+ * Advice phase during execution
+ */
+export type AdvicePhase = 'before' | 'after' | 'error';
+/**
+ * Advice function signature
+ */
+export type AdviceFunction = (context: AOPContext, phase: AdvicePhase) => void;
+/**
+ * Extended Express Request with logging properties
+ */
+export interface LoggingRequest extends Request {
+    requestId?: string;
+    startTime?: number;
+}
+/**
+ * Middleware function type
+ */
+export type LoggingMiddleware = (req: LoggingRequest, res: Response, next: NextFunction) => void;
+/**
+ * Middleware configuration options
+ */
+export interface MiddlewareOptions {
+    /** Endpoints to skip logging */
+    skipEndpoints?: string[];
+    /** Whether to log request body */
+    logRequestBody?: boolean;
+    /** Whether to log response body */
+    logResponseBody?: boolean;
+    /** Custom request ID generator */
+    requestIdGenerator?: () => string;
+    /** Additional fields to extract from request */
+    additionalFields?: (req: Request) => Record<string, unknown>;
+}
+/**
+ * Extended Winston logger with custom methods
+ */
+export interface ExtendedLogger extends winston.Logger {
+    /** Log with request context */
+    logRequest(entry: RequestLogEntry): void;
+    /** Log with custom metadata */
+    logWithMeta(level: LogLevel, message: string, meta?: Record<string, unknown>): void;
+    /** Get the current configuration */
+    getConfig(): LoggerConfig;
+}
+/**
+ * Object with string keys and any values (for sanitization)
+ */
+export type SanitizableObject = Record<string, unknown>;
+/**
+ * Result of log formatting
+ */
+export interface FormattedLogEntry {
+    level: LogLevel;
+    message: string;
+    requestId: string;
+    method: string;
+    methodName: string;
+    url: string;
+    statusCode: string;
+    responseTime: string;
+    timestamp: string;
+    body: Record<string, unknown>;
+    error: string;
+}
+/**
+ * Environment variable names used by the logger
+ */
+export interface LoggerEnvVars {
+    LOG_TARGET: LogTarget;
+    LOG_TO_FILE: 'true' | 'false';
+    LOG_TO_CONSOLE: 'true' | 'false';
+    LOG_LEVEL: LogLevel;
+    LOG_DIR: string;
+    LOG_MAX_SIZE: string;
+    LOG_MAX_FILES: string;
+    LOG_DATE_PATTERN: string;
+    LOG_COLORIZE: 'true' | 'false';
+    LOG_LEVEL_CONTROLLERS: LogLevel;
+    LOG_LEVEL_SERVICES: LogLevel;
+    LOG_LEVEL_REPOSITORIES: LogLevel;
+    LOG_LEVEL_UTILS: LogLevel;
+    LOG_LEVEL_MIDDLEWARE: LogLevel;
+    LOG_LEVEL_ROUTES: LogLevel;
+    LOG_LEVEL_CONFIGURATION: LogLevel;
+    LOG_LEVEL_VALIDATORS: LogLevel;
+    LOG_LEVEL_EVENT_LISTENERS: LogLevel;
+    LOG_LEVEL_HELPERS: LogLevel;
+    LOG_LEVEL_JOBS: LogLevel;
+    LOG_LEVEL_MODELS: LogLevel;
+    LOG_LEVEL_TRANSFORMERS: LogLevel;
+    LOG_LEVEL_DEFAULT: LogLevel;
+    APP_NAME: string;
+    NODE_ENV: string;
+    HEALTHCHECK_ENDPOINT: string;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

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

package/dist/types/index.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":""}

package/dist/utils/sanitize.d.ts

@@ -0,0 +1,26 @@
+import { SanitizableObject } from '../types';
+/**
+ * Recursively sanitize data by masking sensitive fields
+ *
+ * @param data - The data to sanitize
+ * @param sensitiveFields - Optional custom list of sensitive fields
+ * @param seen - Internal set to track circular references
+ * @returns Sanitized copy of the data
+ */
+export declare const sanitizeData: <T extends SanitizableObject | unknown>(data: T, sensitiveFields?: string[], seen?: WeakSet<object>) => T;
+/**
+ * Sanitize headers, specifically targeting authorization-type headers
+ */
+export declare const sanitizeHeaders: (headers: Record<string, string | string[] | undefined>) => Record<string, string | string[] | undefined>;
+/**
+ * Truncate large values to prevent log bloat
+ */
+export declare const truncateValue: (value: unknown, maxLength?: number) => unknown;
+/**
+ * Deep clone and sanitize for logging
+ */
+export declare const prepareForLogging: <T extends SanitizableObject>(data: T, options?: {
+    sensitiveFields?: string[];
+    truncateLength?: number;
+}) => T;
+//# sourceMappingURL=sanitize.d.ts.map

package/dist/utils/sanitize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sanitize.d.ts","sourceRoot":"","sources":["../../src/utils/sanitize.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAa7C;;;;;;;GAOG;AACH,eAAO,MAAM,YAAY,GAAI,CAAC,SAAS,iBAAiB,GAAG,OAAO,EAChE,MAAM,CAAC,EACP,kBAAkB,MAAM,EAAE,EAC1B,OAAM,OAAO,CAAC,MAAM,CAAiB,KACpC,CA6CF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,eAAe,GAC1B,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,KACrD,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CA6B9C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,aAAa,GACxB,OAAO,OAAO,EACd,YAAW,MAAa,KACvB,OAUF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,iBAAiB,GAAI,CAAC,SAAS,iBAAiB,EAC3D,MAAM,CAAC,EACP,UAAU;IACR,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,KACA,CAwBF,CAAC"}

package/dist/utils/sanitize.js

@@ -0,0 +1,132 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.prepareForLogging = exports.truncateValue = exports.sanitizeHeaders = exports.sanitizeData = void 0;
+const config_1 = require("../config");
+/**
+ * Check if a key matches any sensitive field (case-insensitive)
+ */
+const isSensitiveField = (key, sensitiveFields) => {
+    const lowerKey = key.toLowerCase();
+    return sensitiveFields.some((field) => field.toLowerCase() === lowerKey || lowerKey.includes(field.toLowerCase()));
+};
+/**
+ * Recursively sanitize data by masking sensitive fields
+ *
+ * @param data - The data to sanitize
+ * @param sensitiveFields - Optional custom list of sensitive fields
+ * @param seen - Internal set to track circular references
+ * @returns Sanitized copy of the data
+ */
+const sanitizeData = (data, sensitiveFields, seen = new WeakSet()) => {
+    // Return primitives and null/undefined as-is
+    if (data === null || data === undefined) {
+        return data;
+    }
+    if (typeof data !== 'object') {
+        return data;
+    }
+    // Prevent circular references
+    if (seen.has(data)) {
+        return '[CIRCULAR REFERENCE]';
+    }
+    seen.add(data);
+    // Get sensitive fields from config or use provided/default
+    const fieldsToMask = sensitiveFields || (0, config_1.getConfig)()?.sensitiveFields || config_1.DEFAULT_SENSITIVE_FIELDS;
+    // Handle arrays
+    if (Array.isArray(data)) {
+        return data.map((item) => (0, exports.sanitizeData)(item, fieldsToMask, seen));
+    }
+    // Handle objects
+    const sanitized = {};
+    for (const [key, value] of Object.entries(data)) {
+        if (isSensitiveField(key, fieldsToMask)) {
+            // Mask sensitive string values
+            if (typeof value === 'string') {
+                sanitized[key] = '[REDACTED]';
+            }
+            else if (value !== null && value !== undefined) {
+                sanitized[key] = '[REDACTED]';
+            }
+            else {
+                sanitized[key] = value;
+            }
+        }
+        else if (typeof value === 'object' && value !== null) {
+            sanitized[key] = (0, exports.sanitizeData)(value, fieldsToMask, seen);
+        }
+        else {
+            sanitized[key] = value;
+        }
+    }
+    return sanitized;
+};
+exports.sanitizeData = sanitizeData;
+/**
+ * Sanitize headers, specifically targeting authorization-type headers
+ */
+const sanitizeHeaders = (headers) => {
+    const sensitiveHeaders = [
+        'authorization',
+        'x-api-key',
+        'x-auth-token',
+        'cookie',
+        'set-cookie',
+        'x-access-token',
+        'x-refresh-token',
+    ];
+    const sanitized = { ...headers };
+    for (const header of sensitiveHeaders) {
+        if (sanitized[header]) {
+            sanitized[header] = '[REDACTED]';
+        }
+        // Also check lowercase and uppercase variants
+        const lowerHeader = header.toLowerCase();
+        const upperHeader = header.toUpperCase();
+        if (sanitized[lowerHeader]) {
+            sanitized[lowerHeader] = '[REDACTED]';
+        }
+        if (sanitized[upperHeader]) {
+            sanitized[upperHeader] = '[REDACTED]';
+        }
+    }
+    return sanitized;
+};
+exports.sanitizeHeaders = sanitizeHeaders;
+/**
+ * Truncate large values to prevent log bloat
+ */
+const truncateValue = (value, maxLength = 1000) => {
+    if (typeof value === 'string' && value.length > maxLength) {
+        return `${value.substring(0, maxLength)}... [TRUNCATED: ${value.length} chars]`;
+    }
+    if (Array.isArray(value) && value.length > 100) {
+        return [...value.slice(0, 100), `... [TRUNCATED: ${value.length} items]`];
+    }
+    return value;
+};
+exports.truncateValue = truncateValue;
+/**
+ * Deep clone and sanitize for logging
+ */
+const prepareForLogging = (data, options) => {
+    const sanitized = (0, exports.sanitizeData)(data, options?.sensitiveFields);
+    if (options?.truncateLength) {
+        const truncate = (obj) => {
+            if (typeof obj !== 'object' || obj === null) {
+                return (0, exports.truncateValue)(obj, options.truncateLength);
+            }
+            if (Array.isArray(obj)) {
+                return obj.map(truncate);
+            }
+            const result = {};
+            for (const [key, value] of Object.entries(obj)) {
+                result[key] = truncate(value);
+            }
+            return result;
+        };
+        return truncate(sanitized);
+    }
+    return sanitized;
+};
+exports.prepareForLogging = prepareForLogging;
+//# sourceMappingURL=sanitize.js.map

package/dist/utils/sanitize.js.map

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