Schema 중심 검증과 Guard 중심 Narrowing의 전략적 분리

Context

TypeScript 환경에서 Zod와 같은 Schema 기반 라이브러리가 런타임 검증의 표준으로 자리 잡았으나, 내부 로직 내에서 빈번하게 발생하는 Type Narrowing 시 과도한 Schema 의존성과 복잡한 검증 절차가 병목으로 작용함.

Technical Solution

• Zero-dependency 기반의 Lightweight Guard Toolkit 도입을 통한 런타임 오버헤드 최소화
• Schema 정의 후 타입을 추출하는 방식 대신, Type Guard 함수를 통한 자연스러운 Control Flow Narrowing 구현
• and, or, not, oneOf 등 논리 연산자를 이용한 Guard Composition 구조 설계로 재사용성 확보
• struct 및 optionalKey를 활용하여 객체 형태 검증과 Type narrowing을 동시에 수행하는 로직 구현
• Boundary 단계의 Schema Validation과 내부 로직의 Guard Narrowing을 분리하는 계층적 검증 전략 채택