rubigram 0.1.0

package/README.md

@@ -0,0 +1,193 @@
+# Rubigram 🤖
+
+![npm](https://img.shields.io/npm/v/rubigram) ![License](https://img.shields.io/badge/license-MIT-green)
+
+> Rubigram یک فریم‌ورک مدرن، تایپ‌سیف و ماژولار برای توسعه ربات روبیکا با استفاده از [Rubika Bot API](https://rubika.ir/botapi)، با امکانات پیشرفته و معماری قابل توسعه.
+
+---
+
+## فهرست مطالب
+
+- [ویژگی‌ها](#ویژگیها)
+- [نصب](#نصب)
+- [شروع سریع](#شروع-سریع)
+- [آموزش کامل استفاده](#آموزش-کامل-استفاده)
+  - [فرآیند پردازش میدل‌ویر](#فرآیند-پردازش-میدلویر)
+  - [ذخیره‌سازی و مدیریت نشست](#ذخیرهسازی-و-مدیریت-نشست)
+  - [افزونه مدیریت گروه](#افزونه-مدیریت-گروه)
+- [API مرجع](#api-مرجع)
+- [تست و اجرا](#تست-و-اجرا)
+- [لایسنس](#لایسنس)
+
+---
+
+## ویژگی‌ها
+
+- ⚡ **تایپ‌سیف و مدرن:** پیاده‌سازی کامل TypeScript با بهره‌مندی از واردسازی ESM و تایپ‌های قوی.
+- 🧩 **گردش میدل‌ویر:** معماری مشابه اکسپرس برای زنجیره‌‌سازی میدل‌ویرها با متدهای `bot.use()`, `bot.command()`, `bot.hears()` و `bot.on()`.
+- 💾 **ذخیره‌ساز قابل پلاگین:** پشتیبانی داخلی از `MemoryStorage` و `SqliteStorage` با امکان تعریف TTL و توسعه ذخیره‌ساز اختصاصی.
+- 👥 **پکیج مدیریت گروه:** قابلیت‌های پیشرفته برای مدیریت گروه‌ها از جمله: قفل لینک، جستجوی پیام، میوت/آن‌میوت، هشدار و ردیابی اعضا.
+- 🛡 **دسترسی به API رسمی:** بدون هیچ واسط یا پوشش غیراستاندارد و فقط با استفاده از Rubika Bot API رسمی.
+- 📦 **توسعه‌پذیری ماژولار:** ایجاد افزونه و میدل‌ویر دلخواه و توسعه بسیار آسان.
+
+---
+
+## نصب
+
+برای نصب با استفاده از npm کافی است:
+
+```bash
+npm install rubigram
+```
+
+یا با استفاده از yarn:
+
+```bash
+yarn add rubigram
+```
+
+---
+
+## شروع سریع
+
+یک ربات ساده بسازید:
+
+```typescript
+import { Rubigram } from "rubigram";
+
+const bot = new Rubigram("YOUR_BOT_TOKEN"); // توکن ربات‌تان را جایگزین کنید
+
+// ثبت فرمان start
+bot.command("start", async (ctx) => {
+  await ctx.reply("سلام! به روبیگرام خوش آمدید 🎉");
+});
+
+// بازتاب پیام متنی
+bot.on("message", async (ctx) => {
+  if (ctx.text) {
+    await ctx.reply(`شما گفتید: ${ctx.text}`);
+  }
+});
+
+// آغاز دریافت پیام (Polling)
+bot.start();
+```
+
+---
+
+## آموزش کامل استفاده
+
+### فرآیند پردازش میدل‌ویر
+
+Rubigram قابلیت استفاده از میدل‌ویرهای چند مرحله‌ای و شخصی‌سازی شده را در اختیار شما می‌گذارد.  
+مثال:
+
+```typescript
+bot.use(async (ctx, next) => {
+  console.log(`[${ctx.chatId}] دریافت پیام!`);
+  await next();
+});
+```
+
+### ذخیره‌سازی و مدیریت نشست (Session)
+
+برای حفظ اطلاعات هر کاربر (مثلا شمارنده یا هر داده دلخواه):
+
+```typescript
+import { Rubigram, session, SqliteStorage } from "rubigram";
+
+// تایپ داده دلخواه برای هر نشست کاربر
+interface MySessionData {
+  counter: number;
+}
+
+const bot = new Rubigram("YOUR_BOT_TOKEN");
+const storage = new SqliteStorage<MySessionData>({ path: "./sessions.db" });
+
+bot.use(
+  session({
+    storage, // می‌توانید به‌جای Sqlite از MemoryStorage هم استفاده کنید
+    initial: () => ({ counter: 0 }),
+  }),
+);
+
+bot.command("count", async (ctx) => {
+  ctx.session.counter += 1;
+  await ctx.reply(`شمارشگر شما: ${ctx.session.counter}`);
+});
+
+bot.start();
+```
+
+#### توسعه ذخیره‌ساز سفارشی
+
+با پیاده‌سازی interface مخصوص، می‌توانید ذخیره‌سازی اختصاصی خودتان را اضافه کنید.
+
+### افزونه مدیریت گروه (Group Management)
+
+همراه Rubigram یک افزونه مدیریتی کامل برای گروه‌ها ارائه شده:
+
+```typescript
+import { Rubigram, GroupManager, MemoryStorage } from "rubigram";
+
+const bot = new Rubigram("YOUR_BOT_TOKEN");
+const groupManager = new GroupManager(new MemoryStorage());
+
+// اتصال میدل‌ویر افزونه
+bot.use(groupManager.middleware());
+
+// مثال: قفل اشتراک‌گذاری لینک
+bot.command("lock_link", async (ctx) => {
+  if (ctx.chatId) {
+    await groupManager.setLockLink(ctx.chatId, true);
+    await ctx.reply("🔒 اشتراک‌گذاری لینک در این گروه قفل شد.");
+  }
+});
+
+bot.start();
+```
+
+قابلیت‌های گروه: قفل لینک/فایل/تصویر،‌ هشدار، میوت و ... (مستندات بیشتر: [docs/group-management.md](docs/group-management.md))
+
+---
+
+## API مرجع
+
+Rubigram مبتنی بر TypeScript است و تمام اینترفیس‌ها، تایپ‌ها و متدهای مهم به صورت کامل مستندسازی شده‌اند.  
+برخی کلاس‌ها و متدهای کلیدی:
+
+- `Rubigram`: کلاس اصلی ربات
+- `bot.command(name, handler)`: ثبت دستور بات (مانند فرمان start)
+- `bot.on(type, handler)`: دریافت انواع رویدادها مثل پیام
+- `ctx.reply(text, [options])`: ارسال پیام
+- `session({storage, initial})`: راه‌اندازی نشست کاربر
+- `GroupManager`: مدیریت پیشرفته گروه
+- و ...
+
+برای مشاهده مستندات کامل تایپ‌ها به [types.ts](src/types/) مراجعه کنید.
+
+---
+
+## تست و اجرا
+
+- اجرای پروژه:  
+  فایلتان را با node اجرا کنید (مثلا: `node bot.js` یا با ts-node برای پروژه‌های TypeScript).
+- اگر Bot Token معتبر باشد، ربات شروع به دریافت و پاسخ به پیام‌ها خواهد کرد.
+
+---
+
+## سوالات رایج
+
+- **آیا می‌توان چند میدل‌ویر زنجیره‌ای تعریف کرد؟**
+  بله، هر تعداد دلخواه میدل‌ویر قابل اضافه شدن است و ترتیب اجرا رعایت می‌شود.
+- **ذخیره‌سازی کجاست؟**  
+  به صورت پیش‌فرض MemoryStorage ارایه شده، اما برای ذخیره‌سازی پایدار SQLite یا هر ذخیره‌ساز دلخواه قابل استفاده است.
+- **آیا امکان توسعه افزونه وجود دارد؟**  
+  بله، معماری کاملا باز و توسعه‌پذیر است.
+
+---
+
+## لایسنس
+
+MIT © Mani Lipour  
+این پروژه متن‌‌باز است و استفاده، توسعه و گسترش آن آزاد می‌باشد.

package/dist/bot.d.ts

@@ -0,0 +1,24 @@
+import { BotClient } from "./client/api-client.js";
+import type { RubikaClientOptions } from "./client/types.js";
+import { Composer } from "./routing/composer.js";
+import { Context } from "./context/context.js";
+export interface BotOptions extends RubikaClientOptions {
+    pollingIntervalMs?: number;
+    dropPendingUpdates?: boolean;
+}
+export type UpdateType = "message" | "inline_message" | "all";
+export type BotMiddleware = (ctx: Context, next: () => Promise<void>) => Promise<void> | void;
+export type BotHandler = (ctx: Context) => Promise<void> | void;
+export declare class Rubigram extends Composer {
+    readonly client: BotClient;
+    private isPolling;
+    private nextOffsetId;
+    private readonly pollingIntervalMs;
+    private readonly shouldDropPending;
+    constructor(token: string, options?: BotOptions);
+    private sleep;
+    private dropPendingUpdates;
+    start(): Promise<void>;
+    stop(): void;
+}
+//# sourceMappingURL=bot.d.ts.map

package/dist/bot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bot.d.ts","sourceRoot":"","sources":["../src/bot.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,KAAK,EAAc,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACzE,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAG/C,MAAM,WAAW,UAAW,SAAQ,mBAAmB;IACrD,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,gBAAgB,GAAG,KAAK,CAAC;AAC9D,MAAM,MAAM,aAAa,GAAG,CAC1B,GAAG,EAAE,OAAO,EACZ,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,KACtB,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AAC1B,MAAM,MAAM,UAAU,GAAG,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AAOhE,qBAAa,QAAS,SAAQ,QAAQ;IACpC,SAAgB,MAAM,EAAE,SAAS,CAAC;IAClC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,YAAY,CAAqB;IACzC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;IAC3C,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAU;IAE5C,YAAY,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,UAAe,EAKlD;YAEa,KAAK;YAIL,kBAAkB;IAkC1B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAwD3B;IAED,IAAI,IAAI,IAAI,CAGX;CACF"}

package/dist/bot.js

@@ -0,0 +1,95 @@
+import { BotClient } from "./client/api-client.js";
+import { Composer } from "./routing/composer.js";
+import { Context } from "./context/context.js";
+export class Rubigram extends Composer {
+    client;
+    isPolling = false;
+    nextOffsetId;
+    pollingIntervalMs;
+    shouldDropPending;
+    constructor(token, options = {}) {
+        super();
+        this.client = new BotClient(token, options);
+        this.pollingIntervalMs = options.pollingIntervalMs ?? 1000;
+        this.shouldDropPending = options.dropPendingUpdates ?? true;
+    }
+    async sleep(ms) {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+    async dropPendingUpdates() {
+        let offsetId = this.nextOffsetId;
+        while (true) {
+            const payload = {
+                limit: 100,
+                ...(offsetId ? { offset_id: offsetId } : {}),
+            };
+            const response = await this.client.call("getUpdates", payload);
+            const updates = response.updates ?? [];
+            const nextOffsetId = response.next_offset_id;
+            if (updates.length === 0) {
+                if (nextOffsetId) {
+                    offsetId = nextOffsetId;
+                }
+                break;
+            }
+            if (!nextOffsetId || nextOffsetId === offsetId) {
+                break;
+            }
+            offsetId = nextOffsetId;
+        }
+        this.nextOffsetId = offsetId;
+    }
+    async start() {
+        if (this.isPolling) {
+            return;
+        }
+        this.isPolling = true;
+        if (this.shouldDropPending) {
+            try {
+                await this.dropPendingUpdates();
+            }
+            catch (error) {
+                this.isPolling = false;
+                console.error("❌ خطا در تخلیه پیام‌های قدیمی هنگام شروع:", error);
+                throw error;
+            }
+        }
+        while (this.isPolling) {
+            try {
+                const payload = {
+                    limit: 50,
+                    ...(this.nextOffsetId ? { offset_id: this.nextOffsetId } : {}),
+                };
+                const response = await this.client.call("getUpdates", payload);
+                if (response) {
+                    if (response.next_offset_id) {
+                        this.nextOffsetId = response.next_offset_id;
+                    }
+                    const updates = response.updates ?? [];
+                    for (const update of updates) {
+                        if (!this.isPolling)
+                            break;
+                        const ctx = new Context(this.client, update);
+                        try {
+                            await this.handle(ctx);
+                        }
+                        catch (error) {
+                            console.error("❌ خطا در پردازش میدلور:", error);
+                        }
+                    }
+                }
+            }
+            catch (error) {
+                console.error("❌ خطا در حلقه Polling:", error);
+            }
+            if (this.isPolling) {
+                await this.sleep(this.pollingIntervalMs);
+            }
+        }
+    }
+    stop() {
+        this.isPolling = false;
+        console.log("🛑 ربات خاموش شد.");
+    }
+}
+//# sourceMappingURL=bot.js.map

package/dist/bot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bot.js","sourceRoot":"","sources":["../src/bot.ts"],"names":[],"mappings":"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"}

package/dist/client/api-client.d.ts

@@ -0,0 +1,15 @@
+import type { JsonObject, RequestOptions, RubikaClientOptions } from "./types.js";
+export declare class BotClient {
+    readonly token: string;
+    readonly baseUrl: string;
+    private readonly timeoutMs;
+    private readonly defaultHeaders;
+    private readonly retries;
+    private readonly retryDelayMs;
+    constructor(token: string, options?: RubikaClientOptions);
+    private buildUrl;
+    private shouldRetry;
+    call<TResponse = unknown>(method: string, payload?: JsonObject, options?: RequestOptions): Promise<TResponse>;
+    private execute;
+}
+//# sourceMappingURL=api-client.d.ts.map

package/dist/client/api-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-client.d.ts","sourceRoot":"","sources":["../../src/client/api-client.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,UAAU,EACV,cAAc,EACd,mBAAmB,EACpB,MAAM,YAAY,CAAC;AAWpB,qBAAa,SAAS;IACpB,SAAgB,KAAK,EAAE,MAAM,CAAC;IAC9B,SAAgB,OAAO,EAAE,MAAM,CAAC;IAEhC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAyB;IACxD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IAEtC,YAAY,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,mBAAwB,EAoB3D;IAED,OAAO,CAAC,QAAQ;IAIhB,OAAO,CAAC,WAAW;IAab,IAAI,CAAC,SAAS,GAAG,OAAO,EAC5B,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,UAAe,EACxB,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,SAAS,CAAC,CA0BpB;YAEa,OAAO;CA+EtB"}

package/dist/client/api-client.js

@@ -0,0 +1,127 @@
+import { RubikaApiError, RubikaHttpError, RubikaTimeoutError, } from "./api-error.js";
+const DEFAULT_BASE_URL = "https://botapi.rubika.ir";
+const DEFAULT_TIMEOUT_MS = 15_000;
+const DEFAULT_RETRIES = 2;
+const DEFAULT_RETRY_DELAY_MS = 500;
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+export class BotClient {
+    token;
+    baseUrl;
+    timeoutMs;
+    defaultHeaders;
+    retries;
+    retryDelayMs;
+    constructor(token, options = {}) {
+        if (!token?.trim()) {
+            throw new Error("توکن بات روبیکا الزامی است.");
+        }
+        this.token = token.trim();
+        this.baseUrl = (options.baseUrl ?? DEFAULT_BASE_URL).replace(/\/+$/, "");
+        this.timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+        this.retries = Math.max(0, options.retries ?? DEFAULT_RETRIES);
+        this.retryDelayMs = Math.max(0, options.retryDelayMs ?? DEFAULT_RETRY_DELAY_MS);
+        this.defaultHeaders = {
+            "content-type": "application/json",
+            accept: "application/json",
+            "user-agent": "rubigram/0.1.0 (Node.js)",
+            ...(options.headers ?? {}),
+        };
+    }
+    buildUrl(method) {
+        return `${this.baseUrl}/v3/${this.token}/${method}`;
+    }
+    shouldRetry(error) {
+        if (error instanceof RubikaTimeoutError)
+            return true;
+        if (error instanceof RubikaHttpError) {
+            return (error.statusCode === 408 ||
+                error.statusCode === 425 ||
+                error.statusCode === 429 ||
+                error.statusCode >= 500);
+        }
+        return error instanceof TypeError;
+    }
+    async call(method, payload = {}, options = {}) {
+        if (!method?.trim()) {
+            throw new Error("نام متد API الزامی است.");
+        }
+        const timeoutMs = options.timeoutMs ?? this.timeoutMs;
+        const retries = Math.max(0, options.retries ?? this.retries);
+        let attempt = 0;
+        while (true) {
+            try {
+                return await this.execute(method, payload, options.signal, timeoutMs);
+            }
+            catch (error) {
+                const canRetry = attempt < retries && this.shouldRetry(error);
+                if (!canRetry)
+                    throw error;
+                const delay = this.retryDelayMs * 2 ** attempt;
+                await sleep(delay);
+                attempt += 1;
+            }
+        }
+    }
+    async execute(method, payload, externalSignal, timeoutMs) {
+        const controller = new AbortController();
+        let timedOut = false;
+        const timeoutId = setTimeout(() => {
+            timedOut = true;
+            controller.abort();
+        }, timeoutMs);
+        const abortHandler = () => controller.abort();
+        externalSignal?.addEventListener("abort", abortHandler, { once: true });
+        try {
+            const response = await fetch(this.buildUrl(method), {
+                method: "POST",
+                headers: this.defaultHeaders,
+                body: JSON.stringify(payload),
+                signal: controller.signal,
+            });
+            const responseBody = await response.json().catch(() => ({}));
+            if (!response.ok) {
+                throw new RubikaHttpError(`Rubika HTTP Error: ${response.status}`, {
+                    method,
+                    statusCode: response.status,
+                    statusText: response.statusText,
+                    responseBody,
+                });
+            }
+            if (typeof responseBody === "object" && responseBody !== null) {
+                const bodyRecord = responseBody;
+                if (bodyRecord["status"] !== undefined &&
+                    bodyRecord["status"] !== "OK" &&
+                    bodyRecord["status"] !== 200) {
+                    const message = String(bodyRecord["status_det"] ??
+                        bodyRecord["description"] ??
+                        "API Error");
+                    throw new RubikaApiError(`[${method}] ${message}`, method, responseBody);
+                }
+                if ("data" in bodyRecord) {
+                    return bodyRecord["data"];
+                }
+            }
+            return responseBody;
+        }
+        catch (error) {
+            if (timedOut)
+                throw new RubikaTimeoutError(method, timeoutMs);
+            if (error instanceof RubikaHttpError ||
+                error instanceof RubikaApiError ||
+                error instanceof RubikaTimeoutError) {
+                throw error;
+            }
+            if (error instanceof DOMException && error.name === "AbortError") {
+                throw new RubikaTimeoutError(method, timeoutMs);
+            }
+            throw error;
+        }
+        finally {
+            clearTimeout(timeoutId);
+            externalSignal?.removeEventListener("abort", abortHandler);
+        }
+    }
+}
+//# sourceMappingURL=api-client.js.map

package/dist/client/api-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-client.js","sourceRoot":"","sources":["../../src/client/api-client.ts"],"names":[],"mappings":"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"}

package/dist/client/api-error.d.ts

@@ -0,0 +1,22 @@
+import { RubikaRequestErrorDetails, RubikaError } from "./types.js";
+export declare class RubikaHttpError extends RubikaError {
+    readonly method: string;
+    readonly statusCode: number;
+    readonly statusText: string;
+    readonly responseBody: unknown;
+    constructor(message: string, details: RubikaRequestErrorDetails & {
+        statusCode: number;
+        statusText: string;
+    });
+}
+export declare class RubikaApiError extends RubikaError {
+    readonly method: string;
+    readonly response: unknown;
+    constructor(message: string, method: string, response: unknown);
+}
+export declare class RubikaTimeoutError extends RubikaError {
+    readonly method: string;
+    readonly timeoutMs: number;
+    constructor(method: string, timeoutMs: number);
+}
+//# sourceMappingURL=api-error.d.ts.map

package/dist/client/api-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-error.d.ts","sourceRoot":"","sources":["../../src/client/api-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAGpE,qBAAa,eAAgB,SAAQ,WAAW;IAC9C,SAAgB,MAAM,EAAE,MAAM,CAAC;IAC/B,SAAgB,UAAU,EAAE,MAAM,CAAC;IACnC,SAAgB,UAAU,EAAE,MAAM,CAAC;IACnC,SAAgB,YAAY,EAAE,OAAO,CAAC;IAEtC,YACE,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,yBAAyB,GAAG;QACnC,UAAU,EAAE,MAAM,CAAC;QACnB,UAAU,EAAE,MAAM,CAAC;KACpB,EAQF;CACF;AAED,qBAAa,cAAe,SAAQ,WAAW;IAC7C,SAAgB,MAAM,EAAE,MAAM,CAAC;IAC/B,SAAgB,QAAQ,EAAE,OAAO,CAAC;IAElC,YAAY,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAK7D;CACF;AAED,qBAAa,kBAAmB,SAAQ,WAAW;IACjD,SAAgB,MAAM,EAAE,MAAM,CAAC;IAC/B,SAAgB,SAAS,EAAE,MAAM,CAAC;IAElC,YAAY,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAK5C;CACF"}

package/dist/client/api-error.js

@@ -0,0 +1,36 @@
+import { RubikaError } from "./types.js";
+export class RubikaHttpError extends RubikaError {
+    method;
+    statusCode;
+    statusText;
+    responseBody;
+    constructor(message, details) {
+        super(message);
+        this.name = "RubikaHttpError";
+        this.method = details.method;
+        this.statusCode = details.statusCode;
+        this.statusText = details.statusText;
+        this.responseBody = details.responseBody;
+    }
+}
+export class RubikaApiError extends RubikaError {
+    method;
+    response;
+    constructor(message, method, response) {
+        super(message);
+        this.name = "RubikaApiError";
+        this.method = method;
+        this.response = response;
+    }
+}
+export class RubikaTimeoutError extends RubikaError {
+    method;
+    timeoutMs;
+    constructor(method, timeoutMs) {
+        super(`Rubika API request "${method}" timed out after ${timeoutMs}ms`);
+        this.name = "RubikaTimeoutError";
+        this.method = method;
+        this.timeoutMs = timeoutMs;
+    }
+}
+//# sourceMappingURL=api-error.js.map

package/dist/client/api-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-error.js","sourceRoot":"","sources":["../../src/client/api-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAA6B,WAAW,EAAE,MAAM,YAAY,CAAC;AAGpE,MAAM,OAAO,eAAgB,SAAQ,WAAW;IAC9B,MAAM,CAAS;IACf,UAAU,CAAS;IACnB,UAAU,CAAS;IACnB,YAAY,CAAU;IAEtC,YACE,OAAe,EACf,OAGC;QAED,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;QAC9B,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC7B,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;QACrC,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;QACrC,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;IAC3C,CAAC;CACF;AAED,MAAM,OAAO,cAAe,SAAQ,WAAW;IAC7B,MAAM,CAAS;IACf,QAAQ,CAAU;IAElC,YAAY,OAAe,EAAE,MAAc,EAAE,QAAiB;QAC5D,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;QAC7B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;CACF;AAED,MAAM,OAAO,kBAAmB,SAAQ,WAAW;IACjC,MAAM,CAAS;IACf,SAAS,CAAS;IAElC,YAAY,MAAc,EAAE,SAAiB;QAC3C,KAAK,CAAC,uBAAuB,MAAM,qBAAqB,SAAS,IAAI,CAAC,CAAC;QACvE,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;QACjC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;CACF"}

package/dist/client/types.d.ts

@@ -0,0 +1,40 @@
+export type JsonPrimitive = string | number | boolean | null;
+export type JsonValue = JsonPrimitive | JsonObject | JsonValue[];
+export interface JsonObject {
+    [key: string]: JsonValue;
+}
+export interface RubikaApiResponse<T = unknown> {
+    status?: string | number;
+    status_det?: string;
+    description?: string;
+    data?: T;
+    [key: string]: unknown;
+}
+export interface RubikaClientOptions {
+    baseUrl?: string;
+    timeoutMs?: number;
+    headers?: Record<string, string>;
+    retries?: number;
+    retryDelayMs?: number;
+}
+export interface RequestOptions {
+    signal?: AbortSignal;
+    timeoutMs?: number;
+    retries?: number;
+}
+export interface RubikaRequestErrorDetails {
+    method: string;
+    statusCode?: number;
+    statusText?: string;
+    responseBody?: unknown;
+}
+export declare class RubikaError extends Error {
+    constructor(message: string);
+}
+export interface RubikaRequestErrorDetails {
+    method: string;
+    statusCode?: number;
+    statusText?: string;
+    responseBody?: unknown;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/client/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/client/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;AAE7D,MAAM,MAAM,SAAS,GAAG,aAAa,GAAG,UAAU,GAAG,SAAS,EAAE,CAAC;AAEjE,MAAM,WAAW,UAAU;IACzB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;CAC1B;AAED,MAAM,WAAW,iBAAiB,CAAC,CAAC,GAAG,OAAO;IAC5C,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEjC,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,yBAAyB;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,qBAAa,WAAY,SAAQ,KAAK;IACpC,YAAY,OAAO,EAAE,MAAM,EAG1B;CACF;AAED,MAAM,WAAW,yBAAyB;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB"}

package/dist/client/types.js

@@ -0,0 +1,7 @@
+export class RubikaError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "RubikaError";
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/client/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/client/types.ts"],"names":[],"mappings":"AAyCA,MAAM,OAAO,WAAY,SAAQ,KAAK;IACpC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;IAC5B,CAAC;CACF"}

package/dist/context/context.d.ts

@@ -0,0 +1,31 @@
+import type { BotClient, Chat } from "../index.js";
+import type { ChatType, InlineKeyboard, ReplyKeyboard, Update } from "../index.js";
+export interface ReplyOptions {
+    reply_to_message_id?: string;
+    inline_keyboard?: InlineKeyboard;
+    reply_keyboard?: ReplyKeyboard;
+    disable_notification?: boolean;
+}
+export declare class Context<S = any> {
+    readonly client: BotClient;
+    readonly update: Update;
+    readonly chatId: string;
+    readonly messageId?: string;
+    readonly replyToMessageId?: string;
+    readonly text?: string;
+    readonly senderId?: string;
+    readonly senderType?: ChatType;
+    readonly chatType?: ChatType | string;
+    readonly isMessage: boolean;
+    session: S;
+    constructor(client: BotClient, update: Update);
+    get isGroup(): boolean;
+    get isPrivate(): boolean;
+    reply(text: string, options?: ReplyOptions): Promise<unknown>;
+    replyToSender(text: string, options?: Omit<ReplyOptions, "reply_to_message_id">): Promise<unknown>;
+    deleteMessage(messageIds: string | string[]): Promise<void>;
+    edit(newText: string, inline_keyboard?: InlineKeyboard): Promise<unknown>;
+    getChat(): Promise<Chat>;
+    banChatMember(userId: string): Promise<unknown>;
+}
+//# sourceMappingURL=context.d.ts.map

package/dist/context/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/context/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,IAAI,EAAc,MAAM,aAAa,CAAC;AAC/D,OAAO,KAAK,EACV,QAAQ,EACR,cAAc,EAEd,aAAa,EACb,MAAM,EACP,MAAM,aAAa,CAAC;AAErB,MAAM,WAAW,YAAY;IAC3B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,eAAe,CAAC,EAAE,cAAc,CAAC;IACjC,cAAc,CAAC,EAAE,aAAa,CAAC;IAC/B,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC;AAED,qBAAa,OAAO,CAAC,CAAC,GAAG,GAAG;IAC1B,SAAgB,MAAM,EAAE,SAAS,CAAC;IAClC,SAAgB,MAAM,EAAE,MAAM,CAAC;IAE/B,SAAgB,MAAM,EAAE,MAAM,CAAC;IAC/B,SAAgB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnC,SAAgB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1C,SAAgB,IAAI,CAAC,EAAE,MAAM,CAAC;IAC9B,SAAgB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClC,SAAgB,UAAU,CAAC,EAAE,QAAQ,CAAC;IACtC,SAAgB,QAAQ,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAC;IAC7C,SAAgB,SAAS,EAAE,OAAO,CAAC;IAC5B,OAAO,EAAG,CAAC,CAAC;IAEnB,YAAY,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EA6B5C;IAED,IAAI,OAAO,IAAI,OAAO,CAKrB;IAED,IAAI,SAAS,IAAI,OAAO,CAKvB;IAEK,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,YAAiB,oBA+CnD;IAEK,aAAa,CACjB,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,IAAI,CAAC,YAAY,EAAE,qBAAqB,CAAM,oBAMxD;IAEK,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,iBAShD;IAEK,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,eAAe,CAAC,EAAE,cAAc,oBAgB3D;IAEK,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAU7B;IAEK,aAAa,CAAC,MAAM,EAAE,MAAM,oBAajC;CACF"}