100년 가는 프론트엔드 코드, SDK

간단 소개

토스페이먼츠가 프론트엔드 SDK 개발의 어려움을 극복하고 안정성, 확장성, 명확성을 갖춘 V2 SDK를 구축한 과정.

AI Summary

SDK 개발 특수성 및 V1 한계

SDK는 가맹점 환경에 깊이 의존, 네트워크 의존성, 타입 불일치 문제와 V1의 추적/감지 미비, 확장성 부족, 문서 불일치로 개발자 고충 야기.

V2 SDK 핵심 가치 및 전략

안정성: 비즈니스 연속성 위해 단위/E2E 테스트, Global Trace ID 기반 모니터링 CLI 구축.
확장성: 가맹점 요구사항 수용 위해 계층 분리된 조립 가능한 SDK 구조 도입.
명확성: 개발자 생산성 위해 인터페이스를 계약 정의, JSDoc 명세, Git 관리, TypeScript 기반 런타임 유효성 검증 적용.