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

package/dist/esm/presentation/ergonomics/decorator/injectable.decorator.js

@@ -0,0 +1,87 @@
+import '../../../domain/enum/captive-dependency-policy.enum.js';
+import { EDependencyLifecycle } from '../../../domain/enum/dependency-lifecycle.enum.js';
+import '../../../domain/enum/di-container-duplicate-provider-policy.enum.js';
+import '../../../domain/enum/logger-log-level.enum.js';
+import '../../../domain/enum/provider-type.enum.js';
+import { BaseError } from '../../../infrastructure/class/base/error.class.js';
+import { getInjectableMetadata } from '../utility/injectable-metadata/get.utility.js';
+import { setInjectableMetadata } from '../utility/injectable-metadata/set.utility.js';
+
+const DEPENDENCY_LIFECYCLE_VALUES = new Set(Object.values(EDependencyLifecycle));
+/**
+ * Class decorator that stores DI metadata without reflection dependencies.
+ * @param {IInjectableOptions} [options] Injectable metadata options.
+ * @returns {ClassDecorator} Class decorator.
+ */
+function Injectable(options = {}) {
+    validateInjectableOptions(options);
+    const decorator = (target) => {
+        const currentMetadata = getInjectableMetadata(target) ?? {};
+        const mergedMetadata = {
+            afterResolveMethod: options.afterResolveMethod ?? currentMetadata.afterResolveMethod,
+            deps: options.deps ?? currentMetadata.deps,
+            isMultiBinding: options.isMultiBinding ?? currentMetadata.isMultiBinding,
+            lifecycle: options.lifecycle ?? currentMetadata.lifecycle,
+            onDisposeMethod: options.onDisposeMethod ?? currentMetadata.onDisposeMethod,
+            onInitMethod: options.onInitMethod ?? currentMetadata.onInitMethod,
+            token: options.token ?? currentMetadata.token,
+        };
+        setInjectableMetadata(target, mergedMetadata);
+    };
+    return decorator;
+}
+/**
+ * Validates injectable decorator options.
+ * @param {IInjectableOptions} options Injectable decorator options.
+ * @returns {void}
+ */
+function validateInjectableOptions(options) {
+    const dependencies = options.deps;
+    if (dependencies !== undefined) {
+        if (!Array.isArray(dependencies)) {
+            throw new BaseError("Injectable options deps must be an array", {
+                code: "INJECTABLE_OPTIONS_DEPS_NOT_ARRAY",
+                source: "Injectable",
+            });
+        }
+        for (let dependencyIndex = 0; dependencyIndex < dependencies.length; dependencyIndex += 1) {
+            const hasDependencyAtIndex = Object.prototype.hasOwnProperty.call(dependencies, dependencyIndex);
+            if (!hasDependencyAtIndex) {
+                throw new BaseError("Injectable options deps has sparse dependency indexes", {
+                    code: "INJECTABLE_OPTIONS_DEPS_SPARSE",
+                    context: { index: dependencyIndex },
+                    source: "Injectable",
+                });
+            }
+            if (typeof dependencies[dependencyIndex] !== "symbol") {
+                throw new BaseError("Injectable options dependency token must be a symbol", {
+                    code: "INJECTABLE_OPTIONS_DEPS_TOKEN_INVALID",
+                    context: { index: dependencyIndex },
+                    source: "Injectable",
+                });
+            }
+        }
+    }
+    if (options.lifecycle !== undefined && !DEPENDENCY_LIFECYCLE_VALUES.has(options.lifecycle)) {
+        throw new BaseError("Injectable options lifecycle is invalid", {
+            code: "INJECTABLE_OPTIONS_LIFECYCLE_INVALID",
+            context: { lifecycle: options.lifecycle },
+            source: "Injectable",
+        });
+    }
+    if (options.token !== undefined && typeof options.token !== "symbol") {
+        throw new BaseError("Injectable options token must be a symbol", {
+            code: "INJECTABLE_OPTIONS_TOKEN_INVALID",
+            source: "Injectable",
+        });
+    }
+    if (options.isMultiBinding !== undefined && typeof options.isMultiBinding !== "boolean") {
+        throw new BaseError("Injectable options isMultiBinding must be a boolean", {
+            code: "INJECTABLE_OPTIONS_MULTI_BINDING_INVALID",
+            source: "Injectable",
+        });
+    }
+}
+
+export { Injectable };
+//# sourceMappingURL=injectable.decorator.js.map

package/dist/esm/presentation/ergonomics/decorator/injectable.decorator.js.map

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

package/dist/esm/presentation/ergonomics/decorator/module.decorator.d.ts

@@ -0,0 +1,8 @@
+import type { IModuleDecoratorOptions } from '../interface/index';
+/**
+ * Class decorator that stores module composition metadata.
+ * @param {IModuleDecoratorOptions} [options] Module metadata options.
+ * @returns {ClassDecorator} Class decorator.
+ */
+export declare function Module(options?: IModuleDecoratorOptions): ClassDecorator;
+//# sourceMappingURL=module.decorator.d.ts.map

package/dist/esm/presentation/ergonomics/decorator/module.decorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module.decorator.d.ts","sourceRoot":"","sources":["../../../../../src/presentation/ergonomics/decorator/module.decorator.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,oCAAoC,CAAC;AAKlF;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,OAAO,GAAE,uBAA4B,GAAG,cAAc,CAgB5E"}

package/dist/esm/presentation/ergonomics/decorator/module.decorator.js

@@ -0,0 +1,141 @@
+import { BaseError } from '../../../infrastructure/class/base/error.class.js';
+import { getModuleMetadata } from '../utility/module-metadata/get.utility.js';
+import { setModuleMetadata } from '../utility/module-metadata/set.utility.js';
+
+/**
+ * Class decorator that stores module composition metadata.
+ * @param {IModuleDecoratorOptions} [options] Module metadata options.
+ * @returns {ClassDecorator} Class decorator.
+ */
+function Module(options = {}) {
+    validateModuleDecoratorOptions(options);
+    const decorator = (target) => {
+        const currentMetadata = getModuleMetadata(target) ?? {};
+        const mergedMetadata = {
+            exports: options.exports ?? currentMetadata.exports,
+            imports: options.imports ?? currentMetadata.imports,
+            name: options.name ?? currentMetadata.name,
+            providers: options.providers ?? currentMetadata.providers,
+        };
+        setModuleMetadata(target, mergedMetadata);
+    };
+    return decorator;
+}
+/**
+ * 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";
+}
+/**
+ * Validates module decorator options.
+ * @param {IModuleDecoratorOptions} options Module decorator options.
+ */
+function validateModuleDecoratorOptions(options) {
+    validateModuleExports(options.exports);
+    validateModuleImports(options.imports);
+    validateModuleProviders(options.providers);
+}
+/**
+ * Validates module exports list.
+ * @param {ReadonlyArray<Token<unknown>> | undefined} exportTokens Export token list.
+ */
+function validateModuleExports(exportTokens) {
+    if (exportTokens === undefined) {
+        return;
+    }
+    if (!Array.isArray(exportTokens)) {
+        throw new BaseError("Module options exports must be an array", {
+            code: "MODULE_OPTIONS_EXPORTS_NOT_ARRAY",
+            source: "Module",
+        });
+    }
+    for (const exportToken of exportTokens) {
+        if (typeof exportToken !== "symbol") {
+            throw new BaseError("Module export token must be a symbol", {
+                code: "MODULE_OPTIONS_EXPORT_TOKEN_INVALID",
+                source: "Module",
+            });
+        }
+    }
+}
+/**
+ * Validates module imports list.
+ * @param {ReadonlyArray<Constructor<unknown> | IDIModule> | undefined} importEntries Import entry list.
+ */
+function validateModuleImports(importEntries) {
+    if (importEntries === undefined) {
+        return;
+    }
+    if (!Array.isArray(importEntries)) {
+        throw new BaseError("Module options imports must be an array", {
+            code: "MODULE_OPTIONS_IMPORTS_NOT_ARRAY",
+            source: "Module",
+        });
+    }
+    for (const importEntry of importEntries) {
+        if (!isConstructable(importEntry) && !isModuleDefinition(importEntry)) {
+            throw new BaseError("Module import must be a decorated module class or module definition", {
+                code: "MODULE_OPTIONS_IMPORT_INVALID",
+                source: "Module",
+            });
+        }
+    }
+}
+/**
+ * Validates module providers list.
+ * @param {ReadonlyArray<Constructor<unknown> | Provider> | undefined} providers Provider entry list.
+ */
+function validateModuleProviders(providers) {
+    if (providers === undefined) {
+        return;
+    }
+    if (!Array.isArray(providers)) {
+        throw new BaseError("Module options providers must be an array", {
+            code: "MODULE_OPTIONS_PROVIDERS_NOT_ARRAY",
+            source: "Module",
+        });
+    }
+    for (const providerEntry of providers) {
+        if (!isConstructable(providerEntry) && !isProviderDefinition(providerEntry)) {
+            throw new BaseError("Module provider must be a decorated class or provider definition", {
+                code: "MODULE_OPTIONS_PROVIDER_INVALID",
+                source: "Module",
+            });
+        }
+    }
+}
+
+export { Module };
+//# sourceMappingURL=module.decorator.js.map

package/dist/esm/presentation/ergonomics/decorator/module.decorator.js.map

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

package/dist/esm/presentation/ergonomics/decorator/on-dispose.decorator.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Method decorator that marks a class lifecycle onDispose hook.
+ * @returns {MethodDecorator} Method decorator.
+ */
+export declare function OnDispose(): MethodDecorator;
+//# sourceMappingURL=on-dispose.decorator.d.ts.map

package/dist/esm/presentation/ergonomics/decorator/on-dispose.decorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"on-dispose.decorator.d.ts","sourceRoot":"","sources":["../../../../../src/presentation/ergonomics/decorator/on-dispose.decorator.ts"],"names":[],"mappings":"AAMA;;;GAGG;AACH,wBAAgB,SAAS,IAAI,eAAe,CA+B3C"}

package/dist/esm/presentation/ergonomics/decorator/on-dispose.decorator.js

@@ -0,0 +1,39 @@
+import { BaseError } from '../../../infrastructure/class/base/error.class.js';
+import { getInjectableMetadata } from '../utility/injectable-metadata/get.utility.js';
+import { setInjectableMetadata } from '../utility/injectable-metadata/set.utility.js';
+
+/**
+ * Method decorator that marks a class lifecycle onDispose hook.
+ * @returns {MethodDecorator} Method decorator.
+ */
+function OnDispose() {
+    return (target, propertyKey, descriptor) => {
+        if (typeof propertyKey !== "string") {
+            throw new BaseError("OnDispose must target a named class method", {
+                code: "ON_DISPOSE_METHOD_NAME_INVALID",
+                source: "OnDispose",
+            });
+        }
+        if (!descriptor || typeof descriptor.value !== "function") {
+            throw new BaseError("OnDispose can only be applied to methods", {
+                code: "ON_DISPOSE_TARGET_INVALID",
+                source: "OnDispose",
+            });
+        }
+        const targetConstructor = target.constructor;
+        const metadata = getInjectableMetadata(targetConstructor) ?? {};
+        if (metadata.onDisposeMethod !== undefined && metadata.onDisposeMethod !== propertyKey) {
+            throw new BaseError("OnDispose lifecycle hook is already defined for this class", {
+                code: "ON_DISPOSE_METHOD_DUPLICATE",
+                source: "OnDispose",
+            });
+        }
+        setInjectableMetadata(targetConstructor, {
+            ...metadata,
+            onDisposeMethod: propertyKey,
+        });
+    };
+}
+
+export { OnDispose };
+//# sourceMappingURL=on-dispose.decorator.js.map

package/dist/esm/presentation/ergonomics/decorator/on-dispose.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"on-dispose.decorator.js","sources":["../../../../../../src/presentation/ergonomics/decorator/on-dispose.decorator.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;AAMA;;;AAGG;SACa,SAAS,GAAA;AACxB,IAAA,OAAO,CAAC,MAAc,EAAE,WAA4B,EAAE,UAA8B,KAAU;AAC7F,QAAA,IAAI,OAAO,WAAW,KAAK,QAAQ,EAAE;AACpC,YAAA,MAAM,IAAI,SAAS,CAAC,4CAA4C,EAAE;AACjE,gBAAA,IAAI,EAAE,gCAAgC;AACtC,gBAAA,MAAM,EAAE,WAAW;AACnB,aAAA,CAAC;QACH;QAEA,IAAI,CAAC,UAAU,IAAI,OAAO,UAAU,CAAC,KAAK,KAAK,UAAU,EAAE;AAC1D,YAAA,MAAM,IAAI,SAAS,CAAC,0CAA0C,EAAE;AAC/D,gBAAA,IAAI,EAAE,2BAA2B;AACjC,gBAAA,MAAM,EAAE,WAAW;AACnB,aAAA,CAAC;QACH;AAEA,QAAA,MAAM,iBAAiB,GAAyB,MAAM,CAAC,WAAmC;QAC1F,MAAM,QAAQ,GAAwB,qBAAqB,CAAC,iBAAiB,CAAC,IAAI,EAAE;AAEpF,QAAA,IAAI,QAAQ,CAAC,eAAe,KAAK,SAAS,IAAI,QAAQ,CAAC,eAAe,KAAK,WAAW,EAAE;AACvF,YAAA,MAAM,IAAI,SAAS,CAAC,4DAA4D,EAAE;AACjF,gBAAA,IAAI,EAAE,6BAA6B;AACnC,gBAAA,MAAM,EAAE,WAAW;AACnB,aAAA,CAAC;QACH;QAEA,qBAAqB,CAAC,iBAAiB,EAAE;AACxC,YAAA,GAAG,QAAQ;AACX,YAAA,eAAe,EAAE,WAAW;AAC5B,SAAA,CAAC;AACH,IAAA,CAAC;AACF;;;;"}

package/dist/esm/presentation/ergonomics/decorator/on-init.decorator.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Method decorator that marks a class lifecycle onInit hook.
+ * @returns {MethodDecorator} Method decorator.
+ */
+export declare function OnInit(): MethodDecorator;
+//# sourceMappingURL=on-init.decorator.d.ts.map

package/dist/esm/presentation/ergonomics/decorator/on-init.decorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"on-init.decorator.d.ts","sourceRoot":"","sources":["../../../../../src/presentation/ergonomics/decorator/on-init.decorator.ts"],"names":[],"mappings":"AAMA;;;GAGG;AACH,wBAAgB,MAAM,IAAI,eAAe,CA+BxC"}

package/dist/esm/presentation/ergonomics/decorator/on-init.decorator.js

@@ -0,0 +1,39 @@
+import { BaseError } from '../../../infrastructure/class/base/error.class.js';
+import { getInjectableMetadata } from '../utility/injectable-metadata/get.utility.js';
+import { setInjectableMetadata } from '../utility/injectable-metadata/set.utility.js';
+
+/**
+ * Method decorator that marks a class lifecycle onInit hook.
+ * @returns {MethodDecorator} Method decorator.
+ */
+function OnInit() {
+    return (target, propertyKey, descriptor) => {
+        if (typeof propertyKey !== "string") {
+            throw new BaseError("OnInit must target a named class method", {
+                code: "ON_INIT_METHOD_NAME_INVALID",
+                source: "OnInit",
+            });
+        }
+        if (!descriptor || typeof descriptor.value !== "function") {
+            throw new BaseError("OnInit can only be applied to methods", {
+                code: "ON_INIT_TARGET_INVALID",
+                source: "OnInit",
+            });
+        }
+        const targetConstructor = target.constructor;
+        const metadata = getInjectableMetadata(targetConstructor) ?? {};
+        if (metadata.onInitMethod !== undefined && metadata.onInitMethod !== propertyKey) {
+            throw new BaseError("OnInit lifecycle hook is already defined for this class", {
+                code: "ON_INIT_METHOD_DUPLICATE",
+                source: "OnInit",
+            });
+        }
+        setInjectableMetadata(targetConstructor, {
+            ...metadata,
+            onInitMethod: propertyKey,
+        });
+    };
+}
+
+export { OnInit };
+//# sourceMappingURL=on-init.decorator.js.map

package/dist/esm/presentation/ergonomics/decorator/on-init.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"on-init.decorator.js","sources":["../../../../../../src/presentation/ergonomics/decorator/on-init.decorator.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;AAMA;;;AAGG;SACa,MAAM,GAAA;AACrB,IAAA,OAAO,CAAC,MAAc,EAAE,WAA4B,EAAE,UAA8B,KAAU;AAC7F,QAAA,IAAI,OAAO,WAAW,KAAK,QAAQ,EAAE;AACpC,YAAA,MAAM,IAAI,SAAS,CAAC,yCAAyC,EAAE;AAC9D,gBAAA,IAAI,EAAE,6BAA6B;AACnC,gBAAA,MAAM,EAAE,QAAQ;AAChB,aAAA,CAAC;QACH;QAEA,IAAI,CAAC,UAAU,IAAI,OAAO,UAAU,CAAC,KAAK,KAAK,UAAU,EAAE;AAC1D,YAAA,MAAM,IAAI,SAAS,CAAC,uCAAuC,EAAE;AAC5D,gBAAA,IAAI,EAAE,wBAAwB;AAC9B,gBAAA,MAAM,EAAE,QAAQ;AAChB,aAAA,CAAC;QACH;AAEA,QAAA,MAAM,iBAAiB,GAAyB,MAAM,CAAC,WAAmC;QAC1F,MAAM,QAAQ,GAAwB,qBAAqB,CAAC,iBAAiB,CAAC,IAAI,EAAE;AAEpF,QAAA,IAAI,QAAQ,CAAC,YAAY,KAAK,SAAS,IAAI,QAAQ,CAAC,YAAY,KAAK,WAAW,EAAE;AACjF,YAAA,MAAM,IAAI,SAAS,CAAC,yDAAyD,EAAE;AAC9E,gBAAA,IAAI,EAAE,0BAA0B;AAChC,gBAAA,MAAM,EAAE,QAAQ;AAChB,aAAA,CAAC;QACH;QAEA,qBAAqB,CAAC,iBAAiB,EAAE;AACxC,YAAA,GAAG,QAAQ;AACX,YAAA,YAAY,EAAE,WAAW;AACzB,SAAA,CAAC;AACH,IAAA,CAAC;AACF;;;;"}

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

@@ -0,0 +1,4 @@
+export * from './decorator/index';
+export type * from './interface/index';
+export * from './utility/index';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/presentation/ergonomics/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,mBAAmB,aAAa,CAAC;AACjC,cAAc,WAAW,CAAC"}

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

@@ -0,0 +1,12 @@
+import type { EDependencyLifecycle } from '../../../../domain/enum/index';
+import type { Token } from '../../../../domain/type/index';
+export interface ICreateAutowireProviderOptions<T, TDependencies extends ReadonlyArray<Token<unknown>> = ReadonlyArray<Token<unknown>>> {
+    afterResolve?(instance: T): Promise<void> | void;
+    deps?: TDependencies;
+    isMultiBinding?: boolean;
+    lifecycle?: EDependencyLifecycle;
+    onDispose?(instance: T): Promise<void> | void;
+    onInit?(instance: T): Promise<void> | void;
+    token: Token<T>;
+}
+//# sourceMappingURL=autowire-provider-options.interface.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"autowire-provider-options.interface.d.ts","sourceRoot":"","sources":["../../../../../../src/presentation/ergonomics/interface/create/autowire-provider-options.interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACzD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAE1C,MAAM,WAAW,8BAA8B,CAAC,CAAC,EAAE,aAAa,SAAS,aAAa,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,GAAG,aAAa,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACrI,YAAY,CAAC,CAAC,QAAQ,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACjD,IAAI,CAAC,EAAE,aAAa,CAAC;IACrB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,SAAS,CAAC,EAAE,oBAAoB,CAAC;IACjC,SAAS,CAAC,CAAC,QAAQ,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC9C,MAAM,CAAC,CAAC,QAAQ,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC3C,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;CAChB"}

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

@@ -0,0 +1,3 @@
+export type { ICreateAutowireProviderOptions } from './autowire-provider-options.interface';
+export type { ICreateModuleOptions } from './module-options.interface';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/presentation/ergonomics/interface/create/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,8BAA8B,EAAE,MAAM,uCAAuC,CAAC;AAC5F,YAAY,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/esm/presentation/ergonomics/interface/create/module-options.interface.d.ts

@@ -0,0 +1,9 @@
+import type { IDIModule } from '../../../../domain/interface/index';
+import type { Provider, Token } from '../../../../domain/type/index';
+export interface ICreateModuleOptions {
+    exports?: ReadonlyArray<Token<unknown>>;
+    imports?: ReadonlyArray<IDIModule>;
+    name?: string;
+    providers?: ReadonlyArray<Provider>;
+}
+//# sourceMappingURL=module-options.interface.d.ts.map

package/dist/esm/presentation/ergonomics/interface/create/module-options.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module-options.interface.d.ts","sourceRoot":"","sources":["../../../../../../src/presentation/ergonomics/interface/create/module-options.interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAEpD,MAAM,WAAW,oBAAoB;IACpC,OAAO,CAAC,EAAE,aAAa,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;IACxC,OAAO,CAAC,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC;IACnC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;CACpC"}

package/dist/esm/presentation/ergonomics/interface/decorator/index.d.ts

@@ -0,0 +1,2 @@
+export type { IModuleDecoratorOptions } from './module-options.interface';
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/presentation/ergonomics/interface/decorator/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/presentation/ergonomics/interface/decorator/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/esm/presentation/ergonomics/interface/decorator/module-options.interface.d.ts

@@ -0,0 +1,9 @@
+import type { IDIModule } from '../../../../domain/interface/index';
+import type { Constructor, Provider, Token } from '../../../../domain/type/index';
+export interface IModuleDecoratorOptions {
+    exports?: ReadonlyArray<Token<unknown>>;
+    imports?: ReadonlyArray<Constructor<unknown> | IDIModule>;
+    name?: string;
+    providers?: ReadonlyArray<Constructor<unknown> | Provider>;
+}
+//# sourceMappingURL=module-options.interface.d.ts.map

package/dist/esm/presentation/ergonomics/interface/decorator/module-options.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module-options.interface.d.ts","sourceRoot":"","sources":["../../../../../../src/presentation/ergonomics/interface/decorator/module-options.interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAEjE,MAAM,WAAW,uBAAuB;IACvC,OAAO,CAAC,EAAE,aAAa,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;IACxC,OAAO,CAAC,EAAE,aAAa,CAAC,WAAW,CAAC,OAAO,CAAC,GAAG,SAAS,CAAC,CAAC;IAC1D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,aAAa,CAAC,WAAW,CAAC,OAAO,CAAC,GAAG,QAAQ,CAAC,CAAC;CAC3D"}

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

@@ -0,0 +1,4 @@
+export type * from './create/index';
+export type * from './decorator/index';
+export type * from './injectable/index';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/presentation/ergonomics/interface/index.ts"],"names":[],"mappings":"AAAA,mBAAmB,UAAU,CAAC;AAC9B,mBAAmB,aAAa,CAAC;AACjC,mBAAmB,cAAc,CAAC"}

package/dist/esm/presentation/ergonomics/interface/injectable/index.d.ts

@@ -0,0 +1,3 @@
+export type { IInjectableMetadata } from './metadata.interface';
+export type { IInjectableOptions } from './options.interface';
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/presentation/ergonomics/interface/injectable/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/presentation/ergonomics/interface/injectable/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAChE,YAAY,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/esm/presentation/ergonomics/interface/injectable/metadata.interface.d.ts

@@ -0,0 +1,12 @@
+import type { EDependencyLifecycle } from '../../../../domain/enum/index';
+import type { Token } from '../../../../domain/type/index';
+export interface IInjectableMetadata {
+    afterResolveMethod?: string;
+    deps?: ReadonlyArray<Token<unknown>>;
+    isMultiBinding?: boolean;
+    lifecycle?: EDependencyLifecycle;
+    onDisposeMethod?: string;
+    onInitMethod?: string;
+    token?: Token<unknown>;
+}
+//# sourceMappingURL=metadata.interface.d.ts.map

package/dist/esm/presentation/ergonomics/interface/injectable/metadata.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.interface.d.ts","sourceRoot":"","sources":["../../../../../../src/presentation/ergonomics/interface/injectable/metadata.interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACzD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAE1C,MAAM,WAAW,mBAAmB;IACnC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,IAAI,CAAC,EAAE,aAAa,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;IACrC,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,SAAS,CAAC,EAAE,oBAAoB,CAAC;IACjC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;CACvB"}

package/dist/esm/presentation/ergonomics/interface/injectable/options.interface.d.ts

@@ -0,0 +1,4 @@
+import type { IInjectableMetadata } from './metadata.interface';
+type TInjectableOptions = IInjectableMetadata;
+export type { TInjectableOptions as IInjectableOptions };
+//# sourceMappingURL=options.interface.d.ts.map

package/dist/esm/presentation/ergonomics/interface/injectable/options.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.interface.d.ts","sourceRoot":"","sources":["../../../../../../src/presentation/ergonomics/interface/injectable/options.interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAEhE,KAAK,kBAAkB,GAAG,mBAAmB,CAAC;AAE9C,YAAY,EAAE,kBAAkB,IAAI,kBAAkB,EAAE,CAAC"}

package/dist/esm/presentation/ergonomics/utility/compose-decorated-modules.utility.d.ts

@@ -0,0 +1,9 @@
+import type { IDIModule } from '../../../domain/interface/index';
+import type { Constructor, IDIContainer } from '../../../domain/type/index';
+/**
+ * Composes module graph from mixed decorated module classes and plain module definitions.
+ * @param {IDIContainer} container Target container.
+ * @param {Array<Constructor<unknown> | IDIModule>} modules Decorated module classes or plain module definitions.
+ */
+export declare function composeDecoratedModules(container: IDIContainer, modules: Array<Constructor<unknown> | IDIModule>): void;
+//# sourceMappingURL=compose-decorated-modules.utility.d.ts.map

package/dist/esm/presentation/ergonomics/utility/compose-decorated-modules.utility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compose-decorated-modules.utility.d.ts","sourceRoot":"","sources":["../../../../../src/presentation/ergonomics/utility/compose-decorated-modules.utility.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAO9D;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,YAAY,EAAE,OAAO,EAAE,KAAK,CAAC,WAAW,CAAC,OAAO,CAAC,GAAG,SAAS,CAAC,GAAG,IAAI,CAGvH"}

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

@@ -0,0 +1,61 @@
+import { BaseError } from '../../../infrastructure/class/base/error.class.js';
+import { composeModules } from './compose-modules.utility.js';
+import { createModuleFromDecorator } from './create/module-from-decorator.utility.js';
+
+/**
+ * Composes module graph from mixed decorated module classes and plain module definitions.
+ * @param {IDIContainer} container Target container.
+ * @param {Array<Constructor<unknown> | IDIModule>} modules Decorated module classes or plain module definitions.
+ */
+function composeDecoratedModules(container, modules) {
+    const resolvedModules = modules.map((moduleEntry) => resolveModuleDefinition(moduleEntry));
+    composeModules(container, resolvedModules);
+}
+/**
+ * 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);
+}
+/**
+ * Resolves a module entry to plain module definition.
+ * @param {Constructor<unknown> | IDIModule} moduleEntry Module entry.
+ * @returns {IDIModule} Plain module definition.
+ */
+function resolveModuleDefinition(moduleEntry) {
+    if (isModuleDefinition(moduleEntry)) {
+        return moduleEntry;
+    }
+    if (isConstructable(moduleEntry)) {
+        return createModuleFromDecorator(moduleEntry);
+    }
+    throw new BaseError("Module entry must be a decorated module class or module definition", {
+        code: "MODULE_ENTRY_INVALID",
+        context: {
+            entryType: typeof moduleEntry,
+        },
+        source: "composeDecoratedModules",
+    });
+}
+
+export { composeDecoratedModules };
+//# sourceMappingURL=compose-decorated-modules.utility.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"compose-decorated-modules.utility.js","sources":["../../../../../../src/presentation/ergonomics/utility/compose-decorated-modules.utility.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;AAQA;;;;AAIG;AACG,SAAU,uBAAuB,CAAC,SAAuB,EAAE,OAAgD,EAAA;AAChH,IAAA,MAAM,eAAe,GAAqB,OAAO,CAAC,GAAG,CAAC,CAAC,WAA6C,KAAK,uBAAuB,CAAC,WAAW,CAAC,CAAC;AAC9I,IAAA,cAAc,CAAC,SAAS,EAAE,eAAe,CAAC;AAC3C;AAEA;;;;AAIG;AACH,SAAS,eAAe,CAAC,SAAkB,EAAA;AAC1C,IAAA,IAAI,OAAO,SAAS,KAAK,UAAU,EAAE;AACpC,QAAA,OAAO,KAAK;IACb;IAEA,MAAM,sBAAsB,GAA8C,SAAsD;AAChI,IAAA,MAAM,SAAS,GAA0C,sBAAsB,CAAC,SAAS;IAEzF,OAAO,CAAC,CAAC,SAAS,IAAI,SAAS,CAAC,WAAW,KAAK,SAAS;AAC1D;AAEA;;;;AAIG;AACH,SAAS,kBAAkB,CAAC,SAAkB,EAAA;IAC7C,IAAI,OAAO,SAAS,KAAK,QAAQ,IAAI,SAAS,KAAK,IAAI,EAAE;AACxD,QAAA,OAAO,KAAK;IACb;IAEA,MAAM,eAAe,GAIjB,SAIH;IAED,OAAO,KAAK,CAAC,OAAO,CAAC,eAAe,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,eAAe,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,eAAe,CAAC,SAAS,CAAC;AACpI;AAEA;;;;AAIG;AACH,SAAS,uBAAuB,CAAC,WAA6C,EAAA;AAC7E,IAAA,IAAI,kBAAkB,CAAC,WAAW,CAAC,EAAE;AACpC,QAAA,OAAO,WAAW;IACnB;AAEA,IAAA,IAAI,eAAe,CAAC,WAAW,CAAC,EAAE;AACjC,QAAA,OAAO,yBAAyB,CAAC,WAAW,CAAC;IAC9C;AAEA,IAAA,MAAM,IAAI,SAAS,CAAC,oEAAoE,EAAE;AACzF,QAAA,IAAI,EAAE,sBAAsB;AAC5B,QAAA,OAAO,EAAE;YACR,SAAS,EAAE,OAAO,WAAW;AAC7B,SAAA;AACD,QAAA,MAAM,EAAE,yBAAyB;AACjC,KAAA,CAAC;AACH;;;;"}

package/dist/esm/presentation/ergonomics/utility/compose-modules.utility.d.ts

@@ -0,0 +1,10 @@
+import type { IDIModule } from '../../../domain/interface/index';
+import type { IDIContainer } from '../../../domain/type/index';
+/**
+ * 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.
+ */
+export declare function composeModules(container: IDIContainer, modules: Array<IDIModule>): void;
+//# sourceMappingURL=compose-modules.utility.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"compose-modules.utility.d.ts","sourceRoot":"","sources":["../../../../../src/presentation/ergonomics/utility/compose-modules.utility.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,KAAK,EAAE,YAAY,EAAmB,MAAM,cAAc,CAAC;AAalE;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,YAAY,EAAE,OAAO,EAAE,KAAK,CAAC,SAAS,CAAC,GAAG,IAAI,CA6DvF"}