@nexus-ioc/core 0.4.1 → 0.6.1

package/dist/esm/core/modules/container.js

@@ -0,0 +1,178 @@
+import { ModuleGraph } from "../graph/module-graph.js";
+import { Resolver } from "../resolver/resolver.js";
+import { ModulesContainer } from "./modules-container.js";
+/**
+ * Container is the core IoC (Inversion of Control) container that manages
+ * modules, providers, and dependency injection.
+ *
+ * The Container is responsible for:
+ * - Registering and managing modules
+ * - Building the dependency graph
+ * - Resolving dependencies and creating instances
+ * - Managing the lifecycle of providers
+ *
+ * @example
+ * ```typescript
+ * const container = new Container(hashUtils);
+ * await container.run(AppModule);
+ * const service = await container.get(MyService);
+ * ```
+ */
+export class Container {
+    /**
+     * Creates a new Container instance.
+     *
+     * @param hashUtils - Utility for generating unique hashes for modules
+     */
+    constructor(hashUtils) {
+        this.hashUtils = hashUtils;
+        this.modulesContainer = new ModulesContainer(this.hashUtils, this);
+        this._graph = null;
+        this.moduleGraphResolver = null;
+    }
+    /**
+     * Adds a module to the container.
+     *
+     * This method registers a module and all its providers, imports, and exports
+     * in the container. The module can be either a static module class or a
+     * dynamic module with runtime configuration.
+     *
+     * @param module - The module to add (static or dynamic)
+     * @returns A promise that resolves to the module container
+     *
+     * @example
+     * ```typescript
+     * await container.addModule(AppModule);
+     * await container.addModule(DatabaseModule.forRoot({ host: 'localhost' }));
+     * ```
+     */
+    async addModule(module) {
+        return await this.modulesContainer.addModule(module);
+    }
+    /**
+     * Replaces an existing module with a new module.
+     *
+     * This is useful for hot module replacement or testing scenarios where
+     * you need to swap out a module implementation.
+     *
+     * @param moduleToReplace - The module to be replaced
+     * @param newModule - The new module to use instead
+     * @returns A promise that resolves to the new module container
+     *
+     * @example
+     * ```typescript
+     * await container.replaceModule(OldDatabaseModule, NewDatabaseModule);
+     * ```
+     */
+    async replaceModule(moduleToReplace, newModule) {
+        return await this.modulesContainer.replaceModule(moduleToReplace, newModule);
+    }
+    /**
+     * Retrieves a module container by its module class.
+     *
+     * @param module - The module class to look up
+     * @returns A promise that resolves to the module container, or undefined if not found
+     *
+     * @example
+     * ```typescript
+     * const moduleContainer = await container.getModule(DatabaseModule);
+     * ```
+     */
+    async getModule(module) {
+        return this.modulesContainer.getModule(module);
+    }
+    /**
+     * Resolves and returns an instance of a provider by its injection token.
+     *
+     * This is the main method for retrieving dependencies from the container.
+     * The instance is created according to its scope:
+     * - Singleton: Same instance returned every time
+     * - Request: New instance for each get() call
+     * - Transient: New instance every time, even within the same dependency tree
+     *
+     * @template T - The type of the provider to resolve
+     * @param token - The injection token (class, string, or symbol)
+     * @returns A promise that resolves to the provider instance, or undefined if not found
+     *
+     * @example
+     * ```typescript
+     * const userService = await container.get(UserService);
+     * const config = await container.get('CONFIG');
+     * ```
+     */
+    async get(token) {
+        return this.moduleGraphResolver?.resolveProvider(token);
+    }
+    /**
+     * Initializes and runs the container with the specified root module.
+     *
+     * This method:
+     * 1. Registers the root module and all its dependencies
+     * 2. Builds the dependency graph
+     * 3. Validates the graph for circular dependencies and missing providers
+     * 4. Initializes all providers with lifecycle hooks
+     *
+     * This method must be called before using get() to resolve dependencies.
+     *
+     * @param rootModule - The root module of the application
+     * @returns A promise that resolves when initialization is complete
+     * @throws {Error} If there are circular dependencies or missing providers
+     *
+     * @example
+     * ```typescript
+     * const container = new Container(hashUtils);
+     * await container.run(AppModule);
+     * // Now you can use container.get() to resolve dependencies
+     * ```
+     */
+    async run(rootModule) {
+        const root = await this.modulesContainer.addModule(rootModule);
+        this._graph = new ModuleGraph(root);
+        this.moduleGraphResolver = new Resolver(this._graph);
+        await this._graph.compile();
+    }
+    /**
+     * Gets the dependency graph.
+     *
+     * The graph contains all modules, providers, and their dependencies.
+     * It can be used for introspection and debugging.
+     *
+     * @returns The module graph
+     * @throws {Error} If the graph is not initialized (run() not called yet)
+     *
+     * @example
+     * ```typescript
+     * await container.run(AppModule);
+     * const graph = container.graph;
+     * console.log(graph.getAllNodes());
+     * ```
+     */
+    get graph() {
+        if (!this._graph) {
+            throw new Error("Graph is not initialized. Call run() method before accessing the graph.");
+        }
+        return this._graph;
+    }
+    /**
+     * Gets all errors that occurred during graph compilation.
+     *
+     * Errors can include:
+     * - Circular dependencies
+     * - Missing providers
+     * - Unreachable dependencies
+     *
+     * @returns An array of graph errors
+     *
+     * @example
+     * ```typescript
+     * await container.run(AppModule);
+     * if (container.errors.length > 0) {
+     *   console.error('Graph errors:', container.errors);
+     * }
+     * ```
+     */
+    get errors() {
+        return this.graph.errors;
+    }
+}
+//# sourceMappingURL=container.js.map

package/dist/esm/core/modules/container.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"container.js","sourceRoot":"","sources":["../../../../src/core/modules/container.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAEvD;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,OAAO,SAAS;IASrB;;;;OAIG;IACH,YAA6B,SAA4B;QAA5B,cAAS,GAAT,SAAS,CAAmB;QAbxC,qBAAgB,GAAG,IAAI,gBAAgB,CACvD,IAAI,CAAC,SAAS,EACd,IAAI,CACJ,CAAC;QAEM,WAAM,GAAgC,IAAI,CAAC;QAC3C,wBAAmB,GAAoB,IAAI,CAAC;IAOQ,CAAC;IAE7D;;;;;;;;;;;;;;;OAeG;IACI,KAAK,CAAC,SAAS,CACrB,MAA8B;QAE9B,OAAO,MAAM,IAAI,CAAC,gBAAgB,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IACtD,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACI,KAAK,CAAC,aAAa,CACzB,eAAuB,EACvB,SAAiB;QAEjB,OAAO,MAAM,IAAI,CAAC,gBAAgB,CAAC,aAAa,CAC/C,eAAe,EACf,SAAS,CACT,CAAC;IACH,CAAC;IAED;;;;;;;;;;OAUG;IACI,KAAK,CAAC,SAAS,CACrB,MAAc;QAEd,OAAO,IAAI,CAAC,gBAAgB,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAChD,CAAC;IAED;;;;;;;;;;;;;;;;;;OAkBG;IACI,KAAK,CAAC,GAAG,CAAI,KAAqB;QACxC,OAAO,IAAI,CAAC,mBAAmB,EAAE,eAAe,CAAI,KAAK,CAAC,CAAC;IAC5D,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;OAqBG;IACI,KAAK,CAAC,GAAG,CAAC,UAAkB;QAClC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;QAE/D,IAAI,CAAC,MAAM,GAAG,IAAI,WAAW,CAAC,IAAI,CAAC,CAAC;QAEpC,IAAI,CAAC,mBAAmB,GAAG,IAAI,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAErD,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;IAC7B,CAAC;IAED;;;;;;;;;;;;;;;OAeG;IACH,IAAW,KAAK;QACf,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YAClB,MAAM,IAAI,KAAK,CACd,yEAAyE,CACzE,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAC,MAAM,CAAC;IACpB,CAAC;IAED;;;;;;;;;;;;;;;;;OAiBG;IACH,IAAW,MAAM;QAChB,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC;IAC1B,CAAC;CACD"}

package/dist/esm/core/modules/module-container-factory.js

@@ -0,0 +1,21 @@
+import "reflect-metadata";
+import { MODULE_TOKEN_WATERMARK } from "../../interfaces/index.js";
+import { ModuleContainer } from "./module-container.js";
+export class ModuleContainerFactory {
+    constructor(moduleTokenFactory) {
+        this.moduleTokenFactory = moduleTokenFactory;
+    }
+    async create(module, container) {
+        const moduleContainer = new ModuleContainer(module, container);
+        moduleContainer.token = await this.getModuleToken(module);
+        Reflect.defineMetadata(MODULE_TOKEN_WATERMARK, moduleContainer.token, module);
+        return moduleContainer;
+    }
+    getModuleToken(module) {
+        return this.moduleTokenFactory.create(module);
+    }
+    async getModuleContainerImports(module) {
+        return await module.imports;
+    }
+}
+//# sourceMappingURL=module-container-factory.js.map

package/dist/esm/core/modules/module-container-factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"module-container-factory.js","sourceRoot":"","sources":["../../../../src/core/modules/module-container-factory.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAS1B,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD,MAAM,OAAO,sBAAsB;IAClC,YACkB,kBAA+C;QAA/C,uBAAkB,GAAlB,kBAAkB,CAA6B;IAC9D,CAAC;IAEG,KAAK,CAAC,MAAM,CAClB,MAA8B,EAC9B,SAAiC;QAEjC,MAAM,eAAe,GAAG,IAAI,eAAe,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;QAE/D,eAAe,CAAC,KAAK,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;QAE1D,OAAO,CAAC,cAAc,CACrB,sBAAsB,EACtB,eAAe,CAAC,KAAK,EACrB,MAAM,CACN,CAAC;QAEF,OAAO,eAAe,CAAC;IACxB,CAAC;IAEM,cAAc,CAAC,MAA8B;QACnD,OAAO,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC/C,CAAC;IAEM,KAAK,CAAC,yBAAyB,CACrC,MAAgC;QAEhC,OAAO,MAAM,MAAM,CAAC,OAAO,CAAC;IAC7B,CAAC;CACD"}

package/dist/esm/core/modules/module-container.js

@@ -0,0 +1,58 @@
+import "reflect-metadata";
+import { MODULE_METADATA } from "../../interfaces/index.js";
+import { isDynamicModule } from "../../utils/helpers.js";
+export class ModuleContainer {
+    constructor(_metatype, container) {
+        this._metatype = _metatype;
+        this.container = container;
+        this._token = "";
+    }
+    get token() {
+        return this._token;
+    }
+    set token(value) {
+        this._token = value;
+    }
+    get metatype() {
+        return this._metatype;
+    }
+    get imports() {
+        let modules;
+        if (isDynamicModule(this.metatype)) {
+            modules = this.metatype.imports || [];
+        }
+        else {
+            modules =
+                Reflect.getMetadata(MODULE_METADATA.IMPORTS, this.metatype) || [];
+        }
+        const self = this;
+        return new Promise((resolved) => {
+            async function run() {
+                const imports = await Promise.all(modules.map((item) => {
+                    return self.container.addModule(item);
+                }));
+                resolved(imports);
+            }
+            run();
+        });
+    }
+    get providers() {
+        if (isDynamicModule(this.metatype)) {
+            return this.metatype.providers || [];
+        }
+        return Reflect.getMetadata(MODULE_METADATA.PROVIDERS, this.metatype) || [];
+    }
+    get exports() {
+        if (isDynamicModule(this.metatype)) {
+            return this.metatype.exports || [];
+        }
+        return Reflect.getMetadata(MODULE_METADATA.EXPORTS, this.metatype) || [];
+    }
+    get(token) {
+        return this.container.get(token);
+    }
+    get errors() {
+        return this.container.errors;
+    }
+}
+//# sourceMappingURL=module-container.js.map

package/dist/esm/core/modules/module-container.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"module-container.js","sourceRoot":"","sources":["../../../../src/core/modules/module-container.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAS1B,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEtD,MAAM,OAAO,eAAe;IAG3B,YACkB,SAAiC,EACjC,SAAiC;QADjC,cAAS,GAAT,SAAS,CAAwB;QACjC,cAAS,GAAT,SAAS,CAAwB;QAJ3C,WAAM,GAAG,EAAE,CAAC;IAKjB,CAAC;IAEJ,IAAW,KAAK;QACf,OAAO,IAAI,CAAC,MAAM,CAAC;IACpB,CAAC;IAED,IAAW,KAAK,CAAC,KAAa;QAC7B,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;IACrB,CAAC;IAED,IAAW,QAAQ;QAClB,OAAO,IAAI,CAAC,SAAS,CAAC;IACvB,CAAC;IAED,IAAW,OAAO;QACjB,IAAI,OAAmC,CAAC;QACxC,IAAI,eAAe,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;YACpC,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,IAAI,EAAE,CAAC;QACvC,CAAC;aAAM,CAAC;YACP,OAAO;gBACN,OAAO,CAAC,WAAW,CAAC,eAAe,CAAC,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QACpE,CAAC;QAED,MAAM,IAAI,GAAG,IAAI,CAAC;QAClB,OAAO,IAAI,OAAO,CAA6B,CAAC,QAAQ,EAAE,EAAE;YAC3D,KAAK,UAAU,GAAG;gBACjB,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAChC,OAAO,CAAC,GAAG,CAAC,CAAC,IAA4B,EAAE,EAAE;oBAC5C,OAAO,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;gBACvC,CAAC,CAAC,CACF,CAAC;gBAEF,QAAQ,CAAC,OAAO,CAAC,CAAC;YACnB,CAAC;YAED,GAAG,EAAE,CAAC;QACP,CAAC,CAAC,CAAC;IACJ,CAAC;IAED,IAAW,SAAS;QACnB,IAAI,eAAe,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;YACpC,OAAO,IAAI,CAAC,QAAQ,CAAC,SAAS,IAAI,EAAE,CAAC;QACtC,CAAC;QAED,OAAO,OAAO,CAAC,WAAW,CAAC,eAAe,CAAC,SAAS,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;IAC5E,CAAC;IAED,IAAW,OAAO;QACjB,IAAI,eAAe,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;YACpC,OAAO,IAAI,CAAC,QAAQ,CAAC,OAAO,IAAI,EAAE,CAAC;QACpC,CAAC;QAED,OAAO,OAAO,CAAC,WAAW,CAAC,eAAe,CAAC,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;IAC1E,CAAC;IAEM,GAAG,CAAI,KAAqB;QAClC,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAClC,CAAC;IAED,IAAW,MAAM;QAChB,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC;IAC9B,CAAC;CACD"}

package/dist/esm/core/modules/module-token-factory.js

@@ -0,0 +1,43 @@
+import { isDynamicModule } from "../../utils/helpers.js";
+export class ModuleTokenFactory {
+    constructor(hashUtils) {
+        this.hashUtils = hashUtils;
+        this.moduleTokenCache = new Map();
+        this.moduleTokens = new WeakMap();
+        this.moduleIdsCache = new WeakMap();
+    }
+    async create(metatype) {
+        const moduleToken = this.moduleTokens.get(metatype);
+        if (moduleToken) {
+            return moduleToken;
+        }
+        const token = await this.getStaticModuleToken(this.getMetatypeId(metatype), this.getModuleName(metatype));
+        this.moduleTokens.set(metatype, token);
+        return token;
+    }
+    async getStaticModuleToken(moduleId, moduleName) {
+        const key = `${moduleId}_${moduleName}`;
+        if (this.moduleTokenCache.has(key)) {
+            return this.moduleTokenCache.get(key);
+        }
+        const hash = await this.hashUtils.hashString(key);
+        this.moduleTokenCache.set(key, hash);
+        return hash;
+    }
+    getMetatypeId(metatype) {
+        let metatypeId = this.moduleIdsCache.get(metatype);
+        if (metatypeId) {
+            return metatypeId;
+        }
+        metatypeId = `${this.hashUtils.incrementString()}_${metatype.toString()}`;
+        this.moduleIdsCache.set(metatype, metatypeId);
+        return metatypeId;
+    }
+    getModuleName(metatype) {
+        if (isDynamicModule(metatype)) {
+            return metatype.module.name;
+        }
+        return metatype.name;
+    }
+}
+//# sourceMappingURL=module-token-factory.js.map

package/dist/esm/core/modules/module-token-factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"module-token-factory.js","sourceRoot":"","sources":["../../../../src/core/modules/module-token-factory.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEtD,MAAM,OAAO,kBAAkB;IAQ9B,YAA6B,SAA4B;QAA5B,cAAS,GAAT,SAAS,CAAmB;QAPxC,qBAAgB,GAAG,IAAI,GAAG,EAAkB,CAAC;QAC7C,iBAAY,GAAG,IAAI,OAAO,EAAkC,CAAC;QAC7D,mBAAc,GAAG,IAAI,OAAO,EAG1C,CAAC;IAEwD,CAAC;IAEtD,KAAK,CAAC,MAAM,CAAC,QAAgC;QACnD,MAAM,WAAW,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAEpD,IAAI,WAAW,EAAE,CAAC;YACjB,OAAO,WAAW,CAAC;QACpB,CAAC;QAED,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,oBAAoB,CAC5C,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,EAC5B,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,CAC5B,CAAC;QAEF,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QAEvC,OAAO,KAAK,CAAC;IACd,CAAC;IAEO,KAAK,CAAC,oBAAoB,CACjC,QAAgB,EAChB,UAAkB;QAElB,MAAM,GAAG,GAAG,GAAG,QAAQ,IAAI,UAAU,EAAE,CAAC;QACxC,IAAI,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACpC,OAAO,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,GAAG,CAAW,CAAC;QACjD,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;QAClD,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QACrC,OAAO,IAAI,CAAC;IACb,CAAC;IAEO,aAAa,CAAC,QAAgC;QACrD,IAAI,UAAU,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAEnD,IAAI,UAAU,EAAE,CAAC;YAChB,OAAO,UAAU,CAAC;QACnB,CAAC;QAED,UAAU,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,eAAe,EAAE,IAAI,QAAQ,CAAC,QAAQ,EAAE,EAAE,CAAC;QAE1E,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;QAC9C,OAAO,UAAU,CAAC;IACnB,CAAC;IAEO,aAAa,CAAC,QAAgC;QACrD,IAAI,eAAe,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC/B,OAAO,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC;QAC7B,CAAC;QAED,OAAO,QAAQ,CAAC,IAAI,CAAC;IACtB,CAAC;CACD"}

package/dist/esm/core/modules/modules-container.js

@@ -0,0 +1,39 @@
+import "reflect-metadata";
+import { MODULE_TOKEN_WATERMARK, } from "../../interfaces/index.js";
+import { ModuleContainerFactory } from "./module-container-factory.js";
+import { ModuleTokenFactory } from "./module-token-factory.js";
+export class ModulesContainer {
+    constructor(hashUtils, container) {
+        this.hashUtils = hashUtils;
+        this.container = container;
+        this.containers = new Map();
+        this.moduleTokenFactory = new ModuleTokenFactory(this.hashUtils);
+        this.moduleContainerFactory = new ModuleContainerFactory(this.moduleTokenFactory);
+    }
+    async addModule(module) {
+        const cacheModule = await this.getModule(module);
+        if (cacheModule) {
+            return cacheModule;
+        }
+        return this.setModule(module);
+    }
+    getModule(module) {
+        return this.getModuleFromCache(module);
+    }
+    async replaceModule(moduleToReplace, newModule) {
+        const tokenToReplace = this.getModule(moduleToReplace);
+        const newModuleContainer = await this.setModule(newModule);
+        this.containers.set(tokenToReplace?.token || newModuleContainer.token, newModuleContainer);
+        return newModuleContainer;
+    }
+    async setModule(module) {
+        const moduleContainer = await this.moduleContainerFactory.create(module, this.container);
+        this.containers.set(moduleContainer.token, moduleContainer);
+        return moduleContainer;
+    }
+    getModuleFromCache(module) {
+        const token = Reflect.getMetadata(MODULE_TOKEN_WATERMARK, module);
+        return this.containers.get(token);
+    }
+}
+//# sourceMappingURL=modules-container.js.map

package/dist/esm/core/modules/modules-container.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"modules-container.js","sourceRoot":"","sources":["../../../../src/core/modules/modules-container.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAC1B,OAAO,EAIN,sBAAsB,GAItB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AACpE,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAI5D,MAAM,OAAO,gBAAgB;IAO5B,YACkB,SAA4B,EAC5B,SAA6B;QAD7B,cAAS,GAAT,SAAS,CAAmB;QAC5B,cAAS,GAAT,SAAS,CAAoB;QAR9B,eAAU,GAAG,IAAI,GAAG,EAAmC,CAAC;QACxD,uBAAkB,GAAG,IAAI,kBAAkB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC5D,2BAAsB,GAAG,IAAI,sBAAsB,CACnE,IAAI,CAAC,kBAAkB,CACvB,CAAC;IAKC,CAAC;IAEJ,KAAK,CAAC,SAAS,CACd,MAA8B;QAE9B,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QAEjD,IAAI,WAAW,EAAE,CAAC;YACjB,OAAO,WAAW,CAAC;QACpB,CAAC;QAED,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAC/B,CAAC;IAED,SAAS,CACR,MAA8B;QAE9B,OAAO,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC;IACxC,CAAC;IAED,KAAK,CAAC,aAAa,CAClB,eAAuB,EACvB,SAAiB;QAEjB,MAAM,cAAc,GAAG,IAAI,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC;QACvD,MAAM,kBAAkB,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;QAE3D,IAAI,CAAC,UAAU,CAAC,GAAG,CAClB,cAAc,EAAE,KAAK,IAAI,kBAAkB,CAAC,KAAK,EACjD,kBAAkB,CAClB,CAAC;QAEF,OAAO,kBAAkB,CAAC;IAC3B,CAAC;IAEO,KAAK,CAAC,SAAS,CACtB,MAA8B;QAE9B,MAAM,eAAe,GAAG,MAAM,IAAI,CAAC,sBAAsB,CAAC,MAAM,CAC/D,MAAM,EACN,IAAI,CAAC,SAAS,CACd,CAAC;QAEF,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,eAAe,CAAC,KAAK,EAAE,eAAe,CAAC,CAAC;QAE5D,OAAO,eAAe,CAAC;IACxB,CAAC;IAEO,kBAAkB,CACzB,MAA8B;QAE9B,MAAM,KAAK,GAAG,OAAO,CAAC,WAAW,CAAC,sBAAsB,EAAE,MAAM,CAAU,CAAC;QAE3E,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACnC,CAAC;CACD"}

package/dist/esm/core/nexus-applications.browser.js

@@ -0,0 +1,49 @@
+import { HashUtilBrowser } from "../utils/hash-utils.browser.js";
+import { Container } from "./modules/container.js";
+/**
+ * @deprecated
+ * It will be removed in version 1.0.0.
+ * these classes work the same way. For the new behavior, use @NexusApplications
+ */
+export class NexusApplicationsBrowser {
+    constructor(rootModule) {
+        this.rootModule = rootModule;
+        this.hashUtil = new HashUtilBrowser();
+        this.scannerPlugins = [];
+        this.container = new Container(this.hashUtil);
+        this._parentContainer = null;
+    }
+    static create(rootModule) {
+        return new NexusApplicationsBrowser(rootModule);
+    }
+    async bootstrap() {
+        await this.container.run(this.rootModule);
+        for (const scannerPlugin of this.scannerPlugins) {
+            await scannerPlugin.scan(this.container.graph);
+        }
+        return this;
+    }
+    addScannerPlugin(scanner) {
+        const plugins = Array.isArray(scanner) ? scanner : [scanner];
+        this.scannerPlugins.push(...plugins);
+        return this;
+    }
+    async get(token) {
+        const dependency = await this.container.get(token);
+        if (!dependency) {
+            return this._parentContainer?.get(token);
+        }
+        return dependency;
+    }
+    get errors() {
+        return this.container.errors;
+    }
+    async() {
+        return this;
+    }
+    setParent(parentContainer) {
+        this._parentContainer = parentContainer;
+        return this;
+    }
+}
+//# sourceMappingURL=nexus-applications.browser.js.map

package/dist/esm/core/nexus-applications.browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nexus-applications.browser.js","sourceRoot":"","sources":["../../../src/core/nexus-applications.browser.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAEhD;;;;GAIG;AACH,MAAM,OAAO,wBAAwB;IAMpC,YAAqC,UAAkB;QAAlB,eAAU,GAAV,UAAU,CAAQ;QALtC,aAAQ,GAAG,IAAI,eAAe,EAAE,CAAC;QACjC,mBAAc,GAA6B,EAAE,CAAC;QAC9C,cAAS,GAAG,IAAI,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAClD,qBAAgB,GAAqC,IAAI,CAAC;IAER,CAAC;IAE3D,MAAM,CAAC,MAAM,CAAC,UAAkB;QAC/B,OAAO,IAAI,wBAAwB,CAAC,UAAU,CAAC,CAAC;IACjD,CAAC;IAEM,KAAK,CAAC,SAAS;QACrB,MAAM,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAE1C,KAAK,MAAM,aAAa,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YACjD,MAAM,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QAChD,CAAC;QAED,OAAO,IAAI,CAAC;IACb,CAAC;IAEM,gBAAgB,CACtB,OAA0D;QAE1D,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;QAC7D,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC;QACrC,OAAO,IAAI,CAAC;IACb,CAAC;IAEM,KAAK,CAAC,GAAG,CAAI,KAAqB;QACxC,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,GAAG,CAAI,KAAK,CAAC,CAAC;QAEtD,IAAI,CAAC,UAAU,EAAE,CAAC;YACjB,OAAO,IAAI,CAAC,gBAAgB,EAAE,GAAG,CAAI,KAAK,CAAC,CAAC;QAC7C,CAAC;QAED,OAAO,UAAU,CAAC;IACnB,CAAC;IAED,IAAW,MAAM;QAChB,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC;IAC9B,CAAC;IAED,KAAK;QACJ,OAAO,IAAI,CAAC;IACb,CAAC;IAEM,SAAS,CAAC,eAA0C;QAC1D,IAAI,CAAC,gBAAgB,GAAG,eAAe,CAAC;QACxC,OAAO,IAAI,CAAC;IACb,CAAC;CACD"}

package/dist/esm/core/nexus-applications.js

@@ -0,0 +1,200 @@
+import { NodeTypeEnum, Scope, } from "../interfaces/index.js";
+import { HashUtil } from "../utils/hash-utils.js";
+import { Container } from "./modules/container.js";
+/**
+ * NexusApplications is the main application class that provides a high-level
+ * API for creating and managing IoC containers.
+ *
+ * This class wraps the Container and provides additional features:
+ * - Automatic singleton initialization
+ * - Scanner plugin support for custom metadata processing
+ * - Parent-child container hierarchies
+ * - Async/sync container modes
+ *
+ * @example
+ * ```typescript
+ * const app = NexusApplications.create(AppModule);
+ * await app.bootstrap();
+ * const service = await app.get(MyService);
+ * ```
+ */
+export class NexusApplications {
+    /**
+     * Creates a new NexusApplications instance.
+     *
+     * @param rootModule - The root module of the application
+     * @param options - Optional configuration
+     * @param options.hashFn - Custom hash function for module identification
+     */
+    constructor(rootModule, options) {
+        this.rootModule = rootModule;
+        this.hashUtil = new HashUtil();
+        this.isAsyncContainer = false;
+        this.container = new Container(this.hashUtil);
+        this.scannerPlugins = [];
+        this._parentContainer = null;
+        if (options?.hashFn && typeof options?.hashFn === "function") {
+            this.hashUtil = new options.hashFn();
+        }
+    }
+    /**
+     * Creates a new NexusApplications instance.
+     *
+     * This is the main entry point for creating an application.
+     *
+     * @param rootModule - The root module of the application
+     * @param options - Optional configuration
+     * @param options.hashFn - Custom hash function for module identification
+     * @returns A new NexusApplications instance
+     *
+     * @example
+     * ```typescript
+     * const app = NexusApplications.create(AppModule);
+     * await app.bootstrap();
+     * ```
+     */
+    static create(rootModule, options) {
+        return new NexusApplications(rootModule, options);
+    }
+    /**
+     * Bootstraps the application by initializing the container and all providers.
+     *
+     * This method:
+     * 1. Runs the container with the root module
+     * 2. Executes all registered scanner plugins
+     * 3. Pre-instantiates all singleton providers (unless async mode is enabled)
+     *
+     * @returns A promise that resolves to this instance for method chaining
+     * @throws {Error} If there are circular dependencies or missing providers
+     *
+     * @example
+     * ```typescript
+     * const app = NexusApplications.create(AppModule);
+     * await app.bootstrap();
+     * // Application is now ready to use
+     * ```
+     */
+    async bootstrap() {
+        await this.container.run(this.rootModule);
+        for (const scannerPlugin of this.scannerPlugins) {
+            await scannerPlugin.scan(this.container.graph);
+        }
+        if (!this.isAsyncContainer) {
+            for (const [token, node] of this.container.graph.nodes) {
+                if (node.type === NodeTypeEnum.PROVIDER &&
+                    node.scope === Scope.Singleton) {
+                    await this.container.get(token);
+                }
+            }
+        }
+        return this;
+    }
+    /**
+     * Adds one or more scanner plugins to the application.
+     *
+     * Scanner plugins are executed after the dependency graph is built
+     * and can be used to process custom metadata, validate the graph,
+     * or perform other initialization tasks.
+     *
+     * @param scanner - A single scanner plugin or an array of scanner plugins
+     * @returns This instance for method chaining
+     *
+     * @example
+     * ```typescript
+     * const app = NexusApplications.create(AppModule)
+     *   .addScannerPlugin(new CustomScanner())
+     *   .addScannerPlugin([new Scanner1(), new Scanner2()]);
+     * await app.bootstrap();
+     * ```
+     */
+    addScannerPlugin(scanner) {
+        const plugins = Array.isArray(scanner) ? scanner : [scanner];
+        this.scannerPlugins.push(...plugins);
+        return this;
+    }
+    /**
+     * Resolves and returns an instance of a provider by its injection token.
+     *
+     * If the provider is not found in this container, it will attempt to
+     * resolve it from the parent container (if set).
+     *
+     * @template T - The type of the provider to resolve
+     * @param token - The injection token (class, string, or symbol)
+     * @returns A promise that resolves to the provider instance, or undefined if not found
+     *
+     * @example
+     * ```typescript
+     * const app = await NexusApplications.create(AppModule).bootstrap();
+     * const userService = await app.get(UserService);
+     * const config = await app.get('CONFIG');
+     * ```
+     */
+    async get(token) {
+        const dependency = await this.container.get(token);
+        // Check for undefined specifically, not falsy values (null, 0, false, etc. are valid)
+        if (dependency === undefined) {
+            return this._parentContainer?.get(token);
+        }
+        return dependency;
+    }
+    /**
+     * Gets all errors that occurred during graph compilation.
+     *
+     * @returns An array of graph errors
+     *
+     * @example
+     * ```typescript
+     * const app = await NexusApplications.create(AppModule).bootstrap();
+     * if (app.errors.length > 0) {
+     *   console.error('Application errors:', app.errors);
+     * }
+     * ```
+     */
+    get errors() {
+        return this.container.errors;
+    }
+    /**
+     * Enables async mode for the container.
+     *
+     * In async mode, singleton providers are NOT pre-instantiated during
+     * bootstrap. They will be created lazily on first access via get().
+     * This can improve startup time for large applications.
+     *
+     * @returns This instance for method chaining
+     *
+     * @example
+     * ```typescript
+     * const app = NexusApplications.create(AppModule)
+     *   .async();
+     * await app.bootstrap(); // Singletons are NOT created yet
+     * const service = await app.get(MyService); // Created on first access
+     * ```
+     */
+    async() {
+        this.isAsyncContainer = true;
+        return this;
+    }
+    /**
+     * Sets a parent container for this application.
+     *
+     * When a provider is not found in this container, it will be looked up
+     * in the parent container. This enables hierarchical container structures.
+     *
+     * @param parentContainer - The parent container
+     * @returns This instance for method chaining
+     *
+     * @example
+     * ```typescript
+     * const parentApp = await NexusApplications.create(ParentModule).bootstrap();
+     * const childApp = await NexusApplications.create(ChildModule)
+     *   .setParent(parentApp)
+     *   .bootstrap();
+     * // childApp can access providers from parentApp
+     * ```
+     */
+    setParent(parentContainer) {
+        this._parentContainer = parentContainer;
+        return this;
+    }
+}
+//# sourceMappingURL=nexus-applications.js.map

package/dist/esm/core/nexus-applications.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nexus-applications.js","sourceRoot":"","sources":["../../../src/core/nexus-applications.ts"],"names":[],"mappings":"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"}