業務イベントごとに予約の状態を変える関数を、この Session では遷移関数と呼びます。この Session の開始コード(examples/session-01)は、状態の名前を格納する項目 kind で 6 つの状態を分け、状態ごとの遷移関数を持ちます。
遷移関数には、requireKind で例外(処理を中断してエラーを知らせる仕組み)を投げる検証があります。残る問題は、コードの誤りを検出できるのが実行したときだけであることです。startExamination の引数の型が Appointment であり、どの状態の予約も受け取るためです。この Session の目的は、誤った状態の予約を渡すコードの誤りを型検査のときに検出することで、ゴールは、遷移関数の引数を、受け取れる状態の型に絞ることです。
examples/session-01/src/domain/appointment/transitions.tsexport const startExamination = (
appointment: Appointment,
veterinarianId: string,
examinationStartedAt: string,
): Appointment => {
requireKind(appointment, ["CheckedIn"]);
return ({ ...appointment, kind: "InExamination", veterinarianId, examinationStartedAt }) as Appointment;
}; startExamination の入口 引数の型は Appointment。6つの状態をすべて受け取ります。
- 予約済み
Scheduled型検査: 受け取る 実行: × 例外 - 来院済み
CheckedIn型検査: 受け取る 実行: ✓ 診察中になる - 診察中
InExamination型検査: 受け取る 実行: × 例外 - 会計待ち
AwaitingPayment型検査: 受け取る 実行: × 例外 - 会計済み
Paid型検査: 受け取る 実行: × 例外 - キャンセル
Canceled型検査: 受け取る 実行: × 例外
予約済みの予約も、引数の型 Appointment は受け取ります。型検査は報告しません。実行すると、requireKind が例外を投げます。requireKind は、kind が許可された状態でなければ例外を投げる関数です。
来院済みの予約は、診察を開始してよい状態です。型検査も、実行時の requireKind も通ります。
診察中、会計待ち、会計済み、キャンセルの予約も、引数の型 Appointment は受け取ります。型検査は報告せず、実行すると requireKind が例外を投げます。
型検査は、6つの状態をすべて受け取ります。許可されない状態の予約を渡すコードの誤りを検出できるのは、実行したときだけです。