Web Crypto API 기반 Zero-dependency 설계로 Edge Runtime 호환성 확보 및 번들 크기 90% 절감

Context

기존 web-push 라이브러리의 Node.js 전용 Legacy Crypto API 의존으로 인한 Cloudflare Workers, Vercel Edge 등 Edge Runtime에서의 런타임 에러 발생. Node.js 생태계 중심의 설계가 서버리스 및 엣지 컴퓨팅으로의 인프라 전환 추세와 충돌하며 아키텍처적 병목 지점으로 작용.

Technical Solution

• Node.js 전용 crypto.createECDH 대신 W3C 표준인 Web Crypto API(crypto.subtle)를 채택한 런타임 독립적 구조 설계
• 외부 라이브러리 의존성을 완전히 제거한 Zero-dependency 아키텍처를 통해 Supply Chain Risk 최소화 및 경량화 달성
• HTTP 요청에 필요한 endpoint, headers, body만을 생성하는 buildPushHTTPRequest 함수로 역할을 제한하여 fetch API와의 결합도 낮춤
• JWK(JSON Web Key) 포맷의 Private Key 처리를 통해 다양한 JS 환경 간 키 호환성 및 전송 효율성 확보
• TypeScript Native 설계를 통한 정적 타입 안정성 확보 및 런타임 타입 에러 원천 차단

Impact

• 번들 사이즈 150KB+에서 15KB로 약 90% 감소
• Cloudflare Workers, Vercel Edge, Deno, Bun 등 모든 현대적 Edge Runtime에서 100% 호환성 확보
• 출시 후 마케팅 없이 월 72,500회 이상의 다운로드 기록을 통한 실효성 검증

Key Takeaway

특정 플랫폼 종속적 API보다 웹 표준(Web Standards) 기반 인터페이스를 채택함으로써 인프라 환경 변화에 유연하게 대응하는 런타임 불가지론적(Runtime-agnostic) 설계의 중요성.