nano-injector 1.0.3 → 1.0.5

package/lib/Binder.js

@@ -1,86 +1,83 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Binder = exports.NoCreationMethodSpecifiedError = void 0;
-class NoCreationMethodSpecifiedError extends Error {
-    constructor() {
-        super('No creation method specified');
-    }
-}
-exports.NoCreationMethodSpecifiedError = NoCreationMethodSpecifiedError;
-/**
- * Class through which is defined how to create value for this binder
- */
-class Binder {
-    constructor(injector) {
-        this.injector = injector;
-    }
-    /**
-     * Creates the new value if needed through previously defined method, and returns it
-     */
-    getValue() {
-        if (this.value !== undefined) {
-            return this.value;
-        }
-        if (this.isSingleton) {
-            this.value = this.createValue();
-            return this.value;
-        }
-        return this.createValue();
-    }
-    /**
-     * Directly defines value for this binder
-     * @param value
-     */
-    toValue(value) {
-        this.value = value;
-        this.factory = undefined;
-        this.ctor = undefined;
-        return this;
-    }
-    /**
-     * Defines constructor as a method for creating value. All previously defined methods
-     * will be ignored
-     * @param ctor
-     */
-    toConstructor(ctor) {
-        this.ctor = ctor;
-        this.factory = undefined;
-        this.value = undefined;
-        return this;
-    }
-    /**
-     * Defines factory as a method for creating value. All previously defined methods
-     * will be ignored
-     * @param factory
-     */
-    toFactory(factory) {
-        this.factory = factory;
-        this.ctor = undefined;
-        this.value = undefined;
-        return this;
-    }
-    /**
-     * Defines whether value should be a singleton. If yes the value will be created only once
-     * and the same instance will be returned forever
-     * @param value
-     */
-    asSingleton(value = true) {
-        this.isSingleton = value;
-        return this;
-    }
-    /**
-     * Creates value through previously defined method
-     * @private
-     */
-    createValue() {
-        if (this.ctor != null) {
-            // eslint-disable-next-line new-cap
-            return new this.ctor();
-        }
-        if (this.factory != null) {
-            return this.factory(this.injector);
-        }
-        throw new NoCreationMethodSpecifiedError();
-    }
-}
-exports.Binder = Binder;
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Binder = exports.NoCreationMethodSpecifiedError = void 0;
+class NoCreationMethodSpecifiedError extends Error {
+    constructor() {
+        super('No creation method specified');
+    }
+}
+exports.NoCreationMethodSpecifiedError = NoCreationMethodSpecifiedError;
+/**
+ * A class that defines how to create a value for this binder.
+ */
+class Binder {
+    constructor(injector) {
+        this.injector = injector;
+        this.isSingleton = false;
+    }
+    /**
+     * Creates a new value (if needed) using the defined creation method, and returns it.
+     */
+    getValue() {
+        if (this.value !== undefined) {
+            return this.value;
+        }
+        if (this.isSingleton) {
+            this.value = this.createValue();
+            return this.value;
+        }
+        return this.createValue();
+    }
+    /**
+     * Sets a specific value for this binder.
+     * @param value
+     */
+    toValue(value) {
+        this.value = value;
+        this.factory = undefined;
+        this.ctor = undefined;
+        return this;
+    }
+    /**
+     * Use a class constructor to create the value. Previous creation methods are cleared.
+     * @param ctor
+     */
+    toConstructor(ctor) {
+        this.ctor = ctor;
+        this.factory = undefined;
+        this.value = undefined;
+        return this;
+    }
+    /**
+     * Use a factory function to create the value. Previous creation methods are cleared.
+     * @param factory
+     */
+    toFactory(factory) {
+        this.factory = factory;
+        this.ctor = undefined;
+        this.value = undefined;
+        return this;
+    }
+    /**
+     * Configures whether the value should be a singleton. If true, the value is created once and reused for all subsequent requests.
+     * @param value
+     */
+    asSingleton(value = true) {
+        this.isSingleton = value;
+        return this;
+    }
+    /**
+     * Creates the value using the configured creation method.
+     * @private
+     */
+    createValue() {
+        if (this.ctor != null) {
+            return new this.ctor();
+        }
+        if (this.factory != null) {
+            return this.factory(this.injector);
+        }
+        throw new NoCreationMethodSpecifiedError();
+    }
+}
+exports.Binder = Binder;

package/lib/Injector.js

@@ -1,159 +1,158 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Injector = exports.$Injector = exports.NoBinderError = exports.CircularDependencyError = void 0;
-const Binder_1 = require("./Binder");
-const Provider_1 = require("./Provider");
-const InjectorsStack_1 = require("./InjectorsStack");
-/**
- * Thrown when circular dependency is detected
- */
-class CircularDependencyError extends Error {
-    constructor(providers) {
-        const providerNames = providers.map(Provider_1.getProviderName)
-            .map((name) => name !== null && name !== void 0 ? name : '?');
-        super(`Circular dependency detected: ${providerNames.join('->')}`);
-    }
-}
-exports.CircularDependencyError = CircularDependencyError;
-class NoBinderError extends Error {
-    constructor(provider) {
-        var _a;
-        const providerName = (_a = (0, Provider_1.getProviderName)(provider)) !== null && _a !== void 0 ? _a : 'unknown';
-        super(`Value of ${providerName} provider is not found`);
-    }
-}
-exports.NoBinderError = NoBinderError;
-/**
- * Provider which every injector binds itself to
- */
-exports.$Injector = (0, Provider_1.createProvider)();
-/**
- * Main entity in the library, which holds provider's bindings and through which
- * dependencies are resolved
- */
-class Injector {
-    /**
-     * @param params.name name of the injector which can be useful mainly for debugging purposes
-     * @param params.parent parent injector for the composition of injectors
-     * @param params.logger specific log function if the custom output is required
-     */
-    constructor(params = {}) {
-        this.binders = new Map();
-        this.resolvingProviders = [];
-        const { name, parent, logger = console.warn } = params;
-        this.name = name;
-        this.parent = parent;
-        this.logger = logger;
-        this.bindProvider(exports.$Injector).toValue(this);
-    }
-    /**
-     * Creates new binder and joins it to the specified providers. If the provider
-     * is already bound, then overriding occurs
-     * @param providers providers which the binder should be joined to
-     */
-    bindProvider(...providers) {
-        const binder = new Binder_1.Binder(this);
-        providers.forEach((provider) => this.binders.set(provider, binder));
-        return binder;
-    }
-    /**
-     * Resolves all providers to their values and assigns them to the specified instance
-     * @param instance
-     * @param providers
-     */
-    injectValues(instance, providers) {
-        Object.entries(providers)
-            .filter(([, value]) => (0, Provider_1.isProvider)(value))
-            .forEach(([name, provider]) => {
-            // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
-            instance[name] = this.getValue(provider);
-        });
-    }
-    /**
-     * Activates this injector and creates new instance of the type with the provided arguments
-     * @param type
-     * @param args
-     */
-    createInstance(type, ...args) {
-        // eslint-disable-next-line new-cap
-        return this.activateAndCall(() => new type(...args));
-    }
-    /**
-     * Activates this injector and calls the function with provided arguments
-     * @param func function which should be called
-     * @param args args which should be passed to the called function
-     */
-    callFunc(func, ...args) {
-        return this.activateAndCall(() => func(...args));
-    }
-    /**
-     * Returns bound to the specified provider value. If the value is not found
-     * exception is thrown
-     * @param provider
-     */
-    getValue(provider) {
-        const binder = this.getBinder(provider);
-        this.pushResolvingProvider(provider);
-        const value = this.activateAndCall(() => binder.getValue());
-        this.popResolvingProvder();
-        return value;
-    }
-    tryGetValue(provider, defValue) {
-        try {
-            return this.getValue(provider);
-        }
-        catch (err) {
-            if (err instanceof NoBinderError) {
-                return defValue;
-            }
-            throw err;
-        }
-    }
-    pushResolvingProvider(provider) {
-        this.checkCircularDependency(provider);
-        this.resolvingProviders.push(provider);
-    }
-    popResolvingProvder() {
-        this.resolvingProviders.pop();
-    }
-    getBinder(provider) {
-        const binder = this.tryGetBinderRecursively(provider);
-        if (binder == null) {
-            throw new NoBinderError(provider);
-        }
-        return binder;
-    }
-    /**
-     * Finds binder for the specified provider recursively up to the root injector
-     * @param provider
-     * @private
-     */
-    tryGetBinderRecursively(provider) {
-        var _a, _b;
-        return ((_a = this.binders.get(provider)) !== null && _a !== void 0 ? _a : (_b = this.parent) === null || _b === void 0 ? void 0 : _b.tryGetBinderRecursively(provider));
-    }
-    /**
-     * Checks is there circular dependency and throws error if so
-     * @param provider
-     * @private
-     */
-    checkCircularDependency(provider) {
-        const i = this.resolvingProviders.indexOf(provider);
-        if (i !== -1) {
-            const providers = [...this.resolvingProviders.slice(i), provider];
-            throw new CircularDependencyError(providers);
-        }
-    }
-    /**
-     * Temporary activates this injector calls provided function and returns its value
-     * @param func
-     * @private
-     */
-    activateAndCall(func) {
-        InjectorsStack_1.InjectorsStack.push(this);
-        const value = func();
-        InjectorsStack_1.InjectorsStack.pop();
-        return value;
-    }
-}
-exports.Injector = Injector;
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Injector = exports.$Injector = exports.NoBinderError = exports.CircularDependencyError = void 0;
+const Binder_1 = require("./Binder");
+const Provider_1 = require("./Provider");
+const InjectorsStack_1 = require("./InjectorsStack");
+/**
+ * Error thrown when a circular dependency is detected.
+ */
+class CircularDependencyError extends Error {
+    constructor(providers) {
+        const providerNames = providers.map(Provider_1.getProviderName).map((name) => name !== null && name !== void 0 ? name : '?');
+        super(`Circular dependency detected: ${providerNames.join('->')}`);
+    }
+}
+exports.CircularDependencyError = CircularDependencyError;
+class NoBinderError extends Error {
+    constructor(provider) {
+        var _a;
+        const providerName = (_a = (0, Provider_1.getProviderName)(provider)) !== null && _a !== void 0 ? _a : 'unknown';
+        super(`Value of ${providerName} provider is not found`);
+    }
+}
+exports.NoBinderError = NoBinderError;
+/**
+ * The provider to which every injector binds itself.
+ */
+exports.$Injector = (0, Provider_1.createProvider)();
+/**
+ * The central entity of the library. It holds provider bindings and resolves dependencies.
+ */
+class Injector {
+    /**
+     * @param params.name Name of the injector (useful for debugging).
+     * @param params.parent Parent injector for composing injectors.
+     * @param params.logger Custom logger function.
+     */
+    constructor(params = {}) {
+        this.binders = new Map();
+        this.resolvingProviders = [];
+        const { name, parent, logger = console.warn } = params;
+        this.name = name;
+        this.parent = parent;
+        this.logger = logger;
+        this.bindProvider(exports.$Injector).toValue(this);
+    }
+    /**
+     * Creates a new binder and links it to the specified providers.
+     * If a provider is already bound, the binding is overridden.
+     * @param providers The providers to bind.
+     */
+    bindProvider(...providers) {
+        const binder = new Binder_1.Binder(this);
+        providers.forEach((provider) => this.binders.set(provider, binder));
+        return binder;
+    }
+    /**
+     * Resolves specific providers to their values and assigns them to the instance's properties.
+     * @param instance
+     * @param providers
+     */
+    injectValues(instance, providers) {
+        Object.keys(providers).forEach((key) => {
+            const provider = providers[key];
+            if ((0, Provider_1.isProvider)(provider)) {
+                instance[key] = this.getValue(provider);
+            }
+        });
+    }
+    /**
+     * Activates the injector and creates a new instance of the given class using the provided arguments.
+     * @param type
+     * @param args
+     */
+    createInstance(type, ...args) {
+        return this.activateAndCall(() => new type(...args));
+    }
+    /**
+     * Activates the injector and calls the given function with the provided arguments.
+     * @param func function which should be called
+     * @param args args which should be passed to the called function
+     */
+    callFunc(func, ...args) {
+        return this.activateAndCall(() => func(...args));
+    }
+    /**
+     * Returns the value bound to the specified provider. Throws an exception if the value is not found.
+     * @param provider
+     */
+    getValue(provider) {
+        const binder = this.getBinder(provider);
+        this.pushResolvingProvider(provider);
+        const value = this.activateAndCall(() => binder.getValue());
+        this.popResolvingProvder();
+        return value;
+    }
+    tryGetValue(provider, defValue) {
+        try {
+            return this.getValue(provider);
+        }
+        catch (err) {
+            if (err instanceof NoBinderError) {
+                return defValue;
+            }
+            throw err;
+        }
+    }
+    pushResolvingProvider(provider) {
+        this.checkCircularDependency(provider);
+        this.resolvingProviders.push(provider);
+    }
+    popResolvingProvder() {
+        this.resolvingProviders.pop();
+    }
+    getBinder(provider) {
+        const binder = this.tryGetBinderRecursively(provider);
+        if (binder == null) {
+            throw new NoBinderError(provider);
+        }
+        return binder;
+    }
+    /**
+     * Recursively looks up the binder for the specified provider, traversing up to the root injector.
+     * @param provider
+     * @private
+     */
+    tryGetBinderRecursively(provider) {
+        var _a, _b;
+        return ((_a = this.binders.get(provider)) !== null && _a !== void 0 ? _a : (_b = this.parent) === null || _b === void 0 ? void 0 : _b.tryGetBinderRecursively(provider));
+    }
+    /**
+     * Checks for circular dependencies and throws an error if one is detected.
+     * @param provider
+     * @private
+     */
+    checkCircularDependency(provider) {
+        const i = this.resolvingProviders.indexOf(provider);
+        if (i !== -1) {
+            const providers = [...this.resolvingProviders.slice(i), provider];
+            throw new CircularDependencyError(providers);
+        }
+    }
+    /**
+     * Temporarily activates this injector to execute the provided function and return its result.
+     * @param func
+     * @private
+     */
+    activateAndCall(func) {
+        InjectorsStack_1.InjectorsStack.push(this);
+        try {
+            return func();
+        }
+        finally {
+            InjectorsStack_1.InjectorsStack.pop();
+        }
+    }
+}
+exports.Injector = Injector;

package/lib/InjectorsStack.js

@@ -1,33 +1,33 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.InjectorsStack = exports.NoActiveInjectorError = void 0;
-class NoActiveInjectorError extends Error {
-    constructor() {
-        super('No active injector found');
-    }
-}
-exports.NoActiveInjectorError = NoActiveInjectorError;
-/**
- * Private class for holding current active injector
- */
-class _InjectorsStack {
-    constructor() {
-        this.injectors = [];
-    }
-    get activeInjector() {
-        if (this._activeInjector == null) {
-            throw new NoActiveInjectorError();
-        }
-        return this._activeInjector;
-    }
-    push(injector) {
-        if (this._activeInjector != null) {
-            this.injectors.push(this._activeInjector);
-        }
-        this._activeInjector = injector;
-    }
-    pop() {
-        this._activeInjector = this.injectors.pop();
-    }
-}
-exports.InjectorsStack = new _InjectorsStack();
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InjectorsStack = exports.NoActiveInjectorError = void 0;
+class NoActiveInjectorError extends Error {
+    constructor() {
+        super('No active injector found');
+    }
+}
+exports.NoActiveInjectorError = NoActiveInjectorError;
+/**
+ * Private class to manage the stack of active injectors.
+ */
+class _InjectorsStack {
+    constructor() {
+        this.injectors = [];
+    }
+    get activeInjector() {
+        if (this._activeInjector == null) {
+            throw new NoActiveInjectorError();
+        }
+        return this._activeInjector;
+    }
+    push(injector) {
+        if (this._activeInjector != null) {
+            this.injectors.push(this._activeInjector);
+        }
+        this._activeInjector = injector;
+    }
+    pop() {
+        this._activeInjector = this.injectors.pop();
+    }
+}
+exports.InjectorsStack = new _InjectorsStack();