الحل — TypeScript والـ Zod

TypeScript والـ Zod شغلهم مختلف

• TypeScript: بيساعدك تكتب كود آمن، ويكتشف أخطاء الأنواع أثناء التطوير.
• Zod: بيفحص الداتا الفعلية وقت التشغيل ويتأكد إنها مطابقة للـ schema.

التثبيت:

pnpm add zod

الـ schema والنوع من مكان واحد

import { z } from "zod";export const userSchema = z.object({  id: z.number(),  name: z.string(),  email: z.string().email(),});export type User = z.infer<typeof userSchema>;

الـ schema في الـ API layer

export const getUser = async (): Promise<User> => {  const response = await fetch("/api/user");  if (!response.ok) {    throw new Error("Failed to fetch user");  }  const data: unknown = await response.json();  return userSchema.parse(data);};

دلوقتي عندنا ٣ احتمالات:

• الـ API رجعت داتا صحيحة: الدالة بترجع User.
• الـ API رجعت داتا غير مطابقة: parse() بترمي ZodError.
• الـ HTTP request فشل: بنرمي خطأ خاص بالـ request.

خلّصت الفصل لما

• تفرّق بين شغل TypeScript وشغل Zod
• تكتب schema وتطلع النوع بـ z.infer
• تخلي response.json() من نوع unknown قبل parse
• تعرف التلات احتمالات: داتا صحيحة، ZodError، وخطأ HTTP