OpenAPI 기반 Code Generator 개발기: 프론트엔드 개발 생산성 UP!

Code generator는 전처리, Task 실행, 결과 출력 3단계로 구성된다. ConfigProvider를 통해 옵션을 유연하게 관리하고, PreprocessPipe를 사용하여 OAS JSON을 가공한다. 따라서, 각 단계별로 책임 분리를 통해 유지보수성을 높였다.

JSON schema를 기반으로 Type guard를 자동 생성하여 API response의 유효성을 검증한다. jsonschema 라이브러리를 활용하여, OAS schema를 검증 가능한 형태로 변환한다. 반면, GraphQL과 같은 강력한 타입 시스템에 비해, 수동 관리의 위험성이 존재한다.

Inversify를 사용하여 의존성 주입(IoC)을 구현하고, tsup과 Release Please를 통해 빌드 및 배포 자동화를 구축했다. Commitlint를 도입하여 커밋 메시지 일관성을 유지하고, 코드 중복을 최소화하기 위해 노력했다.