node-telegram-bot-api بازنویسی شد؛ حالا TypeScript و ESM
نود جیاس
جاوااسکریپتخلاصهٔ کامل‌تر
این صفحه ریلیزهای کتابخونهٔ node-telegram-bot-api رو نشون می‌ده و مهم‌ترین خبر، نسخهٔ ۱٫۰٫۰ه: کلِ کتابخونه از جاوااسکریپت به TypeScript بازنویسی شده. حالا حداقل Node.js نسخهٔ ۱۸ لازمه و پکیج فقط ESMه، یعنی require() دیگه کار نمی‌کنه و باید با import واردش کنی.
مهاجرتِ اصلی همینه — به‌جای require از import استفاده کن؛ اگه هنوز روی CommonJS گیر کردی، می‌تونی با ایمپورتِ داینامیک لودش کنی:
import TelegramBot from 'node-telegram-bot-api';
// CommonJS:
const { default: TelegramBot } = await import('node-telegram-bot-api');تایپ‌ها دیگه جدا نصب نمی‌شن؛ خودِ پکیج تایپِ کامل داره و جایگزینِ @types/node-telegram-bot-api شده، پس اون رو حذف کن. تایپ‌ها هم دیگه زیرِ نِیم‌اسپیسِ TelegramBot.* نیستن و به‌شکلِ ایمپورتِ نام‌دار در اومدن، اینترفیس‌های *Options به *Params تغییرِ نام دادن، و چند متد هم عوض شدن — مثلاً thumb شده thumbnail و reply_to_message_id جاش رو به reply_parameters داده.
روی همین پایه، نسخهٔ ۱٫۱٫۰ (بدونِ هیچ breaking changeِ جدید) پشتیبانی از Telegram Bot API 10.1 رو اضافه کرده: متدهای تازه‌ای مثل sendRichMessage و پارامترِ rich_message برای editMessageText، به‌علاوهٔ کوئری‌های Join Request و تایپ‌های جدید. تستِ یکپارچگیِ زنده برای متدهای ۱۰٫۱ و بازتولیدِ مستندات هم اومده.
نکات کلیدی:
- نسخهٔ ۱٫۰٫۰ کلِ کتابخونه رو به TypeScript بازنویسی کرده، فقطESM شده و Node ≥ ۱۸ می‌خواد.
- تایپ‌ها داخلِ پکیج اومدن و جایگزینِ @types/... شدن؛ چند breaking change مثلِ حذفِ require و تغییرِ نامِ چند متد هم هست.
- نسخهٔ ۱٫۱٫۰ پشتیبانی از Telegram Bot API 10.1 (مثل Rich Messageها) رو بدونِ شکستنِ چیزی اضافه کرده.
