zod

Define Zod validation schemas using z.object and apply safeParse at API boundaries to catch invalid data flows without throwing exceptions. This approach ensures type safety and enables precise error reporting across your TypeScript application.

Use safeParse instead of parse when handling untrusted API boundary data to avoid unhandled exceptions. SafeParse returns a structured success or error object, enabling robust error handling and precise error reporting for invalid data flows.

Infer TypeScript types from Zod schemas by applying z.infer to your schema definitions. This ensures your TypeScript types remain perfectly synchronized with runtime validation logic, eliminating manual type duplication across data flows.

Handle complex object schemas by leveraging Zod discriminated unions to validate objects with shared fields and distinct variants. This approach ensures type-safe parsing and precise error handling for multi-shape data structures at API boundaries.

Customize Zod error handling by implementing consistent error maps to format precise error reporting for multi-language user experiences. This standardizes validation feedback across API boundaries and data flows when parsing fails.

The Zod guidance covers schema composition and performance optimization by providing actionable patterns for scalable data validation. It includes rules for composing schemas, applying transforms, and optimizing parsing performance in TypeScript apps.