@navios/di 0.4.0 → 0.4.2

package/lib/_tsup-dts-rollup.d.mts

@@ -150,6 +150,9 @@ export { ClassTypeWithOptionalArgument as ClassTypeWithOptionalArgument_alias_1
  * It wraps a ServiceLocator instance and provides convenient methods for getting instances.
  */
 declare class Container {
+    protected readonly registry: Registry;
+    protected readonly logger: Console | null;
+    protected readonly injectors: Injectors;
     private readonly serviceLocator;
     constructor(registry?: Registry, logger?: Console | null, injectors?: Injectors);
     private registerSelf;
@@ -198,6 +201,11 @@ declare class Container {
      * @param requestId The request ID to set as current
      */
     setCurrentRequestContext(requestId: string): void;
+    /**
+     * Clears all instances and bindings from the container.
+     * This is useful for testing or resetting the container state.
+     */
+    clear(): void;
 }
 export { Container }
 export { Container as Container_alias_1 }
@@ -309,17 +317,17 @@ export { ErrorsEnum as ErrorsEnum_alias_2 }
 
 declare class EventEmitter<Events extends EventsConfig = {}> implements EventEmitterInterface<Events> {
     private listeners;
-    on<E extends EventsNames<Events>, Args extends EventsArgs<Events, E>>(event: E, listener: (...args: Args) => void): () => void;
-    off<E extends EventsNames<Events>, Args extends EventsArgs<Events, E>>(event: E, listener: (...args: Args) => void): void;
-    once<E extends EventsNames<Events>, Args extends EventsArgs<Events, E>>(event: E, listener: (...args: Args) => void): () => void;
+    on<E extends EventsNames<Events>, Args extends EventsArgs<Events, E>>(event: E, listener: (...args: Args) => void | Promise<void>): () => void;
+    off<E extends EventsNames<Events>, Args extends EventsArgs<Events, E>>(event: E, listener: (...args: Args) => void | Promise<void>): void;
+    once<E extends EventsNames<Events>, Args extends EventsArgs<Events, E>>(event: E, listener: (...args: Args) => void | Promise<void>): () => void;
     emit<E extends EventsNames<Events>, Args extends EventsArgs<Events, E>>(event: E, ...args: Args): Promise<any>;
 }
 export { EventEmitter }
 export { EventEmitter as EventEmitter_alias_1 }
 
 declare interface EventEmitterInterface<Events extends EventsConfig> {
-    on<E extends EventsNames<Events>, Args extends EventsArgs<Events, E>>(event: E, listener: (...args: Args) => void): () => void;
-    emit<E extends EventsNames<Events>, Args extends EventsArgs<Events, E>>(event: E, ...args: Args): void;
+    on<E extends EventsNames<Events>, Args extends EventsArgs<Events, E>>(event: E, listener: (...args: Args) => void | Promise<void>): () => void;
+    emit<E extends EventsNames<Events>, Args extends EventsArgs<Events, E>>(event: E, ...args: Args): void | Promise<void>;
 }
 export { EventEmitterInterface }
 export { EventEmitterInterface as EventEmitterInterface_alias_1 }
@@ -1017,6 +1025,70 @@ export declare const test4: {
 
 export declare const test5: object;
 
+/**
+ * A binding builder for the TestContainer that allows chaining binding operations.
+ */
+declare class TestBindingBuilder<T> {
+    private readonly container;
+    private readonly token;
+    constructor(container: TestContainer, token: InjectionToken<T, any>);
+    /**
+     * Binds the token to a specific value.
+     * This is useful for testing with mock values or constants.
+     * @param value The value to bind to the token
+     */
+    toValue(value: T): TestContainer;
+    /**
+     * Binds the token to a class constructor.
+     * @param target The class constructor to bind to
+     */
+    toClass(target: ClassType): TestContainer;
+}
+export { TestBindingBuilder }
+export { TestBindingBuilder as TestBindingBuilder_alias_1 }
+
+/**
+ * TestContainer extends the base Container with additional methods useful for testing.
+ * It provides a simplified API for binding values and classes during test setup.
+ */
+declare class TestContainer extends Container {
+    constructor(registry?: Registry, logger?: Console | null, injectors?: Injectors);
+    /**
+     * Creates a binding builder for the given token.
+     * This allows chaining binding operations like bind(Token).toValue(value).
+     * @param token The injection token to bind
+     * @returns A TestBindingBuilder for chaining binding operations
+     */
+    bind<T>(token: ClassType): TestBindingBuilder<T>;
+    bind<T>(token: InjectionToken<T, any>): TestBindingBuilder<T>;
+    /**
+     * Binds a value directly to a token.
+     * This is a convenience method equivalent to bind(token).toValue(value).
+     * @param token The injection token to bind
+     * @param value The value to bind to the token
+     * @returns The TestContainer instance for chaining
+     */
+    bindValue<T>(token: ClassType, value: T): TestContainer;
+    bindValue<T>(token: InjectionToken<T, any>, value: T): TestContainer;
+    /**
+     * Binds a class to a token.
+     * This is a convenience method equivalent to bind(token).toClass(target).
+     * @param token The injection token to bind
+     * @param target The class constructor to bind to
+     * @returns The TestContainer instance for chaining
+     */
+    bindClass(token: ClassType, target: ClassType): TestContainer;
+    bindClass<T>(token: InjectionToken<T, any>, target: ClassType): TestContainer;
+    /**
+     * Creates a new TestContainer instance with the same configuration.
+     * This is useful for creating isolated test containers.
+     * @returns A new TestContainer instance
+     */
+    createChild(): TestContainer;
+}
+export { TestContainer }
+export { TestContainer as TestContainer_alias_1 }
+
 declare type UnionToArray<T, A extends unknown[] = []> = IsUnion<T> extends true ? UnionToArray<Exclude<T, PopUnion<T>>, [PopUnion<T>, ...A]> : [T, ...A];
 export { UnionToArray }
 export { UnionToArray as UnionToArray_alias_1 }

package/lib/_tsup-dts-rollup.d.ts

@@ -150,6 +150,9 @@ export { ClassTypeWithOptionalArgument as ClassTypeWithOptionalArgument_alias_1
  * It wraps a ServiceLocator instance and provides convenient methods for getting instances.
  */
 declare class Container {
+    protected readonly registry: Registry;
+    protected readonly logger: Console | null;
+    protected readonly injectors: Injectors;
     private readonly serviceLocator;
     constructor(registry?: Registry, logger?: Console | null, injectors?: Injectors);
     private registerSelf;
@@ -198,6 +201,11 @@ declare class Container {
      * @param requestId The request ID to set as current
      */
     setCurrentRequestContext(requestId: string): void;
+    /**
+     * Clears all instances and bindings from the container.
+     * This is useful for testing or resetting the container state.
+     */
+    clear(): void;
 }
 export { Container }
 export { Container as Container_alias_1 }
@@ -309,17 +317,17 @@ export { ErrorsEnum as ErrorsEnum_alias_2 }
 
 declare class EventEmitter<Events extends EventsConfig = {}> implements EventEmitterInterface<Events> {
     private listeners;
-    on<E extends EventsNames<Events>, Args extends EventsArgs<Events, E>>(event: E, listener: (...args: Args) => void): () => void;
-    off<E extends EventsNames<Events>, Args extends EventsArgs<Events, E>>(event: E, listener: (...args: Args) => void): void;
-    once<E extends EventsNames<Events>, Args extends EventsArgs<Events, E>>(event: E, listener: (...args: Args) => void): () => void;
+    on<E extends EventsNames<Events>, Args extends EventsArgs<Events, E>>(event: E, listener: (...args: Args) => void | Promise<void>): () => void;
+    off<E extends EventsNames<Events>, Args extends EventsArgs<Events, E>>(event: E, listener: (...args: Args) => void | Promise<void>): void;
+    once<E extends EventsNames<Events>, Args extends EventsArgs<Events, E>>(event: E, listener: (...args: Args) => void | Promise<void>): () => void;
     emit<E extends EventsNames<Events>, Args extends EventsArgs<Events, E>>(event: E, ...args: Args): Promise<any>;
 }
 export { EventEmitter }
 export { EventEmitter as EventEmitter_alias_1 }
 
 declare interface EventEmitterInterface<Events extends EventsConfig> {
-    on<E extends EventsNames<Events>, Args extends EventsArgs<Events, E>>(event: E, listener: (...args: Args) => void): () => void;
-    emit<E extends EventsNames<Events>, Args extends EventsArgs<Events, E>>(event: E, ...args: Args): void;
+    on<E extends EventsNames<Events>, Args extends EventsArgs<Events, E>>(event: E, listener: (...args: Args) => void | Promise<void>): () => void;
+    emit<E extends EventsNames<Events>, Args extends EventsArgs<Events, E>>(event: E, ...args: Args): void | Promise<void>;
 }
 export { EventEmitterInterface }
 export { EventEmitterInterface as EventEmitterInterface_alias_1 }
@@ -1017,6 +1025,70 @@ export declare const test4: {
 
 export declare const test5: object;
 
+/**
+ * A binding builder for the TestContainer that allows chaining binding operations.
+ */
+declare class TestBindingBuilder<T> {
+    private readonly container;
+    private readonly token;
+    constructor(container: TestContainer, token: InjectionToken<T, any>);
+    /**
+     * Binds the token to a specific value.
+     * This is useful for testing with mock values or constants.
+     * @param value The value to bind to the token
+     */
+    toValue(value: T): TestContainer;
+    /**
+     * Binds the token to a class constructor.
+     * @param target The class constructor to bind to
+     */
+    toClass(target: ClassType): TestContainer;
+}
+export { TestBindingBuilder }
+export { TestBindingBuilder as TestBindingBuilder_alias_1 }
+
+/**
+ * TestContainer extends the base Container with additional methods useful for testing.
+ * It provides a simplified API for binding values and classes during test setup.
+ */
+declare class TestContainer extends Container {
+    constructor(registry?: Registry, logger?: Console | null, injectors?: Injectors);
+    /**
+     * Creates a binding builder for the given token.
+     * This allows chaining binding operations like bind(Token).toValue(value).
+     * @param token The injection token to bind
+     * @returns A TestBindingBuilder for chaining binding operations
+     */
+    bind<T>(token: ClassType): TestBindingBuilder<T>;
+    bind<T>(token: InjectionToken<T, any>): TestBindingBuilder<T>;
+    /**
+     * Binds a value directly to a token.
+     * This is a convenience method equivalent to bind(token).toValue(value).
+     * @param token The injection token to bind
+     * @param value The value to bind to the token
+     * @returns The TestContainer instance for chaining
+     */
+    bindValue<T>(token: ClassType, value: T): TestContainer;
+    bindValue<T>(token: InjectionToken<T, any>, value: T): TestContainer;
+    /**
+     * Binds a class to a token.
+     * This is a convenience method equivalent to bind(token).toClass(target).
+     * @param token The injection token to bind
+     * @param target The class constructor to bind to
+     * @returns The TestContainer instance for chaining
+     */
+    bindClass(token: ClassType, target: ClassType): TestContainer;
+    bindClass<T>(token: InjectionToken<T, any>, target: ClassType): TestContainer;
+    /**
+     * Creates a new TestContainer instance with the same configuration.
+     * This is useful for creating isolated test containers.
+     * @returns A new TestContainer instance
+     */
+    createChild(): TestContainer;
+}
+export { TestContainer }
+export { TestContainer as TestContainer_alias_1 }
+
 declare type UnionToArray<T, A extends unknown[] = []> = IsUnion<T> extends true ? UnionToArray<Exclude<T, PopUnion<T>>, [PopUnion<T>, ...A]> : [T, ...A];
 export { UnionToArray }
 export { UnionToArray as UnionToArray_alias_1 }