@dementevdev/maxbot-ts 1.0.0

package/dist/esm/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/esm/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/esm/utils/keyboard.js

@@ -0,0 +1,162 @@
+import { ValidationError } from "../core/errors/index.js";
+const MAX_BUTTONS = 210;
+/**
+ * Builder для inline-клавиатуры.
+ */
+export 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 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 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 ValidationError("Текст кнопки должен быть непустой строкой");
+        }
+    }
+    assertUrl(url) {
+        if (!url || typeof url !== "string") {
+            throw new ValidationError("URL должен быть строкой");
+        }
+        if (!url.startsWith("http://") && !url.startsWith("https://")) {
+            throw new ValidationError("URL должен начинаться с http:// или https://");
+        }
+    }
+}
+//# sourceMappingURL=keyboard.js.map

package/dist/types/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/types/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/types/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/types/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"}

package/dist/types/api/MessagesApi.d.ts

@@ -0,0 +1,41 @@
+import type { IHttpClient } from "../core/http/interfaces.js";
+import type { Message, NewMessageBody, SendMessageParams, SendMessageResponse } from "../types/message.js";
+import type { IMessagesApi } from "./interfaces.js";
+/**
+ * API для работы с сообщениями.
+ */
+export declare class MessagesApi implements IMessagesApi {
+    private readonly http;
+    constructor(http: IHttpClient);
+    /**
+     * Получить сообщение по ID.
+     */
+    getMessage(messageId: string): Promise<Message>;
+    /**
+     * Отправить сообщение.
+     *
+     * @param params - Параметры отправки (user_id или chat_id)
+     * @param body - Тело сообщения (текст, вложения)
+     */
+    sendMessage(params: SendMessageParams, body: NewMessageBody): Promise<SendMessageResponse>;
+    /**
+     * Редактировать сообщение.
+     */
+    editMessage(messageId: string, body: NewMessageBody): Promise<void>;
+    /**
+     * Удалить сообщение.
+     */
+    deleteMessage(messageId: string): Promise<void>;
+    /**
+     * Ответить на callback-запрос.
+     *
+     * Вызывается для закрытия "часиков" на кнопке и опционально показа уведомления.
+     * MAX API требует хотя бы одно из полей `message` или `notification`;
+     * при вызове без аргументов автоматически передаётся `notification: ""`.
+     */
+    answerCallback(callbackId: string, data?: {
+        message?: NewMessageBody;
+        notification?: string;
+    }): Promise<void>;
+}
+//# sourceMappingURL=MessagesApi.d.ts.map

package/dist/types/api/MessagesApi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MessagesApi.d.ts","sourceRoot":"","sources":["../../../src/api/MessagesApi.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,KAAK,EACV,OAAO,EACP,cAAc,EACd,iBAAiB,EACjB,mBAAmB,EACpB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEpD;;GAEG;AACH,qBAAa,WAAY,YAAW,YAAY;IAClC,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,WAAW;IAE9C;;OAEG;IACG,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIrD;;;;;OAKG;IACG,WAAW,CACf,MAAM,EAAE,iBAAiB,EACzB,IAAI,EAAE,cAAc,GACnB,OAAO,CAAC,mBAAmB,CAAC;IAW/B;;OAEG;IACG,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAOzE;;OAEG;IACG,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMrD;;;;;;OAMG;IACG,cAAc,CAClB,UAAU,EAAE,MAAM,EAClB,IAAI,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,cAAc,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,GACzD,OAAO,CAAC,IAAI,CAAC;CAMjB"}

package/dist/types/api/SubscriptionsApi.d.ts

@@ -0,0 +1,45 @@
+import type { IHttpClient } from "../core/http/interfaces.js";
+import type { SubscribeRequest, SubscriptionInfo } from "../types/subscription.js";
+import type { GetUpdatesParams, UpdatesResponse } from "../types/update.js";
+import type { ISubscriptionsApi } from "./interfaces.js";
+/**
+ * API для работы с подписками на обновления.
+ *
+ * Поддерживает два режима получения обновлений:
+ * - Webhook: MAX сам отправляет обновления на указанный URL
+ * - Long Polling: бот периодически запрашивает обновления
+ */
+export declare class SubscriptionsApi implements ISubscriptionsApi {
+    private readonly http;
+    constructor(http: IHttpClient);
+    /**
+     * Получить информацию о текущей подписке.
+     *
+     * Позволяет проверить, настроен ли webhook.
+     */
+    getSubscriptions(): Promise<SubscriptionInfo>;
+    /**
+     * Подписаться на обновления (установить webhook).
+     *
+     * URL должен быть HTTPS — требование API для безопасности.
+     */
+    subscribe(request: SubscribeRequest): Promise<void>;
+    /**
+     * Отписаться от обновлений (удалить webhook).
+     *
+     * После удаления webhook можно использовать long polling.
+     */
+    unsubscribe(): Promise<void>;
+    /**
+     * Получить обновления (long polling).
+     *
+     * Запрос блокируется на сервере до появления обновлений или истечения таймаута.
+     * Это более эффективно, чем постоянные короткие запросы.
+     *
+     * @param params.timeout - Время ожидания в секундах (по умолчанию 30)
+     * @param params.limit - Максимальное количество обновлений (по умолчанию 100)
+     * @param params.marker - Маркер для пагинации (получен из предыдущего ответа)
+     */
+    getUpdates(params?: GetUpdatesParams, signal?: AbortSignal): Promise<UpdatesResponse>;
+}
+//# sourceMappingURL=SubscriptionsApi.d.ts.map

package/dist/types/api/SubscriptionsApi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SubscriptionsApi.d.ts","sourceRoot":"","sources":["../../../src/api/SubscriptionsApi.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,KAAK,EACV,gBAAgB,EAChB,gBAAgB,EACjB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC5E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEzD;;;;;;GAMG;AACH,qBAAa,gBAAiB,YAAW,iBAAiB;IAC5C,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,WAAW;IAE9C;;;;OAIG;IACG,gBAAgB,IAAI,OAAO,CAAC,gBAAgB,CAAC;IAInD;;;;OAIG;IACG,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAMzD;;;;OAIG;IACG,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAIlC;;;;;;;;;OASG;IACG,UAAU,CACd,MAAM,CAAC,EAAE,gBAAgB,EACzB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,eAAe,CAAC;CAe5B"}

package/dist/types/api/UploadsApi.d.ts

@@ -0,0 +1,45 @@
+import type { IHttpClient } from "../core/http/interfaces.js";
+import type { UploadResponse, UploadType, UploadUrlResponse } from "../types/upload.js";
+import type { IUploadsApi } from "./interfaces.js";
+/**
+ * API для загрузки файлов.
+ *
+ * Процесс загрузки двухэтапный:
+ * 1. Получить URL для загрузки через getUploadUrl
+ * 2. Загрузить файл на полученный URL через uploadFile
+ */
+export declare class UploadsApi implements IUploadsApi {
+    private readonly http;
+    private readonly token;
+    constructor(http: IHttpClient, token: string);
+    /**
+     * Получить URL для загрузки файла.
+     *
+     * @param type - Тип файла (image, video, audio, file)
+     */
+    getUploadUrl(type: UploadType): Promise<UploadUrlResponse>;
+    /**
+     * Загрузить файл на полученный URL.
+     *
+     * Используется multipart/form-data для передачи файла.
+     * Этот метод не проходит через rate limiter, так как загрузка
+     * идёт на отдельный сервер.
+     *
+     * Ограничения multipart upload:
+     * - Максимальный размер файла: 4 ГБ
+     * - Можно загружать только один файл за раз
+     */
+    uploadFile(uploadUrl: string, file: Blob, filename: string): Promise<UploadResponse>;
+    /**
+     * Resumable upload (без multipart/form-data).
+     *
+     * Загружает файл чанками с Content-Range.
+     */
+    uploadFileResumable(uploadUrl: string, file: Blob, options?: {
+        chunkSize?: number;
+        contentType?: string;
+        onProgress?: (sentBytes: number, totalBytes: number) => void;
+        signal?: AbortSignal;
+    }): Promise<UploadResponse>;
+}
+//# sourceMappingURL=UploadsApi.d.ts.map

package/dist/types/api/UploadsApi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UploadsApi.d.ts","sourceRoot":"","sources":["../../../src/api/UploadsApi.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,KAAK,EACV,cAAc,EACd,UAAU,EACV,iBAAiB,EAClB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEnD;;;;;;GAMG;AACH,qBAAa,UAAW,YAAW,WAAW;IAE1C,OAAO,CAAC,QAAQ,CAAC,IAAI;IAGrB,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAHL,IAAI,EAAE,WAAW,EAGjB,KAAK,EAAE,MAAM;IAGhC;;;;OAIG;IACG,YAAY,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAMhE;;;;;;;;;;OAUG;IACG,UAAU,CACd,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,IAAI,EACV,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,cAAc,CAAC;IAiC1B;;;;OAIG;IACG,mBAAmB,CACvB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,IAAI,EACV,OAAO,CAAC,EAAE;QACR,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,UAAU,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;QAC7D,MAAM,CAAC,EAAE,WAAW,CAAC;KACtB,GACA,OAAO,CAAC,cAAc,CAAC;CA6C3B"}

package/dist/types/api/index.d.ts

@@ -0,0 +1,7 @@
+export { BotsApi } from "./BotsApi.js";
+export { ChatsApi } from "./ChatsApi.js";
+export { MessagesApi } from "./MessagesApi.js";
+export { SubscriptionsApi } from "./SubscriptionsApi.js";
+export { UploadsApi } from "./UploadsApi.js";
+export type { IBotsApi, IChatsApi, IMessagesApi, ISubscriptionsApi, IUploadsApi, } from "./interfaces.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/types/api/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/api/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,YAAY,EACV,QAAQ,EACR,SAAS,EACT,YAAY,EACZ,iBAAiB,EACjB,WAAW,GACZ,MAAM,iBAAiB,CAAC"}

package/dist/types/api/interfaces.d.ts

@@ -0,0 +1,108 @@
+import type { BotInfo } from "../types/bot.js";
+import type { Chat, ChatMember, ChatsResponse, GetChatsParams, UpdateChatRequest } from "../types/chat.js";
+import type { Message, NewMessageBody, SendMessageParams, SendMessageResponse } from "../types/message.js";
+import type { SubscribeRequest, SubscriptionInfo } from "../types/subscription.js";
+import type { GetUpdatesParams, UpdatesResponse } from "../types/update.js";
+import type { UploadResponse, UploadType, UploadUrlResponse } from "../types/upload.js";
+import type { User } from "../types/common.js";
+/**
+ * Интерфейс API ботов
+ */
+export interface IBotsApi {
+    /** Получить информацию о текущем боте */
+    getMe(): Promise<BotInfo>;
+}
+/**
+ * Интерфейс API чатов
+ */
+export interface IChatsApi {
+    /** Получить список чатов */
+    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>;
+}
+/**
+ * Интерфейс API сообщений
+ */
+export interface IMessagesApi {
+    /** Получить сообщение по ID */
+    getMessage(messageId: string): Promise<Message>;
+    /** Отправить сообщение */
+    sendMessage(params: SendMessageParams, body: NewMessageBody): Promise<SendMessageResponse>;
+    /** Редактировать сообщение */
+    editMessage(messageId: string, body: NewMessageBody): Promise<void>;
+    /** Удалить сообщение */
+    deleteMessage(messageId: string): Promise<void>;
+    /** Ответить на callback-запрос */
+    answerCallback(callbackId: string, data?: {
+        message?: NewMessageBody;
+        notification?: string;
+    }): Promise<void>;
+}
+/**
+ * Интерфейс API подписок
+ */
+export interface ISubscriptionsApi {
+    /** Получить информацию о текущей подписке */
+    getSubscriptions(): Promise<SubscriptionInfo>;
+    /** Подписаться на обновления (установить webhook) */
+    subscribe(request: SubscribeRequest): Promise<void>;
+    /** Отписаться от обновлений (удалить webhook) */
+    unsubscribe(): Promise<void>;
+    /** Получить обновления (long polling) */
+    getUpdates(params?: GetUpdatesParams, signal?: AbortSignal): Promise<UpdatesResponse>;
+}
+/**
+ * Интерфейс API загрузки файлов
+ */
+export interface IUploadsApi {
+    /** Получить URL для загрузки файла */
+    getUploadUrl(type: UploadType): Promise<UploadUrlResponse>;
+    /** Загрузить файл */
+    uploadFile(uploadUrl: string, file: Blob, filename: string): Promise<UploadResponse>;
+    /**
+     * Resumable upload (без multipart/form-data).
+     * Подходит для больших файлов и позволяет загружать частями.
+     */
+    uploadFileResumable(uploadUrl: string, file: Blob, options?: {
+        chunkSize?: number;
+        contentType?: string;
+        onProgress?: (sentBytes: number, totalBytes: number) => void;
+        signal?: AbortSignal;
+    }): Promise<UploadResponse>;
+}
+//# sourceMappingURL=interfaces.d.ts.map

package/dist/types/api/interfaces.d.ts.map

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