> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wyrly.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> 型付きトークンを作成し、プロバイダーを登録して、スコープから use case を解決します。

この guide では、Wyrly の最小構成を示します。型付きポート、具体的な実装、use case、リクエスト風スコープの 4 要素を使います。

## Token を作る

トークンは、インターフェースベースの依存関係を実行時でも型安全に保つために使います。

```ts theme={null}
import { createContainer, Injectable, token } from "@wyrly/core";

interface User {
  id: string;
}

interface UserRepository {
  findById(id: string): Promise<User | null>;
}

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

## Use case を定義する

`@Injectable` は依存関係を明示的に宣言します。Wyrly はコンストラクタのパラメーター型を実行時に読み取りません。

```ts theme={null}
@Injectable({
  deps: [UserRepositoryToken],
  lifetime: "scoped",
})
class GetUserUseCase {
  constructor(private readonly users: UserRepository) {}

  execute(id: string) {
    return this.users.findById(id);
  }
}
```

## プロバイダーを登録する

具体的な実装は composition root で登録します。

```ts theme={null}
class InMemoryUserRepository implements UserRepository {
  async findById(id: string): Promise<User | null> {
    return { id };
  }
}

const container = createContainer();

container.register(UserRepositoryToken, {
  useClass: InMemoryUserRepository,
  lifetime: "scoped",
});

container.register(GetUserUseCase);
```

## スコープから解決する

リクエスト単位の処理では scope を作り、リクエストが終わったら破棄します。

```ts theme={null}
const scope = container.createScope();

try {
  const usecase = scope.resolve(GetUserUseCase);
  const user = await usecase.execute("user-1");
  console.log(user);
} finally {
  await scope.dispose();
}
```

## グラフを検証する

テストや CI で検証を実行すると、プロバイダーの不足やライフタイムの問題を早期に検出できます。

```ts theme={null}
const result = container.validate();

if (!result.ok) {
  throw new Error(result.issues.map((issue) => issue.message).join("\n"));
}
```

## 次のステップ

* [core model](/ja/concepts/core-model) を学ぶ
* [framework adapter](/ja/guides/framework-adapters) を選ぶ
* 実行可能な [examples](/ja/guides/examples) を確認する