@gugananuvem/aws-local-simulator 1.0.11 → 1.0.14

package/README.md

@@ -16,17 +16,30 @@ Simulador local completo para serviços AWS. Desenvolva e teste suas aplicaçõe
 | Lambda | ✅ | 3001 | Funções serverless |
 | Cognito | ✅ | 9229 | Autenticação e autorização |
 | API Gateway | ✅ | 4567 | APIs REST e HTTP |
-| ECS/Fargate |  🚧 | 8080 | Orquestração de containers (em desenvolvimento) |
-| SNS | 🚧 | 9911 | Notificações (em desenvolvimento) |
-| EventBridge | 🚧 | 4010 | Barramento de eventos (em desenvolvimento) |
+| STS | ✅ | 9326 | Credenciais temporárias |
+| SNS | ✅ | 9911 | Notificações pub/sub |
+| EventBridge | ✅ | 4010 | Barramento de eventos |
+| KMS | ✅ | 4000 | Gerenciamento de chaves |
+| Secrets Manager | ✅ | 4001 | Gerenciamento de segredos |
+| Parameter Store | ✅ | 4002 | Armazenamento de parâmetros |
+| CloudWatch | ✅ | 4011 | Logs, métricas e alarmes |
+| CloudTrail | ✅ | 4012 | Auditoria de API calls |
+| AWS Config | ✅ | 4013 | Conformidade e configuração |
+| CloudFormation | ✅ | 4580 | Infraestrutura como código |
+| Athena | ✅ | 4599 | Consultas SQL em dados no S3 |
+| X-Ray | ✅ | 4015 | Rastreamento distribuído |
+| ECS/Fargate | 🚧 | 8080 | Orquestração de containers (em desenvolvimento) |
 
 ## 📦 Instalação
 
 ```bash
 npm install --save-dev aws-local-simulator
 ```
-🚀 Uso Rápido
-1. Crie um arquivo de configuração aws-local-simulator.json:
+
+## 🚀 Uso Rápido
+
+### 1. Crie um arquivo de configuração `aws-local-simulator.json`:
+
 ```json
 {
   "services": {
@@ -35,11 +48,23 @@ npm install --save-dev aws-local-simulator
     "sqs": true,
     "lambda": true,
     "cognito": true,
-    "apigateway": true
+    "apigateway": true,
+    "sts": true,
+    "sns": true,
+    "eventbridge": true,
+    "kms": true,
+    "secret-manager": true,
+    "parameter-store": true,
+    "cloudwatch": true,
+    "cloudtrail": true,
+    "cloudformation": true,
+    "xray": true,
+    "config": true,
+    "athena": true
   },
   "lambdas": [
     {
-      "path": "/api/users",
+      "name": "my-function",
       "handler": "./src/handlers/users.js",
       "env": {
         "TABLE_NAME": "users-table"
@@ -50,18 +75,17 @@ npm install --save-dev aws-local-simulator
     "tables": [
       {
         "TableName": "users-table",
-        "KeySchema": [
-          { "AttributeName": "id", "KeyType": "HASH" }
-        ],
-        "AttributeDefinitions": [
-          { "AttributeName": "id", "AttributeType": "S" }
-        ]
+        "KeySchema": [{ "AttributeName": "id", "KeyType": "HASH" }],
+        "AttributeDefinitions": [{ "AttributeName": "id", "AttributeType": "S" }]
       }
     ]
   },
   "s3": {
     "buckets": ["my-bucket"]
   },
+  "sqs": {
+    "queues": ["my-queue", "dead-letter-queue"]
+  },
   "cognito": {
     "userPools": [
       {
@@ -73,80 +97,119 @@ npm install --save-dev aws-local-simulator
 }
 ```
 
-# 2. Inicie o simulador:
-## Via CLI
+### 2. Inicie o simulador:
+
+```bash
+# Via CLI
 npx aws-local-simulator start
 
 # Ou via código
 const { AWSLocalSimulator } = require('aws-local-simulator');
 const simulator = new AWSLocalSimulator();
 await simulator.start();
+```
 
-# 3. Configure seu código para usar os serviços locais:
+### 3. Configure seu código para usar os serviços locais:
 
 ```javascript
-// Importe a configuração AWS pronta
-const { dynamoDB, s3, sqs, cognito, apigateway } = require('aws-local-simulator/aws-config');
+const { dynamoDB, s3, sqs, cognito } = require('aws-local-simulator/aws-config');
 
-// Use como normalmente faria
 await dynamoDB.send(new PutCommand({
   TableName: 'users-table',
   Item: { id: '123', name: 'John' }
 }));
 ```
 
-🔧 Configuração por Variáveis de Ambiente
+## 🔧 Configuração por Variáveis de Ambiente
 
 | Variável | Descrição | Padrão |
 |---------|----------|-------|
-| AWS_LOCAL_SIMULATOR_DYNAMODB |Habilita DynamoDB | true |
-| AWS_LOCAL_SIMULATOR_S3 |Habilita S3 | true |
-| AWS_LOCAL_SIMULATOR_SQS |Habilita SQS | true |
-| AWS_LOCAL_SIMULATOR_LAMBDA |Habilita Lambda | true |
-| AWS_LOCAL_SIMULATOR_COGNITO |Habilita Cognito | false |
-| AWS_LOCAL_SIMULATOR_APIGATEWAY |Habilita API Gateway | false |
-| AWS_LOCAL_SIMULATOR_ECS |Habilita ECS/Fargate | false |
-| AWS_LOCAL_SIMULATOR_DYNAMODB_PORT |Porta DynamoDB | 8000 |
-| AWS_LOCAL_SIMULATOR_S3_PORT |Porta S3 | 4566 |
-| AWS_LOCAL_SIMULATOR_SQS_PORT |Porta SQS | 9324 |
-| AWS_LOCAL_SIMULATOR_LAMBDA_PORT |Porta Lambda | 3001 |
-| AWS_LOCAL_SIMULATOR_COGNITO_PORT |Porta Cognito | 9229 |
-| AWS_LOCAL_SIMULATOR_APIGATEWAY_PORT |Porta API Gateway | 4567 |
-| AWS_LOCAL_SIMULATOR_ECS_PORT |Porta ECS | 8080 |
-| AWS_LOCAL_SIMULATOR_DATA |Diretório de dados | ./aws-local-simulator-data |
-| AWS_LOCAL_SIMULATOR_LOG |Nível de log | info |
-```
+| AWS_LOCAL_SIMULATOR_DYNAMODB | Habilita DynamoDB | true |
+| AWS_LOCAL_SIMULATOR_S3 | Habilita S3 | true |
+| AWS_LOCAL_SIMULATOR_SQS | Habilita SQS | true |
+| AWS_LOCAL_SIMULATOR_LAMBDA | Habilita Lambda | true |
+| AWS_LOCAL_SIMULATOR_COGNITO | Habilita Cognito | false |
+| AWS_LOCAL_SIMULATOR_APIGATEWAY | Habilita API Gateway | false |
+| AWS_LOCAL_SIMULATOR_STS | Habilita STS | true |
+| AWS_LOCAL_SIMULATOR_SNS | Habilita SNS | false |
+| AWS_LOCAL_SIMULATOR_EVENTBRIDGE | Habilita EventBridge | false |
+| AWS_LOCAL_SIMULATOR_KMS | Habilita KMS | false |
+| AWS_LOCAL_SIMULATOR_SECRET_MANAGER | Habilita Secrets Manager | false |
+| AWS_LOCAL_SIMULATOR_PARAMETER_STORE | Habilita Parameter Store | false |
+| AWS_LOCAL_SIMULATOR_CLOUDWATCH | Habilita CloudWatch | false |
+| AWS_LOCAL_SIMULATOR_CLOUDTRAIL | Habilita CloudTrail | false |
+| AWS_LOCAL_SIMULATOR_CLOUDFORMATION | Habilita CloudFormation | false |
+| AWS_LOCAL_SIMULATOR_ATHENA | Habilita Athena | false |
+| AWS_LOCAL_SIMULATOR_XRAY | Habilita X-Ray | false |
+| AWS_LOCAL_SIMULATOR_CONFIG | Habilita AWS Config | false |
+| AWS_LOCAL_SIMULATOR_ECS | Habilita ECS/Fargate | false |
+| AWS_LOCAL_SIMULATOR_DYNAMODB_PORT | Porta DynamoDB | 8000 |
+| AWS_LOCAL_SIMULATOR_S3_PORT | Porta S3 | 4566 |
+| AWS_LOCAL_SIMULATOR_SQS_PORT | Porta SQS | 9324 |
+| AWS_LOCAL_SIMULATOR_LAMBDA_PORT | Porta Lambda | 3001 |
+| AWS_LOCAL_SIMULATOR_COGNITO_PORT | Porta Cognito | 9229 |
+| AWS_LOCAL_SIMULATOR_APIGATEWAY_PORT | Porta API Gateway | 4567 |
+| AWS_LOCAL_SIMULATOR_STS_PORT | Porta STS | 9326 |
+| AWS_LOCAL_SIMULATOR_SNS_PORT | Porta SNS | 9911 |
+| AWS_LOCAL_SIMULATOR_EVENTBRIDGE_PORT | Porta EventBridge | 4010 |
+| AWS_LOCAL_SIMULATOR_KMS_PORT | Porta KMS | 4000 |
+| AWS_LOCAL_SIMULATOR_SECRET_MANAGER_PORT | Porta Secrets Manager | 4001 |
+| AWS_LOCAL_SIMULATOR_PARAMETER_STORE_PORT | Porta Parameter Store | 4002 |
+| AWS_LOCAL_SIMULATOR_CLOUDWATCH_PORT | Porta CloudWatch | 4011 |
+| AWS_LOCAL_SIMULATOR_CLOUDTRAIL_PORT | Porta CloudTrail | 4012 |
+| AWS_LOCAL_SIMULATOR_CONFIG_PORT | Porta AWS Config | 4013 |
+| AWS_LOCAL_SIMULATOR_XRAY_PORT | Porta X-Ray | 4015 |
+| AWS_LOCAL_SIMULATOR_CLOUDFORMATION_PORT | Porta CloudFormation | 4580 |
+| AWS_LOCAL_SIMULATOR_ATHENA_PORT | Porta Athena | 4599 |
+| AWS_LOCAL_SIMULATOR_ECS_PORT | Porta ECS | 8080 |
+| AWS_LOCAL_SIMULATOR_DATA | Diretório de dados | ./aws-local-simulator-data |
+| AWS_LOCAL_SIMULATOR_LOG | Nível de log | info |
+
+## 📝 Comandos CLI
 
-# 📝 Comandos CLI
 ```bash
-#### Iniciar simulador
+# Iniciar simulador
 npx aws-local-simulator start [configPath]
 
-#### Parar simulador
+# Parar simulador
 npx aws-local-simulator stop
 
-#### Reiniciar
+# Reiniciar
 npx aws-local-simulator restart
 
-#### Resetar dados
+# Resetar dados
 npx aws-local-simulator reset
 
-#### Status
+# Status
 npx aws-local-simulator status
 ```
 
-# 🔌 Endpoints
+## 🔌 Endpoints
+
 | Serviço | Endpoint | Admin |
 |---------|----------|-------|
-| DynamoDB | http://localhost:8000	| http://localhost:8000/__admin/tables |
-| S3 | http://localhost:4566	| http://localhost:4566/__admin/buckets |
-| SQS | http://localhost:9324	| http://localhost:9324/__admin/queues |
-| Lambda | http://localhost:3001	| http://localhost:3001/__admin/functions |
-| Cognito | http://localhost:9229	| http://localhost:9229/__admin/userpools |
-| API Gateway | http://localhost:4567	| http://localhost:4567/__admin/apis |
-| ECS | http://localhost:8080	| http://localhost:8080/__admin/clusters |
-
-🧪 Testando com AWS CLI
+| DynamoDB | http://localhost:8000 | http://localhost:8000/__admin/tables |
+| S3 | http://localhost:4566 | http://localhost:4566/__admin/buckets |
+| SQS | http://localhost:9324 | http://localhost:9324/__admin/queues |
+| Lambda | http://localhost:3001 | http://localhost:3001/__admin/functions |
+| Cognito | http://localhost:9229 | http://localhost:9229/__admin/userpools |
+| API Gateway | http://localhost:4567 | http://localhost:4567/__admin/apis |
+| STS | http://localhost:9326 | — |
+| SNS | http://localhost:9911 | http://localhost:9911/__admin/health |
+| EventBridge | http://localhost:4010 | — |
+| KMS | http://localhost:4000 | — |
+| Secrets Manager | http://localhost:4001 | — |
+| Parameter Store | http://localhost:4002 | — |
+| CloudWatch | http://localhost:4011 | — |
+| CloudTrail | http://localhost:4012 | — |
+| AWS Config | http://localhost:4013 | — |
+| X-Ray | http://localhost:4015 | — |
+| CloudFormation | http://localhost:4580 | http://localhost:4580/__admin/stacks |
+| Athena | http://localhost:4599 | http://localhost:4599/__admin/health |
+| ECS | http://localhost:8080 | http://localhost:8080/__admin/clusters |
+
+## 🧪 Testando com AWS CLI
+
 ```bash
 # DynamoDB
 aws dynamodb list-tables --endpoint-url http://localhost:8000
@@ -157,14 +220,221 @@ aws s3 ls --endpoint-url http://localhost:4566
 # SQS
 aws sqs list-queues --endpoint-url http://localhost:9324
 
+# Lambda
+aws lambda invoke \
+  --function-name my-function \
+  --payload '{"key":"value"}' \
+  --endpoint-url http://localhost:3001 \
+  output.json
+
 # Cognito
 aws cognito-idp list-user-pools --max-results 10 --endpoint-url http://localhost:9229
 
+# STS
+aws sts get-caller-identity --endpoint-url http://localhost:9326
+aws sts assume-role \
+  --role-arn "arn:aws:iam::123456789012:role/my-role" \
+  --role-session-name "my-session" \
+  --endpoint-url http://localhost:9326
+
+# SNS
+aws sns list-topics --endpoint-url http://localhost:9911
+
+# EventBridge
+aws events list-event-buses --endpoint-url http://localhost:4010
+
+# KMS
+aws kms list-keys --endpoint-url http://localhost:4000
+
+# Secrets Manager
+aws secretsmanager list-secrets --endpoint-url http://localhost:4001
+
+# Criar secret
+aws secretsmanager create-secret \
+  --name "local/app/db-credentials" \
+  --description "Credenciais do banco" \
+  --secret-string '{"username":"admin","password":"secret123"}' \
+  --endpoint-url http://localhost:4001
+
+# Ler secret
+aws secretsmanager get-secret-value \
+  --secret-id "local/app/db-credentials" \
+  --endpoint-url http://localhost:4001
+
+# Parameter Store
+aws ssm describe-parameters --endpoint-url http://localhost:4002
+
+# Criar parâmetro String
+aws ssm put-parameter \
+  --name "/local/app/config" \
+  --value '{"timeout":30,"maxRetries":3}' \
+  --type String \
+  --endpoint-url http://localhost:4002
+
+# Criar parâmetro SecureString
+aws ssm put-parameter \
+  --name "/local/app/api-key" \
+  --value "my-secret-api-key" \
+  --type SecureString \
+  --endpoint-url http://localhost:4002
+
+# Ler parâmetro
+aws ssm get-parameter \
+  --name "/local/app/config" \
+  --endpoint-url http://localhost:4002
+
+# CloudWatch
+aws cloudwatch list-metrics --endpoint-url http://localhost:4011
+aws logs describe-log-groups --endpoint-url http://localhost:4011
+
+# CloudTrail
+aws cloudtrail describe-trails --endpoint-url http://localhost:4012
+
+# CloudFormation
+aws cloudformation list-stacks --endpoint-url http://localhost:4580
+
+# X-Ray
+aws xray get-trace-summaries \
+  --start-time $(date -d '1 hour ago' +%s) \
+  --end-time $(date +%s) \
+  --endpoint-url http://localhost:4015
+
+# AWS Config
+aws configservice describe-configuration-recorders --endpoint-url http://localhost:4013
+
 # API Gateway
 aws apigateway get-rest-apis --endpoint-url http://localhost:4567
+
+# Cloudformation
+aws cloudformation create-stack \
+  --stack-name test-stack \
+  --template-body file://templates/test-stack.yaml \
+  --parameters \
+    ParameterKey=Environment,ParameterValue=local \
+    ParameterKey=BucketName,ParameterValue=meu-bucket \
+    ParameterKey=QueueName,ParameterValue=minha-fila \
+    ParameterKey=TableName,ParameterValue=minha-tabela \
+  --endpoint-url http://localhost:4580
+
+# Ver Cloudformation resultado 
+aws cloudformation describe-stacks \
+  --stack-name test-stack \
+  --endpoint-url http://localhost:4580  
+
+# Athena
+# Criar workgroup
+aws athena create-work-group \
+  --name my-workgroup \
+  --configuration ResultConfiguration={OutputLocation=s3://meu-bucket/athena-results/} \
+  --endpoint-url http://localhost:4599
+
+# Listar workgroups
+aws athena list-work-groups --endpoint-url http://localhost:4599
+
+# Executar query
+aws athena start-query-execution \
+  --query-string "SELECT * FROM my_table LIMIT 10" \
+  --query-execution-context Database=default \
+  --result-configuration OutputLocation=s3://meu-bucket/athena-results/ \
+  --endpoint-url http://localhost:4599
+
+# Verificar status da query
+aws athena get-query-execution \
+  --query-execution-id <id-retornado> \
+  --endpoint-url http://localhost:4599
+
+# Buscar resultados
+aws athena get-query-results \
+  --query-execution-id <id-retornado> \
+  --endpoint-url http://localhost:4599
+
+# Criar named query
+aws athena create-named-query \
+  --name "my-saved-query" \
+  --database default \
+  --query-string "SELECT id, value FROM my_table WHERE status = 'active'" \
+  --endpoint-url http://localhost:4599
+
+# Listar named queries
+aws athena list-named-queries --endpoint-url http://localhost:4599
+```
+
+## ⚙️ Configuração de Lambdas
+
+Lambdas são registradas por **nome** e invocadas via API de invocação (igual à AWS real). O roteamento HTTP é feito pelo API Gateway.
+
+```json
+{
+  "lambdas": [
+    {
+      "name": "my-user-function",
+      "handler": "./src/handlers/my-user-function.js",
+      "env": {
+        "TABLE_NAME": "users-table",
+        "BUCKET_NAME": "my-bucket"
+      }
+    }
+  ]
+}
+```
+
+## ⚙️ Configuração API GATEWAY
+
+O valor do **lambdaName** deve igual ao nome Lambda que está registrada com o valor **name**. Ex: "my-user-function".
+
+```json
+{
+  "apigateway": {
+    "apis": [
+      {
+        "name": "Users API",
+        "description": "API para gerenciamento de usuários",
+        "endpoints": [
+          {
+            "path": "/user",
+            "method": "GET",
+            "lambdaName": "my-user-function",
+            "integrationType": "lambda"
+          },
+          {
+            "path": "/user",
+            "method": "POST",
+            "lambdaName": "my-user-function",
+            "integrationType": "lambda"
+          },
+          {
+            "path": "/user/{id}",
+            "method": "GET",
+            "lambdaName": "my-user-function",
+            "integrationType": "lambda"
+          },
+          {
+            "path": "/user/{id}",
+            "method": "DELETE",
+            "lambdaName": "my-user-function",
+            "integrationType": "lambda"
+          }
+        ]
+      }
+    ]
+  },
+
+}
+```
+
+O handler deve exportar uma função padrão:
+
+```javascript
+exports.handler = async (event, context) => {
+  return {
+    statusCode: 200,
+    body: JSON.stringify({ message: 'Hello from Lambda!' })
+  };
+};
 ```
 
-📁 Estrutura de Dados
+## 📁 Estrutura de Dados
+
 Os dados são persistidos em:
 
 ```text
@@ -174,31 +444,38 @@ Os dados são persistidos em:
 ├── sqs/
 ├── cognito/
 ├── apigateway/
-└── ecs/
+├── ecs/
+├── kms/
+├── secret-manager/
+├── parameter-store/
+├── cloudwatch/
+├── cloudtrail/
+├── cloudformation/
+├── athena/
+├── xray/
+└── config/
 ```
 
-🐛 Debug
-Para logs detalhados:
-
-bash
-AWS_LOCAL_SIMULATOR_LOG=verboso npx aws-local-simulator start
-🤝 Contribuindo
-Fork o projeto
+## 🐛 Debug
 
-Crie sua feature branch (git checkout -b feature/AmazingFeature)
+```bash
+AWS_LOCAL_SIMULATOR_LOG=verbose npx aws-local-simulator start
+```
 
-Commit suas mudanças (git commit -m 'Add some AmazingFeature')
+## 🤝 Contribuindo
 
-Push para a branch (git push origin feature/AmazingFeature)
+1. Fork o projeto
+2. Crie sua feature branch (`git checkout -b feature/AmazingFeature`)
+3. Commit suas mudanças (`git commit -m 'Add some AmazingFeature'`)
+4. Push para a branch (`git push origin feature/AmazingFeature`)
+5. Abra um Pull Request
 
-Abra um Pull Request
+## 📄 Licença
 
-📄 Licença
 MIT © Luiz Gustavo Ribeiro
 
-⚠️ Limitações
-SNS e EventBridge em desenvolvimento
-
-WebSocket APIs em desenvolvimento
+## ⚠️ Limitações
 
-Para uso em desenvolvimento e testes apenas
+- ECS/Fargate em desenvolvimento
+- WebSocket APIs em desenvolvimento
+- Para uso em desenvolvimento e testes apenas

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gugananuvem/aws-local-simulator",
-  "version": "1.0.11",
+  "version": "1.0.14",
   "description": "Simulador local completo para serviços AWS",
   "main": "src/index.js",
   "bin": {
@@ -45,7 +45,17 @@
     "lambda",
     "cognito",
     "apigateway",
+    "kms",
+    "config",
+    "parameter-store",
+    "secret-manager",
+    "cloudformation",
+    "eventbridge",
+    "sns",
     "ecs",
+    "sts",
+    "cloudtrail",
+    "cloudwatch",
     "development",
     "testing"
   ],
@@ -109,6 +119,6 @@
       "optional": true
     }
   },
-  "buildDate": "2026-04-03T22:32:50.683Z",
+  "buildDate": "2026-04-05T12:32:46.437Z",
   "published": true
 }

package/src/config/config-loader.js

@@ -23,6 +23,7 @@ class ConfigLoader {
     if (configPath) {
       const userConfig = await this.loadUserConfig(configPath);
       config = this.mergeDeep(config, userConfig);
+      config._configPath = path.resolve(process.cwd(), configPath);
     } else {
       // Tenta encontrar arquivo de configuração padrão
       const possiblePaths = [
@@ -35,6 +36,7 @@ class ConfigLoader {
         if (fs.existsSync(possiblePath)) {
           const userConfig = await this.loadUserConfig(possiblePath);
           config = this.mergeDeep(config, userConfig);
+          config._configPath = possiblePath;
           logger.info(`✅ Configuração carregada de: ${possiblePath}`);
           break;
         }

package/src/config/default-config.js

@@ -14,6 +14,7 @@ module.exports = {
     ecs: false,
     cognito: false,
     apigateway: false,
+    sts: true,
   },
 
   // Portas padrão
@@ -27,6 +28,8 @@ module.exports = {
     ecs: 8080,
     cognito: 9229,
     apigateway: 4567,
+    sts: 9326,
+    athena: 4599,
   },
   apigateway: {
     defaultCors: {

package/src/index.js

@@ -11,8 +11,16 @@ const DynamoDBService = require('./services/dynamodb');
 const S3Service = require('./services/s3');
 const SQSService = require('./services/sqs');
 const LambdaService = require('./services/lambda');
-const SNSService = require('./services/sns');
-const EventBridgeService = require('./services/eventbridge');
+const { SNSService } = require('./services/sns');
+const { EventBridgeService } = require('./services/eventbridge');
+const { CloudWatchService } = require('./services/cloudwatch');
+const CloudTrailService = require('./services/cloudtrail');
+const { KMSService } = require('./services/kms');
+const CloudFormationService = require('./services/cloudformation');
+const { XRayService } = require('./services/xray');
+const { SecretManagerService } = require('./services/secret-manager');
+const { ParameterStoreService } = require('./services/parameter-store');
+const { ConfigService } = require('./services/config');
 
 // Exporta utilitários
 const LocalStore = require('./utils/local-store');
@@ -122,6 +130,14 @@ module.exports = {
   LambdaService,
   SNSService,
   EventBridgeService,
+  CloudWatchService,
+  CloudTrailService,
+  KMSService,
+  CloudFormationService,
+  XRayService,
+  SecretManagerService,
+  ParameterStoreService,
+  ConfigService,
   LocalStore,
   HandlerLoader,
   RouteRegistry