مدیریت کوئری‌های SQL در تایپ‌اسکریپت بدون تولید کد اضافه با Reylo
مدیریت کوئری‌های SQL در تایپ‌اسکریپت با Reylo، تایپ خروجی SQL را بدون فایل واسطه و با اتصال به پایگاه‌داده توسعه، در زمان کامپایل فراهم می‌کند.
خلاصه
کتابخانه Reylo به توسعه‌دهندگان اجازه می‌دهد فایل‌های .sql را مستقیماً در پروژه‌های TypeScript وارد کنند. این ابزار با اتصال به پایگاه‌داده توسعه، ساختار جداول را تحلیل کرده و خروجی کوئری‌ها را به صورت خودکار تایپ‌دهی می‌کند. برخلاف روش‌های سنتی، هیچ فایل واسطه‌ای تولید نمی‌شود و تمام هماهنگی‌ها در زمان کامپایل و با تکیه بر قابلیت‌های نسخه ۷.۱ تایپ‌اسکریپت انجام می‌گیرد.
چالش مدیریت SQL در پروژه‌های تایپ‌اسکریپت
توسعه‌دهندگان در پروژه‌های بزرگ معمولاً میان دو راهی گیر می‌کنند: استفاده از ORMها که گاهی کنترل روی SQL پیچیده را سخت می‌کنند، یا نوشتن SQL خام که مدیریت تایپ‌های آن دشوار و مستعد خطا است. روش‌های موجود برای حل این مشکل اغلب به Codegen یا تولید کد خودکار تکیه دارند. در این روش‌ها، یک پردازشگر ثانویه باید فایل‌های SQL را بخواند و فایل‌های تعریف تایپ (.d.ts) بسازد. این موضوع باعث شلوغی مخزن کد و نیاز به اجرای مداوم ابزارهای ناظر (Watchers) می‌شود.
کتابخانه Reylo با رویکردی متفاوت وارد میدان شده است. این ابزار به جای تولید فایل، مستقیماً با کامپایلر تایپ‌اسکریپت صحبت می‌کند. این یعنی اگر نام یک ستون را در فایل SQL اشتباه بنویسید، ویرایشگر کد شما بلافاصله همان‌جا خطا می‌گیرد، گویی که در حال نوشتن کد تایپ‌اسکریپت هستید.
Reylo چگونه کار می‌کند؟
هسته اصلی این ابزار بر پایه قابلیتی به نام Content Mappers بنا شده است که در نسخه ۷.۱ تایپ‌اسکریپت معرفی شد. Reylo در زمان اجرا یا بررسی کد، کوئری شما را به پایگاه‌داده توسعه (Dev Database) می‌فرستد. پایگاه‌داده بدون اجرای واقعی دستور (با استفاده از دستوراتی مثل Prepare)، مشخص می‌کند که هر ستون چه نوع داده‌ای برمی‌گرداند و کدام پارامترها ورودی هستند.
فرض کنید یک فایل به نام ۰ دارید که اطلاعات کاربر را بر اساس شناسه دریافت می‌کند. در حالت عادی باید یک رابط (Interface) برای خروجی آن در تایپ‌اسکریپت تعریف کنید. اما با Reylo، به محض وارد کردن فایل، تمام فیلدها مثل نام، ایمیل و تاریخ عضویت با تایپ‌های دقیق (string، number و غیره) در دسترس هستند. حتی وضعیت نال‌بودن (Nullable) ستون‌ها نیز بر اساس ساختار جدول و شرط‌های Join به درستی تشخیص داده می‌شود.
مزایای استفاده از Reylo در پروژه‌های مدرن
استفاده از این ابزار چندین برتری فنی ایجاد می‌کند که سرعت و دقت توسعه را بالا می‌برد:
۱. قدرت کامل SQL: شما محدود به متدهای ORM نیستید. هر تابع، عملگر یا سینتکسی که پایگاه‌داده شما (Postgres، MySQL یا SQLite) پشتیبانی کند، در اینجا قابل استفاده است. ۲. عدم تکرار کد (DRY): نیازی به نوشتن دستی تایپِ سطرها نیست. تایپ‌ها مستقیماً از دل SQL بیرون می‌آیند و با تغییر در دیتابیس، کد شما خودکار به‌روز می‌شود. ۳. امنیت در زمان کامپایل: اگر تداخلی بین کد و دیتابیس وجود داشته باشد (مثلاً حذف یک جدول)، دستور tsc خطا می‌دهد و اجازه انتشار نسخه معیوب را نمی‌گیرد. ۴. سازگاری با ایجنت‌های هوش مصنوعی: در دوره کنونی که استفاده از ایجنت‌های هوش مصنوعی برای کدنویسی رایج شده، Reylo کمک می‌کند تا ایجنت‌ها تایپ‌های قدیمی و منسوخ از خود به جا نگذارند؛ چرا که منبع حقیقت فقط یک فایل SQL است.
در پلتفرم‌هایی مثل هوش مصنوعی نهال که توسعه‌دهندگان به دنبال راهکارهای سریع برای پیاده‌سازی زیرساخت‌های داده‌محور هستند، ابزارهایی که فاصله بین منطق دیتابیس و زبان برنامه‌نویسی را کم می‌کنند، ارزش بالایی دارند.
چطور Reylo را راه‌اندازی کنیم؟
برای شروع، ابتدا باید نسخه ۷.۱ تایپ‌اسکریپت را نصب داشته باشید. سپس بسته مربوط به پایگاه‌داده خود را نصب کنید:
۱ (یا نسخه مخصوص mysql و sqlite)
پس از نصب، باید تنظیمات ۲ را به‌روزرسانی کنید تا فایل‌های .sql شناسایی شوند. نکته مهم این است که برای چک کردن تایپ‌ها باید از پرچم ۳ استفاده کنید. این پرچم به تایپ‌اسکریپت اجازه می‌دهد تا از Content Mapperهای Reylo برای تحلیل فایل‌های خارجی استفاده کند.
متغیر محیطی ۴ نیز باید به دیتابیس توسعه شما اشاره کند تا Reylo بتواند شمای جداول را از آن بخواند. این ابزار با اکثر درایورهای محبوب مثل ۵،۶ و ۷ سازگاری کامل دارد.
استنتاج هوشمند تایپ‌ها
یکی از جذاب‌ترین بخش‌های Reylo، توانایی آن در تحلیل منطقی کوئری است. این ابزار فقط به نوع داده ستون نگاه نمی‌کند، بلکه موارد زیر را هم در نظر می‌گیرد:
- کاردینالیتی: اگر کوئری بر اساس یک کلید یکتا (Unique Key) فیلتر شده باشد، Reylo می‌فهمد که خروجی یا یک آبجکت است یا null، نه یک آرایه.
- اجتماع‌ها (Unions): اگر یک ستون از نوع Enum باشد، در تایپ‌اسکریپت به صورت یک Union Type از مقادیر مجاز ظاهر می‌شود.
- ساختار JSON: اگر از فیلدهای JSON استفاده می‌کنید و برای آن‌ها در دیتابیس Check Constraint گذاشته‌اید، Reylo ساختار داخل JSON را هم برای شما استخراج می‌کند.
نکات کلیدی
- این ابزار برای کارکرد صحیح به نسخه ۷.۱ تایپ‌اسکریپت یا بالاتر نیاز دارد.
- هیچ کد واسطه‌ای (Generated Files) تولید نمی‌شود و مستقیماً با کامپایلر تعامل دارد.
- از پایگاه‌داده‌های Postgres، MySQL و SQLite پشتیبانی می‌کند و با اکثر درایورهای معروف سازگار است.
- تشخیص دقیق وضعیت نال‌بودن (Nullability) بر اساس قیدهای دیتابیس و منطق Join انجام می‌شود.
منبع: github.com