کلاس Bot – ساختار اصلی ربات در RubJS
کلاس Bot هسته‌ی اصلی برای ایجاد و مدیریت ربات در کتابخانه RubJS است. این کلاس با ترکیب ماژول‌های مختلف مانند مدیریت نشست (Session)، شبکه (Network)، متدها و هندلرها، ساختار پایه‌ای برای اجرای ربات‌ها را فراهم می‌کند.
ساختار کلی
class Bot extends Methods {
...
}
ورودی سازنده
constructor(public token: SessionType)
token: توکن ربات Rubika که به صورتSessionTypeتعریف شده و برای شناسایی و احراز هویت استفاده می‌شود.
ویژگی‌ها و اجزای اصلی کلاس
| ویژگی | توضیح |
|---|---|
BASE_URL | آدرس پایه API رسمی ربات‌های روبیکا (https://botapi.rubika.ir/v3) |
sessionDB | نمونه‌ای از کلاس SessionManager برای مدیریت نشست ربات |
initialize | پرچمی برای بررسی وضعیت اولیه‌سازی (مقدار پیش‌فرض: false) |
network | نمونه‌ای از کلاس Network برای مدیریت درخواست‌ها |
sendToken | توکن ارسال پیام، می‌تواند بعداً تنظیم شود |
handlers | مجموعه‌ای از هندلرها برای مدیریت پیام‌ها و پیام‌های اینلاین |
server | نمونه‌ای از FastifyInstance برای ساخت سرور HTTP داخلی |
bot | اطلاعات عمومی مربوط به ربات مانند آیدی و نام (در صورت نیاز) |
وظایف کلاس
1. مدیریت نشست‌ها
از طریق SessionManager، نشست‌های مرتبط با توکن و حالت اجرایی ربات (BOT) کنترل می‌شود.
2. ارتباط با API روبیکا
کلاس Network برای ارسال درخواست به API ربات‌ها استفاده می‌شود. مانند دریافت پیام، پاسخ‌دهی، و مدیریت فایل‌ها.
3. سیستم رویدادها (Handler)
هر نوع پیام، مانند message یا inline، می‌تواند مجموعه‌ای از هندلرها داشته باشد که با دریافت پیام اجرا می‌شوند.
4. سرور داخلی
کلاس به کمک Fastify یک سرور سبک راه‌اندازی می‌کند که می‌تواند برای دریافت وب‌هوک، لاگ یا مانیتورینگ استفاده شود.
نتیجه‌گیری
کلاس Bot یکی از ارکان اصلی RubJS است و پایه‌ای برای ساخت ربات‌های پیشرفته روی پلتفرم روبیکا فراهم می‌کند. با استفاده از این کلاس، توسعه‌دهنده‌ها می‌توانند سریعاً یک ربات با قابلیت‌های مختلف ایجاد کنند.