zod-validation-expert

Define a Zod schema for your form fields, infer the TypeScript type with z.infer, and pass the schema to useForm through zodResolver from @hookform/resolvers/zod. Validation errors then map automatically to each registered input field.

parse throws a ZodError when validation fails, requiring try/catch blocks. safeParse returns a result object with a success flag, letting TypeScript narrow the type so you can handle errors without exceptions.

Define a schema describing each variable, using z.coerce.number() for ports and z.enum for NODE_ENV, then call schema.parse(process.env) at startup. The application fails immediately if any variable is missing or invalid.

Yes, use .refine() on the object schema to compare fields, and pass the path option so the error attaches to the correct input such as confirmPassword. For more complex logic, use .superRefine().

The .optional() modifier only permits undefined, not empty strings. To treat empty strings as missing values, preprocess them with a transform that converts empty strings to undefined before applying .optional().

This error appears with deeply recursive schemas. Use z.lazy() for self-referential structures and define the base TypeScript type explicitly instead of relying solely on type inference.