Express 계약

Express 타입 경계 점검 흐름

요청이 라우터로 들어온 뒤 파라미터, 본문, 응답, 오류 타입을 단계별로 분리하면 서버 코드가 예측 가능해진다.

입구 검증

Route Params

URL에서 온 값은 문자열 기반이므로 검증 후 도메인 타입으로 바꾼다.

본문 계약

Request Body

DTO 타입과 런타임 검증을 함께 두어 잘못된 입력을 일찍 거른다.

확장 타입

Middleware

인증 결과처럼 request에 추가되는 값은 선언 병합으로 명확히 한다.

출구 계약

Response Shape

성공과 실패 응답 구조를 정해 컨트롤러 반환을 고정한다.

Express 타입 경계

Express의 자유도는 타입 경계를 직접 세울 때 장점으로 바뀐다.