@expressots/core 3.0.0 → 4.0.0-preview.1

package/lib/esm/di/container/container.js

@@ -0,0 +1,505 @@
+import { Binding } from "../bindings/binding.js";
+import * as ERROR_MSGS from "../constants/error_msgs.js";
+import { Scope, TargetTypeEnum } from "../constants/literal_types.js";
+import * as METADATA_KEY from "../constants/metadata_keys.js";
+import { MetadataReader } from "../planning/metadata_reader.js";
+import { createMockRequest, getBindingDictionary, plan, } from "../planning/planner.js";
+import { resolve } from "../resolution/resolver.js";
+import { BindingToSyntax } from "../syntax/binding_to_syntax.js";
+import { isPromise, isPromiseOrContainsPromise } from "../utils/async.js";
+import { id } from "../utils/id.js";
+import { getServiceIdentifierAsString } from "../utils/serialization.js";
+import { ContainerSnapshot } from "./container_snapshot.js";
+import { Lookup } from "./lookup.js";
+import { ModuleActivationStore } from "./module_activation_store.js";
+class Container {
+    id;
+    parent;
+    options;
+    _middleware;
+    _bindingDictionary;
+    _activations;
+    _deactivations;
+    _snapshots;
+    _metadataReader;
+    _moduleActivationStore;
+    static merge(container1, container2, ...containers) {
+        const container = new Container();
+        const targetContainers = [container1, container2, ...containers].map((targetContainer) => getBindingDictionary(targetContainer));
+        const bindingDictionary = getBindingDictionary(container);
+        function copyDictionary(origin, destination) {
+            origin.traverse((_key, value) => {
+                value.forEach((binding) => {
+                    destination.add(binding.serviceIdentifier, binding.clone());
+                });
+            });
+        }
+        targetContainers.forEach((targetBindingDictionary) => {
+            copyDictionary(targetBindingDictionary, bindingDictionary);
+        });
+        return container;
+    }
+    constructor(containerOptions) {
+        const options = containerOptions || {};
+        if (typeof options !== "object") {
+            throw new Error(`${ERROR_MSGS.CONTAINER_OPTIONS_MUST_BE_AN_OBJECT}`);
+        }
+        if (options.defaultScope === undefined) {
+            options.defaultScope = Scope.Transient;
+        }
+        else if (options.defaultScope !== Scope.Singleton &&
+            options.defaultScope !== Scope.Transient &&
+            options.defaultScope !== Scope.Request) {
+            throw new Error(`${ERROR_MSGS.CONTAINER_OPTIONS_INVALID_DEFAULT_SCOPE}`);
+        }
+        if (options.autoBindInjectable === undefined) {
+            options.autoBindInjectable = false;
+        }
+        else if (typeof options.autoBindInjectable !== "boolean") {
+            throw new Error(`${ERROR_MSGS.CONTAINER_OPTIONS_INVALID_AUTO_BIND_INJECTABLE}`);
+        }
+        if (options.skipBaseClassChecks === undefined) {
+            options.skipBaseClassChecks = false;
+        }
+        else if (typeof options.skipBaseClassChecks !== "boolean") {
+            throw new Error(`${ERROR_MSGS.CONTAINER_OPTIONS_INVALID_SKIP_BASE_CHECK}`);
+        }
+        this.options = {
+            autoBindInjectable: options.autoBindInjectable,
+            defaultScope: options.defaultScope,
+            skipBaseClassChecks: options.skipBaseClassChecks,
+        };
+        this.id = id();
+        this._bindingDictionary = new Lookup();
+        this._snapshots = [];
+        this._middleware = null;
+        this._activations = new Lookup();
+        this._deactivations = new Lookup();
+        this.parent = null;
+        this._metadataReader = new MetadataReader();
+        this._moduleActivationStore = new ModuleActivationStore();
+    }
+    load(...modules) {
+        const getHelpers = this._getContainerModuleHelpersFactory();
+        for (const currentModule of modules) {
+            const containerModuleHelpers = getHelpers(currentModule.id);
+            currentModule.registry(containerModuleHelpers.bindFunction, containerModuleHelpers.unbindFunction, containerModuleHelpers.isboundFunction, containerModuleHelpers.rebindFunction, containerModuleHelpers.unbindAsyncFunction, containerModuleHelpers.onActivationFunction, containerModuleHelpers.onDeactivationFunction);
+        }
+    }
+    async loadAsync(...modules) {
+        const getHelpers = this._getContainerModuleHelpersFactory();
+        for (const currentModule of modules) {
+            const containerModuleHelpers = getHelpers(currentModule.id);
+            await currentModule.registry(containerModuleHelpers.bindFunction, containerModuleHelpers.unbindFunction, containerModuleHelpers.isboundFunction, containerModuleHelpers.rebindFunction, containerModuleHelpers.unbindAsyncFunction, containerModuleHelpers.onActivationFunction, containerModuleHelpers.onDeactivationFunction);
+        }
+    }
+    unload(...modules) {
+        modules.forEach((module) => {
+            const deactivations = this._removeModuleBindings(module.id);
+            this._deactivateSingletons(deactivations);
+            this._removeModuleHandlers(module.id);
+        });
+    }
+    async unloadAsync(...modules) {
+        for (const module of modules) {
+            const deactivations = this._removeModuleBindings(module.id);
+            await this._deactivateSingletonsAsync(deactivations);
+            this._removeModuleHandlers(module.id);
+        }
+    }
+    // Registers a type binding
+    bind(serviceIdentifier) {
+        const scope = this.options.defaultScope || Scope.Transient;
+        const binding = new Binding(serviceIdentifier, scope);
+        this._bindingDictionary.add(serviceIdentifier, binding);
+        return new BindingToSyntax(binding);
+    }
+    rebind(serviceIdentifier) {
+        this.unbind(serviceIdentifier);
+        return this.bind(serviceIdentifier);
+    }
+    async rebindAsync(serviceIdentifier) {
+        await this.unbindAsync(serviceIdentifier);
+        return this.bind(serviceIdentifier);
+    }
+    // Removes a type binding from the registry by its key
+    unbind(serviceIdentifier) {
+        if (this._bindingDictionary.hasKey(serviceIdentifier)) {
+            const bindings = this._bindingDictionary.get(serviceIdentifier);
+            this._deactivateSingletons(bindings);
+        }
+        this._removeServiceFromDictionary(serviceIdentifier);
+    }
+    async unbindAsync(serviceIdentifier) {
+        if (this._bindingDictionary.hasKey(serviceIdentifier)) {
+            const bindings = this._bindingDictionary.get(serviceIdentifier);
+            await this._deactivateSingletonsAsync(bindings);
+        }
+        this._removeServiceFromDictionary(serviceIdentifier);
+    }
+    // Removes all the type bindings from the registry
+    unbindAll() {
+        this._bindingDictionary.traverse((_key, value) => {
+            this._deactivateSingletons(value);
+        });
+        this._bindingDictionary = new Lookup();
+    }
+    async unbindAllAsync() {
+        const promises = [];
+        this._bindingDictionary.traverse((_key, value) => {
+            promises.push(this._deactivateSingletonsAsync(value));
+        });
+        await Promise.all(promises);
+        this._bindingDictionary = new Lookup();
+    }
+    onActivation(serviceIdentifier, onActivation) {
+        this._activations.add(serviceIdentifier, onActivation);
+    }
+    onDeactivation(serviceIdentifier, onDeactivation) {
+        this._deactivations.add(serviceIdentifier, onDeactivation);
+    }
+    // Allows to check if there are bindings available for serviceIdentifier
+    isBound(serviceIdentifier) {
+        let bound = this._bindingDictionary.hasKey(serviceIdentifier);
+        if (!bound && this.parent) {
+            bound = this.parent.isBound(serviceIdentifier);
+        }
+        return bound;
+    }
+    // check binding dependency only in current container
+    isCurrentBound(serviceIdentifier) {
+        return this._bindingDictionary.hasKey(serviceIdentifier);
+    }
+    isBoundNamed(serviceIdentifier, named) {
+        return this.isBoundTagged(serviceIdentifier, METADATA_KEY.NAMED_TAG, named);
+    }
+    // Check if a binding with a complex constraint is available without throwing a error. Ancestors are also verified.
+    isBoundTagged(serviceIdentifier, key, value) {
+        let bound = false;
+        // verify if there are bindings available for serviceIdentifier on current binding dictionary
+        if (this._bindingDictionary.hasKey(serviceIdentifier)) {
+            const bindings = this._bindingDictionary.get(serviceIdentifier);
+            const request = createMockRequest(this, serviceIdentifier, key, value);
+            bound = bindings.some((b) => b.constraint(request));
+        }
+        // verify if there is a parent container that could solve the request
+        if (!bound && this.parent) {
+            bound = this.parent.isBoundTagged(serviceIdentifier, key, value);
+        }
+        return bound;
+    }
+    snapshot() {
+        this._snapshots.push(ContainerSnapshot.of(this._bindingDictionary.clone(), this._middleware, this._activations.clone(), this._deactivations.clone(), this._moduleActivationStore.clone()));
+    }
+    restore() {
+        const snapshot = this._snapshots.pop();
+        if (snapshot === undefined) {
+            throw new Error(ERROR_MSGS.NO_MORE_SNAPSHOTS_AVAILABLE);
+        }
+        this._bindingDictionary = snapshot.bindings;
+        this._activations = snapshot.activations;
+        this._deactivations = snapshot.deactivations;
+        this._middleware = snapshot.middleware;
+        this._moduleActivationStore = snapshot.moduleActivationStore;
+    }
+    createChild(containerOptions) {
+        const child = new Container(containerOptions || this.options);
+        child.parent = this;
+        return child;
+    }
+    applyMiddleware(...middlewares) {
+        const initial = this._middleware
+            ? this._middleware
+            : this._planAndResolve();
+        this._middleware = middlewares.reduce((prev, curr) => curr(prev), initial);
+    }
+    applyCustomMetadataReader(metadataReader) {
+        this._metadataReader = metadataReader;
+    }
+    // Resolves a dependency by its runtime identifier
+    // The runtime identifier must be associated with only one binding
+    // use getAll when the runtime identifier is associated with multiple bindings
+    get(serviceIdentifier) {
+        const getArgs = this._getNotAllArgs(serviceIdentifier, false);
+        return this._getButThrowIfAsync(getArgs);
+    }
+    async getAsync(serviceIdentifier) {
+        const getArgs = this._getNotAllArgs(serviceIdentifier, false);
+        return this._get(getArgs);
+    }
+    getTagged(serviceIdentifier, key, value) {
+        const getArgs = this._getNotAllArgs(serviceIdentifier, false, key, value);
+        return this._getButThrowIfAsync(getArgs);
+    }
+    async getTaggedAsync(serviceIdentifier, key, value) {
+        const getArgs = this._getNotAllArgs(serviceIdentifier, false, key, value);
+        return this._get(getArgs);
+    }
+    getNamed(serviceIdentifier, named) {
+        return this.getTagged(serviceIdentifier, METADATA_KEY.NAMED_TAG, named);
+    }
+    getNamedAsync(serviceIdentifier, named) {
+        return this.getTaggedAsync(serviceIdentifier, METADATA_KEY.NAMED_TAG, named);
+    }
+    // Resolves a dependency by its runtime identifier
+    // The runtime identifier can be associated with one or multiple bindings
+    getAll(serviceIdentifier) {
+        const getArgs = this._getAllArgs(serviceIdentifier);
+        return this._getButThrowIfAsync(getArgs);
+    }
+    getAllAsync(serviceIdentifier) {
+        const getArgs = this._getAllArgs(serviceIdentifier);
+        return this._getAll(getArgs);
+    }
+    getAllTagged(serviceIdentifier, key, value) {
+        const getArgs = this._getNotAllArgs(serviceIdentifier, true, key, value);
+        return this._getButThrowIfAsync(getArgs);
+    }
+    getAllTaggedAsync(serviceIdentifier, key, value) {
+        const getArgs = this._getNotAllArgs(serviceIdentifier, true, key, value);
+        return this._getAll(getArgs);
+    }
+    getAllNamed(serviceIdentifier, named) {
+        return this.getAllTagged(serviceIdentifier, METADATA_KEY.NAMED_TAG, named);
+    }
+    getAllNamedAsync(serviceIdentifier, named) {
+        return this.getAllTaggedAsync(serviceIdentifier, METADATA_KEY.NAMED_TAG, named);
+    }
+    resolve(constructorFunction) {
+        const isBound = this.isBound(constructorFunction);
+        if (!isBound) {
+            this.bind(constructorFunction).toSelf();
+        }
+        const resolved = this.get(constructorFunction);
+        if (!isBound) {
+            this.unbind(constructorFunction);
+        }
+        return resolved;
+    }
+    _preDestroy(constructor, instance) {
+        if (Reflect.hasMetadata(METADATA_KEY.PRE_DESTROY, constructor)) {
+            const data = Reflect.getMetadata(METADATA_KEY.PRE_DESTROY, constructor);
+            return instance[data.value]?.();
+        }
+    }
+    _removeModuleHandlers(moduleId) {
+        const moduleActivationsHandlers = this._moduleActivationStore.remove(moduleId);
+        this._activations.removeIntersection(moduleActivationsHandlers.onActivations);
+        this._deactivations.removeIntersection(moduleActivationsHandlers.onDeactivations);
+    }
+    _removeModuleBindings(moduleId) {
+        return this._bindingDictionary.removeByCondition((binding) => binding.moduleId === moduleId);
+    }
+    _deactivate(binding, instance) {
+        const constructor = Object.getPrototypeOf(instance).constructor;
+        try {
+            if (this._deactivations.hasKey(binding.serviceIdentifier)) {
+                const result = this._deactivateContainer(instance, this._deactivations.get(binding.serviceIdentifier).values());
+                if (isPromise(result)) {
+                    return this._handleDeactivationError(result.then(() => this._propagateContainerDeactivationThenBindingAndPreDestroyAsync(binding, instance, constructor)), constructor);
+                }
+            }
+            const propagateDeactivationResult = this._propagateContainerDeactivationThenBindingAndPreDestroy(binding, instance, constructor);
+            if (isPromise(propagateDeactivationResult)) {
+                return this._handleDeactivationError(propagateDeactivationResult, constructor);
+            }
+        }
+        catch (ex) {
+            if (ex instanceof Error) {
+                throw new Error(ERROR_MSGS.ON_DEACTIVATION_ERROR(constructor.name, ex.message));
+            }
+        }
+    }
+    async _handleDeactivationError(asyncResult, constructor) {
+        try {
+            await asyncResult;
+        }
+        catch (ex) {
+            if (ex instanceof Error) {
+                throw new Error(ERROR_MSGS.ON_DEACTIVATION_ERROR(constructor.name, ex.message));
+            }
+        }
+    }
+    _deactivateContainer(instance, deactivationsIterator) {
+        let deactivation = deactivationsIterator.next();
+        while (deactivation.value) {
+            const result = deactivation.value(instance);
+            if (isPromise(result)) {
+                return result.then(() => this._deactivateContainerAsync(instance, deactivationsIterator));
+            }
+            deactivation = deactivationsIterator.next();
+        }
+    }
+    async _deactivateContainerAsync(instance, deactivationsIterator) {
+        let deactivation = deactivationsIterator.next();
+        while (deactivation.value) {
+            await deactivation.value(instance);
+            deactivation = deactivationsIterator.next();
+        }
+    }
+    _getContainerModuleHelpersFactory() {
+        const setModuleId = (bindingToSyntax, moduleId) => {
+            // TODO: Implement an internal type `_BindingToSyntax<T>` wherein this member
+            // can be public. Let `BindingToSyntax<T>` be the presentational type that
+            // depends on it, and does not expose this member as public.
+            bindingToSyntax._binding.moduleId = moduleId;
+        };
+        const getBindFunction = (moduleId) => (serviceIdentifier) => {
+            const bindingToSyntax = this.bind(serviceIdentifier);
+            setModuleId(bindingToSyntax, moduleId);
+            return bindingToSyntax;
+        };
+        const getUnbindFunction = () => (serviceIdentifier) => {
+            return this.unbind(serviceIdentifier);
+        };
+        const getUnbindAsyncFunction = () => (serviceIdentifier) => {
+            return this.unbindAsync(serviceIdentifier);
+        };
+        const getIsboundFunction = () => (serviceIdentifier) => {
+            return this.isBound(serviceIdentifier);
+        };
+        const getRebindFunction = (moduleId) => (serviceIdentifier) => {
+            const bindingToSyntax = this.rebind(serviceIdentifier);
+            setModuleId(bindingToSyntax, moduleId);
+            return bindingToSyntax;
+        };
+        const getOnActivationFunction = (moduleId) => (serviceIdentifier, onActivation) => {
+            this._moduleActivationStore.addActivation(moduleId, serviceIdentifier, onActivation);
+            this.onActivation(serviceIdentifier, onActivation);
+        };
+        const getOnDeactivationFunction = (moduleId) => (serviceIdentifier, onDeactivation) => {
+            this._moduleActivationStore.addDeactivation(moduleId, serviceIdentifier, onDeactivation);
+            this.onDeactivation(serviceIdentifier, onDeactivation);
+        };
+        // eslint-disable-next-line @typescript-eslint/explicit-function-return-type
+        return (mId) => ({
+            bindFunction: getBindFunction(mId),
+            isboundFunction: getIsboundFunction(),
+            onActivationFunction: getOnActivationFunction(mId),
+            onDeactivationFunction: getOnDeactivationFunction(mId),
+            rebindFunction: getRebindFunction(mId),
+            unbindFunction: getUnbindFunction(),
+            unbindAsyncFunction: getUnbindAsyncFunction(),
+        });
+    }
+    _getAll(getArgs) {
+        return Promise.all(this._get(getArgs));
+    }
+    // Prepares arguments required for resolution and
+    // delegates resolution to _middleware if available
+    // otherwise it delegates resolution to _planAndResolve
+    _get(getArgs) {
+        const planAndResolveArgs = {
+            ...getArgs,
+            contextInterceptor: (context) => context,
+            targetType: TargetTypeEnum.Variable,
+        };
+        if (this._middleware) {
+            const middlewareResult = this._middleware(planAndResolveArgs);
+            if (middlewareResult === undefined || middlewareResult === null) {
+                throw new Error(ERROR_MSGS.INVALID_MIDDLEWARE_RETURN);
+            }
+            return middlewareResult;
+        }
+        return this._planAndResolve()(planAndResolveArgs);
+    }
+    _getButThrowIfAsync(getArgs) {
+        const result = this._get(getArgs);
+        if (isPromiseOrContainsPromise(result)) {
+            throw new Error(ERROR_MSGS.LAZY_IN_SYNC(getArgs.serviceIdentifier));
+        }
+        return result;
+    }
+    _getAllArgs(serviceIdentifier) {
+        const getAllArgs = {
+            avoidConstraints: true,
+            isMultiInject: true,
+            serviceIdentifier,
+        };
+        return getAllArgs;
+    }
+    _getNotAllArgs(serviceIdentifier, isMultiInject, key, value) {
+        const getNotAllArgs = {
+            avoidConstraints: false,
+            isMultiInject,
+            serviceIdentifier,
+            key,
+            value,
+        };
+        return getNotAllArgs;
+    }
+    // Planner creates a plan and Resolver resolves a plan
+    // one of the jobs of the Container is to links the Planner
+    // with the Resolver and that is what this function is about
+    _planAndResolve() {
+        return (args) => {
+            // create a plan
+            let context = plan(this._metadataReader, this, args.isMultiInject, args.targetType, args.serviceIdentifier, args.key, args.value, args.avoidConstraints);
+            // apply context interceptor
+            context = args.contextInterceptor(context);
+            // resolve plan
+            const result = resolve(context);
+            return result;
+        };
+    }
+    _deactivateIfSingleton(binding) {
+        if (!binding.activated) {
+            return;
+        }
+        if (isPromise(binding.cache)) {
+            return binding.cache.then((resolved) => this._deactivate(binding, resolved));
+        }
+        return this._deactivate(binding, binding.cache);
+    }
+    _deactivateSingletons(bindings) {
+        for (const binding of bindings) {
+            const result = this._deactivateIfSingleton(binding);
+            if (isPromise(result)) {
+                throw new Error(ERROR_MSGS.ASYNC_UNBIND_REQUIRED);
+            }
+        }
+    }
+    async _deactivateSingletonsAsync(bindings) {
+        await Promise.all(bindings.map((b) => this._deactivateIfSingleton(b)));
+    }
+    _propagateContainerDeactivationThenBindingAndPreDestroy(binding, instance, constructor) {
+        if (this.parent) {
+            return this._deactivate.bind(this.parent)(binding, instance);
+        }
+        else {
+            return this._bindingDeactivationAndPreDestroy(binding, instance, constructor);
+        }
+    }
+    async _propagateContainerDeactivationThenBindingAndPreDestroyAsync(binding, instance, constructor) {
+        if (this.parent) {
+            await this._deactivate.bind(this.parent)(binding, instance);
+        }
+        else {
+            await this._bindingDeactivationAndPreDestroyAsync(binding, instance, constructor);
+        }
+    }
+    _removeServiceFromDictionary(serviceIdentifier) {
+        try {
+            this._bindingDictionary.remove(serviceIdentifier);
+        }
+        catch (e) {
+            throw new Error(`${ERROR_MSGS.CANNOT_UNBIND} ${getServiceIdentifierAsString(serviceIdentifier)}`);
+        }
+    }
+    _bindingDeactivationAndPreDestroy(binding, instance, constructor) {
+        if (typeof binding.onDeactivation === "function") {
+            const result = binding.onDeactivation(instance);
+            if (isPromise(result)) {
+                return result.then(() => this._preDestroy(constructor, instance));
+            }
+        }
+        return this._preDestroy(constructor, instance);
+    }
+    async _bindingDeactivationAndPreDestroyAsync(binding, instance, constructor) {
+        if (typeof binding.onDeactivation === "function") {
+            await binding.onDeactivation(instance);
+        }
+        await this._preDestroy(constructor, instance);
+    }
+}
+export { Container };

package/lib/esm/di/container/container_module.js

@@ -0,0 +1,17 @@
+import { id } from "../utils/id.js";
+export class ContainerModule {
+    id;
+    registry;
+    constructor(registry) {
+        this.id = id();
+        this.registry = registry;
+    }
+}
+export class AsyncContainerModule {
+    id;
+    registry;
+    constructor(registry) {
+        this.id = id();
+        this.registry = registry;
+    }
+}

package/lib/esm/di/container/container_snapshot.js

@@ -0,0 +1,17 @@
+class ContainerSnapshot {
+    bindings;
+    activations;
+    deactivations;
+    middleware;
+    moduleActivationStore;
+    static of(bindings, middleware, activations, deactivations, moduleActivationStore) {
+        const snapshot = new ContainerSnapshot();
+        snapshot.bindings = bindings;
+        snapshot.middleware = middleware;
+        snapshot.deactivations = deactivations;
+        snapshot.activations = activations;
+        snapshot.moduleActivationStore = moduleActivationStore;
+        return snapshot;
+    }
+}
+export { ContainerSnapshot };

package/lib/esm/di/container/lookup.js

@@ -0,0 +1,108 @@
+import * as ERROR_MSGS from "../constants/error_msgs.js";
+import { isClonable } from "../utils/clonable.js";
+class Lookup {
+    // dictionary used store multiple values for each key <key>
+    _map;
+    constructor() {
+        this._map = new Map();
+    }
+    getMap() {
+        return this._map;
+    }
+    // adds a new entry to _map
+    add(serviceIdentifier, value) {
+        if (serviceIdentifier === null || serviceIdentifier === undefined) {
+            throw new Error(ERROR_MSGS.NULL_ARGUMENT);
+        }
+        if (value === null || value === undefined) {
+            throw new Error(ERROR_MSGS.NULL_ARGUMENT);
+        }
+        const entry = this._map.get(serviceIdentifier);
+        if (entry !== undefined) {
+            entry.push(value);
+        }
+        else {
+            this._map.set(serviceIdentifier, [value]);
+        }
+    }
+    // gets the value of a entry by its key (serviceIdentifier)
+    get(serviceIdentifier) {
+        if (serviceIdentifier === null || serviceIdentifier === undefined) {
+            throw new Error(ERROR_MSGS.NULL_ARGUMENT);
+        }
+        const entry = this._map.get(serviceIdentifier);
+        if (entry !== undefined) {
+            return entry;
+        }
+        else {
+            throw new Error(ERROR_MSGS.KEY_NOT_FOUND);
+        }
+    }
+    // removes a entry from _map by its key (serviceIdentifier)
+    remove(serviceIdentifier) {
+        if (serviceIdentifier === null || serviceIdentifier === undefined) {
+            throw new Error(ERROR_MSGS.NULL_ARGUMENT);
+        }
+        if (!this._map.delete(serviceIdentifier)) {
+            throw new Error(ERROR_MSGS.KEY_NOT_FOUND);
+        }
+    }
+    removeIntersection(lookup) {
+        this.traverse((serviceIdentifier, value) => {
+            const lookupActivations = lookup.hasKey(serviceIdentifier)
+                ? lookup.get(serviceIdentifier)
+                : undefined;
+            if (lookupActivations !== undefined) {
+                const filteredValues = value.filter((lookupValue) => !lookupActivations.some((moduleActivation) => lookupValue === moduleActivation));
+                this._setValue(serviceIdentifier, filteredValues);
+            }
+        });
+    }
+    removeByCondition(condition) {
+        const removals = [];
+        this._map.forEach((entries, key) => {
+            const updatedEntries = [];
+            for (const entry of entries) {
+                const remove = condition(entry);
+                if (remove) {
+                    removals.push(entry);
+                }
+                else {
+                    updatedEntries.push(entry);
+                }
+            }
+            this._setValue(key, updatedEntries);
+        });
+        return removals;
+    }
+    // returns true if _map contains a key (serviceIdentifier)
+    hasKey(serviceIdentifier) {
+        if (serviceIdentifier === null || serviceIdentifier === undefined) {
+            throw new Error(ERROR_MSGS.NULL_ARGUMENT);
+        }
+        return this._map.has(serviceIdentifier);
+    }
+    // returns a new Lookup instance; note: this is not a deep clone, only Lookup related data structure (dictionary) is
+    // cloned, content remains the same
+    clone() {
+        const copy = new Lookup();
+        this._map.forEach((value, key) => {
+            value.forEach((b) => copy.add(key, isClonable(b) ? b.clone() : b));
+        });
+        return copy;
+    }
+    traverse(func) {
+        this._map.forEach((value, key) => {
+            func(key, value);
+        });
+    }
+    _setValue(serviceIdentifier, value) {
+        if (value.length > 0) {
+            this._map.set(serviceIdentifier, value);
+        }
+        else {
+            this._map.delete(serviceIdentifier);
+        }
+    }
+}
+export { Lookup };

package/lib/esm/di/container/module_activation_store.js

@@ -0,0 +1,43 @@
+import { Lookup } from "./lookup.js";
+export class ModuleActivationStore {
+    _map = new Map();
+    remove(moduleId) {
+        if (this._map.has(moduleId)) {
+            const handlers = this._map.get(moduleId);
+            this._map.delete(moduleId);
+            return handlers;
+        }
+        return this._getEmptyHandlersStore();
+    }
+    addDeactivation(moduleId, serviceIdentifier, onDeactivation) {
+        this._getModuleActivationHandlers(moduleId).onDeactivations.add(serviceIdentifier, onDeactivation);
+    }
+    addActivation(moduleId, serviceIdentifier, onActivation) {
+        this._getModuleActivationHandlers(moduleId).onActivations.add(serviceIdentifier, onActivation);
+    }
+    clone() {
+        const clone = new ModuleActivationStore();
+        this._map.forEach((handlersStore, moduleId) => {
+            clone._map.set(moduleId, {
+                onActivations: handlersStore.onActivations.clone(),
+                onDeactivations: handlersStore.onDeactivations.clone(),
+            });
+        });
+        return clone;
+    }
+    _getModuleActivationHandlers(moduleId) {
+        let moduleActivationHandlers = this._map.get(moduleId);
+        if (moduleActivationHandlers === undefined) {
+            moduleActivationHandlers = this._getEmptyHandlersStore();
+            this._map.set(moduleId, moduleActivationHandlers);
+        }
+        return moduleActivationHandlers;
+    }
+    _getEmptyHandlersStore() {
+        const handlersStore = {
+            onActivations: new Lookup(),
+            onDeactivations: new Lookup(),
+        };
+        return handlersStore;
+    }
+}