@elsikora/cladi 2.0.2-dev.1 → 2.1.0-dev.1

package/dist/esm/presentation/ergonomics/utility/compose-modules.utility.js

@@ -0,0 +1,186 @@
+import { BaseError } from '../../../infrastructure/class/base/error.class.js';
+
+const IMPORT_REGISTRATION_MODE_RANK = 1;
+const ROOT_REGISTRATION_MODE_RANK = 2;
+const MODULE_REGISTRATION_MODE_RANK = {
+    import: IMPORT_REGISTRATION_MODE_RANK,
+    root: ROOT_REGISTRATION_MODE_RANK,
+};
+/**
+ * Registers module trees in deterministic order (imports first, then local providers).
+ * Imported modules expose providers through the `exports` contract.
+ * @param {IDIContainer} container Target container.
+ * @param {Array<IDIModule>} modules Module list to compose.
+ */
+function composeModules(container, modules) {
+    const processingModules = new Set();
+    const registeredModuleModes = new WeakMap();
+    const registeredModuleProvidersByToken = new WeakMap();
+    const registerModule = (moduleDefinition, mode, modulePath) => {
+        const previousMode = registeredModuleModes.get(moduleDefinition);
+        const hasSufficientRegistrationMode = previousMode !== undefined && MODULE_REGISTRATION_MODE_RANK[previousMode] >= MODULE_REGISTRATION_MODE_RANK[mode];
+        if (hasSufficientRegistrationMode) {
+            return;
+        }
+        if (processingModules.has(moduleDefinition)) {
+            throw new BaseError("Circular module imports detected", {
+                code: "MODULE_CIRCULAR_DEPENDENCY",
+                context: {
+                    cyclePath: getModuleCyclePath(modulePath, moduleDefinition),
+                },
+                source: "composeModules",
+            });
+        }
+        processingModules.add(moduleDefinition);
+        try {
+            const localProvidersByToken = getLocalProvidersByToken(moduleDefinition);
+            validateModuleExports(moduleDefinition, localProvidersByToken);
+            const nextModulePath = [...modulePath, moduleDefinition];
+            for (const importedModule of moduleDefinition.imports) {
+                registerModule(importedModule, "import", nextModulePath);
+            }
+            const providersToRegister = mode === "root" ? moduleDefinition.providers : collectImportableProviders(moduleDefinition, localProvidersByToken);
+            const previouslyRegisteredProvidersByToken = registeredModuleProvidersByToken.get(moduleDefinition) ?? new Map();
+            const nextRegisteredProvidersByToken = new Map(previouslyRegisteredProvidersByToken);
+            for (const provider of providersToRegister) {
+                const previouslyRegisteredProviders = nextRegisteredProvidersByToken.get(provider.provide) ?? new Set();
+                if (previouslyRegisteredProviders.has(provider)) {
+                    continue;
+                }
+                container.register(provider);
+                const nextProviders = new Set(previouslyRegisteredProviders);
+                nextProviders.add(provider);
+                nextRegisteredProvidersByToken.set(provider.provide, nextProviders);
+            }
+            registeredModuleModes.set(moduleDefinition, mode);
+            registeredModuleProvidersByToken.set(moduleDefinition, nextRegisteredProvidersByToken);
+        }
+        finally {
+            processingModules.delete(moduleDefinition);
+        }
+    };
+    for (const moduleDefinition of modules) {
+        registerModule(moduleDefinition, "root", []);
+    }
+}
+/**
+ * Selects provider subset visible to an importing module.
+ * @param {IDIModule} moduleDefinition Source module definition.
+ * @param {Map<symbol, Array<Provider>>} localProvidersByToken Local providers indexed by token.
+ * @returns {Array<Provider>} Importable providers for current module.
+ */
+function collectImportableProviders(moduleDefinition, localProvidersByToken) {
+    const importableTokens = new Set();
+    const pendingTokens = [...moduleDefinition.exports];
+    while (pendingTokens.length > 0) {
+        const currentToken = pendingTokens.pop();
+        if (!currentToken || importableTokens.has(currentToken)) {
+            continue;
+        }
+        importableTokens.add(currentToken);
+        const currentProviders = localProvidersByToken.get(currentToken);
+        if (!currentProviders) {
+            continue;
+        }
+        for (const currentProvider of currentProviders) {
+            const dependencies = getProviderDependencies(currentProvider);
+            for (const dependencyToken of dependencies) {
+                if (localProvidersByToken.has(dependencyToken)) {
+                    pendingTokens.push(dependencyToken);
+                }
+            }
+        }
+    }
+    return moduleDefinition.providers.filter((provider) => importableTokens.has(provider.provide));
+}
+/**
+ * Converts token symbol to readable debug representation.
+ * @param {Token<unknown>} token Provider token.
+ * @returns {string} Human readable token string.
+ */
+function describeToken(token) {
+    return token.description ? `Symbol(${token.description})` : token.toString();
+}
+/**
+ * Builds map of local providers by token.
+ * @param {IDIModule} moduleDefinition Module definition.
+ * @returns {Map<symbol, Array<Provider>>} Providers indexed by token.
+ */
+function getLocalProvidersByToken(moduleDefinition) {
+    const providersByToken = new Map();
+    for (const provider of moduleDefinition.providers) {
+        const providersForToken = providersByToken.get(provider.provide);
+        if (providersForToken) {
+            providersForToken.push(provider);
+            continue;
+        }
+        providersByToken.set(provider.provide, [provider]);
+    }
+    return providersByToken;
+}
+/**
+ * Builds a module cycle path for structured error context.
+ * @param {Array<IDIModule>} modulePath Current traversal path.
+ * @param {IDIModule} repeatedModule Repeated module that closes the cycle.
+ * @returns {Array<string>} Human readable cycle chain.
+ */
+function getModuleCyclePath(modulePath, repeatedModule) {
+    const cycleStartIndex = modulePath.indexOf(repeatedModule);
+    const cycleModules = cycleStartIndex === -1 ? [...modulePath, repeatedModule] : [...modulePath.slice(cycleStartIndex), repeatedModule];
+    return cycleModules.map((cycleModule) => getModuleName(cycleModule));
+}
+/**
+ * Returns readable module identifier for diagnostics.
+ * @param {IDIModule} moduleDefinition Module definition.
+ * @returns {string} Module name for diagnostics.
+ */
+function getModuleName(moduleDefinition) {
+    return moduleDefinition.name ?? "anonymous-module";
+}
+/**
+ * Returns direct dependency tokens required by provider strategy.
+ * @param {Provider} provider Provider definition.
+ * @returns {Array<Token<unknown>>} Direct dependency token list.
+ */
+function getProviderDependencies(provider) {
+    if ("useExisting" in provider) {
+        return [provider.useExisting];
+    }
+    if ("useLazy" in provider) {
+        return [provider.useLazy];
+    }
+    if ("deps" in provider) {
+        return provider.deps ?? [];
+    }
+    return [];
+}
+/**
+ * Ensures each exported token is either local provider token or re-export from imports.
+ * @param {IDIModule} moduleDefinition Module definition.
+ * @param {Map<symbol, Array<Provider>>} localProvidersByToken Local providers indexed by token.
+ */
+function validateModuleExports(moduleDefinition, localProvidersByToken) {
+    const importedExportTokens = new Set();
+    for (const importedModule of moduleDefinition.imports) {
+        for (const exportedToken of importedModule.exports) {
+            importedExportTokens.add(exportedToken);
+        }
+    }
+    for (const exportedToken of moduleDefinition.exports) {
+        const hasLocalProvider = localProvidersByToken.has(exportedToken);
+        const hasImportedExport = importedExportTokens.has(exportedToken);
+        if (!hasLocalProvider && !hasImportedExport) {
+            throw new BaseError("Invalid module exports: token is not provided locally or by imported modules", {
+                code: "MODULE_EXPORT_INVALID",
+                context: {
+                    moduleName: moduleDefinition.name ?? "anonymous-module",
+                    token: describeToken(exportedToken),
+                },
+                source: "composeModules",
+            });
+        }
+    }
+}
+
+export { composeModules };
+//# sourceMappingURL=compose-modules.utility.js.map

package/dist/esm/presentation/ergonomics/utility/compose-modules.utility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compose-modules.utility.js","sources":["../../../../../../src/presentation/ergonomics/utility/compose-modules.utility.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/dist/esm/presentation/ergonomics/utility/create/autowire-provider.utility.d.ts

@@ -0,0 +1,14 @@
+import type { IClassProvider } from '../../../../domain/interface/index';
+import type { Constructor, Token } from '../../../../domain/type/index';
+import type { ICreateAutowireProviderOptions } from '../../interface/index';
+/**
+ * Creates a class provider using explicit options and optional class metadata.
+ * @param {Constructor<T>} useClass Class constructor to instantiate.
+ * @param {ICreateAutowireProviderOptions<T>} options Explicit provider options.
+ * @returns {IClassProvider<T>} Class provider definition.
+ * @template T Provider instance type.
+ */
+export declare function createAutowireProvider<T, TDependencies extends ReadonlyArray<Token<unknown>> = ReadonlyArray<Token<unknown>>>(useClass: Constructor<T, number extends TDependencies["length"] ? Array<never> : {
+    [Index in keyof TDependencies]: TDependencies[Index] extends Token<infer TValue> ? TValue : never;
+}>, options: ICreateAutowireProviderOptions<T, TDependencies>): IClassProvider<T, TDependencies>;
+//# sourceMappingURL=autowire-provider.utility.d.ts.map

package/dist/esm/presentation/ergonomics/utility/create/autowire-provider.utility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"autowire-provider.utility.d.ts","sourceRoot":"","sources":["../../../../../../src/presentation/ergonomics/utility/create/autowire-provider.utility.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,KAAK,EAAE,8BAA8B,EAAuB,MAAM,oCAAoC,CAAC;AAK9G;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,EAAE,aAAa,SAAS,aAAa,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,GAAG,aAAa,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,EAC5H,QAAQ,EAAE,WAAW,CACpB,CAAC,EACD,MAAM,SAAS,aAAa,CAAC,QAAQ,CAAC,GACnC,KAAK,CAAC,KAAK,CAAC,GACZ;KACC,KAAK,IAAI,MAAM,aAAa,GAAG,aAAa,CAAC,KAAK,CAAC,SAAS,KAAK,CAAC,MAAM,MAAM,CAAC,GAAG,MAAM,GAAG,KAAK;CACjG,CACH,EACD,OAAO,EAAE,8BAA8B,CAAC,CAAC,EAAE,aAAa,CAAC,GACvD,cAAc,CAAC,CAAC,EAAE,aAAa,CAAC,CAsBlC"}

package/dist/esm/presentation/ergonomics/utility/create/autowire-provider.utility.js

@@ -0,0 +1,108 @@
+import { BaseError } from '../../../../infrastructure/class/base/error.class.js';
+import { getInjectableMetadata } from '../injectable-metadata/get.utility.js';
+
+/**
+ * Creates a class provider using explicit options and optional class metadata.
+ * @param {Constructor<T>} useClass Class constructor to instantiate.
+ * @param {ICreateAutowireProviderOptions<T>} options Explicit provider options.
+ * @returns {IClassProvider<T>} Class provider definition.
+ * @template T Provider instance type.
+ */
+function createAutowireProvider(useClass, options) {
+    const metadata = getInjectableMetadata(useClass);
+    const staticDependencies = useClass.inject;
+    const dependencies = options.deps ?? metadata?.deps ?? staticDependencies ?? [];
+    const afterResolve = options.afterResolve ?? createLifecycleMethodHook(useClass, options.token, metadata?.afterResolveMethod, "afterResolve");
+    const onDispose = options.onDispose ?? createLifecycleMethodHook(useClass, options.token, metadata?.onDisposeMethod, "onDispose");
+    const onInit = options.onInit ?? createLifecycleMethodHook(useClass, options.token, metadata?.onInitMethod, "onInit");
+    validateDependencies(dependencies);
+    return {
+        afterResolve,
+        deps: dependencies,
+        isMultiBinding: options.isMultiBinding ?? metadata?.isMultiBinding,
+        lifecycle: options.lifecycle ?? metadata?.lifecycle,
+        onDispose,
+        onInit,
+        provide: options.token,
+        useClass,
+    };
+}
+/**
+ * Resolves a lifecycle hook method from injectable metadata.
+ * @param {Constructor<T>} useClass Provider class.
+ * @param {Token<T>} token Provider token for diagnostics.
+ * @param {string | undefined} methodName Decorated method name.
+ * @param {"afterResolve" | "onDispose" | "onInit"} hookName Hook type.
+ * @returns {((instance: T) => Promise<void> | void) | undefined} Lifecycle hook function.
+ * @template T Provider instance type.
+ */
+function createLifecycleMethodHook(useClass, token, methodName, hookName) {
+    if (!methodName) {
+        return undefined;
+    }
+    const prototypeCandidate = useClass.prototype;
+    const prototype = (typeof prototypeCandidate === "object" && prototypeCandidate !== null ? prototypeCandidate : {});
+    const prototypeMethod = prototype[methodName];
+    if (typeof prototypeMethod !== "function") {
+        throw new BaseError("Injectable lifecycle method not found on class prototype", {
+            code: "INJECTABLE_LIFECYCLE_METHOD_NOT_FOUND",
+            context: {
+                hook: hookName,
+                methodName,
+                token: describeToken(token),
+            },
+            source: "createAutowireProvider",
+        });
+    }
+    return (instance) => {
+        const instanceRecord = instance;
+        const instanceMethod = instanceRecord[methodName];
+        if (typeof instanceMethod !== "function") {
+            throw new BaseError("Injectable lifecycle method is not callable on resolved instance", {
+                code: "INJECTABLE_LIFECYCLE_METHOD_INVALID",
+                context: {
+                    hook: hookName,
+                    methodName,
+                    token: describeToken(token),
+                },
+                source: "createAutowireProvider",
+            });
+        }
+        return instanceMethod.call(instance);
+    };
+}
+/**
+ * Builds readable token description for diagnostics.
+ * @param {Token<unknown>} token Provider token.
+ * @returns {string} Token description.
+ */
+function describeToken(token) {
+    return token.description ? `Symbol(${token.description})` : token.toString();
+}
+/**
+ * Validates dependency metadata for autowire provider creation.
+ * @param {ReadonlyArray<Token<unknown>>} dependencies Dependency token list.
+ */
+function validateDependencies(dependencies) {
+    for (let dependencyIndex = 0; dependencyIndex < dependencies.length; dependencyIndex += 1) {
+        const hasDependencyAtIndex = Object.prototype.hasOwnProperty.call(dependencies, dependencyIndex);
+        if (!hasDependencyAtIndex) {
+            throw new BaseError("Injectable metadata has sparse dependency indexes", {
+                code: "INJECTABLE_METADATA_DEPS_SPARSE",
+                context: { index: dependencyIndex },
+                source: "createAutowireProvider",
+            });
+        }
+        const dependencyValue = dependencies[dependencyIndex];
+        if (typeof dependencyValue !== "symbol") {
+            throw new BaseError("Injectable metadata dependency token must be a symbol", {
+                code: "INJECTABLE_METADATA_DEPS_TOKEN_INVALID",
+                context: { index: dependencyIndex },
+                source: "createAutowireProvider",
+            });
+        }
+    }
+}
+
+export { createAutowireProvider };
+//# sourceMappingURL=autowire-provider.utility.js.map

package/dist/esm/presentation/ergonomics/utility/create/autowire-provider.utility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"autowire-provider.utility.js","sources":["../../../../../../../src/presentation/ergonomics/utility/create/autowire-provider.utility.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/dist/esm/presentation/ergonomics/utility/create/autowire.utility.d.ts

@@ -0,0 +1,15 @@
+import type { IClassProvider } from '../../../../domain/interface/index';
+import type { Constructor, Token } from '../../../../domain/type/index';
+import type { ICreateAutowireProviderOptions } from '../../interface/index';
+/**
+ * Creates autowired provider using token defined in injectable metadata.
+ * @param {Constructor<T>} useClass Class constructor to instantiate.
+ * @param {Omit<ICreateAutowireProviderOptions<T, TDependencies>, "token">} [options] Optional provider overrides.
+ * @returns {IClassProvider<T, TDependencies>} Class provider definition.
+ * @template T Provider instance type.
+ * @template TDependencies Constructor dependency tokens.
+ */
+export declare function autowire<T, TDependencies extends ReadonlyArray<Token<unknown>> = ReadonlyArray<Token<unknown>>>(useClass: Constructor<T, number extends TDependencies["length"] ? Array<never> : {
+    [Index in keyof TDependencies]: TDependencies[Index] extends Token<infer TValue> ? TValue : never;
+}>, options?: Omit<ICreateAutowireProviderOptions<T, TDependencies>, "token">): IClassProvider<T, TDependencies>;
+//# sourceMappingURL=autowire.utility.d.ts.map

package/dist/esm/presentation/ergonomics/utility/create/autowire.utility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"autowire.utility.d.ts","sourceRoot":"","sources":["../../../../../../src/presentation/ergonomics/utility/create/autowire.utility.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,KAAK,EAAE,8BAA8B,EAAuB,MAAM,oCAAoC,CAAC;AAO9G;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,aAAa,SAAS,aAAa,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,GAAG,aAAa,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,EAC9G,QAAQ,EAAE,WAAW,CACpB,CAAC,EACD,MAAM,SAAS,aAAa,CAAC,QAAQ,CAAC,GACnC,KAAK,CAAC,KAAK,CAAC,GACZ;KACC,KAAK,IAAI,MAAM,aAAa,GAAG,aAAa,CAAC,KAAK,CAAC,SAAS,KAAK,CAAC,MAAM,MAAM,CAAC,GAAG,MAAM,GAAG,KAAK;CACjG,CACH,EACD,OAAO,GAAE,IAAI,CAAC,8BAA8B,CAAC,CAAC,EAAE,aAAa,CAAC,EAAE,OAAO,CAAM,GAC3E,cAAc,CAAC,CAAC,EAAE,aAAa,CAAC,CAkBlC"}

package/dist/esm/presentation/ergonomics/utility/create/autowire.utility.js

@@ -0,0 +1,32 @@
+import { BaseError } from '../../../../infrastructure/class/base/error.class.js';
+import { getInjectableMetadata } from '../injectable-metadata/get.utility.js';
+import { createAutowireProvider } from './autowire-provider.utility.js';
+
+/**
+ * Creates autowired provider using token defined in injectable metadata.
+ * @param {Constructor<T>} useClass Class constructor to instantiate.
+ * @param {Omit<ICreateAutowireProviderOptions<T, TDependencies>, "token">} [options] Optional provider overrides.
+ * @returns {IClassProvider<T, TDependencies>} Class provider definition.
+ * @template T Provider instance type.
+ * @template TDependencies Constructor dependency tokens.
+ */
+function autowire(useClass, options = {}) {
+    const metadata = getInjectableMetadata(useClass);
+    const metadataToken = metadata?.token;
+    if (!metadataToken || typeof metadataToken !== "symbol") {
+        throw new BaseError("Injectable metadata token is missing; use @Injectable({ token }) or createAutowireProvider(..., { token })", {
+            code: "INJECTABLE_TOKEN_MISSING",
+            context: {
+                className: useClass.name ?? "anonymous-class",
+            },
+            source: "autowire",
+        });
+    }
+    return createAutowireProvider(useClass, {
+        ...options,
+        token: metadataToken,
+    });
+}
+
+export { autowire };
+//# sourceMappingURL=autowire.utility.js.map

package/dist/esm/presentation/ergonomics/utility/create/autowire.utility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"autowire.utility.js","sources":["../../../../../../../src/presentation/ergonomics/utility/create/autowire.utility.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;AASA;;;;;;;AAOG;SACa,QAAQ,CACvB,QAOC,EACD,UAA2E,EAAE,EAAA;AAE7E,IAAA,MAAM,QAAQ,GAAoC,qBAAqB,CAAC,QAAgC,CAAC;AACzG,IAAA,MAAM,aAAa,GAAyB,QAAQ,EAAE,KAA6B;IAEnF,IAAI,CAAC,aAAa,IAAI,OAAO,aAAa,KAAK,QAAQ,EAAE;AACxD,QAAA,MAAM,IAAI,SAAS,CAAC,4GAA4G,EAAE;AACjI,YAAA,IAAI,EAAE,0BAA0B;AAChC,YAAA,OAAO,EAAE;AACR,gBAAA,SAAS,EAAG,QAAyC,CAAC,IAAI,IAAI,iBAAiB;AAC/E,aAAA;AACD,YAAA,MAAM,EAAE,UAAU;AAClB,SAAA,CAAC;IACH;IAEA,OAAO,sBAAsB,CAAC,QAAQ,EAAE;AACvC,QAAA,GAAG,OAAO;AACV,QAAA,KAAK,EAAE,aAAa;AACpB,KAAA,CAAC;AACH;;;;"}

package/dist/esm/presentation/ergonomics/utility/create/index.d.ts

@@ -0,0 +1,5 @@
+export { createAutowireProvider } from './autowire-provider.utility';
+export { autowire } from './autowire.utility';
+export { createModuleFromDecorator } from './module-from-decorator.utility';
+export { createModule } from './module.utility';
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/presentation/ergonomics/utility/create/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/presentation/ergonomics/utility/create/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,yBAAyB,EAAE,MAAM,iCAAiC,CAAC;AAC5E,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/esm/presentation/ergonomics/utility/create/module-from-decorator.utility.d.ts

@@ -0,0 +1,9 @@
+import type { IDIModule } from '../../../../domain/interface/index';
+import type { Constructor } from '../../../../domain/type/index';
+/**
+ * Builds a module definition from a class decorated with @Module.
+ * @param {Constructor<unknown>} moduleClass Decorated module class.
+ * @returns {IDIModule} Normalized module definition.
+ */
+export declare function createModuleFromDecorator(moduleClass: Constructor<unknown>): IDIModule;
+//# sourceMappingURL=module-from-decorator.utility.d.ts.map

package/dist/esm/presentation/ergonomics/utility/create/module-from-decorator.utility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module-from-decorator.utility.d.ts","sourceRoot":"","sources":["../../../../../../src/presentation/ergonomics/utility/create/module-from-decorator.utility.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,KAAK,EAAE,WAAW,EAAY,MAAM,cAAc,CAAC;AAS1D;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,WAAW,EAAE,WAAW,CAAC,OAAO,CAAC,GAAG,SAAS,CAEtF"}

package/dist/esm/presentation/ergonomics/utility/create/module-from-decorator.utility.js

@@ -0,0 +1,133 @@
+import { BaseError } from '../../../../infrastructure/class/base/error.class.js';
+import { getModuleMetadata } from '../module-metadata/get.utility.js';
+import { autowire } from './autowire.utility.js';
+import { createModule } from './module.utility.js';
+
+/**
+ * Builds a module definition from a class decorated with @Module.
+ * @param {Constructor<unknown>} moduleClass Decorated module class.
+ * @returns {IDIModule} Normalized module definition.
+ */
+function createModuleFromDecorator(moduleClass) {
+    return resolveModuleClass(moduleClass, new Map(), []);
+}
+/**
+ * Checks whether input is constructable class constructor.
+ * @param {unknown} candidate Candidate value.
+ * @returns {boolean} True when value is a constructable class.
+ */
+function isConstructable(candidate) {
+    if (typeof candidate !== "function") {
+        return false;
+    }
+    const candidateAsConstructor = candidate;
+    const prototype = candidateAsConstructor.prototype;
+    return !!prototype && prototype.constructor === candidate;
+}
+/**
+ * Checks whether input is module definition shape.
+ * @param {unknown} candidate Candidate value.
+ * @returns {boolean} True when candidate is module definition-like.
+ */
+function isModuleDefinition(candidate) {
+    if (typeof candidate !== "object" || candidate === null) {
+        return false;
+    }
+    const moduleCandidate = candidate;
+    return Array.isArray(moduleCandidate.exports) && Array.isArray(moduleCandidate.imports) && Array.isArray(moduleCandidate.providers);
+}
+/**
+ * Checks whether input is provider definition shape.
+ * @param {unknown} candidate Candidate value.
+ * @returns {boolean} True when candidate is provider-like object.
+ */
+function isProviderDefinition(candidate) {
+    if (typeof candidate !== "object" || candidate === null) {
+        return false;
+    }
+    const providerCandidate = candidate;
+    return typeof providerCandidate.provide === "symbol";
+}
+/**
+ * Resolves module class recursively into module definition.
+ * @param {Constructor<unknown>} moduleClass Decorated module class.
+ * @param {Map<Constructor<unknown>, IDIModule>} cache Resolved module cache.
+ * @param {Array<Constructor<unknown>>} path Current recursion path.
+ * @returns {IDIModule} Resolved module definition.
+ */
+function resolveModuleClass(moduleClass, cache, path) {
+    const cachedModuleDefinition = cache.get(moduleClass);
+    if (cachedModuleDefinition) {
+        return cachedModuleDefinition;
+    }
+    if (path.includes(moduleClass)) {
+        throw new BaseError("Circular module decorator imports detected", {
+            code: "MODULE_DECORATOR_CIRCULAR_IMPORT",
+            context: {
+                cyclePath: [...path, moduleClass].map((currentModuleClass) => currentModuleClass.name || "anonymous-module-class"),
+            },
+            source: "createModuleFromDecorator",
+        });
+    }
+    const metadata = getModuleMetadata(moduleClass);
+    if (!metadata) {
+        throw new BaseError("Module metadata not found on class; decorate class with @Module", {
+            code: "MODULE_DECORATOR_METADATA_MISSING",
+            context: {
+                className: moduleClass.name || "anonymous-module-class",
+            },
+            source: "createModuleFromDecorator",
+        });
+    }
+    const nextPath = [...path, moduleClass];
+    const imports = (metadata.imports ?? []).map((importEntry) => resolveModuleImport(importEntry, cache, nextPath));
+    const providers = (metadata.providers ?? []).map((providerEntry) => resolveModuleProvider(providerEntry));
+    const moduleName = metadata.name ?? (moduleClass.name || undefined);
+    const moduleDefinition = createModule({
+        exports: metadata.exports,
+        imports,
+        name: moduleName,
+        providers,
+    });
+    cache.set(moduleClass, moduleDefinition);
+    return moduleDefinition;
+}
+/**
+ * Resolves module import entry to module definition.
+ * @param {Constructor<unknown> | IDIModule} importEntry Module import entry.
+ * @param {Map<Constructor<unknown>, IDIModule>} cache Resolved module cache.
+ * @param {Array<Constructor<unknown>>} path Current recursion path.
+ * @returns {IDIModule} Resolved module definition.
+ */
+function resolveModuleImport(importEntry, cache, path) {
+    if (isModuleDefinition(importEntry)) {
+        return importEntry;
+    }
+    if (isConstructable(importEntry)) {
+        return resolveModuleClass(importEntry, cache, path);
+    }
+    throw new BaseError("Module import must be a decorated module class or module definition", {
+        code: "MODULE_DECORATOR_IMPORT_INVALID",
+        source: "createModuleFromDecorator",
+    });
+}
+/**
+ * Resolves module provider entry to provider definition.
+ * @param {Constructor<unknown> | Provider} providerEntry Module provider entry.
+ * @returns {Provider} Resolved provider definition.
+ */
+function resolveModuleProvider(providerEntry) {
+    if (isProviderDefinition(providerEntry)) {
+        return providerEntry;
+    }
+    if (isConstructable(providerEntry)) {
+        return autowire(providerEntry);
+    }
+    throw new BaseError("Module provider must be a decorated class or provider definition", {
+        code: "MODULE_DECORATOR_PROVIDER_INVALID",
+        source: "createModuleFromDecorator",
+    });
+}
+
+export { createModuleFromDecorator };
+//# sourceMappingURL=module-from-decorator.utility.js.map

package/dist/esm/presentation/ergonomics/utility/create/module-from-decorator.utility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"module-from-decorator.utility.js","sources":["../../../../../../../src/presentation/ergonomics/utility/create/module-from-decorator.utility.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/dist/esm/presentation/ergonomics/utility/create/module.utility.d.ts

@@ -0,0 +1,9 @@
+import type { IDIModule } from '../../../../domain/interface/index';
+import type { ICreateModuleOptions } from '../../interface/index';
+/**
+ * Builds a declarative module definition for DI composition.
+ * @param {ICreateModuleOptions} options Module configuration.
+ * @returns {IDIModule} Normalized module definition.
+ */
+export declare function createModule(options: ICreateModuleOptions): IDIModule;
+//# sourceMappingURL=module.utility.d.ts.map

package/dist/esm/presentation/ergonomics/utility/create/module.utility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module.utility.d.ts","sourceRoot":"","sources":["../../../../../../src/presentation/ergonomics/utility/create/module.utility.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAE/E;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,oBAAoB,GAAG,SAAS,CASrE"}

package/dist/esm/presentation/ergonomics/utility/create/module.utility.js

@@ -0,0 +1,17 @@
+/**
+ * Builds a declarative module definition for DI composition.
+ * @param {ICreateModuleOptions} options Module configuration.
+ * @returns {IDIModule} Normalized module definition.
+ */
+function createModule(options) {
+    const moduleDefinition = {
+        exports: Object.freeze([...(options.exports ?? [])]),
+        imports: Object.freeze([...(options.imports ?? [])]),
+        name: options.name,
+        providers: Object.freeze([...(options.providers ?? [])]),
+    };
+    return Object.freeze(moduleDefinition);
+}
+
+export { createModule };
+//# sourceMappingURL=module.utility.js.map

package/dist/esm/presentation/ergonomics/utility/create/module.utility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"module.utility.js","sources":["../../../../../../../src/presentation/ergonomics/utility/create/module.utility.ts"],"sourcesContent":[null],"names":[],"mappings":"AAGA;;;;AAIG;AACG,SAAU,YAAY,CAAC,OAA6B,EAAA;AACzD,IAAA,MAAM,gBAAgB,GAAc;AACnC,QAAA,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,CAAC;AACpD,QAAA,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,CAAC;QACpD,IAAI,EAAE,OAAO,CAAC,IAAI;AAClB,QAAA,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,OAAO,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,CAAC;KACxD;AAED,IAAA,OAAO,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC;AACvC;;;;"}

package/dist/esm/presentation/ergonomics/utility/index.d.ts

@@ -0,0 +1,6 @@
+export { composeDecoratedModules } from './compose-decorated-modules.utility';
+export { composeModules } from './compose-modules.utility';
+export * from './create/index';
+export * from './injectable-metadata/index';
+export * from './module-metadata/index';
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/presentation/ergonomics/utility/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/presentation/ergonomics/utility/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,qCAAqC,CAAC;AAC9E,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,cAAc,UAAU,CAAC;AACzB,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC"}

package/dist/esm/presentation/ergonomics/utility/injectable-metadata/get.utility.d.ts

@@ -0,0 +1,9 @@
+import type { Constructor } from '../../../../domain/type/index';
+import type { IInjectableMetadata } from '../../interface/index';
+/**
+ * Reads injectable metadata from a class constructor.
+ * @param {Constructor<unknown>} target Constructor to inspect.
+ * @returns {IInjectableMetadata | undefined} Stored metadata.
+ */
+export declare function getInjectableMetadata(target: Constructor<unknown>): IInjectableMetadata | undefined;
+//# sourceMappingURL=get.utility.d.ts.map

package/dist/esm/presentation/ergonomics/utility/injectable-metadata/get.utility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get.utility.d.ts","sourceRoot":"","sources":["../../../../../../src/presentation/ergonomics/utility/injectable-metadata/get.utility.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AAI9E;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,GAAG,mBAAmB,GAAG,SAAS,CASnG"}

package/dist/esm/presentation/ergonomics/utility/injectable-metadata/get.utility.js

@@ -0,0 +1,18 @@
+import { INJECTABLE_METADATA_KEY } from '../../constant/injectable-metadata-key.constant.js';
+
+/**
+ * Reads injectable metadata from a class constructor.
+ * @param {Constructor<unknown>} target Constructor to inspect.
+ * @returns {IInjectableMetadata | undefined} Stored metadata.
+ */
+function getInjectableMetadata(target) {
+    const targetWithMetadata = target;
+    const hasOwnMetadata = Object.prototype.hasOwnProperty.call(targetWithMetadata, INJECTABLE_METADATA_KEY);
+    if (!hasOwnMetadata) {
+        return undefined;
+    }
+    return targetWithMetadata[INJECTABLE_METADATA_KEY];
+}
+
+export { getInjectableMetadata };
+//# sourceMappingURL=get.utility.js.map