사용하기 쉬운 Toss Front SDK 설계

Toss Place는 결제 단말기인 Toss Front의 생태계 확장을 위해 외부 연동사를 위한 SDK를 개발하고 있다. SDK의 첫인상은 도입 여부와 장기적인 유지보수에 직결되므로, 사용자가 실수하기 어려운 구조를 만드는 것이 핵심이다.

단순히 기능을 숨기는 것이 아니라, 복잡한 내부 구현을 사용자의 '의도(Intent)' 기준으로 재구성하는 Facade 패턴을 적용한다. 예를 들어, 서버 연결, 메시지 핸들러 등록, 클린업 등의 복잡한 절차를 '서버 시작'이라는 하나의 직관적인 명령으로 추상화하여 휴먼 에러를 방지한다.

효율적인 설계를 위해 low-level과 high-level 인터페이스를 공존시킨다.

• High-level (Facade): 전체 사용 사례의 80%를 차지하는 공통 유즈케이스를 담당하여 인지 부하를 줄인다.
• Low-level (Escape Hatch): 나머지 20%의 특수한 요구사항을 처리할 수 있도록 세밀한 제어 권한을 제공한다.

이러한 설계는 개발자 경험(DX)을 개선하는 동시에, 잘못된 사용 패턴으로 인한 메모리 누수나 장애를 구조적으로 방지할 수 있는 안전장치가 된다.