@gugananuvem/aws-local-simulator 1.0.10 → 1.0.12

package/README.md

@@ -1,193 +1,257 @@
-# AWS Local Simulator
-
-[![npm version](https://badge.fury.io/js/aws-local-simulator.svg)](https://badge.fury.io/js/aws-local-simulator)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-[![Node.js Version](https://img.shields.io/node/v/aws-local-simulator.svg)](https://nodejs.org)
-
-Simulador local completo para serviços AWS. Desenvolva e teste suas aplicações AWS localmente sem custos!
-
-## 🚀 Serviços Suportados
-
-| Serviço | Status | Porta Padrão | Descrição |
-|---------|--------|--------------|-----------|
-| DynamoDB | ✅ | 8000 | Banco de dados NoSQL |
-| S3 | ✅ | 4566 | Armazenamento de objetos |
-| SQS | ✅ | 9324 | Filas de mensagens |
-| 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) |
-
-## 📦 Instalação
-
-```bash
-npm install --save-dev aws-local-simulator
-```
-🚀 Uso Rápido
-1. Crie um arquivo de configuração aws-local-simulator.json:
-```json
-{
-  "services": {
-    "dynamodb": true,
-    "s3": true,
-    "sqs": true,
-    "lambda": true,
-    "cognito": true,
-    "apigateway": true
-  },
-  "lambdas": [
-    {
-      "path": "/api/users",
-      "handler": "./src/handlers/users.js",
-      "env": {
-        "TABLE_NAME": "users-table"
-      }
-    }
-  ],
-  "dynamodb": {
-    "tables": [
-      {
-        "TableName": "users-table",
-        "KeySchema": [
-          { "AttributeName": "id", "KeyType": "HASH" }
-        ],
-        "AttributeDefinitions": [
-          { "AttributeName": "id", "AttributeType": "S" }
-        ]
-      }
-    ]
-  },
-  "s3": {
-    "buckets": ["my-bucket"]
-  },
-  "cognito": {
-    "userPools": [
-      {
-        "PoolName": "my-user-pool",
-        "AutoVerifiedAttributes": ["email"]
-      }
-    ]
-  }
-}
-```
-
-# 2. Inicie o simulador:
-## 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:
-
-```javascript
-// Importe a configuração AWS pronta
-const { dynamoDB, s3, sqs, cognito, apigateway } = 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
-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
-```
-
-# 📝 Comandos CLI
-bash
-#### Iniciar simulador
-npx aws-local-simulator start [configPath]
-
-#### Parar simulador
-npx aws-local-simulator stop
-
-#### Reiniciar
-npx aws-local-simulator restart
-
-#### Resetar dados
-npx aws-local-simulator reset
-
-#### Status
-npx aws-local-simulator status
-
-# 🔌 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/lambdas
-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
-bash
-# DynamoDB
-aws dynamodb list-tables --endpoint-url http://localhost:8000
-
-# S3
-aws s3 ls --endpoint-url http://localhost:4566
-
-# SQS
-aws sqs list-queues --endpoint-url http://localhost:9324
-
-# Cognito
-aws cognito-idp list-user-pools --max-results 10 --endpoint-url http://localhost:9229
-
-# API Gateway
-aws apigateway get-rest-apis --endpoint-url http://localhost:4567
-📁 Estrutura de Dados
-Os dados são persistidos em:
-
-text
-.aws-local-simulator-data/
-├── dynamodb/
-├── s3/
-├── sqs/
-├── cognito/
-├── apigateway/
-└── ecs/
-🐛 Debug
-Para logs detalhados:
-
-bash
-AWS_LOCAL_SIMULATOR_LOG=verboso npx aws-local-simulator start
-🤝 Contribuindo
-Fork o projeto
-
-Crie sua feature branch (git checkout -b feature/AmazingFeature)
-
-Commit suas mudanças (git commit -m 'Add some AmazingFeature')
-
-Push para a branch (git push origin feature/AmazingFeature)
-
-Abra um Pull Request
-
-📄 Licença
-MIT © Luiz Gustavo Ribeiro
-
-⚠️ Limitações
-SNS e EventBridge em desenvolvimento
-
-WebSocket APIs em desenvolvimento
-
-Para uso em desenvolvimento e testes apenas
+# AWS Local Simulator
+
+[![npm version](https://badge.fury.io/js/aws-local-simulator.svg)](https://badge.fury.io/js/aws-local-simulator)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Node.js Version](https://img.shields.io/node/v/aws-local-simulator.svg)](https://nodejs.org)
+
+Simulador local completo para serviços AWS. Desenvolva e teste suas aplicações AWS localmente sem custos!
+
+## 🚀 Serviços Suportados
+
+| Serviço | Status | Porta Padrão | Descrição |
+|---------|--------|--------------|-----------|
+| DynamoDB | ✅ | 8000 | Banco de dados NoSQL |
+| S3 | ✅ | 4566 | Armazenamento de objetos |
+| SQS | ✅ | 9324 | Filas de mensagens |
+| Lambda | ✅ | 3001 | Funções serverless (invocação por nome) |
+| Cognito | ✅ | 9229 | Autenticação e autorização |
+| API Gateway | ✅ | 4567 | APIs REST e HTTP |
+| STS | ✅ | 9326 | Credenciais temporárias (AssumeRole, GetCallerIdentity) |
+| ECS/Fargate | 🚧 | 8080 | Orquestração de containers (em desenvolvimento) |
+| SNS | 🚧 | 9911 | Notificações (em desenvolvimento) |
+| EventBridge | 🚧 | 4010 | Barramento de eventos (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`:
+
+```json
+{
+  "services": {
+    "dynamodb": true,
+    "s3": true,
+    "sqs": true,
+    "lambda": true,
+    "cognito": true,
+    "apigateway": true,
+    "sts": true
+  },
+  "lambdas": [
+    {
+      "name": "my-function",
+      "handler": "./src/handlers/users.js",
+      "env": {
+        "TABLE_NAME": "users-table"
+      }
+    }
+  ],
+  "dynamodb": {
+    "tables": [
+      {
+        "TableName": "users-table",
+        "KeySchema": [{ "AttributeName": "id", "KeyType": "HASH" }],
+        "AttributeDefinitions": [{ "AttributeName": "id", "AttributeType": "S" }]
+      }
+    ]
+  },
+  "s3": {
+    "buckets": ["my-bucket"]
+  },
+  "sqs": {
+    "queues": ["my-queue", "dead-letter-queue"]
+  },
+  "cognito": {
+    "userPools": [
+      {
+        "PoolName": "my-user-pool",
+        "AutoVerifiedAttributes": ["email"]
+      }
+    ]
+  }
+}
+```
+
+### 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:
+
+```javascript
+const { dynamoDB, s3, sqs, cognito } = require('aws-local-simulator/aws-config');
+
+await dynamoDB.send(new PutCommand({
+  TableName: 'users-table',
+  Item: { id: '123', name: 'John' }
+}));
+```
+
+## 🔧 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_STS | Habilita STS | true |
+| 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_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
+
+```bash
+# Iniciar simulador
+npx aws-local-simulator start [configPath]
+
+# Parar simulador
+npx aws-local-simulator stop
+
+# Reiniciar
+npx aws-local-simulator restart
+
+# Resetar dados
+npx aws-local-simulator reset
+
+# Status
+npx aws-local-simulator status
+```
+
+## 🔌 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 |
+| STS | http://localhost:9326 | — |
+| ECS | http://localhost:8080 | http://localhost:8080/__admin/clusters |
+
+## 🧪 Testando com AWS CLI
+
+```bash
+# DynamoDB
+aws dynamodb list-tables --endpoint-url http://localhost:8000
+
+# S3
+aws s3 ls --endpoint-url http://localhost:4566
+
+# SQS
+aws sqs list-queues --endpoint-url http://localhost:9324
+
+# Lambda — invocar por nome (não por path HTTP)
+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
+
+# API Gateway
+aws apigateway get-rest-apis --endpoint-url http://localhost:4567
+```
+
+## ⚙️ 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-function",
+      "handler": "./src/handlers/my-function.js",
+      "env": {
+        "TABLE_NAME": "users-table",
+        "BUCKET_NAME": "my-bucket"
+      }
+    }
+  ]
+}
+```
+
+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
+
+Os dados são persistidos em:
+
+```text
+.aws-local-simulator-data/
+├── dynamodb/
+├── s3/
+├── sqs/
+├── cognito/
+├── apigateway/
+└── ecs/
+```
+
+## 🐛 Debug
+
+```bash
+AWS_LOCAL_SIMULATOR_LOG=verboso npx aws-local-simulator start
+```
+
+## 🤝 Contribuindo
+
+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
+
+## 📄 Licença
+
+MIT © Luiz Gustavo Ribeiro
+
+## ⚠️ Limitações
+
+- SNS e EventBridge em desenvolvimento
+- WebSocket APIs em desenvolvimento
+- Para uso em desenvolvimento e testes apenas

package/bin/aws-local-simulator.js

@@ -1,64 +1,64 @@
 #!/usr/bin/env node
-
-/**
- * CLI para AWS Local Simulator
- */
-
-const { AWSLocalSimulator } = require('../src/index');
-const logger = require('../src/utils/logger');
-const path = require('path');
-
-const command = process.argv[2];
-const configPath = process.argv[3];
-
-const simulator = new AWSLocalSimulator({
-  configPath: configPath ? path.resolve(process.cwd(), configPath) : undefined
-});
-
-async function main() {
-  switch (command) {
-    case 'start':
-      await simulator.start();
-      break;
-      
-    case 'stop':
-      await simulator.stop();
-      break;
-      
-    case 'restart':
-      await simulator.restart();
-      break;
-      
-    case 'reset':
-      await simulator.reset();
-      break;
-      
-    case 'status':
-      const status = simulator.getStatus();
-      console.log(JSON.stringify(status, null, 2));
-      break;
-      
-    case 'help':
-    default:
-      console.log(`
-AWS Local Simulator - CLI Commands:
-  start [configPath]  - Inicia o simulador
-  stop                - Para o simulador
-  restart             - Reinicia o simulador
-  reset               - Reseta todos os dados
-  status              - Mostra status dos serviços
-  help                - Mostra esta ajuda
-
-Exemplos:
-  npx aws-local-simulator start
-  npx aws-local-simulator start ./my-config.json
-  AWS_LOCAL_SIMULATOR_LOG=verboso npx aws-local-simulator start
-      `);
-      break;
-  }
-}
-
-main().catch(error => {
-  logger.error('Erro:', error);
-  process.exit(1);
+
+/**
+ * CLI para AWS Local Simulator
+ */
+
+const { AWSLocalSimulator } = require('../src/index');
+const logger = require('../src/utils/logger');
+const path = require('path');
+
+const command = process.argv[2];
+const configPath = process.argv[3];
+
+const simulator = new AWSLocalSimulator({
+  configPath: configPath ? path.resolve(process.cwd(), configPath) : undefined
+});
+
+async function main() {
+  switch (command) {
+    case 'start':
+      await simulator.start();
+      break;
+      
+    case 'stop':
+      await simulator.stop();
+      break;
+      
+    case 'restart':
+      await simulator.restart();
+      break;
+      
+    case 'reset':
+      await simulator.reset();
+      break;
+      
+    case 'status':
+      const status = simulator.getStatus();
+      console.log(JSON.stringify(status, null, 2));
+      break;
+      
+    case 'help':
+    default:
+      console.log(`
+AWS Local Simulator - CLI Commands:
+  start [configPath]  - Inicia o simulador
+  stop                - Para o simulador
+  restart             - Reinicia o simulador
+  reset               - Reseta todos os dados
+  status              - Mostra status dos serviços
+  help                - Mostra esta ajuda
+
+Exemplos:
+  npx aws-local-simulator start
+  npx aws-local-simulator start ./my-config.json
+  AWS_LOCAL_SIMULATOR_LOG=verboso npx aws-local-simulator start
+      `);
+      break;
+  }
+}
+
+main().catch(error => {
+  logger.error('Erro:', error);
+  process.exit(1);
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gugananuvem/aws-local-simulator",
-  "version": "1.0.10",
+  "version": "1.0.12",
   "description": "Simulador local completo para serviços AWS",
   "main": "src/index.js",
   "bin": {
@@ -109,6 +109,6 @@
       "optional": true
     }
   },
-  "buildDate": "2026-03-29T15:37:11.579Z",
+  "buildDate": "2026-04-04T03:21:21.370Z",
   "published": true
 }