TypeScript → Zod Schema

Khi nào dùng?

• Validate API response: chỉ có type TypeScript thì compile-time safe, nhưng response từ API có thể trả khác — Zod giúp validate runtime.
• LLM structured output: ép GPT/Claude trả JSON đúng schema bằng Zod (qua zodResponseFormat của OpenAI SDK hoặc tool_use của Anthropic).
• Form validation: dùng react-hook-form + Zod resolver — type và validation cùng 1 schema.
• Parse env vars: validate process.env ở startup, fail fast nếu thiếu biến.

Mapping TypeScript → Zod

TypeScript	Zod
string	z.string()
number	z.number()
boolean	z.boolean()
Date	z.date()
T[] hoặc Array<T>	z.array(T)
T | undefined hoặc field?: T	T.optional()
T | null	T.nullable()
"a" | "b" | "c"	z.enum(["a","b","c"])
A | B (non-literal)	z.union([A, B])
Record<K, V>	z.record(K, V)
[A, B] (tuple)	z.tuple([A, B])
enum Color { ... }	z.enum([...]) hoặc z.union(z.literal())

Giới hạn

• Không hỗ trợ generic type parameters (Box<T>).
• Không hỗ trợ intersection A & B phức tạp — dùng .merge() hoặc .extend() thủ công.
• Không resolve type alias từ module khác.

Mục tiêu: cover 80% case thường gặp, output sạch để bạn copy-paste và tinh chỉnh.