Class ContainerBuilder

Fluent builder for DiContainer instances.

Collects configuration and provider registrations, then produces a ready-to-use container via build.

Example

const container = new ContainerBuilder()
  .setDefaultScope('singleton')
  .register('db', { useFactory: () => createDb() })
  .register('users', { useClass: UserService, inject: ['db'] })
  .build();

Since

0.1.0

Index

Constructors

constructor

Methods

build register setAutoRegister setDefaultScope setExternalResolver

Constructors

constructor

new ContainerBuilder(): ContainerBuilder

Returns ContainerBuilder

Methods

build

build(): DiContainer
Creates the container with all queued registrations applied.

Returns DiContainer
An open container whose owner can call close()

Throws
If queued tokens are duplicated

Since
0.11.0
- Defined in packages/di-plugin/src/container/container-builder.ts:113

register

register<T>(
    token: ContainerToken<T>,
    provider: Provider<T>,
    options?: ProviderOptions<T>,
): this
Queues a provider registration to be applied at build time.
Type Parameters
- T
  The service type
Parameters
- token: ContainerToken<T>
  The capability token
- provider: Provider<T>
  Class, factory, or value provider
- Optionaloptions: ProviderOptions<T>
  Lifecycle scope
Returns this
This builder for chaining

Since
0.11.0
- Defined in packages/di-plugin/src/container/container-builder.ts:96

setAutoRegister

setAutoRegister(enabled: boolean): this
Enables or disables auto-registration fallback to the external resolver.
Parameters
- enabled: boolean
  true to enable fallback (defaults to false)
Returns this
This builder for chaining
- Defined in packages/di-plugin/src/container/container-builder.ts:65

setDefaultScope

setDefaultScope(scope: ServiceScope): this
Sets the default lifecycle scope for providers registered without an explicit scope.
Parameters
- scope: ServiceScope
  The default scope
Returns this
This builder for chaining
- Defined in packages/di-plugin/src/container/container-builder.ts:54

setExternalResolver

setExternalResolver(resolver: ExternalResolver): this
Sets the external resolver used when auto-registration is enabled.
Parameters
- resolver: ExternalResolver
  The external resolver (e.g. the service registry)
Returns this
This builder for chaining
- Defined in packages/di-plugin/src/container/container-builder.ts:76

Class ContainerBuilder

Example

Since

Index

Constructors

Methods

Constructors

constructor

Returns ContainerBuilder

Methods

build

Returns DiContainer

Throws

Since

register

Type Parameters

Parameters

Returns this

Since

setAutoRegister

Parameters

Returns this

setDefaultScope

Parameters

Returns this

setExternalResolver

Parameters

Returns this

Settings

On This Page