کلاس Client – هسته اصلی کتابخانه Rubika
کلاس Client نقطه شروع و هسته مرکزی برای ساخت ربات یا کلاینت در کتابخانه Rubika است. این کلاس با ترکیب ماژول‌های Network، Methods، SessionManager و سیستم هندلینگ رویدادها، یک ساختار قدرتمند و منعطف برای تعامل با API روبیکا فراهم می‌کند.
ساختار کلی
class Client extends Methods {
// Properties & Methods
}
ورودی سازنده
constructor(
private session: SessionType,
config: {
application?: "Shad" | "Rubika";
platform?: "Web" | "Android";
timeout?: number;
logLevel?: LogLevel;
}
)
session: توکن یا رشته نشست برای احراز هویت در روبیکاplatform: پلتفرم کلاینت (مثلاً Web, Android)application: نام برنامه (مثلاً Shad, Rubika)timeout: زمان انتظار برای درخواست‌های شبکه (میلی‌ثانیه)
ویژگی‌ها و اجزای اصلی کلاس
| ویژگی | نوع | توضیح |
|---|---|---|
initialize | boolean | وضعیت اولیه‌سازی کلاینت (پیش‌فرض: false) |
key | Buffer | undefined | کلید عمومی برای رمزنگاری ارتباطات |
privateKey | string | undefined | کلید خصوصی کاربر |
auth / decode_auth | string | undefined | توکن‌های احراز هویت رمزنگاری شده |
sessionDb | SessionManager | مدیریت ذخیره و بازیابی نشست‌ها |
network | Network | مدیریت درخواست‌های HTTP و WebSocket |
plugins | RubPlugin[] | لیست پلاگین‌های فعال شده |
errorMiddlewares | ErrorMiddleware[] | میان‌افزارهای مدیریت خطا |
userGuid | string | undefined | شناسه یکتای کاربر در روبیکا |
handlers | ContextMap | ثبت‌کننده هندلرهای رویدادها (message, chat, error, ...) |
logger | Logger<Client> | سیستم لاگ‌گیری هوشمند با پشتیبانی از middleware |
وظایف کلاس
1. ارتباط با API روبیکا
کلاس network برای ارسال درخواست به API ربات‌ها استفاده می‌شود. مانند دریافت پیام، پاسخ‌دهی، و مدیریت فایل‌ها.
2. سیستم رویدادها (Handler)
هر نوع پیام، مانند message, chat, error, activities, notifications ، می‌تواند مجموعه‌ای از هندلرها داشته باشد که با دریافت پیام یا ارور اجرا می‌شوند.
نتیجه‌گیری
کلاس Bot یکی از ارکان اصلی Rubika است و پایه‌ای برای ساخت ربات‌های پیشرفته روی پلتفرم روبیکا فراهم می‌کند. با استفاده از این کلاس، توسعه‌دهنده‌ها می‌توانند سریعاً یک ربات با قابلیت‌های مختلف ایجاد کنند.