ts-ioc-container 54.0.1 → 55.0.0

package/cjm/container/Container.js

@@ -6,6 +6,7 @@ const ContainerDisposedError_1 = require("../errors/ContainerDisposedError");
 const MetadataInjector_1 = require("../injector/MetadataInjector");
 const AliasMap_1 = require("./AliasMap");
 const DependencyNotFoundError_1 = require("../errors/DependencyNotFoundError");
+const ContainerNotFoundError_1 = require("../errors/ContainerNotFoundError");
 const basic_1 = require("../utils/basic");
 const array_1 = require("../utils/array");
 class Container {
@@ -131,6 +132,21 @@ class Container {
     getScopes() {
         return [...this.scopes];
     }
+    hasInstance(instance) {
+        return this.instances.includes(instance);
+    }
+    getScopeByInstanceOrFail(instance) {
+        this.validateContainer();
+        const queue = [this];
+        while (queue.length > 0) {
+            const scope = queue.shift();
+            if (scope.hasInstance(instance)) {
+                return scope;
+            }
+            queue.push(...scope.getScopes());
+        }
+        throw new ContainerNotFoundError_1.ContainerNotFoundError('Cannot find scope for the given instance');
+    }
     removeScope(child) {
         this.scopes = this.scopes.filter((s) => s !== child);
     }

package/cjm/container/EmptyContainer.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.EmptyContainer = void 0;
 const MethodNotImplementedError_1 = require("../errors/MethodNotImplementedError");
 const DependencyNotFoundError_1 = require("../errors/DependencyNotFoundError");
+const ContainerNotFoundError_1 = require("../errors/ContainerNotFoundError");
 class EmptyContainer {
     get isDisposed() {
         throw new MethodNotImplementedError_1.MethodNotImplementedError();
@@ -14,9 +15,15 @@ class EmptyContainer {
     getScopes() {
         return [];
     }
+    getScopeByInstanceOrFail(instance) {
+        throw new ContainerNotFoundError_1.ContainerNotFoundError('Cannot find scope for the given instance');
+    }
     getInstances() {
         return [];
     }
+    hasInstance(instance) {
+        return false;
+    }
     createScope() {
         throw new MethodNotImplementedError_1.MethodNotImplementedError();
     }

package/cjm/errors/ContainerNotFoundError.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ContainerNotFoundError = void 0;
+const ContainerError_1 = require("./ContainerError");
+class ContainerNotFoundError extends ContainerError_1.ContainerError {
+    name = 'ContainerNotFoundError';
+    constructor(message) {
+        super(message);
+        Object.setPrototypeOf(this, ContainerNotFoundError.prototype);
+    }
+}
+exports.ContainerNotFoundError = ContainerNotFoundError;

package/cjm/index.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SingleToken = exports.ClassToken = exports.toSingleAlias = exports.SingleAliasToken = exports.toGroupAlias = exports.GroupAliasToken = exports.InjectionToken = exports.HooksRunner = exports.AddOnDisposeHookModule = exports.onDispose = exports.onDisposeHooksRunner = exports.AddOnConstructHookModule = exports.onConstruct = exports.onConstructHooksRunner = exports.injectProp = exports.createHookContext = exports.createHookContextFactory = exports.HookContext = exports.hasHooks = exports.hook = exports.getHooks = exports.CannonSingletonApplyTwiceError = exports.UnexpectedHookResultError = exports.ProviderDisposedError = exports.ContainerDisposedError = exports.MethodNotImplementedError = exports.DependencyMissingKeyError = exports.DependencyNotFoundError = exports.Registration = exports.appendArgsFn = exports.appendArgs = exports.decorate = exports.singleton = exports.lazy = exports.scopeAccess = exports.scope = exports.bindTo = exports.register = exports.Provider = exports.ProxyInjector = exports.SimpleInjector = exports.resolveArgs = exports.argsFn = exports.args = exports.inject = exports.MetadataInjector = exports.Injector = exports.EmptyContainer = exports.Container = exports.isDependencyKey = void 0;
-exports.resolveConstructor = exports.Is = exports.pipe = exports.select = exports.once = exports.shallowCache = exports.debounce = exports.throttle = exports.handleAsyncError = exports.handleError = exports.getMethodTags = exports.methodTag = exports.getMethodLabels = exports.methodLabel = exports.getMethodMeta = exports.methodMeta = exports.getParamTags = exports.paramTag = exports.getParamLabels = exports.paramLabel = exports.getParamMeta = exports.paramMeta = exports.getClassTags = exports.classTag = exports.getClassLabels = exports.classLabel = exports.getClassMeta = exports.classMeta = exports.GroupInstanceToken = exports.ConstantToken = exports.FunctionToken = void 0;
+exports.ClassToken = exports.toSingleAlias = exports.SingleAliasToken = exports.toGroupAlias = exports.GroupAliasToken = exports.InjectionToken = exports.HooksRunner = exports.AddOnDisposeHookModule = exports.onDispose = exports.onDisposeHooksRunner = exports.AddOnConstructHookModule = exports.onConstruct = exports.onConstructHooksRunner = exports.injectProp = exports.createHookContext = exports.createHookContextFactory = exports.HookContext = exports.hasHooks = exports.hook = exports.getHooks = exports.CannonSingletonApplyTwiceError = exports.UnexpectedHookResultError = exports.ProviderDisposedError = exports.ContainerDisposedError = exports.MethodNotImplementedError = exports.DependencyMissingKeyError = exports.ContainerNotFoundError = exports.DependencyNotFoundError = exports.Registration = exports.appendArgsFn = exports.appendArgs = exports.decorate = exports.singleton = exports.lazy = exports.scopeAccess = exports.scope = exports.bindTo = exports.register = exports.Provider = exports.ProxyInjector = exports.SimpleInjector = exports.resolveArgs = exports.argsFn = exports.args = exports.inject = exports.MetadataInjector = exports.Injector = exports.EmptyContainer = exports.Container = exports.isDependencyKey = void 0;
+exports.resolveConstructor = exports.Is = exports.pipe = exports.select = exports.once = exports.shallowCache = exports.debounce = exports.throttle = 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.GroupInstanceToken = exports.ConstantToken = exports.FunctionToken = exports.SingleToken = void 0;
 // Containers
 var IContainer_1 = require("./container/IContainer");
 Object.defineProperty(exports, "isDependencyKey", { enumerable: true, get: function () { return IContainer_1.isDependencyKey; } });
@@ -40,6 +40,8 @@ Object.defineProperty(exports, "Registration", { enumerable: true, get: function
 // Errors
 var DependencyNotFoundError_1 = require("./errors/DependencyNotFoundError");
 Object.defineProperty(exports, "DependencyNotFoundError", { enumerable: true, get: function () { return DependencyNotFoundError_1.DependencyNotFoundError; } });
+var ContainerNotFoundError_1 = require("./errors/ContainerNotFoundError");
+Object.defineProperty(exports, "ContainerNotFoundError", { enumerable: true, get: function () { return ContainerNotFoundError_1.ContainerNotFoundError; } });
 var DependencyMissingKeyError_1 = require("./errors/DependencyMissingKeyError");
 Object.defineProperty(exports, "DependencyMissingKeyError", { enumerable: true, get: function () { return DependencyMissingKeyError_1.DependencyMissingKeyError; } });
 var MethodNotImplementedError_1 = require("./errors/MethodNotImplementedError");
@@ -94,25 +96,25 @@ var GroupInstanceToken_1 = require("./token/GroupInstanceToken");
 Object.defineProperty(exports, "GroupInstanceToken", { enumerable: true, get: function () { return GroupInstanceToken_1.GroupInstanceToken; } });
 // Metadata
 var class_1 = require("./metadata/class");
-Object.defineProperty(exports, "classMeta", { enumerable: true, get: function () { return class_1.classMeta; } });
+Object.defineProperty(exports, "addClassMeta", { enumerable: true, get: function () { return class_1.addClassMeta; } });
 Object.defineProperty(exports, "getClassMeta", { enumerable: true, get: function () { return class_1.getClassMeta; } });
-Object.defineProperty(exports, "classLabel", { enumerable: true, get: function () { return class_1.classLabel; } });
+Object.defineProperty(exports, "addClassLabel", { enumerable: true, get: function () { return class_1.addClassLabel; } });
 Object.defineProperty(exports, "getClassLabels", { enumerable: true, get: function () { return class_1.getClassLabels; } });
-Object.defineProperty(exports, "classTag", { enumerable: true, get: function () { return class_1.classTag; } });
+Object.defineProperty(exports, "addClassTag", { enumerable: true, get: function () { return class_1.addClassTag; } });
 Object.defineProperty(exports, "getClassTags", { enumerable: true, get: function () { return class_1.getClassTags; } });
 var parameter_1 = require("./metadata/parameter");
-Object.defineProperty(exports, "paramMeta", { enumerable: true, get: function () { return parameter_1.paramMeta; } });
+Object.defineProperty(exports, "addParamMeta", { enumerable: true, get: function () { return parameter_1.addParamMeta; } });
 Object.defineProperty(exports, "getParamMeta", { enumerable: true, get: function () { return parameter_1.getParamMeta; } });
-Object.defineProperty(exports, "paramLabel", { enumerable: true, get: function () { return parameter_1.paramLabel; } });
+Object.defineProperty(exports, "addParamLabel", { enumerable: true, get: function () { return parameter_1.addParamLabel; } });
 Object.defineProperty(exports, "getParamLabels", { enumerable: true, get: function () { return parameter_1.getParamLabels; } });
-Object.defineProperty(exports, "paramTag", { enumerable: true, get: function () { return parameter_1.paramTag; } });
+Object.defineProperty(exports, "addParamTag", { enumerable: true, get: function () { return parameter_1.addParamTag; } });
 Object.defineProperty(exports, "getParamTags", { enumerable: true, get: function () { return parameter_1.getParamTags; } });
 var method_1 = require("./metadata/method");
-Object.defineProperty(exports, "methodMeta", { enumerable: true, get: function () { return method_1.methodMeta; } });
+Object.defineProperty(exports, "addMethodMeta", { enumerable: true, get: function () { return method_1.addMethodMeta; } });
 Object.defineProperty(exports, "getMethodMeta", { enumerable: true, get: function () { return method_1.getMethodMeta; } });
-Object.defineProperty(exports, "methodLabel", { enumerable: true, get: function () { return method_1.methodLabel; } });
+Object.defineProperty(exports, "addMethodLabel", { enumerable: true, get: function () { return method_1.addMethodLabel; } });
 Object.defineProperty(exports, "getMethodLabels", { enumerable: true, get: function () { return method_1.getMethodLabels; } });
-Object.defineProperty(exports, "methodTag", { enumerable: true, get: function () { return method_1.methodTag; } });
+Object.defineProperty(exports, "addMethodTag", { enumerable: true, get: function () { return method_1.addMethodTag; } });
 Object.defineProperty(exports, "getMethodTags", { enumerable: true, get: function () { return method_1.getMethodTags; } });
 var errorHandler_1 = require("./utils/errorHandler");
 Object.defineProperty(exports, "handleError", { enumerable: true, get: function () { return errorHandler_1.handleError; } });

package/cjm/injector/MetadataInjector.js

@@ -14,7 +14,7 @@ class MetadataInjector extends IInjector_1.Injector {
 exports.MetadataInjector = MetadataInjector;
 const hookMetaKey = (methodName = 'constructor') => `inject:${methodName}`;
 const inject = (fn) => (target, propertyKey, parameterIndex) => {
-    (0, parameter_1.paramMeta)(hookMetaKey(propertyKey), () => (0, toToken_1.toToken)(fn))(basic_1.Is.instance(target) ? target.constructor : target, propertyKey, parameterIndex);
+    (0, parameter_1.addParamMeta)(hookMetaKey(propertyKey), () => (0, toToken_1.toToken)(fn))(basic_1.Is.instance(target) ? target.constructor : target, propertyKey, parameterIndex);
 };
 exports.inject = inject;
 const args = (index) => (c, { args = [] }) => {

package/cjm/metadata/class.js

@@ -1,21 +1,21 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getClassTags = exports.classTag = exports.getClassLabels = exports.classLabel = exports.classMeta = void 0;
+exports.getClassTags = exports.addClassTag = exports.getClassLabels = exports.addClassLabel = exports.addClassMeta = void 0;
 exports.getClassMeta = getClassMeta;
 const basic_1 = require("../utils/basic");
-const classMeta = (key, mapFn) => (target) => {
+const addClassMeta = (key, mapFn) => (target) => {
     const value = Reflect.getOwnMetadata(key, target);
     Reflect.defineMetadata(key, mapFn(value), target);
 };
-exports.classMeta = classMeta;
+exports.addClassMeta = addClassMeta;
 function getClassMeta(target, key) {
     return Reflect.getOwnMetadata(key, (0, basic_1.resolveConstructor)(target));
 }
-const classLabel = (key, label) => (0, exports.classMeta)('label', (prev = new Map()) => prev.set(key, label));
-exports.classLabel = classLabel;
+const addClassLabel = (key, label) => (0, exports.addClassMeta)('label', (prev = new Map()) => prev.set(key, label));
+exports.addClassLabel = addClassLabel;
 const getClassLabels = (target) => getClassMeta(target, 'label') ?? new Map();
 exports.getClassLabels = getClassLabels;
-const classTag = (tag) => (0, exports.classMeta)('tag', (prev = new Set()) => prev.add(tag));
-exports.classTag = classTag;
+const addClassTag = (tag) => (0, exports.addClassMeta)('tag', (prev = new Set()) => prev.add(tag));
+exports.addClassTag = addClassTag;
 const getClassTags = (target) => getClassMeta(target, 'tag') ?? new Set();
 exports.getClassTags = getClassTags;

package/cjm/metadata/method.js

@@ -1,19 +1,19 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getMethodTags = exports.methodTag = exports.getMethodLabels = exports.methodLabel = exports.getMethodMeta = exports.methodMeta = void 0;
+exports.getMethodTags = exports.addMethodTag = exports.getMethodLabels = exports.addMethodLabel = exports.getMethodMeta = exports.addMethodMeta = void 0;
 const basic_1 = require("../utils/basic");
-const methodMeta = (key, mapFn) => (target, propertyKey) => {
+const addMethodMeta = (key, mapFn) => (target, propertyKey) => {
     const metadata = Reflect.getMetadata(key, target.constructor, propertyKey);
     Reflect.defineMetadata(key, mapFn(metadata), target.constructor, propertyKey);
 };
-exports.methodMeta = methodMeta;
+exports.addMethodMeta = addMethodMeta;
 const getMethodMeta = (key, target, propertyKey) => Reflect.getMetadata(key, (0, basic_1.resolveConstructor)(target), propertyKey);
 exports.getMethodMeta = getMethodMeta;
-const methodLabel = (key, label) => (0, exports.methodMeta)('label', (prev = new Map()) => prev.set(key, label));
-exports.methodLabel = methodLabel;
+const addMethodLabel = (key, label) => (0, exports.addMethodMeta)('label', (prev = new Map()) => prev.set(key, label));
+exports.addMethodLabel = addMethodLabel;
 const getMethodLabels = (target, propertyKey) => (0, exports.getMethodMeta)('label', target, propertyKey) ?? new Map();
 exports.getMethodLabels = getMethodLabels;
-const methodTag = (tag) => (0, exports.methodMeta)('tag', (prev = new Set()) => prev.add(tag));
-exports.methodTag = methodTag;
+const addMethodTag = (tag) => (0, exports.addMethodMeta)('tag', (prev = new Set()) => prev.add(tag));
+exports.addMethodTag = addMethodTag;
 const getMethodTags = (target, propertyKey) => (0, exports.getMethodMeta)('tag', target, propertyKey) ?? new Set();
 exports.getMethodTags = getMethodTags;

package/cjm/metadata/parameter.js

@@ -1,32 +1,32 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getParamTags = exports.paramTag = exports.getParamLabels = exports.paramLabel = exports.getParamMeta = exports.paramMeta = void 0;
+exports.getParamTags = exports.addParamTag = exports.getParamLabels = exports.addParamLabel = exports.getParamMeta = exports.addParamMeta = void 0;
 const basic_1 = require("../utils/basic");
-const paramMeta = (key, mapFn) => (target, _, parameterIndex) => {
+const addParamMeta = (key, mapFn) => (target, _, parameterIndex) => {
     const metadata = Reflect.getOwnMetadata(key, target) ?? [];
     metadata[parameterIndex] = mapFn(metadata[parameterIndex]);
     Reflect.defineMetadata(key, metadata, target);
 };
-exports.paramMeta = paramMeta;
+exports.addParamMeta = addParamMeta;
 const getParamMeta = (key, target) => {
     return Reflect.getOwnMetadata(key, (0, basic_1.resolveConstructor)(target)) ?? [];
 };
 exports.getParamMeta = getParamMeta;
-const paramLabel = (key, label) => (0, exports.paramMeta)('label', (prev) => {
+const addParamLabel = (key, label) => (0, exports.addParamMeta)('label', (prev) => {
     const map = prev ?? new Map();
     return map.set(key, label);
 });
-exports.paramLabel = paramLabel;
+exports.addParamLabel = addParamLabel;
 const getParamLabels = (target, parameterIndex) => {
     const all = (0, exports.getParamMeta)('label', target);
     return all[parameterIndex] ?? new Map();
 };
 exports.getParamLabels = getParamLabels;
-const paramTag = (tag) => (0, exports.paramMeta)('tag', (prev) => {
+const addParamTag = (tag) => (0, exports.addParamMeta)('tag', (prev) => {
     const set = prev ?? new Set();
     return set.add(tag);
 });
-exports.paramTag = paramTag;
+exports.addParamTag = addParamTag;
 const getParamTags = (target, parameterIndex) => {
     const all = (0, exports.getParamMeta)('tag', target);
     return all[parameterIndex] ?? new Set();

package/cjm/registration/IRegistration.js

@@ -14,7 +14,7 @@ exports.registerPipe = registerPipe;
 const METADATA_KEY = 'registration';
 const getTransformers = (Target) => (0, class_1.getClassMeta)(Target, METADATA_KEY) ?? [];
 exports.getTransformers = getTransformers;
-const register = (...mappers) => (0, class_1.classMeta)(METADATA_KEY, (acc) => {
+const register = (...mappers) => (0, class_1.addClassMeta)(METADATA_KEY, (acc) => {
     const result = mappers.map((m) => (0, exports.isProviderPipe)(m) ? (r) => m.mapRegistration(r) : m);
     return acc ? [...result, ...acc] : result;
 });

package/esm/container/Container.js

@@ -3,6 +3,7 @@ import { ContainerDisposedError } from '../errors/ContainerDisposedError';
 import { MetadataInjector } from '../injector/MetadataInjector';
 import { AliasMap } from './AliasMap';
 import { DependencyNotFoundError } from '../errors/DependencyNotFoundError';
+import { ContainerNotFoundError } from '../errors/ContainerNotFoundError';
 import { Is } from '../utils/basic';
 import { Filter as F } from '../utils/array';
 export class Container {
@@ -128,6 +129,21 @@ export class Container {
     getScopes() {
         return [...this.scopes];
     }
+    hasInstance(instance) {
+        return this.instances.includes(instance);
+    }
+    getScopeByInstanceOrFail(instance) {
+        this.validateContainer();
+        const queue = [this];
+        while (queue.length > 0) {
+            const scope = queue.shift();
+            if (scope.hasInstance(instance)) {
+                return scope;
+            }
+            queue.push(...scope.getScopes());
+        }
+        throw new ContainerNotFoundError('Cannot find scope for the given instance');
+    }
     removeScope(child) {
         this.scopes = this.scopes.filter((s) => s !== child);
     }

package/esm/container/EmptyContainer.js

@@ -1,5 +1,6 @@
 import { MethodNotImplementedError } from '../errors/MethodNotImplementedError';
 import { DependencyNotFoundError } from '../errors/DependencyNotFoundError';
+import { ContainerNotFoundError } from '../errors/ContainerNotFoundError';
 export class EmptyContainer {
     get isDisposed() {
         throw new MethodNotImplementedError();
@@ -11,9 +12,15 @@ export class EmptyContainer {
     getScopes() {
         return [];
     }
+    getScopeByInstanceOrFail(instance) {
+        throw new ContainerNotFoundError('Cannot find scope for the given instance');
+    }
     getInstances() {
         return [];
     }
+    hasInstance(instance) {
+        return false;
+    }
     createScope() {
         throw new MethodNotImplementedError();
     }

package/esm/errors/ContainerNotFoundError.js

@@ -0,0 +1,8 @@
+import { ContainerError } from './ContainerError';
+export class ContainerNotFoundError extends ContainerError {
+    name = 'ContainerNotFoundError';
+    constructor(message) {
+        super(message);
+        Object.setPrototypeOf(this, ContainerNotFoundError.prototype);
+    }
+}

package/esm/index.js

@@ -13,6 +13,7 @@ export { register, bindTo, scope, scopeAccess, lazy, singleton, decorate, append
 export { Registration } from './registration/Registration';
 // Errors
 export { DependencyNotFoundError } from './errors/DependencyNotFoundError';
+export { ContainerNotFoundError } from './errors/ContainerNotFoundError';
 export { DependencyMissingKeyError } from './errors/DependencyMissingKeyError';
 export { MethodNotImplementedError } from './errors/MethodNotImplementedError';
 export { ContainerDisposedError } from './errors/ContainerDisposedError';
@@ -36,9 +37,9 @@ export { FunctionToken } from './token/FunctionToken';
 export { ConstantToken } from './token/ConstantToken';
 export { GroupInstanceToken } from './token/GroupInstanceToken';
 // Metadata
-export { classMeta, getClassMeta, classLabel, getClassLabels, classTag, getClassTags } from './metadata/class';
-export { paramMeta, getParamMeta, paramLabel, getParamLabels, paramTag, getParamTags } from './metadata/parameter';
-export { methodMeta, getMethodMeta, methodLabel, getMethodLabels, methodTag, getMethodTags } from './metadata/method';
+export { addClassMeta, getClassMeta, addClassLabel, getClassLabels, addClassTag, getClassTags } from './metadata/class';
+export { addParamMeta, getParamMeta, addParamLabel, getParamLabels, addParamTag, getParamTags, } from './metadata/parameter';
+export { addMethodMeta, getMethodMeta, addMethodLabel, getMethodLabels, addMethodTag, getMethodTags, } from './metadata/method';
 export { handleError, handleAsyncError } from './utils/errorHandler';
 export { throttle } from './utils/throttle';
 export { debounce } from './utils/debounce';

package/esm/injector/MetadataInjector.js

@@ -1,6 +1,6 @@
 import { Injector } from './IInjector';
 import { Is } from '../utils/basic';
-import { getParamMeta, paramMeta } from '../metadata/parameter';
+import { getParamMeta, addParamMeta } from '../metadata/parameter';
 import { argToToken, toToken } from '../token/toToken';
 export class MetadataInjector extends Injector {
     createInstance(scope, Target, { args: deps = [] } = {}) {
@@ -10,7 +10,7 @@ export class MetadataInjector extends Injector {
 }
 const hookMetaKey = (methodName = 'constructor') => `inject:${methodName}`;
 export const inject = (fn) => (target, propertyKey, parameterIndex) => {
-    paramMeta(hookMetaKey(propertyKey), () => toToken(fn))(Is.instance(target) ? target.constructor : target, propertyKey, parameterIndex);
+    addParamMeta(hookMetaKey(propertyKey), () => toToken(fn))(Is.instance(target) ? target.constructor : target, propertyKey, parameterIndex);
 };
 export const args = (index) => (c, { args = [] }) => {
     return args[index];

package/esm/metadata/class.js

@@ -1,12 +1,12 @@
 import { resolveConstructor } from '../utils/basic';
-export const classMeta = (key, mapFn) => (target) => {
+export const addClassMeta = (key, mapFn) => (target) => {
     const value = Reflect.getOwnMetadata(key, target);
     Reflect.defineMetadata(key, mapFn(value), target);
 };
 export function getClassMeta(target, key) {
     return Reflect.getOwnMetadata(key, resolveConstructor(target));
 }
-export const classLabel = (key, label) => classMeta('label', (prev = new Map()) => prev.set(key, label));
+export const addClassLabel = (key, label) => addClassMeta('label', (prev = new Map()) => prev.set(key, label));
 export const getClassLabels = (target) => getClassMeta(target, 'label') ?? new Map();
-export const classTag = (tag) => classMeta('tag', (prev = new Set()) => prev.add(tag));
+export const addClassTag = (tag) => addClassMeta('tag', (prev = new Set()) => prev.add(tag));
 export const getClassTags = (target) => getClassMeta(target, 'tag') ?? new Set();

package/esm/metadata/method.js

@@ -1,10 +1,10 @@
 import { resolveConstructor } from '../utils/basic';
-export const methodMeta = (key, mapFn) => (target, propertyKey) => {
+export const addMethodMeta = (key, mapFn) => (target, propertyKey) => {
     const metadata = Reflect.getMetadata(key, target.constructor, propertyKey);
     Reflect.defineMetadata(key, mapFn(metadata), target.constructor, propertyKey);
 };
 export const getMethodMeta = (key, target, propertyKey) => Reflect.getMetadata(key, resolveConstructor(target), propertyKey);
-export const methodLabel = (key, label) => methodMeta('label', (prev = new Map()) => prev.set(key, label));
+export const addMethodLabel = (key, label) => addMethodMeta('label', (prev = new Map()) => prev.set(key, label));
 export const getMethodLabels = (target, propertyKey) => getMethodMeta('label', target, propertyKey) ?? new Map();
-export const methodTag = (tag) => methodMeta('tag', (prev = new Set()) => prev.add(tag));
+export const addMethodTag = (tag) => addMethodMeta('tag', (prev = new Set()) => prev.add(tag));
 export const getMethodTags = (target, propertyKey) => getMethodMeta('tag', target, propertyKey) ?? new Set();

package/esm/metadata/parameter.js

@@ -1,5 +1,5 @@
 import { resolveConstructor } from '../utils/basic';
-export const paramMeta = (key, mapFn) => (target, _, parameterIndex) => {
+export const addParamMeta = (key, mapFn) => (target, _, parameterIndex) => {
     const metadata = Reflect.getOwnMetadata(key, target) ?? [];
     metadata[parameterIndex] = mapFn(metadata[parameterIndex]);
     Reflect.defineMetadata(key, metadata, target);
@@ -7,7 +7,7 @@ export const paramMeta = (key, mapFn) => (target, _, parameterIndex) => {
 export const getParamMeta = (key, target) => {
     return Reflect.getOwnMetadata(key, resolveConstructor(target)) ?? [];
 };
-export const paramLabel = (key, label) => paramMeta('label', (prev) => {
+export const addParamLabel = (key, label) => addParamMeta('label', (prev) => {
     const map = prev ?? new Map();
     return map.set(key, label);
 });
@@ -15,7 +15,7 @@ export const getParamLabels = (target, parameterIndex) => {
     const all = getParamMeta('label', target);
     return all[parameterIndex] ?? new Map();
 };
-export const paramTag = (tag) => paramMeta('tag', (prev) => {
+export const addParamTag = (tag) => addParamMeta('tag', (prev) => {
     const set = prev ?? new Set();
     return set.add(tag);
 });

package/esm/registration/IRegistration.js

@@ -1,6 +1,6 @@
 import { SingleToken } from '../token/SingleToken';
 import { isBindToken } from '../token/BindToken';
-import { classMeta, getClassMeta } from '../metadata/class';
+import { addClassMeta, getClassMeta } from '../metadata/class';
 export const isProviderPipe = (obj) => obj !== null && typeof obj === 'object' && 'mapProvider' in obj;
 export const registerPipe = (mapProvider) => ({
     mapProvider,
@@ -8,7 +8,7 @@ export const registerPipe = (mapProvider) => ({
 });
 const METADATA_KEY = 'registration';
 export const getTransformers = (Target) => getClassMeta(Target, METADATA_KEY) ?? [];
-export const register = (...mappers) => classMeta(METADATA_KEY, (acc) => {
+export const register = (...mappers) => addClassMeta(METADATA_KEY, (acc) => {
     const result = mappers.map((m) => isProviderPipe(m) ? (r) => m.mapRegistration(r) : m);
     return acc ? [...result, ...acc] : result;
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ts-ioc-container",
-  "version": "54.0.1",
+  "version": "55.0.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.",
   "workspaces": [
     "docs"

package/typings/container/Container.d.ts

@@ -35,6 +35,8 @@ export declare class Container implements IContainer {
     addOnDisposeHook(...hooks: OnDisposeHook[]): this;
     addInstance(instance: Instance): void;
     getScopes(): IContainer[];
+    hasInstance(instance: object): boolean;
+    getScopeByInstanceOrFail(instance: object): IContainer;
     removeScope(child: IContainer): void;
     useModule(module: IContainerModule): this;
     getParent(): IContainer;

package/typings/container/EmptyContainer.d.ts

@@ -9,7 +9,9 @@ export declare class EmptyContainer implements IContainer {
     addInstance(instance: Instance): void;
     getParent(): undefined;
     getScopes(): never[];
+    getScopeByInstanceOrFail(instance: object): IContainer;
     getInstances(): never[];
+    hasInstance(instance: object): boolean;
     createScope(): IContainer;
     dispose(): void;
     register(key: DependencyKey, value: IProvider): this;

package/typings/container/IContainer.d.ts

@@ -44,10 +44,12 @@ export interface IContainer extends Tagged {
     resolveOneByAlias<T>(alias: DependencyKey, options?: ResolveOneOptions): T;
     createScope(options?: CreateScopeOptions): IContainer;
     getScopes(): IContainer[];
+    getScopeByInstanceOrFail(instance: object): IContainer;
     removeScope(child: IContainer): void;
     useModule(module: IContainerModule): this;
     getParent(): IContainer | undefined;
     getInstances(cascade?: boolean): Instance[];
+    hasInstance(instance: object): boolean;
     dispose(): void;
     addInstance(instance: Instance): void;
 }

package/typings/errors/ContainerNotFoundError.d.ts

@@ -0,0 +1,5 @@
+import { ContainerError } from './ContainerError';
+export declare class ContainerNotFoundError extends ContainerError {
+    name: string;
+    constructor(message: string);
+}

package/typings/index.d.ts

@@ -10,6 +10,7 @@ export { Provider } from './provider/Provider';
 export { type IRegistration, type ReturnTypeOfRegistration, type ScopeMatchRule, type ProviderPipe, register, bindTo, scope, scopeAccess, lazy, singleton, decorate, appendArgs, appendArgsFn, } from './registration/IRegistration';
 export { Registration } from './registration/Registration';
 export { DependencyNotFoundError } from './errors/DependencyNotFoundError';
+export { ContainerNotFoundError } from './errors/ContainerNotFoundError';
 export { DependencyMissingKeyError } from './errors/DependencyMissingKeyError';
 export { MethodNotImplementedError } from './errors/MethodNotImplementedError';
 export { ContainerDisposedError } from './errors/ContainerDisposedError';
@@ -30,9 +31,9 @@ export { SingleToken } from './token/SingleToken';
 export { FunctionToken } from './token/FunctionToken';
 export { ConstantToken } from './token/ConstantToken';
 export { type InstancePredicate, GroupInstanceToken } from './token/GroupInstanceToken';
-export { classMeta, getClassMeta, classLabel, getClassLabels, classTag, getClassTags } from './metadata/class';
-export { paramMeta, getParamMeta, paramLabel, getParamLabels, paramTag, getParamTags } from './metadata/parameter';
-export { methodMeta, getMethodMeta, methodLabel, getMethodLabels, methodTag, getMethodTags } from './metadata/method';
+export { addClassMeta, getClassMeta, addClassLabel, getClassLabels, addClassTag, getClassTags } from './metadata/class';
+export { addParamMeta, getParamMeta, addParamLabel, getParamLabels, addParamTag, getParamTags, } from './metadata/parameter';
+export { addMethodMeta, getMethodMeta, addMethodLabel, getMethodLabels, addMethodTag, getMethodTags, } from './metadata/method';
 export { handleError, handleAsyncError, type HandleErrorParams } from './utils/errorHandler';
 export { throttle } from './utils/throttle';
 export { debounce } from './utils/debounce';

package/typings/metadata/class.d.ts

@@ -1,6 +1,6 @@
-export declare const classMeta: <T>(key: string | symbol, mapFn: (prev: T | undefined) => T) => ClassDecorator;
+export declare const addClassMeta: <T>(key: string | symbol, mapFn: (prev: T | undefined) => T) => ClassDecorator;
 export declare function getClassMeta<T>(target: object, key: string | symbol): T | undefined;
-export declare const classLabel: (key: string, label: string) => ClassDecorator;
+export declare const addClassLabel: (key: string, label: string) => ClassDecorator;
 export declare const getClassLabels: (target: object) => Map<string, string>;
-export declare const classTag: (tag: string) => ClassDecorator;
+export declare const addClassTag: (tag: string) => ClassDecorator;
 export declare const getClassTags: (target: object) => Set<string>;

package/typings/metadata/method.d.ts

@@ -1,6 +1,6 @@
-export declare const methodMeta: <T>(key: string, mapFn: (prev: T | undefined) => T) => MethodDecorator;
+export declare const addMethodMeta: <T>(key: string, mapFn: (prev: T | undefined) => T) => MethodDecorator;
 export declare const getMethodMeta: (key: string, target: object, propertyKey: string) => unknown;
-export declare const methodLabel: (key: string, label: string) => MethodDecorator;
+export declare const addMethodLabel: (key: string, label: string) => MethodDecorator;
 export declare const getMethodLabels: (target: object, propertyKey: string) => Map<string, string>;
-export declare const methodTag: (tag: string) => MethodDecorator;
+export declare const addMethodTag: (tag: string) => MethodDecorator;
 export declare const getMethodTags: (target: object, propertyKey: string) => Set<string>;

package/typings/metadata/parameter.d.ts

@@ -1,6 +1,6 @@
-export declare const paramMeta: (key: string | symbol, mapFn: (prev: unknown) => unknown) => ParameterDecorator;
+export declare const addParamMeta: (key: string | symbol, mapFn: (prev: unknown) => unknown) => ParameterDecorator;
 export declare const getParamMeta: (key: string | symbol, target: object) => unknown[];
-export declare const paramLabel: (key: string, label: string) => ParameterDecorator;
+export declare const addParamLabel: (key: string, label: string) => ParameterDecorator;
 export declare const getParamLabels: (target: object, parameterIndex: number) => Map<string, string>;
-export declare const paramTag: (tag: string) => ParameterDecorator;
+export declare const addParamTag: (tag: string) => ParameterDecorator;
 export declare const getParamTags: (target: object, parameterIndex: number) => Set<string>;