핵심 요약
토스가 패키지를 ESM으로만 제공하기로 결정하고, 듀얼 패키지로 인한 문제를 해소하기 위한 ESM-only 전환을 추진했습니다.
구현 방법
- exports를 활용한 ESM 중심의 환경별 코드/타입 매핑 구성
- Node.js 22.12.0에 맞춘 호환성 점검과 top-level await 제약 대응
- TypeScript 설정 재정비 및 외부 라이브러리 타깃 경로 재설계로 타입 연결 안정화
주요 결과
- 코드/타입 분리 부담 감소 및 디버깅 간소화
- 예측 가능성과 안정성 개선
- 도구 버전 관리의 이점 활용 및 개발 생산성 향상
