TypeScript 第 2 弾: zod で入力検証、JSON に永続化、Node 標準テストで守る

このラボでは、社内ツールの API をチームで使える品質に引き上げる担当の想定で、入力検証・永続化・自動テストの 3 つを実装します。

ブラウザで開く IDE に、第 1 弾の完成版 TODO API（src/app.ts）と、依存パッケージ（express / zod / tsx / typescript）がインストール済みの状態で用意されています。zod でスキーマを書いて不正な入力を 400 で弾き、todos.json に保存して再起動しても消えないようにし、node:test でテストを書いて npm test で守れるようにします。

学習目標:

• zod でスキーマ（必須・文字数・enum・既定値・書式）を定義し、ミドルウェアで検証して 400 と issues を返す
• ファイル（JSON）への永続化と、起動時の復元・id の採番の続き
• クエリ パラメータ（?done=true）による絞り込み
• Node 標準のテストランナー（node:test + fetch）で API を自動テストする
• tsc --noEmit での型チェックを開発の習慣にする

• 「TypeScript で REST API を作る」ラボ相当（Express のルーティング、curl での確認）

• TodoInSchema に priority（enum、既定 normal）と due（YYYY-MM-DD）があり、型チェックが通ること
• 判定テスト（検証・既定値・絞り込み・永続化の 4 件）が合格すること（自分のテストは npm test で自己確認）
• サーバーを起動したまま判定を実行し、/health と本文なし POST の 400 が確認できること

1. ブラウザ IDE を開いて土台を確認する

• ラボ画面の ブラウザ IDE を開く をクリックし、表示されているパスワードでサインインする
• src/app.ts（完成版の TODO API に TODO 1〜4 が追記されたもの）、src/store.ts、src/app.test.ts を開いて全体を眺める
• Terminal → New Terminal でターミナルを開き、まず現状で型チェックとテストが動くことを確認する

npm run typecheck
npm test

• 2 件のテストが pass することを確認する（# pass 2）

• zod 公式（英語）
• Node.js: node:test（英語）
• Express: ミドルウェアの書き方（英語）
• Node.js: fs.readFileSync / writeFileSync（英語）