@nicollasfrazao/liguelead-log-service 1.0.0

package/dist/services/log.service.js

@@ -0,0 +1,572 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LogService = void 0;
+const uuid_1 = require("uuid");
+const log_service_config_1 = require("../configs/log.service.config");
+const log_storage_service_1 = require("./log.storage.service");
+const log_error_1 = require("../errors/log.error");
+/**
+ * Class LogService
+ *
+ * Responsible for logging messages with different severity levels
+ *
+ * @property {LogServiceConfigInterface} config
+ * @property {LogStorageService} logStorageService
+ * @property {string} correlationId
+ * @property {Promise<void>} writeQueue
+ */
+class LogService {
+    /**
+     * Sets the correlation ID for log entries
+     *
+     * @param {string} correlationId
+     *
+     * @returns {void}
+     */
+    static setCorrelationId(correlationId) {
+        this.correlationId = correlationId ?? (0, uuid_1.v4)();
+    }
+    /**
+     * Gets the current correlation ID
+     *
+     * @returns {string} The current correlation ID
+     */
+    static getCorrelationId() {
+        return this.correlationId;
+    }
+    /**
+     * Determines if a log message should be logged based on its level
+     *
+     * @param {LogType['level']} level The level of the log message
+     *
+     * @returns {boolean} True if the message should be logged, false otherwise
+     */
+    static shouldLog(level) {
+        if (!this.config.useLog) {
+            return false;
+        }
+        const levels = [
+            'error',
+            'warn',
+            'info',
+            'debug'
+        ];
+        const configLevelIndex = levels.indexOf(this.config.level);
+        const messageLevel = levels.indexOf(level);
+        return messageLevel <= configLevelIndex;
+    }
+    /**
+     * Formats the log data into a string
+     *
+     * @param {LogType} data The log data to format
+     *
+     * @returns {string} The formatted log string
+     */
+    static formatLog(data) {
+        return JSON.stringify(data);
+    }
+    /**
+     * Gets the current timestamp
+     *
+     * @returns {string} The current timestamp
+     */
+    static getTimestamp() {
+        return this.config.timestampFormat === 'iso'
+            ? new Date().toISOString()
+            : Date.now().toString();
+    }
+    /**
+     * Colorizes the log text based on the log level
+     *
+     * @param {LogType['level']} data The log level
+     *
+     * @returns {string} The colorized log text
+     */
+    static colorizeLogOutput(data) {
+        const logOutput = this.formatLog(data);
+        if (!this.config.useColors) {
+            return logOutput;
+        }
+        /**
+         * ANSI color codes
+         *
+         * @error red
+         * @warn yellow
+         * @info cyan
+         * @debug gray
+         */
+        const colors = {
+            error: '\x1b[31m',
+            warn: '\x1b[33m',
+            info: '\x1b[36m',
+            debug: '\x1b[90m'
+        };
+        const reset = '\x1b[0m';
+        return `${colors[data.level]}${logOutput}${reset}`;
+    }
+    /**
+     * Creates a log entry
+     *
+     * @param {LogType['level']} level The log level
+     * @param {string} message The log message
+     * @param {LogContextType} context The log context
+     *
+     * @returns {LogType} The created log entry
+     */
+    static createLogEntry(level, message, context) {
+        return {
+            timestamp: this.getTimestamp(),
+            level,
+            environment: this.config.environment,
+            service: this.config.service,
+            correlation_id: this.correlationId,
+            message: `${this.config.logPrefix} ${message}`,
+            context
+        };
+    }
+    /**
+     * Logs an informational message
+     *
+     * @param {string} message The log message
+     * @param {LogContextType} context The log context
+     *
+     * @returns {void}
+     */
+    static info(message, context) {
+        if (!this.shouldLog('info')) {
+            return;
+        }
+        const log = this.createLogEntry('info', message, context);
+        this.writeLog(log);
+    }
+    /**
+     * Logs a warning message
+     *
+     * @param {string} message The warning message
+     * @param {LogContextType} context The log context
+     *
+     * @returns {void}
+     */
+    static warn(message, context) {
+        if (!this.shouldLog('warn')) {
+            return;
+        }
+        const log = this.createLogEntry('warn', message, context);
+        this.writeLog(log);
+    }
+    /**
+     * Logs an error message
+     *
+     * @param {string} message The error message
+     * @param {LogContextType} context The log context
+     *
+     * @returns {void}
+     */
+    static error(message, context) {
+        if (!this.shouldLog('error')) {
+            return;
+        }
+        const log = this.createLogEntry('error', message, context);
+        this.writeLog(log);
+    }
+    /**
+     * Logs a debug message
+     *
+     * @param {string} message The debug message
+     * @param {LogContextType} context The log context
+     *
+     * @returns {void}
+     */
+    static debug(message, context) {
+        if (!this.shouldLog('debug')) {
+            return;
+        }
+        const log = this.createLogEntry('debug', message, context);
+        this.writeLog(log);
+    }
+    /**
+     * Function to sanitize sensitive data
+     *
+     * @param {any} body
+     *
+     * @returns {any}
+     */
+    static sanitizeBody(body) {
+        if (!body) {
+            return body;
+        }
+        if (typeof body === 'string') {
+            try {
+                body = JSON.parse(body);
+            }
+            catch {
+                return body.length > this.config.maxBodySize
+                    ? `${body.substring(0, this.config.maxBodySize)}... [TRUNCATED]`
+                    : body;
+            }
+        }
+        if (typeof body !== 'object') {
+            return body;
+        }
+        /**
+         * Recursively sanitize an object
+         *
+         * @param {LogServiceConfigInterface} config The log service configuration
+         * @param {any} obj The object to sanitize
+         * @param {WeakSet} visited Set to track visited objects and prevent circular references
+         *
+         * @returns {any} The sanitized object
+         */
+        function sanitizeRecursive(config, obj, visited = new WeakSet()) {
+            if (obj
+                && typeof obj === 'object'
+                && visited.has(obj)) {
+                return '[CIRCULAR REFERENCE]';
+            }
+            if (Array.isArray(obj)) {
+                visited.add(obj);
+                return obj.map(item => sanitizeRecursive(config, item, visited));
+            }
+            if (obj
+                && typeof obj === 'object') {
+                visited.add(obj);
+                const result = {};
+                for (const [key, value] of Object.entries(obj)) {
+                    if (config.sensitiveFields.some(field => key.toLowerCase().includes(field.toLowerCase()))) {
+                        result[key] = '[REDACTED]';
+                    }
+                    else if (typeof value === 'object') {
+                        result[key] = sanitizeRecursive(config, value, visited);
+                    }
+                    else {
+                        result[key] = value;
+                    }
+                }
+                return result;
+            }
+            return obj;
+        }
+        if (Array.isArray(body)) {
+            return body.map(item => sanitizeRecursive(this.config, item));
+        }
+        const sanitized = { ...body };
+        const sanitizedResult = sanitizeRecursive(this.config, sanitized);
+        const stringified = JSON.stringify(sanitizedResult);
+        if (stringified.length > this.config.maxBodySize) {
+            const truncated = stringified.substring(0, this.config.maxBodySize);
+            return `${truncated}... [TRUNCATED]`;
+        }
+        return sanitizedResult;
+    }
+    /**
+     * Get the client IP address from the request
+     *
+     * @param {Request} request The Express request object
+     *
+     * @returns {string} The client IP address
+     */
+    static getClientIp(request) {
+        return request?.ip
+            || request?.connection?.remoteAddress
+            || request?.socket?.remoteAddress
+            || request?.connection?.socket?.remoteAddress
+            || request?.headers['x-forwarded-for']?.toString().split(',')[0]?.trim()
+            || request?.headers['x-real-ip']?.toString()
+            || '127.0.0.1';
+    }
+    /**
+     * Writes log data to the configured destinations (console, storage, or both)
+     *
+     * @param {LogType} data The log data to write
+     *
+     * @returns {void}
+     */
+    static writeLog(data) {
+        const config = this.config;
+        if ([
+            'console',
+            'both'
+        ].includes(config.logDestination)) {
+            this.writeToConsole(data);
+        }
+        if ([
+            'storage',
+            'both'
+        ].includes(config.logDestination)) {
+            this.writeQueue = this.writeQueue.then(async () => {
+                try {
+                    await this.writeToStorage(data);
+                }
+                catch (error) {
+                    console.error('Error writing log to storage, falling back to console log:', error);
+                    this.writeToConsole(data);
+                }
+            }).catch(error => {
+                console.error('Error in log queue:', error);
+            });
+        }
+    }
+    /**
+     * Initializes the LoggingStorageService if not already initialized
+     *
+     * @returns {void}
+     */
+    static initializeLogStorageService() {
+        if (!this.logStorageService) {
+            try {
+                this.logStorageService = new log_storage_service_1.LogStorageService(this.config);
+            }
+            catch (error) {
+                console.error('Failed to initialize LogStorageService:', error);
+                this.logStorageService = null;
+            }
+        }
+    }
+    /**
+     * Writes log data to the appropriate storage (file or S3)
+     *
+     * @param {LogType} data The log data to write
+     *
+     * @returns {Promise<void>}
+     */
+    static async writeToStorage(data) {
+        this.initializeLogStorageService();
+        if (this.logStorageService) {
+            await this.logStorageService.write(data);
+        }
+    }
+    /**
+     * Writes log data to the console with appropriate color coding
+     *
+     * @param {LogType} data The log data to write
+     *
+     * @returns {void}
+     */
+    static writeToConsole(data) {
+        switch (data.level) {
+            case 'info':
+                console.info(this.colorizeLogOutput(data));
+                break;
+            case 'warn':
+                console.warn(this.colorizeLogOutput(data));
+                break;
+            case 'error':
+                console.error(this.colorizeLogOutput(data));
+                break;
+            case 'debug':
+                console.debug(this.colorizeLogOutput(data));
+                break;
+        }
+    }
+    /**
+     * Helper method to execute request calls with logging
+     *
+     * @param {() => Promise<any>} requestCall - The request call function
+     * @param {string} requestMethod - The HTTP method (GET, POST, etc.)
+     * @param {string} requestUrl - The request endpoint URL
+     * @param {string} requestName - The name of the external request for logging purposes
+     * @param {any} requestBody - The request body (if applicable)
+     * @param {Request} requestOrigin - The original Express request
+     *
+     * @returns {Promise<T>} - The request response
+     */
+    static async executeRequestWithLogging(requestCall, requestMethod, requestUrl, requestName, requestBody, requestOrigin) {
+        const startTime = Date.now();
+        try {
+            const response = await requestCall();
+            const duration = Date.now() - startTime;
+            this.logExternalRequestCall(requestMethod, requestUrl, requestName, requestOrigin, requestBody, response.status, duration, response.data);
+            return response;
+        }
+        catch (error) {
+            const duration = Date.now() - startTime;
+            const statusCode = error?.response?.status || 500;
+            const errorMessage = error?.response?.data?.message || 'Internal error';
+            const responseBody = error?.response?.data || {};
+            this.logExternalRequestCall(requestMethod, requestUrl, requestName, requestBody, requestOrigin, statusCode, duration, responseBody, error);
+            throw new log_error_1.LogError(errorMessage, statusCode);
+        }
+    }
+    /**
+     * Logs an external request call
+     *
+     * @param {string} requestMethod
+     * @param {string} requestUrl
+     * @param {string} requestName
+     * @param {Request} requestOrigin
+     * @param {any} requestBody
+     * @param {number} statusCode
+     * @param {number} duration
+     * @param {any} responseBody
+     * @param {Error} error
+     *
+     * @returns {void}
+     */
+    static logExternalRequestCall(requestMethod, requestUrl, requestName, requestOrigin, requestBody, statusCode, duration, responseBody, error) {
+        if (this.config.logExternalRequestCalls !== true) {
+            return;
+        }
+        const additionalData = {
+            method: requestMethod,
+            url: requestUrl,
+            request: this.sanitizeBody(requestBody),
+            response: this.sanitizeBody(responseBody),
+            response_time: duration
+        };
+        let context;
+        if (requestOrigin) {
+            context = this.createContextFromRequest(requestOrigin, additionalData);
+        }
+        else {
+            context = this.createContextFromData(additionalData);
+        }
+        const message = 'External request call'
+            + (requestName
+                ? ` to ${requestName}`
+                : '');
+        if (error) {
+            this.error(`${message} failed: ${error.message}`, {
+                ...context,
+                error: error.message,
+                stack: error.stack,
+                status_code: statusCode
+            });
+        }
+        else {
+            this.info(`${message} completed`, {
+                ...context,
+                status_code: statusCode
+            });
+        }
+    }
+    /**
+     * Creates a log context from an Express request
+     *
+     * @param {Request} request The Express request
+     * @param {Partial<LogContextType>} additionalData Additional data to include in the context
+     *
+     * @returns {LogContextType} The created log context
+     */
+    static createContextFromRequest(request, additionalData) {
+        const context = {};
+        if (this.config.includeRequestHeaders) {
+            context.headers = {
+                'content-type': request.get('Content-Type'),
+                'authorization': request.get('Authorization')
+                    ? '[REDACTED]'
+                    : undefined,
+                'x-forwarded-for': request.get('X-Forwarded-For'),
+                'accept': request.get('Accept'),
+                'api-token': request.get('api-token')
+                    ? '[REDACTED]'
+                    : undefined,
+                'app-id': request.get('app-id')
+                    ? '[REDACTED]'
+                    : undefined,
+            };
+        }
+        if (this.config.includeRequestBody) {
+            context.content_type = request.get('Content-Type') || '';
+            if (context.content_type.includes('multipart/form-data')) {
+                context.request = {
+                    type: 'multipart/form-data',
+                    note: 'Details will be logged after processing'
+                };
+            }
+            else if (request.body
+                && Object.keys(request.body).length > 0) {
+                context.request = this.sanitizeBody(request.body);
+            }
+        }
+        return {
+            ...context,
+            method: request.method,
+            url: request.originalUrl || request.url,
+            user_agent: request.get('User-Agent'),
+            ip: this.getClientIp(request),
+            ...additionalData
+        };
+    }
+    /**
+     * Creates a log context from an Express response
+     *
+     * @param {Request} request The Express request object
+     * @param {Response} response The Express response object
+     * @param {Partial<LogContextType>} additionalData Additional data to include in the context
+     *
+     * @returns {LogContextType} The created log context
+     */
+    static createContextFromResponse(request, response, additionalData) {
+        const context = this.createContextFromRequest(request);
+        context.status_code = response.statusCode;
+        if (this.config.includeResponseBody) {
+            context.response = this.sanitizeBody(additionalData?.response || response);
+        }
+        const contentType = context.content_type || '';
+        if (this.config.includeRequestBody
+            && contentType.includes('multipart/form-data')) {
+            const multipartData = {
+                type: 'multipart/form-data'
+            };
+            if (request.body
+                && Object.keys(request.body).length > 0) {
+                multipartData.fields = this.sanitizeBody(request.body);
+            }
+            if (request.file) {
+                multipartData.file = {
+                    field_name: request.file.fieldname,
+                    original_name: request.file.originalname,
+                    mime_type: request.file.mimetype,
+                    size: request.file.size
+                };
+            }
+            if (request.files
+                && Array.isArray(request.files)) {
+                multipartData.files = request.files.map((file) => ({
+                    field_name: file.fieldname,
+                    original_name: file.originalname,
+                    mime_type: file.mimetype,
+                    size: file.size
+                }));
+            }
+            context.request = multipartData;
+        }
+        return {
+            ...context,
+            ...additionalData,
+        };
+    }
+    /**
+     * Creates a log context from arbitrary data
+     *
+     * @param {Partial<LogContextType>} data The data to create the context from
+     *
+     * @returns {LogContextType} The created log context
+     */
+    static createContextFromData(data) {
+        return {
+            method: 'unknown',
+            url: 'unknown',
+            ip: this.getClientIp(),
+            ...(data ?? {})
+        };
+    }
+}
+exports.LogService = LogService;
+/**
+ * @var {LogServiceConfigInterface}
+ */
+LogService.config = (0, log_service_config_1.getLogServiceConfig)();
+/**
+ * @var {string}
+ */
+LogService.correlationId = (0, uuid_1.v4)();
+/**
+ * @var {LogStorageService|null}
+ */
+LogService.logStorageService = null;
+/**
+ * @var {Promise<void>}
+ */
+LogService.writeQueue = Promise.resolve();
+//# sourceMappingURL=log.service.js.map

package/dist/services/log.service.js.map

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

package/dist/services/log.storage.base.service.d.ts

@@ -0,0 +1,77 @@
+import { LogStorageBaseServiceInterface } from '../interfaces/log.storage.base.service.interface';
+import { LogServiceConfigInterface } from '../interfaces/log.service.config.interface';
+import { LogType } from '../types/log.type';
+/**
+ * Abstract Class LogStorageBaseService
+ *
+ * Base class for logging storage target services (e.g., local file system, S3)
+ *
+ * @property {LogServiceConfigInterface} logServiceConfig
+ * @property {string} baseLogsDirectory
+ */
+export declare abstract class LogStorageBaseService implements LogStorageBaseServiceInterface {
+    /**
+     * @var {string}
+     */
+    protected baseLogsDirectory: string;
+    /**
+     * @var {LogServiceConfigInterface}
+     */
+    protected logServiceConfig: LogServiceConfigInterface;
+    /**
+     * Constructor of the LogStorageTargetService
+     *
+     * @param logServiceConfig - Configuration for the logging service
+     * @param baseLogsDirectory - Base directory for storing logs
+     */
+    constructor(logServiceConfig: LogServiceConfigInterface, baseLogsDirectory: string);
+    /**
+     * Gets the logs directory for the current environment
+     *
+     * @returns {string} The environment-specific logs directory
+     */
+    protected getLogsDirectory(): string;
+    /**
+     * Gets the combined log file name for the current date
+     *
+     * @returns {string} The combined log file name
+     */
+    private getCombinedLogFileName;
+    /**
+     * Gets the combined log file path
+     *
+     * @returns {string} The combined log file path
+     */
+    protected getCombinedLogFilePath(): string;
+    /**
+     * Gets the log file name for the date and level
+     *
+     * @param {LogType['level']} level The log level
+     *
+     * @returns {string} The log file name
+     */
+    private getLevelLogFileName;
+    /**
+     * Gets the log file name for the date and level
+     *
+     * @param {LogType['level']} level The log level
+     *
+     * @returns {string} The log file path
+     */
+    protected getLevelLogFilePath(level: LogType['level']): string;
+    /**
+     * Writes log data to the storage
+     *
+     * @param {LogType} data - Log data to be written
+     *
+     * @returns {Promise<void>}
+     */
+    abstract write(data: LogType): Promise<void>;
+    /**
+     * Indicates if the storage target should be used
+     *
+     * @returns {boolean} True if the storage target should be used, false otherwise
+     */
+    abstract shouldUse(): boolean;
+}
+//# sourceMappingURL=log.storage.base.service.d.ts.map

package/dist/services/log.storage.base.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log.storage.base.service.d.ts","sourceRoot":"","sources":["../../src/services/log.storage.base.service.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,8BAA8B,EAAE,MAAM,kDAAkD,CAAC;AAClG,OAAO,EAAE,yBAAyB,EAAE,MAAM,4CAA4C,CAAC;AACvF,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAE5C;;;;;;;GAOG;AACH,8BAAsB,qBAAsB,YAAW,8BAA8B;IAEnF;;OAEG;IACH,SAAS,CAAC,iBAAiB,EAAE,MAAM,CAAC;IAEpC;;OAEG;IACH,SAAS,CAAC,gBAAgB,EAAE,yBAAyB,CAAC;IAEtD;;;;;OAKG;gBAED,gBAAgB,EAAE,yBAAyB,EAC3C,iBAAiB,EAAE,MAAM;IAM3B;;;;OAIG;IACH,SAAS,CAAC,gBAAgB,IAAI,MAAM;IAQpC;;;;OAIG;IACH,OAAO,CAAC,sBAAsB;IAQ9B;;;;OAIG;IACH,SAAS,CAAC,sBAAsB,IAAI,MAAM;IAQ1C;;;;;;OAMG;IACH,OAAO,CAAC,mBAAmB;IAQ3B;;;;;;OAMG;IACH,SAAS,CAAC,mBAAmB,CAAC,KAAK,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,MAAM;IAQ9D;;;;;;OAMG;IACH,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAE5C;;;;OAIG;IACH,QAAQ,CAAC,SAAS,IAAI,OAAO;CAC9B"}