ts-ioc-container 57.3.0 → 58.0.0

package/cjm/container/Container.js

@@ -12,7 +12,7 @@ class Container {
     isDisposed = false;
     parent;
     scopes = [];
-    instances = [];
+    instances = new Set();
     registrations = [];
     tags;
     providers = new Map();
@@ -108,7 +108,7 @@ class Container {
         }
         this.providers.clear();
         this.aliases.destroy();
-        this.instances = [];
+        this.instances.clear();
         this.registrations = [];
         this.onConstructHookList.length = 0;
         this.onScopeCreatedHookList.length = 0;
@@ -137,7 +137,7 @@ class Container {
         return this;
     }
     addInstance(instance) {
-        this.instances.push(instance);
+        this.instances.add(instance);
         for (const onConstruct of this.onConstructHookList) {
             onConstruct(instance, this);
         }
@@ -146,7 +146,7 @@ class Container {
         return [...this.scopes];
     }
     hasInstance(instance) {
-        return this.instances.includes(instance);
+        return this.instances.has(instance);
     }
     getScopeByInstanceOrFail(instance) {
         this.validateContainer();

package/cjm/hooks/hook.js

@@ -4,7 +4,6 @@ exports.hook = exports.toHookFn = exports.prepend = exports.append = exports.pre
 exports.getHooks = getHooks;
 exports.hasHooks = hasHooks;
 const basic_1 = require("../utils/basic");
-const proxy_1 = require("../utils/proxy");
 const appendHooks = (...fns) => (...prev) => [...prev, ...fns];
 exports.appendHooks = appendHooks;
 const prependHooks = (...fns) => (...prev) => [...fns, ...prev];
@@ -16,9 +15,6 @@ const isHookClassConstructor = (execute) => {
 };
 const toHookFn = (execute) => isHookClassConstructor(execute) ? (context) => context.scope.resolve(execute).execute(context) : execute;
 exports.toHookFn = toHookFn;
-const getReflectionTarget = (target) => {
-    return (0, proxy_1.isProxy)(target) ? (0, proxy_1.getProxyTarget)(target) : target;
-};
 const getConstructorChain = (ctor) => {
     const chain = [];
     let current = ctor;
@@ -29,9 +25,8 @@ const getConstructorChain = (ctor) => {
     return chain;
 };
 function getHooks(target, key) {
-    const reflectionTarget = getReflectionTarget(target);
     const merged = new Map();
-    for (const ctor of getConstructorChain(reflectionTarget.constructor).reverse()) {
+    for (const ctor of getConstructorChain(target.constructor).reverse()) {
         const ownHooks = Reflect.getOwnMetadata(key, ctor);
         if (ownHooks) {
             for (const [methodName, fns] of ownHooks) {
@@ -42,8 +37,7 @@ function getHooks(target, key) {
     return merged;
 }
 function hasHooks(target, key) {
-    const reflectionTarget = getReflectionTarget(target);
-    return getConstructorChain(reflectionTarget.constructor).some((ctor) => Reflect.hasOwnMetadata(key, ctor));
+    return getConstructorChain(target.constructor).some((ctor) => Reflect.hasOwnMetadata(key, ctor));
 }
 const hook = (key, mapFn) => (target, propertyKey) => {
     const hooks = Reflect.hasOwnMetadata(key, target.constructor)

package/cjm/index.js

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createHookContext = exports.createHookContextFactory = exports.HookContext = exports.prepend = exports.append = exports.prependHooks = exports.appendHooks = exports.hasHooks = exports.hook = exports.getHooks = exports.UnsupportedTokenTypeError = exports.CannonSingletonApplyTwiceError = exports.UnexpectedHookResultError = exports.ProviderDisposedError = exports.ContainerDisposedError = exports.MethodNotImplementedError = exports.DependencyMissingKeyError = exports.ContainerNotFoundError = exports.DependencyNotFoundError = exports.ContainerError = exports.Registration = 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.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 = exports.ClassToken = exports.toSingleAlias = exports.SingleAliasToken = exports.toGroupAlias = exports.GroupAliasToken = exports.argToToken = exports.toMappedToken = exports.toToken = exports.InjectionToken = exports.HooksRunner = exports.AddOnDisposeHookModule = exports.onContainerDisposed = exports.onContainerDisposedHooksRunner = exports.AddOnConstructAsyncHookModule = exports.onConstructAsync = exports.onConstructAsyncHooksRunner = exports.AddOnConstructHookModule = exports.onConstruct = exports.onConstructHooksRunner = exports.injectProp = void 0;
-exports.resolveConstructor = exports.Is = void 0;
+exports.resolveConstructor = exports.Is = exports.unwrapProxyTarget = exports.createProxy = 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");
@@ -150,6 +150,9 @@ var select_1 = require("./select");
 Object.defineProperty(exports, "select", { enumerable: true, get: function () { return select_1.select; } });
 var fp_1 = require("./utils/fp");
 Object.defineProperty(exports, "pipe", { enumerable: true, get: function () { return fp_1.pipe; } });
+var proxy_1 = require("./utils/proxy");
+Object.defineProperty(exports, "createProxy", { enumerable: true, get: function () { return proxy_1.createProxy; } });
+Object.defineProperty(exports, "unwrapProxyTarget", { enumerable: true, get: function () { return proxy_1.unwrapProxyTarget; } });
 var basic_1 = require("./utils/basic");
 Object.defineProperty(exports, "Is", { enumerable: true, get: function () { return basic_1.Is; } });
 Object.defineProperty(exports, "resolveConstructor", { enumerable: true, get: function () { return basic_1.resolveConstructor; } });

package/cjm/utils/proxy.js

@@ -1,24 +1,33 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.unwrapProxyTarget = void 0;
 exports.isProxy = isProxy;
 exports.getProxyTarget = getProxyTarget;
+exports.createProxy = createProxy;
 exports.lazyProxy = lazyProxy;
 exports.toLazyIf = toLazyIf;
 const proxyStateMap = new WeakMap();
 const unwrapProxyTarget = (value) => {
     return isProxy(value) ? getProxyTarget(value) : value;
 };
+exports.unwrapProxyTarget = unwrapProxyTarget;
 function isProxy(value) {
     return proxyStateMap.has(value);
 }
 function getProxyTarget(value) {
-    return proxyStateMap.get(value).getTarget();
+    const target = proxyStateMap.get(value).getTarget();
+    return (0, exports.unwrapProxyTarget)(target);
+}
+function createProxy(target, handler = {}) {
+    const proxy = new Proxy(target, handler);
+    proxyStateMap.set(proxy, { getTarget: () => target });
+    return proxy;
 }
 function lazyProxy(resolveInstance) {
     let instance;
     const state = {
         getTarget: () => {
-            instance = instance ?? unwrapProxyTarget(resolveInstance());
+            instance = instance ?? (0, exports.unwrapProxyTarget)(resolveInstance());
             return instance;
         },
     };

package/esm/container/Container.js

@@ -9,7 +9,7 @@ export class Container {
     isDisposed = false;
     parent;
     scopes = [];
-    instances = [];
+    instances = new Set();
     registrations = [];
     tags;
     providers = new Map();
@@ -105,7 +105,7 @@ export class Container {
         }
         this.providers.clear();
         this.aliases.destroy();
-        this.instances = [];
+        this.instances.clear();
         this.registrations = [];
         this.onConstructHookList.length = 0;
         this.onScopeCreatedHookList.length = 0;
@@ -134,7 +134,7 @@ export class Container {
         return this;
     }
     addInstance(instance) {
-        this.instances.push(instance);
+        this.instances.add(instance);
         for (const onConstruct of this.onConstructHookList) {
             onConstruct(instance, this);
         }
@@ -143,7 +143,7 @@ export class Container {
         return [...this.scopes];
     }
     hasInstance(instance) {
-        return this.instances.includes(instance);
+        return this.instances.has(instance);
     }
     getScopeByInstanceOrFail(instance) {
         this.validateContainer();

package/esm/hooks/hook.js

@@ -1,5 +1,4 @@
 import { Is } from '../utils/basic.js';
-import { getProxyTarget, isProxy } from '../utils/proxy.js';
 export const appendHooks = (...fns) => (...prev) => [...prev, ...fns];
 export const prependHooks = (...fns) => (...prev) => [...fns, ...prev];
 export const append = appendHooks;
@@ -8,9 +7,6 @@ const isHookClassConstructor = (execute) => {
     return Is.constructor(execute) && execute.prototype.execute;
 };
 export const toHookFn = (execute) => isHookClassConstructor(execute) ? (context) => context.scope.resolve(execute).execute(context) : execute;
-const getReflectionTarget = (target) => {
-    return isProxy(target) ? getProxyTarget(target) : target;
-};
 const getConstructorChain = (ctor) => {
     const chain = [];
     let current = ctor;
@@ -21,9 +17,8 @@ const getConstructorChain = (ctor) => {
     return chain;
 };
 export function getHooks(target, key) {
-    const reflectionTarget = getReflectionTarget(target);
     const merged = new Map();
-    for (const ctor of getConstructorChain(reflectionTarget.constructor).reverse()) {
+    for (const ctor of getConstructorChain(target.constructor).reverse()) {
         const ownHooks = Reflect.getOwnMetadata(key, ctor);
         if (ownHooks) {
             for (const [methodName, fns] of ownHooks) {
@@ -34,8 +29,7 @@ export function getHooks(target, key) {
     return merged;
 }
 export function hasHooks(target, key) {
-    const reflectionTarget = getReflectionTarget(target);
-    return getConstructorChain(reflectionTarget.constructor).some((ctor) => Reflect.hasOwnMetadata(key, ctor));
+    return getConstructorChain(target.constructor).some((ctor) => Reflect.hasOwnMetadata(key, ctor));
 }
 export const hook = (key, mapFn) => (target, propertyKey) => {
     const hooks = Reflect.hasOwnMetadata(key, target.constructor)

package/esm/index.js

@@ -45,4 +45,5 @@ export { shallowCache } from './utils/shallowCache.js';
 export { once } from './utils/once.js';
 export { select } from './select.js';
 export { pipe } from './utils/fp.js';
+export { createProxy, unwrapProxyTarget } from './utils/proxy.js';
 export { Is, resolveConstructor } from './utils/basic.js';

package/esm/utils/proxy.js

@@ -1,12 +1,18 @@
 const proxyStateMap = new WeakMap();
-const unwrapProxyTarget = (value) => {
+export const unwrapProxyTarget = (value) => {
     return isProxy(value) ? getProxyTarget(value) : value;
 };
 export function isProxy(value) {
     return proxyStateMap.has(value);
 }
 export function getProxyTarget(value) {
-    return proxyStateMap.get(value).getTarget();
+    const target = proxyStateMap.get(value).getTarget();
+    return unwrapProxyTarget(target);
+}
+export function createProxy(target, handler = {}) {
+    const proxy = new Proxy(target, handler);
+    proxyStateMap.set(proxy, { getTarget: () => target });
+    return proxy;
 }
 export function lazyProxy(resolveInstance) {
     let instance;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ts-ioc-container",
-  "version": "57.3.0",
+  "version": "58.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.",
   "publishConfig": {
     "access": "public",

package/typings/container/Container.d.ts

@@ -9,7 +9,7 @@ export declare class Container implements IContainer {
     isDisposed: boolean;
     private parent;
     private scopes;
-    private instances;
+    private readonly instances;
     private registrations;
     private readonly tags;
     private readonly providers;
@@ -38,12 +38,12 @@ export declare class Container implements IContainer {
     addOnScopeCreatedHook(...hooks: OnScopeCreatedHook[]): this;
     addInstance(instance: Instance): void;
     getScopes(): IContainer[];
-    hasInstance(instance: object): boolean;
-    getScopeByInstanceOrFail(instance: object): IContainer;
+    hasInstance(instance: Instance): boolean;
+    getScopeByInstanceOrFail(instance: Instance): IContainer;
     removeScope(child: IContainer): void;
     useModule(module: IContainerModule): this;
     getParent(): IContainer;
-    getInstances(cascade?: boolean): Instance<unknown>[];
+    getInstances(cascade?: boolean): Instance[];
     hasTag(tag: Tag): boolean;
     addTags(...tags: Tag[]): void;
     private validateContainer;

package/typings/container/EmptyContainer.d.ts

@@ -9,9 +9,9 @@ export declare class EmptyContainer implements IContainer {
     addInstance(instance: Instance): void;
     getParent(): undefined;
     getScopes(): never[];
-    getScopeByInstanceOrFail(instance: object): IContainer;
+    getScopeByInstanceOrFail(instance: Instance): IContainer;
     getInstances(): never[];
-    hasInstance(instance: object): boolean;
+    hasInstance(instance: Instance): boolean;
     createScope(): IContainer;
     autoResolve(options?: AutoResolveOptions): this;
     dispose(): void;

package/typings/container/IContainer.d.ts

@@ -49,12 +49,12 @@ export interface IContainer extends Tagged {
     createScope(options?: CreateScopeOptions): IContainer;
     autoResolve(options?: AutoResolveOptions): this;
     getScopes(): IContainer[];
-    getScopeByInstanceOrFail(instance: object): IContainer;
+    getScopeByInstanceOrFail(instance: Instance): IContainer;
     removeScope(child: IContainer): void;
     useModule(module: IContainerModule): this;
     getParent(): IContainer | undefined;
     getInstances(cascade?: boolean): Instance[];
-    hasInstance(instance: object): boolean;
+    hasInstance(instance: Instance): boolean;
     dispose(): void;
     addInstance(instance: Instance): void;
 }

package/typings/hooks/HookContext.d.ts

@@ -1,7 +1,8 @@
 import type { IContainer } from '../container/IContainer.js';
 import { InjectionToken } from '../token/InjectionToken.js';
+import { type Instance } from '../utils/basic.js';
 export interface IHookContext {
-    instance: object;
+    instance: Instance;
     scope: IContainer;
     methodName?: string;
     resolveArgs(...args: unknown[]): unknown[];
@@ -16,9 +17,9 @@ export interface IHookContext {
 export declare class HookContext implements IHookContext {
     scope: IContainer;
     methodName?: string | undefined;
-    readonly instance: object;
+    readonly instance: Instance;
     private initialArgs;
-    constructor(instance: object, scope: IContainer, methodName?: string | undefined);
+    constructor(instance: Instance, scope: IContainer, methodName?: string | undefined);
     resolveArgs(...args: unknown[]): unknown[];
     invokeMethod({ args }?: {
         args?: unknown[];
@@ -28,7 +29,7 @@ export declare class HookContext implements IHookContext {
     setInitialArgs(...args: unknown[]): this;
     getInitialArgs(): unknown[];
 }
-export type CreateHookContext = (Target: object, scope: IContainer, methodName?: string) => IHookContext;
+export type CreateHookContext = (Target: Instance, scope: IContainer, methodName?: string) => IHookContext;
 export declare const createHookContext: CreateHookContext;
 export declare const createHookContextFactory: ({ args }?: {
     args?: unknown[];

package/typings/hooks/HooksRunner.d.ts

@@ -1,5 +1,6 @@
 import { type CreateHookContext, type IHookContext } from './HookContext.js';
 import type { IContainer } from '../container/IContainer.js';
+import { type Instance } from '../utils/basic.js';
 export type MapHookContext = (context: IHookContext) => IHookContext;
 export type HooksRunnerContext = {
     scope: IContainer;
@@ -10,7 +11,7 @@ export type HooksRunnerContext = {
 export declare class HooksRunner {
     private readonly key;
     constructor(key: string | symbol);
-    hasHooks(target: object): boolean;
-    execute(target: object, { scope, createContext, mapContext, predicate, }: HooksRunnerContext): void;
-    executeAsync(target: object, { scope, createContext, mapContext, predicate, }: HooksRunnerContext): Promise<void[]>;
+    hasHooks(target: Instance): boolean;
+    execute(target: Instance, { scope, createContext, mapContext, predicate, }: HooksRunnerContext): void;
+    executeAsync(target: Instance, { scope, createContext, mapContext, predicate, }: HooksRunnerContext): Promise<void[]>;
 }

package/typings/hooks/hook.d.ts

@@ -1,6 +1,6 @@
 import { type IHookContext } from './HookContext.js';
 import type { IContainer } from '../container/IContainer.js';
-import { type constructor } from '../utils/basic.js';
+import { type constructor, type Instance } from '../utils/basic.js';
 import { ProviderOptions } from '../provider/IProvider.js';
 export type InjectFn<T = unknown> = (s: IContainer, options: ProviderOptions) => T;
 export type HookFn<T extends IHookContext = IHookContext> = (context: T) => void | Promise<void>;
@@ -15,6 +15,6 @@ export declare const prependHooks: (...fns: HookType[]) => MapHooksFn;
 export declare const append: (...fns: HookType[]) => MapHooksFn;
 export declare const prepend: (...fns: HookType[]) => MapHooksFn;
 export declare const toHookFn: <C extends IHookContext>(execute: HookFn<C> | constructor<HookClass<C>>) => HookFn<C>;
-export declare function getHooks(target: object, key: string | symbol): HooksOfClass;
-export declare function hasHooks(target: object, key: string | symbol): boolean;
+export declare function getHooks(target: Instance, key: string | symbol): HooksOfClass;
+export declare function hasHooks(target: Instance, key: string | symbol): boolean;
 export declare const hook: (key: string | symbol, mapFn: MapHooksFn) => (target: object, propertyKey: string | symbol) => void;

package/typings/index.d.ts

@@ -47,4 +47,5 @@ export { once } from './utils/once.js';
 export { type ExecutionContext } from './ExecutionContext.js';
 export { select } from './select.js';
 export { pipe, type MapFn } from './utils/fp.js';
-export { type constructor, type Instance, Is, resolveConstructor } from './utils/basic.js';
+export { createProxy, unwrapProxyTarget } from './utils/proxy.js';
+export { type Branded, type constructor, type Instance, Is, resolveConstructor } from './utils/basic.js';

package/typings/utils/basic.d.ts

@@ -1,7 +1,8 @@
 export type constructor<T> = new (...args: any[]) => T;
-export interface Instance<T = unknown> {
-    new (...args: unknown[]): T;
-}
+export type Branded<TBrand extends string, T> = T & {
+    readonly __brand?: TBrand;
+};
+export type Instance = Branded<'Instance', object>;
 export declare const Is: {
     nullish: <T>(value: T | undefined | null) => value is null | undefined;
     object: (target: unknown) => target is object;

package/typings/utils/proxy.d.ts

@@ -1,4 +1,6 @@
+export declare const unwrapProxyTarget: <T extends object>(value: T) => T;
 export declare function isProxy(value: object): boolean;
 export declare function getProxyTarget<T extends object>(value: T): T;
+export declare function createProxy<T extends object>(target: T, handler?: ProxyHandler<T>): T;
 export declare function lazyProxy<T extends object>(resolveInstance: () => T): T;
 export declare function toLazyIf<T extends object>(resolveInstance: () => T, isLazy?: boolean): T;