کلاینت تازهٔ نئون برای تایپ‌اسکریپت
جاوااسکریپتخلاصهٔ کامل‌تر
نئون توی این پست معرفی می‌کنه که بستهٔ @neon/sdk از حالا در دسترسه؛ کلاینت تایپ‌اسکریپتی تازه‌ای برای API نئون که کارهایی مثل ساخت پروژه، مدیریت برنچ و دیتابیس و انتقال پروژه رو پوشش می‌ده. به نوشتهٔ Andre Landgraf، این بسته جای @neondatabase/api-client قدیمی رو می‌گیره، هرچند به گفتهٔ خودشون فعلاً قرار نیست اون یکی منسوخ شه.
ساختار بسته دو لایه‌ست. هستهٔ خام از روی اسپک OpenAPI و با Hey API تولید شده، پس هر اندپوینت دقیقاً به یه تابع تایپ‌اسکریپتی مستقل و tree-shakable نگاشت میشه. روی اون createNeonClient نشسته که یه کلاینت سطح‌بالا با فضای‌نام‌هایی مثل neon.projects و neon.branches می‌ده و تلاش مجدد، صفحه‌بندی، خطاهای بهتر و جریان‌های چندمرحله‌ای رو هم پوشش می‌ده.
مهم‌ترین کاری که این لایه انجام می‌ده، پنهان‌کردن عملیات ناهمگام نئونه. خیلی از تغییرها روی زیرساخت واقعی اعمال می‌شن، برای همین API به‌جای منبع آماده یه operation برمی‌گردونه که معمولاً باید خودت تا آماده‌شدنش پولینگ کنی. اینجا createAndConnect این انتظار رو خودش انجام می‌ده و یه کانکشن‌استرینگ آمادهٔ پستگرس تحویل می‌ده؛ بقیهٔ متدها هم می‌تونن همین رفتار رو بگیرن.
چند جریان آمادهٔ دیگه هم اضافه شده: restore که بازگردانی اسنپ‌شات و نهایی‌کردنش رو یکی می‌کنه و یه کال‌بک preview می‌گیره تا قبل از تأیید نتیجه رو ببینی و در صورت انصراف برنچ موقت خودکار پاک شه؛ transfer برای جابه‌جایی پروژه بین سازمان‌ها، مثلاً از سازمان پلن رایگان به پلن پولی؛ و createWithCompute که برنچ می‌سازه، کامپیوت بهش می‌ده و منتظر آماده‌شدنش می‌مونه. نویسنده پیشنهاد می‌کنه MCP و CLI رو برای توسعهٔ محلی نگه داری و برای هر یکپارچه‌سازی برنامه‌نویسی‌شده مثل CI/CD یا ساخت پلتفرم سراغ SDK بری.
نکات کلیدی:
- کلاینت تایپ‌اسکریپتی جدید نئون: بدون وابستگی، مبتنی بر fetch و فقط ESM
- هستهٔ تولیدشده از OpenAPI به‌همراه یه لایهٔ سطح‌بالای ارگونومیک
- انتظار خودکار برای آماده‌شدن منابع، به‌جای پولینگ دستی operationها
- جریان‌های آماده برای بازگردانی اسنپ‌شات، انتقال پروژه و ساخت برنچ با کامپیوت
- جایگزین @neondatabase/api-client، ولی بدون منسوخ‌کردن فوری اون
