مذكرات سعيد
اتقرأ🔖

🗺️ الخريطة

البدايةفصلين
فصل ١المشكلة — TypeScript مش بيراجع الـ API#تلات حاجات مختلفة #النوع مش validation #JSON من بره
فصل ٢الحل — TypeScript والـ Zod#schema مرة واحدة #z.infer #unknown مش any #تلات احتمالات
الـ errorsفصلين
فصل ٣عرض الـ error لو الـ response مش متوقع#أربعة أنواع أخطاء #isError #متعرضش تفاصيل الـ schema
فصل ٤هل كل validation error يظهر للمستخدم؟#الشاشة كلها #حقل اختياري #داتا أساسية
المكانفصلين
فصل ٥نطبّق ده فين في الـ architecture؟#schema #api #queries #ui #الـ API layer
فصل ٦الـ typing بتاع الـ Query#الاستنتاج لوحده #useQuery generic مش validation
الاختيارفصلين
فصل ٧parse ولا safeParse؟#parse بيرمي #safeParse بيرجع نتيجة #الافتراضي parse
فصل ٨الـ safeParse في الـ API ولا الـ UI؟#الـ API layer #الـ UI تعرض بس #خطأ مخصص #logger مركزي

المذكرة دي بتفصّل تلات حاجات بتتلخبط على بعض في الـ Frontend، خصوصًا مع React وTypeScript وTanStack Query:

  • الـ Typing: إيه نوع الداتا اللي الكود متوقع يتعامل معاها؟
  • الـ Runtime Validation: هل الداتا اللي رجعت من الـ API مطابقة فعلًا للنوع المتوقع؟
  • الـ Error Handling: هنعمل إيه لو الداتا مش مطابقة؟