@nicollasfrazao/liguelead-log-service 1.0.0 → 1.1.0

package/README.md

@@ -14,7 +14,7 @@ npm install @ligue-lead-tech/log-service-nodejs
 
 ```typescript
 import express from 'express';
-import { LogService, loggingMiddleware } from '@ligue-lead-tech/log-service-nodejs';
+import { LogService, logMiddleware } from '@ligue-lead-tech/log-service-nodejs';
 
 const app = express();
 
@@ -25,7 +25,7 @@ process.env.LOG_DESTINATION = 'both'; // 'console', 'storage', ou 'both'
 process.env.NODE_ENV = 'development';
 
 // Adicione o middleware de logging (obrigatório para correlation IDs)
-app.use(loggingMiddleware);
+app.use(logMiddleware);
 
 // Suas rotas
 app.get('/api/users', (req, res) => {
@@ -49,6 +49,7 @@ app.listen(3000, () => {
 
 ### 2. Configuração com S3 via Kinesis Firehose
 
+#### Usando Nome do Stream (método tradicional)
 ```typescript
 // Configuração para produção com S3
 process.env.LOG_USE_S3_STORAGE = 'true';
@@ -61,6 +62,16 @@ process.env.LOG_AWS_ACCESS_KEY_ID = 'test';
 process.env.LOG_AWS_SECRET_ACCESS_KEY = 'test';
 ```
 
+#### Usando ARN do Firehose (recomendado)
+```typescript
+// Configuração com ARN - extrai automaticamente região e nome do stream
+process.env.LOG_USE_S3_STORAGE = 'true';
+process.env.LOG_FIREHOSE_STREAM_ARN = 'arn:aws:firehose:us-east-1:123456789012:deliverystream/my-app-logs-firehose';
+
+// As variáveis LOG_AWS_REGION e LOG_FIREHOSE_STREAM_NAME são opcionais quando usar ARN
+// A região e nome do stream são extraídos automaticamente do ARN
+```
+
 ### 3. Logging Manual
 
 ```typescript
@@ -125,7 +136,7 @@ Os logs são organizados por ambiente e salvos via **Kinesis Firehose** para S3,
 
 ### Armazenamento S3 (via Kinesis Firehose)
 ```
-ll-api-logs/
+my-app-logs/
 ├── logs/
 │   ├── development/
 │   │   └── 2025-10-27-combined.log.gz     # Logs comprimidos pelo Firehose
@@ -183,7 +194,7 @@ Quando `LOG_USE_S3_STORAGE=true`, os logs são enviados para **Kinesis Firehose*
 
 Exemplo de estrutura no S3 via Firehose:
 ```
-ll-api-logs/
+my-app-logs/
 ├── logs/
 │   ├── 2025/10/27/14/
 │   │   ├── firehose_output-1-2025-10-27-14-01-01-uuid.gz
@@ -208,11 +219,16 @@ NODE_ENV=development                   # development|production|homologation|tes
 
 # S3 via Kinesis Firehose
 LOG_USE_S3_STORAGE=true               # Ativa envio para S3 via Firehose
+
+# Opção 1: Usar ARN do Firehose (recomendado)
+LOG_FIREHOSE_STREAM_ARN=arn:aws:firehose:us-east-1:123456789012:deliverystream/my-app-logs-firehose
+
+# Opção 2: Usar nome e região separadamente
 LOG_FIREHOSE_STREAM_NAME=my-app-logs  # Nome do stream Kinesis Firehose
+LOG_AWS_REGION=us-east-1              # Região AWS (não necessária se usar ARN)
 
 # AWS (apenas para desenvolvimento/LocalStack)
 LOG_AWS_ENDPOINT=http://localhost:4566  # Endpoint AWS (LocalStack)
-LOG_AWS_REGION=us-east-1                # Região AWS
 LOG_AWS_ACCESS_KEY_ID=test              # Access Key (dev only)
 LOG_AWS_SECRET_ACCESS_KEY=test          # Secret Key (dev only)
 
@@ -334,7 +350,7 @@ LOG_DESTINATION=storage
 LOG_USE_S3_STORAGE=true
 
 # Nome do Kinesis Firehose stream
-LOG_FIREHOSE_STREAM_NAME=ll-api-logs-firehose
+LOG_FIREHOSE_STREAM_NAME=my-app-logs-firehose
 
 # Região AWS
 LOG_AWS_REGION=us-east-1
@@ -371,7 +387,7 @@ LOG_USE=true
 LOG_LEVEL=debug
 LOG_DESTINATION=both
 LOG_USE_S3_STORAGE=true
-LOG_FIREHOSE_STREAM_NAME=ll-api-logs-firehose
+LOG_FIREHOSE_STREAM_NAME=my-app-logs-firehose
 LOG_AWS_ENDPOINT=http://localhost:4566
 LOG_AWS_ACCESS_KEY_ID=test
 LOG_AWS_SECRET_ACCESS_KEY=test
@@ -384,7 +400,7 @@ LOG_USE=true
 LOG_LEVEL=info
 LOG_DESTINATION=storage
 LOG_USE_S3_STORAGE=true
-LOG_FIREHOSE_STREAM_NAME=ll-api-logs-firehose-hml
+LOG_FIREHOSE_STREAM_NAME=my-app-logs-firehose-hml
 # AWS credentials via IAM role ou environment variables
 ```
 
@@ -395,7 +411,7 @@ LOG_USE=true
 LOG_LEVEL=warn
 LOG_DESTINATION=storage
 LOG_USE_S3_STORAGE=true
-LOG_FIREHOSE_STREAM_NAME=ll-api-logs-firehose-prod
+LOG_FIREHOSE_STREAM_NAME=my-app-logs-firehose-prod
 LOG_INCLUDE_REQUEST_BODY=false
 LOG_INCLUDE_RESPONSE_BODY=false
 LOG_MAX_BODY_SIZE=1000
@@ -515,9 +531,9 @@ scripts/                             # Scripts utilitários
 O middleware de logging é aplicado automaticamente a todas as rotas:
 
 ```typescript
-import { loggingMiddleware } from './src/middlewares/log.middleware';
+import { logMiddleware } from './src/middlewares/log.middleware';
 
-app.use(loggingMiddleware);
+app.use(logMiddleware);
 ```
 
 ### 5. Logging Manual
@@ -622,13 +638,13 @@ Para integrar o serviço em sua aplicação Express:
 
 ```typescript
 import express from 'express';
-import { loggingMiddleware } from './src/middlewares/log.middleware';
+import { logMiddleware } from './src/middlewares/log.middleware';
 import { LogService } from './src/services/log.service';
 
 const app = express();
 
 // Aplicar middleware de logging
-app.use(loggingMiddleware);
+app.use(logMiddleware);
 
 // Exemplo de uso manual
 app.get('/health', (req, res) => {

package/dist/configs/log.storage.external.s3.config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"log.storage.external.s3.config.d.ts","sourceRoot":"","sources":["../../src/configs/log.storage.external.s3.config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0CAA0C,EAAE,MAAM,gEAAgE,CAAC;AAE5H;;;;GAIG;AACH,eAAO,MAAM,6BAA6B,QAAO,0CAqBhD,CAAA"}
+{"version":3,"file":"log.storage.external.s3.config.d.ts","sourceRoot":"","sources":["../../src/configs/log.storage.external.s3.config.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,0CAA0C,EAAE,MAAM,gEAAgE,CAAC;AAM5H;;;;GAIG;AACH,eAAO,MAAM,6BAA6B,QAAO,0CAmChD,CAAA"}

package/dist/configs/log.storage.external.s3.config.js

@@ -1,15 +1,28 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getLogStorageExternalS3Config = void 0;
+const log_error_1 = require("../errors/log.error");
+const arn_helper_1 = require("../helpers/arn.helper");
 /**
  * Get Log Storage External S3 Configuration
  *
  * @returns {LogStorageExternalS3ServiceConfigInterface} Log Storage External S3 Configuration
  */
 const getLogStorageExternalS3Config = () => {
+    const firehoseArn = process.env.LOG_FIREHOSE_STREAM_ARN;
+    let firehoseStreamName = process.env.LOG_FIREHOSE_STREAM_NAME || 'log-service-firehose';
+    let region = process.env.LOG_AWS_REGION || 'us-east-1';
+    if (firehoseArn) {
+        if (!arn_helper_1.ArnHelper.isFirehoseDeliveryStreamARN(firehoseArn)) {
+            throw new log_error_1.LogError(`Invalid Kinesis Firehose delivery stream ARN: ${firehoseArn}`);
+        }
+        firehoseStreamName = arn_helper_1.ArnHelper.getFirehoseStreamNameFromARN(firehoseArn);
+        region = arn_helper_1.ArnHelper.getRegionFromARN(firehoseArn);
+    }
     let config = {
-        firehoseStreamName: process.env.LOG_FIREHOSE_STREAM_NAME || 'log-service-firehose',
-        region: process.env.LOG_AWS_REGION || 'us-east-1',
+        firehoseStreamName,
+        firehoseStreamArn: firehoseArn,
+        region,
         version: 'latest',
     };
     if (process.env.LOG_AWS_ACCESS_KEY_ID

package/dist/configs/log.storage.external.s3.config.js.map

@@ -1 +1 @@
-{"version":3,"file":"log.storage.external.s3.config.js","sourceRoot":"","sources":["../../src/configs/log.storage.external.s3.config.ts"],"names":[],"mappings":";;;AAEA;;;;GAIG;AACI,MAAM,6BAA6B,GAAG,GAA+C,EAAE;IAE5F,IAAI,MAAM,GAA+C;QACvD,kBAAkB,EAAE,OAAO,CAAC,GAAG,CAAC,wBAAwB,IAAI,sBAAsB;QAClF,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,WAAW;QACjD,OAAO,EAAE,QAAQ;KAClB,CAAC;IAEF,IACE,OAAO,CAAC,GAAG,CAAC,qBAAqB;WAC9B,OAAO,CAAC,GAAG,CAAC,yBAAyB,EACxC,CAAC;QACD,MAAM,GAAG;YACP,GAAG,MAAM;YACT,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,uBAAuB;YACjE,WAAW,EAAE,OAAO,CAAC,GAAG,CAAC,qBAAqB;YAC9C,eAAe,EAAE,OAAO,CAAC,GAAG,CAAC,yBAAyB;SACvD,CAAC;IACJ,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC,CAAA;AArBY,QAAA,6BAA6B,iCAqBzC"}
+{"version":3,"file":"log.storage.external.s3.config.js","sourceRoot":"","sources":["../../src/configs/log.storage.external.s3.config.ts"],"names":[],"mappings":";;;AAAA,mDAA+C;AAE/C,sDAG+B;AAE/B;;;;GAIG;AACI,MAAM,6BAA6B,GAAG,GAA+C,EAAE;IAE5F,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC;IACxD,IAAI,kBAAkB,GAAG,OAAO,CAAC,GAAG,CAAC,wBAAwB,IAAI,sBAAsB,CAAC;IACxF,IAAI,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,WAAW,CAAC;IAEvD,IAAI,WAAW,EAAE,CAAC;QAChB,IAAI,CAAC,sBAAS,CAAC,2BAA2B,CAAC,WAAW,CAAC,EAAE,CAAC;YACxD,MAAM,IAAI,oBAAQ,CAAC,iDAAiD,WAAW,EAAE,CAAC,CAAC;QACrF,CAAC;QAED,kBAAkB,GAAG,sBAAS,CAAC,4BAA4B,CAAC,WAAW,CAAC,CAAC;QACzE,MAAM,GAAG,sBAAS,CAAC,gBAAgB,CAAC,WAAW,CAAC,CAAC;IACnD,CAAC;IAED,IAAI,MAAM,GAA+C;QACvD,kBAAkB;QAClB,iBAAiB,EAAE,WAAW;QAC9B,MAAM;QACN,OAAO,EAAE,QAAQ;KAClB,CAAC;IAEF,IACE,OAAO,CAAC,GAAG,CAAC,qBAAqB;WAC9B,OAAO,CAAC,GAAG,CAAC,yBAAyB,EACxC,CAAC;QACD,MAAM,GAAG;YACP,GAAG,MAAM;YACT,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,uBAAuB;YACjE,WAAW,EAAE,OAAO,CAAC,GAAG,CAAC,qBAAqB;YAC9C,eAAe,EAAE,OAAO,CAAC,GAAG,CAAC,yBAAyB;SACvD,CAAC;IACJ,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC,CAAA;AAnCY,QAAA,6BAA6B,iCAmCzC"}

package/dist/helpers/arn.helper.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Utilities for working with AWS ARNs
+ */
+/**
+ * Interface ArnInterface
+ *
+ * Represents the components of a parsed AWS ARN.
+ *
+ * @property {string} service - The AWS service (e.g., 'firehose')
+ * @property {string} region - The AWS region (e.g., 'us-east-1')
+ * @property {string} accountId - The AWS account ID
+ * @property {string} resourceType - The type of resource (e.g., 'deliverystream')
+ * @property {string} resourceName - The name of the resource
+ * @property {string} fullArn - The full ARN string
+ */
+export interface ArnInterface {
+    service: string;
+    region: string;
+    accountId: string;
+    resourceType: string;
+    resourceName: string;
+    fullArn: string;
+}
+/**
+ * Class ArnHelper
+ *
+ * Provides utility functions for parsing and validating AWS ARNs.
+ */
+export declare class ArnHelper {
+    /**
+     * Parses an AWS ARN and extracts its components
+     *
+     * @param {string} arn - The AWS ARN to parse
+     *
+     * @throws {LogError} if ARN format is invalid
+     *
+     * @returns {ArnInterface} Parsed ARN components
+     *
+     * @example
+     * const parsed = parseARN('arn:aws:firehose:us-east-1:123456789012:deliverystream/my-app-logs-firehose');
+     * // Returns:
+     * // {
+     * //   service: 'firehose',
+     * //   region: 'us-east-1',
+     * //   accountId: '123456789012',
+     * //   resourceType: 'deliverystream',
+     * //   resourceName: 'my-app-logs-firehose',
+     * //   fullArn: 'arn:aws:firehose:us-east-1:123456789012:deliverystream/my-app-logs-firehose'
+     * // }
+     */
+    private static parseARN;
+    /**
+     * Validates if an ARN is for a Kinesis Firehose delivery stream
+     *
+     * @param {string} arn - The AWS ARN to validate
+     *
+     * @returns {boolean} true if it's a valid Firehose delivery stream ARN
+     */
+    static isFirehoseDeliveryStreamARN(arn: string): boolean;
+    /**
+     * Extracts Firehose delivery stream name from ARN
+     *
+     * @param {string} arn - The Kinesis Firehose ARN
+     *
+     * @throws {Error} if ARN is not a valid Firehose delivery stream ARN
+     *
+     * @returns {string} The delivery stream name
+     */
+    static getFirehoseStreamNameFromARN(arn: string): string;
+    /**
+     * Extracts AWS region from ARN
+     *
+     * @param {string} arn - The AWS ARN
+     *
+     * @returns {string} The AWS region
+     */
+    static getRegionFromARN(arn: string): string;
+}
+//# sourceMappingURL=arn.helper.d.ts.map

package/dist/helpers/arn.helper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"arn.helper.d.ts","sourceRoot":"","sources":["../../src/helpers/arn.helper.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;GAIG;AACH,qBAAa,SAAS;IACpB;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ;IA2CvB;;;;;;OAMG;WACW,2BAA2B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAY/D;;;;;;;;OAQG;WACW,4BAA4B,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAW/D;;;;;;OAMG;WACW,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;CAMpD"}

package/dist/helpers/arn.helper.js

@@ -0,0 +1,107 @@
+"use strict";
+/**
+ * Utilities for working with AWS ARNs
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ArnHelper = void 0;
+const log_error_1 = require("../errors/log.error");
+/**
+ * Class ArnHelper
+ *
+ * Provides utility functions for parsing and validating AWS ARNs.
+ */
+class ArnHelper {
+    /**
+     * Parses an AWS ARN and extracts its components
+     *
+     * @param {string} arn - The AWS ARN to parse
+     *
+     * @throws {LogError} if ARN format is invalid
+     *
+     * @returns {ArnInterface} Parsed ARN components
+     *
+     * @example
+     * const parsed = parseARN('arn:aws:firehose:us-east-1:123456789012:deliverystream/my-app-logs-firehose');
+     * // Returns:
+     * // {
+     * //   service: 'firehose',
+     * //   region: 'us-east-1',
+     * //   accountId: '123456789012',
+     * //   resourceType: 'deliverystream',
+     * //   resourceName: 'my-app-logs-firehose',
+     * //   fullArn: 'arn:aws:firehose:us-east-1:123456789012:deliverystream/my-app-logs-firehose'
+     * // }
+     */
+    static parseARN(arn) {
+        if (!arn
+            || typeof arn !== 'string') {
+            throw new log_error_1.LogError('ARN must be a non-empty string');
+        }
+        const arnRegex = /^arn:aws:([^:]+):([^:]*):([^:]*):(.+)$/;
+        const match = arn.match(arnRegex);
+        if (!match) {
+            throw new log_error_1.LogError(`Invalid ARN format: ${arn}`);
+        }
+        const [, service, region, accountId, resource] = match;
+        const resourceParts = resource.split(/[/:]/);
+        if (resourceParts.length < 2) {
+            throw new log_error_1.LogError(`Invalid resource format in ARN: ${arn}`);
+        }
+        const resourceType = resourceParts[0];
+        const resourceName = resourceParts.slice(1).join('/'); // Handle cases with multiple slashes
+        return {
+            service,
+            region,
+            accountId,
+            resourceType,
+            resourceName,
+            fullArn: arn
+        };
+    }
+    /**
+     * Validates if an ARN is for a Kinesis Firehose delivery stream
+     *
+     * @param {string} arn - The AWS ARN to validate
+     *
+     * @returns {boolean} true if it's a valid Firehose delivery stream ARN
+     */
+    static isFirehoseDeliveryStreamARN(arn) {
+        try {
+            const parsed = this.parseARN(arn);
+            return parsed.service === 'firehose'
+                && parsed.resourceType === 'deliverystream';
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Extracts Firehose delivery stream name from ARN
+     *
+     * @param {string} arn - The Kinesis Firehose ARN
+     *
+     * @throws {Error} if ARN is not a valid Firehose delivery stream ARN
+     *
+     * @returns {string} The delivery stream name
+     */
+    static getFirehoseStreamNameFromARN(arn) {
+        if (!this.isFirehoseDeliveryStreamARN(arn)) {
+            throw new log_error_1.LogError(`ARN is not a valid Kinesis Firehose delivery stream: ${arn}`);
+        }
+        const parsed = this.parseARN(arn);
+        return parsed.resourceName;
+    }
+    /**
+     * Extracts AWS region from ARN
+     *
+     * @param {string} arn - The AWS ARN
+     *
+     * @returns {string} The AWS region
+     */
+    static getRegionFromARN(arn) {
+        const parsed = this.parseARN(arn);
+        return parsed.region;
+    }
+}
+exports.ArnHelper = ArnHelper;
+//# sourceMappingURL=arn.helper.js.map

package/dist/helpers/arn.helper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"arn.helper.js","sourceRoot":"","sources":["../../src/helpers/arn.helper.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,mDAA+C;AAuB/C;;;;GAIG;AACH,MAAa,SAAS;IACpB;;;;;;;;;;;;;;;;;;;;OAoBG;IACK,MAAM,CAAC,QAAQ,CAAC,GAAW;QAEjC,IACE,CAAC,GAAG;eACD,OAAO,GAAG,KAAK,QAAQ,EAC1B,CAAC;YACD,MAAM,IAAI,oBAAQ,CAAC,gCAAgC,CAAC,CAAC;QACvD,CAAC;QAED,MAAM,QAAQ,GAAG,wCAAwC,CAAC;QAC1D,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAElC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,oBAAQ,CAAC,uBAAuB,GAAG,EAAE,CAAC,CAAC;QACnD,CAAC;QAED,MAAM,CACJ,AADK,EAEL,OAAO,EACP,MAAM,EACN,SAAS,EACT,QAAQ,CACT,GAAG,KAAK,CAAC;QAEV,MAAM,aAAa,GAAG,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAE7C,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC7B,MAAM,IAAI,oBAAQ,CAAC,mCAAmC,GAAG,EAAE,CAAC,CAAC;QAC/D,CAAC;QAED,MAAM,YAAY,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC;QACtC,MAAM,YAAY,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,qCAAqC;QAE5F,OAAO;YACL,OAAO;YACP,MAAM;YACN,SAAS;YACT,YAAY;YACZ,YAAY;YACZ,OAAO,EAAE,GAAG;SACb,CAAC;IACJ,CAAC;IAED;;;;;;OAMG;IACI,MAAM,CAAC,2BAA2B,CAAC,GAAW;QAEnD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;YAElC,OAAO,MAAM,CAAC,OAAO,KAAK,UAAU;mBAC/B,MAAM,CAAC,YAAY,KAAK,gBAAgB,CAAC;QAChD,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED;;;;;;;;OAQG;IACI,MAAM,CAAC,4BAA4B,CAAC,GAAW;QAEpD,IAAI,CAAC,IAAI,CAAC,2BAA2B,CAAC,GAAG,CAAC,EAAE,CAAC;YAC3C,MAAM,IAAI,oBAAQ,CAAC,wDAAwD,GAAG,EAAE,CAAC,CAAC;QACpF,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QAElC,OAAO,MAAM,CAAC,YAAY,CAAC;IAC7B,CAAC;IAED;;;;;;OAMG;IACI,MAAM,CAAC,gBAAgB,CAAC,GAAW;QAExC,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QAElC,OAAO,MAAM,CAAC,MAAM,CAAC;IACvB,CAAC;CACF;AArHD,8BAqHC"}

package/dist/index.d.ts

@@ -19,4 +19,6 @@ export { LogStorageLocalService } from './services/log.storage.local.service';
 export { LogStorageExternalS3Service } from './services/log.storage.external.s3.service';
 export { LogStorageExternalService } from './services/log.storage.external.service';
 export type { LogStorageBaseServiceInterface } from './interfaces/log.storage.base.service.interface';
+export { ArnHelper } from './helpers/arn.helper';
+export type { ArnInterface } from './helpers/arn.helper';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAGpD,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAG7D,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAG9C,YAAY,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAChD,YAAY,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAG/D,YAAY,EAAE,yBAAyB,EAAE,MAAM,2CAA2C,CAAC;AAC3F,YAAY,EAAE,0CAA0C,EAAE,MAAM,+DAA+D,CAAC;AAGhI,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,EAAE,6BAA6B,EAAE,MAAM,0CAA0C,CAAC;AAGzF,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACnE,OAAO,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AAC5E,OAAO,EAAE,sBAAsB,EAAE,MAAM,sCAAsC,CAAC;AAC9E,OAAO,EAAE,2BAA2B,EAAE,MAAM,4CAA4C,CAAC;AACzF,OAAO,EAAE,yBAAyB,EAAE,MAAM,yCAAyC,CAAC;AAGpF,YAAY,EAAE,8BAA8B,EAAE,MAAM,iDAAiD,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAGpD,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAG7D,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAG9C,YAAY,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAChD,YAAY,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAG/D,YAAY,EAAE,yBAAyB,EAAE,MAAM,2CAA2C,CAAC;AAC3F,YAAY,EAAE,0CAA0C,EAAE,MAAM,+DAA+D,CAAC;AAGhI,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,EAAE,6BAA6B,EAAE,MAAM,0CAA0C,CAAC;AAGzF,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACnE,OAAO,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AAC5E,OAAO,EAAE,sBAAsB,EAAE,MAAM,sCAAsC,CAAC;AAC9E,OAAO,EAAE,2BAA2B,EAAE,MAAM,4CAA4C,CAAC;AACzF,OAAO,EAAE,yBAAyB,EAAE,MAAM,yCAAyC,CAAC;AAGpF,YAAY,EAAE,8BAA8B,EAAE,MAAM,iDAAiD,CAAC;AAGtG,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,YAAY,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/index.js

@@ -6,7 +6,7 @@
  * (local files + S3 via Kinesis Firehose) and comprehensive request tracking.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.LogStorageExternalService = exports.LogStorageExternalS3Service = exports.LogStorageLocalService = exports.LogStorageBaseService = exports.LogStorageService = exports.getLogStorageExternalS3Config = exports.getLogServiceConfig = exports.LogError = exports.logMiddleware = exports.LogService = void 0;
+exports.ArnHelper = exports.LogStorageExternalService = exports.LogStorageExternalS3Service = exports.LogStorageLocalService = exports.LogStorageBaseService = exports.LogStorageService = exports.getLogStorageExternalS3Config = exports.getLogServiceConfig = exports.LogError = exports.logMiddleware = exports.LogService = void 0;
 // Main service exports
 var log_service_1 = require("./services/log.service");
 Object.defineProperty(exports, "LogService", { enumerable: true, get: function () { return log_service_1.LogService; } });
@@ -32,4 +32,7 @@ var log_storage_external_s3_service_1 = require("./services/log.storage.external
 Object.defineProperty(exports, "LogStorageExternalS3Service", { enumerable: true, get: function () { return log_storage_external_s3_service_1.LogStorageExternalS3Service; } });
 var log_storage_external_service_1 = require("./services/log.storage.external.service");
 Object.defineProperty(exports, "LogStorageExternalService", { enumerable: true, get: function () { return log_storage_external_service_1.LogStorageExternalService; } });
+// ARN utilities export
+var arn_helper_1 = require("./helpers/arn.helper");
+Object.defineProperty(exports, "ArnHelper", { enumerable: true, get: function () { return arn_helper_1.ArnHelper; } });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,uBAAuB;AACvB,sDAAoD;AAA3C,yGAAA,UAAU,OAAA;AAEnB,uBAAuB;AACvB,+DAA6D;AAApD,+GAAA,aAAa,OAAA;AAEtB,yBAAyB;AACzB,gDAA8C;AAArC,qGAAA,QAAQ,OAAA;AAUjB,wBAAwB;AACxB,mEAAmE;AAA1D,yHAAA,mBAAmB,OAAA;AAC5B,2FAAyF;AAAhF,+IAAA,6BAA6B,OAAA;AAEtC,+CAA+C;AAC/C,sEAAmE;AAA1D,wHAAA,iBAAiB,OAAA;AAC1B,gFAA4E;AAAnE,iIAAA,qBAAqB,OAAA;AAC9B,kFAA8E;AAArE,mIAAA,sBAAsB,OAAA;AAC/B,8FAAyF;AAAhF,8IAAA,2BAA2B,OAAA;AACpC,wFAAoF;AAA3E,yIAAA,yBAAyB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,uBAAuB;AACvB,sDAAoD;AAA3C,yGAAA,UAAU,OAAA;AAEnB,uBAAuB;AACvB,+DAA6D;AAApD,+GAAA,aAAa,OAAA;AAEtB,yBAAyB;AACzB,gDAA8C;AAArC,qGAAA,QAAQ,OAAA;AAUjB,wBAAwB;AACxB,mEAAmE;AAA1D,yHAAA,mBAAmB,OAAA;AAC5B,2FAAyF;AAAhF,+IAAA,6BAA6B,OAAA;AAEtC,+CAA+C;AAC/C,sEAAmE;AAA1D,wHAAA,iBAAiB,OAAA;AAC1B,gFAA4E;AAAnE,iIAAA,qBAAqB,OAAA;AAC9B,kFAA8E;AAArE,mIAAA,sBAAsB,OAAA;AAC/B,8FAAyF;AAAhF,8IAAA,2BAA2B,OAAA;AACpC,wFAAoF;AAA3E,yIAAA,yBAAyB,OAAA;AAKlC,uBAAuB;AACvB,mDAAiD;AAAxC,uGAAA,SAAS,OAAA"}

package/dist/interfaces/log.storage.external.s3.service.config.interface.d.ts

@@ -6,6 +6,7 @@
  * @property {string} region - AWS region for S3/Firebase
  * @property {string} version - AWS SDK version
  * @property {string} firehoseStreamName - Kinesis Firehose stream name
+ * @property {string} firehoseStreamArn - Kinesis Firehose stream ARN (alternative to firehoseStreamName)
  * @property {string} endpoint - Custom S3 endpoint (optional)
  * @property {string} accessKeyId - AWS access key ID (optional)
  * @property {string} secretAccessKey - AWS secret access key (optional)
@@ -23,6 +24,10 @@ export interface LogStorageExternalS3ServiceConfigInterface {
      * @var {string}
      */
     firehoseStreamName: string;
+    /**
+     * @var {string} - Kinesis Firehose stream ARN (optional, alternative to firehoseStreamName)
+     */
+    firehoseStreamArn?: string;
     /**
      * @var {string}
      */

package/dist/interfaces/log.storage.external.s3.service.config.interface.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"log.storage.external.s3.service.config.interface.d.ts","sourceRoot":"","sources":["../../src/interfaces/log.storage.external.s3.service.config.interface.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,0CAA0C;IAEzD;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,kBAAkB,EAAE,MAAM,CAAC;IAE3B;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B"}
+{"version":3,"file":"log.storage.external.s3.service.config.interface.d.ts","sourceRoot":"","sources":["../../src/interfaces/log.storage.external.s3.service.config.interface.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,0CAA0C;IAEzD;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,kBAAkB,EAAE,MAAM,CAAC;IAE3B;;OAEG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nicollasfrazao/liguelead-log-service",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "A standalone logging service for Express applications with multi-destination storage (local files + S3 via Kinesis Firehose) and comprehensive request tracking using strategy pattern.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",