zodios 는 응답 검증이 실패하면 ZodError 를 그대로 던지지 않고 ZodiosError 의 cause 에 담아 던진다. 그래서 instanceof z.ZodError 로는 잡히지 않고, ZodiosError 인지 본 뒤 cause 가 ZodError 인지 확인해 fromZodError 로 읽는다.

-- zodios: 응답 검증 실패를 ZodiosError 로 감싸고 ZodError 는 cause 에 둔다
zodError :: Error -> Maybe ZodError
zodError (ZodiosError { cause = Just (ZodErr z) }) = Just z   -- err instanceof ZodiosError && err.cause instanceof ZodError
zodError (ZodErr z)                                = Just z
zodError _                                         = Nothing
-- instanceof z.ZodError 만 보면 놓친다 → fromZodError(err.cause).toString()
#278

process.env 를 z.object 스키마로 parse 하면 빠지거나 형식이 틀린 값은 앱이 시작할 때 ZodError 로 바로 터진다 — 쓰는 순간이 아니라. 통과하면 결과에는 스키마에 선언한 키만 남고 나머지 환경 변수는 걸러진다. NODE_ENV 처럼 default 를 주면 없을 때 그 값이 들어간다. window 전역도 같은 방식으로 읽는다.

-- 환경 변수를 스키마로: 빠지면 시작할 때 터지고, 선언한 키만 남는다
parse :: Schema a -> Env -> Either ZodError a     -- .parse 는 Left 를 throw

envSchema = object
  [ ("REACT_APP_FEATURE_RECORDS", string)
  , ("NODE_ENV", enum ["development", "test", "production"] `withDefault` "development") ]

ENV    = parse envSchema    processEnv   -- PATH 같은 선언 안 한 키는 strip
WINDOW = parse windowSchema window
#280

expect.extend 로 toMatchSchema 를 추가한다. 매처는 Response 의 json 을 꺼내 schema.safeParseAsync 로 검사하고 성공 여부를 pass 로 돌려준다. 비동기 매처라 타입 선언의 반환은 R 이 아니라 Promise<void> 이고, 테스트에서 await expect(res).toMatchSchema(schema) 로 기다려야 한다.

-- expect.extend: Response 의 본문이 Zod 스키마에 맞는가
toMatchSchema :: Response -> Schema -> IO MatcherResult
toMatchSchema res schema = do
  body <- json res
  r    <- safeParseAsync schema body
  pure MatcherResult { pass = success r, message = "" }

-- declare module 'vitest' { interface Matchers<R, T> { toMatchSchema: (s) => Promise<void> } }
-- 비동기 매처: 반환 타입은 R 이 아니라 Promise<void>, 테스트에서 await
-- await expect(todoResponse).toMatchSchema(todoSchema)
#317