@navios/di 0.3.1 → 0.4.1

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

@@ -16,6 +16,93 @@ declare type BaseInjectionTokenSchemaType = ZodObject | ZodRecord;
 export { BaseInjectionTokenSchemaType }
 export { BaseInjectionTokenSchemaType as BaseInjectionTokenSchemaType_alias_1 }
 
+/**
+ * Abstract base class that provides common functionality for managing ServiceLocatorInstanceHolder objects.
+ * This class contains shared patterns used by both RequestContextHolder and ServiceLocatorManager.
+ */
+declare abstract class BaseInstanceHolderManager {
+    protected readonly logger: Console | null;
+    protected readonly _holders: Map<string, ServiceLocatorInstanceHolder>;
+    constructor(logger?: Console | null);
+    /**
+     * Protected getter for accessing the holders map from subclasses.
+     */
+    protected get holders(): Map<string, ServiceLocatorInstanceHolder>;
+    /**
+     * Abstract method to get a holder by name. Each implementation defines its own return type
+     * based on their specific error handling and validation needs.
+     */
+    abstract get(name: string): any;
+    /**
+     * Abstract method to set a holder by name. Each implementation may have different validation logic.
+     */
+    abstract set(name: string, holder: ServiceLocatorInstanceHolder): void;
+    /**
+     * Abstract method to check if a holder exists. Each implementation may have different validation logic.
+     */
+    abstract has(name: string): any;
+    /**
+     * Deletes a holder by name.
+     * @param name The name of the holder to delete
+     * @returns true if the holder was deleted, false if it didn't exist
+     */
+    delete(name: string): boolean;
+    /**
+     * Filters holders based on a predicate function.
+     * @param predicate Function to test each holder
+     * @returns A new Map containing only the holders that match the predicate
+     */
+    filter(predicate: (value: ServiceLocatorInstanceHolder<any>, key: string) => boolean): Map<string, ServiceLocatorInstanceHolder>;
+    /**
+     * Clears all holders from this manager.
+     */
+    clear(): void;
+    /**
+     * Gets the number of holders currently managed.
+     */
+    size(): number;
+    /**
+     * Creates a new holder with Creating status and a deferred creation promise.
+     * This is useful for creating placeholder holders that can be fulfilled later.
+     * @param name The name of the instance
+     * @param type The injectable type
+     * @param scope The injectable scope
+     * @param deps Optional set of dependencies
+     * @param ttl Optional time-to-live in milliseconds (defaults to Infinity)
+     * @returns A tuple containing the deferred promise and the holder
+     */
+    createCreatingHolder<Instance>(name: string, type: InjectableType, scope: InjectableScope, deps?: Set<string>, ttl?: number): [
+    ReturnType<typeof createDeferred<[undefined, Instance]>>,
+    ServiceLocatorInstanceHolder<Instance>
+    ];
+    /**
+     * Creates a new holder with Created status and an actual instance.
+     * This is useful for creating holders that already have their instance ready.
+     * @param name The name of the instance
+     * @param instance The actual instance to store
+     * @param type The injectable type
+     * @param scope The injectable scope
+     * @param deps Optional set of dependencies
+     * @param ttl Optional time-to-live in milliseconds (defaults to Infinity)
+     * @returns The created holder
+     */
+    protected createCreatedHolder<Instance>(name: string, instance: Instance, type: InjectableType, scope: InjectableScope, deps?: Set<string>, ttl?: number): ServiceLocatorInstanceHolder<Instance>;
+    /**
+     * Gets all holder names currently managed.
+     */
+    getAllNames(): string[];
+    /**
+     * Gets all holders currently managed.
+     */
+    getAllHolders(): ServiceLocatorInstanceHolder[];
+    /**
+     * Checks if this manager has any holders.
+     */
+    isEmpty(): boolean;
+}
+export { BaseInstanceHolderManager }
+export { BaseInstanceHolderManager as BaseInstanceHolderManager_alias_1 }
+
 declare class BoundInjectionToken<T, S extends InjectionTokenSchemaType> {
     readonly token: InjectionToken<T, S>;
     readonly value: z.input<S>;
@@ -138,18 +225,29 @@ export { defaultInjectors as defaultInjectors_alias_1 }
 /**
  * Default implementation of RequestContextHolder.
  */
-declare class DefaultRequestContextHolder implements RequestContextHolder {
+declare class DefaultRequestContextHolder extends BaseInstanceHolderManager implements RequestContextHolder {
     readonly requestId: string;
     readonly priority: number;
-    readonly instances: Map<string, any>;
-    readonly holders: Map<string, ServiceLocatorInstanceHolder>;
     readonly metadata: Map<string, any>;
     readonly createdAt: number;
     constructor(requestId: string, priority?: number, initialMetadata?: Record<string, any>);
+    /**
+     * Public getter for holders to maintain interface compatibility.
+     */
+    get holders(): Map<string, ServiceLocatorInstanceHolder>;
+    /**
+     * Gets a holder by name. For RequestContextHolder, this is a simple lookup.
+     */
+    get(name: string): ServiceLocatorInstanceHolder | undefined;
+    /**
+     * Sets a holder by name.
+     */
+    set(name: string, holder: ServiceLocatorInstanceHolder): void;
+    /**
+     * Checks if a holder exists by name.
+     */
+    has(name: string): boolean;
     addInstance(instanceName: string | InjectionToken<any, undefined>, instance: any, holder?: ServiceLocatorInstanceHolder): void;
-    getInstance(instanceName: string): any | undefined;
-    getHolder(instanceName: string): ServiceLocatorInstanceHolder | undefined;
-    hasInstance(instanceName: string): boolean;
     clear(): void;
     getMetadata(key: string): any | undefined;
     setMetadata(key: string, value: any): void;
@@ -211,17 +309,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 }
@@ -555,10 +653,6 @@ declare interface RequestContextHolder {
      * Unique identifier for this request context.
      */
     readonly requestId: string;
-    /**
-     * Pre-prepared instances for this request, keyed by instance name.
-     */
-    readonly instances: Map<string, any>;
     /**
      * Instance holders for request-scoped services.
      */
@@ -584,18 +678,14 @@ declare interface RequestContextHolder {
      * Adds a pre-prepared instance to this context.
      */
     addInstance(token: InjectionToken<any, undefined>, instance: any): void;
-    /**
-     * Gets a pre-prepared instance from this context.
-     */
-    getInstance(instanceName: string): any | undefined;
     /**
      * Gets an instance holder from this context.
      */
-    getHolder(instanceName: string): ServiceLocatorInstanceHolder | undefined;
+    get(instanceName: string): ServiceLocatorInstanceHolder | undefined;
     /**
      * Checks if this context has a pre-prepared instance.
      */
-    hasInstance(instanceName: string): boolean;
+    has(instanceName: string): boolean;
     /**
      * Clears all instances and holders from this context.
      */
@@ -608,6 +698,22 @@ declare interface RequestContextHolder {
      * Sets metadata value by key.
      */
     setMetadata(key: string, value: any): void;
+    /**
+     * Filters holders based on a predicate function.
+     */
+    filter(predicate: (value: ServiceLocatorInstanceHolder<any>, key: string) => boolean): Map<string, ServiceLocatorInstanceHolder>;
+    /**
+     * Deletes a holder by name.
+     */
+    delete(name: string): boolean;
+    /**
+     * Gets the number of holders currently managed.
+     */
+    size(): number;
+    /**
+     * Checks if this manager has any holders.
+     */
+    isEmpty(): boolean;
 }
 export { RequestContextHolder }
 export { RequestContextHolder as RequestContextHolder_alias_1 }
@@ -668,7 +774,19 @@ declare class ServiceLocator {
     getOrThrowInstance<Instance>(token: AnyInjectableType, args: any): Promise<Instance>;
     getSyncInstance<Instance, Schema extends InjectionTokenSchemaType | undefined>(token: AnyInjectableType, args: Schema extends ZodObject ? z.input<Schema> : Schema extends ZodOptional<ZodObject> ? z.input<Schema> | undefined : undefined): Instance | null;
     invalidate(service: string, round?: number): Promise<any>;
-    ready(): Promise<null>;
+    /**
+     * Invalidates a single holder based on its current status.
+     */
+    private invalidateHolder;
+    /**
+     * Destroys a holder and cleans up its resources.
+     */
+    private destroyHolder;
+    ready(): Promise<void>;
+    /**
+     * Waits for a holder to settle (either created, destroyed, or error state).
+     */
+    private waitForHolderToSettle;
     /**
      * Begins a new request context with the given parameters.
      * @param requestId Unique identifier for this request
@@ -705,6 +823,23 @@ declare class ServiceLocator {
      * Gets an instance by its instance name, handling all the logic after instance name creation.
      */
     private retrieveOrCreateInstanceByInstanceName;
+    /**
+     * Attempts to retrieve an existing instance, handling request-scoped and singleton instances.
+     * Returns null if no instance exists and a new one should be created.
+     */
+    private tryGetExistingInstance;
+    /**
+     * Attempts to get a request-scoped instance if applicable.
+     */
+    private tryGetRequestScopedInstance;
+    /**
+     * Attempts to get a singleton instance from the manager.
+     */
+    private tryGetSingletonInstance;
+    /**
+     * Waits for an instance holder to be ready and returns the appropriate result.
+     */
+    private waitForInstanceReady;
     /**
      * Emits events to listeners for instance lifecycle events.
      */
@@ -717,6 +852,26 @@ declare class ServiceLocator {
      * Instantiates a service from the registry using the service instantiator.
      */
     private instantiateServiceFromRegistry;
+    /**
+     * Handles the result of service instantiation.
+     */
+    private handleInstantiationResult;
+    /**
+     * Handles successful service instantiation.
+     */
+    private handleInstantiationSuccess;
+    /**
+     * Handles service instantiation errors.
+     */
+    private handleInstantiationError;
+    /**
+     * Stores an instance holder based on its scope.
+     */
+    private storeInstanceByScope;
+    /**
+     * Tries to get a pre-prepared instance from request contexts.
+     */
+    private tryGetPrePreparedInstance;
     /**
      * Creates a factory context for dependency injection during service instantiation.
      * @param contextHolder Optional request context holder for priority-based resolution
@@ -726,6 +881,10 @@ declare class ServiceLocator {
      * Generates a unique instance name based on token and arguments.
      */
     private generateInstanceName;
+    /**
+     * Formats a single argument value for instance name generation.
+     */
+    private formatArgValue;
 }
 export { ServiceLocator }
 export { ServiceLocator as ServiceLocator_alias_1 }
@@ -825,29 +984,11 @@ declare enum ServiceLocatorInstanceHolderStatus {
 export { ServiceLocatorInstanceHolderStatus }
 export { ServiceLocatorInstanceHolderStatus as ServiceLocatorInstanceHolderStatus_alias_1 }
 
-declare class ServiceLocatorManager {
-    private readonly logger;
-    private readonly instancesHolders;
+declare class ServiceLocatorManager extends BaseInstanceHolderManager {
     constructor(logger?: Console | null);
     get(name: string): [InstanceExpired | InstanceDestroying, ServiceLocatorInstanceHolder] | [InstanceNotFound] | [undefined, ServiceLocatorInstanceHolder];
     set(name: string, holder: ServiceLocatorInstanceHolder): void;
     has(name: string): [InstanceExpired | InstanceDestroying] | [undefined, boolean];
-    delete(name: string): boolean;
-    filter(predicate: (value: ServiceLocatorInstanceHolder<any>, key: string) => boolean): Map<string, ServiceLocatorInstanceHolder>;
-    /**
-     * Creates a new holder with Creating status and a deferred creation promise.
-     * This is useful for creating placeholder holders that can be fulfilled later.
-     * @param name The name of the instance
-     * @param type The injectable type
-     * @param scope The injectable scope
-     * @param deps Optional set of dependencies
-     * @param ttl Optional time-to-live in milliseconds (defaults to Infinity)
-     * @returns A tuple containing the deferred promise and the holder
-     */
-    createCreatingHolder<Instance>(name: string, type: InjectableType, scope: InjectableScope, deps?: Set<string>, ttl?: number): [
-    ReturnType<typeof createDeferred<[undefined, Instance]>>,
-    ServiceLocatorInstanceHolder<Instance>
-    ];
     /**
      * Creates a new holder with Created status and an actual instance.
      * This is useful for creating holders that already have their instance ready.

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

@@ -16,6 +16,93 @@ declare type BaseInjectionTokenSchemaType = ZodObject | ZodRecord;
 export { BaseInjectionTokenSchemaType }
 export { BaseInjectionTokenSchemaType as BaseInjectionTokenSchemaType_alias_1 }
 
+/**
+ * Abstract base class that provides common functionality for managing ServiceLocatorInstanceHolder objects.
+ * This class contains shared patterns used by both RequestContextHolder and ServiceLocatorManager.
+ */
+declare abstract class BaseInstanceHolderManager {
+    protected readonly logger: Console | null;
+    protected readonly _holders: Map<string, ServiceLocatorInstanceHolder>;
+    constructor(logger?: Console | null);
+    /**
+     * Protected getter for accessing the holders map from subclasses.
+     */
+    protected get holders(): Map<string, ServiceLocatorInstanceHolder>;
+    /**
+     * Abstract method to get a holder by name. Each implementation defines its own return type
+     * based on their specific error handling and validation needs.
+     */
+    abstract get(name: string): any;
+    /**
+     * Abstract method to set a holder by name. Each implementation may have different validation logic.
+     */
+    abstract set(name: string, holder: ServiceLocatorInstanceHolder): void;
+    /**
+     * Abstract method to check if a holder exists. Each implementation may have different validation logic.
+     */
+    abstract has(name: string): any;
+    /**
+     * Deletes a holder by name.
+     * @param name The name of the holder to delete
+     * @returns true if the holder was deleted, false if it didn't exist
+     */
+    delete(name: string): boolean;
+    /**
+     * Filters holders based on a predicate function.
+     * @param predicate Function to test each holder
+     * @returns A new Map containing only the holders that match the predicate
+     */
+    filter(predicate: (value: ServiceLocatorInstanceHolder<any>, key: string) => boolean): Map<string, ServiceLocatorInstanceHolder>;
+    /**
+     * Clears all holders from this manager.
+     */
+    clear(): void;
+    /**
+     * Gets the number of holders currently managed.
+     */
+    size(): number;
+    /**
+     * Creates a new holder with Creating status and a deferred creation promise.
+     * This is useful for creating placeholder holders that can be fulfilled later.
+     * @param name The name of the instance
+     * @param type The injectable type
+     * @param scope The injectable scope
+     * @param deps Optional set of dependencies
+     * @param ttl Optional time-to-live in milliseconds (defaults to Infinity)
+     * @returns A tuple containing the deferred promise and the holder
+     */
+    createCreatingHolder<Instance>(name: string, type: InjectableType, scope: InjectableScope, deps?: Set<string>, ttl?: number): [
+    ReturnType<typeof createDeferred<[undefined, Instance]>>,
+    ServiceLocatorInstanceHolder<Instance>
+    ];
+    /**
+     * Creates a new holder with Created status and an actual instance.
+     * This is useful for creating holders that already have their instance ready.
+     * @param name The name of the instance
+     * @param instance The actual instance to store
+     * @param type The injectable type
+     * @param scope The injectable scope
+     * @param deps Optional set of dependencies
+     * @param ttl Optional time-to-live in milliseconds (defaults to Infinity)
+     * @returns The created holder
+     */
+    protected createCreatedHolder<Instance>(name: string, instance: Instance, type: InjectableType, scope: InjectableScope, deps?: Set<string>, ttl?: number): ServiceLocatorInstanceHolder<Instance>;
+    /**
+     * Gets all holder names currently managed.
+     */
+    getAllNames(): string[];
+    /**
+     * Gets all holders currently managed.
+     */
+    getAllHolders(): ServiceLocatorInstanceHolder[];
+    /**
+     * Checks if this manager has any holders.
+     */
+    isEmpty(): boolean;
+}
+export { BaseInstanceHolderManager }
+export { BaseInstanceHolderManager as BaseInstanceHolderManager_alias_1 }
+
 declare class BoundInjectionToken<T, S extends InjectionTokenSchemaType> {
     readonly token: InjectionToken<T, S>;
     readonly value: z.input<S>;
@@ -138,18 +225,29 @@ export { defaultInjectors as defaultInjectors_alias_1 }
 /**
  * Default implementation of RequestContextHolder.
  */
-declare class DefaultRequestContextHolder implements RequestContextHolder {
+declare class DefaultRequestContextHolder extends BaseInstanceHolderManager implements RequestContextHolder {
     readonly requestId: string;
     readonly priority: number;
-    readonly instances: Map<string, any>;
-    readonly holders: Map<string, ServiceLocatorInstanceHolder>;
     readonly metadata: Map<string, any>;
     readonly createdAt: number;
     constructor(requestId: string, priority?: number, initialMetadata?: Record<string, any>);
+    /**
+     * Public getter for holders to maintain interface compatibility.
+     */
+    get holders(): Map<string, ServiceLocatorInstanceHolder>;
+    /**
+     * Gets a holder by name. For RequestContextHolder, this is a simple lookup.
+     */
+    get(name: string): ServiceLocatorInstanceHolder | undefined;
+    /**
+     * Sets a holder by name.
+     */
+    set(name: string, holder: ServiceLocatorInstanceHolder): void;
+    /**
+     * Checks if a holder exists by name.
+     */
+    has(name: string): boolean;
     addInstance(instanceName: string | InjectionToken<any, undefined>, instance: any, holder?: ServiceLocatorInstanceHolder): void;
-    getInstance(instanceName: string): any | undefined;
-    getHolder(instanceName: string): ServiceLocatorInstanceHolder | undefined;
-    hasInstance(instanceName: string): boolean;
     clear(): void;
     getMetadata(key: string): any | undefined;
     setMetadata(key: string, value: any): void;
@@ -211,17 +309,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 }
@@ -555,10 +653,6 @@ declare interface RequestContextHolder {
      * Unique identifier for this request context.
      */
     readonly requestId: string;
-    /**
-     * Pre-prepared instances for this request, keyed by instance name.
-     */
-    readonly instances: Map<string, any>;
     /**
      * Instance holders for request-scoped services.
      */
@@ -584,18 +678,14 @@ declare interface RequestContextHolder {
      * Adds a pre-prepared instance to this context.
      */
     addInstance(token: InjectionToken<any, undefined>, instance: any): void;
-    /**
-     * Gets a pre-prepared instance from this context.
-     */
-    getInstance(instanceName: string): any | undefined;
     /**
      * Gets an instance holder from this context.
      */
-    getHolder(instanceName: string): ServiceLocatorInstanceHolder | undefined;
+    get(instanceName: string): ServiceLocatorInstanceHolder | undefined;
     /**
      * Checks if this context has a pre-prepared instance.
      */
-    hasInstance(instanceName: string): boolean;
+    has(instanceName: string): boolean;
     /**
      * Clears all instances and holders from this context.
      */
@@ -608,6 +698,22 @@ declare interface RequestContextHolder {
      * Sets metadata value by key.
      */
     setMetadata(key: string, value: any): void;
+    /**
+     * Filters holders based on a predicate function.
+     */
+    filter(predicate: (value: ServiceLocatorInstanceHolder<any>, key: string) => boolean): Map<string, ServiceLocatorInstanceHolder>;
+    /**
+     * Deletes a holder by name.
+     */
+    delete(name: string): boolean;
+    /**
+     * Gets the number of holders currently managed.
+     */
+    size(): number;
+    /**
+     * Checks if this manager has any holders.
+     */
+    isEmpty(): boolean;
 }
 export { RequestContextHolder }
 export { RequestContextHolder as RequestContextHolder_alias_1 }
@@ -668,7 +774,19 @@ declare class ServiceLocator {
     getOrThrowInstance<Instance>(token: AnyInjectableType, args: any): Promise<Instance>;
     getSyncInstance<Instance, Schema extends InjectionTokenSchemaType | undefined>(token: AnyInjectableType, args: Schema extends ZodObject ? z.input<Schema> : Schema extends ZodOptional<ZodObject> ? z.input<Schema> | undefined : undefined): Instance | null;
     invalidate(service: string, round?: number): Promise<any>;
-    ready(): Promise<null>;
+    /**
+     * Invalidates a single holder based on its current status.
+     */
+    private invalidateHolder;
+    /**
+     * Destroys a holder and cleans up its resources.
+     */
+    private destroyHolder;
+    ready(): Promise<void>;
+    /**
+     * Waits for a holder to settle (either created, destroyed, or error state).
+     */
+    private waitForHolderToSettle;
     /**
      * Begins a new request context with the given parameters.
      * @param requestId Unique identifier for this request
@@ -705,6 +823,23 @@ declare class ServiceLocator {
      * Gets an instance by its instance name, handling all the logic after instance name creation.
      */
     private retrieveOrCreateInstanceByInstanceName;
+    /**
+     * Attempts to retrieve an existing instance, handling request-scoped and singleton instances.
+     * Returns null if no instance exists and a new one should be created.
+     */
+    private tryGetExistingInstance;
+    /**
+     * Attempts to get a request-scoped instance if applicable.
+     */
+    private tryGetRequestScopedInstance;
+    /**
+     * Attempts to get a singleton instance from the manager.
+     */
+    private tryGetSingletonInstance;
+    /**
+     * Waits for an instance holder to be ready and returns the appropriate result.
+     */
+    private waitForInstanceReady;
     /**
      * Emits events to listeners for instance lifecycle events.
      */
@@ -717,6 +852,26 @@ declare class ServiceLocator {
      * Instantiates a service from the registry using the service instantiator.
      */
     private instantiateServiceFromRegistry;
+    /**
+     * Handles the result of service instantiation.
+     */
+    private handleInstantiationResult;
+    /**
+     * Handles successful service instantiation.
+     */
+    private handleInstantiationSuccess;
+    /**
+     * Handles service instantiation errors.
+     */
+    private handleInstantiationError;
+    /**
+     * Stores an instance holder based on its scope.
+     */
+    private storeInstanceByScope;
+    /**
+     * Tries to get a pre-prepared instance from request contexts.
+     */
+    private tryGetPrePreparedInstance;
     /**
      * Creates a factory context for dependency injection during service instantiation.
      * @param contextHolder Optional request context holder for priority-based resolution
@@ -726,6 +881,10 @@ declare class ServiceLocator {
      * Generates a unique instance name based on token and arguments.
      */
     private generateInstanceName;
+    /**
+     * Formats a single argument value for instance name generation.
+     */
+    private formatArgValue;
 }
 export { ServiceLocator }
 export { ServiceLocator as ServiceLocator_alias_1 }
@@ -825,29 +984,11 @@ declare enum ServiceLocatorInstanceHolderStatus {
 export { ServiceLocatorInstanceHolderStatus }
 export { ServiceLocatorInstanceHolderStatus as ServiceLocatorInstanceHolderStatus_alias_1 }
 
-declare class ServiceLocatorManager {
-    private readonly logger;
-    private readonly instancesHolders;
+declare class ServiceLocatorManager extends BaseInstanceHolderManager {
     constructor(logger?: Console | null);
     get(name: string): [InstanceExpired | InstanceDestroying, ServiceLocatorInstanceHolder] | [InstanceNotFound] | [undefined, ServiceLocatorInstanceHolder];
     set(name: string, holder: ServiceLocatorInstanceHolder): void;
     has(name: string): [InstanceExpired | InstanceDestroying] | [undefined, boolean];
-    delete(name: string): boolean;
-    filter(predicate: (value: ServiceLocatorInstanceHolder<any>, key: string) => boolean): Map<string, ServiceLocatorInstanceHolder>;
-    /**
-     * Creates a new holder with Creating status and a deferred creation promise.
-     * This is useful for creating placeholder holders that can be fulfilled later.
-     * @param name The name of the instance
-     * @param type The injectable type
-     * @param scope The injectable scope
-     * @param deps Optional set of dependencies
-     * @param ttl Optional time-to-live in milliseconds (defaults to Infinity)
-     * @returns A tuple containing the deferred promise and the holder
-     */
-    createCreatingHolder<Instance>(name: string, type: InjectableType, scope: InjectableScope, deps?: Set<string>, ttl?: number): [
-    ReturnType<typeof createDeferred<[undefined, Instance]>>,
-    ServiceLocatorInstanceHolder<Instance>
-    ];
     /**
      * Creates a new holder with Created status and an actual instance.
      * This is useful for creating holders that already have their instance ready.

package/lib/index.d.mts

@@ -27,6 +27,7 @@ export { PopUnion } from './_tsup-dts-rollup.mjs';
 export { IsUnion } from './_tsup-dts-rollup.mjs';
 export { UnionToArray } from './_tsup-dts-rollup.mjs';
 export { InjectState } from './_tsup-dts-rollup.mjs';
+export { BaseInstanceHolderManager_alias_1 as BaseInstanceHolderManager } from './_tsup-dts-rollup.mjs';
 export { EventsConfig_alias_1 as EventsConfig } from './_tsup-dts-rollup.mjs';
 export { EventsNames_alias_1 as EventsNames } from './_tsup-dts-rollup.mjs';
 export { EventsArgs_alias_1 as EventsArgs } from './_tsup-dts-rollup.mjs';

package/lib/index.d.ts

@@ -27,6 +27,7 @@ export { PopUnion } from './_tsup-dts-rollup.js';
 export { IsUnion } from './_tsup-dts-rollup.js';
 export { UnionToArray } from './_tsup-dts-rollup.js';
 export { InjectState } from './_tsup-dts-rollup.js';
+export { BaseInstanceHolderManager_alias_1 as BaseInstanceHolderManager } from './_tsup-dts-rollup.js';
 export { EventsConfig_alias_1 as EventsConfig } from './_tsup-dts-rollup.js';
 export { EventsNames_alias_1 as EventsNames } from './_tsup-dts-rollup.js';
 export { EventsArgs_alias_1 as EventsArgs } from './_tsup-dts-rollup.js';