API 開発とインターフェース統合

いまのプロジェクト向けに、完全なユーザー管理 RESTful API を設計実装してほしい。

機能要件：
- ユーザー登録（メール＋パスワード、パスワード暗号化保存）
- ユーザーログイン（JWT token 認証）
- ユーザー情報取得（認証必須）
- ユーザー情報修正（認証必須）
- ユーザーリスト（ページネーション、検索、管理者権限）

技術要件：
1. RESTful スタイル、HTTP メソッドとステータスコード正規
2. リクエストパラメータ校検（Joi/Zod/Pydantic、プロジェクト言語に応じて）
3. 統一応答形式：{ code, data, message }
4. 完全なエラー処理とログ記録
5. Swagger/OpenAPI ドキュメント生成
6. Postman/Insomnia テストセット生成

プロジェクトのテックスタックに応じて実装、コードスタイルの統一を保つこと。

これはサードパーティサービスの API ドキュメント：

[Swagger/OpenAPI JSON または URL を貼り付け]

このドキュメントから TypeScript SDK クライアントを生成してほしい：
1. 各インターフェース向けに方法を生成（完全な型定義付き）
2. 統一 HTTP クライアント（axios/fetch ベース）
3. リクエストインターセプタ：自動 Authorization header
4. 応答インターセプタ：統一エラー処理と再試行
5. リクエストタイムアウトとキャンセル対応
6. TypeScript 型定義全部エクスポート
7. README と使用例を書く

SDK は Tree-shaking をサポート、必要なインターフェースだけ import、不要なのは bundle に入らない。

いまのプロジェクトの API サービスに以下ミドルウェアを追加：

1. 速度制限ミドルウェア（Rate Limiting）：
   - デフォルト：各 IP は 1 分 60 リクエスト
   - ログインインターフェース：各 IP は 1 分 5 リクエスト
   - X-RateLimit-* 応答ヘッダーを返す
   - 超過時 429 + わかりやすいエラーメッセージ

2. 認証ミドルウェア（Authentication）：
   - JWT Token 検証
   - Token 過期時に自動更新（Refresh Token 機制）
   - ロール権限チェック（admin / user / guest）

3. ログミドルウェア（Logging）：
   - 各リクエストのメソッド、パス、実行時間、ステータスコード
   - エラーリクエストは自動でリクエスト body と stack trace を記録
   - ログ形式は ELK または CloudWatch に対応

ミドルウェアの実行順序を確認、ルートに登録するコード提供。