Zero-dependency 기반의 Strict Type Validation을 통한 Env 설정 오류 원천 차단

Context

TypeScript의 타입 시스템만으로는 런타임에 주입되는 외부 환경 변수의 유효성을 보장할 수 없는 한계 존재. 단순 Casting 방식의 타입 변환 시 'false' 문자열이 Boolean true로 해석되는 등 잘못된 설정값이 배포 단계까지 유입되는 위험성 상존.

Technical Solution

• Application Boundary에 엄격한 Validation Layer를 구축하여 런타임 진입 전 설정값 검증
• Type Casting 대신 Explicit Validation 로직을 적용하여 빈 문자열, 잘못된 URL 스킴(file:// 등)을 명시적으로 거부
• Vite의 VITE_ prefix 및 Next.js의 NEXT_PUBLIC_ prefix 체계와 결합한 Config Module 설계로 노출 범위와 유효성을 동시 제어
• REQUIRED, INVALID_URL 등 세분화된 Error Code 체계를 도입하여 CI/CD 파이프라인 및 CLI에서 프로그래밍 방식의 에러 처리 구현
• Zero-dependency 설계를 통해 런타임 오버헤드를 최소화하고 인프라 종속성 제거

Key Takeaway

환경 변수는 외부 입력값으로 간주하여 내부 로직에 도달하기 전 반드시 Validation 단계를 거쳐야 하며, '파싱 가능한 값'과 '유효한 값'을 엄격히 구분하는 설계 원칙이 필요함.