@tsed/di 7.83.0 → 8.0.0-alpha.2

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

@@ -1,10 +1,8 @@
-import { type Type } from "@tsed/core";
 import { Container } from "../domain/Container.js";
 import { LocalsContainer } from "../domain/LocalsContainer.js";
 import { Provider } from "../domain/Provider.js";
 import { ProviderScope } from "../domain/ProviderScope.js";
 import type { DILogger } from "../interfaces/DILogger.js";
-import { InjectablePropertyOptions, InjectablePropertyValue } from "../interfaces/InjectableProperties.js";
 import type { InvokeOptions } from "../interfaces/InvokeOptions.js";
 import type { TokenProvider } from "../interfaces/TokenProvider.js";
 import { DIConfiguration } from "./DIConfiguration.js";
@@ -37,8 +35,18 @@ export declare class InjectorService extends Container {
     constructor();
     get resolvers(): import("../index.js").DIResolver[];
     get scopes(): Record<string, ProviderScope>;
-    static resolveAutoInjectableArgs(token: Type, locals: LocalsContainer, args: unknown[]): any[];
-    static bind(instance: any, locals: LocalsContainer): void;
+    /**
+     * Return the current injector service.
+     */
+    static getInstance(): InjectorService;
+    /**
+     * Get the locals container initiated by DITest or .bootstrap() method.
+     */
+    static getLocals(): LocalsContainer;
+    /**
+     * Reset the locals container.
+     */
+    static unsetLocals(): void;
     /**
      * Retrieve default scope for a given provider.
      * @param provider
@@ -66,22 +74,19 @@ export declare class InjectorService extends Container {
      *
      * @param token The class or symbol registered in InjectorService.
      * @param options
-     * @returns {boolean}
      */
-    get<T = any>(token: TokenProvider<T>, options?: any): T | undefined;
+    get<T = any>(token: TokenProvider<T>, options?: Record<string, unknown>): T | undefined;
     /**
      * Return all instance of the same provider type
-     * @param type
-     * @param locals
-     * @param options
      */
     getMany<Type = any>(type: any, locals?: LocalsContainer, options?: Partial<InvokeOptions>): Type[];
     /**
      * The has() method returns a boolean indicating whether an element with the specified key exists or not.
-     * @returns {boolean}
-     * @param token
      */
     has(token: TokenProvider): boolean;
+    /**
+     * Declare an alias for a given token.
+     */
     alias(token: TokenProvider, alias: TokenProvider): this;
     /**
      * Invoke the class and inject all services that required by the class constructor.
@@ -104,11 +109,14 @@ export declare class InjectorService extends Container {
      * @param options
      * @returns {Type} The class constructed.
      */
-    invoke<Type = any>(token: TokenProvider, locals?: LocalsContainer, options?: Partial<InvokeOptions>): Type;
+    invoke<Type = any>(token: TokenProvider<Type>, locals?: LocalsContainer, options?: Partial<InvokeOptions>): Type;
     /**
      * Build only providers which are asynchronous.
      */
     loadAsync(): Promise<void>;
+    /**
+     * Build only providers which are synchronous.
+     */
     loadSync(): void;
     /**
      * Boostrap injector from container and resolve configuration.
@@ -131,68 +139,36 @@ export declare class InjectorService extends Container {
      * Load all configurations registered on providers
      */
     resolveConfiguration(): void;
-    /**
-     *
-     * @param instance
-     * @param locals
-     * @param options
-     */
-    bindInjectableProperties(instance: any, locals: LocalsContainer, options: Partial<InvokeOptions>): void;
-    /**
-     * Create an injectable property.
-     *
-     * @param instance
-     * @param {string} propertyKey
-     * @param {any} useType
-     * @param resolver
-     * @param options
-     * @param locals
-     * @param invokeOptions
-     */
-    bindProperty(instance: any, { propertyKey, resolver, options }: InjectablePropertyOptions, locals: LocalsContainer, invokeOptions: Partial<InvokeOptions>): void;
-    /**
-     *
-     * @param instance
-     * @param {string} propertyKey
-     * @param {any} useType
-     */
-    bindValue(instance: any, { propertyKey, expression, defaultValue }: InjectablePropertyValue): void;
-    /**
-     *
-     * @param instance
-     * @param {string} propertyKey
-     * @param {any} useType
-     */
-    bindConstant(instance: any, { propertyKey, expression, defaultValue }: InjectablePropertyValue): void;
-    /**
-     *
-     * @param instance
-     * @param propertyKey
-     * @param useType
-     * @param options
-     */
-    bindInterceptor(instance: any, { propertyKey, useType, options }: InjectablePropertyOptions): void;
     lazyInvoke<T = any>(token: TokenProvider): Promise<any>;
     /**
      * Emit an event to all service. See service [lifecycle hooks](/docs/services.md#lifecycle-hooks).
      * @param eventName The event name to emit at all services.
      * @param args List of the parameters to give to each service.
-     * @returns {Promise<any[]>} A list of promises.
+     * @returns A list of promises.
      */
     emit(eventName: string, ...args: any[]): Promise<void>;
     /**
+     * Alter value attached to an event.
      * @param eventName
      * @param value
      * @param args
      */
     alter<T = any>(eventName: string, value: any, ...args: any[]): T;
     /**
+     * Alter value attached to an event asynchronously.
      * @param eventName
      * @param value
      * @param args
      */
     alterAsync<T = any>(eventName: string, value: any, ...args: any[]): Promise<T>;
+    /**
+     * Destroy the injector and all services.
+     */
     destroy(): Promise<void>;
+    /**
+     * Ensure that a provider is added to the container.
+     * @protected
+     */
     protected ensureProvider(token: TokenProvider, force: true): Provider;
     protected ensureProvider(token: TokenProvider, force: false): Provider | undefined;
     protected ensureProvider(token: TokenProvider): Provider | undefined;

package/lib/types-esm/node/services/DITest.d.ts

@@ -25,7 +25,7 @@ export declare class DITest {
      * @param target
      * @param providers
      */
-    static invoke<T = any>(target: TokenProvider, providers?: UseImportTokenProviderOpts[]): Promise<T>;
+    static invoke<T = any>(target: TokenProvider<T>, providers?: UseImportTokenProviderOpts[]): Promise<T>;
     /**
      * Return the instance from injector registry
      * @param target

package/package.json

@@ -2,7 +2,7 @@
   "name": "@tsed/di",
   "description": "DI module for Ts.ED Framework",
   "type": "commonjs",
-  "version": "7.83.0",
+  "version": "8.0.0-alpha.2",
   "source": "./src/index.ts",
   "main": "lib/esm/index.js",
   "module": "lib/esm/index.js",
@@ -26,14 +26,15 @@
     "test:ci": "vitest run --coverage.thresholds.autoUpdate=true"
   },
   "dependencies": {
-    "tslib": "2.6.2"
+    "tslib": "2.6.2",
+    "uuid": "9.0.1"
   },
   "devDependencies": {
-    "@tsed/barrels": "7.83.0",
-    "@tsed/core": "7.83.0",
+    "@tsed/barrels": "8.0.0-alpha.2",
+    "@tsed/core": "8.0.0-alpha.2",
     "@tsed/logger": ">=6.7.5",
-    "@tsed/schema": "7.83.0",
-    "@tsed/typescript": "7.83.0",
+    "@tsed/schema": "8.0.0-alpha.2",
+    "@tsed/typescript": "8.0.0-alpha.2",
     "cross-env": "7.0.3",
     "eslint": "^8.57.0",
     "typescript": "4.9.5",
@@ -41,9 +42,9 @@
     "webpack": "^5.75.0"
   },
   "peerDependencies": {
-    "@tsed/core": "7.83.0",
+    "@tsed/core": "8.0.0-alpha.2",
     "@tsed/logger": ">=6.7.5",
-    "@tsed/schema": "7.83.0"
+    "@tsed/schema": "8.0.0-alpha.2"
   },
   "peerDependenciesMeta": {
     "@tsed/core": {
@@ -62,5 +63,8 @@
   },
   "homepage": "https://github.com/tsedio/tsed/tree/production/packages/di",
   "author": "Romain Lenzotti",
-  "license": "MIT"
+  "license": "MIT",
+  "publishConfig": {
+    "tag": "alpha"
+  }
 }

package/vitest.config.mts

@@ -10,12 +10,12 @@ export default defineConfig(
       coverage: {
         ...presets.test.coverage,
         thresholds: {
-          statements: 98.92,
-          branches: 97.36,
-          functions: 99.08,
-          lines: 98.92
+          statements: 98.75,
+          branches: 97.2,
+          functions: 98.67,
+          lines: 98.75
         }
       }
     }
   }
-);
+);

package/lib/cjs/common/errors/UndefinedTokenError.js

@@ -1,11 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.UndefinedTokenError = void 0;
-class UndefinedTokenError extends Error {
-    constructor() {
-        super("Given token is undefined. Have you enabled emitDecoratorMetadata in your tsconfig.json or decorated your class with @Injectable, @Service, ... decorator ?");
-        this.name = "UNDEFINED_TOKEN_ERROR";
-    }
-}
-exports.UndefinedTokenError = UndefinedTokenError;
-//# sourceMappingURL=UndefinedTokenError.js.map

package/lib/cjs/common/errors/UndefinedTokenError.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"UndefinedTokenError.js","sourceRoot":"","sources":["../../../../src/common/errors/UndefinedTokenError.ts"],"names":[],"mappings":";;;AAAA,MAAa,mBAAoB,SAAQ,KAAK;IAG5C;QACE,KAAK,CACH,4JAA4J,CAC7J,CAAC;QALJ,SAAI,GAAG,uBAAuB,CAAC;IAM/B,CAAC;CACF;AARD,kDAQC"}

package/lib/cjs/common/interfaces/InjectableProperties.js

@@ -1,3 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=InjectableProperties.js.map

package/lib/cjs/common/interfaces/InjectableProperties.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"InjectableProperties.js","sourceRoot":"","sources":["../../../../src/common/interfaces/InjectableProperties.ts"],"names":[],"mappings":""}

package/lib/esm/common/errors/UndefinedTokenError.js

@@ -1,7 +0,0 @@
-export class UndefinedTokenError extends Error {
-    constructor() {
-        super("Given token is undefined. Have you enabled emitDecoratorMetadata in your tsconfig.json or decorated your class with @Injectable, @Service, ... decorator ?");
-        this.name = "UNDEFINED_TOKEN_ERROR";
-    }
-}
-//# sourceMappingURL=UndefinedTokenError.js.map

package/lib/esm/common/errors/UndefinedTokenError.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"UndefinedTokenError.js","sourceRoot":"","sources":["../../../../src/common/errors/UndefinedTokenError.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IAG5C;QACE,KAAK,CACH,4JAA4J,CAC7J,CAAC;QALJ,SAAI,GAAG,uBAAuB,CAAC;IAM/B,CAAC;CACF"}

package/lib/esm/common/interfaces/InjectableProperties.js

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=InjectableProperties.js.map

package/lib/esm/common/interfaces/InjectableProperties.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"InjectableProperties.js","sourceRoot":"","sources":["../../../../src/common/interfaces/InjectableProperties.ts"],"names":[],"mappings":""}

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

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

package/lib/types/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/errors/UndefinedTokenError.d.ts

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

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;
-}