ditox 3.2.0 → 3.3.0

package/dist/cjs/container.js

@@ -1,216 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.createContainer = exports.FACTORIES_MAP = exports.RESOLVER = exports.PARENT_CONTAINERS = exports.CONTAINER = exports.ResolverError = void 0;
-const tokens_1 = require("./tokens");
-/**
- * ResolverError is thrown by the resolver when a token is not found in a container.
- */
-class ResolverError extends Error {
-    constructor(message) {
-        super(message);
-        Object.setPrototypeOf(this, new.target.prototype);
-        this.name = 'ResolverError';
-    }
-}
-exports.ResolverError = ResolverError;
-/** @internal */
-exports.CONTAINER = (0, tokens_1.token)('ditox.Container');
-/** @internal */
-exports.PARENT_CONTAINERS = (0, tokens_1.token)('ditox.ParentContainer');
-/** @internal */
-exports.RESOLVER = (0, tokens_1.token)('ditox.Resolver');
-/** @internal */
-const NOT_FOUND = Symbol();
-/** @internal */
-const DEFAULT_SCOPE = 'singleton';
-/** @internal */
-exports.FACTORIES_MAP = (0, tokens_1.token)('ditox.FactoriesMap');
-/** @internal */
-function getScope(options) {
-    var _a;
-    return (_a = options === null || options === void 0 ? void 0 : options.scope) !== null && _a !== void 0 ? _a : DEFAULT_SCOPE;
-}
-/** @internal */
-function getOnRemoved(options) {
-    return options.scope === undefined ||
-        options.scope === 'scoped' ||
-        options.scope === 'singleton'
-        ? options.onRemoved
-        : undefined;
-}
-/** @internal */
-function isInternalToken(token) {
-    return (token.symbol === exports.CONTAINER.symbol ||
-        token.symbol === exports.PARENT_CONTAINERS.symbol ||
-        token.symbol === exports.RESOLVER.symbol);
-}
-/**
- * Creates a new dependency container.
- *
- * Container can have an optional parent to chain token resolution. The parent is used in case the current container does not have a registered token.
- *
- * @param parentArg - Optional parent container or an array of containers.
- */
-function createContainer(parentArg) {
-    const parents = parentArg
-        ? Array.isArray(parentArg)
-            ? [...parentArg]
-            : [parentArg]
-        : undefined;
-    const values = new Map();
-    const factories = new Map();
-    const container = {
-        bindValue(token, value) {
-            if (isInternalToken(token)) {
-                return;
-            }
-            values.set(token.symbol, value);
-        },
-        bindFactory(token, factory, options) {
-            if (isInternalToken(token)) {
-                return;
-            }
-            factories.set(token.symbol, { factory, options });
-        },
-        remove(token) {
-            var _a;
-            if (isInternalToken(token)) {
-                return;
-            }
-            const options = (_a = factories.get(token.symbol)) === null || _a === void 0 ? void 0 : _a.options;
-            if (options) {
-                executeOnRemoved(token.symbol, options);
-            }
-            values.delete(token.symbol);
-            factories.delete(token.symbol);
-        },
-        removeAll() {
-            factories.forEach((context, tokenSymbol) => {
-                if (context.options) {
-                    executeOnRemoved(tokenSymbol, context.options);
-                }
-            });
-            values.clear();
-            factories.clear();
-            bindInternalTokens();
-        },
-        hasToken(token) {
-            return (values.has(token.symbol) ||
-                factories.has(token.symbol) ||
-                parentContainersHaveToken(parents, token));
-        },
-        get(token) {
-            const value = resolver(token, container);
-            if (value !== NOT_FOUND) {
-                return value;
-            }
-            if (token.isOptional) {
-                return token.optionalValue;
-            }
-            return undefined;
-        },
-        resolve(token) {
-            var _a;
-            const value = resolver(token, container);
-            if (value !== NOT_FOUND) {
-                return value;
-            }
-            if (token.isOptional) {
-                return token.optionalValue;
-            }
-            throw new ResolverError(`Token "${(_a = token.symbol.description) !== null && _a !== void 0 ? _a : ''}" is not provided`);
-        },
-    };
-    function resolver(token, origin) {
-        const value = values.get(token.symbol);
-        const hasValue = value !== undefined || values.has(token.symbol);
-        if (hasValue && origin === container) {
-            return value;
-        }
-        const factoryContext = factories.get(token.symbol);
-        if (factoryContext) {
-            const scope = getScope(factoryContext.options);
-            switch (scope) {
-                case 'singleton': {
-                    if (hasValue) {
-                        return value;
-                    }
-                    else if (parentContainersHaveToken(parents, token)) {
-                        break;
-                    }
-                    else {
-                        // Cache the value in the same container where the factory is registered.
-                        const value = factoryContext.factory(container);
-                        container.bindValue(token, value);
-                        return value;
-                    }
-                }
-                case 'scoped': {
-                    if (hasValue) {
-                        return value;
-                    }
-                    else {
-                        // Create a value within the factory's container and cache it.
-                        const value = factoryContext.factory(container);
-                        container.bindValue(token, value);
-                        return value;
-                    }
-                }
-                case 'transient': {
-                    // Create a value within the origin container and don't cache it.
-                    return factoryContext.factory(origin);
-                }
-            }
-        }
-        if (hasValue) {
-            return value;
-        }
-        if (parents) {
-            return parentContainersResolveToken(parents, token, origin);
-        }
-        return NOT_FOUND;
-    }
-    function executeOnRemoved(tokenSymbol, options) {
-        const onRemoved = getOnRemoved(options);
-        if (onRemoved) {
-            const value = values.get(tokenSymbol);
-            if (value !== undefined || values.has(tokenSymbol)) {
-                onRemoved(value);
-            }
-        }
-    }
-    function bindInternalTokens() {
-        values.set(exports.CONTAINER.symbol, container);
-        values.set(exports.RESOLVER.symbol, resolver);
-        values.set(exports.FACTORIES_MAP.symbol, factories);
-        if (parents) {
-            values.set(exports.PARENT_CONTAINERS.symbol, parents);
-        }
-    }
-    bindInternalTokens();
-    return container;
-}
-exports.createContainer = createContainer;
-function parentContainersHaveToken(parents, token) {
-    if (!parents)
-        return false;
-    for (let i = 0; i < parents.length; i++) {
-        if (parents[i].hasToken(token)) {
-            return true;
-        }
-    }
-    return false;
-}
-function parentContainersResolveToken(parents, token, origin) {
-    for (const parentContainer of parents) {
-        const parentResolver = parentContainer.get(exports.RESOLVER);
-        if (parentResolver) {
-            const resolved = parentResolver(token, origin);
-            if (resolved !== NOT_FOUND) {
-                return resolved;
-            }
-        }
-    }
-    return NOT_FOUND;
-}
-//# sourceMappingURL=container.js.map

package/dist/cjs/container.js.map

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

package/dist/cjs/index.d.ts

@@ -1,7 +0,0 @@
-export { token, optional } from './tokens';
-export type { RequiredToken, OptionalToken, Token } from './tokens';
-export { ResolverError, createContainer } from './container';
-export type { FactoryScope, FactoryOptions, Container, ContainerResolver, } from './container';
-export { isToken, bindMultiValue, tryResolveValue, tryResolveValues, resolveValue, resolveValues, injectable, injectableClass, } from './utils';
-export { bindModule, bindModules, declareModule, declareModuleBindings, } from './modules';
-export type { Module, ModuleDeclaration, BindModuleOptions, ModuleBindingEntry, } from './modules';

package/dist/cjs/index.js

@@ -1,24 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.declareModuleBindings = exports.declareModule = exports.bindModules = exports.bindModule = exports.injectableClass = exports.injectable = exports.resolveValues = exports.resolveValue = exports.tryResolveValues = exports.tryResolveValue = exports.bindMultiValue = exports.isToken = exports.createContainer = exports.ResolverError = exports.optional = exports.token = void 0;
-var tokens_1 = require("./tokens");
-Object.defineProperty(exports, "token", { enumerable: true, get: function () { return tokens_1.token; } });
-Object.defineProperty(exports, "optional", { enumerable: true, get: function () { return tokens_1.optional; } });
-var container_1 = require("./container");
-Object.defineProperty(exports, "ResolverError", { enumerable: true, get: function () { return container_1.ResolverError; } });
-Object.defineProperty(exports, "createContainer", { enumerable: true, get: function () { return container_1.createContainer; } });
-var utils_1 = require("./utils");
-Object.defineProperty(exports, "isToken", { enumerable: true, get: function () { return utils_1.isToken; } });
-Object.defineProperty(exports, "bindMultiValue", { enumerable: true, get: function () { return utils_1.bindMultiValue; } });
-Object.defineProperty(exports, "tryResolveValue", { enumerable: true, get: function () { return utils_1.tryResolveValue; } });
-Object.defineProperty(exports, "tryResolveValues", { enumerable: true, get: function () { return utils_1.tryResolveValues; } });
-Object.defineProperty(exports, "resolveValue", { enumerable: true, get: function () { return utils_1.resolveValue; } });
-Object.defineProperty(exports, "resolveValues", { enumerable: true, get: function () { return utils_1.resolveValues; } });
-Object.defineProperty(exports, "injectable", { enumerable: true, get: function () { return utils_1.injectable; } });
-Object.defineProperty(exports, "injectableClass", { enumerable: true, get: function () { return utils_1.injectableClass; } });
-var modules_1 = require("./modules");
-Object.defineProperty(exports, "bindModule", { enumerable: true, get: function () { return modules_1.bindModule; } });
-Object.defineProperty(exports, "bindModules", { enumerable: true, get: function () { return modules_1.bindModules; } });
-Object.defineProperty(exports, "declareModule", { enumerable: true, get: function () { return modules_1.declareModule; } });
-Object.defineProperty(exports, "declareModuleBindings", { enumerable: true, get: function () { return modules_1.declareModuleBindings; } });
-//# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;AAAA,mCAAyC;AAAjC,+FAAA,KAAK,OAAA;AAAE,kGAAA,QAAQ,OAAA;AAGvB,yCAA2D;AAAnD,0GAAA,aAAa,OAAA;AAAE,4GAAA,eAAe,OAAA;AAQtC,iCASiB;AARf,gGAAA,OAAO,OAAA;AACP,uGAAA,cAAc,OAAA;AACd,wGAAA,eAAe,OAAA;AACf,yGAAA,gBAAgB,OAAA;AAChB,qGAAA,YAAY,OAAA;AACZ,sGAAA,aAAa,OAAA;AACb,mGAAA,UAAU,OAAA;AACV,wGAAA,eAAe,OAAA;AAGjB,qCAKmB;AAJjB,qGAAA,UAAU,OAAA;AACV,sGAAA,WAAW,OAAA;AACX,wGAAA,aAAa,OAAA;AACb,gHAAA,qBAAqB,OAAA"}

package/dist/cjs/modules.d.ts

@@ -1,121 +0,0 @@
-import { Container } from './container';
-import { Token } from './tokens';
-type AnyObject = Record<string, any>;
-type EmptyObject = Record<string, never>;
-type ModuleController = {
-    /** Dispose the module and clean its resources */
-    destroy?: () => void;
-};
-/**
- * Dependency module
- *
- * @example
- * ```ts
- * type LoggerModule = Module<{
- *   logger: Logger;
- * }>;
- * ```
- */
-export type Module<ModuleProps extends AnyObject = EmptyObject> = ModuleController & ModuleProps;
-type GetModuleProps<T> = T extends Module<infer Props> ? Props : never;
-/**
- * Description how to bind the module in declarative way.
- *
- * @example
- * ```ts
- * const LOGGER_MODULE: ModuleDeclaration<LoggerModule> = {
- *   token: LOGGER_MODULE_TOKEN,
- *   factory: (container) => {
- *     const transport = container.resolve(TRANSPORT_TOKEN).open();
- *     return {
- *       logger: { log: (message) => transport.write(message) },
- *       destroy: () => transport.close(),
- *     }
- *   },
- *   exports: {
- *     logger: LOGGER_TOKEN,
- *   },
- * };
- * ```
- */
-export type ModuleDeclaration<T extends Module<AnyObject>> = {
-    /** Token for the module */
-    token: Token<T>;
-    /** Modules for binding  */
-    imports?: ReadonlyArray<ModuleBindingEntry>;
-    /** Factory of the module */
-    factory: (container: Container) => T;
-    /** Dictionary of module properties which are bound to tokens. */
-    exports?: {
-        [K in keyof GetModuleProps<T>]?: Token<GetModuleProps<T>[K]>;
-    };
-    /** Callback could be used to prepare an environment. It is called before binding the module. */
-    beforeBinding?: (container: Container) => void;
-    /** Callback could be used to export complex dependencies from the module. It is called after binding the module.  */
-    afterBinding?: (container: Container) => void;
-};
-export type AnyModuleDeclaration = ModuleDeclaration<Module<AnyObject>>;
-/**
- * Options for module binding.
- *
- * `scope` types:
- *   - `singleton` - **This is the default**. The value is created and cached by the most distant parent container which owns the factory function.
- *   - `scoped` - The value is created and cached by the nearest container which owns the factory function.
- */
-export type BindModuleOptions = {
-    scope?: 'scoped' | 'singleton';
-};
-type ModuleDeclarationWithOptions = {
-    module: ModuleDeclaration<AnyObject>;
-    options: BindModuleOptions;
-};
-export type ModuleBindingEntry = ModuleDeclaration<AnyObject> | ModuleDeclarationWithOptions;
-/**
- * Binds the dependency module to the container
- * @param container - Dependency container.
- * @param moduleDeclaration - Declaration of the dependency module.
- * @param options - Options for module binding.
- *
- * @example
- * ```ts
- * bindModule(container, LOGGER_MODULE);
- * ```
- */
-export declare function bindModule<T extends Module<AnyObject>>(container: Container, moduleDeclaration: ModuleDeclaration<T>, options?: BindModuleOptions): void;
-/**
- * Binds dependency modules to the container
- *
- * @param container - Dependency container for binding
- * @param modules - Array of module binding entries: module declaration or `{module: ModuleDeclaration, options: BindModuleOptions}` objects.
- */
-export declare function bindModules(container: Container, modules: ReadonlyArray<ModuleBindingEntry>): void;
-/**
- * Declares a module binding
- *
- * @param declaration - a module declaration
- * @param declaration.token - optional field
- *
- *  @example
- * ```ts
- * const LOGGER_MODULE = declareModule<LoggerModule>({
- *   factory: (container) => {
- *     const transport = container.resolve(TRANSPORT_TOKEN).open();
- *     return {
- *       logger: { log: (message) => transport.write(message) },
- *       destroy: () => transport.close(),
- *     }
- *   },
- *   exports: {
- *     logger: LOGGER_TOKEN,
- *   },
- * });
- * ```
- */
-export declare function declareModule<T extends Module<AnyObject>>(declaration: Omit<ModuleDeclaration<T>, 'token'> & Partial<Pick<ModuleDeclaration<T>, 'token'>>): ModuleDeclaration<T>;
-/**
- * Declares bindings of several modules
- *
- * @param modules - module declaration entries
- */
-export declare function declareModuleBindings(modules: ReadonlyArray<ModuleBindingEntry>): ModuleDeclaration<Module>;
-export {};

package/dist/cjs/modules.js

@@ -1,143 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.declareModuleBindings = exports.declareModule = exports.bindModules = exports.bindModule = void 0;
-const tokens_1 = require("./tokens");
-const utils_1 = require("./utils");
-/**
- * Binds the dependency module to the container
- * @param container - Dependency container.
- * @param moduleDeclaration - Declaration of the dependency module.
- * @param options - Options for module binding.
- *
- * @example
- * ```ts
- * bindModule(container, LOGGER_MODULE);
- * ```
- */
-function bindModule(container, moduleDeclaration, options) {
-    var _a, _b, _c;
-    const rootEntry = {
-        module: moduleDeclaration,
-        options: options !== null && options !== void 0 ? options : {},
-    };
-    const bfsVisits = new Set([rootEntry]);
-    const bfsQueue = [rootEntry];
-    let bfsIndex = 0;
-    while (bfsIndex < bfsQueue.length) {
-        const entry = bfsQueue[bfsIndex];
-        const m = 'module' in entry ? entry.module : entry;
-        (_a = m.imports) === null || _a === void 0 ? void 0 : _a.forEach((depEntry) => {
-            if (!bfsVisits.has(depEntry)) {
-                bfsVisits.add(depEntry);
-                bfsQueue.push(depEntry);
-            }
-        });
-        bfsIndex++;
-    }
-    for (let i = 0; i < bfsQueue.length; i++) {
-        const entry = bfsQueue[i];
-        const m = 'module' in entry ? entry.module : entry;
-        (_b = m.beforeBinding) === null || _b === void 0 ? void 0 : _b.call(m, container);
-    }
-    for (let i = 0; i < bfsQueue.length; i++) {
-        const entry = bfsQueue[i];
-        bindModuleEntry(container, entry);
-    }
-    for (let i = bfsQueue.length - 1; i >= 0; i--) {
-        const entry = bfsQueue[i];
-        const m = 'module' in entry ? entry.module : entry;
-        (_c = m.afterBinding) === null || _c === void 0 ? void 0 : _c.call(m, container);
-    }
-}
-exports.bindModule = bindModule;
-function bindModuleEntry(container, entry) {
-    let module;
-    let options;
-    if ('module' in entry) {
-        module = entry.module;
-        options = entry.options;
-    }
-    else {
-        module = entry;
-    }
-    const scope = options === null || options === void 0 ? void 0 : options.scope;
-    const exportedValueTokens = new Set();
-    const moduleExports = module.exports;
-    if (moduleExports) {
-        const keys = Object.keys(moduleExports);
-        keys.forEach((valueKey) => {
-            const valueToken = moduleExports[valueKey];
-            if (valueToken) {
-                exportedValueTokens.add(valueToken);
-                container.bindFactory(valueToken, (0, utils_1.injectable)((module) => module[valueKey], module.token), { scope });
-            }
-        });
-    }
-    container.bindFactory(module.token, module.factory, {
-        scope,
-        onRemoved: (moduleInstance) => {
-            if (moduleInstance.destroy) {
-                moduleInstance.destroy();
-            }
-            exportedValueTokens.forEach((valueToken) => container.remove(valueToken));
-            exportedValueTokens.clear();
-        },
-    });
-}
-/**
- * Binds dependency modules to the container
- *
- * @param container - Dependency container for binding
- * @param modules - Array of module binding entries: module declaration or `{module: ModuleDeclaration, options: BindModuleOptions}` objects.
- */
-function bindModules(container, modules) {
-    modules.forEach((entry) => {
-        if ('module' in entry) {
-            bindModule(container, entry.module, entry.options);
-        }
-        else {
-            bindModule(container, entry);
-        }
-    });
-}
-exports.bindModules = bindModules;
-/**
- * Declares a module binding
- *
- * @param declaration - a module declaration
- * @param declaration.token - optional field
- *
- *  @example
- * ```ts
- * const LOGGER_MODULE = declareModule<LoggerModule>({
- *   factory: (container) => {
- *     const transport = container.resolve(TRANSPORT_TOKEN).open();
- *     return {
- *       logger: { log: (message) => transport.write(message) },
- *       destroy: () => transport.close(),
- *     }
- *   },
- *   exports: {
- *     logger: LOGGER_TOKEN,
- *   },
- * });
- * ```
- */
-function declareModule(declaration) {
-    var _a;
-    return { ...declaration, token: (_a = declaration.token) !== null && _a !== void 0 ? _a : (0, tokens_1.token)() };
-}
-exports.declareModule = declareModule;
-/**
- * Declares bindings of several modules
- *
- * @param modules - module declaration entries
- */
-function declareModuleBindings(modules) {
-    return declareModule({
-        factory: () => ({}),
-        imports: modules,
-    });
-}
-exports.declareModuleBindings = declareModuleBindings;
-//# sourceMappingURL=modules.js.map

package/dist/cjs/modules.js.map

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

package/dist/cjs/tokens.d.ts

@@ -1,56 +0,0 @@
-/**
- * @ignore
- * Binding token for mandatory value
- */
-export type RequiredToken<T> = {
-    symbol: symbol;
-    type?: T;
-    isOptional?: false;
-};
-/**
- * @ignore
- * Binding token for optional value
- */
-export type OptionalToken<T> = {
-    symbol: symbol;
-    type?: T;
-    isOptional: true;
-    optionalValue: T;
-};
-/**
- * Binding token
- */
-export type Token<T> = RequiredToken<T> | OptionalToken<T>;
-/**
- * Token options
- */
-export type TokenOptions = {
-    /**
-     * Key for token's symbol. It allows to create shareable tokens.
-     */
-    key: string;
-    /** @ignore */
-    description?: undefined;
-} | {
-    /** Description for better error messages */
-    description?: string;
-    /** @ignore */
-    key?: undefined;
-};
-/**
- * Creates a new binding token.
- * @param description - Token description for better error messages.
- */
-export declare function token<T>(description?: string): Token<T>;
-/**
- * Creates a new binding token.
- * @param options - Token description for better error messages.
- */ export declare function token<T>(options?: TokenOptions): Token<T>;
-/**
- * Decorate a token with an optional value.
- * This value is be used as default value in case a container does not have registered token.
- * @param token - Existed token.
- * @param optionalValue - Default value for the resolver.
- */
-export declare function optional<T>(token: Token<T>, optionalValue: T): OptionalToken<T>;
-export declare function optional<T>(token: Token<T>): OptionalToken<T | undefined>;

package/dist/cjs/tokens.js

@@ -1,20 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.optional = exports.token = void 0;
-function token(options) {
-    const normalized = typeof options === 'string' ? { description: options } : options;
-    const symbol = (normalized === null || normalized === void 0 ? void 0 : normalized.key)
-        ? Symbol.for(normalized.key)
-        : Symbol(normalized === null || normalized === void 0 ? void 0 : normalized.description);
-    return { symbol };
-}
-exports.token = token;
-function optional(token, optionalValue) {
-    return {
-        symbol: token.symbol,
-        isOptional: true,
-        optionalValue,
-    };
-}
-exports.optional = optional;
-//# sourceMappingURL=tokens.js.map

package/dist/cjs/tokens.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"tokens.js","sourceRoot":"","sources":["../../src/tokens.ts"],"names":[],"mappings":";;;AAwDA,SAAgB,KAAK,CAAI,OAA+B;IACtD,MAAM,UAAU,GACd,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAC,WAAW,EAAE,OAAO,EAAC,CAAC,CAAC,CAAC,OAAO,CAAC;IAEjE,MAAM,MAAM,GAAW,CAAA,UAAU,aAAV,UAAU,uBAAV,UAAU,CAAE,GAAG;QACpC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC;QAC5B,CAAC,CAAC,MAAM,CAAC,UAAU,aAAV,UAAU,uBAAV,UAAU,CAAE,WAAW,CAAC,CAAC;IAEpC,OAAO,EAAC,MAAM,EAAC,CAAC;AAClB,CAAC;AATD,sBASC;AAaD,SAAgB,QAAQ,CACtB,KAAe,EACf,aAAiB;IAEjB,OAAO;QACL,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,UAAU,EAAE,IAAI;QAChB,aAAa;KACd,CAAC;AACJ,CAAC;AATD,4BASC"}