JSON Schema para Zod
Converta um Schema JSON em schemas Zod. Types, propriedades obrigatórias, enums, const, anyOf, oneOf e allOf são mapeados para os construtores Zod, e palavras-chave de validação comuns, como minLength, maximum, pattern, format e minItems, passam a ser verificações Zod. Cada definição passa a ser um schema exportado com um tipo z.infer.
Perguntas frequentes
Quais palavras-chave de validação são convertidas?
minLength e maxLength passam a ser .min() e .max() em strings; pattern passa a ser .regex(); e os formatos email, uri, uuid e date-time passam a ser .email(), .url(), .uuid() e .datetime(). minimum, maximum, exclusiveMinimum, exclusiveMaximum e multipleOf passam a ser verificações de número, e minItems e maxItems passam a ser verificações de array.
Como as definições são ordenadas?
Cada definição é declarada antes dos schemas que a usam. Uma definição que se refere a si mesma, diretamente ou por meio de outras, é referenciada com z.lazy para que o código continue funcionando.
Schemas recursivos passam na verificação de tipos?
Eles funcionam, mas TypeScript não consegue inferir o tipo de um schema que se refere a si mesmo por meio de z.lazy. Adicione uma anotação de tipo explícita a esse schema, conforme a documentação de Zod descreve para tipos recursivos.
Como additionalProperties é tratado?
additionalProperties false adiciona .strict(); um schema adiciona .catchall() com esse schema; true adiciona .passthrough(); e um objeto sem propriedades, mas com um schema additionalProperties, passa a ser z.record(z.string(), ...).
Qual versão de Zod o código tem como alvo?
Os construtores gerados, como z.object, z.union, z.record com um schema de chave e .nullable(), existem em Zod 3 e Zod 4. Zod 4 ainda aceita os métodos de formato de string, como .email(), embora também ofereça z.email() como forma abreviada.
O que acontece com as referências que a ferramenta não consegue resolver?
Referências externas ao documento, como as que apontam para outro arquivo ou para um URL, passam a ser z.unknown() e são listadas em um comentário no início da saída.