@nicollasfrazao/liguelead-log-service 1.1.0 → 1.1.2

package/README.md

@@ -62,16 +62,33 @@ process.env.LOG_AWS_ACCESS_KEY_ID = 'test';
 process.env.LOG_AWS_SECRET_ACCESS_KEY = 'test';
 ```
 
-#### Usando ARN do Firehose (recomendado)
+#### Usando IAM Role (recomendado)
 ```typescript
-// Configuração com ARN - extrai automaticamente região e nome do stream
+// Configuração com IAM Role
 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';
+process.env.LOG_AWS_ROLE_ARN = 'arn:aws:iam::0000000000:role/my-firehose-delivery-role';
 
 // 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
 ```
 
+#### Autenticação via IAM Role ARN (Nova Funcionalidade!)
+```typescript
+// Configuração para usar IAM Role com AssumeRole
+process.env.LOG_USE_S3_STORAGE = 'true';
+process.env.LOG_FIREHOSE_STREAM_NAME = 'my-app-logs-firehose';
+process.env.LOG_AWS_REGION = 'us-east-1';
+process.env.LOG_AWS_ROLE_ARN = 'arn:aws:iam::0000000000:role/my-firehose-delivery-role';
+
+// O serviço automaticamente:
+// ✅ Assume a role usando STS
+// ✅ Obtém credenciais temporárias 
+// ✅ Renova automaticamente antes da expiração
+// ✅ Cache inteligente para performance
+```
+
+📖 **Documentação Completa**: [AWS IAM Role Support](./docs/aws-iam-role-support.md)
+
 ### 3. Logging Manual
 
 ```typescript
@@ -129,6 +146,7 @@ app.post('/api/process', async (req, res) => {
 - ✅ **Armazenamento via Kinesis Firehose** para S3 com buffering e compressão
 - ✅ **Fallback para armazenamento local** em caso de falha do S3
 - ✅ **Padrão de serviço estático** - sem necessidade de instanciação
+- ✅ **Autenticação via IAM Role ARN** (AssumeRole automático, cache, renovação, cross-account)
 
 ## Estrutura dos Arquivos de Log
 
@@ -220,8 +238,8 @@ 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 1: Usar IAM Role (recomendado)
+LOG_AWS_ROLE_ARN=arn:aws:iam::0000000000:role/my-firehose-delivery-role
 
 # Opção 2: Usar nome e região separadamente
 LOG_FIREHOSE_STREAM_NAME=my-app-logs  # Nome do stream Kinesis Firehose

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":"AACA,OAAO,EAAE,0CAA0C,EAAE,MAAM,gEAAgE,CAAC;AAM5H;;;;GAIG;AACH,eAAO,MAAM,6BAA6B,QAAO,0CAmChD,CAAA"}
+{"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,0CA4BhD,CAAA"}

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

@@ -1,39 +1,31 @@
 "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,
-        firehoseStreamArn: firehoseArn,
-        region,
+        firehoseStreamName: process.env.LOG_FIREHOSE_STREAM_NAME || 'log-service-firehose',
+        region: process.env.LOG_AWS_REGION || 'us-east-1',
         version: 'latest',
     };
+    if (process.env.LOG_AWS_ROLE_ARN) {
+        config.roleArn = process.env.LOG_AWS_ROLE_ARN;
+    }
     if (process.env.LOG_AWS_ACCESS_KEY_ID
         && process.env.LOG_AWS_SECRET_ACCESS_KEY) {
         config = {
             ...config,
-            endpoint: process.env.LOG_AWS_ENDPOINT || 'http://localhost:4566',
             accessKeyId: process.env.LOG_AWS_ACCESS_KEY_ID,
             secretAccessKey: process.env.LOG_AWS_SECRET_ACCESS_KEY,
         };
     }
+    if (process.env.LOG_AWS_ENDPOINT) {
+        config.endpoint = process.env.LOG_AWS_ENDPOINT;
+    }
     return config;
 };
 exports.getLogStorageExternalS3Config = getLogStorageExternalS3Config;

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":";;;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"}
+{"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,IAAI,OAAO,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;QACjC,MAAM,CAAC,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC;IAChD,CAAC;IAED,IACE,OAAO,CAAC,GAAG,CAAC,qBAAqB;WAC9B,OAAO,CAAC,GAAG,CAAC,yBAAyB,EACxC,CAAC;QACD,MAAM,GAAG;YACP,GAAG,MAAM;YACT,WAAW,EAAE,OAAO,CAAC,GAAG,CAAC,qBAAqB;YAC9C,eAAe,EAAE,OAAO,CAAC,GAAG,CAAC,yBAAyB;SACvD,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;QACjC,MAAM,CAAC,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC;IACjD,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC,CAAA;AA5BY,QAAA,6BAA6B,iCA4BzC"}

package/dist/index.d.ts

@@ -19,6 +19,4 @@ 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;AAGtG,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,YAAY,EAAE,YAAY,EAAE,MAAM,sBAAsB,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"}

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.ArnHelper = exports.LogStorageExternalService = exports.LogStorageExternalS3Service = exports.LogStorageLocalService = exports.LogStorageBaseService = exports.LogStorageService = exports.getLogStorageExternalS3Config = exports.getLogServiceConfig = exports.LogError = exports.logMiddleware = exports.LogService = void 0;
+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,7 +32,4 @@ 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;AAKlC,uBAAuB;AACvB,mDAAiD;AAAxC,uGAAA,SAAS,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"}

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

@@ -6,10 +6,10 @@
  * @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)
+ * @property {string} roleArn - AWS IAM role ARN for assume role authentication (optional)
  */
 export interface LogStorageExternalS3ServiceConfigInterface {
     /**
@@ -24,10 +24,6 @@ export interface LogStorageExternalS3ServiceConfigInterface {
      * @var {string}
      */
     firehoseStreamName: string;
-    /**
-     * @var {string} - Kinesis Firehose stream ARN (optional, alternative to firehoseStreamName)
-     */
-    firehoseStreamArn?: string;
     /**
      * @var {string}
      */
@@ -40,5 +36,9 @@ export interface LogStorageExternalS3ServiceConfigInterface {
      * @var {string}
      */
     secretAccessKey?: string;
+    /**
+     * @var {string}
+     */
+    roleArn?: string;
 }
 //# sourceMappingURL=log.storage.external.s3.service.config.interface.d.ts.map

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;;;;;;;;;;;;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"}
+{"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,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB"}

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

@@ -9,6 +9,7 @@ import { LogType } from '../types/log.type';
  * @property {FirehoseClient} firehose
  * @property {LogStorageExternalS3ServiceConfigInterface} config
  * @property {Map<string, Promise<void>>} writeQueue
+ * @property {Promise<any> | null} credentialsCache
  */
 export declare class LogStorageExternalS3Service extends LogStorageExternalService {
     /**
@@ -23,6 +24,10 @@ export declare class LogStorageExternalS3Service extends LogStorageExternalServi
      * @var {Map<string, Promise<void>>}
      */
     private writeQueue;
+    /**
+     * @var {Promise<any> | null}
+     */
+    private credentialsCache;
     /**
      * Constructor of the LogStorageS3Service
      *
@@ -35,6 +40,18 @@ export declare class LogStorageExternalS3Service extends LogStorageExternalServi
      * @returns {boolean} True if the storage target should be used, false otherwise
      */
     shouldUse(): boolean;
+    /**
+     * Gets temporary credentials using STS AssumeRole
+     *
+     * @returns {Promise<any>} Credentials object for AWS SDK
+     */
+    private getAssumeRoleCredentials;
+    /**
+     * Refreshes temporary credentials using STS AssumeRole
+     *
+     * @returns {Promise<any>} Fresh credentials object for AWS SDK
+     */
+    private refreshAssumeRoleCredentials;
     /**
      * Upload log content to Firehose (which delivers to S3)
      *

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

@@ -1 +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"}
+{"version":3,"file":"log.storage.external.s3.service.d.ts","sourceRoot":"","sources":["../../src/services/log.storage.external.s3.service.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAE3E,OAAO,EAAE,yBAAyB,EAAE,MAAM,4CAA4C,CAAC;AAEvF,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAI5C;;;;;;;;;GASG;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;;OAEG;IACH,OAAO,CAAC,gBAAgB,CAA6B;IAErD;;;;OAIG;gBACU,gBAAgB,EAAE,yBAAyB;IA6BxD;;;;OAIG;IACI,SAAS,IAAI,OAAO;IAK3B;;;;OAIG;YACW,wBAAwB;IAqCtC;;;;OAIG;YACW,4BAA4B;IAsC1C;;;;;;;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

@@ -2,9 +2,11 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.LogStorageExternalS3Service = void 0;
 const client_firehose_1 = require("@aws-sdk/client-firehose");
+const client_sts_1 = require("@aws-sdk/client-sts");
 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");
+const log_error_1 = require("../errors/log.error");
 /**
  * Class LogStorageExternalS3Service
  *
@@ -13,6 +15,7 @@ const log_storage_external_s3_config_1 = require("../configs/log.storage.externa
  * @property {FirehoseClient} firehose
  * @property {LogStorageExternalS3ServiceConfigInterface} config
  * @property {Map<string, Promise<void>>} writeQueue
+ * @property {Promise<any> | null} credentialsCache
  */
 class LogStorageExternalS3Service extends log_storage_external_service_1.LogStorageExternalService {
     /**
@@ -26,22 +29,27 @@ class LogStorageExternalS3Service extends log_storage_external_service_1.LogStor
          * @var {Map<string, Promise<void>>}
          */
         this.writeQueue = new Map();
+        /**
+         * @var {Promise<any> | null}
+         */
+        this.credentialsCache = null;
         this.config = (0, log_storage_external_s3_config_1.getLogStorageExternalS3Config)();
-        let firehoseConfig = {
+        const firehoseConfig = {
             region: this.config.region,
-            endpoint: this.config.endpoint,
         };
-        if (this.config.accessKeyId
+        if (this.config.roleArn) {
+            firehoseConfig.credentials = () => this.getAssumeRoleCredentials();
+        }
+        else 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,
-                },
+            firehoseConfig.credentials = {
+                accessKeyId: this.config.accessKeyId,
+                secretAccessKey: this.config.secretAccessKey,
             };
         }
+        if (this.config.endpoint) {
+            firehoseConfig.endpoint = this.config.endpoint;
+        }
         this.firehose = new client_firehose_1.FirehoseClient(firehoseConfig);
     }
     /**
@@ -52,6 +60,72 @@ class LogStorageExternalS3Service extends log_storage_external_service_1.LogStor
     shouldUse() {
         return this.logServiceConfig.useS3Storage;
     }
+    /**
+     * Gets temporary credentials using STS AssumeRole
+     *
+     * @returns {Promise<any>} Credentials object for AWS SDK
+     */
+    async getAssumeRoleCredentials() {
+        if (!this.config.roleArn) {
+            throw new Error('Role ARN is required for AssumeRole authentication');
+        }
+        if (this.credentialsCache) {
+            try {
+                const credentials = await this.credentialsCache;
+                let expirationTime;
+                if (credentials.expiration instanceof Date) {
+                    expirationTime = credentials.expiration;
+                }
+                else {
+                    expirationTime = new Date(credentials.expiration);
+                    credentials.expiration = expirationTime;
+                }
+                const now = new Date();
+                const bufferTime = 5 * 60 * 1000;
+                if (expirationTime.getTime() - now.getTime() > bufferTime) {
+                    return credentials;
+                }
+            }
+            catch (error) {
+                console.warn('Cached credentials failed, refreshing:', error);
+            }
+        }
+        this.credentialsCache = this.refreshAssumeRoleCredentials();
+        return this.credentialsCache;
+    }
+    /**
+     * Refreshes temporary credentials using STS AssumeRole
+     *
+     * @returns {Promise<any>} Fresh credentials object for AWS SDK
+     */
+    async refreshAssumeRoleCredentials() {
+        const stsClient = new client_sts_1.STSClient({
+            region: this.config.region,
+            endpoint: this.config.endpoint
+        });
+        const command = new client_sts_1.AssumeRoleCommand({
+            RoleArn: this.config.roleArn,
+            RoleSessionName: `log-service-session-${Date.now()}`,
+            DurationSeconds: 3600, // 1 hour
+        });
+        try {
+            const response = await stsClient.send(command);
+            if (!response.Credentials) {
+                throw new log_error_1.LogError('Failed to retrieve credentials from STS AssumeRole');
+            }
+            return {
+                accessKeyId: response.Credentials.AccessKeyId,
+                secretAccessKey: response.Credentials.SecretAccessKey,
+                sessionToken: response.Credentials.SessionToken,
+                expiration: response.Credentials.Expiration,
+            };
+        }
+        catch (error) {
+            console.error('Failed to assume role:', error);
+            this.credentialsCache = null;
+            throw error;
+        }
+    }
     /**
      * Upload log content to Firehose (which delivers to S3)
      *

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

@@ -1 +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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"}
+{"version":3,"file":"log.storage.external.s3.service.js","sourceRoot":"","sources":["../../src/services/log.storage.external.s3.service.ts"],"names":[],"mappings":";;;AAAA,8DAA4E;AAC5E,oDAAmE;AACnE,iFAA2E;AAG3E,+CAA2C;AAE3C,8FAA0F;AAC1F,mDAA+C;AAE/C;;;;;;;;;GASG;AACH,MAAa,2BAA4B,SAAQ,wDAAyB;IAsBxE;;;;OAIG;IACH,YAAa,gBAA2C;QAEtD,KAAK,CAAE,gBAAgB,CAAC,CAAC;QAjB3B;;WAEG;QACK,eAAU,GAA+B,IAAI,GAAG,EAAE,CAAC;QAE3D;;WAEG;QACK,qBAAgB,GAAwB,IAAI,CAAC;QAWnD,IAAI,CAAC,MAAM,GAAG,IAAA,8DAA6B,GAAE,CAAC;QAE9C,MAAM,cAAc,GAAQ;YAC1B,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM;SAC3B,CAAC;QAEF,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACxB,cAAc,CAAC,WAAW,GAAG,GAAG,EAAE,CAAC,IAAI,CAAC,wBAAwB,EAAE,CAAC;QACrE,CAAC;aAAM,IACL,IAAI,CAAC,MAAM,CAAC,WAAW;eACpB,IAAI,CAAC,MAAM,CAAC,eAAe,EAC9B,CAAC;YACD,cAAc,CAAC,WAAW,GAAG;gBAC3B,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,WAAW;gBACpC,eAAe,EAAE,IAAI,CAAC,MAAM,CAAC,eAAe;aAC7C,CAAC;QACJ,CAAC;QAED,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;YACzB,cAAc,CAAC,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC;QACjD,CAAC;QAED,IAAI,CAAC,QAAQ,GAAG,IAAI,gCAAc,CAAC,cAAc,CAAC,CAAC;IACrD,CAAC;IAED;;;;OAIG;IACI,SAAS;QAEd,OAAO,IAAI,CAAC,gBAAgB,CAAC,YAAY,CAAC;IAC5C,CAAC;IAED;;;;OAIG;IACK,KAAK,CAAC,wBAAwB;QAEpC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;QACxE,CAAC;QAED,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC;YAC1B,IAAI,CAAC;gBACH,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC;gBAChD,IAAI,cAAoB,CAAC;gBAEzB,IAAI,WAAW,CAAC,UAAU,YAAY,IAAI,EAAE,CAAC;oBAC3C,cAAc,GAAG,WAAW,CAAC,UAAU,CAAC;gBAC1C,CAAC;qBAAM,CAAC;oBACN,cAAc,GAAG,IAAI,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;oBAClD,WAAW,CAAC,UAAU,GAAG,cAAc,CAAC;gBAC1C,CAAC;gBAED,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;gBACvB,MAAM,UAAU,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;gBAEjC,IAAI,cAAc,CAAC,OAAO,EAAE,GAAG,GAAG,CAAC,OAAO,EAAE,GAAG,UAAU,EAAE,CAAC;oBAC1D,OAAO,WAAW,CAAC;gBACrB,CAAC;YACH,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,CAAC,IAAI,CACV,wCAAwC,EACxC,KAAK,CACN,CAAC;YACJ,CAAC;QACH,CAAC;QAED,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC,4BAA4B,EAAE,CAAC;QAE5D,OAAO,IAAI,CAAC,gBAAgB,CAAC;IAC/B,CAAC;IAED;;;;OAIG;IACK,KAAK,CAAC,4BAA4B;QAExC,MAAM,SAAS,GAAG,IAAI,sBAAS,CAAC;YAC9B,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM;YAC1B,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ;SAC/B,CAAC,CAAC;QAEH,MAAM,OAAO,GAAG,IAAI,8BAAiB,CAAC;YACpC,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,OAAQ;YAC7B,eAAe,EAAE,uBAAuB,IAAI,CAAC,GAAG,EAAE,EAAE;YACpD,eAAe,EAAE,IAAI,EAAE,SAAS;SACjC,CAAC,CAAC;QAEH,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAE/C,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC;gBAC1B,MAAM,IAAI,oBAAQ,CAAC,oDAAoD,CAAC,CAAC;YAC3E,CAAC;YAED,OAAO;gBACL,WAAW,EAAE,QAAQ,CAAC,WAAW,CAAC,WAAY;gBAC9C,eAAe,EAAE,QAAQ,CAAC,WAAW,CAAC,eAAgB;gBACtD,YAAY,EAAE,QAAQ,CAAC,WAAW,CAAC,YAAa;gBAChD,UAAU,EAAE,QAAQ,CAAC,WAAW,CAAC,UAAW;aAC7C,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CACX,wBAAwB,EACxB,KAAK,CACN,CAAC;YAEF,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC;YAE7B,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED;;;;;;;OAOG;IACK,KAAK,CAAC,SAAS,CACrB,GAAW,EACX,OAAe;QAEf,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,kCAAgB,CAAC;gBAC5C,kBAAkB,EAAE,IAAI,CAAC,MAAM,CAAC,kBAAkB;gBAClD,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,EAAE;aAC9C,CAAC,CAAC,CAAC;QACN,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CACX,qCAAqC,GAAG,EAAE,EAC1C,KAAK,CACN,CAAC;YAEF,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED;;;;;;;;OAQG;IACK,KAAK,CAAC,SAAS,CACrB,GAAW,EACX,UAAkB;QAElB,MAAM,gBAAgB,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QAEvE,MAAM,YAAY,GAAG,gBAAgB,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE;YACpD,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,SAAS,CAClB,GAAG,EACH,UAAU,CACX,CAAC;YACJ,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,CAAC,KAAK,CACX,mCAAmC,GAAG,EAAE,EACxC,KAAK,CACN,CAAC;gBAEF,MAAM,KAAK,CAAC;YACd,CAAC;oBAAS,CAAC;gBACT,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC9B,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,UAAU,CAAC,GAAG,CACjB,GAAG,EACH,YAAY,CACb,CAAC;QAEF,OAAO,YAAY,CAAC;IACtB,CAAC;IAED;;;;;;OAMG;IACI,KAAK,CAAC,KAAK,CAAC,IAAa;QAE9B,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,wBAAU,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;YAE5C,MAAM,gBAAgB,GAAG,IAAI,CAAC,sBAAsB,EAAE,CAAC;YAEvD,MAAM,IAAI,CAAC,SAAS,CAClB,gBAAgB,EAChB,QAAQ,CACT,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CACX,6CAA6C,EAC7C,KAAK,CACN,CAAC;YAEF,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;CACF;AAtPD,kEAsPC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nicollasfrazao/liguelead-log-service",
-  "version": "1.1.0",
+  "version": "1.1.2",
   "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",
@@ -49,6 +49,7 @@
   "dependencies": {
     "@aws-sdk/client-firehose": "^3.658.1",
     "@aws-sdk/client-s3": "^3.658.1",
+    "@aws-sdk/client-sts": "^3.921.0",
     "uuid": "^9.0.1"
   },
   "devDependencies": {

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

@@ -1,79 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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

@@ -1,107 +0,0 @@
-"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

@@ -1 +0,0 @@
-{"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"}