診察開始の入力を境界で検証する

コードを読み、失敗を再現する

routes.tsからparseへ渡すraw objectと、startExaminationInput.tsが必ずOkを返す実装を順に読み、night-shiftが型付き入力になる理由を確認します。

編集する範囲は examples/session-04/src/boundary、変更するファイル数は最大 1ファイル・約18行です。

1. 診察開始のHTTP入力はrouteで組み立てている

     app.post("/appointments/:appointmentId/start-examination", async (context) => {
       const raw = await context.req.json<Readonly<{ veterinarianId?: unknown }>>();
       const input = StartExaminationInput.parse({
         appointmentId: context.req.param("appointmentId"),
         veterinarianId: raw.veterinarianId,
       })._unsafeUnwrap();
       const current = appointmentOrThrow(repository, input.appointmentId);

   path parameterの予約IDとrequest bodyのveterinarianIdを、raw objectへまとめてStartExaminationInput.parseへ渡しています。 bodyへnight-shiftが入っても、境界のparserが検査しなければStartExaminationInputとして処理されます。

2. HTTP入力をanyのまま診察開始の入力へ入れている

   import type { AppointmentId } from "../domain/appointment/index.js";
   import type { VeterinarianId } from "../domain/appointment/index.js";
   import { ok, type Result } from "../shared/schemaResult.js";
   
   export type StartExaminationInput = Readonly<{
     appointmentId: AppointmentId;
     veterinarianId: VeterinarianId;
   }>;
   
   export const StartExaminationInput = {
     parse: (raw: any): Result<StartExaminationInput> =>
       ok({
         appointmentId: raw.appointmentId,
         veterinarianId: raw.veterinarianId,
       }),

   raw: anyから2項目をコピーし、検査せずに必ずokを返しています。 TypeScriptは返り値の型注釈を信頼するため、night-shiftもVeterinarianIdとして後続処理へ渡ります。

修正前の失敗を確認する

修正前は、次の2件に対応する演習テストが失敗します。

• 不正な予約IDでも、診察開始の入力として扱える。
• 不正な担当獣医師IDでも、診察開始の入力として扱える。

pnpm exercise:04

ブラウザ内の変更はローカルへ反映されません。

exercises/start-examination-input.test.tsimport { describe, expect, expectTypeOf, it } from "vitest";import { clinicFixture } from "../../fixtures/clinic.js";import {  StartExaminationInput,  type StartExaminationInput as StartExaminationInputValue,} from "../src/boundary/startExaminationInput.js";describe("Step 1: HTTP入力を診察開始の入力へ変換する", () => {  it("正しい予約IDと獣医師IDを型付き入力へ変換する", () => {    const result = StartExaminationInput.parse({      appointmentId: clinicFixture.appointmentId,      veterinarianId: clinicFixture.veterinarianId,    });    expect(result.isOk()).toBe(true);    expectTypeOf(result._unsafeUnwrap()).toMatchTypeOf<StartExaminationInputValue>();  });});describe("Step 2: 不正なIDを境界で拒否する", () => {  it("不正な予約IDをerrにする", () => {    expect(      StartExaminationInput.parse({        appointmentId: "invalid",        veterinarianId: clinicFixture.veterinarianId,      }).isErr(),    ).toBe(true);  });  it("不正な獣医師IDをerrにする", () => {    expect(      StartExaminationInput.parse({        appointmentId: clinicFixture.appointmentId,        veterinarianId: "night-shift",      }).isErr(),    ).toBe(true);  });});