@adimm/x-injection 0.3.1 → 0.4.0

package/README.md

@@ -26,6 +26,7 @@ xInjection&nbsp;<a href="https://www.npmjs.com/package/@adimm/x-injection" targe
   - [Dynamic Exports](#dynamic-exports)
 - [Advanced Usage](#advanced-usage)
 - [Documentation](#documentation)
+- [ReactJS Implementation](#reactjs-implementation)
 - [Contributing](#contributing)
 
 ## Overview
@@ -126,6 +127,7 @@ The below list shows them in order of priority _(highest to lowest)_, meaning th
 3. By providing the [defaultScope](https://adimarianmutu.github.io/x-injection/interfaces/ProviderModuleOptions.html#defaultscope) property when initializing a `ProviderModule`:
    ```ts
    const RainModule = new ProviderModule({
+     identifier: Symbol('RainModule'),
      defaultScope: InjectionScope.Transient,
    });
    ```
@@ -152,7 +154,7 @@ export class SessionService {
 }
 
 export const DatabaseModule = new ProviderModule({
-  name: 'DatabaseModule',
+  identifier: Symbol('DatabaseModule'),
   providers: [DatabaseService],
   exports: [DatabaseService],
   onReady: async (module) => {
@@ -168,7 +170,7 @@ export const DatabaseModule = new ProviderModule({
 });
 
 export const SessionModule = new ProviderModule({
-  name: 'SessionModule',
+  identifier: Symbol('SessionModule'),
   defaultScope: InjectionScope.Request,
   providers: [SessionService],
   exports: [SessionService],
@@ -244,14 +246,14 @@ class CrowService extends AnimalService {
 }
 
 const AnimalModule = new ProviderModule({
-  name: 'AnimalModule',
+  identifier: Symbol('AnimalModule'),
   providers: [AnimalService, { provide: WingsService, useClass: WingsService, scope: InjectionScope.Transient }],
   exports: [AnimalService, WingsService],
   dynamicExports: (importerModule, moduleExports) => {
     // If the importer module is `CrowModule`, we'll export the entire
     // `exports` list, because `moduleExports` is actually the `exports` array declared above.
     // Meaning that the `CrowModule` container will also have access to the `WingsService`
-    if (importerModule.toNaked().name === 'CrowModule') return moduleExports;
+    if (importerModule.toString() === 'CrowModule') return moduleExports;
 
     // Otherwise it is the `CatModule` and we are not
     // exporting the `WingsService` as cats don't fly, or do they fly? 🧐
@@ -260,14 +262,14 @@ const AnimalModule = new ProviderModule({
 });
 
 const CrowModule = new ProviderModule({
-  name: 'CrowModule',
+  identifier: Symbol('CrowModule'),
   imports: [AnimalModule],
   providers: [CrowService],
   exports: [CrowService],
 });
 
 const CatModule = new ProviderModule({
-  name: 'CatModule',
+  identifier: Symbol('CatModule'),
   imports: [AnimalModule],
   providers: [CatService],
   exports: [CatService],
@@ -308,6 +310,12 @@ Comprehensive, auto-generated documentation is available at:
 
 👉 [https://adimarianmutu.github.io/x-injection/index.html](https://adimarianmutu.github.io/x-injection/index.html)
 
+## ReactJS Implementation
+
+You want to use it within a [ReactJS](https://react.dev/) project? Don't worry, the library does already have an official implementation for React ⚛️
+
+For more details check out the [GitHub Repository](https://github.com/AdiMarianMutu/x-injection-reactjs).
+
 ## Contributing
 
 Pull requests are warmly welcomed! 😃

package/dist/index.cjs

@@ -11,30 +11,34 @@ var e, i = Object.defineProperty, t = Object.getOwnPropertyDescriptor, n = Objec
         enumerable: !0
     });
 })(s, {
-    ANONYMOUSE_MODULE_DEFAULT_ID: () => c,
-    AppModule: () => z,
+    AppModule: () => H,
     GLOBAL_APP_MODULE_ID: () => d,
-    GlobalAppModule: () => $,
-    GlobalContainer: () => V,
+    GlobalAppModule: () => z,
+    GlobalContainer: () => X,
     Inject: () => b,
     InjectFromBase: () => B,
     Injectable: () => I,
-    InjectionScope: () => u,
+    InjectionScope: () => a,
     MultiInject: () => T,
     Named: () => D,
-    Optional: () => M,
+    Optional: () => P,
     PostConstruct: () => C,
-    PreDestroy: () => A,
-    ProviderModule: () => W,
-    ProviderModuleHelpers: () => p,
-    ProviderTokenHelpers: () => f,
+    PreDestroy: () => x,
+    ProviderModule: () => $,
+    ProviderModuleHelpers: () => f,
+    ProviderTokenHelpers: () => l,
     Tagged: () => O,
     Unmanaged: () => q,
     XInjectionDynamicExportsOutOfRange: () => G,
     XInjectionError: () => F,
     XInjectionProviderModuleDisposedError: () => U,
     XInjectionProviderModuleError: () => N,
-    injectionScopeToBindingScope: () => h
+    XInjectionProviderModuleMissingIdentifierError: () => V,
+    bindingScopeToInjectionScope: () => h,
+    injectionScopeToBindingScope: () => u,
+    isClass: () => g,
+    isClassOrFunction: () => S,
+    isPlainObject: () => y
 }), module.exports = (e = s, ((e, o, s, d) => {
     if (o && "object" == typeof o || "function" == typeof o) for (let c of n(o)) r.call(e, c) || c === s || i(e, c, {
         get: () => o[c],
@@ -45,62 +49,66 @@ var e, i = Object.defineProperty, t = Object.getOwnPropertyDescriptor, n = Objec
     value: !0
 }), e));
 
-var d = "GlobalAppModule", c = "AnonymousModule", a = require("inversify"), u = function(e) {
+var d = "GlobalAppModule", c = require("inversify"), a = function(e) {
     return e[e.Singleton = 0] = "Singleton", e[e.Transient = 1] = "Transient", e[e.Request = 2] = "Request", 
     e;
 }({});
 
-function h(e) {
+function u(e) {
     switch (e) {
-      case u.Singleton:
+      case a.Singleton:
         return "Singleton";
 
-      case u.Transient:
+      case a.Transient:
         return "Transient";
 
-      case u.Request:
+      case a.Request:
         return "Request";
     }
 }
 
-function l(e) {
+function h(e) {
     switch (e) {
       case "Singleton":
-        return u.Singleton;
+        return a.Singleton;
 
       case "Transient":
-        return u.Transient;
+        return a.Transient;
 
       case "Request":
-        return u.Request;
+        return a.Request;
     }
 }
 
-o(h, "injectionScopeToBindingScope"), o(l, "bindingScopeToInjectionScope");
+o(u, "injectionScopeToBindingScope"), o(h, "bindingScopeToInjectionScope");
 
-var f, p, v = require("@inversifyjs/core");
+var l, f, p = require("@inversifyjs/core");
 
 function g(e) {
     return "function" == typeof e && /^class\s/.test(Function.prototype.toString.call(e));
 }
 
-function S(e) {
+function v(e) {
     return "[object Object]" === Object.prototype.toString.call(e);
 }
 
 function y(e) {
-    if (!1 === S(e)) return !1;
+    if (!1 === v(e)) return !1;
     const i = e.constructor;
     if (void 0 === i) return !0;
     const t = i.prototype;
-    return !1 !== S(t) && !1 !== t.hasOwnProperty("isPrototypeOf");
+    return !1 !== v(t) && !1 !== t.hasOwnProperty("isPrototypeOf");
+}
+
+function S(e) {
+    return "function" == typeof e;
 }
 
 function I(e) {
-    return void 0 === e ? (0, a.injectable)() : (0, a.injectable)(h(e));
+    return void 0 === e ? (0, c.injectable)() : (0, c.injectable)(u(e));
 }
 
-o(g, "isClass"), o(S, "isObject"), o(y, "isPlainObject"), function(e) {
+o(g, "isClass"), o(v, "isObject"), o(y, "isPlainObject"), function(e) {
     function i(e) {
         return f(e) && "useClass" in e;
     }
@@ -120,7 +128,7 @@ o(g, "isClass"), o(S, "isObject"), o(y, "isPlainObject"), function(e) {
         return e.map((e => s(e)));
     }
     function c(e, i) {
-        return u(e) ?? h(e) ?? i;
+        return u(e) ?? l(e) ?? i;
     }
     function a(e) {
         if (f(e)) return e;
@@ -129,11 +137,11 @@ o(g, "isClass"), o(S, "isObject"), o(y, "isPlainObject"), function(e) {
         const i = a(e);
         if (i) return i.scope;
     }
-    function h(e) {
+    function l(e) {
         const i = s(e);
         if (!g(i)) return;
-        const t = (0, v.getClassMetadata)(i)?.scope;
-        return t ? l(t) : void 0;
+        const t = (0, p.getClassMetadata)(i)?.scope;
+        return t ? h(t) : void 0;
     }
     function f(e) {
         return y(e) && "object" == typeof e && "provide" in e;
@@ -143,9 +151,9 @@ o(g, "isClass"), o(S, "isObject"), o(y, "isPlainObject"), function(e) {
     o(s, "toServiceIdentifier"), e.toServiceIdentifier = s, o(d, "toServiceIdentifiers"), 
     e.toServiceIdentifiers = d, o(c, "getInjectionScopeByPriority"), e.getInjectionScopeByPriority = c, 
     o(a, "tryGetProviderOptions"), e.tryGetProviderOptions = a, o(u, "tryGetScopeFromProvider"), 
-    e.tryGetScopeFromProvider = u, o(h, "tryGetDecoratorScopeFromClass"), e.tryGetDecoratorScopeFromClass = h, 
+    e.tryGetScopeFromProvider = u, o(l, "tryGetDecoratorScopeFromClass"), e.tryGetDecoratorScopeFromClass = l, 
     o(f, "hasProvideProperty");
-}(f || (f = {})), function(e) {
+}(l || (l = {})), function(e) {
     function i(e) {
         return e;
     }
@@ -154,12 +162,12 @@ o(g, "isClass"), o(S, "isObject"), o(y, "isPlainObject"), function(e) {
     }
     o(i, "buildInternalConstructorParams"), e.buildInternalConstructorParams = i, o(t, "isDynamicExport"), 
     e.isDynamicExport = t;
-}(p || (p = {})), o(I, "Injectable");
+}(f || (f = {})), o(S, "isClassOrFunction"), o(I, "Injectable");
 
 var m = require("inversify");
 
 function b(e) {
-    return (0, m.inject)(f.toServiceIdentifier(e));
+    return (0, m.inject)(l.toServiceIdentifier(e));
 }
 
 o(b, "Inject");
@@ -167,7 +175,7 @@ o(b, "Inject");
 var E = require("inversify");
 
 function T(e) {
-    return (0, E.multiInject)(f.toServiceIdentifier(e));
+    return (0, E.multiInject)(l.toServiceIdentifier(e));
 }
 
 o(T, "MultiInject");
@@ -190,32 +198,32 @@ o(D, "Named");
 
 var j = require("inversify");
 
-function M() {
+function P() {
     return (0, j.optional)();
 }
 
-o(M, "Optional");
+o(P, "Optional");
 
-var P = require("inversify");
+var M = require("inversify");
 
 function C() {
-    return (0, P.postConstruct)();
+    return (0, M.postConstruct)();
 }
 
 o(C, "PostConstruct");
 
 var k = require("inversify");
 
-function A() {
+function x() {
     return (0, k.preDestroy)();
 }
 
-o(A, "PreDestroy");
+o(x, "PreDestroy");
 
-var x = require("inversify");
+var A = require("inversify");
 
 function O(e, i) {
-    return (0, x.tagged)(e, i);
+    return (0, A.tagged)(e, i);
 }
 
 o(O, "Tagged");
@@ -257,9 +265,17 @@ var F = class e extends Error {
     constructor(e) {
         super(e, `The 'ProviderModule.${e.toString()}' is trying to dynamically export providers/modules out of the declared range of the static exports!`);
     }
-}, V = new (require("inversify").Container)({
+}, V = class e extends N {
+    static {
+        o(this, "XInjectionProviderModuleMissingIdentifierError");
+    }
+    name=e.name;
+    constructor(e) {
+        super(e, "An `identifier` must be supplied!");
+    }
+}, X = new (require("inversify").Container)({
     defaultScope: "Singleton"
-}), L = require("inversify"), X = class {
+}), L = require("inversify"), W = class {
     static {
         o(this, "ProviderModuleUtils");
     }
@@ -272,55 +288,56 @@ var F = class e extends Error {
         this.module = e, this.moduleNaked = e.toNaked();
     }
     bindToContainer(e, i) {
-        return f.isProviderIdentifier(e) ? this.bindSelfTokenToContainer(e, i) : f.isClassToken(e) ? this.bindClassTokenToContainer(e, i) : f.isValueToken(e) ? this.bindValueTokenToContainer(e) : !!f.isFactoryToken(e) && this.bindFactoryTokenToContainer(e, i);
+        return l.isProviderIdentifier(e) ? this.bindSelfTokenToContainer(e, i) : l.isClassToken(e) ? this.bindClassTokenToContainer(e, i) : l.isValueToken(e) ? this.bindValueTokenToContainer(e) : !!l.isFactoryToken(e) && this.bindFactoryTokenToContainer(e, i);
     }
     bindManyToContainer(e, i) {
         e.forEach((e => this.bindToContainer(e, i)));
     }
     bindSelfTokenToContainer(e, i) {
-        return this.setBindingScope(e, this.container.bind(f.toServiceIdentifier(e)).toSelf(), i), 
+        return this.setBindingScope(e, this.container.bind(l.toServiceIdentifier(e)).toSelf(), i), 
         this.moduleNaked.__isCurrentBound(e);
     }
     bindClassTokenToContainer(e, i) {
-        return this.setBindingOnEvent(e, this.setWhenBinding(e, this.setBindingScope(e, this.container.bind(f.toServiceIdentifier(e)).to(e.useClass), i))), 
+        return this.setBindingOnEvent(e, this.setWhenBinding(e, this.setBindingScope(e, this.container.bind(l.toServiceIdentifier(e)).to(e.useClass), i))), 
         this.moduleNaked.__isCurrentBound(e);
     }
     bindValueTokenToContainer(e) {
-        return this.setBindingOnEvent(e, this.setWhenBinding(e, this.container.bind(f.toServiceIdentifier(e)).toConstantValue(e.useValue))), 
+        return this.setBindingOnEvent(e, this.setWhenBinding(e, this.container.bind(l.toServiceIdentifier(e)).toConstantValue(e.useValue))), 
         this.moduleNaked.__isCurrentBound(e);
     }
     bindFactoryTokenToContainer(e, i) {
-        return this.setBindingOnEvent(e, this.setWhenBinding(e, this.setBindingScope(e, this.container.bind(f.toServiceIdentifier(e)).toResolvedValue(e.useFactory, f.toServiceIdentifiers(e.inject ?? [])), i))), 
+        return this.setBindingOnEvent(e, this.setWhenBinding(e, this.setBindingScope(e, this.container.bind(l.toServiceIdentifier(e)).toResolvedValue(e.useFactory, l.toServiceIdentifiers(e.inject ?? [])), i))), 
         this.moduleNaked.__isCurrentBound(e);
     }
     setBindingScope(e, i, t) {
-        if (f.isValueToken(e)) return i;
-        switch (f.getInjectionScopeByPriority(e, t)) {
-          case u.Singleton:
+        if (l.isValueToken(e)) return i;
+        switch (l.getInjectionScopeByPriority(e, t)) {
+          case a.Singleton:
             return i.inSingletonScope();
 
-          case u.Transient:
+          case a.Transient:
             return i.inTransientScope();
 
-          case u.Request:
+          case a.Request:
             return i.inRequestScope();
         }
     }
     setWhenBinding(e, i) {
-        if (f.isProviderIdentifier(e)) return i;
+        if (l.isProviderIdentifier(e)) return i;
         const t = e.when;
         return t ? i.when(t) : i;
     }
     setBindingOnEvent(e, i) {
-        if (f.isProviderIdentifier(e)) return;
+        if (l.isProviderIdentifier(e)) return;
         const t = e;
         t.onEvent?.activation && i.onActivation(t.onEvent.activation), t.onEvent?.deactivation && i.onDeactivation(t.onEvent.deactivation);
     }
-}, W = class e {
+}, $ = class e {
     static {
         o(this, "ProviderModule");
     }
     identifier;
+    isDisposed=!1;
     isAppModule;
     container;
     defaultScope;
@@ -332,9 +349,10 @@ var F = class e extends Error {
     exports;
     imports;
     registeredBindingSideEffects;
-    constructor({identifier: e = Symbol(c), imports: i, providers: t, exports: n, defaultScope: r, dynamicExports: o, onReady: s, onDispose: d, ...a}) {
-        const u = a;
-        this.identifier = e, this.isAppModule = u.isAppModule ?? !1, this.isAppModule || this._lazyInit({
+    constructor({identifier: e, imports: i, providers: t, exports: n, defaultScope: r, dynamicExports: o, onReady: s, onDispose: d, ...c}) {
+        const a = c;
+        this.identifier = this.setIdentifier(e), this.isAppModule = a.isAppModule ?? !1, 
+        this.isAppModule || this._lazyInit({
             imports: i,
             providers: t,
             exports: n,
@@ -342,7 +360,7 @@ var F = class e extends Error {
             dynamicExports: o,
             onReady: s,
             onDispose: d,
-            ...a
+            ...c
         });
     }
     get(e, i) {
@@ -357,21 +375,25 @@ var F = class e extends Error {
         }));
     }
     onActivationEvent(e, i) {
-        this.container.onActivation(f.toServiceIdentifier(e), i);
+        this.container.onActivation(l.toServiceIdentifier(e), i);
     }
     onDeactivationEvent(e, i) {
-        this.container.onDeactivation(f.toServiceIdentifier(e), i);
+        this.container.onDeactivation(l.toServiceIdentifier(e), i);
     }
     toNaked() {
         return this;
     }
     toString() {
-        return this.identifier.description;
+        return this.identifier?.description ?? "Unknown";
+    }
+    setIdentifier(e) {
+        if (!e) throw new V(this);
+        return e;
     }
     prepareContainer(e) {
-        return this.isAppModule ? e.container?.() ?? V : e.container ? (console.warn(`[xInjection]: The '${this.toString()}' module is using a dynamic container!`), 
+        return this.isAppModule ? e.container?.() ?? X : e.container ? (console.warn(`[xInjection]: The '${this.toString()}' module is using a dynamic container!`), 
         e.container()) : new L.Container({
-            parent: V,
+            parent: X,
             defaultScope: this.defaultScope.inversify
         });
     }
@@ -387,9 +409,9 @@ var F = class e extends Error {
                 }
                 const n = t;
                 this.moduleUtils.bindToContainer({
-                    scope: f.getInjectionScopeByPriority(n, i.defaultScope.native),
-                    provide: f.toServiceIdentifier(n),
-                    useFactory: o((() => i.get(n)), "useFactory")
+                    scope: l.getInjectionScopeByPriority(n, i.defaultScope.native),
+                    provide: l.toServiceIdentifier(n),
+                    useFactory: o((() => this._importedDependencyFactory(n, i)), "useFactory")
                 }, i.defaultScope.native);
             }));
         }));
@@ -420,18 +442,21 @@ var F = class e extends Error {
     shouldThrowIfDisposed() {
         if (null === this.container) throw new U(this);
     }
+    _importedDependencyFactory(e, i) {
+        return i.get(e);
+    }
     async _dispose() {
         await (this.onDispose?.(this)), await this.__unbindAll(), this.container = null, 
         this.imports = null, this.providers = null, this.exports = null, this.dynamicExports = null, 
-        this.registeredBindingSideEffects = null;
+        this.registeredBindingSideEffects = null, this.isDisposed = !0;
     }
-    _lazyInit({imports: e = [], providers: i = [], exports: t = [], defaultScope: n = u.Singleton, dynamicExports: r, onReady: o, onDispose: s, ...d}) {
-        this.imports = e, this.providers = i, this.exports = t, this.defaultScope = {
+    _lazyInit({imports: e = [], providers: i = [], exports: t = [], defaultScope: n = a.Singleton, dynamicExports: r, onReady: o, onDispose: s, ...d}) {
+        this.isDisposed = !1, this.imports = e, this.providers = i, this.exports = t, this.defaultScope = {
             native: n,
-            inversify: h(n)
+            inversify: u(n)
         }, this.dynamicExports = r, this.onReady = o, this.onDispose = s, this.container = this.prepareContainer({
             ...d
-        }), this.moduleUtils = new X(this), this.registeredBindingSideEffects = new Map, 
+        }), this.moduleUtils = new W(this), this.registeredBindingSideEffects = new Map, 
         this.injectImportedModules(this._getImportedModules()), this.injectProviders(), 
         this.onReady?.(this);
     }
@@ -458,26 +483,26 @@ var F = class e extends Error {
     }
     __bind(e) {
         this.shouldThrowIfDisposed();
-        const i = this.container.bind(f.toServiceIdentifier(e));
+        const i = this.container.bind(l.toServiceIdentifier(e));
         return this.invokeRegisteredBindingSideEffects(e, "onBind"), i;
     }
     __get(e, i) {
-        return this.shouldThrowIfDisposed(), this.container.get(f.toServiceIdentifier(e), i);
+        return this.shouldThrowIfDisposed(), this.container.get(l.toServiceIdentifier(e), i);
     }
     async __getAsync(e, i) {
-        return this.shouldThrowIfDisposed(), this.container.getAsync(f.toServiceIdentifier(e), i);
+        return this.shouldThrowIfDisposed(), this.container.getAsync(l.toServiceIdentifier(e), i);
     }
     __getAll(e, i) {
-        return this.shouldThrowIfDisposed(), this.container.getAll(f.toServiceIdentifier(e), i);
+        return this.shouldThrowIfDisposed(), this.container.getAll(l.toServiceIdentifier(e), i);
     }
     async __getAllAsync(e, i) {
-        return this.shouldThrowIfDisposed(), this.container.getAllAsync(f.toServiceIdentifier(e), i);
+        return this.shouldThrowIfDisposed(), this.container.getAllAsync(l.toServiceIdentifier(e), i);
     }
     __isBound(e, i) {
-        return this.shouldThrowIfDisposed(), this.container.isBound(f.toServiceIdentifier(e), i);
+        return this.shouldThrowIfDisposed(), this.container.isBound(l.toServiceIdentifier(e), i);
     }
     __isCurrentBound(e, i) {
-        return this.shouldThrowIfDisposed(), this.container.isCurrentBound(f.toServiceIdentifier(e), i);
+        return this.shouldThrowIfDisposed(), this.container.isCurrentBound(l.toServiceIdentifier(e), i);
     }
     __takeSnapshot() {
         this.shouldThrowIfDisposed(), this.container.snapshot();
@@ -487,33 +512,33 @@ var F = class e extends Error {
     }
     async __rebind(e) {
         this.shouldThrowIfDisposed();
-        const i = await this.container.rebind(f.toServiceIdentifier(e));
+        const i = await this.container.rebind(l.toServiceIdentifier(e));
         return this.invokeRegisteredBindingSideEffects(e, "onRebind"), i;
     }
     __rebindSync(e) {
         this.shouldThrowIfDisposed();
-        const i = this.container.rebindSync(f.toServiceIdentifier(e));
+        const i = this.container.rebindSync(l.toServiceIdentifier(e));
         return this.invokeRegisteredBindingSideEffects(e, "onRebind"), i;
     }
     async __unbind(e) {
-        this.shouldThrowIfDisposed(), await this.container.unbind(f.toServiceIdentifier(e)), 
+        this.shouldThrowIfDisposed(), await this.container.unbind(l.toServiceIdentifier(e)), 
         this.removeRegisteredBindingSideEffects(e);
     }
     __unbindSync(e) {
-        this.shouldThrowIfDisposed(), this.container.unbindSync(f.toServiceIdentifier(e)), 
+        this.shouldThrowIfDisposed(), this.container.unbindSync(l.toServiceIdentifier(e)), 
         this.removeRegisteredBindingSideEffects(e);
     }
     async __unbindAll() {
         this.shouldThrowIfDisposed(), await this.container.unbindAll(), this.removeRegisteredBindingSideEffects("all");
     }
-}, $ = class extends W {
+}, z = class extends $ {
     static {
         o(this, "GlobalAppModule");
     }
     nakedModule=this;
     isLoaded=!1;
     constructor() {
-        super(p.buildInternalConstructorParams({
+        super(f.buildInternalConstructorParams({
             identifier: Symbol(d),
             isAppModule: !0
         }));
@@ -528,4 +553,4 @@ var F = class e extends Error {
     async _dispose() {
         this.isLoaded = !1, super._dispose();
     }
-}, z = new $;//# sourceMappingURL=index.cjs.map
+}, H = new z;//# sourceMappingURL=index.cjs.map