Пакет @nrgyjs/ditox

Назначение пакета

Пакет @nrgyjs/ditox интегрирует декларации контроллеров Nrgy.js с DI-контейнером ditox.

Общая информация

Пакет добавляет extensions, которые делают контейнер ditox доступным внутри контроллеров и view-model. Также он предоставляет helper для адаптации контроллеров с injections к конфигурации DI.

Установка пакета

npm install @nrgyjs/core @nrgyjs/ditox ditox

yarn add @nrgyjs/core @nrgyjs/ditox ditox

pnpm add @nrgyjs/core @nrgyjs/ditox ditox

Концептуальная архитектура

Пакет намеренно небольшой и целиком построен на extension-механизме из @nrgyjs/core.

1. withContainer() добавляет активный ditox-контейнер в контекст контроллера.
2. withInjections() резолвит карту токенов из контейнера и публикует результат как deps в контексте контроллера.
3. applyInjections() адаптирует декларацию контроллера к функции, удобной для использования в DI-конфигурации.

Документация по функционалу

• applyInjections: адаптер из декларации контроллера в container-aware фабрику.
• withContainer: extension для передачи ditox-контейнера.
• withInjections: extension для резолва токенов в deps.

Примеры использования

import { declareController } from '@nrgyjs/core';
import { withInjections } from '@nrgyjs/ditox';
import { token } from 'ditox';

const LOGGER = token<(message: string) => void>();

const LoggerController = declareController()
  .extend(withInjections({ log: LOGGER }))
  .apply(({ deps }) => ({
    write: (message: string) => deps.log(message),
  }));