rubika 1.1.0 → 1.2.1

package/README.md

@@ -1,6 +1,6 @@
 <p align="center">
   <h1 style="color:#fff;">› rubika Framework</h1>
-  <p><b>فریم‌ورک قدرتمند و پرسرعت جاوااسکریپت برای ربات‌های روبیکا</b></p>
+  <p><b>فریم‌ورک قدرتمند و پرسرعت جاوااسکریپت برای ربات‌/سلف‌های روبیکا</b></p>
 </p>
 
 ---
@@ -10,9 +10,9 @@
 **rubika** یک فریم‌ورک سبک، مدرن و کاملاً **غیرهمزمان** برای توسعه ربات‌های روبیکا است.  
 با معماری **Filter-Base** و **Type-Safe**، شما می‌توانید:
 
-- ربات‌هایی سریع و کم‌حجم بسازید
-- سیستم فرمان‌دهی و مدیریت پیام حرفه‌ای داشته باشید
-- با قابلیت **اسکِیبل و قابل گسترش**، پروژه‌های بزرگ هم مدیریت کنید
+- ربات‌/سلف‌ هایی سریع و کم‌حجم بسازید.
+- سیستم فرمان‌دهی و مدیریت پیام حرفه‌ای داشته باشید.
+- با قابلیت **اسکِیبل و قابل گسترش**، پروژه‌های بزرگ هم مدیریت کنید.
 
 ---
 
@@ -22,33 +22,63 @@
 bun add rubika
 ```
 
-## › نمونه کد ساده
+## › نمونه کد ساده ربات
 
 ```ts
-import Bot, { Filters } from "rubika";
+import Bot, { Filters } from "rubika/bot";
 
-const bot = new Bot("rubika");
+const bot = new Bot("TOKEN_BOT");
 
-bot.command("/start", async (ctx, bot) => {
-  await bot.sendMessage(ctx.chat_id, "🤖 ربات استارت شد");
+bot.command("/start", async (ctx) => {
+  await ctx.reply("🤖 ربات استارت شد");
 });
 
-bot.on("update", [Filters.isText], async (ctx, bot) => {
-  await bot.sendMessage(ctx.chat_id, "سلام 😎");
+bot.on("update", [Filters.isText], async (ctx) => {
+  await ctx.reply("سلام 😎");
+});
+
+bot.on("error", async (err) => {
+  await err.bot.sendMessage("CHAT_ID", err.message);
+  console.log(err.message);
 });
 
 bot.run();
 ```
 
+## › نمونه کد ساده سلف (self)
+
+```ts
+import Client from "rubika/bot";
+
+const shad_client = new Client("shad", "Shad");
+const rubika_client = new Client("rubika", "Rubika");
+
+// Shad
+shad_client.on("message", async (ctx) => console.log(ctx));
+shad_client.on("error", async (err) => console.log(err));
+
+// Rubika
+rubika_client.on("message", async (ctx) => console.log(ctx));
+rubika_client.on("error", async (err) => console.log(err));
+
+// start (self)-bots
+shad_client.run();
+rubika_client.run();
+```
+
 ## › ویژگی‌های کلیدی
 
-| ویژگی          | توضیح                                          |
-| -------------- | ---------------------------------------------- |
-| ⚡ Super-Speed | استفاده از معماری غیرهمزمان برای پاسخ‌دهی سریع |
-| 🛡️ Type-Safe   | کمک به جلوگیری از خطاهای متداول جاوااسکریپت    |
-| 🔧 Filter-Base | سیستم فیلترینگ قدرتمند برای مدیریت پیام‌ها     |
-| 📂 Modular     | ساختار ماژولار و قابل گسترش                    |
+| ویژگی                | توضیح                                          |
+| -------------------- | ---------------------------------------------- |
+| ⚡ Super-Speed       | استفاده از معماری غیرهمزمان برای پاسخ‌دهی سریع |
+| 🛡️ Type-Safe         | کمک به جلوگیری از خطاهای متداول جاوااسکریپت    |
+| 🔧 Filter-Base       | سیستم فیلترینگ قدرتمند برای مدیریت پیام‌ها     |
+| 📂 Modular           | ساختار ماژولار و قابل گسترش                    |
+| 🈸 Multi Application | ساخت ربات های روبیکایی و شاد                   |
 
 ## 🌐 لینک‌های مهم
 
 - [لینک گیتهاب](https://github.com/hadi-rostami/rubika-bot)
+- [لینک npm](https://www.npmjs.com/package/rubika)
+- [تلگرام](https://t.me/rubikajs_channel)
+- [روبیکا](https://rubika.ir/rubika_js)

package/{bot.ts → bot/bot.ts}

@@ -3,7 +3,7 @@ import Methods from "./methods";
 import type { BotInfo } from "./types/interfaces";
 import type { ContextMap, Handler, NestedFilter } from "./types/handlers";
 import Update from "./contexts/update";
-import Logger from "./utils/errors";
+import { Logger } from "../utils";
 
 class Bot extends Methods {
   protected initialize: boolean = false;
@@ -15,7 +15,7 @@ class Bot extends Methods {
     [K in keyof ContextMap]: Handler<ContextMap[K]>[];
   } = { inline: [], update: [], error: [] };
 
-  public logger = new Logger(this.handlers.error);
+  public logger = new Logger<Bot>(this.handlers.error, this);
 
   /**
    * نمونه‌ای از کلاس ربات را ایجاد می‌کند.

package/{contexts → bot/contexts}/inline.ts

@@ -1,6 +1,12 @@
 import Bot from "..";
-import util from "util";
-import { AuxData, File, InlineKeypad, Keypad, Location } from "../types/interfaces";
+import { inspect } from "util";
+import {
+  AuxData,
+  File,
+  InlineKeypad,
+  Keypad,
+  Location,
+} from "../types/interfaces";
 import { ChatKeypadTypeEnum } from "../types/enums";
 import { FileSource } from "../types/methods";
 
@@ -16,7 +22,10 @@ class Inline {
 
   declare bot: Bot;
 
-  constructor(ctx: any, bot: Bot) {
+  constructor(
+    private ctx: any,
+    bot: Bot,
+  ) {
     this.sender_id = ctx.sender_id;
     this.text = ctx.text;
     this.file = ctx.file;
@@ -285,17 +294,8 @@ class Inline {
       );
   };
 
-  [util.inspect.custom]() {
-    return {
-      sender_id: this.sender_id,
-      text: this.text,
-      file: this.file,
-      location: this.location,
-      aux_data: this.aux_data,
-      message_id: this.message_id,
-      chat_id: this.chat_id,
-      store: this.store,
-    };
+  [inspect.custom]() {
+    return this.ctx;
   }
 }
 

package/{contexts → bot/contexts}/update.ts

@@ -1,5 +1,5 @@
 import Bot from "..";
-import util from "util";
+import { inspect } from "util";
 import { ChatKeypadTypeEnum, UpdateTypeEnum } from "../types/enums";
 import { FileSource } from "../types/methods";
 import {
@@ -19,7 +19,10 @@ class Update {
   store: Record<string, any> = {};
   declare bot: Bot;
 
-  constructor(ctx: any, bot: Bot) {
+  constructor(
+    private ctx: any,
+    bot: Bot,
+  ) {
     this.type = ctx.type;
     this.chat_id = ctx.chat_id;
     this.removed_message_id = ctx.removed_message_id;
@@ -335,16 +338,8 @@ class Update {
     return isId ? msg.sender_id : msg.message_id;
   }
 
-  [util.inspect.custom]() {
-    return {
-      type: this.type,
-      chat_id: this.chat_id,
-      removed_message_id: this.removed_message_id,
-      new_message: this.new_message,
-      updated_message: this.updated_message,
-      updated_payment: this.updated_payment,
-      store: this.store,
-    };
+  [inspect.custom]() {
+    return this.ctx;
   }
 }
 

package/bot/index.ts

@@ -0,0 +1,10 @@
+import Bot from "./bot";
+import { AntiSpam } from "./utils";
+import Filters from "./filters";
+import Utils from "../utils/formater";
+import type * as Enums from "./types/enums";
+import { Update, Inline } from "./contexts/index";
+
+export default Bot;
+export { Bot, Filters, Utils, AntiSpam };
+export type { Enums, Update, Inline };

package/bot/methods/chat/getChatAdministrators.ts

@@ -0,0 +1,9 @@
+import Bot from "../..";
+
+async function getChatAdministrators(this: Bot, chat_id: string) {
+  return await this.builder("getChatAdministrators", {
+    chat_id,
+  });
+}
+
+export default getChatAdministrators;

package/bot/methods/chat/getChatMemberCount.ts

@@ -0,0 +1,9 @@
+import Bot from "../..";
+
+async function getChatMemberCount(this: Bot, chat_id: string) {
+  return await this.builder("getChatMemberCount", {
+    chat_id,
+  });
+}
+
+export default getChatMemberCount;

package/bot/methods/chat/index.ts

@@ -0,0 +1,13 @@
+import banChatMember from "./banChatMember";
+import getChat from "./getChat";
+import getChatAdministrators from "./getChatAdministrators";
+import getChatMemberCount from "./getChatMemberCount";
+import unbanChatMember from "./unbanChatMember";
+
+export {
+  getChat,
+  banChatMember,
+  unbanChatMember,
+  getChatAdministrators,
+  getChatMemberCount,
+};

package/{methods → bot/methods}/files/_sendFile.ts

@@ -1,5 +1,5 @@
 import Bot from "../..";
-import { Markdown } from "../../utils";
+import { Markdown } from "../../../utils";
 import { FileSource, SendType } from "../../types/methods";
 import { InlineKeypad, Keypad } from "../../types/interfaces";
 import { ChatKeypadTypeEnum, FileTypeEnum } from "../../types/enums";

package/{methods → bot/methods}/index.ts

@@ -162,6 +162,13 @@ export default class Methods {
     return Messages.editChatKeypad.apply(this, args);
   }
 
+  // async pinChatMessage(
+  //   this: Bot,
+  //   ...args: Parameters<typeof Messages.pinChatMessage>
+  // ): Promise<Types.SendMessage> {
+  //   return Messages.pinChatMessage.apply(this, args);
+  // }
+
   // chat
   async getChat(
     this: Bot,
@@ -184,6 +191,20 @@ export default class Methods {
     return Chat.unbanChatMember.apply(this, args);
   }
 
+  // async getChatAdministrators(
+  //   this: Bot,
+  //   ...args: Parameters<typeof Chat.getChatAdministrators>
+  // ): Promise<Types.SendMessage> {
+  //   return Chat.getChatAdministrators.apply(this, args);
+  // }
+
+  // async getChatMemberCount(
+  //   this: Bot,
+  //   ...args: Parameters<typeof Chat.getChatMemberCount>
+  // ): Promise<Types.SendMessage> {
+  //   return Chat.getChatMemberCount.apply(this, args);
+  // }
+
   // utilities
   async start(
     this: Bot,

package/bot/methods/messages/index.ts

@@ -0,0 +1,37 @@
+import deleteMessage from "./deleteMessage";
+import editChatKeypad from "./editChatKeypad";
+import editMessageKeypad from "./editMessageKeypad";
+import editMessageText from "./editMessageText";
+import forwardMessage from "./forwardMessage";
+import pinChatMessage from "./pinChatMessage";
+import sendContact from "./sendContact";
+import sendFile from "./sendFile";
+import sendGif from "./sendGif";
+import sendImage from "./sendImage";
+import sendLocation from "./sendLocation";
+import sendMessage from "./sendMessage";
+import sendMusic from "./sendMusic";
+import sendPoll from "./sendPoll";
+import sendSticker from "./sendSticker";
+import sendVideo from "./sendVideo";
+import sendVoice from "./sendVoice";
+
+export {
+  sendMessage,
+  sendPoll,
+  sendLocation,
+  sendContact,
+  forwardMessage,
+  editMessageText,
+  deleteMessage,
+  editMessageKeypad,
+  editChatKeypad,
+  sendMusic,
+  sendFile,
+  sendGif,
+  sendImage,
+  sendSticker,
+  sendVideo,
+  sendVoice,
+  pinChatMessage,
+};

package/bot/methods/messages/pinChatMessage.ts

@@ -0,0 +1,16 @@
+import Bot from "../..";
+
+async function pinChatMessage(
+  this: Bot,
+  chat_id: string,
+  message_id: string,
+  disable_notification = false,
+) {
+  return await this.builder("pinChatMessage", {
+    chat_id,
+    message_id,
+    disable_notification,
+  });
+}
+
+export default pinChatMessage;

package/{methods → bot/methods}/messages/sendMessage.ts

@@ -1,5 +1,5 @@
 import Bot from "../..";
-import { Markdown } from "../../utils";
+import { Markdown } from "../../../utils";
 import { SendType } from "../../types/methods";
 import { ChatKeypadTypeEnum } from "../../types/enums";
 import { InlineKeypad, Keypad } from "../../types/interfaces";

package/{methods → bot/methods}/utilities/handleUpdates.ts

@@ -2,7 +2,7 @@ import Bot from "../../bot";
 import Inline from "../../contexts/inline";
 import Update from "../../contexts/update";
 import { UpdateTypeEnum } from "../../types/enums";
-import { checkFilters } from "../../utils";
+import { checkFilters } from "../../../utils";
 
 const checkTypes = [UpdateTypeEnum.UpdatedMessage, UpdateTypeEnum.NewMessage];
 

package/{methods → bot/methods}/utilities/polling.ts

@@ -1,6 +1,6 @@
 import fs from "fs";
 import Bot from "../../bot";
-import { checkFilters } from "../../utils";
+import { checkFilters } from "../../../utils";
 import { UpdateTypeEnum } from "../../types/enums";
 import Update from "../../contexts/update";
 
@@ -35,8 +35,9 @@ export default async function polling(this: Bot) {
                 if (typeof prefix === "string" && text !== prefix) continue;
                 if (prefix instanceof RegExp && !prefix.test(text)) continue;
               }
-
-              await handler(ctx);
+              try {
+                await handler(ctx);
+              } catch {}
             }
           }
         }

package/{methods → bot/methods}/utilities/start.ts

@@ -1,5 +1,5 @@
 import Bot from "../../bot";
-import { prompt } from "../../utils";
+import { prompt } from "../../../utils";
 
 async function start(this: Bot, token?: string) {
   if (!this.token) {

package/{types → bot/types}/handlers.ts

@@ -1,9 +1,13 @@
+import Bot from "..";
 import { Update, Inline } from "../contexts";
 
 export interface ContextMap {
   update: Update;
   inline: Inline;
-  error: string;
+  error: {
+    message: string;
+    bot: Bot;
+  };
 }
 
 export type FilterFn<T> = (ctx: T) => boolean | Promise<boolean>;

package/bot/utils/index.ts

@@ -0,0 +1,3 @@
+import AntiSpam from "./antiSpam";
+
+export { AntiSpam };

package/client/client.ts

@@ -0,0 +1,114 @@
+import Network from "./network";
+import Methods from "./methods";
+import { SessionManager } from "./utils";
+import Message from "./contexts/message.type";
+import * as ClientTypes from "./types/client.type";
+import { Logger } from "../utils";
+
+export default class Client extends Methods {
+  public initialize = false;
+  public key?: Buffer<ArrayBuffer>;
+  public privateKey?: string;
+  public decode_auth?: string;
+  public auth?: string;
+  public sessionDb: SessionManager;
+  public network: Network;
+  public plugins: ClientTypes.RubPlugin[] = [];
+  public userGuid?: string;
+  public handlers: {
+    [K in keyof ClientTypes.ContextMap]: ClientTypes.Handler<
+      ClientTypes.ContextMap[K]
+    >[];
+  } = {
+    error: [],
+    chat: [],
+    message: [],
+    activities: [],
+    notifications: [],
+  };
+
+  public logger = new Logger<Client>(this.handlers.error, this);
+
+  constructor(
+    private session: ClientTypes.SessionType,
+    public application: "Shad" | "Rubika" = "Rubika",
+    public platform: ClientTypes.PlatformType = "Web",
+    public timeout: number = 5000,
+  ) {
+    super();
+    this.sessionDb = new SessionManager(this.session);
+    this.network = new Network(this);
+
+    this.start();
+  }
+
+  on<T extends keyof typeof this.handlers>(
+    type: T,
+    handler: (ctx: ClientTypes.ContextMap[T]) => Promise<void>,
+  ): void;
+
+  on<T extends keyof typeof this.handlers>(
+    type: T,
+    filters: Array<
+      (ctx: ClientTypes.ContextMap[T]) => boolean | Promise<boolean>
+    >,
+    handler: (ctx: ClientTypes.ContextMap[T]) => Promise<void>,
+  ): void;
+
+  on<T extends keyof typeof this.handlers>(
+    type: T,
+    filtersOrHandler:
+      | Array<(ctx: ClientTypes.ContextMap[T]) => boolean | Promise<boolean>>
+      | ((ctx: ClientTypes.ContextMap[T]) => Promise<void>),
+    maybeHandler?: (ctx: ClientTypes.ContextMap[T]) => Promise<void>,
+  ) {
+    if (typeof filtersOrHandler === "function") {
+      this.handlers[type].push({
+        filters: [],
+        handler: filtersOrHandler,
+      });
+    } else if (Array.isArray(filtersOrHandler) && maybeHandler) {
+      this.handlers[type].push({
+        filters: filtersOrHandler,
+        handler: maybeHandler,
+      });
+    } else {
+      throw new Error("Invalid arguments for on()");
+    }
+  }
+
+  command(
+    prefix: string | RegExp,
+    handler: (ctx: Message) => Promise<void>,
+  ): void;
+
+  command(
+    prefix: string | RegExp,
+    filters: Array<(ctx: Message) => boolean | Promise<boolean>>,
+    handler: (ctx: Message) => Promise<void>,
+  ): void;
+
+  command(
+    prefix: string | RegExp,
+    filtersOrHandler:
+      | Array<(ctx: Message) => boolean | Promise<boolean>>
+      | ((ctx: Message) => Promise<void>),
+    maybeHandler?: (ctx: Message) => Promise<void>,
+  ) {
+    if (typeof filtersOrHandler === "function") {
+      this.handlers["message"].push({
+        filters: [],
+        handler: filtersOrHandler,
+        prefix,
+      });
+    } else if (Array.isArray(filtersOrHandler) && maybeHandler) {
+      this.handlers["message"].push({
+        filters: filtersOrHandler,
+        handler: maybeHandler,
+        prefix,
+      });
+    } else {
+      throw new Error("Invalid arguments for command()");
+    }
+  }
+}

package/client/contexts/activities.type.ts

@@ -0,0 +1,31 @@
+import { inspect } from "util";
+import { Client } from "../../..";
+import { DecoratorsTypes } from "../types/index.type";
+
+class Activities implements DecoratorsTypes.ShowActivities {
+  type: string;
+  object_guid: string;
+  object_type: string;
+  user_activity_guid: string;
+  store: Record<string, any> = {};
+
+  declare client: Client;
+
+  constructor(
+    client: Client,
+    private update: DecoratorsTypes.ShowActivities,
+  ) {
+    this.client = client;
+
+    this.type = update.type;
+    this.object_guid = update.object_guid;
+    this.object_type = update.object_type;
+    this.user_activity_guid = update.user_activity_guid;
+  }
+
+  [inspect.custom]() {
+    return this.update;
+  }
+}
+
+export default Activities;

package/client/contexts/chat.type.ts

@@ -0,0 +1,32 @@
+import { inspect } from "util";
+import { Client } from "../../..";
+import { DecoratorsTypes } from "../types/index.type";
+
+class Chat implements DecoratorsTypes.ChatUpdates {
+  object_guid: string;
+  action: string;
+  chat: DecoratorsTypes.Chat;
+  updated_parameters: string[];
+  timestamp: string;
+  type: string;
+  store: Record<string, any> = {};
+
+  declare client: Client;
+
+  constructor(client: Client, private update: DecoratorsTypes.ChatUpdates) {
+    this.client = client;
+
+    this.object_guid = update.object_guid;
+    this.action = update.action;
+    this.chat = update.chat;
+    this.updated_parameters = update.updated_parameters;
+    this.timestamp = update.timestamp;
+    this.type = update.type;
+  }
+
+  [inspect.custom]() {
+    return this.update
+  }
+}
+
+export default Chat;

package/client/contexts/contextConstructors.ts

@@ -0,0 +1,16 @@
+import { ContextMapCon } from "../types/client.type";
+import Client from "../client";
+import Activities from "./activities.type";
+import Chat from "./chat.type";
+import Message from "./message.type";
+import Notifications from "./notifications.type";
+
+export const ContextConstructors = {
+  message: Message,
+  chat: Chat,
+  activities: Activities,
+  notifications: Notifications,
+} satisfies Record<
+  keyof ContextMapCon,
+  new (client: Client, update: any) => any
+>;

package/client/contexts/index.ts

@@ -0,0 +1,6 @@
+import Activities from './activities.type';
+import Chat from './chat.type';
+import Message from './message.type';
+import Notifications from './notifications.type';
+
+export { Activities, Chat, Message, Notifications };