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互換でない正規表現も許容するため、そのまま持ち込むと挙動が変わる場合があります。

生成結果は必ずレビューしてください

このツールは移行のたたき台を作るためのものです。業務ルールや値どうしの整合性チェックは元のスキーマに書かれていない限り生成されません。本番のバリデーションに使う前に内容を確認してください。