코드 생성기 개발 기록 (Part 2): 스키마 검증 및 타입 가드 구현 과정

요약

본 글은 OpenAPI Specification(OAS)을 기반으로 코드 생성기, 스키마 검증기, 타입 가드를 구현한 과정을 설명합니다. 이 시스템의 목표는 프론트엔드 엔지니어가 API 스키마 변화에 쉽게 대응하고, OAS와 실제 API 응답 간의 일관성을 통합 테스트로 검증하는 것입니다.

핵심 포인트

• OAS JSON을 파싱하여 원하는 형태의 결과물을 파일로 자동 생성합니다.
• API 응답 정의를 기반으로 스키마 유효성 검사를 위한 타입 가드가 자동으로 생성됩니다.
• 통합 테스트를 통해 OAS에 선언된 스키마와 실제 API 응답 간의 일치 여부를 검증할 수 있습니다.
• 코드 구조 설계 시, 책임 분리(Service layer) 및 코드 중복 최소화에 집중했습니다.