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と組み合わせて1つのスキーマから実行時検証と静的型推論を同時に取得。

変換例

ルート名を 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 は 2 件の注文のうち 1 件にしかないので optional になります。出力には Zod 3 と Zod 4 の両方で動く書き方だけを使っています。

生成したスキーマの調整

サンプルには各フィールドの値が 1 つしかないため、業務ルールは推論できません。使う前に次の点を確認してください。

失敗したら処理を止めたい場所（起動時の設定読み込みなど）では .parse() を使います。ZodError を投げます。API レスポンスやユーザー入力には .safeParse() を使います。{ success: false, error } を返すので、エラーを自分で処理できます。

制限事項

• 型は 1 つのサンプルから決まります。 空の配列は z.array(z.unknown())、空のオブジェクトは z.record(z.string(), z.unknown()) になります。
• null は z.null() になります。 .nullable() は付きません。オブジェクトの配列で、あるキーが 1 件目で null、2 件目で文字列のときは z.union([z.null(), z.string()]) になります。
• 型が混ざった配列は union になります。 [{"a": 1}, 2] のような配列は、ルートでもオブジェクトの中でも z.array(z.union([z.number().int(), z.object({ a: z.number().int() })])) になります。同じ配列のオブジェクトは 1 つの z.object にまとめるので、union のオブジェクトは 1 つです。
• 文字列の形式や範囲は付きません。 メール、URL、日付、UUID はすべて z.string() です。