@dementevdev/maxbot-ts 1.0.0

package/dist/cjs/utils/Histogram.js

@@ -0,0 +1,103 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Histogram = exports.DEFAULT_BUCKETS = void 0;
+/**
+ * Стандартные границы корзин гистограммы в миллисекундах.
+ *
+ * Покрывают диапазон от быстрых (~5ms) до медленных (~1s) обработчиков.
+ * Совпадают с дефолтными bucket-ами Prometheus Go-клиента (DefBuckets).
+ */
+exports.DEFAULT_BUCKETS = [
+    5, 10, 25, 50, 100, 250, 500, 1000,
+];
+/**
+ * Гистограмма задержек.
+ *
+ * Накапливает измерения (в мс) по заранее заданным boundary-корзинам.
+ * Формат снимка ({@link HistogramSnapshot}) совместим с Prometheus histogram
+ * — можно скармировать напрямую `prom-client` или аналогу.
+ *
+ * @example Интеграция с onMetrics
+ * ```ts
+ * const histogram = new Histogram();
+ *
+ * bot = new Bot({
+ *   token: process.env.MAX_BOT_TOKEN!,
+ *   transport: "polling",
+ *   onMetrics: (m) => histogram.observe(m.totalMs),
+ * });
+ *
+ * // Раз в минуту — публикуем снимок
+ * setInterval(() => {
+ *   const snap = histogram.snapshot();
+ *   console.log(`p50≈${snap.buckets["50"]} count=${snap.count} sum=${snap.sum}ms`);
+ *   histogram.reset(); // сбрасываем для следующего окна
+ * }, 60_000);
+ * ```
+ *
+ * @example Кастомные корзины
+ * ```ts
+ * const h = new Histogram([10, 50, 200, 1000, 5000]);
+ * ```
+ */
+class Histogram {
+    boundaries;
+    /** Кумулятивные счётчики: counts[i] = число наблюдений ≤ boundaries[i] */
+    counts;
+    _sum = 0;
+    _count = 0;
+    /**
+     * @param boundaries - Границы корзин в мс (порядок не важен, будут отсортированы).
+     *   По умолчанию — {@link DEFAULT_BUCKETS}.
+     */
+    constructor(boundaries = exports.DEFAULT_BUCKETS) {
+        // Дедупликация и сортировка по возрастанию
+        this.boundaries = [...new Set(boundaries)].sort((a, b) => a - b);
+        this.counts = new Array(this.boundaries.length).fill(0);
+    }
+    /**
+     * Записывает одно измерение.
+     *
+     * Инкрементирует все корзины, чья граница ≥ `ms` (кумулятивный формат).
+     *
+     * @param ms - Значение в миллисекундах (обычно `BotMetrics.totalMs`)
+     */
+    observe(ms) {
+        this._sum += ms;
+        this._count++;
+        for (let i = 0; i < this.boundaries.length; i++) {
+            if (ms <= this.boundaries[i]) {
+                this.counts[i]++;
+            }
+        }
+    }
+    /**
+     * Возвращает текущий снимок гистограммы (не изменяет состояние).
+     *
+     * Структура `buckets` — кумулятивные счётчики Prometheus:
+     * - `"5"` → число наблюдений ≤ 5ms
+     * - `"10"` → число наблюдений ≤ 10ms
+     * - …
+     * - `"+Inf"` → общее число наблюдений
+     */
+    snapshot() {
+        const buckets = {};
+        for (let i = 0; i < this.boundaries.length; i++) {
+            buckets[String(this.boundaries[i])] = this.counts[i];
+        }
+        buckets["+Inf"] = this._count;
+        return { buckets, sum: this._sum, count: this._count };
+    }
+    /**
+     * Сбрасывает все счётчики.
+     *
+     * Используйте для скользящих окон (например, раз в минуту).
+     */
+    reset() {
+        this.counts.fill(0);
+        this._sum = 0;
+        this._count = 0;
+    }
+}
+exports.Histogram = Histogram;
+//# sourceMappingURL=Histogram.js.map

package/dist/cjs/utils/assertNever.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Exhaustiveness check для discriminated union-ов.
+ *
+ * Вызывается в `default`-ветке switch чтобы TypeScript статически гарантировал,
+ * что все варианты union обработаны. Если ветка достигается в рантайме —
+ * бросает ошибку с понятным сообщением вместо молчаливого некорректного поведения.
+ *
+ * @example
+ * ```typescript
+ * switch (update.update_type) {
+ *   case "message_created": ...
+ *   case "message_callback": ...
+ *   default:
+ *     assertNever(update); // ошибка компиляции если добавить новый update_type
+ * }
+ * ```
+ */
+export declare function assertNever(value: never): never;
+//# sourceMappingURL=assertNever.d.ts.map

package/dist/cjs/utils/assertNever.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assertNever.d.ts","sourceRoot":"","sources":["../../../src/utils/assertNever.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,KAAK,CAI/C"}

package/dist/cjs/utils/assertNever.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.assertNever = assertNever;
+/**
+ * Exhaustiveness check для discriminated union-ов.
+ *
+ * Вызывается в `default`-ветке switch чтобы TypeScript статически гарантировал,
+ * что все варианты union обработаны. Если ветка достигается в рантайме —
+ * бросает ошибку с понятным сообщением вместо молчаливого некорректного поведения.
+ *
+ * @example
+ * ```typescript
+ * switch (update.update_type) {
+ *   case "message_created": ...
+ *   case "message_callback": ...
+ *   default:
+ *     assertNever(update); // ошибка компиляции если добавить новый update_type
+ * }
+ * ```
+ */
+function assertNever(value) {
+    throw new Error(`assertNever: необработанный вариант: ${JSON.stringify(value)}`);
+}
+//# sourceMappingURL=assertNever.js.map

package/dist/cjs/utils/format.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Утилиты форматирования текста сообщений.
+ */
+export declare const md: {
+    readonly bold: (text: string) => string;
+    readonly italic: (text: string) => string;
+    readonly strike: (text: string) => string;
+    readonly underline: (text: string) => string;
+    readonly link: (text: string, url: string) => string;
+    readonly mention: (userId: number, text: string) => string;
+    readonly escape: (text: string) => string;
+};
+export declare const html: {
+    readonly bold: (text: string) => string;
+    readonly italic: (text: string) => string;
+    readonly strike: (text: string) => string;
+    readonly underline: (text: string) => string;
+    readonly link: (text: string, url: string) => string;
+    readonly mention: (userId: number, text: string) => string;
+    readonly escape: (text: string) => string;
+};
+//# sourceMappingURL=format.d.ts.map

package/dist/cjs/utils/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../../src/utils/format.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,EAAE;0BACA,MAAM;4BACJ,MAAM;4BACN,MAAM;+BACH,MAAM;0BACX,MAAM,OAAO,MAAM;+BACd,MAAM,QAAQ,MAAM;4BACvB,MAAM;CACb,CAAC;AAEX,eAAO,MAAM,IAAI;0BACF,MAAM;4BACJ,MAAM;4BACN,MAAM;+BACH,MAAM;0BACX,MAAM,OAAO,MAAM;+BACd,MAAM,QAAQ,MAAM;4BAEvB,MAAM;CAEb,CAAC"}

package/dist/cjs/utils/format.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.html = exports.md = void 0;
+/**
+ * Утилиты форматирования текста сообщений.
+ */
+exports.md = {
+    bold: (text) => `**${text}**`,
+    italic: (text) => `_${text}_`,
+    strike: (text) => `~~${text}~~`,
+    underline: (text) => `++${text}++`,
+    link: (text, url) => `[${text}](${url})`,
+    mention: (userId, text) => `[${text}](max://user/${userId})`,
+    escape: (text) => text.replace(/[*_~+\[\]()\\]/g, "\\$&"),
+};
+exports.html = {
+    bold: (text) => `<b>${text}</b>`,
+    italic: (text) => `<i>${text}</i>`,
+    strike: (text) => `<del>${text}</del>`,
+    underline: (text) => `<ins>${text}</ins>`,
+    link: (text, url) => `<a href="${url}">${text}</a>`,
+    mention: (userId, text) => `<a href="max://user/${userId}">${text}</a>`,
+    escape: (text) => text.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;"),
+};
+//# sourceMappingURL=format.js.map

package/dist/cjs/utils/index.d.ts

@@ -0,0 +1,6 @@
+export { InlineKeyboard } from "./keyboard.js";
+export { md, html } from "./format.js";
+export { assertNever } from "./assertNever.js";
+export { Histogram, DEFAULT_BUCKETS } from "./Histogram.js";
+export type { HistogramSnapshot } from "./Histogram.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAC5D,YAAY,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/cjs/utils/index.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_BUCKETS = exports.Histogram = exports.assertNever = exports.html = exports.md = exports.InlineKeyboard = void 0;
+var keyboard_js_1 = require("./keyboard.js");
+Object.defineProperty(exports, "InlineKeyboard", { enumerable: true, get: function () { return keyboard_js_1.InlineKeyboard; } });
+var format_js_1 = require("./format.js");
+Object.defineProperty(exports, "md", { enumerable: true, get: function () { return format_js_1.md; } });
+Object.defineProperty(exports, "html", { enumerable: true, get: function () { return format_js_1.html; } });
+var assertNever_js_1 = require("./assertNever.js");
+Object.defineProperty(exports, "assertNever", { enumerable: true, get: function () { return assertNever_js_1.assertNever; } });
+var Histogram_js_1 = require("./Histogram.js");
+Object.defineProperty(exports, "Histogram", { enumerable: true, get: function () { return Histogram_js_1.Histogram; } });
+Object.defineProperty(exports, "DEFAULT_BUCKETS", { enumerable: true, get: function () { return Histogram_js_1.DEFAULT_BUCKETS; } });
+//# sourceMappingURL=index.js.map

package/dist/cjs/utils/keyboard.d.ts

@@ -0,0 +1,70 @@
+import type { ButtonIntent, InlineKeyboardAttachment } from "../types/keyboard.js";
+/**
+ * Builder для inline-клавиатуры.
+ */
+export declare class InlineKeyboard {
+    private readonly rows;
+    private get currentRow();
+    /**
+     * Добавить callback-кнопку.
+     */
+    button(text: string, payload: string, intent?: ButtonIntent): this;
+    /**
+     * Добавить кнопку-ссылку.
+     */
+    url(text: string, url: string, intent?: ButtonIntent): this;
+    /**
+     * Запросить контакт пользователя (только текст).
+     */
+    requestContact(text: string, intent?: ButtonIntent): this;
+    /**
+     * Запросить геолокацию пользователя.
+     */
+    requestGeoLocation(text: string, options?: {
+        quick?: boolean;
+        intent?: ButtonIntent;
+    }): this;
+    /**
+     * Открыть приложение.
+     */
+    openApp(text: string, options?: {
+        web_app?: string;
+        contact_id?: number;
+        payload?: string;
+        intent?: ButtonIntent;
+    }): this;
+    /**
+     * Создать новый чат с ботом.
+     *
+     * При нажатии открывается диалог создания чата — пользователь может его
+     * переименовать или отменить. После создания бот получит событие `bot_added`.
+     *
+     * @param text - Текст кнопки
+     * @param chatTitle - Предзаполненное название чата
+     * @param options - Дополнительные параметры
+     */
+    chat(text: string, chatTitle: string, options?: {
+        /** Описание чата */
+        chat_description?: string | null;
+        /** Payload для bot_started (до 1024 символов) */
+        start_payload?: string | null;
+        /** UUID для предотвращения дублирования при повторных нажатиях */
+        uuid?: string | null;
+    }): this;
+    /**
+     * Отправить сообщение из клиента (текст кнопки отправится в чат от лица пользователя).
+     */
+    message(text: string, intent?: ButtonIntent): this;
+    /**
+     * Завершить текущую строку и начать новую.
+     */
+    row(): this;
+    /**
+     * Построить вложение inline-клавиатуры.
+     */
+    build(): InlineKeyboardAttachment;
+    private pushButton;
+    private assertText;
+    private assertUrl;
+}
+//# sourceMappingURL=keyboard.d.ts.map

package/dist/cjs/utils/keyboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyboard.d.ts","sourceRoot":"","sources":["../../../src/utils/keyboard.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAEV,YAAY,EACZ,wBAAwB,EACzB,MAAM,sBAAsB,CAAC;AAI9B;;GAEG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAoB;IAEzC,OAAO,KAAK,UAAU,GAGrB;IAED;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,YAAY,GAAG,IAAI;IAalE;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,YAAY,GAAG,IAAI;IAc3D;;OAEG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,YAAY,GAAG,IAAI;IAYzD;;OAEG;IACH,kBAAkB,CAChB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,YAAY,CAAA;KAAE,GACnD,IAAI;IAaP;;OAEG;IACH,OAAO,CACL,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;QACR,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,MAAM,CAAC,EAAE,YAAY,CAAC;KACvB,GACA,IAAI;IAiBP;;;;;;;;;OASG;IACH,IAAI,CACF,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE;QACR,oBAAoB;QACpB,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACjC,iDAAiD;QACjD,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC9B,kEAAkE;QAClE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KACtB,GACA,IAAI;IAsBP;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,YAAY,GAAG,IAAI;IAYlD;;OAEG;IACH,GAAG,IAAI,IAAI;IAKX;;OAEG;IACH,KAAK,IAAI,wBAAwB;IAkBjC,OAAO,CAAC,UAAU;IAIlB,OAAO,CAAC,UAAU;IAMlB,OAAO,CAAC,SAAS;CASlB"}

package/dist/cjs/utils/keyboard.js

@@ -0,0 +1,166 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InlineKeyboard = void 0;
+const index_js_1 = require("../core/errors/index.js");
+const MAX_BUTTONS = 210;
+/**
+ * Builder для inline-клавиатуры.
+ */
+class InlineKeyboard {
+    rows = [[]];
+    get currentRow() {
+        // eslint-disable-next-line @typescript-eslint/no-non-null-assertion -- rows всегда содержит хотя бы одну строку (инициализирована как [[]])
+        return this.rows[this.rows.length - 1];
+    }
+    /**
+     * Добавить callback-кнопку.
+     */
+    button(text, payload, intent) {
+        this.assertText(text);
+        this.pushButton({
+            type: "callback",
+            text,
+            payload,
+            ...(intent ? { intent } : {}),
+        });
+        return this;
+    }
+    /**
+     * Добавить кнопку-ссылку.
+     */
+    url(text, url, intent) {
+        this.assertText(text);
+        this.assertUrl(url);
+        this.pushButton({
+            type: "link",
+            text,
+            url,
+            ...(intent ? { intent } : {}),
+        });
+        return this;
+    }
+    /**
+     * Запросить контакт пользователя (только текст).
+     */
+    requestContact(text, intent) {
+        this.assertText(text);
+        this.pushButton({
+            type: "request_contact",
+            text,
+            ...(intent ? { intent } : {}),
+        });
+        return this;
+    }
+    /**
+     * Запросить геолокацию пользователя.
+     */
+    requestGeoLocation(text, options) {
+        this.assertText(text);
+        this.pushButton({
+            type: "request_geo_location",
+            text,
+            ...(options?.quick ? { quick: options.quick } : {}),
+            ...(options?.intent ? { intent: options.intent } : {}),
+        });
+        return this;
+    }
+    /**
+     * Открыть приложение.
+     */
+    openApp(text, options) {
+        this.assertText(text);
+        this.pushButton({
+            type: "open_app",
+            text,
+            ...(options?.web_app ? { web_app: options.web_app } : {}),
+            ...(typeof options?.contact_id === "number"
+                ? { contact_id: options.contact_id }
+                : {}),
+            ...(options?.payload ? { payload: options.payload } : {}),
+            ...(options?.intent ? { intent: options.intent } : {}),
+        });
+        return this;
+    }
+    /**
+     * Создать новый чат с ботом.
+     *
+     * При нажатии открывается диалог создания чата — пользователь может его
+     * переименовать или отменить. После создания бот получит событие `bot_added`.
+     *
+     * @param text - Текст кнопки
+     * @param chatTitle - Предзаполненное название чата
+     * @param options - Дополнительные параметры
+     */
+    chat(text, chatTitle, options) {
+        this.assertText(text);
+        if (!chatTitle || typeof chatTitle !== "string") {
+            throw new index_js_1.ValidationError("chat_title должен быть непустой строкой");
+        }
+        this.pushButton({
+            type: "chat",
+            text,
+            chat_title: chatTitle,
+            ...(options?.chat_description != null
+                ? { chat_description: options.chat_description }
+                : {}),
+            ...(options?.start_payload != null
+                ? { start_payload: options.start_payload }
+                : {}),
+            ...(options?.uuid != null ? { uuid: options.uuid } : {}),
+        });
+        return this;
+    }
+    /**
+     * Отправить сообщение из клиента (текст кнопки отправится в чат от лица пользователя).
+     */
+    message(text, intent) {
+        this.assertText(text);
+        this.pushButton({
+            type: "message",
+            text,
+            ...(intent ? { intent } : {}),
+        });
+        return this;
+    }
+    /**
+     * Завершить текущую строку и начать новую.
+     */
+    row() {
+        this.rows.push([]);
+        return this;
+    }
+    /**
+     * Построить вложение inline-клавиатуры.
+     */
+    build() {
+        const rows = this.rows.filter((row) => row.length > 0);
+        const total = rows.reduce((count, row) => count + row.length, 0);
+        if (total > MAX_BUTTONS) {
+            throw new index_js_1.ValidationError(`Превышен лимит кнопок: ${total}/${MAX_BUTTONS}`);
+        }
+        return {
+            type: "inline_keyboard",
+            payload: {
+                buttons: rows,
+            },
+        };
+    }
+    pushButton(button) {
+        this.currentRow.push(button);
+    }
+    assertText(text) {
+        if (!text || typeof text !== "string") {
+            throw new index_js_1.ValidationError("Текст кнопки должен быть непустой строкой");
+        }
+    }
+    assertUrl(url) {
+        if (!url || typeof url !== "string") {
+            throw new index_js_1.ValidationError("URL должен быть строкой");
+        }
+        if (!url.startsWith("http://") && !url.startsWith("https://")) {
+            throw new index_js_1.ValidationError("URL должен начинаться с http:// или https://");
+        }
+    }
+}
+exports.InlineKeyboard = InlineKeyboard;
+//# sourceMappingURL=keyboard.js.map

package/dist/esm/api/BotsApi.d.ts

@@ -0,0 +1,17 @@
+import type { IHttpClient } from "../core/http/interfaces.js";
+import type { BotInfo } from "../types/bot.js";
+import type { IBotsApi } from "./interfaces.js";
+/**
+ * API для работы с ботами.
+ */
+export declare class BotsApi implements IBotsApi {
+    private readonly http;
+    constructor(http: IHttpClient);
+    /**
+     * Получить информацию о текущем боте.
+     *
+     * Используется для проверки валидности токена и получения данных бота.
+     */
+    getMe(): Promise<BotInfo>;
+}
+//# sourceMappingURL=BotsApi.d.ts.map

package/dist/esm/api/BotsApi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BotsApi.d.ts","sourceRoot":"","sources":["../../../src/api/BotsApi.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAEhD;;GAEG;AACH,qBAAa,OAAQ,YAAW,QAAQ;IAC1B,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,WAAW;IAE9C;;;;OAIG;IACG,KAAK,IAAI,OAAO,CAAC,OAAO,CAAC;CAGhC"}

package/dist/esm/api/BotsApi.js

@@ -0,0 +1,18 @@
+/**
+ * API для работы с ботами.
+ */
+export class BotsApi {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    /**
+     * Получить информацию о текущем боте.
+     *
+     * Используется для проверки валидности токена и получения данных бота.
+     */
+    async getMe() {
+        return this.http.get("/me");
+    }
+}
+//# sourceMappingURL=BotsApi.js.map

package/dist/esm/api/ChatsApi.d.ts

@@ -0,0 +1,87 @@
+import type { IHttpClient } from "../core/http/interfaces.js";
+import type { Chat, ChatMember, ChatsResponse, GetChatsParams, UpdateChatRequest } from "../types/chat.js";
+import type { Message } from "../types/message.js";
+import type { User } from "../types/common.js";
+import type { IChatsApi } from "./interfaces.js";
+/**
+ * API для работы с чатами.
+ */
+export declare class ChatsApi implements IChatsApi {
+    private readonly http;
+    constructor(http: IHttpClient);
+    /**
+     * Получить список чатов, в которых участвует бот.
+     */
+    getChats(params?: GetChatsParams): Promise<ChatsResponse>;
+    /**
+     * Получить информацию о чате по ID.
+     */
+    getChat(chatId: number): Promise<Chat>;
+    /**
+     * Получить информацию о чате по ссылке.
+     */
+    getChatByLink(chatLink: string): Promise<Chat>;
+    /**
+     * Обновить информацию о чате.
+     */
+    updateChat(chatId: number, data: UpdateChatRequest): Promise<Chat>;
+    /**
+     * Удалить чат.
+     */
+    deleteChat(chatId: number): Promise<void>;
+    /**
+     * Отправить действие в чат (например, "печатает...").
+     *
+     * Показывает пользователям, что бот обрабатывает запрос.
+     */
+    sendAction(chatId: number, action: string): Promise<void>;
+    /**
+     * Получить закреплённое сообщение.
+     */
+    getPinnedMessage(chatId: number): Promise<Message | null>;
+    /**
+     * Закрепить сообщение в чате.
+     */
+    pinMessage(chatId: number, messageId: string): Promise<void>;
+    /**
+     * Открепить сообщение в чате.
+     */
+    unpinMessage(chatId: number): Promise<void>;
+    /**
+     * Получить информацию о членстве бота в чате.
+     */
+    getBotMembership(chatId: number): Promise<ChatMember>;
+    /**
+     * Покинуть чат.
+     */
+    leaveChat(chatId: number): Promise<void>;
+    /**
+     * Получить участников чата.
+     */
+    getMembers(chatId: number): Promise<{
+        members: ChatMember[];
+    }>;
+    /**
+     * Добавить участников в чат.
+     */
+    addMembers(chatId: number, userIds: number[]): Promise<void>;
+    /**
+     * Удалить участника из чата.
+     */
+    removeMember(chatId: number, userId: number): Promise<void>;
+    /**
+     * Получить администраторов чата.
+     */
+    getAdmins(chatId: number): Promise<{
+        admins: User[];
+    }>;
+    /**
+     * Добавить администратора в чат.
+     */
+    addAdmin(chatId: number, userId: number): Promise<void>;
+    /**
+     * Удалить администратора из чата.
+     */
+    removeAdmin(chatId: number, userId: number): Promise<void>;
+}
+//# sourceMappingURL=ChatsApi.d.ts.map

package/dist/esm/api/ChatsApi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChatsApi.d.ts","sourceRoot":"","sources":["../../../src/api/ChatsApi.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,KAAK,EACV,IAAI,EACJ,UAAU,EACV,aAAa,EACb,cAAc,EACd,iBAAiB,EAClB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD;;GAEG;AACH,qBAAa,QAAS,YAAW,SAAS;IAC5B,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,WAAW;IAE9C;;OAEG;IACG,QAAQ,CAAC,MAAM,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IAS/D;;OAEG;IACG,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI5C;;OAEG;IACG,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpD;;OAEG;IACG,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAMxE;;OAEG;IACG,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI/C;;;;OAIG;IACG,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAM/D;;OAEG;IACG,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IAgB/D;;OAEG;IACG,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMlE;;OAEG;IACG,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIjD;;OAEG;IACG,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAI3D;;OAEG;IACG,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI9C;;OAEG;IACG,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,UAAU,EAAE,CAAA;KAAE,CAAC;IAIpE;;OAEG;IACG,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAMlE;;OAEG;IACG,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIjE;;OAEG;IACG,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,IAAI,EAAE,CAAA;KAAE,CAAC;IAI5D;;OAEG;IACG,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAM7D;;OAEG;IACG,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAGjE"}