Samchil
Verified

Env Config Validator

typed Zod schema와 redacted validation error로 runtime environment configuration을 검증하는 Verified Samchil module입니다.

store listing은 Polar checkout으로 구매 가능합니다. 결제 확인 후 GitHub repository access는 Polar에 연결된 GitHub benefit으로 처리됩니다.

Public API

  • createEnvConfig는 input을 검증하고 typed config를 반환합니다.
  • EnvValidationError는 읽을 수 있는 validation failure detail을 제공합니다.
  • booleanFromEnv, numberFromEnv, jsonFromEnv는 자주 쓰는 environment string conversion helper입니다.

Input 및 schema 동작

  • Default input은 process.env이며, test와 example은 plain object를 전달할 수 있습니다.
  • required, optional, default, enum, URL, unknown-key behavior는 caller의 Zod schema에 위임됩니다.
  • Unknown key는 caller가 strict Zod schema를 사용할 때만 fail합니다.

Secret redaction

  • Default secret key detection은 secret, password/passwd, token, api key, private key를 포함하는 일반적인 이름을 감지합니다.
  • Caller는 secretKeys로 exact string 또는 regular expression matcher를 추가할 수 있습니다.
  • root-level, cross-field, JSON-parsed validation message에서 secret-like raw value가 message에 나타나면 redaction됩니다.