@gugananuvem/aws-local-simulator 1.0.0 → 1.0.2

package/README.md

@@ -1,192 +1,192 @@
-# 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 |
+| 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

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.0",
+  "version": "1.0.2",
   "description": "Simulador local completo para serviços AWS",
   "main": "src/index.js",
   "bin": {
@@ -56,13 +56,16 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/seu-usuario/aws-local-simulator.git"
+    "url": "git+https://github.com/gugananuvem/aws-local-simulator.git"
   },
   "engines": {
     "node": ">=14.0.0"
   },
   "files": [
-    "dist/"
+    "src/",
+    "bin/",
+    "README.md",
+    "LICENSE"
   ],
   "publishConfig": {
     "directory": "dist"
@@ -105,6 +108,6 @@
       "optional": true
     }
   },
-  "buildDate": "2026-03-29T01:01:59.763Z",
+  "buildDate": "2026-03-29T01:51:13.759Z",
   "published": true
 }

package/src/config/config-loader.js

@@ -0,0 +1,113 @@
+/**
+ * Carrega configurações do usuário
+ */
+
+const fs = require('fs');
+const path = require('path');
+const defaultConfig = require('./default-config');
+const EnvLoader = require('./env-loader');
+const logger = require('../utils/logger');
+
+class ConfigLoader {
+  static async load(configPath) {
+    logger.info('📝 Carregando configurações...');
+    
+    // 1. Carrega configurações padrão
+    let config = { ...defaultConfig };
+    
+    // 2. Sobrescreve com variáveis de ambiente
+    const envConfig = EnvLoader.load();
+    config = this.mergeDeep(config, envConfig);
+    
+    // 3. Sobrescreve com arquivo de configuração do usuário se existir
+    if (configPath) {
+      const userConfig = await this.loadUserConfig(configPath);
+      config = this.mergeDeep(config, userConfig);
+    } else {
+      // Tenta encontrar arquivo de configuração padrão
+      const possiblePaths = [
+        path.join(process.cwd(), 'aws-local-simulator.json'),
+        path.join(process.cwd(), 'aws-local-simulator.config.json'),
+        path.join(process.cwd(), '.aws-local-simulator.json')
+      ];
+      
+      for (const possiblePath of possiblePaths) {
+        if (fs.existsSync(possiblePath)) {
+          const userConfig = await this.loadUserConfig(possiblePath);
+          config = this.mergeDeep(config, userConfig);
+          logger.info(`✅ Configuração carregada de: ${possiblePath}`);
+          break;
+        }
+      }
+    }
+    
+    // 4. Valida configurações
+    this.validate(config);
+    
+    logger.info(`✅ Configurações carregadas (logLevel: ${config.logLevel})`);
+    
+    return config;
+  }
+  
+  static async loadUserConfig(filePath) {
+    try {
+      const fullPath = path.resolve(process.cwd(), filePath);
+      
+      if (!fs.existsSync(fullPath)) {
+        logger.warn(`Arquivo de configuração não encontrado: ${fullPath}`);
+        return {};
+      }
+      
+      const content = fs.readFileSync(fullPath, 'utf8');
+      const config = JSON.parse(content);
+      
+      return config;
+    } catch (error) {
+      logger.error(`Erro ao carregar configuração de ${filePath}:`, error);
+      throw error;
+    }
+  }
+  
+  static validate(config) {
+    // Valida serviços
+    const enabledServices = Object.entries(config.services)
+      .filter(([_, enabled]) => enabled)
+      .map(([name]) => name);
+    
+    if (enabledServices.length === 0) {
+      logger.warn('⚠️ Nenhum serviço está habilitado!');
+    } else {
+      logger.info(`📦 Serviços habilitados: ${enabledServices.join(', ')}`);
+    }
+    
+    // Valida diretório de dados
+    if (!config.dataDir) {
+      throw new Error('dataDir não configurado');
+    }
+    
+    // Valida portas
+    for (const [service, port] of Object.entries(config.ports)) {
+      if (config.services[service] && (port < 1 || port > 65535)) {
+        throw new Error(`Porta inválida para ${service}: ${port}`);
+      }
+    }
+  }
+  
+  static mergeDeep(target, source) {
+    const output = { ...target };
+    
+    for (const key in source) {
+      if (source.hasOwnProperty(key)) {
+        if (source[key] && typeof source[key] === 'object' && !Array.isArray(source[key])) {
+          output[key] = this.mergeDeep(target[key] || {}, source[key]);
+        } else {
+          output[key] = source[key];
+        }
+      }
+    }
+    
+    return output;
+  }
+}
+
+module.exports = { loadConfig: ConfigLoader.load.bind(ConfigLoader) };