@adimm/x-injection 0.7.0 → 1.1.5

package/dist/index.d.ts

@@ -168,6 +168,7 @@ interface IProviderModuleNaked extends IProviderModule {
     readonly onDispose: ProviderModuleOptions['onDispose'];
     /** Can be used to override all the _imported_ providers _before_ the binding process. */
     readonly importedProvidersMap: ProviderModuleOptionsInternal['importedProvidersMap'];
+    readonly registeredSideEffects: RegisteredSideEffects;
     /** It'll _completely_ re-init the `module` with the provided {@link LazyInitOptions | options}. */
     _lazyInit(options: LazyInitOptions): IProviderModule;
     /** Can be used to get the list of all the imported modules of this module. */
@@ -180,12 +181,19 @@ interface IProviderModuleNaked extends IProviderModule {
      * Can be used to execute the provided {@link cb | callback} whenever a _new_ {@link https://inversify.io/docs/fundamentals/binding/ | binding}
      * is registered for the {@link provider}.
      *
-     * **Note:** _This is not the same as the {@link onActivationEvent}!_
-     *
      * @param provider The {@link ProviderToken}.
      * @param cb The `callback` to be invoked.
      */
     _onBind<T>(provider: ProviderToken<T>, cb: () => Promise<void> | void): void;
+    /**
+     * Can be used to execute the provided {@link cb | callback} whenever the
+     * {@link IProviderModule.get | get} method is invoked.
+     *
+     * @param provider The {@link ProviderToken}.
+     * @param once When set to `true` it'll invoke the provided {@link cb | callback} only once.
+     * @param cb The `callback` to be invoked.
+     */
+    _onGet<T>(provider: ProviderToken<T>, once: boolean, cb: () => Promise<void> | void): void;
     /**
      * Can be used to execute the provided {@link cb | callback} whenever an existing {@link https://inversify.io/docs/fundamentals/binding/ | binding}
      * is re-registered for the {@link provider}.
@@ -197,8 +205,7 @@ interface IProviderModuleNaked extends IProviderModule {
     /**
      * Can be used to execute the provided {@link cb | callback} whenever a {@link provider} is `unbound`.
      *
-     * **Note:** _This is not the same as the {@link onDeactivationEvent}!_
-     * _Also the {@link _onBind}, {@link __rebind} and {@link _onUnbind} registered callbacks will be removed._
+     * **Note:** _All the {@link _onBind}, {@link _onGet}, {@link _onRebind} and {@link _onUnbind} registered callbacks will be removed_
      *
      * @param provider The {@link ProviderToken}.
      * @param cb The `callback` to be invoked.
@@ -318,6 +325,23 @@ interface IProviderModuleNaked extends IProviderModule {
     __unbindAll(): Promise<void>;
 }
 type LazyInitOptions = Except<ProviderModuleOptions & ProviderModuleOptionsInternal, 'identifier' | 'isAppModule'>;
+type RegisteredSideEffects = Map<ProviderToken, {
+    onBindEffects: OnBindEffects[];
+    onGetEffects: OnGetEffects[];
+    onRebindEffects: OnRebindEffects[];
+    onUnbindEffects: OnUnbindEffects[];
+}>;
+type OnBindEffects = () => Promise<void> | void;
+type OnGetEffects = {
+    once: boolean;
+    invoked: boolean;
+    cb: () => Promise<void> | void;
+};
+type OnRebindEffects = () => Promise<void> | void;
+type OnUnbindEffects = {
+    registerModule?: symbol;
+    cb: () => Promise<void> | void;
+};
 
 /**
  * The low-level App Container.
@@ -399,12 +423,10 @@ declare class ProviderModule implements IProviderModule {
     protected readonly providers: IProviderModuleNaked['providers'];
     protected readonly importedProviders: IProviderModuleNaked['importedProviders'];
     protected readonly exports: IProviderModuleNaked['exports'];
-    private readonly registeredBindingSideEffects;
+    protected readonly registeredSideEffects: IProviderModuleNaked['registeredSideEffects'];
     constructor({ identifier, imports, providers, exports, defaultScope, markAsGlobal, dynamicExports, onReady, onDispose, ..._internalParams }: ProviderModuleOptions);
     get<T>(provider: ProviderToken<T>, isOptional?: boolean): T;
     getMany<D extends (ProviderModuleGetManyParam<any> | ProviderToken)[]>(...deps: D | unknown[]): ProviderModuleGetManySignature<D>;
-    onActivationEvent<T>(provider: ProviderToken<T>, cb: BindingActivation<T>): void;
-    onDeactivationEvent<T>(provider: ProviderToken<T>, cb: BindingDeactivation<T>): void;
     toNaked(): IProviderModuleNaked;
     clone(options?: Partial<ProviderModuleOptions>): IProviderModule;
     dispose(): Promise<void>;
@@ -413,9 +435,11 @@ declare class ProviderModule implements IProviderModule {
     private prepareContainer;
     private injectImportedModules;
     private injectProviders;
+    private onUnbindInternal;
     private registerBindingSideEffect;
     private invokeRegisteredBindingSideEffects;
     private removeRegisteredBindingSideEffects;
+    private removeOnUnbindEffectsFromImportedModule;
     private shouldThrowIfDisposed;
     /**
      * **Publicly visible when the instance is casted to {@link IProviderModuleNaked}.**
@@ -447,6 +471,12 @@ declare class ProviderModule implements IProviderModule {
      * See {@link IProviderModuleNaked._onBind}.
      */
     protected _onBind<T>(provider: ProviderToken<T>, cb: () => Promise<void> | void): void;
+    /**
+     * **Publicly visible when the instance is casted to {@link IProviderModuleNaked}.**
+     *
+     * See {@link IProviderModuleNaked._onGet}.
+     */
+    protected _onGet<T>(provider: ProviderToken<T>, once: boolean, cb: () => Promise<void> | void): void;
     /**
      * **Publicly visible when the instance is casted to {@link IProviderModuleNaked}.**
      *
@@ -731,18 +761,6 @@ interface IProviderModule {
      * ```
      */
     getMany<D extends (ProviderModuleGetManyParam<any> | ProviderToken)[]>(...deps: D | unknown[]): ProviderModuleGetManySignature<D>;
-    /**
-     * Adds an activation handler for the {@link provider}.
-     *
-     * See {@link https://inversify.io/docs/api/container/#onactivation} for more details.
-     */
-    onActivationEvent<T>(provider: ProviderToken<T>, cb: BindingActivation<T>): void;
-    /**
-     * Adds a deactivation handler for the {@link provider}.
-     *
-     * See {@link https://inversify.io/docs/api/container/#ondeactivation} for more details.
-     */
-    onDeactivationEvent<T>(provider: ProviderToken<T>, cb: BindingDeactivation<T>): void;
     /**
      * Casts the current module type to the {@link IProviderModuleNaked} type.
      *
@@ -800,12 +818,6 @@ declare function Named(name: MetadataName): MethodDecorator & ParameterDecorator
 /** See {@link https://inversify.io/docs/api/decorator/#optional} for more details. */
 declare function Optional(): MethodDecorator & ParameterDecorator & PropertyDecorator;
 
-/** See {@link https://inversify.io/docs/api/decorator/#postconstruct} for more details. */
-declare function PostConstruct(): MethodDecorator;
-
-/** See {@link https://inversify.io/docs/api/decorator/#predestroy} for more details. */
-declare function PreDestroy(): MethodDecorator;
-
 /** See {@link https://inversify.io/docs/api/decorator/#tagged} for more details. */
 declare function Tagged(key: MetadataTag, value: unknown): MethodDecorator & ParameterDecorator & PropertyDecorator;
 
@@ -880,4 +892,4 @@ declare function isFunction(v: any): boolean;
 
 declare function isClassOrFunction(value: any): value is Function | Class<any>;
 
-export { AppModule, type AppModuleOptions, type DependencyProvider, type DynamicExports, GLOBAL_APP_MODULE_ID, GlobalAppModule, GlobalContainer, type IAppModule, type IProviderModule, type IProviderModuleNaked, Inject, InjectFromBase, Injectable, InjectionError, InjectionProviderModuleDisposedError, InjectionProviderModuleError, InjectionProviderModuleGlobalMarkError, InjectionProviderModuleMissingIdentifierError, InjectionScope, type LazyInitOptions, MultiInject, Named, type OnEvent, Optional, PostConstruct, PreDestroy, type ProviderClassToken, type ProviderFactoryToken, type ProviderIdentifier, ProviderModule, type ProviderModuleGetManyParam, type ProviderModuleGetManySignature, ProviderModuleHelpers, type ProviderModuleOptions, type ProviderModuleOptionsInternal, type ProviderOptions, type ProviderScopeOption, type ProviderToken, ProviderTokenHelpers, type ProviderValueToken, type StaticExports, Tagged, Unmanaged, bindingScopeToInjectionScope, injectionScopeToBindingScope, isClass, isClassOrFunction, isFunction, isPlainObject };
+export { AppModule, type AppModuleOptions, type DependencyProvider, type DynamicExports, GLOBAL_APP_MODULE_ID, GlobalAppModule, GlobalContainer, type IAppModule, type IProviderModule, type IProviderModuleNaked, Inject, InjectFromBase, Injectable, InjectionError, InjectionProviderModuleDisposedError, InjectionProviderModuleError, InjectionProviderModuleGlobalMarkError, InjectionProviderModuleMissingIdentifierError, InjectionScope, type LazyInitOptions, MultiInject, Named, type OnEvent, Optional, type ProviderClassToken, type ProviderFactoryToken, type ProviderIdentifier, ProviderModule, type ProviderModuleGetManyParam, type ProviderModuleGetManySignature, ProviderModuleHelpers, type ProviderModuleOptions, type ProviderModuleOptionsInternal, type ProviderOptions, type ProviderScopeOption, type ProviderToken, ProviderTokenHelpers, type ProviderValueToken, type StaticExports, Tagged, Unmanaged, bindingScopeToInjectionScope, injectionScopeToBindingScope, isClass, isClassOrFunction, isFunction, isPlainObject };

package/dist/index.js

@@ -48,7 +48,7 @@ function h(e) {
     return "function" == typeof e;
 }
 
-function p(e) {
+function f(e) {
     return "function" == typeof e && !Function.prototype.toString.call(e).startsWith("class ");
 }
 
@@ -56,7 +56,7 @@ function l(e) {
     return "[object Object]" === Object.prototype.toString.call(e);
 }
 
-function f(e) {
+function p(e) {
     if (!1 === l(e)) return !1;
     const i = e.constructor;
     if (void 0 === i) return !0;
@@ -68,16 +68,16 @@ function v(e) {
     return void 0 === e ? n() : n(d(e));
 }
 
-i(u, "isClass"), i(h, "isClassOrFunction"), i(p, "isFunction"), i(l, "isObject"), 
-i(f, "isPlainObject"), function(e) {
+i(u, "isClass"), i(h, "isClassOrFunction"), i(f, "isFunction"), i(l, "isObject"), 
+i(p, "isPlainObject"), function(e) {
     function t(e) {
-        return y(e) && "useClass" in e;
+        return b(e) && "useClass" in e;
     }
     function n(e) {
-        return y(e) && "useValue" in e;
+        return b(e) && "useValue" in e;
     }
     function o(e) {
-        return y(e) && "useFactory" in e;
+        return b(e) && "useFactory" in e;
     }
     function r(e) {
         return "string" == typeof e || "symbol" == typeof e || h(e);
@@ -93,7 +93,7 @@ i(f, "isPlainObject"), function(e) {
             ...i,
             provide: i?.provide ?? e,
             useClass: i?.useClass ?? e
-        } : p(e) ? {
+        } : f(e) ? {
             ...i,
             provide: i?.provide ?? e,
             useFactory: i?.useFactory ?? e
@@ -106,7 +106,7 @@ i(f, "isPlainObject"), function(e) {
         return m(e) ?? S(e) ?? i;
     }
     function g(e) {
-        if (y(e)) return e;
+        if (b(e)) return e;
     }
     function m(e) {
         const i = g(e);
@@ -118,8 +118,8 @@ i(f, "isPlainObject"), function(e) {
         const t = c(i)?.scope;
         return t ? a(t) : void 0;
     }
-    function y(e) {
-        return f(e) && "object" == typeof e && "provide" in e;
+    function b(e) {
+        return p(e) && "object" == typeof e && "provide" in e;
     }
     i(t, "isClassToken"), e.isClassToken = t, i(n, "isValueToken"), e.isValueToken = n, 
     i(o, "isFactoryToken"), e.isFactoryToken = o, i(r, "isProviderIdentifier"), e.isProviderIdentifier = r, 
@@ -127,7 +127,7 @@ i(f, "isPlainObject"), function(e) {
     e.toServiceIdentifiers = d, i(l, "toDependencyProviderWithOptions"), e.toDependencyProviderWithOptions = l, 
     i(v, "getInjectionScopeByPriority"), e.getInjectionScopeByPriority = v, i(g, "tryGetProviderOptions"), 
     e.tryGetProviderOptions = g, i(m, "tryGetScopeFromProvider"), e.tryGetScopeFromProvider = m, 
-    i(S, "tryGetDecoratorScopeFromClass"), e.tryGetDecoratorScopeFromClass = S, i(y, "hasProvideProperty");
+    i(S, "tryGetDecoratorScopeFromClass"), e.tryGetDecoratorScopeFromClass = S, i(b, "hasProvideProperty");
 }(o || (o = {})), function(e) {
     function t(e) {
         return e;
@@ -149,16 +149,16 @@ i(m, "Inject");
 
 import { multiInject as S } from "inversify";
 
-function y(e) {
+function b(e) {
     return S(o.toServiceIdentifier(e));
 }
 
-i(y, "MultiInject");
+i(b, "MultiInject");
 
-import { injectFromBase as b } from "inversify";
+import { injectFromBase as y } from "inversify";
 
 function I(e) {
-    return b(e);
+    return y(e);
 }
 
 i(I, "InjectFromBase");
@@ -171,52 +171,36 @@ function T(e) {
 
 i(T, "Named");
 
-import { optional as k } from "inversify";
-
-function M() {
-    return k();
-}
-
-i(M, "Optional");
-
-import { postConstruct as w } from "inversify";
-
-function B() {
-    return w();
-}
-
-i(B, "PostConstruct");
+import { optional as M } from "inversify";
 
-import { preDestroy as _ } from "inversify";
-
-function P() {
-    return _();
+function k() {
+    return M();
 }
 
-i(P, "PreDestroy");
+i(k, "Optional");
 
-import { tagged as D } from "inversify";
+import { tagged as w } from "inversify";
 
-function A(e, i) {
-    return D(e, i);
+function _(e, i) {
+    return w(e, i);
 }
 
-i(A, "Tagged");
+i(_, "Tagged");
 
-import { unmanaged as C } from "inversify";
+import { unmanaged as P } from "inversify";
 
-function R() {
-    return C();
+function B() {
+    return P();
 }
 
-i(R, "Unmanaged");
+i(B, "Unmanaged");
 
-var j = class e extends Error {
+var A = class e extends Error {
     static {
         i(this, "InjectionError");
     }
     name=e.name;
-}, x = class e extends Error {
+}, D = class e extends Error {
     static {
         i(this, "InjectionProviderModuleError");
     }
@@ -224,7 +208,7 @@ var j = class e extends Error {
     constructor(e, i) {
         super(`{ProviderModule.${e.toString()}} => ${i}`);
     }
-}, G = class e extends x {
+}, C = class e extends D {
     static {
         i(this, "InjectionProviderModuleDisposedError");
     }
@@ -232,7 +216,7 @@ var j = class e extends Error {
     constructor(e) {
         super(e, "Has been disposed! You can re-initialize it by using the `_lazyInit` method.");
     }
-}, F = class e extends x {
+}, R = class e extends D {
     static {
         i(this, "InjectionProviderModuleMissingIdentifierError");
     }
@@ -240,7 +224,7 @@ var j = class e extends Error {
     constructor(e) {
         super(e, "An `identifier` must be supplied!");
     }
-}, O = class e extends x {
+}, j = class e extends D {
     static {
         i(this, "InjectionProviderModuleGlobalMarkError");
     }
@@ -250,15 +234,15 @@ var j = class e extends Error {
     }
 };
 
-import { Container as N } from "inversify";
+import { Container as x } from "inversify";
 
-var U = new N({
+var G = new x({
     defaultScope: "Singleton"
 });
 
-import { Container as V } from "inversify";
+import { Container as F } from "inversify";
 
-var q = class {
+var O = class {
     static {
         i(this, "ProviderModuleUtils");
     }
@@ -267,7 +251,7 @@ var q = class {
     }
     module;
     moduleNaked;
-    appModule=H;
+    appModule=q;
     constructor(e, i) {
         this.module = e, this.moduleNaked = e.toNaked(), this.appModule = i.appModule?.() ?? this.appModule, 
         this.checkIfShouldBeAddedToTheGlobalRegister();
@@ -276,7 +260,7 @@ var q = class {
         return o.isProviderIdentifier(e) ? this.bindSelfTokenToContainer(e, i) : o.isClassToken(e) ? this.bindClassTokenToContainer(e, i) : o.isValueToken(e) ? this.bindValueTokenToContainer(e) : !!o.isFactoryToken(e) && this.bindFactoryTokenToContainer(e, i);
     }
     checkIfShouldBeAddedToTheGlobalRegister() {
-        !this.moduleNaked.isAppModule && this.module.isMarkedAsGlobal && $.add(this.module);
+        !this.moduleNaked.isAppModule && this.module.isMarkedAsGlobal && N.add(this.module);
     }
     bindSelfTokenToContainer(e, i) {
         return this.setBindingScope(e, this.container.bind(o.toServiceIdentifier(e)).toSelf(), i), 
@@ -317,7 +301,7 @@ var q = class {
         const t = e;
         t.onEvent?.activation && i.onActivation(t.onEvent.activation), t.onEvent?.deactivation && i.onDeactivation(t.onEvent.deactivation);
     }
-}, W = class e {
+}, U = class e {
     static {
         i(this, "ProviderModule");
     }
@@ -336,7 +320,7 @@ var q = class {
     providers;
     importedProviders;
     exports;
-    registeredBindingSideEffects;
+    registeredSideEffects;
     constructor({identifier: e, imports: i, providers: t, exports: n, defaultScope: o, markAsGlobal: r, dynamicExports: s, onReady: d, onDispose: a, ...c}) {
         const u = c;
         this.identifier = this.setIdentifier(e), this.isDisposed = u.isDisposed ?? !1, this.isAppModule = u.isAppModule ?? !1, 
@@ -359,22 +343,15 @@ var q = class {
     }
     getMany(...e) {
         return e.map((e => {
-            const i = f(e) && "provider" in e;
+            const i = p(e) && "provider" in e;
             return this.get(i ? e.provider : e, !!i && e.isOptional);
         }));
     }
-    onActivationEvent(e, i) {
-        this.shouldThrowIfDisposed(), this.container.onActivation(o.toServiceIdentifier(e), i);
-    }
-    onDeactivationEvent(e, i) {
-        this.shouldThrowIfDisposed(), this.container.onDeactivation(o.toServiceIdentifier(e), i);
-    }
     toNaked() {
         return this;
     }
     clone(i) {
-        const t = i;
-        return new e(r.buildInternalConstructorParams({
+        const t = i, n = new e(r.buildInternalConstructorParams({
             isAppModule: this.isAppModule,
             markAsGlobal: this.isMarkedAsGlobal,
             identifier: this.identifier,
@@ -388,67 +365,101 @@ var q = class {
             exports: [ ...this.exports ],
             ...t
         }));
+        return n.registeredSideEffects = new Map(this.registeredSideEffects), n;
     }
     async dispose() {
         await (this.onDispose?.(this)), await this.__unbindAll(), this.container = null, 
         this.imports = null, this.providers = null, this.importedProviders = null, this.exports = null, 
-        this.dynamicExports = null, this.registeredBindingSideEffects = null, this.isDisposed = !0;
+        this.dynamicExports = null, this.registeredSideEffects = null, this.isDisposed = !0;
     }
     toString() {
         return this.identifier?.description ?? "Unknown";
     }
     setIdentifier(e) {
-        if (!e) throw new F(this);
+        if (!e) throw new R(this);
         return e;
     }
     prepareContainer(e) {
-        return this.isAppModule ? e.container?.() ?? U : e.container ? (console.warn(`[xInjection]: The '${this.toString()}' module is using a dynamic container!`), 
-        e.container()) : new V({
-            parent: U,
+        return this.isAppModule ? e.container?.() ?? G : e.container ? (console.warn(`[xInjection]: The '${this.toString()}' module is using a dynamic container!`), 
+        e.container()) : new F({
+            parent: G,
             defaultScope: this.defaultScope.inversify
         });
     }
     injectImportedModules(t) {
         t && 0 !== t.length && t.forEach((t => {
-            if ("GlobalAppModule" === t.toString()) throw new x(this, "The 'GlobalAppModule' can't be imported!");
+            if ("GlobalAppModule" === t.toString()) throw new D(this, "The 'GlobalAppModule' can't be imported!");
             const n = (t = "function" == typeof t ? t() : t)._getExportableModulesAndProviders(), r = t.dynamicExports?.(this, n);
             (r ?? n).forEach((n => {
                 if (n instanceof e) {
                     const e = n.toNaked();
                     return void this.injectImportedModules([ e ]);
                 }
-                const r = n, s = this.importedProvidersMap({
+                const r = n, s = o.toServiceIdentifier(r), d = this.importedProvidersMap({
                     scope: o.getInjectionScopeByPriority(r, t.defaultScope.native),
-                    provide: o.toServiceIdentifier(r),
+                    provide: s,
                     useFactory: i((() => t.get(r)), "useFactory")
                 }, r, t);
-                this.importedProviders.set(t, [ ...this.importedProviders.get(t) ?? [], s ]), this.moduleUtils.bindToContainer(s, t.defaultScope.native), 
-                t._onUnbind(r, (() => this.__unbind(s)));
+                this.importedProviders.set(t, [ ...this.importedProviders.get(t) ?? [], d ]), this.moduleUtils.bindToContainer(d, t.defaultScope.native);
+                const a = t;
+                a.onUnbindInternal(r, this.identifier, (() => this.__unbind(d))), this._onUnbind(d, (() => {
+                    this.removeOnUnbindEffectsFromImportedModule(s, a);
+                }));
             }));
         }));
     }
     injectProviders() {
         this.providers.forEach((e => this.moduleUtils.bindToContainer(e, this.defaultScope.native)));
     }
-    registerBindingSideEffect(e, i, t) {
-        this.registeredBindingSideEffects.has(e) || this.registeredBindingSideEffects.set(e, {
+    onUnbindInternal(e, i, t) {
+        this.shouldThrowIfDisposed(), this.registerBindingSideEffect(e, "unbind", t, {
+            registerModule: i
+        });
+    }
+    registerBindingSideEffect(e, i, t, n) {
+        const r = o.toServiceIdentifier(e);
+        this.registeredSideEffects.has(r) || this.registeredSideEffects.set(r, {
             onBindEffects: [],
+            onGetEffects: [],
             onRebindEffects: [],
             onUnbindEffects: []
         });
-        const n = this.registeredBindingSideEffects.get(e);
-        "bind" === i ? n.onBindEffects.push(t) : "rebind" === i ? n.onRebindEffects.push(t) : n.onUnbindEffects.push(t);
+        const s = this.registeredSideEffects.get(r);
+        "bind" === i ? s.onBindEffects.push(t) : "get" === i ? s.onGetEffects.push({
+            once: n.once,
+            invoked: !1,
+            cb: t
+        }) : "rebind" === i ? s.onRebindEffects.push(t) : "unbind" === i && s.onUnbindEffects.push({
+            registerModule: n?.registerModule,
+            cb: t
+        });
     }
     invokeRegisteredBindingSideEffects(e, i) {
-        const t = this.registeredBindingSideEffects.get(e);
-        t && t[`${i}Effects`].forEach((e => e()));
+        const t = o.toServiceIdentifier(e), n = this.registeredSideEffects.get(t);
+        n && n[`${i}Effects`].forEach((e => {
+            if ("function" == typeof e) return e();
+            if ("onGet" === i) {
+                const i = e;
+                if (i.invoked && i.once) return;
+                i.invoked = !0;
+            }
+            e.cb();
+        }));
     }
     removeRegisteredBindingSideEffects(e) {
-        this.registeredBindingSideEffects && ("all" !== e ? this.registeredBindingSideEffects.has(e) && (this.registeredBindingSideEffects.get(e)?.onUnbindEffects.forEach((e => e())), 
-        this.registeredBindingSideEffects.delete(e)) : this.registeredBindingSideEffects.forEach((({onUnbindEffects: e}) => e.forEach((e => e())))));
+        if (!this.registeredSideEffects) return;
+        if ("all" === e) return this.registeredSideEffects.forEach((({onUnbindEffects: e}) => e.forEach((e => e.cb())))), 
+        void this.registeredSideEffects.clear();
+        const i = o.toServiceIdentifier(e);
+        this.registeredSideEffects.has(i) && (this.registeredSideEffects.get(i)?.onUnbindEffects.forEach((e => e.cb())), 
+        this.registeredSideEffects.delete(i));
+    }
+    removeOnUnbindEffectsFromImportedModule(e, i) {
+        const t = i.registeredSideEffects.get(e);
+        t && (t.onUnbindEffects = t.onUnbindEffects.filter((e => e.registerModule !== this.identifier)));
     }
     shouldThrowIfDisposed() {
-        if (null === this.container) throw new G(this);
+        if (null === this.container) throw new C(this);
     }
     _lazyInit({markAsGlobal: e, imports: i = [], providers: t = [], exports: n = [], defaultScope: o = s.Singleton, dynamicExports: r, onReady: a, onDispose: c, ...u}) {
         return this.isMarkedAsGlobal = e ?? !1, this.isDisposed = !1, this.imports = i, 
@@ -459,9 +470,8 @@ var q = class {
         }, this.dynamicExports = r, this.onReady = a, this.onDispose = c, this.importedProvidersMap = u.importedProvidersMap ?? (e => e), 
         this.container = this.prepareContainer({
             ...u
-        }), this.moduleUtils = new q(this, u), this.registeredBindingSideEffects = new Map, 
-        this.injectImportedModules(this._getImportedModules()), this.injectProviders(), 
-        this.onReady?.(this), this;
+        }), this.moduleUtils = new O(this, u), this.registeredSideEffects = new Map, this.injectImportedModules(this._getImportedModules()), 
+        this.injectProviders(), this.onReady?.(this), this;
     }
     _getImportedModules() {
         return this.shouldThrowIfDisposed(), this.imports;
@@ -475,6 +485,12 @@ var q = class {
     _onBind(e, i) {
         this.shouldThrowIfDisposed(), this.registerBindingSideEffect(e, "bind", i);
     }
+    _onGet(e, i, t) {
+        if (this.shouldThrowIfDisposed(), "boolean" != typeof i) throw new D(this, `The 'once' parameter is required when using the '${this._onGet.name}' method!`);
+        this.registerBindingSideEffect(e, "get", t, {
+            once: i
+        });
+    }
     _onRebind(e, i) {
         this.shouldThrowIfDisposed(), this.registerBindingSideEffect(e, "rebind", i);
     }
@@ -490,7 +506,8 @@ var q = class {
         return this.invokeRegisteredBindingSideEffects(e, "onBind"), i;
     }
     __get(e, i) {
-        return this.shouldThrowIfDisposed(), this.container.get(o.toServiceIdentifier(e), i);
+        return this.shouldThrowIfDisposed(), this.invokeRegisteredBindingSideEffects(e, "onGet"), 
+        this.container.get(o.toServiceIdentifier(e), i);
     }
     async __getAsync(e, i) {
         return this.shouldThrowIfDisposed(), this.container.getAsync(o.toServiceIdentifier(e), i);
@@ -534,7 +551,7 @@ var q = class {
     async __unbindAll() {
         this.shouldThrowIfDisposed(), await this.container.unbindAll(), this.removeRegisteredBindingSideEffects("all");
     }
-}, $ = new Set, z = class extends W {
+}, N = new Set, V = class extends U {
     static {
         i(this, "GlobalAppModule");
     }
@@ -547,7 +564,7 @@ var q = class {
         }));
     }
     register(e) {
-        if (this.isLoaded) throw new j(`The '${this.toString()}' has already been registered!`);
+        if (this.isLoaded) throw new A(`The '${this.toString()}' has already been registered!`);
         return this.nakedModule._lazyInit(e), this.checkIfRegisteredModulesHaveGlobalMark(this.toNaked(), this.imports), 
         this.isLoaded = !0, this;
     }
@@ -559,14 +576,14 @@ var q = class {
     }
     checkIfRegisteredModulesHaveGlobalMark(e, i, t = !1) {
         i.forEach((i => {
-            if (i instanceof W) {
-                if (i.isMarkedAsGlobal) return $.delete(i), void (i.exports && this.checkIfRegisteredModulesHaveGlobalMark(i, i.exports, !0));
-                throw new O(i, t ? `Is not marked as \`global\` but has been imported into the \`AppModule\`via the \`${e.toString()}\` module!` : "Is not marked as `global` but has been imported into the `AppModule`!");
+            if (i instanceof U) {
+                if (i.isMarkedAsGlobal) return N.delete(i), void (i.exports && this.checkIfRegisteredModulesHaveGlobalMark(i, i.exports, !0));
+                throw new j(i, t ? `Is not marked as \`global\` but has been imported into the \`AppModule\`via the \`${e.toString()}\` module!` : "Is not marked as `global` but has been imported into the `AppModule`!");
             }
-        })), t || $.forEach((e => {
-            throw new O(e, "Is marked as 'global' and has not been imported into the 'AppModule'!");
+        })), t || N.forEach((e => {
+            throw new j(e, "Is marked as 'global' and has not been imported into the 'AppModule'!");
         }));
     }
-}, H = new z;
+}, q = new V;
 
-export { H as AppModule, t as GLOBAL_APP_MODULE_ID, z as GlobalAppModule, U as GlobalContainer, m as Inject, I as InjectFromBase, v as Injectable, j as InjectionError, G as InjectionProviderModuleDisposedError, x as InjectionProviderModuleError, O as InjectionProviderModuleGlobalMarkError, F as InjectionProviderModuleMissingIdentifierError, s as InjectionScope, y as MultiInject, T as Named, M as Optional, B as PostConstruct, P as PreDestroy, W as ProviderModule, r as ProviderModuleHelpers, o as ProviderTokenHelpers, A as Tagged, R as Unmanaged, a as bindingScopeToInjectionScope, d as injectionScopeToBindingScope, u as isClass, h as isClassOrFunction, p as isFunction, f as isPlainObject };//# sourceMappingURL=index.js.map
+export { q as AppModule, t as GLOBAL_APP_MODULE_ID, V as GlobalAppModule, G as GlobalContainer, m as Inject, I as InjectFromBase, v as Injectable, A as InjectionError, C as InjectionProviderModuleDisposedError, D as InjectionProviderModuleError, j as InjectionProviderModuleGlobalMarkError, R as InjectionProviderModuleMissingIdentifierError, s as InjectionScope, b as MultiInject, T as Named, k as Optional, U as ProviderModule, r as ProviderModuleHelpers, o as ProviderTokenHelpers, _ as Tagged, B as Unmanaged, a as bindingScopeToInjectionScope, d as injectionScopeToBindingScope, u as isClass, h as isClassOrFunction, f as isFunction, p as isPlainObject };//# sourceMappingURL=index.js.map