@expressots/core 3.0.0 → 4.0.0-preview.3

package/lib/cjs/types/di/binding-decorator/constants.d.ts

@@ -1,4 +1,7 @@
 declare const METADATA_KEY: {
     provide: string;
+    scope: string;
+    source: string;
+    providerMeta: string;
 };
 export { METADATA_KEY };

package/lib/cjs/types/di/binding-decorator/decorator/fluent_provide.d.ts

@@ -1,4 +1,4 @@
-import interfaces from "../interfaces/interfaces";
-import { interfaces as inversifyInterfaces } from "../../../di/inversify";
+import interfaces from "../interfaces/interfaces.js";
+import { interfaces as inversifyInterfaces } from "../../../di/inversify.js";
 declare function fluentProvide(serviceIdentifier: inversifyInterfaces.ServiceIdentifier<any>): interfaces.ProvideInWhenOnSyntax<any>;
 export default fluentProvide;

package/lib/cjs/types/di/binding-decorator/decorator/provide.d.ts

@@ -1,4 +1,4 @@
 import "reflect-metadata";
-import { interfaces as inversifyInterfaces } from "../../../di/inversify";
+import { interfaces as inversifyInterfaces } from "../../../di/inversify.js";
 declare function provide(serviceIdentifier: inversifyInterfaces.ServiceIdentifier<any>, force?: boolean): any;
 export default provide;

package/lib/cjs/types/di/binding-decorator/factory/module_factory.d.ts

@@ -1,4 +1,23 @@
 import "reflect-metadata";
-import { interfaces as inversifyInterfaces } from "../../inversify";
+import { interfaces as inversifyInterfaces } from "../../inversify.js";
+/**
+ * Builds a ContainerModule from all @provide() decorated classes.
+ *
+ * @layer internal
+ * @audience framework-developers
+ *
+ * **Internal Behavior**
+ * - Discovers all classes decorated with @provide() or fluentProvide()
+ * - Creates bindings for each discovered provider
+ * - Returns ContainerModule that can be loaded into container
+ *
+ * **Used By**
+ * - AppContainer automatically loads this module
+ * - Provides auto-discovery of providers
+ *
+ * @returns ContainerModule with all provider bindings
+ *
+ * @internal
+ */
 declare function buildProviderModule(): inversifyInterfaces.ContainerModule;
 export default buildProviderModule;

package/lib/cjs/types/di/binding-decorator/index.d.ts

@@ -1,8 +1,10 @@
-import autoProvide from "./utils/auto_wire";
-import provide from "./decorator/provide";
-import fluentProvide from "./decorator/fluent_provide";
-import buildProviderModule from "./factory/module_factory";
+import autoProvide from "./utils/auto_wire.js";
+import provide from "./decorator/provide.js";
+import fluentProvide from "./decorator/fluent_provide.js";
+import buildProviderModule from "./factory/module_factory.js";
+import { METADATA_KEY } from "./constants.js";
 export { fluentProvide };
 export { provide };
 export { autoProvide };
 export { buildProviderModule };
+export { METADATA_KEY };

package/lib/cjs/types/di/binding-decorator/interfaces/interfaces.d.ts

@@ -1,4 +1,4 @@
-import { interfaces as inversifyInterfaces } from "../../inversify";
+import { interfaces as inversifyInterfaces } from "../../inversify.js";
 declare namespace interfaces {
     type BindConstraint = (bind: inversifyInterfaces.Bind, target: any) => any;
     interface ProvideSyntax {
@@ -11,6 +11,7 @@ declare namespace interfaces {
     interface ProvideInSyntax<T> extends ProvideDoneSyntax {
         inSingletonScope(): ProvideWhenOnSyntax<T>;
         inTransientScope(): ProvideWhenOnSyntax<T>;
+        inScope(scope: string): ProvideWhenOnSyntax<T>;
     }
     interface ProvideInWhenOnSyntax<T> extends ProvideInSyntax<T>, ProvideWhenSyntax<T>, ProvideOnSyntax<T> {
     }

package/lib/cjs/types/di/binding-decorator/syntax/provide_done_syntax.d.ts

@@ -1,4 +1,4 @@
-import interfaces from "../interfaces/interfaces";
+import interfaces from "../interfaces/interfaces.js";
 declare class ProvideDoneSyntax implements interfaces.ProvideDoneSyntax {
     private _binding;
     constructor(binding: interfaces.BindConstraint);

package/lib/cjs/types/di/binding-decorator/syntax/provide_in_syntax.d.ts

@@ -1,11 +1,12 @@
-import interfaces from "../interfaces/interfaces";
-import { interfaces as inversifyInterfaces } from "../../inversify";
+import interfaces from "../interfaces/interfaces.js";
+import { interfaces as inversifyInterfaces } from "../../inversify.js";
 declare class ProvideInSyntax<T> implements interfaces.ProvideInSyntax<T> {
     private _bindingInSyntax;
     private _provideDoneSyntax;
     constructor(bindingInSyntax: (bind: inversifyInterfaces.Bind, target: any) => inversifyInterfaces.BindingInSyntax<T>, provideDoneSyntax: interfaces.ProvideDoneSyntax);
     inSingletonScope(): interfaces.ProvideWhenOnSyntax<T>;
     inTransientScope(): interfaces.ProvideWhenOnSyntax<T>;
+    inScope(scope: string): interfaces.ProvideWhenOnSyntax<T>;
     done(force?: boolean): any;
 }
 export default ProvideInSyntax;

package/lib/cjs/types/di/binding-decorator/syntax/provide_in_when_on_syntax.d.ts

@@ -1,5 +1,5 @@
-import interfaces from "../interfaces/interfaces";
-import { interfaces as inversifyInterfaces } from "../../inversify";
+import interfaces from "../interfaces/interfaces.js";
+import { interfaces as inversifyInterfaces } from "../../inversify.js";
 declare class ProvideInWhenOnSyntax<T> implements interfaces.ProvideInWhenOnSyntax<T> {
     private _provideInSyntax;
     private _provideWhenSyntax;
@@ -22,6 +22,7 @@ declare class ProvideInWhenOnSyntax<T> implements interfaces.ProvideInWhenOnSynt
     onActivation(fn: (context: inversifyInterfaces.Context, injectable: T) => T): interfaces.ProvideWhenSyntax<T>;
     inSingletonScope(): interfaces.ProvideWhenOnSyntax<T>;
     inTransientScope(): interfaces.ProvideWhenOnSyntax<T>;
+    inScope(scope: string): interfaces.ProvideWhenOnSyntax<T>;
     done(force?: boolean): any;
 }
 export default ProvideInWhenOnSyntax;

package/lib/cjs/types/di/binding-decorator/syntax/provide_on_syntax.d.ts

@@ -1,5 +1,5 @@
-import interfaces from "../interfaces/interfaces";
-import { interfaces as inversifyInterfaces } from "../../inversify";
+import interfaces from "../interfaces/interfaces.js";
+import { interfaces as inversifyInterfaces } from "../../inversify.js";
 declare class ProvideOnSyntax<T> implements interfaces.ProvideOnSyntax<T> {
     private _bindingOnSyntax;
     private _provideDoneSyntax;

package/lib/cjs/types/di/binding-decorator/syntax/provide_when_on_syntax.d.ts

@@ -1,5 +1,5 @@
-import interfaces from "../interfaces/interfaces";
-import { interfaces as inversifyInterfaces } from "../../inversify";
+import interfaces from "../interfaces/interfaces.js";
+import { interfaces as inversifyInterfaces } from "../../inversify.js";
 declare class ProvideWhenOnSyntax<T> implements interfaces.ProvideWhenOnSyntax<T> {
     private _provideWhenSyntax;
     private _provideOnSyntax;

package/lib/cjs/types/di/binding-decorator/syntax/provide_when_syntax.d.ts

@@ -1,5 +1,5 @@
-import interfaces from "../interfaces/interfaces";
-import { interfaces as inversifyInterfaces } from "../../inversify";
+import interfaces from "../interfaces/interfaces.js";
+import { interfaces as inversifyInterfaces } from "../../inversify.js";
 declare class ProvideWhenSyntax<T> implements interfaces.ProvideWhenSyntax<T> {
     private _bindingWhenSyntax;
     private _provideDoneSyntax;

package/lib/cjs/types/di/binding-decorator/utils/auto_wire.d.ts

@@ -1,3 +1,3 @@
-import { interfaces } from "../../inversify";
+import { interfaces } from "../../inversify.js";
 declare function autoProvide(container: interfaces.Container, ...modules: Array<any>): void;
 export default autoProvide;

package/lib/cjs/types/di/bindings/binding.d.ts

@@ -1,4 +1,4 @@
-import { interfaces } from "../interfaces/interfaces";
+import { interfaces } from "../interfaces/interfaces.js";
 declare class Binding<TActivated> implements interfaces.Binding<TActivated> {
     id: number;
     moduleId: interfaces.ContainerModuleBase["id"];

package/lib/cjs/types/di/constants/literal_types.d.ts

@@ -1,5 +1,5 @@
-import { interfaces } from "../interfaces/interfaces";
-declare const BindingScopeEnum: interfaces.BindingScopeEnum;
+import { interfaces } from "../interfaces/interfaces.js";
+declare const Scope: interfaces.Scope;
 declare const BindingTypeEnum: interfaces.BindingTypeEnum;
 declare const TargetTypeEnum: interfaces.TargetTypeEnum;
-export { BindingScopeEnum, BindingTypeEnum, TargetTypeEnum };
+export { Scope, BindingTypeEnum, TargetTypeEnum };

package/lib/cjs/types/di/container/container.d.ts

@@ -1,4 +1,4 @@
-import { interfaces } from "../interfaces/interfaces";
+import { interfaces } from "../interfaces/interfaces.js";
 declare class Container implements interfaces.Container {
     id: number;
     parent: interfaces.Container | null;

package/lib/cjs/types/di/container/container_module.d.ts

@@ -1,4 +1,4 @@
-import { interfaces } from "../interfaces/interfaces";
+import { interfaces } from "../interfaces/interfaces.js";
 export declare class ContainerModule implements interfaces.ContainerModule {
     id: number;
     registry: interfaces.ContainerModuleCallBack;

package/lib/cjs/types/di/container/container_snapshot.d.ts

@@ -1,4 +1,4 @@
-import { interfaces } from "../interfaces/interfaces";
+import { interfaces } from "../interfaces/interfaces.js";
 declare class ContainerSnapshot implements interfaces.ContainerSnapshot {
     bindings: interfaces.Lookup<interfaces.Binding<unknown>>;
     activations: interfaces.Lookup<interfaces.BindingActivation<unknown>>;

package/lib/cjs/types/di/container/lookup.d.ts

@@ -1,4 +1,4 @@
-import { interfaces } from "../interfaces/interfaces";
+import { interfaces } from "../interfaces/interfaces.js";
 declare class Lookup<T> implements interfaces.Lookup<T> {
     private _map;
     constructor();

package/lib/cjs/types/di/container/module_activation_store.d.ts

@@ -1,4 +1,4 @@
-import { interfaces } from "../interfaces/interfaces";
+import { interfaces } from "../interfaces/interfaces.js";
 export declare class ModuleActivationStore implements interfaces.ModuleActivationStore {
     private _map;
     remove(moduleId: number): interfaces.ModuleActivationHandlers;

package/lib/cjs/types/di/container-introspection.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Container introspection helpers.
+ *
+ * Centralises the (currently unavoidable) reach into the vendored
+ * Inversify `_bindingDictionary._map`. Concentrating it in one file means
+ * the rest of the framework no longer accesses Inversify internals
+ * directly, and the day we replace or upgrade the DI internals there is
+ * exactly one file to update.
+ *
+ * @public API (advanced) - intentionally exported so user code, the
+ * adapter, and the metrics collector can introspect bindings without
+ * each importing private internals.
+ */
+import type { interfaces } from "./inversify.js";
+/**
+ * Visit every binding in the container, including duplicates registered
+ * for the same service identifier. Returns the total count visited.
+ */
+export declare function forEachBinding(container: interfaces.Container, visit: (binding: interfaces.Binding<unknown>, serviceIdentifier: unknown) => void): number;
+/**
+ * Returns every implementation type currently bound in the container
+ * that is a real constructor function. Filters out factory and value
+ * bindings.
+ */
+export declare function getBoundImplementations(container: interfaces.Container): Array<NewableFunction>;

package/lib/cjs/types/di/interfaces/interfaces.d.ts

@@ -1,12 +1,12 @@
-import { FactoryType } from "../utils/factory_type";
+import { FactoryType } from "../utils/factory_type.js";
 declare namespace interfaces {
     export type DynamicValue<T> = (context: interfaces.Context) => T | Promise<T>;
     export type ContainerResolution<T> = T | Promise<T> | Array<T | Promise<T>>;
     type AsyncCallback<TCallback> = TCallback extends (...args: infer TArgs) => infer TResult ? (...args: TArgs) => Promise<TResult> : never;
-    export type BindingScope = "Singleton" | "Transient" | "Request";
+    export type BindingScope = "Singleton" | "Transient" | "Request" | string;
     export type BindingType = "ConstantValue" | "Constructor" | "DynamicValue" | "Factory" | "Function" | "Instance" | "Invalid" | "Provider";
     export type TargetType = "ConstructorArgument" | "ClassProperty" | "Variable";
-    export interface BindingScopeEnum {
+    export interface Scope {
         Request: interfaces.BindingScope;
         Singleton: interfaces.BindingScope;
         Transient: interfaces.BindingScope;
@@ -263,6 +263,7 @@ declare namespace interfaces {
         inSingletonScope(): BindingWhenOnSyntax<T>;
         inTransientScope(): BindingWhenOnSyntax<T>;
         inRequestScope(): BindingWhenOnSyntax<T>;
+        inScope(scope: string): BindingWhenOnSyntax<T>;
     }
     export interface BindingInWhenOnSyntax<T> extends BindingInSyntax<T>, BindingWhenOnSyntax<T> {
     }

package/lib/cjs/types/di/inversify.d.ts

@@ -1,25 +1,54 @@
-import * as keys from "./constants/metadata_keys";
+/**
+ * InversifyJS Dependency Injection Library
+ *
+ * @layer public
+ * @audience application-developers
+ * @concept dependency-injection
+ * @difficulty intermediate
+ *
+ * @summary Quick Start
+ * ExpressoTS uses InversifyJS for dependency injection. Most InversifyJS APIs are available here.
+ *
+ * @example
+ * ```typescript
+ * import { Container, injectable, inject } from "@expressots/core";
+ *
+ * @injectable()
+ * export class MyService {
+ *   constructor(@inject("IDependency") private dep: IDependency) {}
+ * }
+ * ```
+ *
+ * @note
+ * This module re-exports InversifyJS APIs. For full InversifyJS documentation,
+ * see: https://github.com/inversify/InversifyJS
+ *
+ * @public API
+ */
+import * as keys from "./constants/metadata_keys.js";
 export declare const METADATA_KEY: typeof keys;
-export { Container } from "./container/container";
-export { BindingScopeEnum, BindingTypeEnum, TargetTypeEnum, } from "./constants/literal_types";
-export { AsyncContainerModule, ContainerModule, } from "./container/container_module";
-export { createTaggedDecorator } from "./annotation/decorator_utils";
-export { injectable } from "./annotation/injectable";
-export { tagged } from "./annotation/tagged";
-export { named } from "./annotation/named";
-export { inject } from "./annotation/inject";
-export { LazyServiceIdentifier } from "./annotation/lazy_service_identifier";
-export { LazyServiceIdentifier as LazyServiceIdentifer } from "./annotation/lazy_service_identifier";
-export { optional } from "./annotation/optional";
-export { unmanaged } from "./annotation/unmanaged";
-export { multiInject } from "./annotation/multi_inject";
-export { targetName } from "./annotation/target_name";
-export { postConstruct } from "./annotation/post_construct";
-export { preDestroy } from "./annotation/pre_destroy";
-export { MetadataReader } from "./planning/metadata_reader";
-export { id } from "./utils/id";
-export { interfaces } from "./interfaces/interfaces";
-export { decorate } from "./annotation/decorator_utils";
-export { traverseAncerstors, taggedConstraint, namedConstraint, typeConstraint, } from "./syntax/constraint_helpers";
-export { getServiceIdentifierAsString } from "./utils/serialization";
-export { multiBindToService } from "./utils/binding_utils";
+export { Container } from "./container/container.js";
+export { Scope, BindingTypeEnum, TargetTypeEnum, } from "./constants/literal_types.js";
+export { AsyncContainerModule, ContainerModule, } from "./container/container_module.js";
+export { createTaggedDecorator } from "./annotation/decorator_utils.js";
+export { injectable } from "./annotation/injectable.js";
+export { tagged } from "./annotation/tagged.js";
+export { named } from "./annotation/named.js";
+export { inject } from "./annotation/inject.js";
+export { LazyServiceIdentifier } from "./annotation/lazy_service_identifier.js";
+export { LazyServiceIdentifier as LazyServiceIdentifer } from "./annotation/lazy_service_identifier.js";
+export { optional } from "./annotation/optional.js";
+export { unmanaged } from "./annotation/unmanaged.js";
+export { multiInject } from "./annotation/multi_inject.js";
+export { targetName } from "./annotation/target_name.js";
+export { postConstruct } from "./annotation/post_construct.js";
+export { preDestroy } from "./annotation/pre_destroy.js";
+export { MetadataReader } from "./planning/metadata_reader.js";
+export { id } from "./utils/id.js";
+export { interfaces } from "./interfaces/interfaces.js";
+export { decorate } from "./annotation/decorator_utils.js";
+export { forEachBinding, getBoundImplementations, } from "./container-introspection.js";
+export { traverseAncerstors, taggedConstraint, namedConstraint, typeConstraint, } from "./syntax/constraint_helpers.js";
+export { getServiceIdentifierAsString } from "./utils/serialization.js";
+export { multiBindToService } from "./utils/binding_utils.js";
+export { ScopeRegistry, globalScopeRegistry } from "./scope/scope-registry.js";

package/lib/cjs/types/di/planning/context.d.ts

@@ -1,4 +1,4 @@
-import { interfaces } from "../interfaces/interfaces";
+import { interfaces } from "../interfaces/interfaces.js";
 declare class Context implements interfaces.Context {
     id: number;
     container: interfaces.Container;

package/lib/cjs/types/di/planning/metadata.d.ts

@@ -1,4 +1,4 @@
-import { interfaces } from "../interfaces/interfaces";
+import { interfaces } from "../interfaces/interfaces.js";
 declare class Metadata implements interfaces.Metadata {
     key: string | number | symbol;
     value: unknown;

package/lib/cjs/types/di/planning/metadata_reader.d.ts

@@ -1,4 +1,4 @@
-import { interfaces } from "../interfaces/interfaces";
+import { interfaces } from "../interfaces/interfaces.js";
 declare class MetadataReader implements interfaces.MetadataReader {
     getConstructorMetadata(constructorFunc: NewableFunction): interfaces.ConstructorMetadata;
     getPropertiesMetadata(constructorFunc: NewableFunction): interfaces.MetadataMap;

package/lib/cjs/types/di/planning/plan.d.ts

@@ -1,4 +1,4 @@
-import { interfaces } from "../interfaces/interfaces";
+import { interfaces } from "../interfaces/interfaces.js";
 declare class Plan implements interfaces.Plan {
     parentContext: interfaces.Context;
     rootRequest: interfaces.Request;

package/lib/cjs/types/di/planning/planner.d.ts

@@ -1,4 +1,4 @@
-import { interfaces } from "../interfaces/interfaces";
+import { interfaces } from "../interfaces/interfaces.js";
 declare function getBindingDictionary(cntnr: interfaces.Container): interfaces.Lookup<interfaces.Binding<unknown>>;
 declare function plan(metadataReader: interfaces.MetadataReader, container: interfaces.Container, isMultiInject: boolean, targetType: interfaces.TargetType, serviceIdentifier: interfaces.ServiceIdentifier, key?: string | number | symbol, value?: unknown, avoidConstraints?: boolean): interfaces.Context;
 declare function createMockRequest(container: interfaces.Container, serviceIdentifier: interfaces.ServiceIdentifier, key: string | number | symbol, value: unknown): interfaces.Request;

package/lib/cjs/types/di/planning/queryable_string.d.ts

@@ -1,4 +1,4 @@
-import { interfaces } from "../interfaces/interfaces";
+import { interfaces } from "../interfaces/interfaces.js";
 declare class QueryableString implements interfaces.QueryableString {
     private str;
     constructor(str: string);

package/lib/cjs/types/di/planning/reflection_utils.d.ts

@@ -1,5 +1,5 @@
-import { interfaces } from "../interfaces/interfaces";
-import { getFunctionName } from "../utils/serialization";
+import { interfaces } from "../interfaces/interfaces.js";
+import { getFunctionName } from "../utils/serialization.js";
 declare function getDependencies(metadataReader: interfaces.MetadataReader, func: NewableFunction): Array<interfaces.Target>;
 declare function getBaseClassDependencyCount(metadataReader: interfaces.MetadataReader, func: NewableFunction): number;
 export { getDependencies, getBaseClassDependencyCount, getFunctionName };

package/lib/cjs/types/di/planning/request.d.ts

@@ -1,4 +1,4 @@
-import { interfaces } from "../interfaces/interfaces";
+import { interfaces } from "../interfaces/interfaces.js";
 declare class Request implements interfaces.Request {
     id: number;
     serviceIdentifier: interfaces.ServiceIdentifier;

package/lib/cjs/types/di/planning/target.d.ts

@@ -1,5 +1,5 @@
-import { interfaces } from "../interfaces/interfaces";
-import { Metadata } from "./metadata";
+import { interfaces } from "../interfaces/interfaces.js";
+import { Metadata } from "./metadata.js";
 declare class Target implements interfaces.Target {
     id: number;
     type: interfaces.TargetType;

package/lib/cjs/types/di/resolution/instantiation.d.ts

@@ -1,3 +1,3 @@
-import { interfaces } from "../interfaces/interfaces";
+import { interfaces } from "../interfaces/interfaces.js";
 declare function resolveInstance<T>(binding: interfaces.Binding<T>, constr: interfaces.Newable<T>, childRequests: Array<interfaces.Request>, resolveRequest: interfaces.ResolveRequestHandler): T | Promise<T>;
 export { resolveInstance };

package/lib/cjs/types/di/resolution/resolver.d.ts

@@ -1,3 +1,3 @@
-import { interfaces } from "../interfaces/interfaces";
+import { interfaces } from "../interfaces/interfaces.js";
 declare function resolve<T>(context: interfaces.Context): T | Promise<T> | Array<T | Promise<T>>;
 export { resolve };

package/lib/cjs/types/di/scope/scope-registry.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Registry for managing custom scope stores in dependency injection.
+ *
+ * @layer public
+ * @audience application-developers
+ * @concept scope-management
+ * @difficulty advanced
+ *
+ * @summary Quick Start
+ * Manages custom scope stores for multi-tenant or transaction-scoped services.
+ * Typically used internally by the framework.
+ *
+ * @example
+ * ```typescript
+ * const registry = new ScopeRegistry();
+ * const tenantScope = registry.getScopeStore("tenant");
+ * tenantScope.set(bindingId, instance);
+ * ```
+ *
+ * @layer internal
+ * @audience framework-developers
+ *
+ * **Internal Architecture**
+ *
+ * ScopeRegistry maintains separate stores for each custom scope:
+ * - Each scope has its own Map of binding IDs to instances
+ * - Instances are cached per scope value
+ * - Used by InversifyJS container for custom scope resolution
+ *
+ * **Use Cases**
+ * - Multi-tenant applications (tenant scope)
+ * - Transaction management (transaction scope)
+ * - Workflow orchestration (workflow scope)
+ *
+ * @see {@link provideInScope} for registering services with custom scopes
+ *
+ * @public API
+ */
+export declare class ScopeRegistry {
+    private stores;
+    /**
+     * Get or create a scope store for the given scope name.
+     *
+     * @layer public
+     * @audience application-developers
+     *
+     * @param scopeName - The name of the custom scope (e.g., "tenant", "transaction")
+     * @returns The scope store Map for the given scope name
+     *
+     * @example
+     * ```typescript
+     * const registry = new ScopeRegistry();
+     * const tenantScope = registry.getScopeStore("tenant");
+     * // Use tenantScope to store/retrieve instances
+     * ```
+     *
+     * @public API
+     */
+    getScopeStore(scopeName: string): Map<number, unknown>;
+    /**
+     * Check if a scope store exists for the given scope name.
+     * @param scopeName - The name of the custom scope
+     * @returns True if the scope store exists, false otherwise
+     */
+    hasScope(scopeName: string): boolean;
+    /**
+     * Clear all instances from a specific scope store.
+     * @param scopeName - The name of the custom scope to clear
+     */
+    clearScope(scopeName: string): void;
+    /**
+     * Remove a scope store entirely.
+     * @param scopeName - The name of the custom scope to remove
+     */
+    removeScope(scopeName: string): void;
+    /**
+     * Clear all scope stores.
+     */
+    clearAll(): void;
+    /**
+     * Get all registered scope names.
+     * @returns Array of scope names
+     */
+    getScopeNames(): Array<string>;
+}
+/**
+ * Global scope registry instance.
+ * This is used by the container to manage custom scopes.
+ * @internal
+ */
+export declare const globalScopeRegistry: ScopeRegistry;

package/lib/cjs/types/di/scope/scope.d.ts

@@ -1,3 +1,3 @@
-import type { interfaces } from "../interfaces/interfaces";
+import type { interfaces } from "../interfaces/interfaces.js";
 export declare const tryGetFromScope: <T>(requestScope: interfaces.RequestScope, binding: interfaces.Binding<T>) => T | Promise<T> | null;
 export declare const saveToScope: <T>(requestScope: interfaces.RequestScope, binding: interfaces.Binding<T>, result: T | Promise<T>) => void;

package/lib/cjs/types/di/syntax/binding_in_syntax.d.ts

@@ -1,9 +1,10 @@
-import { interfaces } from "../interfaces/interfaces";
+import { interfaces } from "../interfaces/interfaces.js";
 declare class BindingInSyntax<T> implements interfaces.BindingInSyntax<T> {
     private _binding;
     constructor(binding: interfaces.Binding<T>);
     inRequestScope(): interfaces.BindingWhenOnSyntax<T>;
     inSingletonScope(): interfaces.BindingWhenOnSyntax<T>;
     inTransientScope(): interfaces.BindingWhenOnSyntax<T>;
+    inScope(scope: string): interfaces.BindingWhenOnSyntax<T>;
 }
 export { BindingInSyntax };

package/lib/cjs/types/di/syntax/binding_in_when_on_syntax.d.ts

@@ -1,4 +1,4 @@
-import { interfaces } from "../interfaces/interfaces";
+import { interfaces } from "../interfaces/interfaces.js";
 declare class BindingInWhenOnSyntax<T> implements interfaces.BindingInSyntax<T>, interfaces.BindingWhenSyntax<T>, interfaces.BindingOnSyntax<T> {
     private _bindingInSyntax;
     private _bindingWhenSyntax;
@@ -8,6 +8,7 @@ declare class BindingInWhenOnSyntax<T> implements interfaces.BindingInSyntax<T>,
     inRequestScope(): interfaces.BindingWhenOnSyntax<T>;
     inSingletonScope(): interfaces.BindingWhenOnSyntax<T>;
     inTransientScope(): interfaces.BindingWhenOnSyntax<T>;
+    inScope(scope: string): interfaces.BindingWhenOnSyntax<T>;
     when(constraint: (request: interfaces.Request) => boolean): interfaces.BindingOnSyntax<T>;
     whenTargetNamed(name: string): interfaces.BindingOnSyntax<T>;
     whenTargetIsDefault(): interfaces.BindingOnSyntax<T>;

package/lib/cjs/types/di/syntax/binding_on_syntax.d.ts

@@ -1,4 +1,4 @@
-import { interfaces } from "../interfaces/interfaces";
+import { interfaces } from "../interfaces/interfaces.js";
 declare class BindingOnSyntax<T> implements interfaces.BindingOnSyntax<T> {
     private _binding;
     constructor(binding: interfaces.Binding<T>);

package/lib/cjs/types/di/syntax/binding_to_syntax.d.ts

@@ -1,5 +1,5 @@
-import { interfaces } from "../interfaces/interfaces";
-import { BindingWhenOnSyntax } from "./binding_when_on_syntax";
+import { interfaces } from "../interfaces/interfaces.js";
+import { BindingWhenOnSyntax } from "./binding_when_on_syntax.js";
 declare class BindingToSyntax<T> implements interfaces.BindingToSyntax<T> {
     private _binding;
     constructor(binding: interfaces.Binding<T>);

package/lib/cjs/types/di/syntax/binding_when_on_syntax.d.ts

@@ -1,4 +1,4 @@
-import { interfaces } from "../interfaces/interfaces";
+import { interfaces } from "../interfaces/interfaces.js";
 declare class BindingWhenOnSyntax<T> implements interfaces.BindingWhenSyntax<T>, interfaces.BindingOnSyntax<T> {
     private _bindingWhenSyntax;
     private _bindingOnSyntax;

package/lib/cjs/types/di/syntax/binding_when_syntax.d.ts

@@ -1,4 +1,4 @@
-import { interfaces } from "../interfaces/interfaces";
+import { interfaces } from "../interfaces/interfaces.js";
 declare class BindingWhenSyntax<T> implements interfaces.BindingWhenSyntax<T> {
     private _binding;
     constructor(binding: interfaces.Binding<T>);

package/lib/cjs/types/di/syntax/constraint_helpers.d.ts

@@ -1,4 +1,4 @@
-import { interfaces } from "../interfaces/interfaces";
+import { interfaces } from "../interfaces/interfaces.js";
 declare const traverseAncerstors: (request: interfaces.Request, constraint: interfaces.ConstraintFunction) => boolean;
 declare const taggedConstraint: (key: string | number | symbol) => (value: unknown) => interfaces.ConstraintFunction;
 declare const namedConstraint: (value: unknown) => interfaces.ConstraintFunction;

package/lib/cjs/types/di/utils/binding_utils.d.ts

@@ -1,4 +1,4 @@
-import type { interfaces } from "../interfaces/interfaces";
+import type { interfaces } from "../interfaces/interfaces.js";
 export declare const multiBindToService: (container: interfaces.Container) => (service: interfaces.ServiceIdentifier) => (...types: Array<interfaces.ServiceIdentifier>) => void;
 export declare const ensureFullyBound: <T = unknown>(binding: interfaces.Binding<T>) => void;
 export declare const getFactoryDetails: <T = unknown>(binding: interfaces.Binding<T>) => interfaces.FactoryDetails;

package/lib/cjs/types/di/utils/clonable.d.ts

@@ -1,3 +1,3 @@
-import { interfaces } from "../interfaces/interfaces";
+import { interfaces } from "../interfaces/interfaces.js";
 declare function isClonable<T>(obj: unknown): obj is interfaces.Clonable<T>;
 export { isClonable };

package/lib/cjs/types/di/utils/serialization.d.ts

@@ -1,4 +1,4 @@
-import { interfaces } from "../interfaces/interfaces";
+import { interfaces } from "../interfaces/interfaces.js";
 declare function getServiceIdentifierAsString(serviceIdentifier: interfaces.ServiceIdentifier): string;
 declare function listRegisteredBindingsForServiceIdentifier(container: interfaces.Container, serviceIdentifier: string, getBindings: <T>(container: interfaces.Container, serviceIdentifier: interfaces.ServiceIdentifier<T>) => Array<interfaces.Binding<T>>): string;
 declare function circularDependencyToException(request: interfaces.Request): void;