토스뱅크, 패키지 문법·파일 구조 유지하고 최종 변환은 서비스에 맡겨
토스뱅크가 공통 패키지의 JavaScript 문법과 파일별 모듈 구조를 유지하고, 실행 환경별 문법 변환·최종 번들링은 사용하는 서비스에 맡기도록 기준을 정했다. API 지원 범위를 타입 검사에 반영하고, 원본 파일과 declaration sourcemap을 배포해 IDE에서 구현을 바로 확인하도록 했다.
패키지 빌드에서는 TypeScript를 JavaScript로 변환하고, 브라우저·런타임별 문법 변환과 최종 번들링은 호스트 서비스가 담당한다.
낮은 target을 지정해도 변환 도구가 지원하지 않는 문법까지 처리되지는 않는다. API도 대상 환경이나 폴리필이 제공하는지 별도로 확인한다.
TypeScript 설정만으로 호환성을 모두 검증할 수 없어 실제 API 지원과 문법 변환 가능 여부도 점검한다.
원본 파일과 declaration sourcemap을 설치 패키지에 포함해 타입 선언에서 실제 구현으로 이동할 수 있게 한다.
파일 경계를 보존하면 Next.js의 'use client'가 유틸리티 코드까지 적용되는 일을 피할 수 있다.
원문
- 토스뱅크가 패키지를 관리하는 방식 #2: 토스뱅크 패키지의 세 가지 기준토스 테크 · 원문 2026-10-16