@zanobijs/core 1.1.1-beta.0 → 1.2.0-beta.1

package/CHANGELOG.md

@@ -3,6 +3,20 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.2.0-beta.1](https://github.com/devdroide/ZanobiJS/compare/v1.2.0-beta.0...v1.2.0-beta.1) (2025-06-05)
+
+### Bug Fixes
+
+- **core,test:** Change in provider scanning and dependency search ([cd0858b](https://github.com/devdroide/ZanobiJS/commit/cd0858b1437c4470003f574baa34bc7a4f3db817))
+
+# [1.2.0-beta.0](https://github.com/devdroide/ZanobiJS/compare/v1.1.1-beta.0...v1.2.0-beta.0) (2025-05-28)
+
+### Features
+
+- **core,test:** Added the ability to use useClass and useFactory as providers ([bff63e2](https://github.com/devdroide/ZanobiJS/commit/bff63e2d73fa03ef72f38b3c7c6f5a51ad9ddf80))
+- **core,test:** Added type validation to prevent errors in providers with useClass ([6e64d3b](https://github.com/devdroide/ZanobiJS/commit/6e64d3b6a46965ad9affa697980b6862b1ae8be0))
+- **core:** ✨ new provider with useClass ([668d981](https://github.com/devdroide/ZanobiJS/commit/668d981890e2a43f615ae8f78f025e3c33db9707))
+
 ## [1.1.1-beta.0](https://github.com/devdroide/ZanobiJS/compare/v1.1.0...v1.1.1-beta.0) (2025-05-27)
 
 **Note:** Version bump only for package @zanobijs/core

package/exceptions/constant.message.d.ts

@@ -1,3 +1,4 @@
 export declare const MODULE_INVALID_ANNOTATION_ERROR: () => string;
 export declare const CONTAINER_RESOLUTION_ERROR: (entity: string, resolutionError: string) => string;
 export declare const CONTAINER_RESOLUTION_ENTITY_ERROR: (entity: string) => string;
+export declare const PROVIDER_INVALID_MODULE_ERROR: (entity: string, moduleName: string) => string;

package/exceptions/constant.message.js

@@ -1,9 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CONTAINER_RESOLUTION_ENTITY_ERROR = exports.CONTAINER_RESOLUTION_ERROR = exports.MODULE_INVALID_ANNOTATION_ERROR = void 0;
+exports.PROVIDER_INVALID_MODULE_ERROR = exports.CONTAINER_RESOLUTION_ENTITY_ERROR = exports.CONTAINER_RESOLUTION_ERROR = exports.MODULE_INVALID_ANNOTATION_ERROR = void 0;
 const MODULE_INVALID_ANNOTATION_ERROR = () => 'The class must have an annotation @Module()';
 exports.MODULE_INVALID_ANNOTATION_ERROR = MODULE_INVALID_ANNOTATION_ERROR;
 const CONTAINER_RESOLUTION_ERROR = (entity, resolutionError) => `${resolutionError} please review '${entity}' and its dependencies.`;
 exports.CONTAINER_RESOLUTION_ERROR = CONTAINER_RESOLUTION_ERROR;
 const CONTAINER_RESOLUTION_ENTITY_ERROR = (entity) => `Please check that the entity '${entity}' exists and is registered in @modulo`;
 exports.CONTAINER_RESOLUTION_ENTITY_ERROR = CONTAINER_RESOLUTION_ENTITY_ERROR;
+const PROVIDER_INVALID_MODULE_ERROR = (entity, moduleName) => `Please check that ${entity} located in the @module ${moduleName} exists and is @Injectable().`;
+exports.PROVIDER_INVALID_MODULE_ERROR = PROVIDER_INVALID_MODULE_ERROR;

package/exceptions/invalidProvider.module.exception.d.ts

@@ -0,0 +1,12 @@
+import { RuntimeException } from '@zanobijs/common/exceptions/runtime.exception';
+/**
+ * Excepción lanzada cuando una clase Modulo no tiene un provedor definido correctamente
+ * de @zanobijs/common
+ *
+ * @remarks
+ * Esta clase extiende la base `RuntimeException`de @zanobijs/common
+ * para proporcionar detalles adicionales específicos a esquemas de módulos inválidos.
+ */
+export declare class InvalidProviderModuleException extends RuntimeException {
+    constructor(entity: string, moduleName: string, detail: string);
+}

package/exceptions/invalidProvider.module.exception.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InvalidProviderModuleException = void 0;
+const runtime_exception_1 = require("@zanobijs/common/exceptions/runtime.exception");
+const constant_message_1 = require("./constant.message");
+/**
+ * Excepción lanzada cuando una clase Modulo no tiene un provedor definido correctamente
+ * de @zanobijs/common
+ *
+ * @remarks
+ * Esta clase extiende la base `RuntimeException`de @zanobijs/common
+ * para proporcionar detalles adicionales específicos a esquemas de módulos inválidos.
+ */
+class InvalidProviderModuleException extends runtime_exception_1.RuntimeException {
+    constructor(entity, moduleName, detail) {
+        super((0, constant_message_1.PROVIDER_INVALID_MODULE_ERROR)(entity, moduleName), detail);
+    }
+}
+exports.InvalidProviderModuleException = InvalidProviderModuleException;

package/factory.d.ts

@@ -14,12 +14,14 @@ export declare class Factory {
     private logger;
     private options;
     constructor(appModule: TClass, options?: IFactoryOptions);
+    private scanProviderModule;
+    private registerProviderScanedModules;
     /**
      * Registra clases desde un módulo específico.
      * @param {TClass} module - Módulo desde el que se registrarán las clases.
      * @private
      */
-    private processModule;
+    private processClassModule;
     /**
      * Crea el contenedor de inyección de dependencias y registra las clases.
      * @returns {Factory} - Instancia actual de la fábrica.

package/factory.js

@@ -25,24 +25,40 @@ class Factory {
         this.evaluateOptions();
         this.logger = (0, utils_1.Logger)();
         this.moduleHandler = new module_1.Module();
-        this.processModule(appModule);
+        this.scanProviderModule(appModule);
+        this.registerProviderScanedModules();
+        this.processClassModule(appModule);
+    }
+    scanProviderModule(module) {
+        this.logger.debug('Factory - Scan Module:', module.name);
+        this.moduleHandler.setup(module);
+        this.moduleHandler.scan();
+        this.logger.debug('===================================================');
+        const importedModules = this.moduleHandler.getImports();
+        if (importedModules && importedModules.length) {
+            importedModules.forEach((moduleImport) => {
+                this.scanProviderModule(moduleImport);
+            });
+        }
+    }
+    registerProviderScanedModules() {
+        this.moduleHandler.registerAllProviders();
     }
     /**
      * Registra clases desde un módulo específico.
      * @param {TClass} module - Módulo desde el que se registrarán las clases.
      * @private
      */
-    processModule(module) {
-        this.logger.debug('Factory - Process - Create module setup:', module.name);
+    processClassModule(module) {
+        this.logger.debug('Factory - Process Class Module:', module.name);
         this.moduleHandler.setup(module);
-        this.logger.debug('Factory - Process - Module initialize:', module.name);
         this.moduleHandler.initialize();
         Object.assign(this.registeredClasses, this.moduleHandler.getRegisterClass());
-        this.logger.success('Factory - Process - Completion of module ', module.name);
+        this.logger.success('Factory - Process Class Module - Completion!!!', module.name);
         const importedModules = this.moduleHandler.getImports();
         if (importedModules && importedModules.length) {
             importedModules.forEach((moduleImport) => {
-                this.processModule(moduleImport);
+                this.processClassModule(moduleImport);
             });
         }
         this.logger.debug('===================================================');

package/injector/injector.d.ts

@@ -8,7 +8,8 @@ export type Constructor<T> = {
  */
 export declare class Injector {
     private module;
-    private listProviders;
+    private readonly listProviders;
+    private readonly listProvidersClass;
     private metadata;
     private logger;
     private moduleName;
@@ -18,17 +19,17 @@ export declare class Injector {
      * @param {Module} module - El módulo debe tener el decorador `@Module`
      * para poderlo procesar.
      */
-    constructor(module: TClass, listProviders: Map<string, any>);
+    constructor(module: TClass, listProviders: Map<string, any>, listProvidersClass: Map<string, any>);
     /**
      * Este método privado recorre el array de los servicios del modulo para
      * buscar los proveedores tipo objeto a injectar y los almacena en una
      * lista de proveedores.
      * @private
      */
-    private scanProviders;
+    scanProviders(): void;
     /**
-     * Método para obtener un objeto con los parámetros(key) y valores(useValue)
-     * que se inyectarán en la clase (target) mediante asClass().inject().
+     * Método para obtener un objeto con los parámetros(key) y valores(useValue, useClass, useFactory)
+     * que se inyectarán en la clase (target).
      *
      * @param { TClass} target - La clase objetivo.
      * @returns {object} - Objeto con datos a inyectar.
@@ -44,27 +45,25 @@ export declare class Injector {
      * @param {any} target - La clase objetivo.
      * @returns - El injector configurado.
      */
-    getInjectorClass(target: any): {
-        interface: any;
+    getInjectorClass(target: TClass): {
+        interface: TClass;
         injectionMode?: import("awilix").InjectionModeType;
         injector?: import("awilix").InjectorFunction;
-        setLifetime(lifetime: import("awilix").LifetimeType): import("awilix").BuildResolver<object> & import("awilix").DisposableResolver<object>;
-        setInjectionMode(mode: import("awilix").InjectionModeType): import("awilix").BuildResolver<object> & import("awilix").DisposableResolver<object>;
-        singleton(): import("awilix").BuildResolver<object> & import("awilix").DisposableResolver<object>;
-        scoped(): import("awilix").BuildResolver<object> & import("awilix").DisposableResolver<object>;
-        transient(): import("awilix").BuildResolver<object> & import("awilix").DisposableResolver<object>;
-        proxy(): import("awilix").BuildResolver<object> & import("awilix").DisposableResolver<object>;
-        classic(): import("awilix").BuildResolver<object> & import("awilix").DisposableResolver<object>;
-        inject(injector: import("awilix").InjectorFunction): import("awilix").BuildResolver<object> & import("awilix").DisposableResolver<object>;
-        resolve<U extends object>(container: import("awilix").AwilixContainer<U>): object;
+        setLifetime(lifetime: import("awilix").LifetimeType): import("awilix").BuildResolver<any> & import("awilix").DisposableResolver<any>;
+        setInjectionMode(mode: import("awilix").InjectionModeType): import("awilix").BuildResolver<any> & import("awilix").DisposableResolver<any>;
+        singleton(): import("awilix").BuildResolver<any> & import("awilix").DisposableResolver<any>;
+        scoped(): import("awilix").BuildResolver<any> & import("awilix").DisposableResolver<any>;
+        transient(): import("awilix").BuildResolver<any> & import("awilix").DisposableResolver<any>;
+        proxy(): import("awilix").BuildResolver<any> & import("awilix").DisposableResolver<any>;
+        classic(): import("awilix").BuildResolver<any> & import("awilix").DisposableResolver<any>;
+        inject(injector: import("awilix").InjectorFunction): import("awilix").BuildResolver<any> & import("awilix").DisposableResolver<any>;
+        resolve<U extends object>(container: import("awilix").AwilixContainer<U>): any;
         name?: string;
         lifetime?: import("awilix").LifetimeType;
-        register?: (...args: any[]) => import("awilix").Resolver<object>;
+        register?: (...args: any[]) => import("awilix").Resolver<any>;
         isLeakSafe?: boolean;
-        dispose?: import("awilix").Disposer<object>;
-        disposer(dispose: import("awilix").Disposer<object>): import("awilix").BuildResolver<object> & import("awilix").DisposableResolver<object>;
+        dispose?: import("awilix").Disposer<any>;
+        disposer(dispose: import("awilix").Disposer<any>): import("awilix").BuildResolver<any> & import("awilix").DisposableResolver<any>;
     };
     getAllProvider(): Map<string, any>;
-    getInjectProvider(provider: any): import("awilix").Resolver<any>;
-    funtionInjectData(injectData: any): () => any;
 }

package/injector/injector.js

@@ -12,6 +12,7 @@ const awilix_1 = require("awilix");
 class Injector {
     module;
     listProviders;
+    listProvidersClass;
     metadata;
     logger;
     moduleName = '';
@@ -21,13 +22,13 @@ class Injector {
      * @param {Module} module - El módulo debe tener el decorador `@Module`
      * para poderlo procesar.
      */
-    constructor(module, listProviders) {
+    constructor(module, listProviders, listProvidersClass) {
         this.metadata = metadata_1.Metadata.getInstance();
         this.logger = (0, utils_1.Logger)();
         this.moduleName = module.name;
         this.module = module;
         this.listProviders = listProviders;
-        this.scanProviders();
+        this.listProvidersClass = listProvidersClass;
     }
     /**
      * Este método privado recorre el array de los servicios del modulo para
@@ -39,14 +40,42 @@ class Injector {
         this.logger.debug('Injector - Scan provider to module:', this.moduleName);
         const { services } = this.metadata.getMetadataModule(this.module);
         services.forEach((service) => {
-            if (typeof service === 'object')
-                this.listProviders.set(service.provider, service.useValue);
+            if (typeof service === 'object' && typeof service.provider === 'string') {
+                const key = service.provider;
+                if (service.useClass) {
+                    this.listProvidersClass.set(key, service.useClass);
+                }
+                else if (service.useFactory) {
+                    this.listProviders.set(key, (0, awilix_1.asFunction)(service.useFactory).scoped());
+                }
+                else {
+                    this.listProviders.set(key, (0, awilix_1.asValue)(service.useValue));
+                }
+            }
+            if (typeof service === 'object' && (0, shared_utils_1.isClass)(service.provider)) {
+                let useExample = false;
+                const key = service.provider.name;
+                if (service.useClass && (0, shared_utils_1.isClass)(service.useClass)) {
+                    this.listProvidersClass.set(key, service.useClass);
+                }
+                else {
+                    useExample = true;
+                    this.logger.important(`You are trying to inject the ${key} provider`, `but it is not possible to add it because using useFactory or useValue`);
+                }
+                if (useExample) {
+                    this.logger.debug('Example ✅', '{ provider: UserClassRepository, useClass: UserClassImplementation }');
+                    this.logger.debug('Example ❌', '{ provider: UserClassRepository, useClass: () => { return "text" }}');
+                    this.logger.debug('Example ❌', '{ provider: UserClassRepository, useFactory: () => { return "text" }}');
+                    this.logger.debug('Example ❌', '{ provider: UserClassRepository, useValue: "Text" }');
+                }
+            }
         });
         this.logger.debug('Injector - list provider', this.listProviders);
+        this.logger.debug('Injector - list provider type class', this.listProvidersClass);
     }
     /**
-     * Método para obtener un objeto con los parámetros(key) y valores(useValue)
-     * que se inyectarán en la clase (target) mediante asClass().inject().
+     * Método para obtener un objeto con los parámetros(key) y valores(useValue, useClass, useFactory)
+     * que se inyectarán en la clase (target).
      *
      * @param { TClass} target - La clase objetivo.
      * @returns {object} - Objeto con datos a inyectar.
@@ -58,8 +87,8 @@ class Injector {
             for (const key of dInject.keys()) {
                 if (this.listProviders.has(key)) {
                     const paramName = dInject.get(key);
-                    const useValue = this.listProviders.get(key);
-                    injectData[paramName] = useValue;
+                    const provider = this.listProviders.get(key);
+                    injectData[paramName] = provider;
                 }
                 else {
                     this.logger.important(`You are trying to inject @INJECT('${key}') into '${target.name}'`, `but the provider '${key}' and its value are not registered in '${this.moduleName}' or any other previously loaded modules`);
@@ -83,7 +112,7 @@ class Injector {
         let injector = (0, awilix_1.asClass)(target).scoped();
         if (!(0, shared_utils_1.isEmpty)(injectData)) {
             this.logger.debug(`Inject - list dependencies to inject of ${target.name}:`, injectData);
-            injector = injector.inject(this.funtionInjectData(injectData));
+            injector = injector.inject(() => injectData);
         }
         return {
             ...injector,
@@ -93,13 +122,5 @@ class Injector {
     getAllProvider() {
         return this.listProviders;
     }
-    getInjectProvider(provider) {
-        return typeof provider.value === 'function'
-            ? (0, awilix_1.asFunction)(provider.value).scoped()
-            : (0, awilix_1.asValue)(provider.value);
-    }
-    funtionInjectData(injectData) {
-        return () => injectData;
-    }
 }
 exports.Injector = Injector;

package/injector/module.d.ts

@@ -12,7 +12,8 @@ export declare class Module {
     private dependenciesClass;
     private metadata;
     private types;
-    private listProviders;
+    private readonly listProviders;
+    private readonly listProvidersClass;
     /**
      * Constructor del módulo.
      */
@@ -22,6 +23,7 @@ export declare class Module {
      * @param {any} module - Módulo a configurar.
      */
     setup(module: any): void;
+    scan(): void;
     /**
      * Inicializa el módulo extrayendo metadatos y registrando las entidades.
      */
@@ -42,6 +44,11 @@ export declare class Module {
      * @private
      */
     private registerEntities;
+    /**
+     * Registra entidades que se escanearon en dentro de proveedores para se reemplazar otra clase.
+     * @private
+     */
+    private registerEntitiesFromProvider;
     /**
      * Agrupación de dependencias para alias
      *
@@ -65,7 +72,7 @@ export declare class Module {
      * contructor(private sA: ServiceA) // parametro con nombre diferente
      */
     private registerDependenciesToAlias;
-    private registerAllProviders;
+    registerAllProviders(): void;
     /**
      * Devuelve las importaciones del módulo.
      * @returns {TClass[] | undefined} - Importaciones del módulo.

package/injector/module.js

@@ -8,6 +8,7 @@ const utils_1 = require("@zanobijs/common/utils");
 const injector_1 = require("./injector");
 const metadata_1 = require("../metadata");
 const exceptions_1 = require("../exceptions");
+const invalidProvider_module_exception_1 = require("../exceptions/invalidProvider.module.exception");
 /**
  * Módulo para gestionar la configuración y el registro de controladores, servicios y dependencias.
  */
@@ -21,6 +22,7 @@ class Module {
     metadata;
     types = ['controller', 'service'];
     listProviders = new Map();
+    listProvidersClass = new Map();
     /**
      * Constructor del módulo.
      */
@@ -36,20 +38,24 @@ class Module {
         if (this.metadata.isTypeModule(module)) {
             this.module = module;
             this.logger.debug('Module - Setup - Create Injector to module:', module.name);
-            this.injector = new injector_1.Injector(module, this.listProviders);
+            this.injector = new injector_1.Injector(this.module, this.listProviders, this.listProvidersClass);
         }
         else {
             throw new exceptions_1.InvalidModuleAnnotationException();
         }
     }
+    scan() {
+        this.injector.scanProviders();
+        this.getMetadataModule();
+    }
     /**
      * Inicializa el módulo extrayendo metadatos y registrando las entidades.
      */
     initialize() {
         this.logger.debug('Module - Initialize:', this.module.name);
-        this.registerAllProviders();
         this.getMetadataModule();
         this.registerDependencies();
+        this.registerEntitiesFromProvider();
         this.registerDependenciesToAlias();
     }
     /**
@@ -74,7 +80,7 @@ class Module {
      */
     registerEntities(entityType) {
         const entities = this.config[entityType];
-        this.logger.debug('Module - ..... searching for entities type ', entityType);
+        this.logger.debug('Module - searching for entities type:', entityType);
         if (entities && entities.length > 0) {
             const registeredEntities = entities
                 .filter((target) => {
@@ -96,6 +102,35 @@ class Module {
             this.logger.debug('Module - Does not have entities of that type', entityType);
         }
     }
+    /**
+     * Registra entidades que se escanearon en dentro de proveedores para se reemplazar otra clase.
+     * @private
+     */
+    registerEntitiesFromProvider() {
+        this.logger.debug('Module - searching for entities from provider');
+        for (const [key, value] of this.listProvidersClass) {
+            try {
+                this.logger.debug('Module - Entity provider', `<<< ${key} >>>`);
+                const type = this.metadata.determineType(value);
+                if (!this.types.includes(type)) {
+                    throw new Error('The type used in the provider useClass property is not valid');
+                }
+                this.groupDependenciesForAlias(value);
+                const targetName = (0, shared_utils_1.unCapitalize)(value.name);
+                const targetProviderName = (0, shared_utils_1.unCapitalize)(key);
+                const registerProviderWithEntities = {
+                    [value.name]: this.injector.getInjectorClass(value),
+                    [targetName]: (0, awilix_1.aliasTo)(value.name),
+                    [key]: (0, awilix_1.aliasTo)(value.name),
+                    [targetProviderName]: (0, awilix_1.aliasTo)(value.name),
+                };
+                Object.assign(this.registerClass, registerProviderWithEntities);
+            }
+            catch (error) {
+                throw new invalidProvider_module_exception_1.InvalidProviderModuleException(value.name, this.module.name, error.message);
+            }
+        }
+    }
     /**
      * Agrupación de dependencias para alias
      *
@@ -110,7 +145,7 @@ class Module {
      */
     groupDependenciesForAlias(target) {
         const dependencies = this.metadata.getClassDependencies(target);
-        this.logger.debug(`Module - List dependecies to group by${target.name}`, dependencies);
+        this.logger.debug(`Module - List dependecies to group by ${target.name}`, dependencies);
         if (dependencies && !(0, shared_utils_1.isEmpty)(dependencies)) {
             this.dependenciesClass = [...this.dependenciesClass, ...dependencies];
         }
@@ -136,11 +171,7 @@ class Module {
         this.logger.debug('Module - Register list provider:', this.module.name);
         const listProviders = this.injector.getAllProvider();
         listProviders.forEach((value, key) => {
-            const providerInject = this.injector.getInjectProvider({
-                key,
-                value,
-            });
-            this.registerClass[key] = providerInject;
+            this.registerClass[key] = value;
         });
     }
     /**
@@ -155,7 +186,7 @@ class Module {
      * @returns {any} - Clases registradas.
      */
     getRegisterClass() {
-        this.logger.debug('Module - List of candidate classes to register in container.', this.registerClass);
+        this.logger.debug(`Module ${this.module.name} - List of candidate classes to register in container.`, this.registerClass);
         return this.registerClass;
     }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zanobijs/core",
-  "version": "1.1.1-beta.0",
+  "version": "1.2.0-beta.1",
   "description": "Zanobi - modern, small, powerful node.js lambda framework (@core)",
   "keywords": [],
   "author": "John Edison Cortes Rivera [Devdroide] <johne.aplicativos@gmail.com>",
@@ -29,5 +29,5 @@
   "peerDependencies": {
     "@zanobijs/common": "*"
   },
-  "gitHead": "5194cbeb7a6e41341f99dbc57f39150d741372a8"
+  "gitHead": "30085eedbf67b5ddcd588ad11a4b3e7782f66d87"
 }