JSON → Zod 스키마

출력 형식

완전한 TypeScript 스니펫을 출력합니다:

• import { z } from “zod” — Zod 가져오기
• const FooSchema = z.object({…}) — 스키마 정의
• export type Foo = z.infer<typeof FooSchema> — 추론된 TypeScript 타입

주요 사용 사례

• API 유효성 검사: API 응답 예시에서 스키마를 생성하여 실제 응답을 런타임에 검증.
• 폼 유효성 검사: 폼 데이터 형태를 Zod 스키마로 변환하여 react-hook-form 등에서 활용.
• 설정 파일: JSON 파일에서 로드하는 설정 객체를 정의하고 검증.
• 타입 안전성: TypeScript와 결합하여 하나의 스키마에서 런타임 검증과 정적 타입 추론을 동시에.

변환 예시

루트 이름을 User로 두고 다음 JSON을 넣으면

{
  "id": 42,
  "email": "alice@example.com",
  "price": 19.9,
  "tags": ["admin", "beta"],
  "metadata": null,
  "orders": [
    { "sku": "A1", "qty": 2 },
    { "sku": "B7", "qty": 1, "note": "gift" }
  ]
}

다음 결과가 나옵니다.

import { z } from "zod";

const UserSchema = z.object({
  id: z.number().int(),
  email: z.string(),
  price: z.number(),
  tags: z.array(z.string()),
  metadata: z.null(),
  orders: z.array(z.object({
    sku: z.string(),
    qty: z.number().int(),
    note: z.string().optional(),
  })),
});

export type User = z.infer<typeof UserSchema>;

주문 두 건 중 한 건에만 note가 있으므로 note는 optional입니다. 출력에는 Zod 3과 Zod 4에서 모두 동작하는 호출만 씁니다.

생성된 스키마 다듬기

샘플에는 필드마다 값이 하나뿐이라 업무 규칙은 알 수 없습니다. 사용하기 전에 다음을 확인하세요.

실패하면 멈춰야 하는 곳(시작 시 설정 읽기 등)에는 .parse()를 씁니다. ZodError를 던집니다. API 응답과 사용자 입력에는 .safeParse()를 씁니다. { success: false, error }를 반환하므로 오류를 직접 처리할 수 있습니다.

제한 사항

• 타입은 샘플 하나로 정해집니다. 빈 배열은 z.array(z.unknown()), 빈 객체는 z.record(z.string(), z.unknown())가 됩니다.
• null은 z.null()이 됩니다. .nullable()은 붙지 않습니다. 객체 배열에서 어떤 키가 첫 항목에서 null, 두 번째 항목에서 문자열이면 z.union([z.null(), z.string()])이 됩니다.
• 타입이 섞인 배열은 union이 됩니다. [{"a": 1}, 2] 같은 배열은 루트에 있든 객체 안에 있든 z.array(z.union([z.number().int(), z.object({ a: z.number().int() })]))가 됩니다. 같은 배열의 객체는 하나의 z.object로 합치므로 union의 객체 멤버는 하나입니다.
• 문자열 형식과 범위는 없습니다. 이메일, URL, 날짜, UUID는 모두 z.string()입니다.