Class ServiceContainer

Type-safe Service Container for Dependency Injection

Features:

Full type safety with TypeScript - no string-based APIs
Automatic type inference using ServiceIdentifier tokens
Support for both interface tokens and concrete classes
Singleton and transient lifetime management
Compile-time type checking for all service registrations and retrievals

Index

Constructors

constructor

Methods

bind clear createScope get has register registerAll

Constructors

constructor

new ServiceContainer(): ServiceContainer
Returns ServiceContainer

Methods

bind

bind<T>(
implementation: new (...args: unknown[]) => T,
options?: ServiceOptions,
): this
Bind a class to itself (syntactic sugar)
Type Parameters
- T
Parameters
- implementation: new (...args: unknown[]) => T
  Class constructor
- Optionaloptions: ServiceOptions
  Service options
Returns this
- Defined in packages/core/src/ServiceContainer.ts:132

clear

clear(): void
Clear all singleton instances Useful for testing or resetting the container

Returns void
- Defined in packages/core/src/ServiceContainer.ts:117

createScope

createScope(): ServiceContainer
Create a scoped container (child container) Useful for request-scoped services

Returns ServiceContainer
- Defined in packages/core/src/ServiceContainer.ts:154

get

get<T>(key: new (...args: any[]) => ServiceIdentifier<T>): T
Get a service from the container with automatic type inference
Type Parameters
- T
Parameters
- key: new (...args: any[]) => ServiceIdentifier<T>
  Service identifier (interface token or class) - strings are not supported
Returns T
Service instance with correct type inferred from the key
Throws
Error if service is not registered
Example
```
const messageService = container.get(MessageService) // Type is inferred as IMessageService
const appSettings = container.get(AppSettings) // Type is inferred as IAppSettings
```
- Defined in packages/core/src/ServiceContainer.ts:72
get<C extends new (...args: any[]) => any>(key: C): InstanceType<C>
Get a service from the container with automatic type inference
Type Parameters
- C extends new (...args: any[]) => any
Parameters
- key: C
  Service identifier (interface token or class) - strings are not supported
Returns InstanceType<C>
Service instance with correct type inferred from the key
Throws
Error if service is not registered
Example
```
const messageService = container.get(MessageService) // Type is inferred as IMessageService
const appSettings = container.get(AppSettings) // Type is inferred as IAppSettings
```
- Defined in packages/core/src/ServiceContainer.ts:75

has

has<T>(key: ServiceKey<T>): boolean
Check if a service is registered
Type Parameters
- T
Parameters
- key: ServiceKey<T>
  Service identifier
Returns boolean
true if the service is registered
- Defined in packages/core/src/ServiceContainer.ts:109

register

register<T>(
    key: ServiceKey<T>,
    factory: ServiceFactory<ServiceType<T>>,
    options?: ServiceOptions,
): this
Register a service with the container using type-safe keys
Type Parameters
- T
Parameters
- key: ServiceKey<T>
  Service identifier (interface token or class) - strings are not supported
- factory: ServiceFactory<ServiceType<T>>
  Factory function to create the service
- options: ServiceOptions = {}
  Service registration options
Returns this
Example
```
container.register(MessageService, () => new MessageServiceImpl())
container.register(AppSettings, () => new AppSettingsImpl())
```
- Defined in packages/core/src/ServiceContainer.ts:51

registerAll

registerAll(registrations: ServiceRegistration[]): this
Register all services at once (bulk registration)
Parameters
- registrations: ServiceRegistration[]
  Array of service registrations
Returns this
- Defined in packages/core/src/ServiceContainer.ts:143

Class ServiceContainer

Index

Constructors

Methods

Constructors

constructor

Returns ServiceContainer

Methods

bind

Type Parameters

Parameters

Returns this

clear

Returns void

createScope

Returns ServiceContainer

get

Type Parameters

Parameters

Returns T

Throws

Example

Type Parameters

Parameters

Returns InstanceType<C>

Throws

Example

has

Type Parameters

Parameters

Returns boolean

register

Type Parameters

Parameters

Returns this

Example

registerAll

Parameters

Returns this

Settings

On This Page