토스뱅크, 패키지 개발 3대 기준 공개: 안정성·예측 가능성·디버깅 편의성

토스뱅크 기술그룹이 패키지 개발 환경을 개선하기 위해 안정성, 예측 가능성, 디버깅 편의성이라는 세 가지 기준을 제시했다. 기존에는 호스트가 패키지의 지원 브라우저나 API 호환성을 별도로 확인해야 하는 번거로움이 있었으나, 이번 기준을 통해 패키지 제작자와 사용자의 역할을 명확히 구분했다.

안정성과 예측 가능성 확보

패키지는 호스트의 실행 환경에서 안정적으로 동작해야 하며, 배포 후에도 원본 코드의 의도가 유지되어야 한다. 토스뱅크는 패키지의 JavaScript 문법과 모듈 구조를 최대한 유지해 배포하기로 결정했다. 문법 변환과 최종 번들링은 각 서비스의 지원 범위를 아는 호스트가 담당하도록 해, 불필요한 코드 변환이나 파일 경계 손상을 방지한다. 예를 들어 Next.js App Router의 'use client' 지시문과 같은 파일별 경계가 번들링 과정에서 무너지지 않도록 원본 모듈 구조를 전달한다.

디버깅 편의성 강화

사용처에서 패키지 문제를 쉽게 파악할 수 있도록 declaration sourcemap을 지원한다. 이 파일은 .d.ts 선언을 원본 소스 코드 위치와 연결해 주므로, 개발자는 IDE에서 클릭 한 번으로 타입 선언 대신 실제 구현 코드를 확인할 수 있다. 이를 통해 함수의 오류 조건이나 옵션 동작을 타입 정보에만 의존하지 않고 직접 검증할 수 있게 됐다.