본인이 만든 유틸리티 라이브러리나 내부 공통 라이브러리가 있다면, 설계 시 API를 어떻게 결정했는지 그 과정을 말씀해주세요.

인턴 때 팀 내에서 반복되는 날짜 변환·포맷 코드를 공통 유틸로 분리하는 작업을 맡았습니다. 코드베이스 곳곳에 비슷한 날짜 처리가 7군데 이상 있었는데, 유지 보수가 어렵다는 팀 의견이 있었어요.

API를 결정할 때 가장 먼저 본 건 기존 코드에서 어떤 입출력 패턴이 반복되냐였습니다. 대부분 string → Date, Date → string 두 방향이었어요. 그래서 API를 parseDate(str, format), formatDate(date, format) 두 함수로 단순하게 잡았습니다. 선택적 파라미터(format)는 기본값으로 ISO8601을 두어 인자 없이도 동작하게 했고요. 실패는 타임존 처리를 첫 버전에서 빠뜨린 것이었습니다. 국내 서버만 있다고 가정했는데 해외 API 연동 이슈가 생기면서 나중에 timezone 파라미터를 추가했어요. API에 처음부터 확장 포인트를 넣어두는 게 중요하다는 걸 그때 배웠습니다.

API는 지금 필요한 것을 명확하게, 나중에 필요할 것을 무너뜨리지 않는 구조로 만드는 게 핵심이라고 생각합니다.