@hemia/core 0.0.6 → 0.0.7

package/dist/hemia-core.esm.js

@@ -312,14 +312,13 @@ Reflector = __decorate([
     injectable()
 ], Reflector);
 
-class HemiaFactory {
+class AppFactory {
     /**
      * Inicializa la aplicación Hemia conectando Express con Inversify.
      * @param container El contenedor de Inversify con tus servicios ya bindeados.
-     * @param controllers Lista de Clases de Controladores a registrar.
      * @param options Opciones de configuración.
      */
-    static async create(container, options = {}, controllers) {
+    static async create(container, options = {}, plugins = []) {
         const app = express();
         app.use(express.json(options.jsonOptions));
         app.use(express.urlencoded({ extended: true, ...options.urlencodedOptions }));
@@ -345,18 +344,27 @@ class HemiaFactory {
             }
             next();
         });
+        if (plugins && Array.isArray(plugins) && plugins.length > 0) {
+            for (const plugin of plugins) {
+                if (plugin && typeof plugin === 'function') {
+                    await plugin(container);
+                }
+            }
+        }
         if (!container.isBound(Reflector)) {
             container.bind(Reflector).toSelf().inSingletonScope();
         }
-        const controllerList = controllers && controllers.length > 0
-            ? controllers
-            : ControllerRegistry.getAll();
-        controllerList.forEach(controllerClass => {
+        const autoControllerList = ControllerRegistry.getAll();
+        const controllers = Array.from(new Set([
+            ...(options.controllers || []),
+            ...autoControllerList,
+        ]));
+        controllers.forEach(controllerClass => {
             if (!container.isBound(controllerClass)) {
                 container.bind(controllerClass).toSelf();
             }
         });
-        await registerRoutes(app, container, controllerList, options.onTraceFinish || (() => { }), options.multerOptions);
+        await registerRoutes(app, container, controllers, options.onTraceFinish || (() => { }), options.multerOptions);
         app.use((err, req, res, next) => {
             console.error('[Hemia] Unhandled error:', err);
             res.status(err.status || 500).json({
@@ -365,7 +373,7 @@ class HemiaFactory {
             });
         });
         if (options.logger !== false) {
-            console.log(`[Hemia] Application initialized with ${controllerList.length} controllers.`);
+            console.log(`[Hemia] Application initialized with ${controllers.length} controllers.`);
         }
         return app;
     }
@@ -478,4 +486,4 @@ JWTGuard = __decorate([
     __metadata("design:paramtypes", [AuthService])
 ], JWTGuard);
 
-export { ApiKeyGuard, AuthGuard, GuardsConsumer, HemiaExecutionContext, HemiaFactory, JWTGuard, Reflector, ResponseSerializer, registerRoutes };
+export { ApiKeyGuard, AppFactory, AuthGuard, GuardsConsumer, HemiaExecutionContext, JWTGuard, Reflector, ResponseSerializer, registerRoutes };

package/dist/hemia-core.js

@@ -314,14 +314,13 @@ exports.Reflector = __decorate([
     inversify.injectable()
 ], exports.Reflector);
 
-class HemiaFactory {
+class AppFactory {
     /**
      * Inicializa la aplicación Hemia conectando Express con Inversify.
      * @param container El contenedor de Inversify con tus servicios ya bindeados.
-     * @param controllers Lista de Clases de Controladores a registrar.
      * @param options Opciones de configuración.
      */
-    static async create(container, options = {}, controllers) {
+    static async create(container, options = {}, plugins = []) {
         const app = express();
         app.use(express.json(options.jsonOptions));
         app.use(express.urlencoded({ extended: true, ...options.urlencodedOptions }));
@@ -347,18 +346,27 @@ class HemiaFactory {
             }
             next();
         });
+        if (plugins && Array.isArray(plugins) && plugins.length > 0) {
+            for (const plugin of plugins) {
+                if (plugin && typeof plugin === 'function') {
+                    await plugin(container);
+                }
+            }
+        }
         if (!container.isBound(exports.Reflector)) {
             container.bind(exports.Reflector).toSelf().inSingletonScope();
         }
-        const controllerList = controllers && controllers.length > 0
-            ? controllers
-            : common.ControllerRegistry.getAll();
-        controllerList.forEach(controllerClass => {
+        const autoControllerList = common.ControllerRegistry.getAll();
+        const controllers = Array.from(new Set([
+            ...(options.controllers || []),
+            ...autoControllerList,
+        ]));
+        controllers.forEach(controllerClass => {
             if (!container.isBound(controllerClass)) {
                 container.bind(controllerClass).toSelf();
             }
         });
-        await registerRoutes(app, container, controllerList, options.onTraceFinish || (() => { }), options.multerOptions);
+        await registerRoutes(app, container, controllers, options.onTraceFinish || (() => { }), options.multerOptions);
         app.use((err, req, res, next) => {
             console.error('[Hemia] Unhandled error:', err);
             res.status(err.status || 500).json({
@@ -367,7 +375,7 @@ class HemiaFactory {
             });
         });
         if (options.logger !== false) {
-            console.log(`[Hemia] Application initialized with ${controllerList.length} controllers.`);
+            console.log(`[Hemia] Application initialized with ${controllers.length} controllers.`);
         }
         return app;
     }
@@ -480,8 +488,8 @@ exports.JWTGuard = __decorate([
     __metadata("design:paramtypes", [authSdk.AuthService])
 ], exports.JWTGuard);
 
+exports.AppFactory = AppFactory;
 exports.GuardsConsumer = GuardsConsumer;
 exports.HemiaExecutionContext = HemiaExecutionContext;
-exports.HemiaFactory = HemiaFactory;
 exports.ResponseSerializer = ResponseSerializer;
 exports.registerRoutes = registerRoutes;

package/dist/types/{hemia-factory.d.ts → app-factory.d.ts}

@@ -1,8 +1,8 @@
 import { Container } from "inversify";
 import { TraceFinishCallback } from "./router";
-import { Type } from "@hemia/common";
+import { Plugin, Type } from "@hemia/common";
 import { Express } from "express";
-export interface HemiaFactoryOptions {
+export interface AppFactoryOptions {
     onTraceFinish?: TraceFinishCallback;
     logger?: boolean;
     corsHeaders?: Record<string, string>;
@@ -10,13 +10,13 @@ export interface HemiaFactoryOptions {
     multerOptions?: any;
     jsonOptions?: any;
     urlencodedOptions?: any;
+    controllers?: Type<any>[];
 }
-export declare class HemiaFactory {
+export declare class AppFactory {
     /**
      * Inicializa la aplicación Hemia conectando Express con Inversify.
      * @param container El contenedor de Inversify con tus servicios ya bindeados.
-     * @param controllers Lista de Clases de Controladores a registrar.
      * @param options Opciones de configuración.
      */
-    static create(container: Container, options?: HemiaFactoryOptions, controllers?: Type<any>[]): Promise<Express>;
+    static create(container: Container, options?: AppFactoryOptions, plugins?: Plugin[]): Promise<Express>;
 }

package/dist/types/index.d.ts

@@ -1,7 +1,7 @@
 import 'reflect-metadata';
-export * from './hemia-factory';
+export * from './app-factory';
 export * from "./services";
 export * from "./context";
 export * from "./router";
 export * from "./guards";
-export * from "./hemia-factory";
+export * from "./app-factory";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hemia/core",
-  "version": "0.0.6",
+  "version": "0.0.7",
   "description": "Core utilities for Hemia projects",
   "main": "dist/hemia-core.js",
   "module": "dist/hemia-core.esm.js",
@@ -17,10 +17,10 @@
     "@rollup/plugin-commonjs": "^26.0.1",
     "@rollup/plugin-json": "^6.1.0",
     "@rollup/plugin-node-resolve": "^15.2.3",
-    "@hemia/common": "^0.0.8",
+    "@hemia/common": "^0.0.9",
     "@hemia/app-context": "^0.0.6",
     "@hemia/trace-manager": "^0.0.9",
-    "@hemia/auth-sdk": "^0.0.9",
+    "@hemia/auth-sdk": "^0.0.10",
     "@types/express": "^5.0.5",
     "express": "^5.1.0",
     "inversify": "^7.10.4",