‏اوروال: تبدیل OpenAPI به کد TypeScript آماده

اوروال (Orval) یه ابزار کد‌جنریشن هست که فایل مشخصات OpenAPI رو به عنوان ورودی می‌گیره و به‌جای اینکه مجبور بشی همه چیز رو دستی بنویسی، به‌طور خودکار کد TypeScript آماده‌ی پروداکشن تولید می‌کنه. نسخه ۸ این ابزار به‌تازگی منتشر شده.

مشکلی که اوروال حل می‌کنه اینه که توسعه‌دهنده‌ها معمولاً وقت زیادی رو صرف نوشتن کدهای تکراری (boilerplate) برای API client می‌کنن — تعریف type‌ها، هندل کردن درخواست‌ها، نوشتن موک‌ها. اوروال این کارها رو از روی spec یه‌بار می‌خونه و همه‌شون رو خودکار تولید می‌کنه.

یکی از نقاط قوت اوروال اینه که framework-native هست؛ یعنی مستقیم هوک‌ها و کلاینت‌های سازگار با فریم‌ورک‌های محبوب تولید می‌کنه. از React Query، Vue Query، Angular، SWR، Svelte Query، Solid Query و حتی Hono و MCP پشتیبانی می‌کنه.

قابلیت موک‌سازی هم بخش جذابیه. اوروال می‌تونه به‌صورت خودکار هندلرهای MSW (Mock Service Worker) با داده‌های واقع‌نما از Faker.js تولید کنه؛ یعنی می‌شه بدون نیاز به بک‌اند واقعی، فرانت‌اند رو تست کرد. همچنین ولیدیتورهای Zod هم از روی spec تولید می‌شن.

برای نصب کافیه اوروال رو به‌عنوان dev dependency اضافه کنی:

bun add -d orval

نکات کلیدی:

• اوروال spec های OpenAPI رو به کد TypeScript تایپ‌سیف تبدیل می‌کنه
• از فریم‌ورک‌هایی مثل React Query، Vue، Angular، SWR و Svelte پشتیبانی می‌کنه
• موک‌های MSW با داده‌های Faker.js و ولیدیتور Zod هم تولید می‌شن
• نسخه ۸ این ابزار تازه منتشر شده
• پروژه متن‌باز هست و روی GitHub در دسترسه