@gugananuvem/aws-local-simulator 1.0.0 → 1.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (38) hide show
  1. package/README.md +192 -192
  2. package/bin/aws-local-simulator.js +62 -62
  3. package/package.json +8 -5
  4. package/src/config/config-loader.js +113 -0
  5. package/src/config/default-config.js +65 -0
  6. package/src/config/env-loader.js +67 -0
  7. package/src/index.js +130 -130
  8. package/src/index.mjs +124 -0
  9. package/src/server.js +219 -0
  10. package/src/services/apigateway/index.js +67 -0
  11. package/src/services/apigateway/server.js +435 -0
  12. package/src/services/apigateway/simulator.js +1252 -0
  13. package/src/services/cognito/index.js +66 -0
  14. package/src/services/cognito/server.js +229 -0
  15. package/src/services/cognito/simulator.js +848 -0
  16. package/src/services/dynamodb/index.js +71 -0
  17. package/src/services/dynamodb/server.js +122 -0
  18. package/src/services/dynamodb/simulator.js +614 -0
  19. package/src/services/eventbridge/index.js +85 -0
  20. package/src/services/index.js +19 -0
  21. package/src/services/lambda/handler-loader.js +173 -0
  22. package/src/services/lambda/index.js +73 -0
  23. package/src/services/lambda/route-registry.js +275 -0
  24. package/src/services/lambda/server.js +153 -0
  25. package/src/services/lambda/simulator.js +278 -0
  26. package/src/services/s3/index.js +70 -0
  27. package/src/services/s3/server.js +239 -0
  28. package/src/services/s3/simulator.js +740 -0
  29. package/src/services/sns/index.js +76 -0
  30. package/src/services/sqs/index.js +96 -0
  31. package/src/services/sqs/server.js +274 -0
  32. package/src/services/sqs/simulator.js +660 -0
  33. package/src/template/aws-config-template.js +88 -0
  34. package/src/template/aws-config-template.mjs +91 -0
  35. package/src/template/config-template.json +165 -0
  36. package/src/utils/aws-config.js +92 -0
  37. package/src/utils/local-store.js +68 -0
  38. package/src/utils/logger.js +60 -0
@@ -0,0 +1,278 @@
1
+ /**
2
+ * Lambda Simulator - Simula execução de funções Lambda
3
+ */
4
+
5
+ const HandlerLoader = require('./handler-loader');
6
+ const RouteRegistry = require('./route-registry');
7
+ const logger = require('../../utils/logger');
8
+
9
+ class LambdaSimulator {
10
+ constructor(config) {
11
+ this.config = config;
12
+ this.routeRegistry = new RouteRegistry();
13
+ this.lambdas = new Map();
14
+ this.environment = { ...process.env };
15
+ }
16
+
17
+ async initialize() {
18
+ logger.debug('Inicializando Lambda Simulator...');
19
+
20
+ if (this.config.lambdas && this.config.lambdas.length > 0) {
21
+ for (const lambdaConfig of this.config.lambdas) {
22
+ await this.registerLambda(lambdaConfig);
23
+ }
24
+ }
25
+
26
+ logger.debug(`✅ ${this.lambdas.size} Lambdas registradas`);
27
+ }
28
+
29
+ async registerLambda(lambdaConfig) {
30
+ try {
31
+ const { path, handler: handlerPath, env = {}, type = 'auto' } = lambdaConfig;
32
+
33
+ // Carrega o handler
34
+ const handler = await HandlerLoader.load(handlerPath, type);
35
+
36
+ // Registra no route registry
37
+ this.routeRegistry.register(path, handler, env);
38
+
39
+ // Armazena metadata
40
+ this.lambdas.set(path, {
41
+ path,
42
+ handler,
43
+ handlerPath,
44
+ handlerName: handler.name || 'anonymous',
45
+ env,
46
+ type,
47
+ registeredAt: new Date().toISOString()
48
+ });
49
+
50
+ logger.debug(`✅ Lambda registrada: ${path} -> ${handler.name || 'anonymous'}`);
51
+
52
+ } catch (error) {
53
+ logger.error(`❌ Erro ao registrar Lambda ${lambdaConfig.path}:`, error);
54
+ throw error;
55
+ }
56
+ }
57
+
58
+ async handleRequest(req, res) {
59
+ const matchedRoute = this.routeRegistry.find(req.path);
60
+
61
+ if (!matchedRoute) {
62
+ return {
63
+ error: {
64
+ statusCode: 404,
65
+ message: `Route not found: ${req.path}`,
66
+ availableRoutes: this.listRoutes()
67
+ },
68
+ status: 404
69
+ };
70
+ }
71
+
72
+ // Aplica variáveis de ambiente específicas da rota
73
+ this.applyEnvironment(matchedRoute.env);
74
+
75
+ // Prepara evento Lambda
76
+ const event = this.toLambdaEvent(req, matchedRoute.params);
77
+
78
+ logger.debug(`🎯 Executando: ${matchedRoute.path} -> ${matchedRoute.handler.name || 'anonymous'}`);
79
+
80
+ // Executa middlewares
81
+ const middlewares = this.routeRegistry.getMiddlewares(matchedRoute);
82
+ let handled = false;
83
+ let result = null;
84
+
85
+ const runMiddlewares = async (index) => {
86
+ if (index >= middlewares.length) {
87
+ // Executa handler
88
+ result = await this.executeHandler(matchedRoute.handler, event);
89
+ handled = true;
90
+ return;
91
+ }
92
+
93
+ const middleware = middlewares[index];
94
+ await new Promise((resolve, reject) => {
95
+ middleware(event, {
96
+ status: (code) => ({ json: (data) => {
97
+ result = { statusCode: code, body: data };
98
+ handled = true;
99
+ resolve();
100
+ }}),
101
+ send: (data) => {
102
+ result = { statusCode: 200, body: data };
103
+ handled = true;
104
+ resolve();
105
+ },
106
+ next: () => {
107
+ runMiddlewares(index + 1).then(resolve).catch(reject);
108
+ }
109
+ });
110
+ });
111
+ };
112
+
113
+ await runMiddlewares(0);
114
+
115
+ if (!handled && result) {
116
+ return this.formatResponse(result);
117
+ }
118
+
119
+ return null;
120
+ }
121
+
122
+ async executeHandler(handler, event) {
123
+ try {
124
+ const context = this.createContext();
125
+ const result = await handler(event, context);
126
+ return result;
127
+ } catch (error) {
128
+ logger.error('❌ Erro no handler:', error);
129
+ return {
130
+ statusCode: 500,
131
+ body: {
132
+ error: 'Internal Server Error',
133
+ message: error.message,
134
+ stack: process.env.NODE_ENV === 'development' ? error.stack : undefined
135
+ }
136
+ };
137
+ }
138
+ }
139
+
140
+ toLambdaEvent(req, params = {}) {
141
+ return {
142
+ httpMethod: req.method,
143
+ path: req.path,
144
+ headers: req.headers,
145
+ queryStringParameters: req.query,
146
+ pathParameters: params,
147
+ body: req.body ? (typeof req.body === 'string' ? req.body : JSON.stringify(req.body)) : null,
148
+ isBase64Encoded: false,
149
+ requestContext: {
150
+ path: req.path,
151
+ stage: process.env.STAGE_NAME || 'dev',
152
+ requestId: Math.random().toString(36).substring(7),
153
+ identity: {
154
+ sourceIp: req.ip,
155
+ userAgent: req.headers['user-agent']
156
+ }
157
+ },
158
+ stageVariables: {},
159
+ resource: req.path
160
+ };
161
+ }
162
+
163
+ formatResponse(result) {
164
+ const statusCode = result.statusCode || 200;
165
+ const body = result.body;
166
+ const headers = result.headers || { 'Content-Type': 'application/json' };
167
+
168
+ return {
169
+ statusCode,
170
+ headers,
171
+ body: typeof body === 'string' ? body : JSON.stringify(body),
172
+ isBase64Encoded: false
173
+ };
174
+ }
175
+
176
+ createContext() {
177
+ return {
178
+ awsRequestId: Math.random().toString(36).substring(7),
179
+ functionName: 'local-lambda',
180
+ functionVersion: '$LATEST',
181
+ invokedFunctionArn: 'arn:aws:lambda:local:function',
182
+ memoryLimitInMB: '1024',
183
+ logGroupName: '/aws/lambda/local-lambda',
184
+ logStreamName: 'local-stream',
185
+ getRemainingTimeInMillis: () => 30000,
186
+ callbackWaitsForEmptyEventLoop: true,
187
+ identity: null,
188
+ clientContext: null
189
+ };
190
+ }
191
+
192
+ applyEnvironment(env) {
193
+ for (const [key, value] of Object.entries(env)) {
194
+ process.env[key] = value;
195
+ this.environment[key] = value;
196
+ }
197
+ }
198
+
199
+ setEnvironmentVariable(key, value) {
200
+ process.env[key] = value;
201
+ this.environment[key] = value;
202
+ }
203
+
204
+ getEnvironmentVariables() {
205
+ return { ...this.environment };
206
+ }
207
+
208
+ listLambdas() {
209
+ return Array.from(this.lambdas.values()).map(l => ({
210
+ path: l.path,
211
+ handlerName: l.handlerName,
212
+ handlerPath: l.handlerPath,
213
+ type: l.type,
214
+ env: l.env,
215
+ registeredAt: l.registeredAt
216
+ }));
217
+ }
218
+
219
+ getLambda(path) {
220
+ return this.lambdas.get(path);
221
+ }
222
+
223
+ listRoutes() {
224
+ return this.routeRegistry.list();
225
+ }
226
+
227
+ getLambdasCount() {
228
+ return this.lambdas.size;
229
+ }
230
+
231
+ async reloadLambdas() {
232
+ logger.info('🔄 Recarregando Lambdas...');
233
+
234
+ for (const [path, lambda] of this.lambdas.entries()) {
235
+ try {
236
+ const newHandler = await HandlerLoader.reload(lambda.handlerPath, lambda.type);
237
+ this.routeRegistry.register(path, newHandler, lambda.env);
238
+ lambda.handler = newHandler;
239
+ lambda.handlerName = newHandler.name || 'anonymous';
240
+ logger.debug(`✅ Lambda recarregada: ${path}`);
241
+ } catch (error) {
242
+ logger.error(`❌ Erro ao recarregar Lambda ${path}:`, error);
243
+ }
244
+ }
245
+
246
+ logger.info(`✅ ${this.lambdas.size} Lambdas recarregadas`);
247
+ }
248
+
249
+ getStats() {
250
+ const lambdas = this.listLambdas();
251
+ return {
252
+ totalLambdas: lambdas.length,
253
+ lambdas: lambdas.map(l => ({
254
+ path: l.path,
255
+ handler: l.handlerName
256
+ })),
257
+ routes: this.routeRegistry.getStats(),
258
+ environment: Object.keys(this.environment).length
259
+ };
260
+ }
261
+
262
+ async reset() {
263
+ // Recarrega Lambdas
264
+ await this.reloadLambdas();
265
+
266
+ // Limpa variáveis de ambiente customizadas
267
+ for (const key of Object.keys(this.environment)) {
268
+ if (!process.env.hasOwnProperty(key) || key.startsWith('AWS_LOCAL_SIMULATOR_')) {
269
+ delete process.env[key];
270
+ }
271
+ }
272
+
273
+ this.environment = { ...process.env };
274
+ logger.debug('Lambda: Estado resetado');
275
+ }
276
+ }
277
+
278
+ module.exports = LambdaSimulator;
@@ -0,0 +1,70 @@
1
+ /**
2
+ * S3 Service - Ponto de entrada
3
+ * Exporta o serviço principal e seus componentes
4
+ */
5
+
6
+ const S3Server = require('./server');
7
+ const S3Simulator = require('./simulator');
8
+
9
+ class S3Service {
10
+ constructor(config) {
11
+ this.config = config;
12
+ this.name = 's3';
13
+ this.port = config.ports.s3;
14
+ this.server = null;
15
+ this.simulator = null;
16
+ this.isRunning = false;
17
+ }
18
+
19
+ async initialize() {
20
+ const logger = require('../../utils/logger');
21
+ logger.debug(`Inicializando S3 Service na porta ${this.port}...`);
22
+
23
+ // Cria o simulador
24
+ this.simulator = new S3Simulator(this.config);
25
+
26
+ // Cria o servidor HTTP
27
+ this.server = new S3Server(this.port, this.config);
28
+ this.server.simulator = this.simulator;
29
+
30
+ await this.server.initialize();
31
+
32
+ logger.debug('S3 Service inicializado');
33
+ }
34
+
35
+ async start() {
36
+ if (this.isRunning) return;
37
+ await this.server.start();
38
+ this.isRunning = true;
39
+ }
40
+
41
+ async stop() {
42
+ if (!this.isRunning) return;
43
+ await this.server.stop();
44
+ this.isRunning = false;
45
+ }
46
+
47
+ async reset() {
48
+ await this.simulator.reset();
49
+ }
50
+
51
+ getStatus() {
52
+ return {
53
+ running: this.isRunning,
54
+ port: this.port,
55
+ endpoint: `http://localhost:${this.port}`,
56
+ bucketsCount: this.simulator?.getBucketsCount() || 0,
57
+ objectsCount: this.simulator?.getTotalObjectsCount() || 0
58
+ };
59
+ }
60
+
61
+ getSimulator() {
62
+ return this.simulator;
63
+ }
64
+
65
+ getServer() {
66
+ return this.server;
67
+ }
68
+ }
69
+
70
+ module.exports = S3Service;
@@ -0,0 +1,239 @@
1
+ /**
2
+ * S3 Server - Servidor HTTP para S3
3
+ */
4
+
5
+ const express = require('express');
6
+ const S3Simulator = require('./simulator');
7
+ const logger = require('../../utils/logger');
8
+
9
+ class S3Server {
10
+ constructor(port, config) {
11
+ this.port = port;
12
+ this.config = config;
13
+ this.app = express();
14
+ this.simulator = null;
15
+ this.server = null;
16
+ this.setupMiddlewares();
17
+ }
18
+
19
+ setupMiddlewares() {
20
+ this.app.use(express.json({ limit: '100mb' }));
21
+ this.app.use(express.raw({ type: 'application/octet-stream', limit: '100mb' }));
22
+ this.app.use(express.text({ limit: '100mb' }));
23
+
24
+ // Logging de requisições
25
+ if (logger.currentLogLevel === 'verboso') {
26
+ this.app.use((req, res, next) => {
27
+ const start = Date.now();
28
+ res.on('finish', () => {
29
+ const duration = Date.now() - start;
30
+ logger.verboso(`S3: ${req.method} ${req.path} - ${duration}ms`);
31
+ });
32
+ next();
33
+ });
34
+ }
35
+ }
36
+
37
+ async initialize() {
38
+ this.simulator = new S3Simulator(this.config);
39
+ await this.simulator.initialize();
40
+ this.setupRoutes();
41
+ }
42
+
43
+ setupRoutes() {
44
+ // Listar buckets
45
+ this.app.get('/', (req, res) => {
46
+ const buckets = this.simulator.listBuckets();
47
+ res.set('Content-Type', 'application/xml');
48
+ res.send(this.simulator.generateListBucketsResponse(buckets));
49
+ });
50
+
51
+ // Criar bucket
52
+ this.app.put('/:bucket', (req, res) => {
53
+ const result = this.simulator.createBucket(req.params.bucket);
54
+ if (result.error) {
55
+ res.status(result.status).send(this.simulator.generateErrorResponse(result.error.code, result.error.message));
56
+ } else {
57
+ res.status(200).send();
58
+ }
59
+ });
60
+
61
+ // Deletar bucket
62
+ this.app.delete('/:bucket', (req, res) => {
63
+ const result = this.simulator.deleteBucket(req.params.bucket);
64
+ if (result.error) {
65
+ res.status(result.status).send(this.simulator.generateErrorResponse(result.error.code, result.error.message));
66
+ } else {
67
+ res.status(204).send();
68
+ }
69
+ });
70
+
71
+ // Head bucket
72
+ this.app.head('/:bucket', (req, res) => {
73
+ const bucket = this.simulator.getBucket(req.params.bucket);
74
+ if (!bucket) {
75
+ res.status(404).send();
76
+ } else {
77
+ res.status(200).send();
78
+ }
79
+ });
80
+
81
+ // Upload object
82
+ this.app.put('/:bucket/*', (req, res) => {
83
+ const bucket = req.params.bucket;
84
+ const key = req.params[0];
85
+ const result = this.simulator.putObject(bucket, key, req.body, req.headers);
86
+
87
+ if (result.error) {
88
+ res.status(result.status).send(this.simulator.generateErrorResponse(result.error.code, result.error.message));
89
+ } else {
90
+ res.set('ETag', `"${result.etag}"`);
91
+ res.status(200).send();
92
+ }
93
+ });
94
+
95
+ // Get object
96
+ this.app.get('/:bucket/*', (req, res) => {
97
+ const bucket = req.params.bucket;
98
+ const key = req.params[0];
99
+ const result = this.simulator.getObject(bucket, key, req.headers);
100
+
101
+ if (result.error) {
102
+ res.status(result.status).send(this.simulator.generateErrorResponse(result.error.code, result.error.message));
103
+ } else {
104
+ res.set('ETag', `"${result.etag}"`);
105
+ res.set('Last-Modified', result.lastModified);
106
+ res.set('Content-Type', result.contentType);
107
+ res.set('Content-Length', result.size);
108
+
109
+ if (result.metadata) {
110
+ Object.entries(result.metadata).forEach(([k, v]) => {
111
+ res.set(`x-amz-meta-${k}`, v);
112
+ });
113
+ }
114
+
115
+ res.send(result.content);
116
+ }
117
+ });
118
+
119
+ // Head object
120
+ this.app.head('/:bucket/*', (req, res) => {
121
+ const bucket = req.params.bucket;
122
+ const key = req.params[0];
123
+ const result = this.simulator.headObject(bucket, key);
124
+
125
+ if (result.error) {
126
+ res.status(result.status).send();
127
+ } else {
128
+ res.set('ETag', `"${result.etag}"`);
129
+ res.set('Last-Modified', result.lastModified);
130
+ res.set('Content-Type', result.contentType);
131
+ res.set('Content-Length', result.size);
132
+ res.status(200).send();
133
+ }
134
+ });
135
+
136
+ // Delete object
137
+ this.app.delete('/:bucket/*', (req, res) => {
138
+ const bucket = req.params.bucket;
139
+ const key = req.params[0];
140
+ const result = this.simulator.deleteObject(bucket, key);
141
+
142
+ if (result.error) {
143
+ res.status(result.status).send(this.simulator.generateErrorResponse(result.error.code, result.error.message));
144
+ } else {
145
+ res.status(204).send();
146
+ }
147
+ });
148
+
149
+ // List objects
150
+ this.app.get('/:bucket', (req, res) => {
151
+ const bucket = req.params.bucket;
152
+ const prefix = req.query.prefix || '';
153
+ const delimiter = req.query.delimiter;
154
+ const maxKeys = parseInt(req.query['max-keys']) || 1000;
155
+ const listType = req.query['list-type'];
156
+
157
+ const result = this.simulator.listObjects(bucket, { prefix, delimiter, maxKeys });
158
+
159
+ if (result.error) {
160
+ res.status(result.status).send(this.simulator.generateErrorResponse(result.error.code, result.error.message));
161
+ } else {
162
+ res.set('Content-Type', 'application/xml');
163
+ if (listType === '2') {
164
+ res.send(this.simulator.generateListObjectsV2Response(result));
165
+ } else {
166
+ res.send(this.simulator.generateListObjectsResponse(result));
167
+ }
168
+ }
169
+ });
170
+
171
+ // Admin endpoints
172
+ this.setupAdminRoutes();
173
+ }
174
+
175
+ setupAdminRoutes() {
176
+ this.app.get('/__admin/buckets', (req, res) => {
177
+ res.json(this.simulator.getBucketsInfo());
178
+ });
179
+
180
+ this.app.get('/__admin/buckets/:bucket', (req, res) => {
181
+ const info = this.simulator.getBucketInfo(req.params.bucket);
182
+ if (info.error) {
183
+ res.status(404).json(info.error);
184
+ } else {
185
+ res.json(info);
186
+ }
187
+ });
188
+
189
+ this.app.get('/__admin/buckets/:bucket/objects', (req, res) => {
190
+ const objects = this.simulator.listAllObjects(req.params.bucket);
191
+ res.json(objects);
192
+ });
193
+
194
+ this.app.delete('/__admin/buckets/:bucket', (req, res) => {
195
+ this.simulator.clearBucket(req.params.bucket);
196
+ res.json({ message: `Bucket ${req.params.bucket} cleared` });
197
+ });
198
+
199
+ this.app.delete('/__admin/buckets/:bucket/objects/:key', (req, res) => {
200
+ this.simulator.deleteObject(req.params.bucket, req.params.key);
201
+ res.json({ message: 'Object deleted' });
202
+ });
203
+
204
+ this.app.get('/__admin/stats', (req, res) => {
205
+ res.json(this.simulator.getStats());
206
+ });
207
+ }
208
+
209
+ start() {
210
+ return new Promise((resolve) => {
211
+ this.server = this.app.listen(this.port, () => {
212
+ logger.info(`🗄️ S3 rodando em http://localhost:${this.port}`);
213
+ resolve();
214
+ });
215
+ });
216
+ }
217
+
218
+ stop() {
219
+ return new Promise((resolve) => {
220
+ if (this.server) {
221
+ this.server.close(() => resolve());
222
+ } else {
223
+ resolve();
224
+ }
225
+ });
226
+ }
227
+
228
+ getStatus() {
229
+ return {
230
+ running: !!this.server,
231
+ port: this.port,
232
+ endpoint: `http://localhost:${this.port}`,
233
+ bucketsCount: this.simulator?.getBucketsCount() || 0,
234
+ objectsCount: this.simulator?.getTotalObjectsCount() || 0
235
+ };
236
+ }
237
+ }
238
+
239
+ module.exports = S3Server;