bootifyjs 0.1.0 → 1.0.0

package/dist/core/router.js

@@ -1,266 +1,89 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Router = void 0;
-const container_1 = require("./container");
-const errors_1 = require("./errors");
-const utils_1 = require("./utils");
-const validation_1 = require("./validation");
-const logger_service_1 = require("../logging/core/logger.service");
-class Router {
-    constructor() {
-        this.routes = [];
-        try {
-            this.logger = logger_service_1.LoggerService.getInstance();
+exports.registerControllers = registerControllers;
+const zod_to_json_schema_1 = require("zod-to-json-schema");
+const di_container_1 = require("./di-container");
+const decorators_1 = require("./decorators");
+// const buildJsonSchema = (schemas: any) => {
+//   const schema: any = {}
+//   if (schemas.body) schema.body = zodToJsonSchema(schemas.body)
+//   if (schemas.query) schema.querystring = zodToJsonSchema(schemas.query)
+//   if (schemas.params) schema.params = zodToJsonSchema(schemas.params)
+//   return schema
+// }
+function buildFastifySchema(options) {
+    const schema = {};
+    if (options.body)
+        schema.body = (0, zod_to_json_schema_1.zodToJsonSchema)(options.body);
+    if (options.query)
+        schema.querystring = (0, zod_to_json_schema_1.zodToJsonSchema)(options.query);
+    if (options.params)
+        schema.params = (0, zod_to_json_schema_1.zodToJsonSchema)(options.params);
+    if (options.responses) {
+        schema.response = {};
+        for (const statusCode in options.responses) {
+            schema.response[statusCode] = (0, zod_to_json_schema_1.zodToJsonSchema)(options.responses[statusCode]);
         }
-        catch (error) {
-            // Logger not initialized yet
-        }
-    }
-    registerControllers(controllers) {
-        if (this.logger) {
-            this.logger.component('Registering controllers', { count: controllers.length });
-        }
-        controllers.forEach(Controller => {
-            this.registerController(Controller);
-        });
-        if (this.logger) {
-            this.logger.component('Controllers registered successfully', {
-                totalRoutes: this.routes.length,
-                controllers: controllers.map(c => c.name)
-            });
-        }
-        // Log all registered routes
-        this.logRegisteredRoutes();
     }
-    registerController(Controller) {
-        const prefix = Reflect.getMetadata('controller:prefix', Controller) || '';
-        const classMiddlewares = Reflect.getMetadata('middlewares', Controller) || [];
-        const instance = container_1.container.resolve(Controller);
-        if (this.logger) {
-            this.logger.trace(`Registering controller: ${Controller.name}`, { prefix });
-        }
-        const methodNames = Object.getOwnPropertyNames(Controller.prototype);
-        methodNames.forEach(methodName => {
-            if (methodName === 'constructor')
-                return;
-            const method = Reflect.getMetadata('route:method', Controller.prototype, methodName);
-            const path = Reflect.getMetadata('route:path', Controller.prototype, methodName);
-            const methodMiddlewares = Reflect.getMetadata('middlewares', Controller.prototype, methodName) || [];
-            if (method && path !== undefined) {
-                const fullPath = `${prefix}${path}`.replace(/\/+/g, '/');
-                const allMiddlewares = [...classMiddlewares, ...methodMiddlewares];
-                this.routes.push({
-                    method: method.toUpperCase(),
-                    path: fullPath,
-                    handler: Controller.prototype[methodName],
-                    controller: instance,
-                    middlewares: allMiddlewares,
-                    originalMethod: methodName
-                });
-                if (this.logger) {
-                    this.logger.trace(`Route registered: ${method.toUpperCase()} ${fullPath}`, {
-                        controller: Controller.name,
-                        method: methodName,
-                        middlewares: allMiddlewares.length
-                    });
-                }
-            }
-        });
-    }
-    logRegisteredRoutes() {
-        if (!this.logger)
-            return;
-        // Group routes by controller for better organization
-        const routesByController = this.routes.reduce((acc, route) => {
-            const controllerName = route.controller.constructor.name;
-            if (!acc[controllerName]) {
-                acc[controllerName] = [];
-            }
-            acc[controllerName].push({
+    return schema;
+}
+function registerControllers(fastify, controllers) {
+    console.log('📋 Registering controllers...');
+    controllers.forEach((controllerClass) => {
+        // 👇 Read controller-level middleware
+        const classMiddlewares = Reflect.getMetadata(decorators_1.METADATA_KEYS.middleware, controllerClass) || [];
+        const controllerInstance = di_container_1.container.resolve(controllerClass);
+        const prefix = Reflect.getMetadata(decorators_1.METADATA_KEYS.controllerPrefix, controllerClass) || '';
+        const routes = Reflect.getMetadata(decorators_1.METADATA_KEYS.routes, controllerClass) || [];
+        routes.forEach((route) => {
+            // 👇 Read method-level middleware
+            const methodMiddlewares = Reflect.getMetadata(decorators_1.METADATA_KEYS.middleware, controllerInstance, route.handlerName) || [];
+            const allMiddlewares = [...classMiddlewares, ...methodMiddlewares]; // Combine them
+            const handler = controllerInstance[route.handlerName].bind(controllerInstance);
+            const paramDecorators = Reflect.getMetadata(decorators_1.METADATA_KEYS.paramTypes, controllerInstance, route.handlerName) || [];
+            const validationSchemas = Reflect.getMetadata(decorators_1.METADATA_KEYS.validationSchema, controllerInstance, route.handlerName);
+            console.log(validationSchemas);
+            const routeOptions = {
                 method: route.method,
-                path: route.path,
-                handler: route.originalMethod,
-                middlewares: route.middlewares.length
-            });
-            return acc;
-        }, {});
-        // Log summary
-        this.logger.info('📋 Registered Routes Summary', {
-            totalRoutes: this.routes.length,
-            controllers: Object.keys(routesByController).length
+                url: `${prefix}${route.path}`.replace(/\/+/g, '/'),
+                schema: validationSchemas ? buildFastifySchema(validationSchemas) : {},
+                // 👇 Attach all middleware functions to the preHandler hook
+                preHandler: allMiddlewares,
+                handler: async (request, reply) => {
+                    // ... handler logic remains the same
+                    try {
+                        const args = paramDecorators.map((param) => {
+                            if (!param)
+                                return undefined;
+                            switch (param.type) {
+                                case 'body':
+                                    return request.body;
+                                case 'query':
+                                    return param.name ? request.query[param.name] : request.query;
+                                case 'param':
+                                    return request.params[param.name];
+                                case 'request':
+                                    return request;
+                                case 'reply':
+                                    return reply;
+                                default:
+                                    return undefined;
+                            }
+                        });
+                        const result = await handler(...args);
+                        if (!reply.sent) {
+                            return result;
+                        }
+                    }
+                    catch (error) {
+                        throw error;
+                    }
+                },
+            };
+            fastify.route(routeOptions);
+            console.log(`  ✓  Registered: ${route.method.padEnd(7)} ${routeOptions.url} (middlewares: ${allMiddlewares.length})`);
         });
-        // Log routes by controller
-        Object.entries(routesByController).forEach(([controllerName, routes]) => {
-            this.logger.info(`🎯 ${controllerName} Routes:`, {
-                controller: controllerName,
-                routes: routes.map(r => `${r.method} ${r.path} -> ${r.handler}()`),
-                count: routes.length
-            });
-        });
-        // Create a formatted table for console output
-        this.logRoutesTable();
-    }
-    logRoutesTable() {
-        console.log('\n📋 Available Routes:');
-        console.log('─'.repeat(80));
-        console.log('Method'.padEnd(8) + 'Path'.padEnd(30) + 'Controller'.padEnd(20) + 'Handler'.padEnd(15) + 'Middlewares');
-        console.log('─'.repeat(80));
-        // Sort routes by path for better readability
-        const sortedRoutes = [...this.routes].sort((a, b) => a.path.localeCompare(b.path));
-        sortedRoutes.forEach(route => {
-            const method = route.method.padEnd(8);
-            const path = route.path.padEnd(30);
-            const controller = route.controller.constructor.name.padEnd(20);
-            const handler = route.originalMethod.padEnd(15);
-            const middlewares = route.middlewares.length.toString();
-            console.log(`${method}${path}${controller}${handler}${middlewares}`);
-        });
-        console.log('─'.repeat(80));
-        console.log(`Total: ${this.routes.length} routes registered\n`);
-    }
-    getRoutes() {
-        return [...this.routes];
-    }
-    getRoutesSummary() {
-        const routesByMethod = this.routes.reduce((acc, route) => {
-            acc[route.method] = (acc[route.method] || 0) + 1;
-            return acc;
-        }, {});
-        const routesByController = this.routes.reduce((acc, route) => {
-            const controllerName = route.controller.constructor.name;
-            acc[controllerName] = (acc[controllerName] || 0) + 1;
-            return acc;
-        }, {});
-        return {
-            totalRoutes: this.routes.length,
-            routesByMethod,
-            routesByController
-        };
-    }
-    getRouteCount() {
-        return this.routes.length;
-    }
-    async handleRequest(req, res) {
-        const method = req.method?.toUpperCase() || 'GET';
-        const url = req.url || '/';
-        const pathname = url.split('?')[0];
-        const route = this.findRoute(method, pathname);
-        if (!route) {
-            // Check if response has already been sent (e.g., by middleware)
-            if (res.headersSent) {
-                return;
-            }
-            res.writeHead(404, { 'Content-Type': 'application/json' });
-            res.end(JSON.stringify({ error: 'Not Found', status: 404 }));
-            return;
-        }
-        try {
-            await this.executeRoute(route, req, res);
-        }
-        catch (error) {
-            (0, errors_1.errorHandler)(error, res);
-        }
-    }
-    findRoute(method, pathname) {
-        // First try exact match for better performance
-        const exactMatches = this.routes.filter(route => route.method === method && route.path === pathname);
-        if (exactMatches.length > 0) {
-            return { ...exactMatches[0], params: {} };
-        }
-        // Then try pattern matching
-        for (const route of this.routes) {
-            if (route.method === method) {
-                const { isMatch, params } = (0, utils_1.matchRoute)(route.path, pathname);
-                if (isMatch) {
-                    return { ...route, params };
-                }
-            }
-        }
-        return null;
-    }
-    async executeRoute(route, req, res) {
-        // Execute middlewares
-        await this.executeMiddlewares(route.middlewares, req, res);
-        // Prepare handler arguments
-        const args = await this.prepareHandlerArgs(route, req, res);
-        // Execute handler
-        const result = await route.handler.call(route.controller, ...args);
-        // Validate response if schema exists
-        const validationMeta = Reflect.getMetadata('validation', route.controller, route.originalMethod) || {};
-        let finalResult = result;
-        if (validationMeta.response && result !== undefined) {
-            finalResult = validation_1.ValidationService.validateResponse(result, validationMeta.response);
-        }
-        // Send response if not already sent
-        if (!res.headersSent) {
-            res.writeHead(200, { 'Content-Type': 'application/json' });
-            res.end(JSON.stringify(finalResult));
-        }
-    }
-    async executeMiddlewares(middlewares, req, res) {
-        let index = 0;
-        const next = async () => {
-            if (index < middlewares.length) {
-                const middleware = middlewares[index++];
-                await middleware(req, res, next);
-            }
-        };
-        await next();
-    }
-    async prepareHandlerArgs(route, req, res) {
-        const paramTypes = Reflect.getMetadata('design:paramtypes', route.controller, route.originalMethod) || [];
-        const validationMeta = Reflect.getMetadata('validation', route.controller, route.originalMethod) || {};
-        const args = [];
-        // Parse and validate request data
-        let body = null;
-        let query = null;
-        let params = route.params;
-        // Validate params if schema exists
-        if (validationMeta.params) {
-            params = validation_1.ValidationService.validateParams(route.params, validationMeta.params);
-        }
-        // Parse and validate query if needed
-        if (validationMeta.query) {
-            const rawQuery = (0, utils_1.parseQuery)(req);
-            query = validation_1.ValidationService.validateQuery(rawQuery, validationMeta.query);
-        }
-        else {
-            query = (0, utils_1.parseQuery)(req);
-        }
-        // Parse and validate body if needed
-        if (validationMeta.body) {
-            const rawBody = await (0, utils_1.parseBody)(req);
-            body = validation_1.ValidationService.validateBody(rawBody, validationMeta.body);
-        }
-        for (let i = 0; i < paramTypes.length; i++) {
-            const paramMeta = Reflect.getMetadata(`param:${i}`, route.controller.constructor.prototype, route.originalMethod);
-            if (paramMeta) {
-                switch (paramMeta.type) {
-                    case 'request':
-                        args[i] = req;
-                        break;
-                    case 'response':
-                        args[i] = res;
-                        break;
-                    case 'body':
-                        args[i] = body || await (0, utils_1.parseBody)(req);
-                        break;
-                    case 'param':
-                        args[i] = params[paramMeta.name];
-                        break;
-                    case 'query':
-                        args[i] = paramMeta.name ? query[paramMeta.name] : query;
-                        break;
-                    default:
-                        args[i] = undefined;
-                }
-            }
-            else {
-                args[i] = undefined;
-            }
-        }
-        return args;
-    }
+    });
+    console.log('✅ All controllers registered successfully!\n');
 }
-exports.Router = Router;
 //# sourceMappingURL=router.js.map

package/dist/core/router.js.map

@@ -1 +1 @@
-{"version":3,"file":"router.js","sourceRoot":"","sources":["../../src/core/router.ts"],"names":[],"mappings":";;;AACA,2CAAwC;AAExC,qCAAwC;AACxC,mCAA4D;AAC5D,6CAAqE;AACrE,mEAA+D;AAW/D,MAAa,MAAM;IAIjB;QAHQ,WAAM,GAAsB,EAAE,CAAC;QAIrC,IAAI,CAAC;YACH,IAAI,CAAC,MAAM,GAAG,8BAAa,CAAC,WAAW,EAAE,CAAC;QAC5C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,6BAA6B;QAC/B,CAAC;IACH,CAAC;IAED,mBAAmB,CAAC,WAAkB;QACpC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,yBAAyB,EAAE,EAAE,KAAK,EAAE,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC;QAClF,CAAC;QAED,WAAW,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE;YAC/B,IAAI,CAAC,kBAAkB,CAAC,UAAU,CAAC,CAAC;QACtC,CAAC,CAAC,CAAC;QAEH,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,qCAAqC,EAAE;gBAC3D,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM;gBAC/B,WAAW,EAAE,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;aAC1C,CAAC,CAAC;QACL,CAAC;QAED,4BAA4B;QAC5B,IAAI,CAAC,mBAAmB,EAAE,CAAC;IAC7B,CAAC;IAEO,kBAAkB,CAAC,UAAe;QACxC,MAAM,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,mBAAmB,EAAE,UAAU,CAAC,IAAI,EAAE,CAAC;QAC1E,MAAM,gBAAgB,GAAG,OAAO,CAAC,WAAW,CAAC,aAAa,EAAE,UAAU,CAAC,IAAI,EAAE,CAAC;QAC9E,MAAM,QAAQ,GAAG,qBAAS,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QAE/C,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,2BAA2B,UAAU,CAAC,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;QAC9E,CAAC;QAED,MAAM,WAAW,GAAG,MAAM,CAAC,mBAAmB,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;QAErE,WAAW,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE;YAC/B,IAAI,UAAU,KAAK,aAAa;gBAAE,OAAO;YAEzC,MAAM,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,cAAc,EAAE,UAAU,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;YACrF,MAAM,IAAI,GAAG,OAAO,CAAC,WAAW,CAAC,YAAY,EAAE,UAAU,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;YACjF,MAAM,iBAAiB,GAAG,OAAO,CAAC,WAAW,CAAC,aAAa,EAAE,UAAU,CAAC,SAAS,EAAE,UAAU,CAAC,IAAI,EAAE,CAAC;YAErG,IAAI,MAAM,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;gBACjC,MAAM,QAAQ,GAAG,GAAG,MAAM,GAAG,IAAI,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;gBACzD,MAAM,cAAc,GAAG,CAAC,GAAG,gBAAgB,EAAE,GAAG,iBAAiB,CAAC,CAAC;gBAEnE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;oBACf,MAAM,EAAE,MAAM,CAAC,WAAW,EAAE;oBAC5B,IAAI,EAAE,QAAQ;oBACd,OAAO,EAAE,UAAU,CAAC,SAAS,CAAC,UAAU,CAAC;oBACzC,UAAU,EAAE,QAAQ;oBACpB,WAAW,EAAE,cAAc;oBAC3B,cAAc,EAAE,UAAU;iBAC3B,CAAC,CAAC;gBAEH,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;oBAChB,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,qBAAqB,MAAM,CAAC,WAAW,EAAE,IAAI,QAAQ,EAAE,EAAE;wBACzE,UAAU,EAAE,UAAU,CAAC,IAAI;wBAC3B,MAAM,EAAE,UAAU;wBAClB,WAAW,EAAE,cAAc,CAAC,MAAM;qBACnC,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,mBAAmB;QACzB,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,OAAO;QAEzB,qDAAqD;QACrD,MAAM,kBAAkB,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE;YAC3D,MAAM,cAAc,GAAG,KAAK,CAAC,UAAU,CAAC,WAAW,CAAC,IAAI,CAAC;YACzD,IAAI,CAAC,GAAG,CAAC,cAAc,CAAC,EAAE,CAAC;gBACzB,GAAG,CAAC,cAAc,CAAC,GAAG,EAAE,CAAC;YAC3B,CAAC;YACD,GAAG,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC;gBACvB,MAAM,EAAE,KAAK,CAAC,MAAM;gBACpB,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,OAAO,EAAE,KAAK,CAAC,cAAc;gBAC7B,WAAW,EAAE,KAAK,CAAC,WAAW,CAAC,MAAM;aACtC,CAAC,CAAC;YACH,OAAO,GAAG,CAAC;QACb,CAAC,EAAE,EAA2B,CAAC,CAAC;QAEhC,cAAc;QACd,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,8BAA8B,EAAE;YAC/C,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM;YAC/B,WAAW,EAAE,MAAM,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC,MAAM;SACpD,CAAC,CAAC;QAEH,2BAA2B;QAC3B,MAAM,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,cAAc,EAAE,MAAM,CAAC,EAAE,EAAE;YACtE,IAAI,CAAC,MAAO,CAAC,IAAI,CAAC,MAAM,cAAc,UAAU,EAAE;gBAChD,UAAU,EAAE,cAAc;gBAC1B,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,OAAO,IAAI,CAAC;gBAClE,KAAK,EAAE,MAAM,CAAC,MAAM;aACrB,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,8CAA8C;QAC9C,IAAI,CAAC,cAAc,EAAE,CAAC;IACxB,CAAC;IAEO,cAAc;QACpB,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC;QACtC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;QAC5B,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,aAAa,CAAC,CAAC;QACrH,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;QAE5B,6CAA6C;QAC7C,MAAM,YAAY,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QAEnF,YAAY,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE;YAC3B,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YACtC,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YACnC,MAAM,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YAChE,MAAM,OAAO,GAAG,KAAK,CAAC,cAAc,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YAChD,MAAM,WAAW,GAAG,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;YAExD,OAAO,CAAC,GAAG,CAAC,GAAG,MAAM,GAAG,IAAI,GAAG,UAAU,GAAG,OAAO,GAAG,WAAW,EAAE,CAAC,CAAC;QACvE,CAAC,CAAC,CAAC;QAEH,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;QAC5B,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,CAAC,MAAM,CAAC,MAAM,sBAAsB,CAAC,CAAC;IAClE,CAAC;IAED,SAAS;QACP,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;IAC1B,CAAC;IAED,gBAAgB;QACd,MAAM,cAAc,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE;YACvD,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;YACjD,OAAO,GAAG,CAAC;QACb,CAAC,EAAE,EAA4B,CAAC,CAAC;QAEjC,MAAM,kBAAkB,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE;YAC3D,MAAM,cAAc,GAAG,KAAK,CAAC,UAAU,CAAC,WAAW,CAAC,IAAI,CAAC;YACzD,GAAG,CAAC,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;YACrD,OAAO,GAAG,CAAC;QACb,CAAC,EAAE,EAA4B,CAAC,CAAC;QAEjC,OAAO;YACL,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM;YAC/B,cAAc;YACd,kBAAkB;SACnB,CAAC;IACJ,CAAC;IACD,aAAa;QACX,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;IAC5B,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,GAAoB,EAAE,GAAmB;QAC3D,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,WAAW,EAAE,IAAI,KAAK,CAAC;QAClD,MAAM,GAAG,GAAG,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC;QAC3B,MAAM,QAAQ,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QAEnC,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QAE/C,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,gEAAgE;YAChE,IAAI,GAAG,CAAC,WAAW,EAAE,CAAC;gBACpB,OAAO;YACT,CAAC;YACD,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAC,CAAC;YAC3D,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;YAC7D,OAAO;QACT,CAAC;QAED,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;QAC3C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAA,qBAAY,EAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;IAEO,SAAS,CAAC,MAAc,EAAE,QAAgB;QAChD,+CAA+C;QAC/C,MAAM,YAAY,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,KAAK,MAAM,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC;QACrG,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC5B,OAAO,EAAE,GAAG,YAAY,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;QAC5C,CAAC;QAED,4BAA4B;QAC5B,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChC,IAAI,KAAK,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;gBAC5B,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,IAAA,kBAAU,EAAC,KAAK,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;gBAC7D,IAAI,OAAO,EAAE,CAAC;oBACZ,OAAO,EAAE,GAAG,KAAK,EAAE,MAAM,EAAE,CAAC;gBAC9B,CAAC;YACH,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAEO,KAAK,CAAC,YAAY,CACxB,KAA2D,EAC3D,GAAoB,EACpB,GAAmB;QAEnB,sBAAsB;QACtB,MAAM,IAAI,CAAC,kBAAkB,CAAC,KAAK,CAAC,WAAW,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;QAE3D,4BAA4B;QAC5B,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,kBAAkB,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;QAE5D,kBAAkB;QAClB,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,GAAG,IAAI,CAAC,CAAC;QAEnE,qCAAqC;QACrC,MAAM,cAAc,GAAuB,OAAO,CAAC,WAAW,CAAC,YAAY,EAAE,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC;QAC3H,IAAI,WAAW,GAAG,MAAM,CAAC;QAEzB,IAAI,cAAc,CAAC,QAAQ,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACpD,WAAW,GAAG,8BAAiB,CAAC,gBAAgB,CAAC,MAAM,EAAE,cAAc,CAAC,QAAQ,CAAC,CAAC;QACpF,CAAC;QAED,oCAAoC;QACpC,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC;YACrB,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAC,CAAC;YAC3D,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC,CAAC;QACvC,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,kBAAkB,CAAC,WAAyB,EAAE,GAAoB,EAAE,GAAmB;QACnG,IAAI,KAAK,GAAG,CAAC,CAAC;QAEd,MAAM,IAAI,GAAG,KAAK,IAAmB,EAAE;YACrC,IAAI,KAAK,GAAG,WAAW,CAAC,MAAM,EAAE,CAAC;gBAC/B,MAAM,UAAU,GAAG,WAAW,CAAC,KAAK,EAAE,CAAC,CAAC;gBACxC,MAAM,UAAU,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;YACnC,CAAC;QACH,CAAC,CAAC;QAEF,MAAM,IAAI,EAAE,CAAC;IACf,CAAC;IAEO,KAAK,CAAC,kBAAkB,CAC9B,KAA2D,EAC3D,GAAoB,EACpB,GAAmB;QAEnB,MAAM,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC,mBAAmB,EAAE,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC;QAC1G,MAAM,cAAc,GAAuB,OAAO,CAAC,WAAW,CAAC,YAAY,EAAE,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC;QAC3H,MAAM,IAAI,GAAU,EAAE,CAAC;QAEvB,kCAAkC;QAClC,IAAI,IAAI,GAAQ,IAAI,CAAC;QACrB,IAAI,KAAK,GAAQ,IAAI,CAAC;QACtB,IAAI,MAAM,GAAQ,KAAK,CAAC,MAAM,CAAC;QAE/B,mCAAmC;QACnC,IAAI,cAAc,CAAC,MAAM,EAAE,CAAC;YAC1B,MAAM,GAAG,8BAAiB,CAAC,cAAc,CAAC,KAAK,CAAC,MAAM,EAAE,cAAc,CAAC,MAAM,CAAC,CAAC;QACjF,CAAC;QAED,qCAAqC;QACrC,IAAI,cAAc,CAAC,KAAK,EAAE,CAAC;YACzB,MAAM,QAAQ,GAAG,IAAA,kBAAU,EAAC,GAAG,CAAC,CAAC;YACjC,KAAK,GAAG,8BAAiB,CAAC,aAAa,CAAC,QAAQ,EAAE,cAAc,CAAC,KAAK,CAAC,CAAC;QAC1E,CAAC;aAAM,CAAC;YACN,KAAK,GAAG,IAAA,kBAAU,EAAC,GAAG,CAAC,CAAC;QAC1B,CAAC;QAED,oCAAoC;QACpC,IAAI,cAAc,CAAC,IAAI,EAAE,CAAC;YACxB,MAAM,OAAO,GAAG,MAAM,IAAA,iBAAS,EAAC,GAAG,CAAC,CAAC;YACrC,IAAI,GAAG,8BAAiB,CAAC,YAAY,CAAC,OAAO,EAAE,cAAc,CAAC,IAAI,CAAC,CAAC;QACtE,CAAC;QAED,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,UAAU,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAC3C,MAAM,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC,SAAS,CAAC,EAAE,EAAE,KAAK,CAAC,UAAU,CAAC,WAAW,CAAC,SAAS,EAAE,KAAK,CAAC,cAAc,CAAC,CAAC;YAElH,IAAI,SAAS,EAAE,CAAC;gBACd,QAAQ,SAAS,CAAC,IAAI,EAAE,CAAC;oBACvB,KAAK,SAAS;wBACZ,IAAI,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC;wBACd,MAAM;oBACR,KAAK,UAAU;wBACb,IAAI,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC;wBACd,MAAM;oBACR,KAAK,MAAM;wBACT,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,MAAM,IAAA,iBAAS,EAAC,GAAG,CAAC,CAAC;wBACvC,MAAM;oBACR,KAAK,OAAO;wBACV,IAAI,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;wBACjC,MAAM;oBACR,KAAK,OAAO;wBACV,IAAI,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;wBACzD,MAAM;oBACR;wBACE,IAAI,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC;gBACxB,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC;YACtB,CAAC;QACH,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;CACF;AApTD,wBAoTC"}
+{"version":3,"file":"router.js","sourceRoot":"","sources":["../../src/core/router.ts"],"names":[],"mappings":"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"}

package/dist/events/bootstrap.d.ts

@@ -0,0 +1,8 @@
+import { Constructor } from '../core/di-container';
+/**
+ * Scans all registered DI components for EventListeners and subscribes
+ * their handlers to the EventBus. Should be called once at application startup.
+ * @param components An array of all registered service/controller constructors.
+ */
+export declare function bootstrapEventSystem(components: Constructor[]): void;
+//# sourceMappingURL=bootstrap.d.ts.map

package/dist/events/bootstrap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../../src/events/bootstrap.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAK7D;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,WAAW,EAAE,QAgC7D"}

package/dist/events/bootstrap.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.bootstrapEventSystem = bootstrapEventSystem;
+const di_container_1 = require("../core/di-container");
+const event_bus_service_1 = require("./event-bus.service");
+const decorators_1 = require("./decorators");
+/**
+ * Scans all registered DI components for EventListeners and subscribes
+ * their handlers to the EventBus. Should be called once at application startup.
+ * @param components An array of all registered service/controller constructors.
+ */
+function bootstrapEventSystem(components) {
+    console.log('🔄 Bootstrapping Event System...');
+    const eventBus = di_container_1.container.resolve(event_bus_service_1.EventBusService);
+    for (const component of components) {
+        const isListener = Reflect.getMetadata(decorators_1.EVENTS_METADATA_KEYS.eventListener, component);
+        if (!isListener) {
+            continue;
+        }
+        const handlers = Reflect.getMetadata(decorators_1.EVENTS_METADATA_KEYS.onEvent, component) || [];
+        if (handlers.length === 0) {
+            continue;
+        }
+        // Get the singleton instance of the listener class from the DI container
+        const listenerInstance = di_container_1.container.resolve(component);
+        console.log(`  - Found listener: ${component.name}`);
+        for (const handlerInfo of handlers) {
+            const handler = {
+                handle: listenerInstance[handlerInfo.methodName].bind(listenerInstance),
+            };
+            eventBus.subscribe(handlerInfo.eventType, handler);
+            console.log(`    ✓ Registered handler for '${handlerInfo.eventType}' -> ${handlerInfo.methodName}()`);
+        }
+    }
+    console.log('✅ Event System bootstrapped successfully!\n');
+}
+//# sourceMappingURL=bootstrap.js.map

package/dist/events/bootstrap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap.js","sourceRoot":"","sources":["../../src/events/bootstrap.ts"],"names":[],"mappings":";;AAUA,oDAgCC;AA1CD,uDAA6D;AAC7D,2DAAqD;AACrD,6CAAmD;AAGnD;;;;GAIG;AACH,SAAgB,oBAAoB,CAAC,UAAyB;IAC5D,OAAO,CAAC,GAAG,CAAC,kCAAkC,CAAC,CAAA;IAC/C,MAAM,QAAQ,GAAG,wBAAS,CAAC,OAAO,CAAkB,mCAAe,CAAQ,CAAA;IAE3E,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,MAAM,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC,iCAAoB,CAAC,aAAa,EAAE,SAAS,CAAC,CAAA;QACrF,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,SAAQ;QACV,CAAC;QAED,MAAM,QAAQ,GAAG,OAAO,CAAC,WAAW,CAAC,iCAAoB,CAAC,OAAO,EAAE,SAAS,CAAC,IAAI,EAAE,CAAA;QACnF,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1B,SAAQ;QACV,CAAC;QAED,yEAAyE;QACzE,MAAM,gBAAgB,GAAG,wBAAS,CAAC,OAAO,CAAC,SAAS,CAAQ,CAAA;QAE5D,OAAO,CAAC,GAAG,CAAC,uBAAuB,SAAS,CAAC,IAAI,EAAE,CAAC,CAAA;QAEpD,KAAK,MAAM,WAAW,IAAI,QAAQ,EAAE,CAAC;YACnC,MAAM,OAAO,GAAkB;gBAC7B,MAAM,EAAE,gBAAgB,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC;aACvD,CAAA;YAElB,QAAQ,CAAC,SAAS,CAAC,WAAW,CAAC,SAAS,EAAE,OAAO,CAAC,CAAA;YAClD,OAAO,CAAC,GAAG,CACT,iCAAiC,WAAW,CAAC,SAAS,QAAQ,WAAW,CAAC,UAAU,IAAI,CACzF,CAAA;QACH,CAAC;IACH,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,6CAA6C,CAAC,CAAA;AAC5D,CAAC"}

package/dist/events/decorators.d.ts

@@ -0,0 +1,16 @@
+import 'reflect-metadata';
+export declare const EVENTS_METADATA_KEYS: {
+    eventListener: string;
+    onEvent: string;
+};
+/**
+ * A class decorator that marks a class as a container for event listeners.
+ * The framework will automatically scan these classes for handlers.
+ */
+export declare const EventListener: () => ClassDecorator;
+/**
+ * A method decorator that registers the method as a handler for a specific event type.
+ * @param eventType The unique string identifier for the event.
+ */
+export declare const OnEvent: (eventType: string) => MethodDecorator;
+//# sourceMappingURL=decorators.d.ts.map

package/dist/events/decorators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decorators.d.ts","sourceRoot":"","sources":["../../src/events/decorators.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAA;AAGzB,eAAO,MAAM,oBAAoB;;;CAGhC,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,aAAa,QAAO,cAMhC,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,OAAO,GAAI,WAAW,MAAM,KAAG,eAS3C,CAAA"}

package/dist/events/decorators.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OnEvent = exports.EventListener = exports.EVENTS_METADATA_KEYS = void 0;
+require("reflect-metadata");
+const decorators_1 = require("../core/decorators");
+exports.EVENTS_METADATA_KEYS = {
+    eventListener: 'bootify:event-listener',
+    onEvent: 'bootify:on-event',
+};
+/**
+ * A class decorator that marks a class as a container for event listeners.
+ * The framework will automatically scan these classes for handlers.
+ */
+const EventListener = () => {
+    return (target) => {
+        Reflect.defineMetadata(exports.EVENTS_METADATA_KEYS.eventListener, true, target);
+        // Call the base Component decorator's logic
+        (0, decorators_1.Component)()(target);
+    };
+};
+exports.EventListener = EventListener;
+/**
+ * A method decorator that registers the method as a handler for a specific event type.
+ * @param eventType The unique string identifier for the event.
+ */
+const OnEvent = (eventType) => {
+    return (target, propertyKey) => {
+        const handlers = Reflect.getMetadata(exports.EVENTS_METADATA_KEYS.onEvent, target.constructor) || [];
+        handlers.push({
+            eventType,
+            methodName: propertyKey,
+        });
+        Reflect.defineMetadata(exports.EVENTS_METADATA_KEYS.onEvent, handlers, target.constructor);
+    };
+};
+exports.OnEvent = OnEvent;
+//# sourceMappingURL=decorators.js.map

package/dist/events/decorators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decorators.js","sourceRoot":"","sources":["../../src/events/decorators.ts"],"names":[],"mappings":";;;AAAA,4BAAyB;AACzB,mDAA8C;AAEjC,QAAA,oBAAoB,GAAG;IAClC,aAAa,EAAE,wBAAwB;IACvC,OAAO,EAAE,kBAAkB;CAC5B,CAAA;AAED;;;GAGG;AACI,MAAM,aAAa,GAAG,GAAmB,EAAE;IAChD,OAAO,CAAC,MAAW,EAAE,EAAE;QACrB,OAAO,CAAC,cAAc,CAAC,4BAAoB,CAAC,aAAa,EAAE,IAAI,EAAE,MAAM,CAAC,CAAA;QACxE,4CAA4C;QAC5C,IAAA,sBAAS,GAAE,CAAC,MAAM,CAAC,CAAA;IACrB,CAAC,CAAA;AACH,CAAC,CAAA;AANY,QAAA,aAAa,iBAMzB;AAED;;;GAGG;AACI,MAAM,OAAO,GAAG,CAAC,SAAiB,EAAmB,EAAE;IAC5D,OAAO,CAAC,MAAW,EAAE,WAA4B,EAAE,EAAE;QACnD,MAAM,QAAQ,GAAG,OAAO,CAAC,WAAW,CAAC,4BAAoB,CAAC,OAAO,EAAE,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,CAAA;QAC5F,QAAQ,CAAC,IAAI,CAAC;YACZ,SAAS;YACT,UAAU,EAAE,WAAW;SACxB,CAAC,CAAA;QACF,OAAO,CAAC,cAAc,CAAC,4BAAoB,CAAC,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,WAAW,CAAC,CAAA;IACpF,CAAC,CAAA;AACH,CAAC,CAAA;AATY,QAAA,OAAO,WASnB"}

package/dist/events/event-bus.service.d.ts

@@ -0,0 +1,21 @@
+import { IEvent, IEventHandler } from './event.types';
+export declare class EventBusService {
+    private readonly emitter;
+    private readonly deadLetterQueue;
+    private readonly options;
+    constructor();
+    /**
+     * Subscribes an event handler to a specific event type.
+     * This is used internally by the framework during bootstrap.
+     */
+    subscribe<T extends IEvent>(eventType: string, handler: IEventHandler<T>): void;
+    /**
+     * Emits an event to all registered listeners.
+     */
+    emit(event: IEvent): void;
+    /**
+     * Retrieves all events that have failed all retry attempts.
+     */
+    getDeadLetterQueue(): IEvent[];
+}
+//# sourceMappingURL=event-bus.service.d.ts.map

package/dist/events/event-bus.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-bus.service.d.ts","sourceRoot":"","sources":["../../src/events/event-bus.service.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAQrD,qBACa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;IAC7C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAe;IAC/C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA2B;;IAYnD;;;OAGG;IACH,SAAS,CAAC,CAAC,SAAS,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,IAAI;IA4B/E;;OAEG;IACH,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IASzB;;OAEG;IACH,kBAAkB,IAAI,MAAM,EAAE;CAG/B"}

package/dist/events/event-bus.service.js

@@ -0,0 +1,78 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EventBusService = void 0;
+const events_1 = require("events");
+const decorators_1 = require("../core/decorators");
+const request_context_service_1 = require("../core/request-context.service");
+let EventBusService = class EventBusService {
+    constructor() {
+        this.emitter = new events_1.EventEmitter();
+        this.deadLetterQueue = [];
+        // Default options can be extended via a ConfigService
+        this.options = {
+            maxRetries: 3,
+            retryDelayMs: 500,
+        };
+        // Increase max listeners to avoid warnings for many handlers
+        this.emitter.setMaxListeners(50);
+    }
+    /**
+     * Subscribes an event handler to a specific event type.
+     * This is used internally by the framework during bootstrap.
+     */
+    subscribe(eventType, handler) {
+        this.emitter.on(eventType, async (event) => {
+            let attempt = 0;
+            while (attempt < this.options.maxRetries) {
+                try {
+                    console.log(`[EventBus] Attempt ${attempt + 1}: Handling event '${event.type}'`);
+                    await handler.handle(event);
+                    return; // Success, exit loop
+                }
+                catch (error) {
+                    attempt++;
+                    console.error(`[EventBus] Error handling event '${event.type}' (Attempt ${attempt})`, error);
+                    if (attempt >= this.options.maxRetries) {
+                        console.error(`[EventBus] Event '${event.type}' failed after ${this.options.maxRetries} attempts. Moving to DLQ.`);
+                        this.deadLetterQueue.push(event);
+                    }
+                    else {
+                        // Wait before retrying
+                        await new Promise((res) => setTimeout(res, this.options.retryDelayMs * attempt));
+                    }
+                }
+            }
+        });
+    }
+    /**
+     * Emits an event to all registered listeners.
+     */
+    emit(event) {
+        // Enrich event with correlationId from the current request context
+        const contextService = new request_context_service_1.RequestContextService();
+        event.correlationId = contextService.get('requestId');
+        console.log(`[EventBus] Emitting event '${event.type}'`, { correlationId: event.correlationId });
+        this.emitter.emit(event.type, event);
+    }
+    /**
+     * Retrieves all events that have failed all retry attempts.
+     */
+    getDeadLetterQueue() {
+        return [...this.deadLetterQueue];
+    }
+};
+exports.EventBusService = EventBusService;
+exports.EventBusService = EventBusService = __decorate([
+    (0, decorators_1.Service)(),
+    __metadata("design:paramtypes", [])
+], EventBusService);
+//# sourceMappingURL=event-bus.service.js.map

package/dist/events/event-bus.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-bus.service.js","sourceRoot":"","sources":["../../src/events/event-bus.service.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,mCAAqC;AACrC,mDAAuD;AAEvD,6EAAuE;AAQhE,IAAM,eAAe,GAArB,MAAM,eAAe;IAK1B;QAJiB,YAAO,GAAG,IAAI,qBAAY,EAAE,CAAA;QAC5B,oBAAe,GAAa,EAAE,CAAA;QAI7C,sDAAsD;QACtD,IAAI,CAAC,OAAO,GAAG;YACb,UAAU,EAAE,CAAC;YACb,YAAY,EAAE,GAAG;SAClB,CAAA;QACD,6DAA6D;QAC7D,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,EAAE,CAAC,CAAA;IAClC,CAAC;IAED;;;OAGG;IACH,SAAS,CAAmB,SAAiB,EAAE,OAAyB;QACtE,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,KAAK,EAAE,KAAQ,EAAE,EAAE;YAC5C,IAAI,OAAO,GAAG,CAAC,CAAA;YACf,OAAO,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;gBACzC,IAAI,CAAC;oBACH,OAAO,CAAC,GAAG,CAAC,sBAAsB,OAAO,GAAG,CAAC,qBAAqB,KAAK,CAAC,IAAI,GAAG,CAAC,CAAA;oBAChF,MAAM,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;oBAC3B,OAAM,CAAC,qBAAqB;gBAC9B,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,OAAO,EAAE,CAAA;oBACT,OAAO,CAAC,KAAK,CACX,oCAAoC,KAAK,CAAC,IAAI,cAAc,OAAO,GAAG,EACtE,KAAK,CACN,CAAA;oBACD,IAAI,OAAO,IAAI,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;wBACvC,OAAO,CAAC,KAAK,CACX,qBAAqB,KAAK,CAAC,IAAI,kBAAkB,IAAI,CAAC,OAAO,CAAC,UAAU,2BAA2B,CACpG,CAAA;wBACD,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;oBAClC,CAAC;yBAAM,CAAC;wBACN,uBAAuB;wBACvB,MAAM,IAAI,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,OAAO,CAAC,YAAY,GAAG,OAAO,CAAC,CAAC,CAAA;oBAClF,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC,CAAC,CAAA;IACJ,CAAC;IAED;;OAEG;IACH,IAAI,CAAC,KAAa;QAChB,mEAAmE;QACnE,MAAM,cAAc,GAAG,IAAI,+CAAqB,EAAE,CAAA;QAClD,KAAK,CAAC,aAAa,GAAG,cAAc,CAAC,GAAG,CAAS,WAAW,CAAC,CAAA;QAE7D,OAAO,CAAC,GAAG,CAAC,8BAA8B,KAAK,CAAC,IAAI,GAAG,EAAE,EAAE,aAAa,EAAE,KAAK,CAAC,aAAa,EAAE,CAAC,CAAA;QAChG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;IACtC,CAAC;IAED;;OAEG;IACH,kBAAkB;QAChB,OAAO,CAAC,GAAG,IAAI,CAAC,eAAe,CAAC,CAAA;IAClC,CAAC;CACF,CAAA;AAjEY,0CAAe;0BAAf,eAAe;IAD3B,IAAA,oBAAO,GAAE;;GACG,eAAe,CAiE3B"}

package/dist/events/event.types.d.ts

@@ -0,0 +1,17 @@
+/**
+ * The base interface for all events.
+ * It ensures that every event has a unique type identifier.
+ */
+export interface IEvent {
+    readonly type: string;
+    payload: any;
+    correlationId?: string;
+}
+/**
+ * Defines the shape of an event handler. It's a class with
+ * a 'handle' method for a specific event type.
+ */
+export interface IEventHandler<T extends IEvent = IEvent> {
+    handle(event: T): Promise<void> | void;
+}
+//# sourceMappingURL=event.types.d.ts.map

package/dist/events/event.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event.types.d.ts","sourceRoot":"","sources":["../../src/events/event.types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,MAAM;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,OAAO,EAAE,GAAG,CAAA;IACZ,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM;IACtD,MAAM,CAAC,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;CACvC"}

package/dist/events/event.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event.types.js","sourceRoot":"","sources":["../../src/events/event.types.ts"],"names":[],"mappings":""}