@nicollasfrazao/liguelead-log-service 1.0.0

package/dist/services/log.storage.base.service.js

@@ -0,0 +1,107 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LogStorageBaseService = void 0;
+const path = __importStar(require("path"));
+/**
+ * Abstract Class LogStorageBaseService
+ *
+ * Base class for logging storage target services (e.g., local file system, S3)
+ *
+ * @property {LogServiceConfigInterface} logServiceConfig
+ * @property {string} baseLogsDirectory
+ */
+class LogStorageBaseService {
+    /**
+     * Constructor of the LogStorageTargetService
+     *
+     * @param logServiceConfig - Configuration for the logging service
+     * @param baseLogsDirectory - Base directory for storing logs
+     */
+    constructor(logServiceConfig, baseLogsDirectory) {
+        this.logServiceConfig = logServiceConfig;
+        this.baseLogsDirectory = baseLogsDirectory;
+    }
+    /**
+     * Gets the logs directory for the current environment
+     *
+     * @returns {string} The environment-specific logs directory
+     */
+    getLogsDirectory() {
+        return path.join(this.baseLogsDirectory, this.logServiceConfig.environment);
+    }
+    /**
+     * Gets the combined log file name for the current date
+     *
+     * @returns {string} The combined log file name
+     */
+    getCombinedLogFileName() {
+        const today = new Date();
+        const dateString = today.toISOString().split('T')[0];
+        return `${dateString}-combined.log`;
+    }
+    /**
+     * Gets the combined log file path
+     *
+     * @returns {string} The combined log file path
+     */
+    getCombinedLogFilePath() {
+        return path.join(this.getLogsDirectory(), this.getCombinedLogFileName());
+    }
+    /**
+     * Gets the log file name for the date and level
+     *
+     * @param {LogType['level']} level The log level
+     *
+     * @returns {string} The log file name
+     */
+    getLevelLogFileName(level) {
+        const today = new Date();
+        const dateString = today.toISOString().split('T')[0];
+        return `${dateString}-${level}.log`;
+    }
+    /**
+     * Gets the log file name for the date and level
+     *
+     * @param {LogType['level']} level The log level
+     *
+     * @returns {string} The log file path
+     */
+    getLevelLogFilePath(level) {
+        return path.join(this.getLogsDirectory(), this.getLevelLogFileName(level));
+    }
+}
+exports.LogStorageBaseService = LogStorageBaseService;
+//# sourceMappingURL=log.storage.base.service.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"log.storage.base.service.js","sourceRoot":"","sources":["../../src/services/log.storage.base.service.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,2CAA6B;AAK7B;;;;;;;GAOG;AACH,MAAsB,qBAAqB;IAYzC;;;;;OAKG;IACH,YACE,gBAA2C,EAC3C,iBAAyB;QAEzB,IAAI,CAAC,gBAAgB,GAAG,gBAAgB,CAAC;QACzC,IAAI,CAAC,iBAAiB,GAAG,iBAAiB,CAAC;IAC7C,CAAC;IAED;;;;OAIG;IACO,gBAAgB;QAExB,OAAO,IAAI,CAAC,IAAI,CACd,IAAI,CAAC,iBAAiB,EACtB,IAAI,CAAC,gBAAgB,CAAC,WAAW,CAClC,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACK,sBAAsB;QAE5B,MAAM,KAAK,GAAG,IAAI,IAAI,EAAE,CAAC;QACzB,MAAM,UAAU,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QAErD,OAAO,GAAG,UAAU,eAAe,CAAC;IACtC,CAAC;IAED;;;;OAIG;IACO,sBAAsB;QAE9B,OAAO,IAAI,CAAC,IAAI,CACd,IAAI,CAAC,gBAAgB,EAAE,EACvB,IAAI,CAAC,sBAAsB,EAAE,CAC9B,CAAC;IACJ,CAAC;IAED;;;;;;OAMG;IACK,mBAAmB,CAAC,KAAuB;QAEjD,MAAM,KAAK,GAAG,IAAI,IAAI,EAAE,CAAC;QACzB,MAAM,UAAU,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QAErD,OAAO,GAAG,UAAU,IAAI,KAAK,MAAM,CAAC;IACtC,CAAC;IAED;;;;;;OAMG;IACO,mBAAmB,CAAC,KAAuB;QAEnD,OAAO,IAAI,CAAC,IAAI,CACd,IAAI,CAAC,gBAAgB,EAAE,EACvB,IAAI,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAChC,CAAC;IACJ,CAAC;CAiBF;AA9GD,sDA8GC"}

package/dist/services/log.storage.external.s3.service.d.ts

@@ -0,0 +1,66 @@
+import { LogStorageExternalService } from './log.storage.external.service';
+import { LogServiceConfigInterface } from '../interfaces/log.service.config.interface';
+import { LogType } from '../types/log.type';
+/**
+ * Class LogStorageExternalS3Service
+ *
+ * Responsible for uploading logs to S3 bucket via Kinesis Firehose
+ *
+ * @property {FirehoseClient} firehose
+ * @property {LogStorageExternalS3ServiceConfigInterface} config
+ * @property {Map<string, Promise<void>>} writeQueue
+ */
+export declare class LogStorageExternalS3Service extends LogStorageExternalService {
+    /**
+     * @var {FirehoseClient}
+     */
+    private firehose;
+    /**
+     * @var {LogStorageExternalS3ServiceConfigInterface}
+     */
+    private config;
+    /**
+     * @var {Map<string, Promise<void>>}
+     */
+    private writeQueue;
+    /**
+     * Constructor of the LogStorageS3Service
+     *
+     * @param {LogServiceConfigInterface} logServiceConfig - Configuration for the logging service
+     */
+    constructor(logServiceConfig: LogServiceConfigInterface);
+    /**
+     * Determines if the S3 storage should be used
+     *
+     * @returns {boolean} True if the storage target should be used, false otherwise
+     */
+    shouldUse(): boolean;
+    /**
+     * Upload log content to Firehose (which delivers to S3)
+     *
+     * @param {string} key The S3 key (path) for the log file (used for metadata)
+     * @param {string} content The log content to upload
+     *
+     * @returns {Promise<void>}
+     */
+    private uploadLog;
+    /**
+     * Send log content to Firehose with queue management
+     * Firehose handles delivery to S3 with buffering and compression
+     *
+     * @param {string} key The S3 key (path) for the log file (used for metadata)
+     * @param {string} newContent The new content to send
+     *
+     * @returns {Promise<void>}
+     */
+    private appendLog;
+    /**
+     * Writes a log entry to S3 via Firehose
+     *
+     * @param {LogType} data The log data to write
+     *
+     * @returns {Promise<void>}
+     */
+    write(data: LogType): Promise<void>;
+}
+//# sourceMappingURL=log.storage.external.s3.service.d.ts.map

package/dist/services/log.storage.external.s3.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log.storage.external.s3.service.d.ts","sourceRoot":"","sources":["../../src/services/log.storage.external.s3.service.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAE3E,OAAO,EAAE,yBAAyB,EAAE,MAAM,4CAA4C,CAAC;AAEvF,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAG5C;;;;;;;;GAQG;AACH,qBAAa,2BAA4B,SAAQ,yBAAyB;IAExE;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAiB;IAEjC;;OAEG;IACH,OAAO,CAAC,MAAM,CAA6C;IAE3D;;OAEG;IACH,OAAO,CAAC,UAAU,CAAyC;IAE3D;;;;OAIG;gBACU,gBAAgB,EAAE,yBAAyB;IA4BxD;;;;OAIG;IACI,SAAS,IAAI,OAAO;IAK3B;;;;;;;OAOG;YACW,SAAS;IAmBvB;;;;;;;;OAQG;YACW,SAAS;IAgCvB;;;;;;OAMG;IACU,KAAK,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;CAoBjD"}

package/dist/services/log.storage.external.s3.service.js

@@ -0,0 +1,121 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LogStorageExternalS3Service = void 0;
+const client_firehose_1 = require("@aws-sdk/client-firehose");
+const log_storage_external_service_1 = require("./log.storage.external.service");
+const log_service_1 = require("./log.service");
+const log_storage_external_s3_config_1 = require("../configs/log.storage.external.s3.config");
+/**
+ * Class LogStorageExternalS3Service
+ *
+ * Responsible for uploading logs to S3 bucket via Kinesis Firehose
+ *
+ * @property {FirehoseClient} firehose
+ * @property {LogStorageExternalS3ServiceConfigInterface} config
+ * @property {Map<string, Promise<void>>} writeQueue
+ */
+class LogStorageExternalS3Service extends log_storage_external_service_1.LogStorageExternalService {
+    /**
+     * Constructor of the LogStorageS3Service
+     *
+     * @param {LogServiceConfigInterface} logServiceConfig - Configuration for the logging service
+     */
+    constructor(logServiceConfig) {
+        super(logServiceConfig);
+        /**
+         * @var {Map<string, Promise<void>>}
+         */
+        this.writeQueue = new Map();
+        this.config = (0, log_storage_external_s3_config_1.getLogStorageExternalS3Config)();
+        let firehoseConfig = {
+            region: this.config.region,
+            endpoint: this.config.endpoint,
+        };
+        if (this.config.accessKeyId
+            && this.config.secretAccessKey) {
+            firehoseConfig = {
+                region: this.config.region,
+                endpoint: this.config.endpoint,
+                credentials: {
+                    accessKeyId: this.config.accessKeyId,
+                    secretAccessKey: this.config.secretAccessKey,
+                },
+            };
+        }
+        this.firehose = new client_firehose_1.FirehoseClient(firehoseConfig);
+    }
+    /**
+     * Determines if the S3 storage should be used
+     *
+     * @returns {boolean} True if the storage target should be used, false otherwise
+     */
+    shouldUse() {
+        return this.logServiceConfig.useS3Storage;
+    }
+    /**
+     * Upload log content to Firehose (which delivers to S3)
+     *
+     * @param {string} key The S3 key (path) for the log file (used for metadata)
+     * @param {string} content The log content to upload
+     *
+     * @returns {Promise<void>}
+     */
+    async uploadLog(key, content) {
+        try {
+            await this.firehose.send(new client_firehose_1.PutRecordCommand({
+                DeliveryStreamName: this.config.firehoseStreamName,
+                Record: { Data: Buffer.from(content + '\n') },
+            }));
+        }
+        catch (error) {
+            console.error(`Failed to upload log to Firehose: ${key}`, error);
+            throw error;
+        }
+    }
+    /**
+     * Send log content to Firehose with queue management
+     * Firehose handles delivery to S3 with buffering and compression
+     *
+     * @param {string} key The S3 key (path) for the log file (used for metadata)
+     * @param {string} newContent The new content to send
+     *
+     * @returns {Promise<void>}
+     */
+    async appendLog(key, newContent) {
+        const currentOperation = this.writeQueue.get(key) || Promise.resolve();
+        const newOperation = currentOperation.then(async () => {
+            try {
+                await this.uploadLog(key, newContent);
+            }
+            catch (error) {
+                console.error(`Failed to send log to Firehose: ${key}`, error);
+                throw error;
+            }
+            finally {
+                this.writeQueue.delete(key);
+            }
+        });
+        this.writeQueue.set(key, newOperation);
+        return newOperation;
+    }
+    /**
+     * Writes a log entry to S3 via Firehose
+     *
+     * @param {LogType} data The log data to write
+     *
+     * @returns {Promise<void>}
+     */
+    async write(data) {
+        try {
+            const logEntry = log_service_1.LogService.formatLog(data);
+            const combinedFilePath = this.getCombinedLogFilePath();
+            await this.appendLog(combinedFilePath, logEntry);
+        }
+        catch (error) {
+            console.error('Failed to write log to Firehose/S3 storage:', error);
+            throw error;
+        }
+    }
+}
+exports.LogStorageExternalS3Service = LogStorageExternalS3Service;
+//# sourceMappingURL=log.storage.external.s3.service.js.map

package/dist/services/log.storage.external.s3.service.js.map

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

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

@@ -0,0 +1,17 @@
+import { LogServiceConfigInterface } from "../interfaces/log.service.config.interface";
+import { LogStorageBaseService } from "./log.storage.base.service";
+/**
+ * Abstract Class LogStorageExternalService
+ *
+ * Base class for external logging storage target services (e.g., S3)
+ */
+export declare abstract class LogStorageExternalService extends LogStorageBaseService {
+    /**
+     * Constructor for LogStorageExternalService
+     *
+     * @param {LogServiceConfigInterface} loggingServiceConfig - Configuration for the logging service
+     * @param {string} baseLogsDirectory - Base directory for storing logs
+     */
+    constructor(loggingServiceConfig: LogServiceConfigInterface, baseLogsDirectory?: string);
+}
+//# sourceMappingURL=log.storage.external.service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"log.storage.external.service.d.ts","sourceRoot":"","sources":["../../src/services/log.storage.external.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,4CAA4C,CAAC;AACvF,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAEnE;;;;GAIG;AACH,8BAAsB,yBAA0B,SAAQ,qBAAqB;IAE3E;;;;;OAKG;gBAED,oBAAoB,EAAE,yBAAyB,EAC/C,iBAAiB,GAAE,MAAe;CAOrC"}

package/dist/services/log.storage.external.service.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LogStorageExternalService = void 0;
+const log_storage_base_service_1 = require("./log.storage.base.service");
+/**
+ * Abstract Class LogStorageExternalService
+ *
+ * Base class for external logging storage target services (e.g., S3)
+ */
+class LogStorageExternalService extends log_storage_base_service_1.LogStorageBaseService {
+    /**
+     * Constructor for LogStorageExternalService
+     *
+     * @param {LogServiceConfigInterface} loggingServiceConfig - Configuration for the logging service
+     * @param {string} baseLogsDirectory - Base directory for storing logs
+     */
+    constructor(loggingServiceConfig, baseLogsDirectory = 'logs') {
+        super(loggingServiceConfig, baseLogsDirectory);
+    }
+}
+exports.LogStorageExternalService = LogStorageExternalService;
+//# sourceMappingURL=log.storage.external.service.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"log.storage.external.service.js","sourceRoot":"","sources":["../../src/services/log.storage.external.service.ts"],"names":[],"mappings":";;;AACA,yEAAmE;AAEnE;;;;GAIG;AACH,MAAsB,yBAA0B,SAAQ,gDAAqB;IAE3E;;;;;OAKG;IACH,YACE,oBAA+C,EAC/C,oBAA4B,MAAM;QAElC,KAAK,CACH,oBAAoB,EACpB,iBAAiB,CAClB,CAAC;IACJ,CAAC;CACF;AAjBD,8DAiBC"}

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

@@ -0,0 +1,38 @@
+import { LogStorageBaseService } from './log.storage.base.service';
+import { LogServiceConfigInterface } from '../interfaces/log.service.config.interface';
+import { LogType } from '../types/log.type';
+/**
+ * Class LogStorageLocalService
+ *
+ * Responsible for storing logs on the local file system
+ */
+export declare class LogStorageLocalService extends LogStorageBaseService {
+    /**
+     * Constructor of the LogStorageLocalService
+     *
+     * @param {LogServiceConfigInterface} loggingServiceConfig - Configuration for the logging service
+     * @param {string} baseLogsDirectory - Base directory for storing logs
+     */
+    constructor(loggingServiceConfig: LogServiceConfigInterface, baseLogsDirectory?: string);
+    /**
+     * Indicates if the storage target should be used
+     *
+     * @returns {boolean} Always true for local storage
+     */
+    shouldUse(): boolean;
+    /**
+     * Ensures the logs directory exists for the current environment
+     *
+     * @returns {void}
+     */
+    private ensureLogsDirectory;
+    /**
+     * Writes a log entry to local storage
+     *
+     * @param {LogType} data The log data to write
+     *
+     * @returns {Promise<void>}
+     */
+    write(data: LogType): Promise<void>;
+}
+//# sourceMappingURL=log.storage.local.service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"log.storage.local.service.d.ts","sourceRoot":"","sources":["../../src/services/log.storage.local.service.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,yBAAyB,EAAE,MAAM,4CAA4C,CAAC;AACvF,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAG5C;;;;GAIG;AACH,qBAAa,sBAAuB,SAAQ,qBAAqB;IAE/D;;;;;OAKG;gBAED,oBAAoB,EAAE,yBAAyB,EAC/C,iBAAiB,GAAE,MAGlB;IAQH;;;;OAIG;IACI,SAAS,IAAI,OAAO;IAK3B;;;;OAIG;IACH,OAAO,CAAC,mBAAmB;IAY3B;;;;;;OAMG;IACU,KAAK,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;CAuBjD"}

package/dist/services/log.storage.local.service.js

@@ -0,0 +1,96 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LogStorageLocalService = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const log_storage_base_service_1 = require("./log.storage.base.service");
+const log_service_1 = require("./log.service");
+/**
+ * Class LogStorageLocalService
+ *
+ * Responsible for storing logs on the local file system
+ */
+class LogStorageLocalService extends log_storage_base_service_1.LogStorageBaseService {
+    /**
+     * Constructor of the LogStorageLocalService
+     *
+     * @param {LogServiceConfigInterface} loggingServiceConfig - Configuration for the logging service
+     * @param {string} baseLogsDirectory - Base directory for storing logs
+     */
+    constructor(loggingServiceConfig, baseLogsDirectory = path.join(process.cwd(), 'src/storage/logs')) {
+        super(loggingServiceConfig, baseLogsDirectory);
+    }
+    /**
+     * Indicates if the storage target should be used
+     *
+     * @returns {boolean} Always true for local storage
+     */
+    shouldUse() {
+        return true;
+    }
+    /**
+     * Ensures the logs directory exists for the current environment
+     *
+     * @returns {void}
+     */
+    ensureLogsDirectory() {
+        const logsDirectory = this.getLogsDirectory();
+        if (!fs.existsSync(logsDirectory)) {
+            fs.mkdirSync(logsDirectory, { recursive: true });
+        }
+    }
+    /**
+     * Writes a log entry to local storage
+     *
+     * @param {LogType} data The log data to write
+     *
+     * @returns {Promise<void>}
+     */
+    async write(data) {
+        try {
+            this.ensureLogsDirectory();
+            const logEntry = log_service_1.LogService.formatLog(data);
+            const combinedFilePath = this.getCombinedLogFilePath();
+            fs.appendFileSync(combinedFilePath, logEntry + '\n', 'utf8');
+        }
+        catch (error) {
+            console.error('Failed to write log to local storage:', error);
+            throw error;
+        }
+    }
+}
+exports.LogStorageLocalService = LogStorageLocalService;
+//# sourceMappingURL=log.storage.local.service.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"log.storage.local.service.js","sourceRoot":"","sources":["../../src/services/log.storage.local.service.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,uCAAyB;AACzB,2CAA6B;AAC7B,yEAAmE;AAGnE,+CAA2C;AAE3C;;;;GAIG;AACH,MAAa,sBAAuB,SAAQ,gDAAqB;IAE/D;;;;;OAKG;IACH,YACE,oBAA+C,EAC/C,oBAA4B,IAAI,CAAC,IAAI,CACnC,OAAO,CAAC,GAAG,EAAE,EACb,kBAAkB,CACnB;QAED,KAAK,CACH,oBAAoB,EACpB,iBAAiB,CAClB,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACI,SAAS;QAEd,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;OAIG;IACK,mBAAmB;QAEzB,MAAM,aAAa,GAAG,IAAI,CAAC,gBAAgB,EAAE,CAAC;QAE9C,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;YAClC,EAAE,CAAC,SAAS,CACV,aAAa,EACb,EAAE,SAAS,EAAE,IAAI,EAAE,CACpB,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;;;;;OAMG;IACI,KAAK,CAAC,KAAK,CAAC,IAAa;QAE9B,IAAI,CAAC;YACH,IAAI,CAAC,mBAAmB,EAAE,CAAC;YAE3B,MAAM,QAAQ,GAAG,wBAAU,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;YAE5C,MAAM,gBAAgB,GAAG,IAAI,CAAC,sBAAsB,EAAE,CAAC;YAEvD,EAAE,CAAC,cAAc,CACf,gBAAgB,EAChB,QAAQ,GAAG,IAAI,EACf,MAAM,CACP,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CACX,uCAAuC,EACvC,KAAK,CACN,CAAC;YAEF,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;CACF;AA9ED,wDA8EC"}

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

@@ -0,0 +1,62 @@
+import { LogServiceConfigInterface } from '../interfaces/log.service.config.interface';
+import { LogType } from '../types/log.type';
+/**
+ * Class LogStorageService
+ *
+ * Responsible for saving logs to local files or S3 bucket organized by date and environment
+ *
+ * @property {LogStorageLocalService} localService
+ * @property {LogStorageExternalService} externalService
+ * @property {LogServiceConfigInterface} logServiceConfig
+ */
+export declare class LogStorageService {
+    /**
+     * @var {LogStorageLocalService}
+     */
+    private localService;
+    /**
+     * @var {LogStorageExternalService}
+     */
+    private externalService;
+    /**
+     * @var {LogServiceConfigInterface}
+     */
+    private logServiceConfig;
+    /**
+     * Constructor of the LogStorageService
+     *
+     * @param {LogServiceConfigInterface} logServiceConfig - Configuration for the logging service
+     */
+    constructor(logServiceConfig: LogServiceConfigInterface);
+    /**
+     * Writes a log entry to the appropriate storage
+     *
+     * @param {LogType} data The log data to write
+     *
+     * @returns {Promise<void>}
+     */
+    write(data: LogType): Promise<void>;
+    /**
+     * Writes a log entry to local storage
+     *
+     * @param {LogType} data The log data to write
+     *
+     * @returns {Promise<void>}
+     */
+    private writeLocalService;
+    /**
+     * Writes a log entry to external storage
+     *
+     * @param {LogType} data The log data to write
+     *
+     * @returns {Promise<void>}
+     */
+    private writeExternalService;
+    /**
+     * Indicates if any storage target should be used
+     *
+     * @returns {boolean} True if any storage target should be used, false otherwise
+     */
+    shouldUse(): boolean;
+}
+//# sourceMappingURL=log.storage.service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"log.storage.service.d.ts","sourceRoot":"","sources":["../../src/services/log.storage.service.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,yBAAyB,EAAE,MAAM,4CAA4C,CAAC;AAEvF,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAG5C;;;;;;;;GAQG;AACH,qBAAa,iBAAiB;IAE5B;;OAEG;IACH,OAAO,CAAC,YAAY,CAAyB;IAE7C;;OAEG;IACH,OAAO,CAAC,eAAe,CAA4B;IAEnD;;OAEG;IACH,OAAO,CAAC,gBAAgB,CAA4B;IAEpD;;;;OAIG;gBACU,gBAAgB,EAAE,yBAAyB;IAQxD;;;;;;OAMG;IACU,KAAK,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAWhD;;;;;;OAMG;YACW,iBAAiB;IAc/B;;;;;;OAMG;YACW,oBAAoB;IAmBlC;;;;OAIG;IACI,SAAS,IAAI,OAAO;CAK5B"}

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

@@ -0,0 +1,92 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LogStorageService = void 0;
+const log_storage_local_service_1 = require("./log.storage.local.service");
+const log_storage_external_s3_service_1 = require("./log.storage.external.s3.service");
+const log_error_1 = require("../errors/log.error");
+/**
+ * Class LogStorageService
+ *
+ * Responsible for saving logs to local files or S3 bucket organized by date and environment
+ *
+ * @property {LogStorageLocalService} localService
+ * @property {LogStorageExternalService} externalService
+ * @property {LogServiceConfigInterface} logServiceConfig
+ */
+class LogStorageService {
+    /**
+     * Constructor of the LogStorageService
+     *
+     * @param {LogServiceConfigInterface} logServiceConfig - Configuration for the logging service
+     */
+    constructor(logServiceConfig) {
+        this.logServiceConfig = logServiceConfig;
+        this.localService = new log_storage_local_service_1.LogStorageLocalService(this.logServiceConfig);
+        this.externalService = new log_storage_external_s3_service_1.LogStorageExternalS3Service(this.logServiceConfig);
+    }
+    /**
+     * Writes a log entry to the appropriate storage
+     *
+     * @param {LogType} data The log data to write
+     *
+     * @returns {Promise<void>}
+     */
+    async write(data) {
+        if (this.externalService.shouldUse()) {
+            await this.writeExternalService(data);
+        }
+        else if (this.localService.shouldUse()) {
+            await this.writeLocalService(data);
+        }
+        else {
+            throw new log_error_1.LogError('No available log storage targets.');
+        }
+    }
+    /**
+     * Writes a log entry to local storage
+     *
+     * @param {LogType} data The log data to write
+     *
+     * @returns {Promise<void>}
+     */
+    async writeLocalService(data) {
+        try {
+            await this.localService.write(data);
+        }
+        catch (error) {
+            console.error('Local logging failed:', error);
+            throw error;
+        }
+    }
+    /**
+     * Writes a log entry to external storage
+     *
+     * @param {LogType} data The log data to write
+     *
+     * @returns {Promise<void>}
+     */
+    async writeExternalService(data) {
+        try {
+            await this.externalService.write(data);
+        }
+        catch (error) {
+            console.error('External logging failed:', error);
+            if (!this.localService.shouldUse()) {
+                throw error;
+            }
+            console.info('Falling back to local logging storage.');
+            await this.writeLocalService(data);
+        }
+    }
+    /**
+     * Indicates if any storage target should be used
+     *
+     * @returns {boolean} True if any storage target should be used, false otherwise
+     */
+    shouldUse() {
+        return this.localService.shouldUse()
+            || this.externalService.shouldUse();
+    }
+}
+exports.LogStorageService = LogStorageService;
+//# sourceMappingURL=log.storage.service.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"log.storage.service.js","sourceRoot":"","sources":["../../src/services/log.storage.service.ts"],"names":[],"mappings":";;;AAAA,2EAAqE;AAGrE,uFAAgF;AAEhF,mDAA+C;AAE/C;;;;;;;;GAQG;AACH,MAAa,iBAAiB;IAiB5B;;;;OAIG;IACH,YAAa,gBAA2C;QAEtD,IAAI,CAAC,gBAAgB,GAAG,gBAAgB,CAAC;QAEzC,IAAI,CAAC,YAAY,GAAG,IAAI,kDAAsB,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QACtE,IAAI,CAAC,eAAe,GAAG,IAAI,6DAA2B,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IAChF,CAAC;IAED;;;;;;OAMG;IACI,KAAK,CAAC,KAAK,CAAC,IAAa;QAE9B,IAAI,IAAI,CAAC,eAAe,CAAC,SAAS,EAAE,EAAE,CAAC;YACrC,MAAM,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC;QACxC,CAAC;aAAM,IAAI,IAAI,CAAC,YAAY,CAAC,SAAS,EAAE,EAAE,CAAC;YACzC,MAAM,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;QACrC,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,oBAAQ,CAAC,mCAAmC,CAAC,CAAC;QAC1D,CAAC;IACH,CAAC;IAED;;;;;;OAMG;IACK,KAAK,CAAC,iBAAiB,CAAC,IAAa;QAE3C,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACtC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CACX,uBAAuB,EACvB,KAAK,CACN,CAAC;YAEF,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED;;;;;;OAMG;IACK,KAAK,CAAC,oBAAoB,CAAC,IAAa;QAE9C,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACzC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACd,OAAO,CAAC,KAAK,CACZ,0BAA0B,EAC1B,KAAK,CACN,CAAC;YAEF,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,SAAS,EAAE,EAAE,CAAC;gBACnC,MAAM,KAAK,CAAC;YACd,CAAC;YAED,OAAO,CAAC,IAAI,CAAC,wCAAwC,CAAC,CAAC;YACvD,MAAM,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;QACrC,CAAC;IACH,CAAC;IAED;;;;OAIG;IACI,SAAS;QAEd,OAAO,IAAI,CAAC,YAAY,CAAC,SAAS,EAAE;eAC/B,IAAI,CAAC,eAAe,CAAC,SAAS,EAAE,CAAC;IACxC,CAAC;CACF;AAzGD,8CAyGC"}