@kaokei/di 2.0.8 → 3.0.0

package/README.md

@@ -1,4 +1,4 @@
-<h1 align="center">di</h1>
+<h1 align="center">npm install @kaokei/di</h1>
 <div align="center">
 
 [![Build Status](https://github.com/kaokei/di/actions/workflows/build.yml/badge.svg)](https://github.com/kaokei/di/actions/workflows/build.yml)
@@ -6,74 +6,45 @@
 [![Downloads](https://img.shields.io/npm/dm/@kaokei/di.svg?sanitize=true)](https://npmcharts.com/compare/@kaokei/di?minimal=true)
 [![Version](https://img.shields.io/npm/v/@kaokei/di.svg?sanitize=true)](https://www.npmjs.com/package/@kaokei/di)
 [![License](https://img.shields.io/npm/l/@kaokei/di.svg?sanitize=true)](https://www.npmjs.com/package/@kaokei/di)
+![GitHub Created At](https://img.shields.io/github/created-at/kaokei/di?style=social)
 
 </div>
 
-- [documentation](https://kaokei.com/project/di/)
-- [online playground](https://codesandbox.io/s/di-playground-zjnyv)
-- [online demo](https://kaokei.com/project/di/)
-
-```bash
-npm install @kaokei/di reflect-metadata
-```
-
-## 灵感
-
-Inspired by [Spring](https://spring.io/), [Angular](https://angular.io/), [typedi](https://github.com/typestack/typedi), [InversifyJS](https://github.com/inversify/InversifyJS)
-
-其他类似的 library 可以[参考这里](https://github.com/topics/ioc?l=typescript)和[参考这里](https://github.com/topics/dependency-injection?l=typescript)
+## 简介
 
-最初接触依赖注入是从 Spring 中开始的，依稀记得我的第一份工作是 java 开发，在第一次开发业务需求的时候，还只知道`new`一个类来获取对象。然后我就在代码中 new 了很多实例对象。不出意外的出现问题了，组长就开始帮我调试代码，最终组长告诉我不要自己手动`new`实例对象，只需要在`XML`文件中配置对应的 bean 对象即可。这给当时的我留下了深刻的印象。现在回想起来，如果我是当时的组长，我肯定会非常生气，连这么基础的东西都不知道。
+本库是一个轻量级的依赖注入库，类似的其他比较流行的库有`InversifyJS`和`typedi`。
 
-后来又接触到 Angular，第一次了解到依赖注入在前端的应用。最关键的是我之前有使用过 vue 和 react，先入为主的认为 Angular 中一定也有一个全局的 store，但是却怎么也找不到这个 store 对象，反而都是碎片化的 service。后来才反应过来，多 service 其实可以理解为多 store，如果整个项目只有一个 service，那么不就退化成和 vue 以及 react 一样了吗？只不过 service 在 Angular 中非常方便使用而且易于控制作用范围，相对的 vue 中的 store 的 module 本质还是全局范围可见的不同命名空间而已。
+本库主要特点是参考借鉴了`InversifyJS`的优秀 API 设计，不依赖`reflect-metadata`，支持循环依赖。
 
-所以我的想法就是要把 angular 的 service 特性迁移到 vue 和 react 中。本库作为一个基础库，被[user-vue-service](https://github.com/kaokei/use-vue-service)等库依赖。
-
-## 解决了什么问题？
-
-基于 typescript 实现依赖注入能力。类似的目前比较流行的 library 是`InversifyJS`和`typedi`。
-
-## 已经支持的特性
-
-- 支持类，Symbol，字符串等作为服务的 token
-- 支持类，值，工厂函数等作为服务
-- 支持@Inject、@Skip、@Self、@Optional 以及 forwardRef 控制获取服务
-- 支持@Optional 配置可选注入以及类属性的初始值作为默认值
-- Injector 作为 DI 容器，易于测试
-- 同一个服务在同一个 Injector 中一定是单例的。相对的[Inversify 支持 3 种 Scope](https://github.com/inversify/InversifyJS/blob/master/wiki/scope.md)。
-- 支持分层 DI 系统
-- 支持属性注入和构造函数注入
-- 支持部分循环依赖，对于不支持的循环依赖会有相应的提示
-- 支持类型提示，以及 InjectionKey 的类型提示
-- 支持 dispose 生命周期钩子
+- [入门指南](./docs/guide/README.md)
+- [API 文档](./docs/api/README.md)
+- [博客文章](./docs/note/01.什么是Token.md)
+- [online playground](https://codesandbox.io/s/di-playground-zjnyv)
+- [online demo](https://codesandbox.io/s/di-playground-zjnyv)
 
-## 不支持的特性
+## todo
 
-- 不支持 multi-injection，有需要可以[参考这里](https://github.com/inversify/InversifyJS/blob/master/wiki/multi_injection.md)
-- 不支持不能自己 new 的注入，比如 react 类组件的实例化过程我们干预不了，所以不能在 react 类组件上使用依赖注入。有需要可以[参考这里](https://itnext.io/dependency-injection-in-react-using-inversifyjs-a38ff0c6601)
-- 对于类的继承没有过多的支持，[参考这里](https://docs.typestack.community/typedi/v/develop/02-basic-usage-guide/07-inheritance)以及[参考这里](https://github.com/inversify/InversifyJS/blob/master/wiki/inheritance.md)
-- 暂时不实现 providers 中使用 forwardRef，主要是不了解使用场景，目前只支持在@Inject 中使用 forwardRef
-- 不支持异步实例化，即该实例对象的状态和数据依赖服务器端数据，需要异步获取，等待获取数据成功之后才实例化对象。对于这种场景建议在实例对象中维护类似 loading/ready/inited 这种字段来表明数据是否准备完毕。
-- 不支持 LazyInject
-- 不支持 onInit/PostConstruct 生命周期钩子，虽然 Spring 中是支持的，但是实际场景中并不常用，[参考这里](https://github.com/angular/angular/issues/23235)以及[参考这里](https://github.com/inversify/InversifyJS/blob/master/wiki/post_construct.md)
-- 不支持中间件，有需要可以[参考这里](https://github.com/inversify/InversifyJS/blob/master/wiki/middleware.md)
-- 原来确实导出了 autobind，后续删除了该导出，有业务需要可以自己 `npm install autobind-decorator` 即可。
-- 没有实现自定义装饰器，比如@Prev、@Post、@Aop 等装饰器，类似 autobind，应该独立维护。
+1. 实现 LazyInject 功能
+   关键是怎么实现 container 和 class 的绑定
+   正常 inject 时，是可以通过 container.get 获取上下文的，但是 lazyInject 拿不到这个上下文
 
-## 已知问题
+   LazyInject是否需要@Self/@Optional/@SkipSelf来配合？
+   需要协调@LazyInject/@Inject，因为现在是两条并行的路线，也就是@Self/@Optional/@SkipSelf默认是和@Inject配合的，现在如果和@LazyInject就会报找不到@Inject的异常
+   可以作为低优先级的需求，后续有需要再考虑。
 
-循环依赖导致的问题运行时报错。
+1. 直接使用javascript，不依赖typescript
 
-- [Design:type metadata for cyclic dependencies throw at runtime #27519](https://github.com/microsoft/TypeScript/issues/27519)
-- [Support for classes](https://github.com/inversify/InversifyJS/blob/master/wiki/classes_as_id.md#known-limitation-classes-as-identifiers-and-circular-dependencies)
+1. getter支持缓存，使用computed支持缓存
 
-经过一番探究，有不同的场景会导致这个问题。
+应该在use-vue-service中实现
 
-问题一：A 类和 B 类循环依赖。
+https://yuanbao.tencent.com/bot/app/share/chat/tUbGmhHdY1Ta
 
-解决方案：使用 forwardRef 解藕 A 和 B 的实例化过程。类似 InversifyJS 中的 lazyInject。
+2. 优化 https://github.com/kaokei/utils/blob/main/src/index.ts 的文档
 
-问题二：已经使用 forawrdRef 解藕了 A 和 B。仍然有运行时错误。
 
-解决方案：这是因为 tsconfig.json 中的 target 不是 es5。通过测试发现只有设置为 es5 才能避免这个问题。
-可以[参考这个项目](https://github.com/kaokei/test-webpack-typescript)
+```ts
+function useAppService<T>(token: interfaces.ServiceIdentifier<T>, app: any) {
+  return app.runWithContext(() => useService(token));
+}
+```

package/dist/binding.d.cts

@@ -0,0 +1,36 @@
+import { Container } from './container';
+import { Newable, Context, Options, CommonToken, DynamicValue, ActivationHandler, DeactivationHandler } from './interfaces';
+export declare class Binding<T = unknown> {
+    container: Container;
+    context: Context;
+    token: CommonToken<T>;
+    type: string;
+    status: string;
+    classValue: Newable<T>;
+    constantValue: T;
+    dynamicValue: DynamicValue<T>;
+    cache: T;
+    postConstructResult?: Promise<void> | Symbol;
+    onActivationHandler?: ActivationHandler<T>;
+    onDeactivationHandler?: DeactivationHandler<T>;
+    constructor(token: CommonToken<T>, container: Container);
+    onActivation(handler: ActivationHandler<T>): void;
+    onDeactivation(handler: DeactivationHandler<T>): void;
+    activate(input: T): T;
+    deactivate(): void;
+    to(constructor: Newable<T>): this;
+    toSelf(): this;
+    toConstantValue(value: T): this;
+    toDynamicValue(func: DynamicValue<T>): this;
+    toService(token: CommonToken<T>): this;
+    get(options: Options<T>): T;
+    private getAwaitBindings;
+    private postConstruct;
+    preDestroy(): any;
+    private execute;
+    private resolveInstanceValue;
+    private resolveConstantValue;
+    private resolveDynamicValue;
+    private getConstructorParameters;
+    private getInjectProperties;
+}

package/dist/binding.d.ts

@@ -0,0 +1,36 @@
+import { Container } from './container';
+import { Newable, Context, Options, CommonToken, DynamicValue, ActivationHandler, DeactivationHandler } from './interfaces';
+export declare class Binding<T = unknown> {
+    container: Container;
+    context: Context;
+    token: CommonToken<T>;
+    type: string;
+    status: string;
+    classValue: Newable<T>;
+    constantValue: T;
+    dynamicValue: DynamicValue<T>;
+    cache: T;
+    postConstructResult?: Promise<void> | Symbol;
+    onActivationHandler?: ActivationHandler<T>;
+    onDeactivationHandler?: DeactivationHandler<T>;
+    constructor(token: CommonToken<T>, container: Container);
+    onActivation(handler: ActivationHandler<T>): void;
+    onDeactivation(handler: DeactivationHandler<T>): void;
+    activate(input: T): T;
+    deactivate(): void;
+    to(constructor: Newable<T>): this;
+    toSelf(): this;
+    toConstantValue(value: T): this;
+    toDynamicValue(func: DynamicValue<T>): this;
+    toService(token: CommonToken<T>): this;
+    get(options: Options<T>): T;
+    private getAwaitBindings;
+    private postConstruct;
+    preDestroy(): any;
+    private execute;
+    private resolveInstanceValue;
+    private resolveConstantValue;
+    private resolveDynamicValue;
+    private getConstructorParameters;
+    private getInjectProperties;
+}

package/dist/cachemap.d.cts

@@ -0,0 +1,21 @@
+import { CommonToken, META_KEYS, META_KEY_INJECTED_PARAMS, META_KEY_INJECTED_PROPS, META_KEY_POST_CONSTRUCT, META_KEY_PRE_DESTROY, META_VALUES, META_VALUE_INJECTED_PARAMS, META_VALUE_INJECTED_PROPS, META_VALUE_POST_CONSTRUCT, META_VALUE_PRE_DESTROY } from './interfaces';
+export declare function defineMetadata(metadataKey: META_KEY_INJECTED_PARAMS, metadataValue: META_VALUE_INJECTED_PARAMS, target: CommonToken): void;
+export declare function defineMetadata(metadataKey: META_KEY_INJECTED_PROPS, metadataValue: META_VALUE_INJECTED_PROPS, target: CommonToken): void;
+export declare function defineMetadata(metadataKey: META_KEY_POST_CONSTRUCT, metadataValue: META_VALUE_POST_CONSTRUCT, target: CommonToken): void;
+export declare function defineMetadata(metadataKey: META_KEY_PRE_DESTROY, metadataValue: META_VALUE_PRE_DESTROY, target: CommonToken): void;
+export declare function defineMetadata(metadataKey: META_KEYS, metadataValue: META_VALUES, target: CommonToken): void;
+export declare function getOwnMetadata(metadataKey: META_KEY_INJECTED_PARAMS, target: CommonToken): META_VALUE_INJECTED_PARAMS | undefined;
+export declare function getOwnMetadata(metadataKey: META_KEY_INJECTED_PROPS, target: CommonToken): META_VALUE_INJECTED_PROPS | undefined;
+export declare function getOwnMetadata(metadataKey: META_KEY_POST_CONSTRUCT, target: CommonToken): META_VALUE_POST_CONSTRUCT | undefined;
+export declare function getOwnMetadata(metadataKey: META_KEY_PRE_DESTROY, target: CommonToken): META_VALUE_PRE_DESTROY | undefined;
+export declare function getOwnMetadata(metadataKey: META_KEYS, target: CommonToken): META_VALUES | undefined;
+/**
+ * 使用hasParentClass判断当前target有没有父类
+ * 如果没有父类直接使用getOwnMetadata获取数据
+ * 如果有父类，那么需要合并getOwnMetadata(target)和getMetadata(target的父类)
+ * 不支持META_KEY_INJECTED_PARAMS作为metadataKey
+ */
+export declare function getMetadata(metadataKey: META_KEY_INJECTED_PROPS, target: CommonToken): META_VALUE_INJECTED_PROPS | undefined;
+export declare function getMetadata(metadataKey: META_KEY_POST_CONSTRUCT, target: CommonToken): META_VALUE_POST_CONSTRUCT | undefined;
+export declare function getMetadata(metadataKey: META_KEY_PRE_DESTROY, target: CommonToken): META_VALUE_PRE_DESTROY | undefined;
+export declare function getMetadata(metadataKey: Exclude<META_KEYS, META_KEY_INJECTED_PARAMS>, target: CommonToken): Exclude<META_VALUES, META_VALUE_INJECTED_PARAMS> | undefined;

package/dist/cachemap.d.ts

@@ -0,0 +1,21 @@
+import { CommonToken, META_KEYS, META_KEY_INJECTED_PARAMS, META_KEY_INJECTED_PROPS, META_KEY_POST_CONSTRUCT, META_KEY_PRE_DESTROY, META_VALUES, META_VALUE_INJECTED_PARAMS, META_VALUE_INJECTED_PROPS, META_VALUE_POST_CONSTRUCT, META_VALUE_PRE_DESTROY } from './interfaces';
+export declare function defineMetadata(metadataKey: META_KEY_INJECTED_PARAMS, metadataValue: META_VALUE_INJECTED_PARAMS, target: CommonToken): void;
+export declare function defineMetadata(metadataKey: META_KEY_INJECTED_PROPS, metadataValue: META_VALUE_INJECTED_PROPS, target: CommonToken): void;
+export declare function defineMetadata(metadataKey: META_KEY_POST_CONSTRUCT, metadataValue: META_VALUE_POST_CONSTRUCT, target: CommonToken): void;
+export declare function defineMetadata(metadataKey: META_KEY_PRE_DESTROY, metadataValue: META_VALUE_PRE_DESTROY, target: CommonToken): void;
+export declare function defineMetadata(metadataKey: META_KEYS, metadataValue: META_VALUES, target: CommonToken): void;
+export declare function getOwnMetadata(metadataKey: META_KEY_INJECTED_PARAMS, target: CommonToken): META_VALUE_INJECTED_PARAMS | undefined;
+export declare function getOwnMetadata(metadataKey: META_KEY_INJECTED_PROPS, target: CommonToken): META_VALUE_INJECTED_PROPS | undefined;
+export declare function getOwnMetadata(metadataKey: META_KEY_POST_CONSTRUCT, target: CommonToken): META_VALUE_POST_CONSTRUCT | undefined;
+export declare function getOwnMetadata(metadataKey: META_KEY_PRE_DESTROY, target: CommonToken): META_VALUE_PRE_DESTROY | undefined;
+export declare function getOwnMetadata(metadataKey: META_KEYS, target: CommonToken): META_VALUES | undefined;
+/**
+ * 使用hasParentClass判断当前target有没有父类
+ * 如果没有父类直接使用getOwnMetadata获取数据
+ * 如果有父类，那么需要合并getOwnMetadata(target)和getMetadata(target的父类)
+ * 不支持META_KEY_INJECTED_PARAMS作为metadataKey
+ */
+export declare function getMetadata(metadataKey: META_KEY_INJECTED_PROPS, target: CommonToken): META_VALUE_INJECTED_PROPS | undefined;
+export declare function getMetadata(metadataKey: META_KEY_POST_CONSTRUCT, target: CommonToken): META_VALUE_POST_CONSTRUCT | undefined;
+export declare function getMetadata(metadataKey: META_KEY_PRE_DESTROY, target: CommonToken): META_VALUE_PRE_DESTROY | undefined;
+export declare function getMetadata(metadataKey: Exclude<META_KEYS, META_KEY_INJECTED_PARAMS>, target: CommonToken): Exclude<META_VALUES, META_VALUE_INJECTED_PARAMS> | undefined;

package/dist/constants.d.cts

@@ -0,0 +1,28 @@
+export declare const KEYS: {
+    readonly INJECTED_PARAMS: "injected:params";
+    readonly INJECTED_PROPS: "injected:props";
+    readonly INJECT: "inject";
+    readonly SELF: "self";
+    readonly SKIP_SELF: "skipSelf";
+    readonly OPTIONAL: "optional";
+    readonly POST_CONSTRUCT: "postConstruct";
+    readonly PRE_DESTROY: "preDestroy";
+};
+export declare const STATUS: {
+    readonly DEFAULT: "default";
+    readonly INITING: "initing";
+    readonly ACTIVATED: "activated";
+};
+export declare const BINDING: {
+    readonly Invalid: "Invalid";
+    readonly Instance: "Instance";
+    readonly ConstantValue: "ConstantValue";
+    readonly DynamicValue: "DynamicValue";
+};
+export declare const ERRORS: {
+    readonly POST_CONSTRUCT: "Cannot apply @PostConstruct decorator multiple times in the same class.";
+    readonly PRE_DESTROY: "Cannot apply @PreDestroy decorator multiple times in the same class.";
+    readonly MISS_INJECT: "Expected a @Inject decorator to explicitly specify the token.";
+    readonly MISS_CONTAINER: "@LazyInject decorator cannot find the corresponding container.";
+};
+export declare const DEFAULT_VALUE: unique symbol;

package/dist/constants.d.ts

@@ -0,0 +1,28 @@
+export declare const KEYS: {
+    readonly INJECTED_PARAMS: "injected:params";
+    readonly INJECTED_PROPS: "injected:props";
+    readonly INJECT: "inject";
+    readonly SELF: "self";
+    readonly SKIP_SELF: "skipSelf";
+    readonly OPTIONAL: "optional";
+    readonly POST_CONSTRUCT: "postConstruct";
+    readonly PRE_DESTROY: "preDestroy";
+};
+export declare const STATUS: {
+    readonly DEFAULT: "default";
+    readonly INITING: "initing";
+    readonly ACTIVATED: "activated";
+};
+export declare const BINDING: {
+    readonly Invalid: "Invalid";
+    readonly Instance: "Instance";
+    readonly ConstantValue: "ConstantValue";
+    readonly DynamicValue: "DynamicValue";
+};
+export declare const ERRORS: {
+    readonly POST_CONSTRUCT: "Cannot apply @PostConstruct decorator multiple times in the same class.";
+    readonly PRE_DESTROY: "Cannot apply @PreDestroy decorator multiple times in the same class.";
+    readonly MISS_INJECT: "Expected a @Inject decorator to explicitly specify the token.";
+    readonly MISS_CONTAINER: "@LazyInject decorator cannot find the corresponding container.";
+};
+export declare const DEFAULT_VALUE: unique symbol;

package/dist/container.d.cts

@@ -0,0 +1,29 @@
+import { Binding } from './binding';
+import { Options, CommonToken, ActivationHandler, DeactivationHandler } from './interfaces';
+export declare class Container {
+    parent?: Container;
+    private bindings;
+    private onActivationHandler?;
+    private onDeactivationHandler?;
+    bind<T>(token: CommonToken<T>): Binding<T>;
+    unbind<T>(token: CommonToken<T>): void;
+    unbindAll(): void;
+    isCurrentBound<T>(token: CommonToken<T>): boolean;
+    isBound<T>(token: CommonToken<T>): boolean;
+    createChild(): Container;
+    get<T>(token: CommonToken<T>, options: Options<T> & {
+        optional: true;
+    }): T | void;
+    get<T>(token: CommonToken<T>, options?: Options<T> & {
+        optional?: false;
+    }): T;
+    get<T>(token: CommonToken<T>, options?: Options<T>): T | void;
+    onActivation(handler: ActivationHandler): void;
+    onDeactivation(handler: DeactivationHandler): void;
+    activate<T>(input: T, token: CommonToken<T>): T;
+    deactivate<T>(binding: Binding<T>): void;
+    private buildBinding;
+    private getBinding;
+    private checkBindingNotFoundError;
+}
+export declare const CONTAINER_MAP: WeakMap<any, Container>;

package/dist/container.d.ts

@@ -0,0 +1,29 @@
+import { Binding } from './binding';
+import { Options, CommonToken, ActivationHandler, DeactivationHandler } from './interfaces';
+export declare class Container {
+    parent?: Container;
+    private bindings;
+    private onActivationHandler?;
+    private onDeactivationHandler?;
+    bind<T>(token: CommonToken<T>): Binding<T>;
+    unbind<T>(token: CommonToken<T>): void;
+    unbindAll(): void;
+    isCurrentBound<T>(token: CommonToken<T>): boolean;
+    isBound<T>(token: CommonToken<T>): boolean;
+    createChild(): Container;
+    get<T>(token: CommonToken<T>, options: Options<T> & {
+        optional: true;
+    }): T | void;
+    get<T>(token: CommonToken<T>, options?: Options<T> & {
+        optional?: false;
+    }): T;
+    get<T>(token: CommonToken<T>, options?: Options<T>): T | void;
+    onActivation(handler: ActivationHandler): void;
+    onDeactivation(handler: DeactivationHandler): void;
+    activate<T>(input: T, token: CommonToken<T>): T;
+    deactivate<T>(binding: Binding<T>): void;
+    private buildBinding;
+    private getBinding;
+    private checkBindingNotFoundError;
+}
+export declare const CONTAINER_MAP: WeakMap<any, Container>;

package/dist/decorator.d.cts

@@ -0,0 +1,18 @@
+import { InjectFunction } from './interfaces';
+/**
+ * 创建装饰器的高阶函数
+ * 装饰器的通用逻辑就是通过cachemap记录到全局的WeakMap中
+ *
+ * @param {(string )} decoratorKey 代表某个装饰器的名称
+ * @param {*} [defaultValue] 该装饰器函数的默认参数
+ * @return {*} 装饰器函数
+ */
+declare function createDecorator(decoratorKey: string, defaultValue?: any): (decoratorValue?: any) => (target: any, targetKey?: string, index?: number) => void;
+export declare const Inject: InjectFunction<ReturnType<typeof createDecorator>>;
+export declare const Self: (decoratorValue?: any) => (target: any, targetKey?: string, index?: number) => void;
+export declare const SkipSelf: (decoratorValue?: any) => (target: any, targetKey?: string, index?: number) => void;
+export declare const Optional: (decoratorValue?: any) => (target: any, targetKey?: string, index?: number) => void;
+export declare const PostConstruct: (metaValue: import('./interfaces').PostConstructParam) => (target: any, propertyKey: string) => void;
+export declare const PreDestroy: (metaValue: void) => (target: any, propertyKey: string) => void;
+export declare function decorate(decorator: any, target: any, key: number | string): void;
+export {};

package/dist/decorator.d.ts

@@ -0,0 +1,18 @@
+import { InjectFunction } from './interfaces';
+/**
+ * 创建装饰器的高阶函数
+ * 装饰器的通用逻辑就是通过cachemap记录到全局的WeakMap中
+ *
+ * @param {(string )} decoratorKey 代表某个装饰器的名称
+ * @param {*} [defaultValue] 该装饰器函数的默认参数
+ * @return {*} 装饰器函数
+ */
+declare function createDecorator(decoratorKey: string, defaultValue?: any): (decoratorValue?: any) => (target: any, targetKey?: string, index?: number) => void;
+export declare const Inject: InjectFunction<ReturnType<typeof createDecorator>>;
+export declare const Self: (decoratorValue?: any) => (target: any, targetKey?: string, index?: number) => void;
+export declare const SkipSelf: (decoratorValue?: any) => (target: any, targetKey?: string, index?: number) => void;
+export declare const Optional: (decoratorValue?: any) => (target: any, targetKey?: string, index?: number) => void;
+export declare const PostConstruct: (metaValue: import('./interfaces').PostConstructParam) => (target: any, propertyKey: string) => void;
+export declare const PreDestroy: (metaValue: void) => (target: any, propertyKey: string) => void;
+export declare function decorate(decorator: any, target: any, key: number | string): void;
+export {};

package/dist/errors/BaseError.d.cts

@@ -0,0 +1,4 @@
+import { CommonToken } from '../interfaces';
+export declare class BaseError extends Error {
+    constructor(prefix: string, token?: CommonToken);
+}

package/dist/errors/BaseError.d.ts

@@ -0,0 +1,4 @@
+import { CommonToken } from '../interfaces';
+export declare class BaseError extends Error {
+    constructor(prefix: string, token?: CommonToken);
+}

package/dist/errors/BindingNotFoundError.d.cts

@@ -0,0 +1,5 @@
+import { BaseError } from './BaseError';
+import { CommonToken } from '../interfaces';
+export declare class BindingNotFoundError extends BaseError {
+    constructor(token: CommonToken);
+}

package/dist/errors/BindingNotFoundError.d.ts

@@ -0,0 +1,5 @@
+import { BaseError } from './BaseError';
+import { CommonToken } from '../interfaces';
+export declare class BindingNotFoundError extends BaseError {
+    constructor(token: CommonToken);
+}

package/dist/errors/BindingNotValidError.d.cts

@@ -0,0 +1,5 @@
+import { BaseError } from './BaseError';
+import { CommonToken } from '../interfaces';
+export declare class BindingNotValidError extends BaseError {
+    constructor(token: CommonToken);
+}

package/dist/errors/BindingNotValidError.d.ts

@@ -0,0 +1,5 @@
+import { BaseError } from './BaseError';
+import { CommonToken } from '../interfaces';
+export declare class BindingNotValidError extends BaseError {
+    constructor(token: CommonToken);
+}

package/dist/errors/CircularDependencyError.d.cts

@@ -0,0 +1,5 @@
+import { BaseError } from './BaseError';
+import { Options } from '../interfaces';
+export declare class CircularDependencyError extends BaseError {
+    constructor(options: Options);
+}

package/dist/errors/CircularDependencyError.d.ts

@@ -0,0 +1,5 @@
+import { BaseError } from './BaseError';
+import { Options } from '../interfaces';
+export declare class CircularDependencyError extends BaseError {
+    constructor(options: Options);
+}

package/dist/errors/DuplicateBindingError.d.cts

@@ -0,0 +1,5 @@
+import { BaseError } from './BaseError';
+import { CommonToken } from '../interfaces';
+export declare class DuplicateBindingError extends BaseError {
+    constructor(token: CommonToken);
+}

package/dist/errors/DuplicateBindingError.d.ts

@@ -0,0 +1,5 @@
+import { BaseError } from './BaseError';
+import { CommonToken } from '../interfaces';
+export declare class DuplicateBindingError extends BaseError {
+    constructor(token: CommonToken);
+}

package/dist/errors/PostConstructError.d.cts

@@ -0,0 +1,5 @@
+import { Options } from '../interfaces';
+import { CircularDependencyError } from './CircularDependencyError';
+export declare class PostConstructError extends CircularDependencyError {
+    constructor(options: Options);
+}

package/dist/errors/PostConstructError.d.ts

@@ -0,0 +1,5 @@
+import { Options } from '../interfaces';
+import { CircularDependencyError } from './CircularDependencyError';
+export declare class PostConstructError extends CircularDependencyError {
+    constructor(options: Options);
+}

package/dist/index.cjs

@@ -0,0 +1 @@
+"use strict";var w=Object.defineProperty;var _=(n,t,e)=>t in n?w(n,t,{enumerable:!0,configurable:!0,writable:!0,value:e}):n[t]=e;var o=(n,t,e)=>_(n,typeof t!="symbol"?t+"":t,e);Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const l={INJECTED_PARAMS:"injected:params",INJECTED_PROPS:"injected:props",INJECT:"inject",SELF:"self",SKIP_SELF:"skipSelf",OPTIONAL:"optional",POST_CONSTRUCT:"postConstruct",PRE_DESTROY:"preDestroy"},p={DEFAULT:"default",INITING:"initing",ACTIVATED:"activated"},d={Invalid:"Invalid",Instance:"Instance",ConstantValue:"ConstantValue",DynamicValue:"DynamicValue"},I={POST_CONSTRUCT:"Cannot apply @PostConstruct decorator multiple times in the same class.",PRE_DESTROY:"Cannot apply @PreDestroy decorator multiple times in the same class.",MISS_INJECT:"Expected a @Inject decorator to explicitly specify the token.",MISS_CONTAINER:"@LazyInject decorator cannot find the corresponding container."},P=Symbol(),S=new WeakMap;function j(n){return typeof n=="function"&&Object.getPrototypeOf(n)!==Function.prototype}function N(n,t,e){const s=S.get(e)||{};s[n]=t,S.set(e,s)}function C(n,t){return(S.get(t)||{})[n]}function g(n,t){const e=C(n,t);if(!j(t))return e;const s=g(n,Object.getPrototypeOf(t));if(s||e)return{...s||{},...e||{}}}class k{constructor(t){o(this,"_","");o(this,"name");this.name=t}}class O{constructor(t){o(this,"callback");this.callback=t}resolve(){return this.callback()}}function v(n){if(!n)throw new Error(I.MISS_INJECT);return n instanceof O?n.resolve():n}class T extends Error{constructor(t,e){super(),this.name=this.constructor.name,this.message=`${t}${e==null?void 0:e.name}`}}class b extends T{constructor(t){super("");const e=[];let s=t;for(;s&&s.token;)e.push(s.token),s=s.parent;const i=e.reverse().map(a=>a.name).join(" --> ");this.message=`Circular dependency found: ${i}`}}class B extends T{constructor(t){super("Invalid binding: ",t)}}class M extends b{constructor(t){super(t),this.name="CircularDependencyError inside @PostConstruct"}}class L{constructor(t,e){o(this,"container");o(this,"context");o(this,"token");o(this,"type",d.Invalid);o(this,"status",p.DEFAULT);o(this,"classValue");o(this,"constantValue");o(this,"dynamicValue");o(this,"cache");o(this,"postConstructResult",P);o(this,"onActivationHandler");o(this,"onDeactivationHandler");this.container=e,this.context={container:this.container},this.token=t}onActivation(t){this.onActivationHandler=t}onDeactivation(t){this.onDeactivationHandler=t}activate(t){const e=this.onActivationHandler?this.onActivationHandler(this.context,t):t;return this.container.activate(e,this.token)}deactivate(){this.onDeactivationHandler&&this.onDeactivationHandler(this.cache)}to(t){return this.type=d.Instance,this.classValue=t,this}toSelf(){return this.to(this.token)}toConstantValue(t){return this.type=d.ConstantValue,this.constantValue=t,this}toDynamicValue(t){return this.type=d.DynamicValue,this.dynamicValue=t,this}toService(t){return this.toDynamicValue(e=>e.container.get(t,{parent:{token:this.token}}))}get(t){if(p.INITING===this.status)throw new b(t);if(p.ACTIVATED===this.status)return this.cache;if(d.Instance===this.type)return this.resolveInstanceValue(t);if(d.ConstantValue===this.type)return this.resolveConstantValue();if(d.DynamicValue===this.type)return this.resolveDynamicValue();throw new B(this.token)}getAwaitBindings(t,e){return e===!0?t:Array.isArray(e)?t.filter(s=>e.includes(s.token)):typeof e=="function"?t.filter(e):[]}postConstruct(t,e,s){if(d.Instance===this.type){const{key:i,value:a}=g(l.POST_CONSTRUCT,this.token)||{};if(i)if(a){const r=[...e,...s].filter(u=>d.Instance===(u==null?void 0:u.type)),c=this.getAwaitBindings(r,a);for(const u of c)if(u&&u.postConstructResult===P)throw new M({token:u.token,parent:t});const h=c.map(u=>u.postConstructResult);this.postConstructResult=Promise.all(h).then(()=>this.execute(i))}else this.postConstructResult=this.execute(i);else this.postConstructResult=void 0}}preDestroy(){if(d.Instance===this.type){const{key:t}=g(l.PRE_DESTROY,this.token)||{};if(t)return this.execute(t)}this.container=null,this.context=null}execute(t){const e=this.cache[t];return e==null?void 0:e.call(this.cache)}resolveInstanceValue(t){this.status=p.INITING;const e=this.classValue,[s,i]=this.getConstructorParameters(t),a=new e(...s);this.cache=this.activate(a),this.status=p.ACTIVATED,m.set(this.cache,this.container);const[r,c]=this.getInjectProperties(t);return Object.assign(this.cache,r),this.postConstruct(t,i,c),this.cache}resolveConstantValue(){return this.status=p.INITING,this.cache=this.activate(this.constantValue),this.status=p.ACTIVATED,this.cache}resolveDynamicValue(){this.status=p.INITING;const t=this.dynamicValue.call(this,this.context);return this.cache=this.activate(t),this.status=p.ACTIVATED,this.cache}getConstructorParameters(t){const e=C(l.INJECTED_PARAMS,this.classValue)||[],s=[],i=[];for(let a=0;a<e.length;a++){const r=e[a],{inject:c,...h}=r;h.parent=t;const u=this.container.get(v(c),h);s.push(u),i.push(h.binding)}return[s,i]}getInjectProperties(t){const e=g(l.INJECTED_PROPS,this.classValue)||{},s=Object.keys(e),i=Object.create(null),a=[];for(let r=0;r<s.length;r++){const c=s[r],h=e[c],{inject:u,...f}=h;f.parent=t;const y=this.container.get(v(u),f);y===void 0&&h.optional||(i[c]=y),a.push(f.binding)}return[i,a]}}class x extends T{constructor(t){super("No matching binding found for token: ",t)}}class H extends T{constructor(t){super("Cannot bind token multiple times: ",t)}}class D{constructor(){o(this,"parent");o(this,"bindings",new Map);o(this,"onActivationHandler");o(this,"onDeactivationHandler")}bind(t){if(this.bindings.has(t))throw new H(t);const e=this.buildBinding(t);return this.bindings.set(t,e),e}unbind(t){if(this.bindings.has(t)){const e=this.getBinding(t);this.deactivate(e),e.preDestroy(),this.bindings.delete(t)}}unbindAll(){this.bindings.forEach(t=>{this.unbind(t.token)})}isCurrentBound(t){return this.bindings.has(t)}isBound(t){return this.isCurrentBound(t)||!!this.parent&&this.parent.isBound(t)}createChild(){const t=new D;return t.parent=this,t}get(t,e={}){const s=this.getBinding(t);if(e.skipSelf){if(this.parent)return e.skipSelf=!1,this.parent.get(t,e)}else if(e.self||s){if(s)return e.token=t,e.binding=s,s.get(e)}else if(this.parent)return this.parent.get(t,e);return this.checkBindingNotFoundError(t,e)}onActivation(t){this.onActivationHandler=t}onDeactivation(t){this.onDeactivationHandler=t}activate(t,e){return this.onActivationHandler?this.onActivationHandler({container:this},t,e):t}deactivate(t){this.onDeactivationHandler&&this.onDeactivationHandler(t.cache,t.token),t.deactivate()}buildBinding(t){return new L(t,this)}getBinding(t){return this.bindings.get(t)}checkBindingNotFoundError(t,e){if(!e.optional)throw new x(t)}}const m=new WeakMap;function E(n,t){return function(e){return function(s,i,a){const r=typeof a=="number",c=r?s:s.constructor,h=r?a:i,u=r?l.INJECTED_PARAMS:l.INJECTED_PROPS,f=r?C(u,c)||[]:g(u,c)||{},y=f[h]||{};y[n]=e===void 0?t:e,f[h]=y,N(u,f,c)}}}function V(n,t){return e=>(s,i)=>{if(C(n,s.constructor))throw new Error(t);N(n,{key:i,value:e},s.constructor)}}const F=E(l.INJECT),J=E(l.SELF,!0),U=E(l.SKIP_SELF,!0),z=E(l.OPTIONAL,!0),G=V(l.POST_CONSTRUCT,I.POST_CONSTRUCT),Y=V(l.PRE_DESTROY,I.PRE_DESTROY);function A(n,t,e,s){for(let i=n.length-1;i>=0;i--)n[i](t,e,s)}function K(n,t,e){n=Array.isArray(n)?n:[n],typeof e=="number"?A(n,t,void 0,e):typeof e=="string"&&A(n,t.prototype,e)}function $(n,t,e,s){function i(){const r=Symbol.for(t);if(!this.hasOwnProperty(r)){const c=s||m.get(this),h=this.constructor;if(!c)throw new Error(`${I.MISS_CONTAINER} ${h.name}`);this[r]=c.get(v(e),{parent:{token:h}})}return this[r]}function a(r){const c=Symbol.for(t);this[c]=r}Object.defineProperty(n,t,{configurable:!0,enumerable:!0,get:i,set:a})}function R(n,t){return function(e,s){$(e,s,n,t)}}function W(n){return function(t){return R(t,n)}}exports.CONTAINER_MAP=m;exports.Container=D;exports.Inject=F;exports.LazyInject=R;exports.LazyToken=O;exports.Optional=z;exports.PostConstruct=G;exports.PreDestroy=Y;exports.Self=J;exports.SkipSelf=U;exports.Token=k;exports.createLazyInject=W;exports.decorate=K;

package/dist/index.d.cts

@@ -0,0 +1,4 @@
+export { Container, CONTAINER_MAP } from './container';
+export { Token, LazyToken } from './token';
+export { Inject, Self, SkipSelf, Optional, PostConstruct, PreDestroy, decorate, } from './decorator';
+export { LazyInject, createLazyInject } from './lazyinject';

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { Container, CONTAINER_MAP } from './container';
+export { Token, LazyToken } from './token';
+export { Inject, Self, SkipSelf, Optional, PostConstruct, PreDestroy, decorate, } from './decorator';
+export { LazyInject, createLazyInject } from './lazyinject';