Core model

Wyrly の core model は小さく保たれています。ほとんどの application で必要なのは、tokens、 providers、containers、scopes、lifetimes の 5 つです。

Tokens

トークンは TypeScript の型を持つ実行時のキーです。

const UserRepositoryToken = token<UserRepository>("UserRepository");

インターフェースや抽象的な機能にはトークンを使います。クラス自体が依存のキーになる場合は、クラスのコンストラクタを直接登録することもできます。

プロバイダーは、依存関係をどのように作成または返すかをコンテナに伝えます。 Wyrly は以下に対応しています。

ルートコンテナはアプリケーション全体の登録を管理します。

const container = createContainer();
container.register(UserRepositoryToken, {
  useClass: PrismaUserRepository,
  lifetime: "scoped",
});

ルートコンテナは composition root として扱います。ドメインや use case のコードの中ではなく、そこに具体的なインフラ実装を登録してください。

スコープは子の依存解決コンテキストです。Web アプリでは、アダプターが通常 1 リクエストにつき 1 スコープを作ります。

const scope = container.createScope();
try {
  const service = scope.resolve(MyService);
} finally {
  await scope.dispose();
}

スコープ付きの依存関係は同じスコープ内で再利用され、スコープが破棄されると一緒に破棄されます。

依存関係の状態とリソースの所有権に合う、最も狭いライフタイムを選んでください。

本番環境に出す前に依存グラフの問題を検出するには、container.validate() を使います。

検証は依存の組み立てを検査可能な成果物にできるため、CI で特に有用です。