@gugananuvem/aws-local-simulator 1.0.0

package/README.md

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

package/bin/aws-local-simulator.js

@@ -0,0 +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);
+});

package/package.json

@@ -0,0 +1,110 @@
+{
+  "name": "@gugananuvem/aws-local-simulator",
+  "version": "1.0.0",
+  "description": "Simulador local completo para serviços AWS",
+  "main": "src/index.js",
+  "bin": {
+    "aws-local-simulator": "bin/aws-local-simulator.js"
+  },
+  "scripts": {
+    "start": "node bin/aws-local-simulator.js start"
+  },
+  "jest": {
+    "setupFilesAfterEnv": [
+      "<rootDir>/tests/setup.js"
+    ],
+    "testEnvironment": "node",
+    "testMatch": [
+      "**/tests/**/*.test.js"
+    ],
+    "collectCoverageFrom": [
+      "src/**/*.js",
+      "!src/templates/**",
+      "!**/node_modules/**"
+    ],
+    "coverageThreshold": {
+      "global": {
+        "branches": 30,
+        "functions": 30,
+        "lines": 30,
+        "statements": 30
+      }
+    },
+    "verbose": true,
+    "testTimeout": 30000,
+    "forceExit": true,
+    "detectOpenHandles": true
+  },
+  "keywords": [
+    "aws",
+    "local",
+    "simulator",
+    "dynamodb",
+    "s3",
+    "sqs",
+    "lambda",
+    "cognito",
+    "apigateway",
+    "ecs",
+    "development",
+    "testing"
+  ],
+  "author": {
+    "name": "gugananuvem",
+    "email": "lgustavor@hotmail.com"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/seu-usuario/aws-local-simulator.git"
+  },
+  "engines": {
+    "node": ">=14.0.0"
+  },
+  "files": [
+    "dist/"
+  ],
+  "publishConfig": {
+    "directory": "dist"
+  },
+  "dependencies": {
+    "express": "^4.18.2",
+    "cors": "^2.8.5",
+    "uuid": "^9.0.0",
+    "glob": "^10.3.0",
+    "dotenv": "^16.3.1",
+    "jsonwebtoken": "^9.0.2",
+    "urlpattern-polyfill": "^10.0.0"
+  },
+  "peerDependencies": {
+    "@aws-sdk/client-dynamodb": "^3.0.0",
+    "@aws-sdk/client-s3": "^3.0.0",
+    "@aws-sdk/client-sqs": "^3.0.0",
+    "@aws-sdk/client-cognito-identity-provider": "^3.0.0",
+    "@aws-sdk/client-api-gateway": "^3.0.0",
+    "@aws-sdk/client-ecs": "^3.0.0",
+    "@aws-sdk/lib-dynamodb": "^3.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@aws-sdk/client-dynamodb": {
+      "optional": true
+    },
+    "@aws-sdk/client-s3": {
+      "optional": true
+    },
+    "@aws-sdk/client-sqs": {
+      "optional": true
+    },
+    "@aws-sdk/client-cognito-identity-provider": {
+      "optional": true
+    },
+    "@aws-sdk/client-api-gateway": {
+      "optional": true
+    },
+    "@aws-sdk/client-ecs": {
+      "optional": true
+    }
+  },
+  "buildDate": "2026-03-29T01:01:59.763Z",
+  "published": true
+}

package/src/index.js

@@ -0,0 +1,131 @@
+/**
+ * AWS Local Simulator - Entry Point Principal
+ */
+
+const Server = require('./server');
+const { loadConfig } = require('./config/config-loader');
+const logger = require('./utils/logger');
+
+// Exporta serviços para uso programático
+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');
+
+// Exporta utilitários
+const LocalStore = require('./utils/local-store');
+const HandlerLoader = require('./services/lambda/handler-loader');
+const RouteRegistry = require('./services/lambda/route-registry');
+
+class AWSLocalSimulator {
+  constructor(options = {}) {
+    this.options = options;
+    this.server = null;
+    this.isRunning = false;
+  }
+
+  async start() {
+    if (this.isRunning) {
+      logger.warn('Simulador já está rodando');
+      return this;
+    }
+
+    try {
+      const config = await loadConfig(this.options.configPath);
+      this.server = new Server(config);
+      await this.server.start();
+      this.isRunning = true;
+      logger.success('✅ AWS Local Simulator iniciado com sucesso');
+      return this;
+    } catch (error) {
+      logger.error('❌ Erro ao iniciar simulador:', error);
+      throw error;
+    }
+  }
+
+  async stop() {
+    if (!this.isRunning || !this.server) {
+      logger.warn('Simulador não está rodando');
+      return this;
+    }
+
+    try {
+      await this.server.stop();
+      this.isRunning = false;
+      logger.info('🛑 AWS Local Simulator parado');
+      return this;
+    } catch (error) {
+      logger.error('❌ Erro ao parar simulador:', error);
+      throw error;
+    }
+  }
+
+  async restart() {
+    await this.stop();
+    await this.start();
+    return this;
+  }
+
+  async reset() {
+    if (!this.server) {
+      throw new Error('Simulador não iniciado');
+    }
+    await this.server.reset();
+    logger.success('🗑️ Todos os dados foram resetados');
+    return this;
+  }
+
+  getStatus() {
+    if (!this.server) {
+      return { running: false };
+    }
+    return {
+      running: this.isRunning,
+      services: this.server.getStatus()
+    };
+  }
+
+  getService(serviceName) {
+    if (!this.server) {
+      return null;
+    }
+    return this.server.getService(serviceName);
+  }
+
+  // Métodos de conveniência
+  getDynamoDB() {
+    return this.getService('dynamodb')?.getSimulator();
+  }
+
+  getS3() {
+    return this.getService('s3')?.getSimulator();
+  }
+
+  getSQS() {
+    return this.getService('sqs')?.getSimulator();
+  }
+
+  getLambda() {
+    return this.getService('lambda')?.getSimulator();
+  }
+}
+
+// Exporta classes e utilitários
+module.exports = {
+  AWSLocalSimulator,
+  Server,
+  DynamoDBService,
+  S3Service,
+  SQSService,
+  LambdaService,
+  SNSService,
+  EventBridgeService,
+  LocalStore,
+  HandlerLoader,
+  RouteRegistry
+};
+
+// Exporta também como default para ES Modules compatibilidade
+module.exports.default = AWSLocalSimulator;