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

package/dist/esm/infrastructure/class/di/cache/coordinator.class.js

@@ -0,0 +1,124 @@
+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';
+
+class CacheCoordinator {
+    clearScopedCachesRecursivelyForCacheKeys(cacheKeys, providerKey, scope, getChildScopes, getScopedCache, hasLocalProvider) {
+        const scopedCache = getScopedCache(scope);
+        for (const cacheKey of cacheKeys) {
+            scopedCache.delete(cacheKey);
+        }
+        for (const childScope of getChildScopes(scope)) {
+            if (hasLocalProvider(childScope, providerKey)) {
+                continue;
+            }
+            this.clearScopedCachesRecursivelyForCacheKeys(cacheKeys, providerKey, childScope, getChildScopes, getScopedCache, hasLocalProvider);
+        }
+    }
+    getOrCreateSingletonOwnerCache(rootSingletonCache, ownerScope) {
+        const existingOwnerCache = rootSingletonCache.get(ownerScope);
+        if (existingOwnerCache) {
+            return existingOwnerCache;
+        }
+        const ownerCache = new Map();
+        rootSingletonCache.set(ownerScope, ownerCache);
+        return ownerCache;
+    }
+    getRootSingletonCacheSize(rootSingletonCache) {
+        let totalEntries = 0;
+        for (const ownerCache of rootSingletonCache.values()) {
+            totalEntries += ownerCache.size;
+        }
+        return totalEntries;
+    }
+    getScopedCacheForLifecycle(lifecycle, requestScopedCache, rootSingletonCache, providerOwner) {
+        if (lifecycle === EDependencyLifecycle.SINGLETON) {
+            return this.getOrCreateSingletonOwnerCache(rootSingletonCache, providerOwner);
+        }
+        if (lifecycle === EDependencyLifecycle.SCOPED) {
+            return requestScopedCache;
+        }
+        return undefined;
+    }
+    hasScopedCacheForLookup(lookup, scopedCache, dependencyKey) {
+        const registrations = lookup.registrations ?? [];
+        if (registrations.length === 0) {
+            return scopedCache.has(dependencyKey);
+        }
+        let hasScopedRegistration = false;
+        for (const registration of registrations) {
+            if (registration.lifecycle !== EDependencyLifecycle.SCOPED) {
+                continue;
+            }
+            hasScopedRegistration = true;
+            if (scopedCache.has(registration.cacheKey)) {
+                return true;
+            }
+        }
+        if (hasScopedRegistration) {
+            return false;
+        }
+        return scopedCache.has(dependencyKey);
+    }
+    hasSingletonCacheForAnyOwner(rootSingletonCache, dependencyKey, getRegistrationsForOwner) {
+        for (const [ownerScope, ownerCache] of rootSingletonCache.entries()) {
+            if (ownerCache.has(dependencyKey)) {
+                return true;
+            }
+            const registrations = getRegistrationsForOwner(ownerScope, dependencyKey);
+            if (!registrations) {
+                continue;
+            }
+            for (const registration of registrations) {
+                if (ownerCache.has(registration.cacheKey)) {
+                    return true;
+                }
+            }
+        }
+        return false;
+    }
+    hasSingletonCacheForOwner(rootSingletonCache, ownerScope, registrations) {
+        const ownerCache = rootSingletonCache.get(ownerScope);
+        if (!ownerCache || !registrations || registrations.length === 0) {
+            return false;
+        }
+        for (const registration of registrations) {
+            if (ownerCache.has(registration.cacheKey)) {
+                return true;
+            }
+        }
+        return false;
+    }
+    removeSingletonCacheForOwnerCacheKeys(rootSingletonCache, ownerScope, cacheKeys) {
+        const ownerCache = rootSingletonCache.get(ownerScope);
+        if (!ownerCache) {
+            return;
+        }
+        for (const cacheKey of cacheKeys) {
+            ownerCache.delete(cacheKey);
+        }
+        if (ownerCache.size === 0) {
+            rootSingletonCache.delete(ownerScope);
+        }
+    }
+    removeSingletonCacheForOwnerRegistrations(rootSingletonCache, ownerScope, ownerRegistrationsByToken) {
+        const singletonCacheKeys = [];
+        for (const registrations of ownerRegistrationsByToken.values()) {
+            for (const registration of registrations) {
+                if (registration.lifecycle !== EDependencyLifecycle.SINGLETON) {
+                    continue;
+                }
+                singletonCacheKeys.push(registration.cacheKey);
+            }
+        }
+        if (singletonCacheKeys.length === 0) {
+            return;
+        }
+        this.removeSingletonCacheForOwnerCacheKeys(rootSingletonCache, ownerScope, singletonCacheKeys);
+    }
+}
+
+export { CacheCoordinator };
+//# sourceMappingURL=coordinator.class.js.map

package/dist/esm/infrastructure/class/di/cache/coordinator.class.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"coordinator.class.js","sources":["../../../../../../../src/infrastructure/class/di/cache/coordinator.class.ts"],"sourcesContent":[null],"names":["EDependencyLifecycleEnum"],"mappings":"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"}

package/dist/esm/infrastructure/class/di/captive/coordinator.class.d.ts

@@ -0,0 +1,17 @@
+import type { ILogger } from '../../../../domain/interface/index';
+import type { Token } from '../../../../domain/type/index';
+import type { IProviderLookup, IProviderRegistration } from '../interface/provider/index';
+import { EDependencyLifecycle, EDiContainerCaptiveDependencyPolicy } from '../../../../domain/enum/index';
+export declare class CaptiveDependencyCoordinator {
+    private readonly CAPTIVE_DEPENDENCY_POLICY;
+    private readonly LOGGER;
+    private readonly STRINGIFY_KEY;
+    constructor(options: {
+        captiveDependencyPolicy: EDiContainerCaptiveDependencyPolicy;
+        logger: ILogger;
+        stringifyKey: (dependencyKeySymbol: symbol) => string;
+    });
+    handleCaptiveDependency(parentDependencyKeySymbol: symbol, dependencyKeySymbol: symbol, dependencyLifecycle: EDependencyLifecycle, scopeId: string): void;
+    validateCaptiveDependency<TScope extends object>(parentRegistration: IProviderRegistration<unknown>, dependencyKey: Token<unknown>, resolutionScope: TScope, assertKey: <T>(dependencyKey: Token<T>) => symbol, findProviderInScope: (scope: TScope, dependencyKeySymbol: symbol) => IProviderLookup<TScope>, scopeId: string): void;
+}
+//# sourceMappingURL=coordinator.class.d.ts.map

package/dist/esm/infrastructure/class/di/captive/coordinator.class.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coordinator.class.d.ts","sourceRoot":"","sources":["../../../../../../src/infrastructure/class/di/captive/coordinator.class.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,KAAK,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,6CAA6C,CAAC;AAE1G,OAAO,EAAE,oBAAoB,EAAE,mCAAmC,EAAE,MAAM,cAAc,CAAC;AAGzF,qBAAa,4BAA4B;IACxC,OAAO,CAAC,QAAQ,CAAC,yBAAyB,CAAsC;IAEhF,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAU;IAEjC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA0C;gBAE5D,OAAO,EAAE;QAAE,uBAAuB,EAAE,mCAAmC,CAAC;QAAC,MAAM,EAAE,OAAO,CAAC;QAAC,YAAY,EAAE,CAAC,mBAAmB,EAAE,MAAM,KAAK,MAAM,CAAA;KAAE;IAMtJ,uBAAuB,CAAC,yBAAyB,EAAE,MAAM,EAAE,mBAAmB,EAAE,MAAM,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAgCzJ,yBAAyB,CAAC,MAAM,SAAS,MAAM,EAAE,kBAAkB,EAAE,qBAAqB,CAAC,OAAO,CAAC,EAAE,aAAa,EAAE,KAAK,CAAC,OAAO,CAAC,EAAE,eAAe,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC,EAAE,aAAa,EAAE,KAAK,CAAC,CAAC,CAAC,KAAK,MAAM,EAAE,mBAAmB,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,mBAAmB,EAAE,MAAM,KAAK,eAAe,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;CAe3U"}

package/dist/esm/infrastructure/class/di/captive/coordinator.class.js

@@ -0,0 +1,60 @@
+import { EDiContainerCaptiveDependencyPolicy } from '../../../../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 '../../base/error.class.js';
+
+class CaptiveDependencyCoordinator {
+    CAPTIVE_DEPENDENCY_POLICY;
+    LOGGER;
+    STRINGIFY_KEY;
+    constructor(options) {
+        this.CAPTIVE_DEPENDENCY_POLICY = options.captiveDependencyPolicy;
+        this.LOGGER = options.logger;
+        this.STRINGIFY_KEY = options.stringifyKey;
+    }
+    handleCaptiveDependency(parentDependencyKeySymbol, dependencyKeySymbol, dependencyLifecycle, scopeId) {
+        if (this.CAPTIVE_DEPENDENCY_POLICY === EDiContainerCaptiveDependencyPolicy.DISABLED) {
+            return;
+        }
+        const parentTokenDescription = this.STRINGIFY_KEY(parentDependencyKeySymbol);
+        const dependencyTokenDescription = this.STRINGIFY_KEY(dependencyKeySymbol);
+        const warningMessage = `Singleton provider ${parentTokenDescription} depends on ${dependencyLifecycle} provider ${dependencyTokenDescription}`;
+        if (this.CAPTIVE_DEPENDENCY_POLICY === EDiContainerCaptiveDependencyPolicy.ERROR) {
+            throw new BaseError("Singleton provider depends on non-singleton provider", {
+                code: "CAPTIVE_DEPENDENCY",
+                context: {
+                    dependencyLifecycle,
+                    dependencyToken: dependencyTokenDescription,
+                    providerToken: parentTokenDescription,
+                    scopeId,
+                },
+                source: "DIContainer",
+            });
+        }
+        this.LOGGER.warn(warningMessage, {
+            context: {
+                dependencyLifecycle,
+                dependencyToken: dependencyTokenDescription,
+                providerToken: parentTokenDescription,
+            },
+            source: "DIContainer",
+        });
+    }
+    validateCaptiveDependency(parentRegistration, dependencyKey, resolutionScope, assertKey, findProviderInScope, scopeId) {
+        if (parentRegistration.lifecycle !== EDependencyLifecycle.SINGLETON) {
+            return;
+        }
+        const dependencyKeySymbol = assertKey(dependencyKey);
+        const dependencyLookup = findProviderInScope(resolutionScope, dependencyKeySymbol);
+        const dependencyRegistration = dependencyLookup.registration;
+        if (!dependencyRegistration || dependencyRegistration.lifecycle === EDependencyLifecycle.SINGLETON) {
+            return;
+        }
+        this.handleCaptiveDependency(assertKey(parentRegistration.provider.provide), dependencyKeySymbol, dependencyRegistration.lifecycle, scopeId);
+    }
+}
+
+export { CaptiveDependencyCoordinator };
+//# sourceMappingURL=coordinator.class.js.map

package/dist/esm/infrastructure/class/di/captive/coordinator.class.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"coordinator.class.js","sources":["../../../../../../../src/infrastructure/class/di/captive/coordinator.class.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;;;;MAOa,4BAA4B,CAAA;AACvB,IAAA,yBAAyB;AAEzB,IAAA,MAAM;AAEN,IAAA,aAAa;AAE9B,IAAA,WAAA,CAAY,OAAiJ,EAAA;AAC5J,QAAA,IAAI,CAAC,yBAAyB,GAAG,OAAO,CAAC,uBAAuB;AAChE,QAAA,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM;AAC5B,QAAA,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC,YAAY;IAC1C;AAEO,IAAA,uBAAuB,CAAC,yBAAiC,EAAE,mBAA2B,EAAE,mBAAyC,EAAE,OAAe,EAAA;QACxJ,IAAI,IAAI,CAAC,yBAAyB,KAAK,mCAAmC,CAAC,QAAQ,EAAE;YACpF;QACD;QAEA,MAAM,sBAAsB,GAAW,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC;QACpF,MAAM,0BAA0B,GAAW,IAAI,CAAC,aAAa,CAAC,mBAAmB,CAAC;QAClF,MAAM,cAAc,GAAW,CAAA,mBAAA,EAAsB,sBAAsB,eAAe,mBAAmB,CAAA,UAAA,EAAa,0BAA0B,CAAA,CAAE;QAEtJ,IAAI,IAAI,CAAC,yBAAyB,KAAK,mCAAmC,CAAC,KAAK,EAAE;AACjF,YAAA,MAAM,IAAI,SAAS,CAAC,sDAAsD,EAAE;AAC3E,gBAAA,IAAI,EAAE,oBAAoB;AAC1B,gBAAA,OAAO,EAAE;oBACR,mBAAmB;AACnB,oBAAA,eAAe,EAAE,0BAA0B;AAC3C,oBAAA,aAAa,EAAE,sBAAsB;oBACrC,OAAO;AACP,iBAAA;AACD,gBAAA,MAAM,EAAE,aAAa;AACrB,aAAA,CAAC;QACH;AAEA,QAAA,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,cAAc,EAAE;AAChC,YAAA,OAAO,EAAE;gBACR,mBAAmB;AACnB,gBAAA,eAAe,EAAE,0BAA0B;AAC3C,gBAAA,aAAa,EAAE,sBAAsB;AACrC,aAAA;AACD,YAAA,MAAM,EAAE,aAAa;AACrB,SAAA,CAAC;IACH;IAEO,yBAAyB,CAAwB,kBAAkD,EAAE,aAA6B,EAAE,eAAuB,EAAE,SAAiD,EAAE,mBAA4F,EAAE,OAAe,EAAA;QACnU,IAAI,kBAAkB,CAAC,SAAS,KAAK,oBAAoB,CAAC,SAAS,EAAE;YACpE;QACD;AAEA,QAAA,MAAM,mBAAmB,GAAW,SAAS,CAAC,aAAa,CAAC;QAC5D,MAAM,gBAAgB,GAA4B,mBAAmB,CAAC,eAAe,EAAE,mBAAmB,CAAC;AAC3G,QAAA,MAAM,sBAAsB,GAA+C,gBAAgB,CAAC,YAAY;QAExG,IAAI,CAAC,sBAAsB,IAAI,sBAAsB,CAAC,SAAS,KAAK,oBAAoB,CAAC,SAAS,EAAE;YACnG;QACD;QAEA,IAAI,CAAC,uBAAuB,CAAC,SAAS,CAAC,kBAAkB,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,mBAAmB,EAAE,sBAAsB,CAAC,SAAS,EAAE,OAAO,CAAC;IAC7I;AACA;;;;"}

package/dist/esm/infrastructure/class/di/container.class.d.ts

@@ -0,0 +1,75 @@
+import type { IContainerSnapshot, IDependencyGraph, IDIScopeCreateOptions, IResolutionExplanation } from '../../../domain/interface/index';
+import type { IDIContainer, Provider, Token } from '../../../domain/type/index';
+import type { IInternalContainerOptions } from './interface/internal-container-options.interface';
+/**
+ * Advanced DI container with scoped and async resolution support.
+ */
+export declare class DIContainer implements IDIContainer {
+    id: string;
+    get isLocked(): boolean;
+    private readonly ASYNC_RESOLUTION_DRAIN_TIMEOUT_MS?;
+    private readonly CACHE_COORDINATOR;
+    private readonly CAPTIVE_DEPENDENCY_POLICY;
+    private readonly CHILD_SCOPES;
+    private readonly DEPENDENCY_GRAPH_COORDINATOR;
+    private readonly DISPOSAL_COORDINATOR;
+    private readonly DISPOSAL_MANAGER;
+    private disposePromise?;
+    private readonly DISPOSER_COORDINATOR;
+    private readonly DISPOSERS;
+    private readonly DISPOSERS_BY_TOKEN;
+    private readonly DUPLICATE_PROVIDER_POLICY;
+    private isDisposed;
+    private isDisposing;
+    private isScopeLocked;
+    private readonly LOGGER;
+    private readonly LOOKUP_COORDINATOR;
+    private readonly PARENT?;
+    private readonly PENDING_PROVIDER_CLEANUPS;
+    private readonly PROVIDERS;
+    private readonly REGISTRATION_COORDINATOR;
+    private readonly RESOLUTION_COORDINATOR;
+    private readonly RESOLUTION_ENGINE;
+    private readonly RESOLVE_INTERCEPTOR_DISPATCHER;
+    private readonly RESOLVE_INTERCEPTORS;
+    private readonly ROOT;
+    private readonly ROOT_SCOPE_COUNTER;
+    private readonly ROOT_SINGLETON_CACHE;
+    private readonly SCOPED_CACHE;
+    constructor(options?: IInternalContainerOptions);
+    bootstrap(tokens?: ReadonlyArray<Token<unknown>>): Promise<void>;
+    createScope(name?: string, options?: IDIScopeCreateOptions): DIContainer;
+    dispose(): Promise<void>;
+    explain<T>(token: Token<T>): IResolutionExplanation;
+    exportGraph(): IDependencyGraph;
+    getRegisteredTokens(): Array<Token<unknown>>;
+    has(token: Token<unknown>): boolean;
+    lock(): void;
+    register(providerOrProviders: Array<Provider> | Provider): void;
+    resolve<T>(token: Token<T>): T;
+    resolveAll<T>(token: Token<T>): Array<T>;
+    resolveAllAsync<T>(token: Token<T>): Promise<Array<T>>;
+    resolveAsync<T>(token: Token<T>): Promise<T>;
+    resolveOptional<T>(token: Token<T>): T | undefined;
+    resolveOptionalAsync<T>(token: Token<T>): Promise<T | undefined>;
+    snapshot(): IContainerSnapshot;
+    unregister<T>(token: Token<T>): Promise<boolean>;
+    validate(): void;
+    private assertToken;
+    private collectCacheKeys;
+    private describeToken;
+    private disposeInternal;
+    private ensureActive;
+    private ensureNotDisposing;
+    private ensureNotLocked;
+    private getProviderRegistrationCount;
+    private getSingletonProviderTokens;
+    private hasAsyncCleanupHooks;
+    private hasTrackedDisposersForTokenRecursively;
+    private isProviderCleanupPending;
+    private isRegistrationCurrent;
+    private logProviderCleanupFailure;
+    private queueProviderCleanup;
+    private waitForProviderCleanup;
+}
+//# sourceMappingURL=container.class.d.ts.map

package/dist/esm/infrastructure/class/di/container.class.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"container.class.d.ts","sourceRoot":"","sources":["../../../../../src/infrastructure/class/di/container.class.ts"],"names":[],"mappings":"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"}