chubbyts-dic



Description

Dependency injection container (DIC), [PSR-11][2] inspired.

Requirements

* node: 18
* [chubbyts/chubbyts-dic-types][3]: ^2.0.0

Installation

Through NPM as [@chubbyts/chubbyts-dic][1].

``ts
npm i @chubbyts/chubbyts-dic@^2.0.2
`

Usage

$3

`ts
import { Container } from '@chubbyts/chubbyts-dic-types/dist/container';
import { createContainer } from '@chubbyts/chubbyts-dic/dist/container';
import { Logger } from 'some-logger/dist/logger';
import { createMyService, decorateMyService, MyService } from './service/my-service';

const container = createContainer();

container.sets(new Map([
['myService', (container: Container): MyService => {
return createMyService(container.get('logger'));
}]
]));

`

$3

`ts
import { Container } from '@chubbyts/chubbyts-dic-types/dist/container';
import { createContainer, createParameter, Factory } from '@chubbyts/chubbyts-dic/dist/container';
import { Cache } from 'some-cache/dist/cache';
import { Logger } from 'some-logger/dist/logger';
import { createMyService, MyService } from './service/my-service';

const container = createContainer();

// new
container.set('myService', (container: Container): MyService => {
return createMyService(container.get('logger'));
});

// existing (replace)
container.set('myService', (container: Container): MyService => {
return createMyService(container.get('logger'));
});

// existing (extend)
container.set('myService', (container: Container, existingFactory?: Factory): MyService => {
if (!existingFactory) {
throw 'Missing service';
}

return decorateMyService(existingFactory(container), container.get('cache'));
});

// parameter
container.set('param', createParameter('value'));
`

$3

`ts
import { createContainer } from '@chubbyts/chubbyts-dic/dist/container';
import { MyService } from './service/my-service';

const container = createContainer();

container.get('myService');
`

$3

`ts
import { createContainer } from '@chubbyts/chubbyts-dic/dist/container';

const container = createContainer();

container.has('myService');
``

Copyright

2025 Dominik Zogg

[1]: https://www.npmjs.com/package/@chubbyts/chubbyts-dic
[2]: https://www.php-fig.org/psr/psr-11
[3]: https://www.npmjs.com/package/@chubbyts/chubbyts-dic-types