@tsed/di 7.83.3 → 8.0.0-alpha.10

package/lib/types-esm/common/domain/Provider.d.ts

@@ -1,71 +0,0 @@
-import { Store, Type } from "@tsed/core";
-import type { ProviderOpts } from "../interfaces/ProviderOpts.js";
-import type { TokenProvider } from "../interfaces/TokenProvider.js";
-import { ProviderScope } from "./ProviderScope.js";
-import { ProviderType } from "./ProviderType.js";
-export type ProviderHookCallback<T = any> = (instance: T, ...args: unknown[]) => Promise<void> | void;
-export declare class Provider<T = any> implements ProviderOpts<T> {
-    /**
-     * Token group provider to retrieve all provider from the same type
-     */
-    type: TokenProvider | ProviderType;
-    deps: TokenProvider[];
-    imports: (TokenProvider | [TokenProvider])[];
-    alias?: string;
-    useFactory?: Function;
-    useAsyncFactory?: Function;
-    useValue?: unknown;
-    hooks?: Record<string, ProviderHookCallback<T>>;
-    private _useClass;
-    private _provide;
-    private _store;
-    private _tokenStore;
-    [key: string]: any;
-    constructor(token: TokenProvider, options?: Partial<Provider>);
-    get token(): any;
-    get provide(): TokenProvider;
-    set provide(value: TokenProvider);
-    get useClass(): Type<T>;
-    /**
-     * Create a new store if the given value is a class. Otherwise the value is ignored.
-     * @param value
-     */
-    set useClass(value: Type<T>);
-    get className(): string;
-    get name(): string;
-    get store(): Store;
-    get path(): string;
-    set path(path: string);
-    /**
-     * Get the scope of the provider.
-     *
-     * ::: tip Note
-     * Async provider is always a SINGLETON
-     * :::
-     *
-     * @returns {boolean}
-     */
-    get scope(): ProviderScope;
-    /**
-     * Change the scope value of the provider.
-     * @param scope
-     */
-    set scope(scope: ProviderScope);
-    get configuration(): Partial<TsED.Configuration>;
-    set configuration(configuration: Partial<TsED.Configuration>);
-    get children(): TokenProvider[];
-    get(key: string): any;
-    isAsync(): boolean;
-    clone(): Provider;
-    /**
-     *
-     * @returns {boolean}
-     */
-    hasChildren(): boolean;
-    /**
-     *
-     * @returns {boolean}
-     */
-    hasParent(): boolean;
-    toString(): string;
-}

package/lib/types-esm/common/domain/ProviderScope.d.ts

@@ -1,5 +0,0 @@
-export declare enum ProviderScope {
-    SINGLETON = "singleton",
-    REQUEST = "request",
-    INSTANCE = "instance"
-}

package/lib/types-esm/common/domain/ProviderType.d.ts

@@ -1,10 +0,0 @@
-export declare enum ProviderType {
-    VALUE = "value",
-    FACTORY = "factory",
-    SERVICE = "service",
-    PROVIDER = "provider",
-    MODULE = "module",
-    CONTROLLER = "controller",
-    INTERCEPTOR = "interceptor",
-    MIDDLEWARE = "middleware"
-}

package/lib/types-esm/common/errors/InjectionError.d.ts

@@ -1,8 +0,0 @@
-import { TokenProvider } from "../interfaces/TokenProvider.js";
-export declare class InjectionError extends Error {
-    name: string;
-    tokens: TokenProvider[];
-    origin: any;
-    constructor(token: TokenProvider, origin?: any);
-    static throwInjectorError(token: any, currentDependency: any, error: any): void;
-}

package/lib/types-esm/common/errors/InvalidPropertyTokenError.d.ts

@@ -1,4 +0,0 @@
-export declare class InvalidPropertyTokenError extends Error {
-    name: string;
-    constructor(target: any, propertyKey: string);
-}

package/lib/types-esm/common/errors/UndefinedTokenError.d.ts

@@ -1,4 +0,0 @@
-export declare class UndefinedTokenError extends Error {
-    name: string;
-    constructor();
-}

package/lib/types-esm/common/index.d.ts

@@ -1,56 +0,0 @@
-/**
- * @file Automatically generated by @tsed/barrels.
- */
-export * from "./constants/constants.js";
-export * from "./decorators/autoInjectable.js";
-export * from "./decorators/configuration.js";
-export * from "./decorators/constant.js";
-export * from "./decorators/controller.js";
-export * from "./decorators/inject.js";
-export * from "./decorators/injectable.js";
-export * from "./decorators/intercept.js";
-export * from "./decorators/interceptor.js";
-export * from "./decorators/lazyInject.js";
-export * from "./decorators/module.js";
-export * from "./decorators/opts.js";
-export * from "./decorators/overrideProvider.js";
-export * from "./decorators/scope.js";
-export * from "./decorators/service.js";
-export * from "./decorators/useOpts.js";
-export * from "./decorators/value.js";
-export * from "./domain/Container.js";
-export * from "./domain/ControllerProvider.js";
-export * from "./domain/InjectablePropertyType.js";
-export * from "./domain/LocalsContainer.js";
-export * from "./domain/Provider.js";
-export * from "./domain/ProviderScope.js";
-export * from "./domain/ProviderType.js";
-export * from "./errors/InjectionError.js";
-export * from "./errors/InvalidPropertyTokenError.js";
-export * from "./errors/UndefinedTokenError.js";
-export * from "./interfaces/DIConfigurationOptions.js";
-export * from "./interfaces/DILogger.js";
-export * from "./interfaces/DILoggerOptions.js";
-export * from "./interfaces/DIResolver.js";
-export * from "./interfaces/ImportTokenProviderOpts.js";
-export * from "./interfaces/InjectableProperties.js";
-export * from "./interfaces/InterceptorContext.js";
-export * from "./interfaces/InterceptorMethods.js";
-export * from "./interfaces/InvokeOptions.js";
-export * from "./interfaces/OnDestroy.js";
-export * from "./interfaces/OnInit.js";
-export * from "./interfaces/ProviderOpts.js";
-export * from "./interfaces/RegistrySettings.js";
-export * from "./interfaces/ResolvedInvokeOptions.js";
-export * from "./interfaces/TokenProvider.js";
-export * from "./interfaces/TokenRoute.js";
-export * from "./registries/GlobalProviders.js";
-export * from "./registries/ProviderRegistry.js";
-export * from "./services/DIConfiguration.js";
-export * from "./services/DILogger.js";
-export * from "./services/InjectorService.js";
-export * from "./utils/colors.js";
-export * from "./utils/createContainer.js";
-export * from "./utils/getConfiguration.js";
-export * from "./utils/getConstructorDependencies.js";
-export * from "./utils/resolveControllers.js";

package/lib/types-esm/common/interfaces/DIConfigurationOptions.d.ts

@@ -1,29 +0,0 @@
-import type { ProviderScope } from "../domain/ProviderScope.js";
-import type { DIResolver } from "./DIResolver.js";
-import type { ImportTokenProviderOpts } from "./ImportTokenProviderOpts.js";
-import type { TokenProvider } from "./TokenProvider.js";
-declare global {
-    namespace TsED {
-        interface Context {
-        }
-        interface Configuration extends Record<string, any> {
-            scopes: {
-                [key: string]: ProviderScope;
-            };
-            /**
-             * Define a list of resolvers (it can be an external DI).
-             */
-            resolvers: DIResolver[];
-            /**
-             * Define dependencies to build the provider
-             */
-            imports: (TokenProvider | ImportTokenProviderOpts)[];
-            /**
-             * Mount controllers
-             */
-            mount: Record<string, TokenProvider[]>;
-        }
-    }
-}
-export interface DIConfigurationOptions extends TsED.Configuration {
-}

package/lib/types-esm/common/interfaces/DILogger.d.ts

@@ -1,8 +0,0 @@
-export interface DILogger {
-    info(...args: any[]): void | any;
-    warn(...args: any[]): void | any;
-    debug(...args: any[]): void | any;
-    error(...args: any[]): void | any;
-    trace(...args: any[]): void | any;
-    [key: string]: any;
-}

package/lib/types-esm/common/interfaces/DILoggerOptions.d.ts

@@ -1,53 +0,0 @@
-export interface DILoggerOptions {
-    /**
-     * Enable debug mode. By default debug is false.
-     */
-    debug?: boolean;
-    /**
-     * Enable info mode. By default debug is false.
-     */
-    level?: "debug" | "info" | "warn" | "error" | "off";
-    /**
-     * Enable log performance tracker and disable log server.
-     */
-    perf?: boolean;
-    /**
-     * List of regexp to ignore log.
-     */
-    ignoreUrlPatterns?: (string | RegExp)[];
-    /**
-     * The number of space characters to use as white space in JSON output. Default is 2 (0 in production).
-     */
-    jsonIndentation?: number;
-    /**
-     * A function called for each incoming request to create a request id.
-     * @returns {number}
-     */
-    reqIdBuilder?: (req: any) => string;
-    /**
-     * Disable routes table displayed in the logger. By default debug is `false`.
-     */
-    disableRoutesSummary?: boolean;
-    /**
-     * Disable bootstrap log displayed in the logger. By default debug is `false`.
-     */
-    disableBootstrapLog?: boolean;
-    /**
-     * Specify log format. Example: `%[%d{[yyyy-MM-dd hh:mm:ss,SSS}] %p%] %m`. See [@tsed/logger configuration](https://tsedio.github.io/logger/).
-     */
-    format?: string;
-    /**
-     * Specify the log stack size for the context.logger. When the stack.length is reach, the logger is flushed during the request.
-     * Default size is set to 30.
-     */
-    maxStackSize?: number;
-}
-declare global {
-    namespace TsED {
-        interface LoggerConfiguration extends DILoggerOptions {
-        }
-        interface Configuration extends Record<string, any> {
-            logger?: LoggerConfiguration;
-        }
-    }
-}

package/lib/types-esm/common/interfaces/DIResolver.d.ts

@@ -1,5 +0,0 @@
-import type { TokenProvider } from "./TokenProvider.js";
-export interface DIResolver {
-    deps?: TokenProvider[];
-    get<T = any>(type: TokenProvider, options: any): T | undefined;
-}

package/lib/types-esm/common/interfaces/ImportTokenProviderOpts.d.ts

@@ -1,19 +0,0 @@
-import type { Type } from "@tsed/core";
-import type { TokenProvider } from "./TokenProvider.js";
-export type UseImportTokenProviderOpts = {
-    token: TokenProvider;
-    use: unknown;
-};
-export type UseClassImportTokenProviderOpts = {
-    token: TokenProvider;
-    useClass: Type | Function;
-};
-export type UseFactoryImportTokenProviderOpts = {
-    token: TokenProvider;
-    useFactory: (...args: unknown[]) => unknown;
-};
-export type UseAsyncFactoryImportTokenProviderOpts = {
-    token: TokenProvider;
-    useAsyncFactory: (...args: unknown[]) => Promise<unknown>;
-};
-export type ImportTokenProviderOpts = UseImportTokenProviderOpts | UseClassImportTokenProviderOpts | UseFactoryImportTokenProviderOpts | UseAsyncFactoryImportTokenProviderOpts;

package/lib/types-esm/common/interfaces/InjectableProperties.d.ts

@@ -1,25 +0,0 @@
-import type { InjectablePropertyType } from "../domain/InjectablePropertyType.js";
-import type { LocalsContainer } from "../domain/LocalsContainer.js";
-import type { TokenProvider } from "./TokenProvider.js";
-import type { InjectorService } from "../services/InjectorService.js";
-import type { InvokeOptions } from "./InvokeOptions.js";
-export interface InjectableProperty {
-    propertyKey: string;
-}
-export interface InjectablePropertyOptions extends InjectableProperty {
-    bindingType: InjectablePropertyType.METHOD | InjectablePropertyType.PROPERTY | InjectablePropertyType.INTERCEPTOR;
-    propertyType: string;
-    useType?: TokenProvider;
-    resolver: (injector: InjectorService, locals: LocalsContainer, options: Partial<InvokeOptions> & {
-        options: any;
-    }) => () => any;
-    options?: any;
-}
-export interface InjectablePropertyValue extends InjectableProperty {
-    bindingType: InjectablePropertyType.CONSTANT | InjectablePropertyType.VALUE;
-    expression: string;
-    defaultValue?: any;
-}
-export interface InjectableProperties {
-    [key: string]: InjectablePropertyOptions | InjectablePropertyValue;
-}

package/lib/types-esm/common/interfaces/InterceptorContext.d.ts

@@ -1,11 +0,0 @@
-import type { Type } from "@tsed/core";
-export interface InterceptorNext {
-    <T>(err?: Error): T;
-}
-export interface InterceptorContext<Klass = Type, Opts = any> {
-    target: Klass;
-    propertyKey: string;
-    args: any[];
-    next: InterceptorNext;
-    options?: Opts;
-}

package/lib/types-esm/common/interfaces/InterceptorMethods.d.ts

@@ -1,4 +0,0 @@
-import type { InterceptorContext, InterceptorNext } from "./InterceptorContext.js";
-export interface InterceptorMethods {
-    intercept(context: InterceptorContext, next?: InterceptorNext): any;
-}

package/lib/types-esm/common/interfaces/InvokeOptions.d.ts

@@ -1,24 +0,0 @@
-import { ProviderScope } from "../domain/ProviderScope.js";
-import { TokenProvider } from "./TokenProvider.js";
-export interface InvokeOptions {
-    /**
-     * Define dependencies to build the provider and inject them in the constructor.
-     */
-    deps: unknown[];
-    /**
-     * List of imports to be created before the provider. Imports list aren't injected directly in the provider constructor.
-     */
-    imports: unknown[];
-    /**
-     * Parent provider.
-     */
-    parent?: TokenProvider;
-    /**
-     * Scope used by the injector to build the provider.
-     */
-    scope: ProviderScope;
-    /**
-     * If true, the injector will rebuild the instance.
-     */
-    rebuild?: boolean;
-}

package/lib/types-esm/common/interfaces/OnDestroy.d.ts

@@ -1,3 +0,0 @@
-export interface OnDestroy {
-    $onDestroy(): Promise<any> | void;
-}

package/lib/types-esm/common/interfaces/OnInit.d.ts

@@ -1,3 +0,0 @@
-export interface OnInit {
-    $onInit(): Promise<any> | void;
-}

package/lib/types-esm/common/interfaces/ProviderOpts.d.ts

@@ -1,59 +0,0 @@
-import type { Type } from "@tsed/core";
-import type { ProviderType } from "../domain/ProviderType.js";
-import type { DIResolver } from "./DIResolver.js";
-import type { ProviderScope } from "../domain/ProviderScope.js";
-import type { TokenProvider } from "./TokenProvider.js";
-export interface ProviderOpts<T = any> {
-    /**
-     * An injection token. (Typically an instance of `Type` or `InjectionToken`, but can be `any`).
-     */
-    provide: TokenProvider;
-    /**
-     * Create alias token to retrieve the instance provider.
-     */
-    alias?: TokenProvider;
-    /**
-     * Provider type
-     */
-    type?: TokenProvider | ProviderType;
-    /**
-     * Instance build by the injector
-     */
-    instance?: T;
-    /**
-     * Define dependencies to build the provider
-     */
-    deps?: TokenProvider[];
-    /**
-     * Class to instantiate for the `token`.
-     */
-    useClass?: Type<T>;
-    /**
-     * Provide a function to build the provider
-     */
-    useFactory?: Function;
-    /**
-     * Provide an async function to build the provider
-     */
-    useAsyncFactory?: Function;
-    /**
-     * Provide predefined value
-     */
-    useValue?: any;
-    /**
-     * Scope used by the injector to build the provider.
-     */
-    scope?: ProviderScope;
-    /**
-     * A list of resolvers which will be used to resolve missing Symbol/Class when injector invoke a Class. This property allow external DI usage.
-     */
-    resolvers?: DIResolver[];
-    /**
-     * hooks to intercept custom events
-     */
-    hooks?: Record<string, (instance: T, ...args: any[]) => Promise<any> | any>;
-    /**
-     *
-     */
-    [key: string]: any;
-}

package/lib/types-esm/common/interfaces/RegistrySettings.d.ts

@@ -1,20 +0,0 @@
-import { Type } from "@tsed/core";
-import type { Provider } from "../domain/Provider.js";
-import type { InjectorService } from "../services/InjectorService.js";
-import type { ResolvedInvokeOptions } from "./ResolvedInvokeOptions.js";
-/**
- * @ignore
- */
-export interface RegistrySettings {
-    injectable?: boolean;
-    model?: Type<Provider>;
-    /**
-     *
-     * @param provider
-     * @param {Map<string | Function, any>} locals
-     * @param options
-     */
-    onInvoke?(provider: Provider, locals: Map<string | Function, any>, options: ResolvedInvokeOptions & {
-        injector: InjectorService;
-    }): void;
-}

package/lib/types-esm/common/interfaces/ResolvedInvokeOptions.d.ts

@@ -1,12 +0,0 @@
-import type { Provider } from "../domain/Provider.js";
-import type { ProviderScope } from "../domain/ProviderScope.js";
-import type { TokenProvider } from "./TokenProvider.js";
-export interface ResolvedInvokeOptions {
-    token: TokenProvider;
-    parent?: TokenProvider;
-    scope: ProviderScope;
-    deps: TokenProvider[];
-    imports: TokenProvider[];
-    provider: Provider;
-    construct(deps: TokenProvider[]): any;
-}

package/lib/types-esm/common/interfaces/TokenProvider.d.ts

@@ -1,6 +0,0 @@
-import type { Type } from "@tsed/core";
-export type TokenProvider<T = any> = string | symbol | Type<T> | Function | any;
-export interface TokenProviderOpts {
-    token?: TokenProvider;
-    use: any;
-}

package/lib/types-esm/common/interfaces/TokenRoute.d.ts

@@ -1,5 +0,0 @@
-import { TokenProvider } from "./TokenProvider.js";
-export interface TokenRoute {
-    token: TokenProvider;
-    route: string;
-}

package/lib/types-esm/common/registries/GlobalProviders.d.ts

@@ -1,58 +0,0 @@
-import { Type } from "@tsed/core";
-import type { LocalsContainer } from "../domain/LocalsContainer.js";
-import { Provider } from "../domain/Provider.js";
-import { ProviderOpts } from "../interfaces/ProviderOpts.js";
-import { RegistrySettings } from "../interfaces/RegistrySettings.js";
-import { ResolvedInvokeOptions } from "../interfaces/ResolvedInvokeOptions.js";
-import { TokenProvider } from "../interfaces/TokenProvider.js";
-import type { InjectorService } from "../services/InjectorService.js";
-export declare class GlobalProviderRegistry extends Map<TokenProvider, Provider> {
-    #private;
-    /**
-     * The get() method returns a specified element from a Map object.
-     * @param key Required. The key of the element to return from the Map object.
-     * @returns {T} Returns the element associated with the specified key or undefined if the key can't be found in the Map object.
-     */
-    get(key: TokenProvider): Provider | undefined;
-    /**
-     * The has() method returns a boolean indicating whether an element with the specified key exists or not.
-     * @param key
-     * @returns {boolean}
-     */
-    has(key: TokenProvider): boolean;
-    /**
-     * The set() method adds or updates an element with a specified key and value to a Map object.
-     * @param key Required. The key of the element to add to the Map object.
-     * @param metadata Required. The value of the element to add to the Map object.
-     */
-    set(key: TokenProvider, metadata: Provider): this;
-    /**
-     *
-     * @param target
-     * @param options
-     */
-    merge(target: TokenProvider, options: Partial<ProviderOpts>): Provider<any>;
-    /**
-     * The delete() method removes the specified element from a Map object.
-     * @param key Required. The key of the element to remove from the Map object.
-     * @returns {boolean} Returns true if an element in the Map object existed and has been removed, or false if the element does not exist.
-     */
-    delete(key: TokenProvider): boolean;
-    createRegistry(type: string, model: Type<Provider>, options?: Partial<RegistrySettings>): this;
-    onInvoke(provider: Provider, locals: LocalsContainer, options: ResolvedInvokeOptions & {
-        injector: InjectorService;
-    }): void;
-    getRegistrySettings(target: string | TokenProvider): RegistrySettings;
-    createRegisterFn(type: string): (provider: any | ProviderOpts, instance?: any) => void;
-    /**
-     *
-     * @param key
-     * @param options
-     */
-    protected createIfNotExists(key: TokenProvider, options: Partial<ProviderOpts>): Provider;
-}
-/**
- *
- * @type {GlobalProviders}
- */
-export declare const GlobalProviders: GlobalProviderRegistry;

package/lib/types-esm/common/registries/ProviderRegistry.d.ts

@@ -1,58 +0,0 @@
-import { Provider } from "../domain/Provider.js";
-import type { ProviderOpts } from "../interfaces/ProviderOpts.js";
-/**
- * Register a provider configuration.
- * @param {ProviderOpts<any>} provider
- */
-export declare function registerProvider<Type = any>(provider: Partial<ProviderOpts<Type>>): Provider<any>;
-/**
- * Add a new value in the `ProviderRegistry`.
- *
- * #### Example with symbol definition
- *
- *
- * ```typescript
- * import {registerValue, InjectorService} from "@tsed/di";
- *
- * const MyValue = Symbol.from("MyValue")
- *
- * registerValue({token: MyValue, useValue: "myValue"});
- *
- * @Service()
- * export class OtherService {
- *      constructor(@Inject(MyValue) myValue: string){
- *          console.log(myValue); /// "myValue"
- *      }
- * }
- * ```
- */
-export declare const registerValue: (provider: any | ProviderOpts<any>, value?: any) => void;
-/**
- * Add a new controller in the `ProviderRegistry`. This controller will be built when `InjectorService` will be loaded.
- *
- * #### Example
- *
- * ```typescript
- * import {registerController, InjectorService} from "@tsed/di";
- *
- * export default class MyController {
- *     constructor(){}
- *     transform() {
- *         return "test";
- *     }
- * }
- *
- * registerController({provide: MyController});
- * // or
- * registerController(MyController);
- *
- * const injector = new InjectorService();
- * injector.load();
- *
- * const myController = injector.get<MyController>(MyController);
- * myController.getFoo(); // test
- * ```
- *
- * @param provider Provider configuration.
- */
-export declare const registerController: (provider: any, instance?: any) => void;

package/lib/types-esm/common/services/DIConfiguration.d.ts

@@ -1,57 +0,0 @@
-import { Env } from "@tsed/core";
-import type { ProviderScope } from "../domain/ProviderScope.js";
-import type { DILoggerOptions } from "../interfaces/DILoggerOptions.js";
-import type { DIResolver } from "../interfaces/DIResolver.js";
-import type { ImportTokenProviderOpts } from "../interfaces/ImportTokenProviderOpts.js";
-import type { TokenProvider } from "../interfaces/TokenProvider.js";
-import type { TokenRoute } from "../interfaces/TokenRoute.js";
-export declare class DIConfiguration {
-    readonly default: Map<string, any>;
-    protected map: Map<string, any>;
-    constructor(initialProps?: {});
-    get version(): string;
-    set version(v: string);
-    get rootDir(): string;
-    set rootDir(value: string);
-    get env(): Env;
-    set env(value: Env);
-    get scopes(): Record<string, ProviderScope>;
-    set scopes(value: Record<string, ProviderScope>);
-    get resolvers(): DIResolver[];
-    set resolvers(resolvers: DIResolver[]);
-    get imports(): (TokenProvider | ImportTokenProviderOpts)[];
-    set imports(imports: (TokenProvider | ImportTokenProviderOpts)[]);
-    get routes(): TokenRoute[];
-    set routes(routes: TokenRoute[]);
-    get logger(): Partial<DILoggerOptions>;
-    set logger(value: Partial<DILoggerOptions>);
-    get debug(): boolean;
-    set debug(debug: boolean);
-    /**
-     *
-     * @param callbackfn
-     * @param thisArg
-     */
-    forEach(callbackfn: (value: any, index: string, map: Map<string, any>) => void, thisArg?: any): void;
-    /**
-     *
-     * @param propertyKey
-     * @param value
-     */
-    set(propertyKey: string | Partial<TsED.Configuration>, value?: any): this;
-    setRaw(propertyKey: string, value: any): this;
-    /**
-     *
-     * @param propertyKey
-     * @param defaultValue
-     * @returns {undefined|any}
-     */
-    get<T = any>(propertyKey: string, defaultValue?: T): T;
-    /**
-     *
-     * @param value
-     * @returns {any}
-     */
-    resolve(value: any): any;
-    protected getRaw(propertyKey: string, defaultValue?: any): any;
-}

package/lib/types-esm/common/services/DILogger.d.ts

@@ -1,3 +0,0 @@
-import { DILogger } from "../interfaces/DILogger.js";
-export declare const LOGGER: unique symbol;
-export type LOGGER = DILogger;