ditox 1.4.0 → 2.1.0

package/README.md

@@ -2,7 +2,7 @@
 
 <img alt="lemon" src="https://raw.githubusercontent.com/mnasyrov/ditox/master/lemon.svg" width="120" />
 
-Detoxed dependency injection container.
+Powerful dependency injection container for building modular apps.
 
 [![npm](https://img.shields.io/npm/v/ditox.svg)](https://www.npmjs.com/package/ditox)
 [![downloads](https://img.shields.io/npm/dt/ditox.svg)](https://www.npmjs.com/package/ditox)
@@ -34,7 +34,7 @@ Detoxed dependency injection container.
 - Scoped containers
 - Dependency modules
 - Multi-value tokens
-- Typescript and Flow typings
+- Typescript typings
 - Supports Node.js, Deno and browsers
 
 ## Installation
@@ -119,7 +119,8 @@ container.bindFactory(
 // A factory can have `transient` lifetime to create a value on each resolving.
 container.bindFactory(TOKENS.Logger, createLogger, {scope: 'transient'});
 
-// Classes are provided by factories.
+// A class can be injected by `injectableClass()` which calls its constructor
+// with injected dependencies as arguments.
 container.bindFactory(
   TOKENS.UserService,
   injectable(
@@ -194,7 +195,7 @@ const createLogger = (tag) => (message) => console.log(`[${tag}] ${message}`);
 
 const parent = createContainer();
 parent.bindValue(TAG, 'parent');
-parent.bindFactory(LOGGER, injectable(createLogger, TAG, {scope: 'singleton'}));
+parent.bindFactory(LOGGER, injectable(createLogger, TAG), {scope: 'singleton'});
 
 const container1 = createContainer(parent);
 container1.bindValue(TAG, 'container1');
@@ -221,7 +222,7 @@ const createLogger = (tag) => (message) => console.log(`[${tag}] ${message}`);
 
 const parent = createContainer();
 // `scoped` is default scope and can be omitted.
-parent.bindFactory(LOGGER, injectable(createLogger, TAG, {scope: 'scoped'}));
+parent.bindFactory(LOGGER, injectable(createLogger, TAG), {scope: 'scoped'});
 
 const container1 = createContainer(parent);
 container1.bindValue(TAG, 'container1');
@@ -251,7 +252,7 @@ const createLogger = (tag) => (message) => console.log(`[${tag}] ${message}`);
 
 const parent = createContainer();
 parent.bindValue(TAG, 'parent');
-parent.bindFactory(LOGGER, injectable(createLogger, TAG, {scope: 'singleton'}));
+parent.bindFactory(LOGGER, injectable(createLogger, TAG), {scope: 'singleton'});
 
 const container1 = createContainer(parent);
 container1.bindValue(TAG, 'container1');

package/dist/{index.d.ts → browser/index.d.ts}

@@ -102,46 +102,162 @@ declare type Container = {
  */
 declare function createContainer(parentContainer?: Container): Container;
 
-declare type ValuesProps = {
+declare type ValuesProps$1 = {
     [key: string]: unknown;
 };
-declare type TokenProps<Props extends ValuesProps> = {
+declare type TokenProps$1<Props extends ValuesProps$1> = {
     [K in keyof Props]: Token<Props[K]>;
 };
+/**
+ * Checks if a value is the token
+ */
+declare function isToken<T>(value: unknown): value is Token<T>;
 /**
  * Rebinds the array by the token with added new value.
  * @param container - Dependency container.
  * @param token - Token for an array of values.
  * @param value - New value which is added to the end of the array.
  */
-declare function bindMultiValue<T>(container: Container, token: Token<Array<T>>, value: T): void;
+declare function bindMultiValue<T>(container: Container, token: Token<ReadonlyArray<T>>, value: T): void;
 /**
- * Returns an array of resolved values by the specified token.
+ * Tries to resolve a value by the provided token.
+ *
+ * If an argument is an object which has tokens as its properties,
+ * then returns an object containing resolved values as properties.
+
  * If a token is not found, then `undefined` value is used.
+ *
+ * @example
+ * ```ts
+ * const value = tryResolveValue(container, tokenA);
+ * console.log(value); // 1
+ *
+ * const props = tryResolveValue(container, {a: tokenA, b: tokenB});
+ * console.log(props); // {a: 1, b: 2}
+ * ```
  */
-declare function getValues<Tokens extends Token<unknown>[], Values extends {
-    [K in keyof Tokens]: Tokens[K] extends Token<infer V> ? V : never;
+declare function tryResolveValue<Tokens extends Token<unknown> | {
+    [key: string]: Token<unknown>;
+}, Values extends Tokens extends Token<infer V> ? V | undefined : Tokens extends TokenProps$1<infer Props> ? Partial<Props> : never>(container: Container, token: Tokens): Values;
+/**
+ * Returns an array of resolved values or objects with resolved values.
+ *
+ * If an item of the array is an object which has tokens as its properties,
+ * then returns an object containing resolved values as properties.
+
+ * If a token is not found, then `undefined` value is used.
+ *
+ * @example
+ * ```ts
+ * const items1 = tryResolveValues(container, tokenA);
+ * console.log(items1); // [1]
+ *
+ * const items2 = tryResolveValues(container, tokenA, {a: tokenA, b: tokenB});
+ * console.log(items2); // [1, {a: 1, b: 2}]
+ * ```
+ */
+declare function tryResolveValues<Tokens extends (Token<unknown> | {
+    [key: string]: Token<unknown>;
+})[], Values extends {
+    [K in keyof Tokens]: Tokens[K] extends Token<infer V> ? V | undefined : Tokens[K] extends TokenProps$1<infer Props> ? Partial<Props> : never;
 }>(container: Container, ...tokens: Tokens): Values;
 /**
- * Returns an array of resolved values by the specified token.
+ * Resolves a value by the provided token.
+ *
+ * If an argument is an object which has tokens as its properties,
+ * then returns an object containing resolved values as properties.
+
+ * If a value is not found by the token, then `ResolverError` is thrown.
+ *
+ * @example
+ * ```ts
+ * const value = resolveValue(container, tokenA);
+ * console.log(value); // 1
+ *
+ * const props = resolveValue(container, {a: tokenA, b: tokenB});
+ * console.log(props); // {a: 1, b: 2}
+ * ```
+ */
+declare function resolveValue<Tokens extends Token<unknown> | {
+    [key: string]: Token<unknown>;
+}, Values extends Tokens extends Token<infer V> ? V : Tokens extends TokenProps$1<infer Props> ? Props : never>(container: Container, token: Tokens): Values;
+/**
+ * Returns an array of resolved values or objects with resolved values.
+ *
+ * If an item of the array is an object which has tokens as its properties,
+ * then returns an object containing resolved values as properties.
+
  * If a token is not found, then `ResolverError` is thrown.
+ *
+ * @example
+ * ```ts
+ * const items1 = resolveValues(container, tokenA);
+ * console.log(items1); // [1]
+ *
+ * const items2 = resolveValues(container, tokenA, {a: tokenA, b: tokenB});
+ * console.log(items2); // [1, {a: 1, b: 2}]
+ * ```
  */
-declare function resolveValues<Tokens extends Token<unknown>[], Values extends {
-    [K in keyof Tokens]: Tokens[K] extends Token<infer V> ? V : never;
+declare function resolveValues<Tokens extends (Token<unknown> | {
+    [key: string]: Token<unknown>;
+})[], Values extends {
+    [K in keyof Tokens]: Tokens[K] extends Token<infer V> ? V : Tokens[K] extends TokenProps$1<infer Props> ? Props : never;
 }>(container: Container, ...tokens: Tokens): Values;
 /**
- * Decorates a factory by passing resolved tokens as factory arguments.
+ * Decorates a factory by passing resolved values as factory arguments.
+ *
+ * If an argument is an object which has tokens as its properties,
+ * then returns an object containing resolved values as properties.
+ *
  * @param factory - A factory.
  * @param tokens - Tokens which correspond to factory arguments.
+ *
  * @return Decorated factory which takes a dependency container as a single argument.
  */
-declare function injectable<Tokens extends Token<unknown>[], Values extends {
-    [K in keyof Tokens]: Tokens[K] extends Token<infer V> ? V : never;
+declare function injectable<Tokens extends (Token<unknown> | {
+    [key: string]: Token<unknown>;
+})[], Values extends {
+    [K in keyof Tokens]: Tokens[K] extends Token<infer V> ? V : Tokens[K] extends TokenProps$1<infer Props> ? Props : never;
 }, Result>(this: unknown, factory: (...params: Values) => Result, ...tokens: Tokens): (container: Container) => Result;
+/**
+ * Decorates a class by passing resolved values as arguments to its constructor.
+ *
+ * If an argument is an object which has tokens as its properties,
+ * then returns an object containing resolved values as properties.
+ *
+ * @param constructor - Constructor of a class
+ * @param tokens - Tokens which correspond to constructor arguments
+ *
+ * @return A factory function which takes a dependency container as a single argument
+ * and returns a new created class.
+ */
+declare function injectableClass<Tokens extends (Token<unknown> | {
+    [key: string]: Token<unknown>;
+})[], Values extends {
+    [K in keyof Tokens]: Tokens[K] extends Token<infer V> ? V : Tokens[K] extends TokenProps$1<infer Props> ? Props : never;
+}, Result>(this: unknown, constructor: new (...params: Values) => Result, ...tokens: Tokens): (container: Container) => Result;
+
+declare type ValuesProps = {
+    [key: string]: unknown;
+};
+declare type TokenProps<Props extends ValuesProps> = {
+    [K in keyof Props]: Token<Props[K]>;
+};
+/**
+ * Returns an array of resolved values by the specified token.
+ * If a token is not found, then `undefined` value is used.
+ *
+ * @deprecated Use `tryResolveValues()` function.
+ */
+declare function getValues<Tokens extends Token<unknown>[], Values extends {
+    [K in keyof Tokens]: Tokens[K] extends Token<infer V> ? V : never;
+}>(container: Container, ...tokens: Tokens): Values;
 /**
  * Returns an object with resolved properties which are specified by token properties.
  * If a token is not found, then `undefined` value is used.
  *
+ * @deprecated Use `tryResolveValue()` function.
+ *
  * @example
  * ```ts
  * const props = getProps(container, {a: tokenA, b: tokenB});
@@ -153,6 +269,8 @@ declare function getProps<Props extends ValuesProps>(container: Container, token
  * Returns an object with resolved properties which are specified by token properties.
  * If a token is not found, then `ResolverError` is thrown.
  *
+ * @deprecated Use `resolveValue()` function.
+ *
  * @example
  * ```ts
  * const props = resolveProps(container, {a: tokenA, b: tokenB});
@@ -166,6 +284,8 @@ declare function resolveProps<Props extends ValuesProps>(container: Container, t
  * @param tokens - Object with tokens.
  * @return Decorated factory which takes a dependency container as a single argument.
  *
+ * @deprecated Use `injectable()` function.
+ *
  * @example
  * ```ts
  * const factory = ({a, b}: {a: number, b: number}) => a + b;
@@ -298,4 +418,4 @@ declare function declareModule<T>(declaration: Omit<ModuleDeclaration<T>, 'token
  */
 declare function declareModuleBindings(modules: ReadonlyArray<ModuleBindingEntry>): ModuleDeclaration<Module>;
 
-export { BindModuleOptions, Container, FactoryOptions, FactoryScope, Module, ModuleBindingEntry, ModuleDeclaration, OptionalToken, RequiredToken, ResolverError, Token, bindModule, bindModules, bindMultiValue, createContainer, declareModule, declareModuleBindings, getProps, getValues, injectable, injectableProps, optional, resolveProps, resolveValues, token };
+export { BindModuleOptions, Container, FactoryOptions, FactoryScope, Module, ModuleBindingEntry, ModuleDeclaration, OptionalToken, RequiredToken, ResolverError, Token, bindModule, bindModules, bindMultiValue, createContainer, declareModule, declareModuleBindings, getProps, getValues, injectable, injectableClass, injectableProps, isToken, optional, resolveProps, resolveValue, resolveValues, token, tryResolveValue, tryResolveValues };

package/dist/browser/index.js

@@ -0,0 +1,2 @@
+var n=function(o,t){return n=Object.setPrototypeOf||{__proto__:[]}instanceof Array&&function(n,o){n.__proto__=o}||function(n,o){for(var t in o)Object.prototype.hasOwnProperty.call(o,t)&&(n[t]=o[t])},n(o,t)};var o=function(){return o=Object.assign||function(n){for(var o,t=1,r=arguments.length;t<r;t++)for(var e in o=arguments[t])Object.prototype.hasOwnProperty.call(o,e)&&(n[e]=o[e]);return n},o.apply(this,arguments)};function t(n,o,t){if(t||2===arguments.length)for(var r,e=0,i=o.length;e<i;e++)!r&&e in o||(r||(r=Array.prototype.slice.call(o,0,e)),r[e]=o[e]);return n.concat(r||Array.prototype.slice.call(o))}function r(n){return{symbol:Symbol(n)}}function e(n,o){return{symbol:n.symbol,isOptional:!0,optionalValue:o}}var i=function(o){function t(n){var t=this.constructor,r=o.call(this,n)||this;return Object.setPrototypeOf(r,t.prototype),r.name="ResolverError",r}return function(o,t){if("function"!=typeof t&&null!==t)throw new TypeError("Class extends value "+String(t)+" is not a constructor or null");function r(){this.constructor=o}n(o,t),o.prototype=null===t?Object.create(t):(r.prototype=t.prototype,new r)}(t,o),t}(Error),u=r("ditox.Container"),l=r("ditox.ParentContainer"),c=r("ditox.Resolver"),a=Symbol(),s=function(){throw new Error("FAKE_FACTORY")},f=r("ditox.FactoriesMap");function p(n){return n.symbol===u.symbol||n.symbol===l.symbol||n.symbol===c.symbol}function y(n){var o=new Map,t=new Map,r={bindValue:function(n,t){p(n)||o.set(n.symbol,t)},bindFactory:function(n,o,r){p(n)||t.set(n.symbol,{factory:o,options:r})},remove:function(n){var r;if(!p(n)){var e=null===(r=t.get(n.symbol))||void 0===r?void 0:r.options;e&&y(n.symbol,e),o.delete(n.symbol),t.delete(n.symbol)}},removeAll:function(){t.forEach((function(n,o){n.options&&y(o,n.options)})),o.clear(),t.clear(),v()},hasToken:function(r){var e;return o.has(r.symbol)||t.has(r.symbol)||null!==(e=null==n?void 0:n.hasToken(r))&&void 0!==e&&e},get:function(n){var o=e(n,r);return o!==a?o:n.isOptional?n.optionalValue:void 0},resolve:function(n){var o,t=e(n,r);if(t!==a)return t;if(n.isOptional)return n.optionalValue;throw new i('Token "'.concat(null!==(o=n.symbol.description)&&void 0!==o?o:"",'" is not provided'))}};function e(e,i){var u=o.get(e.symbol),l=void 0!==u||o.has(e.symbol);if(l&&i===r)return u;var f,p,y=t.get(e.symbol);if(y&&y.factory!==s)switch(f=y.options,null!==(p=null==f?void 0:f.scope)&&void 0!==p?p:"singleton"){case"singleton":if(l)return u;if(null==n?void 0:n.hasToken(e))break;var v=y.factory(r);return r.bindValue(e,v),v;case"scoped":var d=y.factory(i);return i.bindValue(e,d),i!==r&&i.bindFactory(e,s,y.options),d;case"transient":return y.factory(i)}if(l)return u;var b=null==n?void 0:n.get(c);return b?b(e,i):a}function y(n,t){var r=function(n){return void 0===n.scope||"scoped"===n.scope||"singleton"===n.scope?n.onRemoved:void 0}(t);if(r){var e=o.get(n);(void 0!==e||o.has(n))&&r(e)}}function v(){o.set(u.symbol,r),o.set(c.symbol,e),o.set(f.symbol,t),n&&o.set(l.symbol,n)}return v(),r}function v(n){return null!=n&&"object"==typeof n&&"symbol"in n&&"symbol"==typeof n.symbol}function d(n,o,r){var e,i=t(t([],null!==(e=n.get(o))&&void 0!==e?e:[],!0),[r],!1);n.bindValue(o,i)}function b(n,o){if(v(o))return n.get(o);var t={};return Object.keys(o).forEach((function(r){return t[r]=n.get(o[r])})),t}function m(n){for(var o=[],t=1;t<arguments.length;t++)o[t-1]=arguments[t];return o.map((function(o){return b(n,o)}))}function h(n,o){if(v(o))return n.resolve(o);var t={};return Object.keys(o).forEach((function(r){return t[r]=n.resolve(o[r])})),t}function g(n){for(var o=[],t=1;t<arguments.length;t++)o[t-1]=arguments[t];return o.map((function(o){return h(n,o)}))}function O(n){for(var o=this,r=[],e=1;e<arguments.length;e++)r[e-1]=arguments[e];return function(e){var i=g.apply(void 0,t([e],r,!1));return n.apply(o,i)}}function w(n){for(var o=[],r=1;r<arguments.length;r++)o[r-1]=arguments[r];return O.apply(void 0,t([function(){for(var o=[],r=0;r<arguments.length;r++)o[r]=arguments[r];return new(n.bind.apply(n,t([void 0],o,!1)))}],o,!1))}function k(n){for(var o=[],r=1;r<arguments.length;r++)o[r-1]=arguments[r];return m.apply(void 0,t([n],o,!1))}function E(n,o){return b(n,o)}function j(n,o){return h(n,o)}function _(n,o){return O(n,o)}function x(n,o,t){var r,e=o.token,i=o.imports,u=o.factory,l=o.beforeBinding,c=o.afterBinding,a=null!==(r=o.exports)&&void 0!==r?r:o.exportedProps,s=null==t?void 0:t.scope;l&&l(n),i&&F(n,i);var f=new Set;a&&Object.keys(a).forEach((function(o){var t=a[o];t&&(f.add(t),n.bindFactory(t,O((function(n){return n[o]}),e),{scope:s}))}));n.bindFactory(e,u,{scope:s,onRemoved:function(o){o.destroy&&o.destroy(),f.forEach((function(o){return n.remove(o)})),f.clear()}}),c&&c(n)}function F(n,o){o.forEach((function(o){"module"in o?x(n,o.module,o.options):x(n,o)}))}function V(n){var t;return o(o({},n),{token:null!==(t=n.token)&&void 0!==t?t:r()})}function A(n){return V({factory:function(){return{}},imports:n})}export{i as ResolverError,x as bindModule,F as bindModules,d as bindMultiValue,y as createContainer,V as declareModule,A as declareModuleBindings,E as getProps,k as getValues,O as injectable,w as injectableClass,_ as injectableProps,v as isToken,e as optional,j as resolveProps,h as resolveValue,g as resolveValues,r as token,b as tryResolveValue,m as tryResolveValues};
+//# sourceMappingURL=index.js.map

package/dist/browser/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../../../../node_modules/tslib/tslib.es6.js","../../src/ditox.ts","../../src/utils.ts","../../src/utils-deprecated.ts","../../src/modules.ts"],"sourcesContent":["/*! *****************************************************************************\r\nCopyright (c) Microsoft Corporation.\r\n\r\nPermission to use, copy, modify, and/or distribute this software for any\r\npurpose with or without fee is hereby granted.\r\n\r\nTHE SOFTWARE IS PROVIDED \"AS IS\" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH\r\nREGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY\r\nAND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,\r\nINDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM\r\nLOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR\r\nOTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR\r\nPERFORMANCE OF THIS SOFTWARE.\r\n***************************************************************************** */\r\n/* global Reflect, Promise */\r\n\r\nvar extendStatics = function(d, b) {\r\n    extendStatics = Object.setPrototypeOf ||\r\n        ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||\r\n        function (d, b) { for (var p in b) if (Object.prototype.hasOwnProperty.call(b, p)) d[p] = b[p]; };\r\n    return extendStatics(d, b);\r\n};\r\n\r\nexport function __extends(d, b) {\r\n    if (typeof b !== \"function\" && b !== null)\r\n        throw new TypeError(\"Class extends value \" + String(b) + \" is not a constructor or null\");\r\n    extendStatics(d, b);\r\n    function __() { this.constructor = d; }\r\n    d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());\r\n}\r\n\r\nexport var __assign = function() {\r\n    __assign = Object.assign || function __assign(t) {\r\n        for (var s, i = 1, n = arguments.length; i < n; i++) {\r\n            s = arguments[i];\r\n            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p)) t[p] = s[p];\r\n        }\r\n        return t;\r\n    }\r\n    return __assign.apply(this, arguments);\r\n}\r\n\r\nexport function __rest(s, e) {\r\n    var t = {};\r\n    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)\r\n        t[p] = s[p];\r\n    if (s != null && typeof Object.getOwnPropertySymbols === \"function\")\r\n        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {\r\n            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))\r\n                t[p[i]] = s[p[i]];\r\n        }\r\n    return t;\r\n}\r\n\r\nexport function __decorate(decorators, target, key, desc) {\r\n    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;\r\n    if (typeof Reflect === \"object\" && typeof Reflect.decorate === \"function\") r = Reflect.decorate(decorators, target, key, desc);\r\n    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;\r\n    return c > 3 && r && Object.defineProperty(target, key, r), r;\r\n}\r\n\r\nexport function __param(paramIndex, decorator) {\r\n    return function (target, key) { decorator(target, key, paramIndex); }\r\n}\r\n\r\nexport function __metadata(metadataKey, metadataValue) {\r\n    if (typeof Reflect === \"object\" && typeof Reflect.metadata === \"function\") return Reflect.metadata(metadataKey, metadataValue);\r\n}\r\n\r\nexport function __awaiter(thisArg, _arguments, P, generator) {\r\n    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }\r\n    return new (P || (P = Promise))(function (resolve, reject) {\r\n        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }\r\n        function rejected(value) { try { step(generator[\"throw\"](value)); } catch (e) { reject(e); } }\r\n        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }\r\n        step((generator = generator.apply(thisArg, _arguments || [])).next());\r\n    });\r\n}\r\n\r\nexport function __generator(thisArg, body) {\r\n    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;\r\n    return g = { next: verb(0), \"throw\": verb(1), \"return\": verb(2) }, typeof Symbol === \"function\" && (g[Symbol.iterator] = function() { return this; }), g;\r\n    function verb(n) { return function (v) { return step([n, v]); }; }\r\n    function step(op) {\r\n        if (f) throw new TypeError(\"Generator is already executing.\");\r\n        while (_) try {\r\n            if (f = 1, y && (t = op[0] & 2 ? y[\"return\"] : op[0] ? y[\"throw\"] || ((t = y[\"return\"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;\r\n            if (y = 0, t) op = [op[0] & 2, t.value];\r\n            switch (op[0]) {\r\n                case 0: case 1: t = op; break;\r\n                case 4: _.label++; return { value: op[1], done: false };\r\n                case 5: _.label++; y = op[1]; op = [0]; continue;\r\n                case 7: op = _.ops.pop(); _.trys.pop(); continue;\r\n                default:\r\n                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }\r\n                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }\r\n                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }\r\n                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }\r\n                    if (t[2]) _.ops.pop();\r\n                    _.trys.pop(); continue;\r\n            }\r\n            op = body.call(thisArg, _);\r\n        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }\r\n        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };\r\n    }\r\n}\r\n\r\nexport var __createBinding = Object.create ? (function(o, m, k, k2) {\r\n    if (k2 === undefined) k2 = k;\r\n    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });\r\n}) : (function(o, m, k, k2) {\r\n    if (k2 === undefined) k2 = k;\r\n    o[k2] = m[k];\r\n});\r\n\r\nexport function __exportStar(m, o) {\r\n    for (var p in m) if (p !== \"default\" && !Object.prototype.hasOwnProperty.call(o, p)) __createBinding(o, m, p);\r\n}\r\n\r\nexport function __values(o) {\r\n    var s = typeof Symbol === \"function\" && Symbol.iterator, m = s && o[s], i = 0;\r\n    if (m) return m.call(o);\r\n    if (o && typeof o.length === \"number\") return {\r\n        next: function () {\r\n            if (o && i >= o.length) o = void 0;\r\n            return { value: o && o[i++], done: !o };\r\n        }\r\n    };\r\n    throw new TypeError(s ? \"Object is not iterable.\" : \"Symbol.iterator is not defined.\");\r\n}\r\n\r\nexport function __read(o, n) {\r\n    var m = typeof Symbol === \"function\" && o[Symbol.iterator];\r\n    if (!m) return o;\r\n    var i = m.call(o), r, ar = [], e;\r\n    try {\r\n        while ((n === void 0 || n-- > 0) && !(r = i.next()).done) ar.push(r.value);\r\n    }\r\n    catch (error) { e = { error: error }; }\r\n    finally {\r\n        try {\r\n            if (r && !r.done && (m = i[\"return\"])) m.call(i);\r\n        }\r\n        finally { if (e) throw e.error; }\r\n    }\r\n    return ar;\r\n}\r\n\r\n/** @deprecated */\r\nexport function __spread() {\r\n    for (var ar = [], i = 0; i < arguments.length; i++)\r\n        ar = ar.concat(__read(arguments[i]));\r\n    return ar;\r\n}\r\n\r\n/** @deprecated */\r\nexport function __spreadArrays() {\r\n    for (var s = 0, i = 0, il = arguments.length; i < il; i++) s += arguments[i].length;\r\n    for (var r = Array(s), k = 0, i = 0; i < il; i++)\r\n        for (var a = arguments[i], j = 0, jl = a.length; j < jl; j++, k++)\r\n            r[k] = a[j];\r\n    return r;\r\n}\r\n\r\nexport function __spreadArray(to, from, pack) {\r\n    if (pack || arguments.length === 2) for (var i = 0, l = from.length, ar; i < l; i++) {\r\n        if (ar || !(i in from)) {\r\n            if (!ar) ar = Array.prototype.slice.call(from, 0, i);\r\n            ar[i] = from[i];\r\n        }\r\n    }\r\n    return to.concat(ar || Array.prototype.slice.call(from));\r\n}\r\n\r\nexport function __await(v) {\r\n    return this instanceof __await ? (this.v = v, this) : new __await(v);\r\n}\r\n\r\nexport function __asyncGenerator(thisArg, _arguments, generator) {\r\n    if (!Symbol.asyncIterator) throw new TypeError(\"Symbol.asyncIterator is not defined.\");\r\n    var g = generator.apply(thisArg, _arguments || []), i, q = [];\r\n    return i = {}, verb(\"next\"), verb(\"throw\"), verb(\"return\"), i[Symbol.asyncIterator] = function () { return this; }, i;\r\n    function verb(n) { if (g[n]) i[n] = function (v) { return new Promise(function (a, b) { q.push([n, v, a, b]) > 1 || resume(n, v); }); }; }\r\n    function resume(n, v) { try { step(g[n](v)); } catch (e) { settle(q[0][3], e); } }\r\n    function step(r) { r.value instanceof __await ? Promise.resolve(r.value.v).then(fulfill, reject) : settle(q[0][2], r); }\r\n    function fulfill(value) { resume(\"next\", value); }\r\n    function reject(value) { resume(\"throw\", value); }\r\n    function settle(f, v) { if (f(v), q.shift(), q.length) resume(q[0][0], q[0][1]); }\r\n}\r\n\r\nexport function __asyncDelegator(o) {\r\n    var i, p;\r\n    return i = {}, verb(\"next\"), verb(\"throw\", function (e) { throw e; }), verb(\"return\"), i[Symbol.iterator] = function () { return this; }, i;\r\n    function verb(n, f) { i[n] = o[n] ? function (v) { return (p = !p) ? { value: __await(o[n](v)), done: n === \"return\" } : f ? f(v) : v; } : f; }\r\n}\r\n\r\nexport function __asyncValues(o) {\r\n    if (!Symbol.asyncIterator) throw new TypeError(\"Symbol.asyncIterator is not defined.\");\r\n    var m = o[Symbol.asyncIterator], i;\r\n    return m ? m.call(o) : (o = typeof __values === \"function\" ? __values(o) : o[Symbol.iterator](), i = {}, verb(\"next\"), verb(\"throw\"), verb(\"return\"), i[Symbol.asyncIterator] = function () { return this; }, i);\r\n    function verb(n) { i[n] = o[n] && function (v) { return new Promise(function (resolve, reject) { v = o[n](v), settle(resolve, reject, v.done, v.value); }); }; }\r\n    function settle(resolve, reject, d, v) { Promise.resolve(v).then(function(v) { resolve({ value: v, done: d }); }, reject); }\r\n}\r\n\r\nexport function __makeTemplateObject(cooked, raw) {\r\n    if (Object.defineProperty) { Object.defineProperty(cooked, \"raw\", { value: raw }); } else { cooked.raw = raw; }\r\n    return cooked;\r\n};\r\n\r\nvar __setModuleDefault = Object.create ? (function(o, v) {\r\n    Object.defineProperty(o, \"default\", { enumerable: true, value: v });\r\n}) : function(o, v) {\r\n    o[\"default\"] = v;\r\n};\r\n\r\nexport function __importStar(mod) {\r\n    if (mod && mod.__esModule) return mod;\r\n    var result = {};\r\n    if (mod != null) for (var k in mod) if (k !== \"default\" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);\r\n    __setModuleDefault(result, mod);\r\n    return result;\r\n}\r\n\r\nexport function __importDefault(mod) {\r\n    return (mod && mod.__esModule) ? mod : { default: mod };\r\n}\r\n\r\nexport function __classPrivateFieldGet(receiver, state, kind, f) {\r\n    if (kind === \"a\" && !f) throw new TypeError(\"Private accessor was defined without a getter\");\r\n    if (typeof state === \"function\" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError(\"Cannot read private member from an object whose class did not declare it\");\r\n    return kind === \"m\" ? f : kind === \"a\" ? f.call(receiver) : f ? f.value : state.get(receiver);\r\n}\r\n\r\nexport function __classPrivateFieldSet(receiver, state, value, kind, f) {\r\n    if (kind === \"m\") throw new TypeError(\"Private method is not writable\");\r\n    if (kind === \"a\" && !f) throw new TypeError(\"Private accessor was defined without a setter\");\r\n    if (typeof state === \"function\" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError(\"Cannot write private member to an object whose class did not declare it\");\r\n    return (kind === \"a\" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;\r\n}\r\n",null,null,null,null],"names":["extendStatics","d","b","Object","setPrototypeOf","__proto__","Array","p","prototype","hasOwnProperty","call","__assign","assign","t","s","i","n","arguments","length","apply","this","__spreadArray","to","from","pack","ar","l","slice","concat","token","description","symbol","Symbol","optional","optionalValue","isOptional","message","_super","_this","_newTarget","name","TypeError","String","__","constructor","create","__extends","Error","CONTAINER","PARENT_CONTAINER","RESOLVER","NOT_FOUND","FAKE_FACTORY","FACTORIES_MAP","isInternalToken","createContainer","parentContainer","values","Map","factories","container","bindValue","value","set","bindFactory","factory","options","remove","get","executeOnRemoved","delete","removeAll","forEach","context","tokenSymbol","clear","bindInternalTokens","hasToken","has","resolver","resolve","ResolverError","origin","hasValue","undefined","factoryContext","scope","value_1","value_2","parentResolver","onRemoved","getOnRemoved","isToken","bindMultiValue","nextValues","tryResolveValue","obj","keys","key","tryResolveValues","_i","tokens","map","item","resolveValue","resolveValues","injectable","injectableClass","getValues","getProps","resolveProps","injectableProps","bindModule","moduleDeclaration","imports","beforeBinding","afterBinding","exports","exportedProps","bindModules","exportedValueTokens","Set","valueKey","valueToken","add","module","destroy","modules","entry","declareModule","declaration","declareModuleBindings"],"mappings":"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"}

package/dist/cjs/ditox.d.ts

@@ -0,0 +1,125 @@
+/**
+ * @ignore
+ * Binding token for mandatory value
+ */
+export declare type RequiredToken<T> = {
+    symbol: symbol;
+    type?: T;
+    isOptional?: false;
+};
+/**
+ * @ignore
+ * Binding token for optional value
+ */
+export declare type OptionalToken<T> = {
+    symbol: symbol;
+    type?: T;
+    isOptional: true;
+    optionalValue: T;
+};
+/**
+ * Binding token.
+ */
+export declare type Token<T> = RequiredToken<T> | OptionalToken<T>;
+/**
+ * Creates a new binding token.
+ * @param description - Token description for better error messages.
+ */
+export declare function token<T>(description?: string): 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>;
+/**
+ * ResolverError is thrown by the resolver when a token is not found in a container.
+ */
+export declare class ResolverError extends Error {
+    constructor(message: string);
+}
+/**
+ * @see https://github.com/mnasyrov/ditox#factory-lifetimes
+ */
+export declare type FactoryScope = 'scoped' | 'singleton' | 'transient';
+/**
+ * Options for factory binding.
+ *
+ * `scope` types:
+ *   - `singleton` - **This is the default**. The value is created and cached by the container which registered the factory.
+ *   - `scoped` - The value is created and cached by the container which starts resolving.
+ *   - `transient` - The value is created every time it is resolved.
+ *
+ * `scoped` and `singleton` scopes can have `onRemoved` callback. It is called when a token is removed from the container.
+ */
+export declare type FactoryOptions<T> = {
+    scope?: 'scoped' | 'singleton';
+    onRemoved?: (value: T) => void;
+} | {
+    scope: 'transient';
+};
+/**
+ * Dependency container.
+ */
+export declare type Container = {
+    /**
+     * Binds a value for the token
+     */
+    bindValue<T>(token: Token<T>, value: T): void;
+    /**
+     * Binds a factory for the token.
+     */
+    bindFactory<T>(token: Token<T>, factory: (container: Container) => T, options?: FactoryOptions<T>): void;
+    /**
+     * Checks if the token is registered in the container hierarchy.
+     */
+    hasToken(token: Token<unknown>): boolean;
+    /**
+     * Returns a resolved value by the token, or returns `undefined` in case the token is not found.
+     */
+    get<T>(token: Token<T>): T | undefined;
+    /**
+     * Returns a resolved value by the token, or throws `ResolverError` in case the token is not found.
+     */
+    resolve<T>(token: Token<T>): T;
+    /**
+     * Removes a binding for the token.
+     */
+    remove<T>(token: Token<T>): void;
+    /**
+     * Removes all bindings in the container.
+     */
+    removeAll(): void;
+};
+/** @internal */
+export declare const CONTAINER: Token<Container>;
+/** @internal */
+export declare const PARENT_CONTAINER: Token<Container>;
+/** @internal */
+export declare const RESOLVER: Token<Resolver>;
+/** @internal */
+declare const NOT_FOUND: unique symbol;
+/** @internal */
+export declare const FAKE_FACTORY: () => never;
+/** @internal */
+declare type FactoryContext<T> = {
+    factory: (container: Container) => T;
+    options?: FactoryOptions<T>;
+};
+/** @internal */
+export declare type FactoriesMap = Map<symbol, FactoryContext<any>>;
+/** @internal */
+export declare const FACTORIES_MAP: Token<FactoriesMap>;
+/** @internal */
+declare type Resolver = <T>(token: Token<T>, origin: Container) => T | typeof NOT_FOUND;
+/**
+ * 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 parentContainer - Optional parent container.
+ */
+export declare function createContainer(parentContainer?: Container): Container;
+export {};

package/dist/cjs/ditox.js

@@ -0,0 +1,210 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createContainer = exports.FACTORIES_MAP = exports.FAKE_FACTORY = exports.RESOLVER = exports.PARENT_CONTAINER = exports.CONTAINER = exports.ResolverError = exports.optional = exports.token = void 0;
+/**
+ * Creates a new binding token.
+ * @param description - Token description for better error messages.
+ */
+function token(description) {
+    return { symbol: Symbol(description) };
+}
+exports.token = token;
+function optional(token, optionalValue) {
+    return {
+        symbol: token.symbol,
+        isOptional: true,
+        optionalValue,
+    };
+}
+exports.optional = optional;
+/**
+ * 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 = token('ditox.Container');
+/** @internal */
+exports.PARENT_CONTAINER = token('ditox.ParentContainer');
+/** @internal */
+exports.RESOLVER = token('ditox.Resolver');
+/** @internal */
+const NOT_FOUND = Symbol();
+/** @internal */
+const FAKE_FACTORY = () => {
+    throw new Error('FAKE_FACTORY');
+};
+exports.FAKE_FACTORY = FAKE_FACTORY;
+/** @internal */
+const DEFAULT_SCOPE = 'singleton';
+/** @internal */
+exports.FACTORIES_MAP = 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_CONTAINER.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 parentContainer - Optional parent container.
+ */
+function createContainer(parentContainer) {
+    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) {
+            var _a;
+            return (values.has(token.symbol) ||
+                factories.has(token.symbol) ||
+                ((_a = parentContainer === null || parentContainer === void 0 ? void 0 : parentContainer.hasToken(token)) !== null && _a !== void 0 ? _a : false));
+        },
+        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 && factoryContext.factory !== exports.FAKE_FACTORY) {
+            const scope = getScope(factoryContext.options);
+            switch (scope) {
+                case 'singleton': {
+                    if (hasValue) {
+                        return value;
+                    }
+                    else if (parentContainer === null || parentContainer === void 0 ? void 0 : parentContainer.hasToken(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': {
+                    // Create a value within the origin container and cache it.
+                    const value = factoryContext.factory(origin);
+                    origin.bindValue(token, value);
+                    if (origin !== container) {
+                        // Bind a fake factory with actual options to make onRemoved() works.
+                        origin.bindFactory(token, exports.FAKE_FACTORY, factoryContext.options);
+                    }
+                    return value;
+                }
+                case 'transient': {
+                    // Create a value within the origin container and don't cache it.
+                    return factoryContext.factory(origin);
+                }
+            }
+        }
+        if (hasValue) {
+            return value;
+        }
+        const parentResolver = parentContainer === null || parentContainer === void 0 ? void 0 : parentContainer.get(exports.RESOLVER);
+        if (parentResolver) {
+            return parentResolver(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 (parentContainer) {
+            values.set(exports.PARENT_CONTAINER.symbol, parentContainer);
+        }
+    }
+    bindInternalTokens();
+    return container;
+}
+exports.createContainer = createContainer;
+//# sourceMappingURL=ditox.js.map

package/dist/cjs/ditox.js.map

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