@hemia/core 0.0.6 → 0.0.8

package/dist/hemia-core.esm.js

@@ -312,17 +312,23 @@ 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 }));
+        if (plugins && Array.isArray(plugins) && plugins.length > 0) {
+            for (const plugin of plugins) {
+                if (plugin && typeof plugin === 'function') {
+                    await plugin(container);
+                }
+            }
+        }
         if (options.middlewares && Array.isArray(options.middlewares)) {
             options.middlewares.forEach(middleware => {
                 app.use(middleware);
@@ -348,15 +354,27 @@ class HemiaFactory {
         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 validAutoControllers = autoControllerList.filter(controllerClass => {
+            if (container.isBound(controllerClass)) {
+                return true;
+            }
+            const isManual = Reflect.getMetadata(METADATA_KEYS.MANUAL_REGISTER, controllerClass);
+            if (isManual) {
+                return false;
+            }
+            return true;
+        });
+        const controllers = Array.from(new Set([
+            ...(options.controllers || []),
+            ...validAutoControllers,
+        ]));
+        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 +383,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 +496,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,17 +314,23 @@ 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 }));
+        if (plugins && Array.isArray(plugins) && plugins.length > 0) {
+            for (const plugin of plugins) {
+                if (plugin && typeof plugin === 'function') {
+                    await plugin(container);
+                }
+            }
+        }
         if (options.middlewares && Array.isArray(options.middlewares)) {
             options.middlewares.forEach(middleware => {
                 app.use(middleware);
@@ -350,15 +356,27 @@ class HemiaFactory {
         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 validAutoControllers = autoControllerList.filter(controllerClass => {
+            if (container.isBound(controllerClass)) {
+                return true;
+            }
+            const isManual = Reflect.getMetadata(common.METADATA_KEYS.MANUAL_REGISTER, controllerClass);
+            if (isManual) {
+                return false;
+            }
+            return true;
+        });
+        const controllers = Array.from(new Set([
+            ...(options.controllers || []),
+            ...validAutoControllers,
+        ]));
+        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 +385,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 +498,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.8",
   "description": "Core utilities for Hemia projects",
   "main": "dist/hemia-core.js",
   "module": "dist/hemia-core.esm.js",
@@ -11,16 +11,17 @@
     "build": "npm run clean && npm run tscBuild",
     "test": "jest --detectOpenHandles",
     "test:coverage": "jest --coverage",
-    "test:watch": "jest --watch"
+    "test:watch": "jest --watch",
+    "prepublish": "npm run build"
   },
   "devDependencies": {
     "@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.12",
     "@hemia/app-context": "^0.0.6",
     "@hemia/trace-manager": "^0.0.9",
-    "@hemia/auth-sdk": "^0.0.9",
+    "@hemia/auth-sdk": "^0.0.11",
     "@types/express": "^5.0.5",
     "express": "^5.1.0",
     "inversify": "^7.10.4",