JSON Schema a Zod
Convierte un esquema JSON en esquemas Zod. Los tipos, las propiedades obligatorias, los enums, const, anyOf, oneOf y allOf se asignan a sus constructores Zod, y las palabras clave de validación habituales, como minLength, maximum, pattern, format y minItems, se convierten en comprobaciones Zod. Cada definición se convierte en un esquema exportado con un tipo z.infer.
Preguntas frecuentes
¿Qué palabras clave de validación se convierten?
minLength y maxLength se convierten en .min() y .max() para cadenas; pattern se convierte en .regex(); y los formatos email, uri, uuid y date-time se convierten en .email(), .url(), .uuid() y .datetime(), respectivamente. minimum, maximum, exclusiveMinimum, exclusiveMaximum y multipleOf se convierten en comprobaciones numéricas, y minItems y maxItems, en comprobaciones de matrices.
¿En qué orden se declaran las definiciones?
Todas las definiciones se declaran antes que los esquemas que las usan. Una definición que se referencia a sí misma, directamente o a través de otras, se referencia con z.lazy para que el código siga ejecutándose.
¿Se comprueban los tipos de los esquemas recursivos?
Se ejecutan, pero TypeScript no puede inferir el tipo de un esquema que se referencia a sí mismo mediante z.lazy. Añade una anotación de tipo explícita a ese esquema, como se describe en la documentación de Zod sobre tipos recursivos.
¿Cómo se gestiona additionalProperties?
additionalProperties false añade .strict(); un esquema añade .catchall() con ese esquema; true añade .passthrough(); y un objeto sin propiedades, pero con un esquema additionalProperties, se convierte en z.record(z.string(), ...).
¿A qué versión de Zod se dirige el código?
Los constructores generados, como z.object, z.union, z.record con un esquema de clave y .nullable(), están disponibles en Zod 3 y Zod 4. Zod 4 sigue admitiendo los métodos de formato de cadena, como .email(), aunque también ofrece z.email() como forma abreviada.
¿Qué ocurre con las referencias que la herramienta no puede resolver?
Las referencias externas al documento, como las que apuntan a otro archivo o a un URL, se convierten en z.unknown() y se incluyen en un comentario al principio del resultado.