@automatons/typescript-zod

What is @automatons/typescript-zod

This is a generator that emits zod schemas from an OpenAPI document's component schemas. Only use openapi-automatons.

This package is ESM-only and requires Node.js >= 22.

For every model it emits a XxxSchema zod schema plus a type Xxx = z.infer<typeof XxxSchema>, so the inferred static type and the runtime validator never drift apart.

zod is a peer dependency — install it alongside the generated output (zod@^3 || ^4).

Generated schemas

import { PetSchema, type Pet } from "./models";

// runtime-validate an unknown payload
const pet: Pet = PetSchema.parse(await response.json());

// or non-throwing
const result = PetSchema.safeParse(payload);
if (!result.success) {
  // result.error
}

How can I use @automatons/typescript-zod?

This library is designed to be used by openapi-automatons. Please read the readme of openapi-automatons for how to use it.