Compile Zod schemas

Set compile to wrap generated schemas in z.compile(...) for faster validation, and see which schemas stay on the interpreter. Needs Zod 4.5 or later.

Turn on compile

Pass true, or { strict: true } to make Zod throw when a part cannot be compiled. The schemas that stay uncompiled are not wrapped, so they raise no error.

import { pluginZod } from '@kubb/plugin-zod'

pluginZod({ compile: true })

export const petSchema = z.compile(
  z.object({
    id: z.int(),
    name: z.string(),
  }),
)

Schemas that stay uncompiled

Kubb leaves these schemas without z.compile(...):

• Schemas with circular references (z.lazy).
• Bare $ref response aliases. An alias that adds a description, such as petSchema.describe('A pet'), is compiled.
• With strict: true, a z.coerce or z.xor schema, a union with such a member, and a schema that reaches a circular one through a $ref. The module then loads without a ZodCompileUnsupportedError.

Coerced and int64 fields

Every format: int64 schema is coerced, and so is every schema that coercion covers.

• An object or array that holds a coerced field is still compiled, and Zod runs that field on its interpreter.
• To compile an int64 schema, set integerType: 'number' on the adapter.

For every option value, see compile.