JSON Schema ⇄ Zod 변환

OpenAPI 정의에서 프런트엔드 타입과 검증 만들기

OpenAPI의 components.schemas는 JSON Schema이므로 그대로 붙여 넣으면 Zod 스키마와 z.infer 타입을 한 번에 얻을 수 있습니다. 서버 정의와 프런트 검증이 어긋나는 것을 막아 줍니다.

기존 Zod 스키마를 API 명세로 내보내기

코드에서 Zod 스키마를 먼저 작성했다면 반대 방향 변환으로 JSON Schema를 만들어 OpenAPI의 components나 문서에 붙여 넣을 수 있습니다.

손으로 쓴 검증을 스키마 기반으로 옮기기

if 문으로 흩어진 검증을 교체할 때, JSON Schema가 있으면 출발점이 되는 Zod 스키마를 한 번에 생성할 수 있어 required나 enum을 빠뜨릴 일이 줄어듭니다.

AI가 만든 JSON Schema를 실제로 쓸 수 있는 형태로

LLM에 작성시킨 JSON Schema를 그대로 붙여 넣어 TypeScript에서 동작하는 Zod 스키마로 바꾸고, 타입과 런타임 검증을 동시에 얻을 수 있습니다.

$ref·allOf·조건 분기는 전개되지 않습니다

$ref는 참조를 해결하지 않고 z.any()가 되며, allOf는 첫 번째 서브스키마만 변환합니다. if/then/else와 not은 지원하지 않습니다. 모두 결과 아래에 경고로 표시되므로 해당 부분은 직접 보완해 주세요.

Zod→JSON Schema는 코드를 문자열로 해석합니다

브라우저 안에서 처리하기 위해 코드를 실행하지 않고 텍스트로 파싱합니다. z.object / z.array / z.union / z.enum / z.literal / z.record와 주요 메서드 체인은 지원하지만, 변수로 분리한 스키마 참조나 .refine() 같은 임의 함수는 JSON Schema로 표현할 수 없어 무시됩니다.

pattern의 정규식은 그대로 옮겨집니다

JSON Schema의 pattern은 z.string().regex()가 되고, 반대 방향에서는 그 내용이 pattern에 들어갑니다. JSON Schema는 ECMAScript 호환이 아닌 정규식도 허용하므로 그대로 옮기면 동작이 달라질 수 있습니다.

생성 결과는 반드시 검토하세요

이 도구는 마이그레이션의 출발점을 만들기 위한 것입니다. 업무 규칙이나 필드 간 정합성 검사는 원래 스키마에 없으면 생성되지 않으므로, 운영에 쓰기 전에 내용을 확인해 주세요.