ts-ioc-container 69.2.0 → 70.1.0

package/cjm/index.js

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.injectProp = exports.createHookExecutionContext = exports.createHookContextFactory = exports.HookContext = exports.toHookFn = exports.hasHooks = exports.hook = exports.getHooks = exports.ArgumentNotFoundError = exports.TypedEventDisposedError = exports.UnsupportedTokenTypeError = exports.CannonSingletonApplyTwiceError = exports.ProviderDisposedError = exports.ContainerDisposedError = exports.MethodNotImplementedError = exports.DependencyMissingKeyError = exports.ContainerNotFoundError = exports.DependencyNotFoundError = exports.ContainerError = exports.Registration = exports.onResolve = exports.appendArgsFn = exports.appendArgs = exports.decorate = exports.singleton = exports.autoResolve = exports.lazy = exports.scopeAccess = exports.scope = exports.bindTo = exports.register = exports.toRegistrationFn = exports.toProviderFn = exports.toBindToken = exports.registerPipe = exports.isProviderPipe = exports.Provider = exports.ProxyInjector = exports.SimpleInjector = exports.resolveArgs = exports.argsFn = exports.args = exports.arg = exports.inject = exports.MetadataInjector = exports.Injector = exports.EmptyContainer = exports.AutoResolveModule = exports.Container = exports.isDependencyKey = void 0;
 exports.TypedEvent = exports.getConstructorChain = exports.memoize = exports.once = exports.shallowCache = exports.debounce = exports.throttle = exports.runAtOnce = exports.runInOrder = exports.handleAsyncError = exports.handleError = exports.getMethodTags = exports.addMethodTag = exports.getMethodLabels = exports.addMethodLabel = exports.getMethodMeta = exports.addMethodMeta = exports.getParamTags = exports.addParamTag = exports.getParamLabels = exports.addParamLabel = exports.getParamMeta = exports.addParamMeta = exports.getClassTags = exports.addClassTag = exports.getClassLabels = exports.addClassLabel = exports.getClassMeta = exports.addClassMeta = exports.resolveConstructor = exports.GroupInstanceToken = exports.ConstantToken = exports.FunctionToken = exports.SingleToken = exports.ClassToken = exports.toSingleAlias = exports.SingleAliasToken = exports.toGroupAlias = exports.GroupAliasToken = exports.argToToken = exports.toMappedToken = exports.toToken = exports.forwardArgs = exports.isInjectionToken = exports.InjectionToken = exports.toTask = exports.HookCollector = exports.oncePerInstance = exports.parallel = exports.sequential = void 0;
-exports.Is = exports.unwrapProxy = exports.ProxyRegistry = exports.findOrFail = exports.pipe = exports.select = void 0;
+exports.isSerializable = exports.Is = exports.unwrapProxy = exports.ProxyRegistry = exports.findOrFail = exports.pipe = exports.select = void 0;
 var IContainer_1 = require("./container/IContainer");
 Object.defineProperty(exports, "isDependencyKey", { enumerable: true, get: function () { return IContainer_1.isDependencyKey; } });
 var Container_1 = require("./container/Container");
@@ -163,3 +163,4 @@ Object.defineProperty(exports, "ProxyRegistry", { enumerable: true, get: functio
 Object.defineProperty(exports, "unwrapProxy", { enumerable: true, get: function () { return ProxyRegistry_1.unwrapProxy; } });
 var basic_1 = require("./utils/basic");
 Object.defineProperty(exports, "Is", { enumerable: true, get: function () { return basic_1.Is; } });
+Object.defineProperty(exports, "isSerializable", { enumerable: true, get: function () { return basic_1.isSerializable; } });

package/cjm/provider/Provider.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Provider = void 0;
+const basic_1 = require("../utils/basic");
 const CannonSingletonApplyTwiceError_1 = require("../errors/CannonSingletonApplyTwiceError");
 const ProviderDisposedError_1 = require("../errors/ProviderDisposedError");
 class Provider {
@@ -31,7 +32,7 @@ class Provider {
         if (!this.getKey) {
             return this.resolveDep(scope, options);
         }
-        const key = this.getKey(...(options.args ?? []));
+        const key = (0, basic_1.toString)(this.getKey(...(options.args ?? [])));
         if (!this.cache.has(key)) {
             this.cache.set(key, this.resolveDep(scope, options));
         }

package/cjm/token/ClassToken.js

@@ -6,8 +6,8 @@ class ClassToken extends InjectionToken_1.InjectionToken {
     target;
     _getArgsFn;
     _isLazy;
-    constructor(target, { getArgsFn = InjectionToken_1.forwardArgs, isLazy = false } = {}) {
-        super();
+    constructor(target, { getArgsFn = InjectionToken_1.forwardArgs, isLazy = false, tags = [], } = {}) {
+        super(tags);
         this.target = target;
         this._getArgsFn = getArgsFn;
         this._isLazy = isLazy;
@@ -26,6 +26,7 @@ class ClassToken extends InjectionToken_1.InjectionToken {
         return new ClassToken(this.target, {
             getArgsFn: (s, opts) => [...parentFn(s, opts), ...newArgs],
             isLazy: this._isLazy,
+            tags: this.getTags(),
         });
     }
     argsFn(fn) {
@@ -33,16 +34,25 @@ class ClassToken extends InjectionToken_1.InjectionToken {
         return new ClassToken(this.target, {
             getArgsFn: (s, opts) => [...parentFn(s, opts), ...fn(s)],
             isLazy: this._isLazy,
+            tags: this.getTags(),
         });
     }
     lazy() {
         return new ClassToken(this.target, {
             getArgsFn: this._getArgsFn,
             isLazy: true,
+            tags: this.getTags(),
         });
     }
-    getKey() {
-        return this.target;
+    addTags(...tags) {
+        return new ClassToken(this.target, {
+            getArgsFn: this._getArgsFn,
+            isLazy: this._isLazy,
+            tags: [...this.getTags(), ...tags],
+        });
+    }
+    toString() {
+        return this.target.name;
     }
 }
 exports.ClassToken = ClassToken;

package/cjm/token/ConstantToken.js

@@ -5,8 +5,8 @@ const InjectionToken_1 = require("./InjectionToken");
 const MethodNotImplementedError_1 = require("../errors/MethodNotImplementedError");
 class ConstantToken extends InjectionToken_1.InjectionToken {
     token;
-    constructor(token) {
-        super();
+    constructor(token, { tags = [] } = {}) {
+        super(tags);
         this.token = token;
     }
     resolve(s) {
@@ -21,7 +21,10 @@ class ConstantToken extends InjectionToken_1.InjectionToken {
     lazy() {
         throw new MethodNotImplementedError_1.MethodNotImplementedError('not implemented');
     }
-    getKey() {
+    addTags(...tags) {
+        return new ConstantToken(this.token, { tags: [...this.getTags(), ...tags] });
+    }
+    toString() {
         throw new MethodNotImplementedError_1.MethodNotImplementedError('not implemented');
     }
 }

package/cjm/token/FunctionToken.js

@@ -7,8 +7,8 @@ class FunctionToken extends InjectionToken_1.InjectionToken {
     fn;
     _getArgsFn;
     _isLazy;
-    constructor(fn, { getArgsFn = InjectionToken_1.forwardArgs, isLazy = false } = {}) {
-        super();
+    constructor(fn, { getArgsFn = InjectionToken_1.forwardArgs, isLazy = false, tags = [], } = {}) {
+        super(tags);
         this.fn = fn;
         this._getArgsFn = getArgsFn;
         this._isLazy = isLazy;
@@ -24,6 +24,7 @@ class FunctionToken extends InjectionToken_1.InjectionToken {
         return new FunctionToken(this.fn, {
             getArgsFn: (s, opts) => [...parentFn(s, opts), ...newArgs],
             isLazy: this._isLazy,
+            tags: this.getTags(),
         });
     }
     argsFn(fn) {
@@ -31,15 +32,24 @@ class FunctionToken extends InjectionToken_1.InjectionToken {
         return new FunctionToken(this.fn, {
             getArgsFn: (s, opts) => [...parentFn(s, opts), ...fn(s)],
             isLazy: this._isLazy,
+            tags: this.getTags(),
         });
     }
     lazy() {
         return new FunctionToken(this.fn, {
             getArgsFn: this._getArgsFn,
             isLazy: true,
+            tags: this.getTags(),
         });
     }
-    getKey() {
+    addTags(...tags) {
+        return new FunctionToken(this.fn, {
+            getArgsFn: this._getArgsFn,
+            isLazy: this._isLazy,
+            tags: [...this.getTags(), ...tags],
+        });
+    }
+    toString() {
         throw new MethodNotImplementedError_1.MethodNotImplementedError('not implemented');
     }
 }

package/cjm/token/GroupAliasToken.js

@@ -6,8 +6,8 @@ class GroupAliasToken extends InjectionToken_1.InjectionToken {
     token;
     _getArgsFn;
     _isLazy;
-    constructor(token, { getArgsFn = InjectionToken_1.forwardArgs, isLazy = false } = {}) {
-        super();
+    constructor(token, { getArgsFn = InjectionToken_1.forwardArgs, isLazy = false, tags = [], } = {}) {
+        super(tags);
         this.token = token;
         this._getArgsFn = getArgsFn;
         this._isLazy = isLazy;
@@ -29,6 +29,7 @@ class GroupAliasToken extends InjectionToken_1.InjectionToken {
         return new GroupAliasToken(this.token, {
             getArgsFn: (s, opts) => [...parentFn(s, opts), ...newArgs],
             isLazy: this._isLazy,
+            tags: this.getTags(),
         });
     }
     argsFn(fn) {
@@ -36,16 +37,25 @@ class GroupAliasToken extends InjectionToken_1.InjectionToken {
         return new GroupAliasToken(this.token, {
             getArgsFn: (s, opts) => [...parentFn(s, opts), ...fn(s)],
             isLazy: this._isLazy,
+            tags: this.getTags(),
         });
     }
     lazy() {
         return new GroupAliasToken(this.token, {
             getArgsFn: this._getArgsFn,
             isLazy: true,
+            tags: this.getTags(),
         });
     }
-    getKey() {
-        return this.token;
+    addTags(...tags) {
+        return new GroupAliasToken(this.token, {
+            getArgsFn: this._getArgsFn,
+            isLazy: this._isLazy,
+            tags: [...this.getTags(), ...tags],
+        });
+    }
+    toString() {
+        return this.token.toString();
     }
 }
 exports.GroupAliasToken = GroupAliasToken;

package/cjm/token/GroupInstanceToken.js

@@ -5,10 +5,11 @@ const InjectionToken_1 = require("./InjectionToken");
 const MethodNotImplementedError_1 = require("../errors/MethodNotImplementedError");
 class GroupInstanceToken extends InjectionToken_1.InjectionToken {
     predicate;
-    isCascade = true;
-    constructor(predicate) {
-        super();
+    isCascade;
+    constructor(predicate, { tags = [], isCascade = true } = {}) {
+        super(tags);
         this.predicate = predicate;
+        this.isCascade = isCascade;
     }
     select(fn) {
         return (s) => this.resolve(s).map(fn);
@@ -29,7 +30,10 @@ class GroupInstanceToken extends InjectionToken_1.InjectionToken {
     resolve(c) {
         return c.getInstances(this.isCascade).filter(this.predicate);
     }
-    getKey() {
+    addTags(...tags) {
+        return new GroupInstanceToken(this.predicate, { tags: [...this.getTags(), ...tags], isCascade: this.isCascade });
+    }
+    toString() {
         throw new MethodNotImplementedError_1.MethodNotImplementedError('not implemented');
     }
 }

package/cjm/token/InjectionToken.js

@@ -6,8 +6,24 @@ const basic_1 = require("../utils/basic");
 const forwardArgs = (_, { args = [] } = {}) => args;
 exports.forwardArgs = forwardArgs;
 class InjectionToken {
+    tags;
+    constructor(tags = []) {
+        this.tags = new Set(tags);
+    }
+    hasTag(tag) {
+        return this.tags.has(tag);
+    }
+    getTags() {
+        return [...this.tags];
+    }
 }
 exports.InjectionToken = InjectionToken;
 function isInjectionToken(target) {
-    return basic_1.Is.object(target) && 'resolve' in target && 'args' in target && 'argsFn' in target && 'lazy' in target;
+    return (basic_1.Is.object(target) &&
+        'resolve' in target &&
+        'args' in target &&
+        'argsFn' in target &&
+        'lazy' in target &&
+        'hasTag' in target &&
+        'addTags' in target);
 }

package/cjm/token/SingleAliasToken.js

@@ -6,8 +6,8 @@ class SingleAliasToken extends InjectionToken_1.InjectionToken {
     token;
     _getArgsFn;
     _isLazy;
-    constructor(token, { getArgsFn = InjectionToken_1.forwardArgs, isLazy = false } = {}) {
-        super();
+    constructor(token, { getArgsFn = InjectionToken_1.forwardArgs, isLazy = false, tags = [], } = {}) {
+        super(tags);
         this.token = token;
         this._getArgsFn = getArgsFn;
         this._isLazy = isLazy;
@@ -29,6 +29,7 @@ class SingleAliasToken extends InjectionToken_1.InjectionToken {
         return new SingleAliasToken(this.token, {
             getArgsFn: (s, opts) => [...parentFn(s, opts), ...newArgs],
             isLazy: this._isLazy,
+            tags: this.getTags(),
         });
     }
     argsFn(fn) {
@@ -36,16 +37,25 @@ class SingleAliasToken extends InjectionToken_1.InjectionToken {
         return new SingleAliasToken(this.token, {
             getArgsFn: (s, opts) => [...parentFn(s, opts), ...fn(s)],
             isLazy: this._isLazy,
+            tags: this.getTags(),
         });
     }
     lazy() {
         return new SingleAliasToken(this.token, {
             getArgsFn: this._getArgsFn,
             isLazy: true,
+            tags: this.getTags(),
         });
     }
-    getKey() {
-        return this.token;
+    addTags(...tags) {
+        return new SingleAliasToken(this.token, {
+            getArgsFn: this._getArgsFn,
+            isLazy: this._isLazy,
+            tags: [...this.getTags(), ...tags],
+        });
+    }
+    toString() {
+        return this.token.toString();
     }
 }
 exports.SingleAliasToken = SingleAliasToken;

package/cjm/token/SingleToken.js

@@ -6,8 +6,8 @@ class SingleToken extends InjectionToken_1.InjectionToken {
     token;
     _getArgsFn;
     _isLazy;
-    constructor(token, { getArgsFn = InjectionToken_1.forwardArgs, isLazy = false } = {}) {
-        super();
+    constructor(token, { getArgsFn = InjectionToken_1.forwardArgs, isLazy = false, tags = [], } = {}) {
+        super(tags);
         this.token = token;
         this._getArgsFn = getArgsFn;
         this._isLazy = isLazy;
@@ -29,6 +29,7 @@ class SingleToken extends InjectionToken_1.InjectionToken {
         return new SingleToken(this.token, {
             getArgsFn: (s, opts) => [...parentFn(s, opts), ...newArgs],
             isLazy: this._isLazy,
+            tags: this.getTags(),
         });
     }
     argsFn(fn) {
@@ -36,16 +37,25 @@ class SingleToken extends InjectionToken_1.InjectionToken {
         return new SingleToken(this.token, {
             getArgsFn: (s, opts) => [...parentFn(s, opts), ...fn(s)],
             isLazy: this._isLazy,
+            tags: this.getTags(),
         });
     }
     lazy() {
         return new SingleToken(this.token, {
             getArgsFn: this._getArgsFn,
             isLazy: true,
+            tags: this.getTags(),
         });
     }
-    getKey() {
-        return this.token;
+    addTags(...tags) {
+        return new SingleToken(this.token, {
+            getArgsFn: this._getArgsFn,
+            isLazy: this._isLazy,
+            tags: [...this.getTags(), ...tags],
+        });
+    }
+    toString() {
+        return this.token.toString();
     }
 }
 exports.SingleToken = SingleToken;

package/cjm/utils/basic.js

@@ -1,9 +1,15 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Is = void 0;
+exports.toString = exports.Is = void 0;
+exports.isSerializable = isSerializable;
 exports.Is = {
     nullish: (value) => value === undefined || value === null,
     object: (target) => target !== null && typeof target === 'object',
     instance: (target) => Object.prototype.hasOwnProperty.call(target, 'constructor'),
     constructor: (target) => typeof target === 'function' && !!target.prototype,
 };
+function isSerializable(target) {
+    return exports.Is.object(target) && typeof target.toString === 'function' && target.toString !== Object.prototype.toString;
+}
+const toString = (target) => (isSerializable(target) ? target.toString() : String(target));
+exports.toString = toString;

package/esm/index.js

@@ -51,4 +51,4 @@ export { select } from './select.js';
 export { pipe } from './utils/fp.js';
 export { findOrFail } from './utils/array.js';
 export { ProxyRegistry, unwrapProxy } from './utils/ProxyRegistry.js';
-export { Is } from './utils/basic.js';
+export { Is, isSerializable } from './utils/basic.js';

package/esm/provider/Provider.js

@@ -1,3 +1,4 @@
+import { toString } from '../utils/basic.js';
 import { CannonSingletonApplyTwiceError } from '../errors/CannonSingletonApplyTwiceError.js';
 import { ProviderDisposedError } from '../errors/ProviderDisposedError.js';
 export class Provider {
@@ -28,7 +29,7 @@ export class Provider {
         if (!this.getKey) {
             return this.resolveDep(scope, options);
         }
-        const key = this.getKey(...(options.args ?? []));
+        const key = toString(this.getKey(...(options.args ?? [])));
         if (!this.cache.has(key)) {
             this.cache.set(key, this.resolveDep(scope, options));
         }

package/esm/token/ClassToken.js

@@ -3,8 +3,8 @@ export class ClassToken extends InjectionToken {
     target;
     _getArgsFn;
     _isLazy;
-    constructor(target, { getArgsFn = forwardArgs, isLazy = false } = {}) {
-        super();
+    constructor(target, { getArgsFn = forwardArgs, isLazy = false, tags = [], } = {}) {
+        super(tags);
         this.target = target;
         this._getArgsFn = getArgsFn;
         this._isLazy = isLazy;
@@ -23,6 +23,7 @@ export class ClassToken extends InjectionToken {
         return new ClassToken(this.target, {
             getArgsFn: (s, opts) => [...parentFn(s, opts), ...newArgs],
             isLazy: this._isLazy,
+            tags: this.getTags(),
         });
     }
     argsFn(fn) {
@@ -30,15 +31,24 @@ export class ClassToken extends InjectionToken {
         return new ClassToken(this.target, {
             getArgsFn: (s, opts) => [...parentFn(s, opts), ...fn(s)],
             isLazy: this._isLazy,
+            tags: this.getTags(),
         });
     }
     lazy() {
         return new ClassToken(this.target, {
             getArgsFn: this._getArgsFn,
             isLazy: true,
+            tags: this.getTags(),
         });
     }
-    getKey() {
-        return this.target;
+    addTags(...tags) {
+        return new ClassToken(this.target, {
+            getArgsFn: this._getArgsFn,
+            isLazy: this._isLazy,
+            tags: [...this.getTags(), ...tags],
+        });
+    }
+    toString() {
+        return this.target.name;
     }
 }

package/esm/token/ConstantToken.js

@@ -2,8 +2,8 @@ import { InjectionToken } from './InjectionToken.js';
 import { MethodNotImplementedError } from '../errors/MethodNotImplementedError.js';
 export class ConstantToken extends InjectionToken {
     token;
-    constructor(token) {
-        super();
+    constructor(token, { tags = [] } = {}) {
+        super(tags);
         this.token = token;
     }
     resolve(s) {
@@ -18,7 +18,10 @@ export class ConstantToken extends InjectionToken {
     lazy() {
         throw new MethodNotImplementedError('not implemented');
     }
-    getKey() {
+    addTags(...tags) {
+        return new ConstantToken(this.token, { tags: [...this.getTags(), ...tags] });
+    }
+    toString() {
         throw new MethodNotImplementedError('not implemented');
     }
 }

package/esm/token/FunctionToken.js

@@ -4,8 +4,8 @@ export class FunctionToken extends InjectionToken {
     fn;
     _getArgsFn;
     _isLazy;
-    constructor(fn, { getArgsFn = forwardArgs, isLazy = false } = {}) {
-        super();
+    constructor(fn, { getArgsFn = forwardArgs, isLazy = false, tags = [], } = {}) {
+        super(tags);
         this.fn = fn;
         this._getArgsFn = getArgsFn;
         this._isLazy = isLazy;
@@ -21,6 +21,7 @@ export class FunctionToken extends InjectionToken {
         return new FunctionToken(this.fn, {
             getArgsFn: (s, opts) => [...parentFn(s, opts), ...newArgs],
             isLazy: this._isLazy,
+            tags: this.getTags(),
         });
     }
     argsFn(fn) {
@@ -28,15 +29,24 @@ export class FunctionToken extends InjectionToken {
         return new FunctionToken(this.fn, {
             getArgsFn: (s, opts) => [...parentFn(s, opts), ...fn(s)],
             isLazy: this._isLazy,
+            tags: this.getTags(),
         });
     }
     lazy() {
         return new FunctionToken(this.fn, {
             getArgsFn: this._getArgsFn,
             isLazy: true,
+            tags: this.getTags(),
         });
     }
-    getKey() {
+    addTags(...tags) {
+        return new FunctionToken(this.fn, {
+            getArgsFn: this._getArgsFn,
+            isLazy: this._isLazy,
+            tags: [...this.getTags(), ...tags],
+        });
+    }
+    toString() {
         throw new MethodNotImplementedError('not implemented');
     }
 }

package/esm/token/GroupAliasToken.js

@@ -3,8 +3,8 @@ export class GroupAliasToken extends InjectionToken {
     token;
     _getArgsFn;
     _isLazy;
-    constructor(token, { getArgsFn = forwardArgs, isLazy = false } = {}) {
-        super();
+    constructor(token, { getArgsFn = forwardArgs, isLazy = false, tags = [], } = {}) {
+        super(tags);
         this.token = token;
         this._getArgsFn = getArgsFn;
         this._isLazy = isLazy;
@@ -26,6 +26,7 @@ export class GroupAliasToken extends InjectionToken {
         return new GroupAliasToken(this.token, {
             getArgsFn: (s, opts) => [...parentFn(s, opts), ...newArgs],
             isLazy: this._isLazy,
+            tags: this.getTags(),
         });
     }
     argsFn(fn) {
@@ -33,16 +34,25 @@ export class GroupAliasToken extends InjectionToken {
         return new GroupAliasToken(this.token, {
             getArgsFn: (s, opts) => [...parentFn(s, opts), ...fn(s)],
             isLazy: this._isLazy,
+            tags: this.getTags(),
         });
     }
     lazy() {
         return new GroupAliasToken(this.token, {
             getArgsFn: this._getArgsFn,
             isLazy: true,
+            tags: this.getTags(),
         });
     }
-    getKey() {
-        return this.token;
+    addTags(...tags) {
+        return new GroupAliasToken(this.token, {
+            getArgsFn: this._getArgsFn,
+            isLazy: this._isLazy,
+            tags: [...this.getTags(), ...tags],
+        });
+    }
+    toString() {
+        return this.token.toString();
     }
 }
 export const toGroupAlias = (token) => new GroupAliasToken(token);

package/esm/token/GroupInstanceToken.js

@@ -2,10 +2,11 @@ import { InjectionToken } from './InjectionToken.js';
 import { MethodNotImplementedError } from '../errors/MethodNotImplementedError.js';
 export class GroupInstanceToken extends InjectionToken {
     predicate;
-    isCascade = true;
-    constructor(predicate) {
-        super();
+    isCascade;
+    constructor(predicate, { tags = [], isCascade = true } = {}) {
+        super(tags);
         this.predicate = predicate;
+        this.isCascade = isCascade;
     }
     select(fn) {
         return (s) => this.resolve(s).map(fn);
@@ -26,7 +27,10 @@ export class GroupInstanceToken extends InjectionToken {
     resolve(c) {
         return c.getInstances(this.isCascade).filter(this.predicate);
     }
-    getKey() {
+    addTags(...tags) {
+        return new GroupInstanceToken(this.predicate, { tags: [...this.getTags(), ...tags], isCascade: this.isCascade });
+    }
+    toString() {
         throw new MethodNotImplementedError('not implemented');
     }
 }

package/esm/token/InjectionToken.js

@@ -1,7 +1,23 @@
 import { Is } from '../utils/basic.js';
 export const forwardArgs = (_, { args = [] } = {}) => args;
 export class InjectionToken {
+    tags;
+    constructor(tags = []) {
+        this.tags = new Set(tags);
+    }
+    hasTag(tag) {
+        return this.tags.has(tag);
+    }
+    getTags() {
+        return [...this.tags];
+    }
 }
 export function isInjectionToken(target) {
-    return Is.object(target) && 'resolve' in target && 'args' in target && 'argsFn' in target && 'lazy' in target;
+    return (Is.object(target) &&
+        'resolve' in target &&
+        'args' in target &&
+        'argsFn' in target &&
+        'lazy' in target &&
+        'hasTag' in target &&
+        'addTags' in target);
 }

package/esm/token/SingleAliasToken.js

@@ -3,8 +3,8 @@ export class SingleAliasToken extends InjectionToken {
     token;
     _getArgsFn;
     _isLazy;
-    constructor(token, { getArgsFn = forwardArgs, isLazy = false } = {}) {
-        super();
+    constructor(token, { getArgsFn = forwardArgs, isLazy = false, tags = [], } = {}) {
+        super(tags);
         this.token = token;
         this._getArgsFn = getArgsFn;
         this._isLazy = isLazy;
@@ -26,6 +26,7 @@ export class SingleAliasToken extends InjectionToken {
         return new SingleAliasToken(this.token, {
             getArgsFn: (s, opts) => [...parentFn(s, opts), ...newArgs],
             isLazy: this._isLazy,
+            tags: this.getTags(),
         });
     }
     argsFn(fn) {
@@ -33,16 +34,25 @@ export class SingleAliasToken extends InjectionToken {
         return new SingleAliasToken(this.token, {
             getArgsFn: (s, opts) => [...parentFn(s, opts), ...fn(s)],
             isLazy: this._isLazy,
+            tags: this.getTags(),
         });
     }
     lazy() {
         return new SingleAliasToken(this.token, {
             getArgsFn: this._getArgsFn,
             isLazy: true,
+            tags: this.getTags(),
         });
     }
-    getKey() {
-        return this.token;
+    addTags(...tags) {
+        return new SingleAliasToken(this.token, {
+            getArgsFn: this._getArgsFn,
+            isLazy: this._isLazy,
+            tags: [...this.getTags(), ...tags],
+        });
+    }
+    toString() {
+        return this.token.toString();
     }
 }
 export const toSingleAlias = (token) => new SingleAliasToken(token);

package/esm/token/SingleToken.js

@@ -3,8 +3,8 @@ export class SingleToken extends InjectionToken {
     token;
     _getArgsFn;
     _isLazy;
-    constructor(token, { getArgsFn = forwardArgs, isLazy = false } = {}) {
-        super();
+    constructor(token, { getArgsFn = forwardArgs, isLazy = false, tags = [], } = {}) {
+        super(tags);
         this.token = token;
         this._getArgsFn = getArgsFn;
         this._isLazy = isLazy;
@@ -26,6 +26,7 @@ export class SingleToken extends InjectionToken {
         return new SingleToken(this.token, {
             getArgsFn: (s, opts) => [...parentFn(s, opts), ...newArgs],
             isLazy: this._isLazy,
+            tags: this.getTags(),
         });
     }
     argsFn(fn) {
@@ -33,15 +34,24 @@ export class SingleToken extends InjectionToken {
         return new SingleToken(this.token, {
             getArgsFn: (s, opts) => [...parentFn(s, opts), ...fn(s)],
             isLazy: this._isLazy,
+            tags: this.getTags(),
         });
     }
     lazy() {
         return new SingleToken(this.token, {
             getArgsFn: this._getArgsFn,
             isLazy: true,
+            tags: this.getTags(),
         });
     }
-    getKey() {
-        return this.token;
+    addTags(...tags) {
+        return new SingleToken(this.token, {
+            getArgsFn: this._getArgsFn,
+            isLazy: this._isLazy,
+            tags: [...this.getTags(), ...tags],
+        });
+    }
+    toString() {
+        return this.token.toString();
     }
 }

package/esm/utils/basic.js

@@ -4,3 +4,7 @@ export const Is = {
     instance: (target) => Object.prototype.hasOwnProperty.call(target, 'constructor'),
     constructor: (target) => typeof target === 'function' && !!target.prototype,
 };
+export function isSerializable(target) {
+    return Is.object(target) && typeof target.toString === 'function' && target.toString !== Object.prototype.toString;
+}
+export const toString = (target) => (isSerializable(target) ? target.toString() : String(target));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ts-ioc-container",
-  "version": "69.2.0",
+  "version": "70.1.0",
   "description": "Fast, lightweight TypeScript dependency injection container with a clean API, scoped lifecycles, decorators, tokens, hooks, lazy injection, customizable providers, and no global container objects.",
   "publishConfig": {
     "access": "public",

package/typings/index.d.ts

@@ -53,4 +53,4 @@ export { select } from './select.js';
 export { pipe, type MapFn } from './utils/fp.js';
 export { findOrFail, type Predicate } from './utils/array.js';
 export { ProxyRegistry, unwrapProxy, type IProxyRegistry } from './utils/ProxyRegistry.js';
-export { type Branded, type constructor, type Instance, Is } from './utils/basic.js';
+export { type Branded, type constructor, type Instance, type Serializable, Is, isSerializable } from './utils/basic.js';

package/typings/provider/IProvider.d.ts

@@ -1,5 +1,6 @@
 import { IContainer, Tagged } from '../container/IContainer.js';
 import { InjectOptions } from '../injector/IInjector.js';
+import { Serializable } from '../utils/basic.js';
 export type WithLazy = {
     lazy: boolean;
 };
@@ -12,7 +13,7 @@ export type ScopeAccessOptions = {
 };
 export type ScopeAccessRule = (options: ScopeAccessOptions, prev: boolean) => boolean;
 export type ArgsFn = (l: IContainer, options?: InjectOptions) => unknown[];
-export type GetCacheKey = (...args: unknown[]) => string | symbol;
+export type GetCacheKey = (...args: unknown[]) => string | Serializable;
 export type DecorateFn<Instance = any> = (dep: Instance, scope: IContainer) => Instance;
 export type ProviderHook = (dependency: unknown, scope: IContainer) => void;
 export interface IProvider<T = any> {

package/typings/token/ClassToken.d.ts

@@ -1,19 +1,21 @@
 import { IContainer } from '../container/IContainer.js';
 import { InjectionToken } from './InjectionToken.js';
-import { type constructor } from '../utils/basic.js';
+import { type constructor, Serializable } from '../utils/basic.js';
 import { ArgsFn, ProviderOptions } from '../provider/IProvider.js';
-export declare class ClassToken<T = any> extends InjectionToken<T> {
+export declare class ClassToken<T = any> extends InjectionToken<T> implements Serializable {
     private readonly target;
     private readonly _getArgsFn;
     private readonly _isLazy;
-    constructor(target: constructor<T>, { getArgsFn, isLazy }?: {
+    constructor(target: constructor<T>, { getArgsFn, isLazy, tags, }?: {
         getArgsFn?: ArgsFn;
         isLazy?: boolean;
+        tags?: string[];
     });
     select<R>(fn: (target: T) => R): (s: IContainer) => R;
     resolve(s: IContainer, { args, lazy }?: ProviderOptions): T;
     args(...newArgs: unknown[]): ClassToken<T>;
     argsFn(fn: (s: IContainer) => unknown[]): ClassToken<T>;
     lazy(): ClassToken<T>;
-    getKey(): constructor<T>;
+    addTags(...tags: string[]): ClassToken<T>;
+    toString(): string;
 }

package/typings/token/ConstantToken.d.ts

@@ -1,12 +1,15 @@
-import type { DependencyKey, IContainer } from '../container/IContainer.js';
+import type { IContainer } from '../container/IContainer.js';
 import { InjectionToken } from './InjectionToken.js';
-import { type constructor } from '../utils/basic.js';
-export declare class ConstantToken<T = any> extends InjectionToken<T> {
+import { Serializable } from '../utils/basic.js';
+export declare class ConstantToken<T = any> extends InjectionToken<T> implements Serializable {
     private readonly token;
-    constructor(token: T);
+    constructor(token: T, { tags }?: {
+        tags?: string[];
+    });
     resolve(s: IContainer): T;
     args(...deps: unknown[]): InjectionToken<T>;
     argsFn(getArgsFn: (s: IContainer) => unknown[]): InjectionToken<T>;
     lazy(): InjectionToken<T>;
-    getKey(): DependencyKey | constructor<T>;
+    addTags(...tags: string[]): ConstantToken<T>;
+    toString(): string;
 }

package/typings/token/FunctionToken.d.ts

@@ -1,19 +1,21 @@
-import type { DependencyKey, IContainer } from '../container/IContainer.js';
+import type { IContainer } from '../container/IContainer.js';
 import { InjectionToken } from './InjectionToken.js';
 import { InjectFn } from '../hooks/hook.js';
 import { ArgsFn, ProviderOptions } from '../provider/IProvider.js';
-import { type constructor } from '../utils/basic.js';
-export declare class FunctionToken<T = any> extends InjectionToken<T> {
+import { Serializable } from '../utils/basic.js';
+export declare class FunctionToken<T = any> extends InjectionToken<T> implements Serializable {
     private readonly fn;
     private readonly _getArgsFn;
     private readonly _isLazy;
-    constructor(fn: InjectFn<T>, { getArgsFn, isLazy }?: {
+    constructor(fn: InjectFn<T>, { getArgsFn, isLazy, tags, }?: {
         getArgsFn?: ArgsFn;
         isLazy?: boolean;
+        tags?: string[];
     });
     resolve(s: IContainer, { args, lazy }?: ProviderOptions): T;
     args(...newArgs: unknown[]): InjectionToken<T>;
     argsFn(fn: (s: IContainer) => unknown[]): InjectionToken<T>;
     lazy(): InjectionToken<T>;
-    getKey(): DependencyKey | constructor<T>;
+    addTags(...tags: string[]): FunctionToken<T>;
+    toString(): string;
 }

package/typings/token/GroupAliasToken.d.ts

@@ -3,13 +3,15 @@ import { InjectionToken } from './InjectionToken.js';
 import { IRegistration } from '../registration/IRegistration.js';
 import { BindToken } from './BindToken.js';
 import { ArgsFn, ProviderOptions } from '../provider/IProvider.js';
-export declare class GroupAliasToken<T = any> extends InjectionToken<T[]> implements BindToken<T> {
+import { Serializable } from '../utils/basic.js';
+export declare class GroupAliasToken<T = any> extends InjectionToken<T[]> implements BindToken<T>, Serializable {
     readonly token: DependencyKey;
     private readonly _getArgsFn;
     private readonly _isLazy;
-    constructor(token: DependencyKey, { getArgsFn, isLazy }?: {
+    constructor(token: DependencyKey, { getArgsFn, isLazy, tags, }?: {
         getArgsFn?: ArgsFn;
         isLazy?: boolean;
+        tags?: string[];
     });
     select<R>(fn: (target: T[]) => R[]): (s: IContainer) => R[];
     resolve(s: IContainer, { args, lazy }?: ProviderOptions): T[];
@@ -17,6 +19,7 @@ export declare class GroupAliasToken<T = any> extends InjectionToken<T[]> implem
     args(...newArgs: unknown[]): GroupAliasToken<T>;
     argsFn(fn: (s: IContainer) => unknown[]): GroupAliasToken<T>;
     lazy(): GroupAliasToken<T>;
-    getKey(): DependencyKey;
+    addTags(...tags: string[]): GroupAliasToken<T>;
+    toString(): string;
 }
 export declare const toGroupAlias: <T>(token: DependencyKey) => GroupAliasToken<T>;

package/typings/token/GroupInstanceToken.d.ts

@@ -1,16 +1,20 @@
 import { InjectionToken } from './InjectionToken.js';
-import type { DependencyKey, IContainer } from '../container/IContainer.js';
-import { type constructor, Instance } from '../utils/basic.js';
+import type { IContainer } from '../container/IContainer.js';
+import { Instance, Serializable } from '../utils/basic.js';
 export type InstancePredicate = (dep: unknown) => boolean;
-export declare class GroupInstanceToken extends InjectionToken<Instance[]> {
+export declare class GroupInstanceToken extends InjectionToken<Instance[]> implements Serializable {
     private predicate;
     private isCascade;
-    constructor(predicate: InstancePredicate);
+    constructor(predicate: InstancePredicate, { tags, isCascade }?: {
+        tags?: string[];
+        isCascade?: boolean;
+    });
     select<R>(fn: (target: Instance) => R): (s: IContainer) => R[];
     args(...deps: unknown[]): this;
     argsFn(getArgsFn: (s: IContainer) => unknown[]): InjectionToken<Instance[]>;
     lazy(): InjectionToken<Instance[]>;
     cascade(isTrue: boolean): this;
     resolve(c: IContainer): Instance[];
-    getKey(): DependencyKey | constructor<Instance[]>;
+    addTags(...tags: string[]): GroupInstanceToken;
+    toString(): string;
 }

package/typings/token/InjectionToken.d.ts

@@ -1,12 +1,15 @@
-import { type DependencyKey, type IContainer } from '../container/IContainer.js';
+import { type IContainer, type Tag } from '../container/IContainer.js';
 import { ArgsFn, ProviderOptions } from '../provider/IProvider.js';
-import { type constructor } from '../utils/basic.js';
 export declare const forwardArgs: ArgsFn;
 export declare abstract class InjectionToken<T = any> {
+    private readonly tags;
+    protected constructor(tags?: Tag[]);
     abstract resolve(s: IContainer, options?: ProviderOptions): T;
     abstract args(...deps: unknown[]): InjectionToken<T>;
     abstract argsFn(getArgsFn: (s: IContainer) => unknown[]): InjectionToken<T>;
     abstract lazy(): InjectionToken<T>;
-    abstract getKey(): DependencyKey | constructor<T>;
+    abstract addTags(...tags: Tag[]): InjectionToken<T>;
+    hasTag(tag: Tag): boolean;
+    protected getTags(): Tag[];
 }
 export declare function isInjectionToken(target: unknown): target is InjectionToken;

package/typings/token/SingleAliasToken.d.ts

@@ -3,13 +3,15 @@ import { InjectionToken } from './InjectionToken.js';
 import { IRegistration } from '../registration/IRegistration.js';
 import { BindToken } from './BindToken.js';
 import { ArgsFn } from '../provider/IProvider.js';
-export declare class SingleAliasToken<T = any> extends InjectionToken<T> implements BindToken<T> {
+import { Serializable } from '../utils/basic.js';
+export declare class SingleAliasToken<T = any> extends InjectionToken<T> implements BindToken<T>, Serializable {
     readonly token: DependencyKey;
     private readonly _getArgsFn;
     private readonly _isLazy;
-    constructor(token: DependencyKey, { getArgsFn, isLazy }?: {
+    constructor(token: DependencyKey, { getArgsFn, isLazy, tags, }?: {
         getArgsFn?: ArgsFn;
         isLazy?: boolean;
+        tags?: string[];
     });
     select<R>(fn: (target: T) => R): (s: IContainer) => R;
     resolve(s: IContainer, { args, lazy }?: ResolveOneOptions): T;
@@ -17,6 +19,7 @@ export declare class SingleAliasToken<T = any> extends InjectionToken<T> impleme
     args(...newArgs: unknown[]): SingleAliasToken<T>;
     argsFn(fn: (s: IContainer) => unknown[]): SingleAliasToken<T>;
     lazy(): SingleAliasToken<T>;
-    getKey(): DependencyKey;
+    addTags(...tags: string[]): SingleAliasToken<T>;
+    toString(): string;
 }
 export declare const toSingleAlias: <T>(token: DependencyKey) => SingleAliasToken<T>;

package/typings/token/SingleToken.d.ts

@@ -2,13 +2,15 @@ import { DependencyKey, IContainer } from '../container/IContainer.js';
 import { InjectionToken } from './InjectionToken.js';
 import { IRegistration } from '../registration/IRegistration.js';
 import { ArgsFn, ProviderOptions } from '../provider/IProvider.js';
-export declare class SingleToken<T = any> extends InjectionToken<T> {
+import { Serializable } from '../utils/basic.js';
+export declare class SingleToken<T = any> extends InjectionToken<T> implements Serializable {
     token: DependencyKey;
     private readonly _getArgsFn;
     private readonly _isLazy;
-    constructor(token: DependencyKey, { getArgsFn, isLazy }?: {
+    constructor(token: DependencyKey, { getArgsFn, isLazy, tags, }?: {
         getArgsFn?: ArgsFn;
         isLazy?: boolean;
+        tags?: string[];
     });
     select<R>(fn: (target: T) => R): (s: IContainer) => R;
     resolve(s: IContainer, { args, lazy }?: ProviderOptions): T;
@@ -16,5 +18,6 @@ export declare class SingleToken<T = any> extends InjectionToken<T> {
     args(...newArgs: unknown[]): SingleToken<T>;
     argsFn(fn: (s: IContainer) => unknown[]): SingleToken<T>;
     lazy(): SingleToken<T>;
-    getKey(): DependencyKey;
+    addTags(...tags: string[]): SingleToken<T>;
+    toString(): string;
 }

package/typings/utils/basic.d.ts

@@ -1,4 +1,7 @@
 export type constructor<T> = new (...args: any[]) => T;
+export interface Serializable {
+    toString(): string;
+}
 export type Branded<TBrand extends string, T> = T & {
     readonly __brand?: TBrand;
 };
@@ -9,3 +12,5 @@ export declare const Is: {
     instance: (target: unknown) => target is Instance;
     constructor: (target: unknown) => target is constructor<unknown>;
 };
+export declare function isSerializable(target: unknown): target is Serializable;
+export declare const toString: (target: unknown) => string;