@dementevdev/maxbot-ts 1.0.0

package/dist/cjs/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/cjs/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/cjs/api/BotsApi.js

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

package/dist/cjs/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/cjs/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/cjs/api/ChatsApi.js

@@ -0,0 +1,144 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ChatsApi = void 0;
+/**
+ * API для работы с чатами.
+ */
+class ChatsApi {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    /**
+     * Получить список чатов, в которых участвует бот.
+     */
+    async getChats(params) {
+        return this.http.get("/chats", {
+            params: {
+                count: params?.count,
+                marker: params?.marker,
+            },
+        });
+    }
+    /**
+     * Получить информацию о чате по ID.
+     */
+    async getChat(chatId) {
+        return this.http.get(`/chats/${chatId}`);
+    }
+    /**
+     * Получить информацию о чате по ссылке.
+     */
+    async getChatByLink(chatLink) {
+        return this.http.get(`/chats/${encodeURIComponent(chatLink)}`);
+    }
+    /**
+     * Обновить информацию о чате.
+     */
+    async updateChat(chatId, data) {
+        return this.http.patch(`/chats/${chatId}`, {
+            body: data,
+        });
+    }
+    /**
+     * Удалить чат.
+     */
+    async deleteChat(chatId) {
+        await this.http.delete(`/chats/${chatId}`);
+    }
+    /**
+     * Отправить действие в чат (например, "печатает...").
+     *
+     * Показывает пользователям, что бот обрабатывает запрос.
+     */
+    async sendAction(chatId, action) {
+        await this.http.post(`/chats/${chatId}/actions`, {
+            body: { action },
+        });
+    }
+    /**
+     * Получить закреплённое сообщение.
+     */
+    async getPinnedMessage(chatId) {
+        try {
+            return await this.http.get(`/chats/${chatId}/pin`);
+        }
+        catch (error) {
+            // 404 означает отсутствие закреплённого сообщения — это нормальная ситуация
+            if (error instanceof Error &&
+                "code" in error &&
+                error.code === "NOT_FOUND") {
+                return null;
+            }
+            throw error;
+        }
+    }
+    /**
+     * Закрепить сообщение в чате.
+     */
+    async pinMessage(chatId, messageId) {
+        await this.http.put(`/chats/${chatId}/pin`, {
+            body: { message_id: messageId },
+        });
+    }
+    /**
+     * Открепить сообщение в чате.
+     */
+    async unpinMessage(chatId) {
+        await this.http.delete(`/chats/${chatId}/pin`);
+    }
+    /**
+     * Получить информацию о членстве бота в чате.
+     */
+    async getBotMembership(chatId) {
+        return this.http.get(`/chats/${chatId}/members/me`);
+    }
+    /**
+     * Покинуть чат.
+     */
+    async leaveChat(chatId) {
+        await this.http.delete(`/chats/${chatId}/members/me`);
+    }
+    /**
+     * Получить участников чата.
+     */
+    async getMembers(chatId) {
+        return this.http.get(`/chats/${chatId}/members`);
+    }
+    /**
+     * Добавить участников в чат.
+     */
+    async addMembers(chatId, userIds) {
+        await this.http.post(`/chats/${chatId}/members`, {
+            body: { user_ids: userIds },
+        });
+    }
+    /**
+     * Удалить участника из чата.
+     */
+    async removeMember(chatId, userId) {
+        await this.http.delete(`/chats/${chatId}/members/${userId}`);
+    }
+    /**
+     * Получить администраторов чата.
+     */
+    async getAdmins(chatId) {
+        return this.http.get(`/chats/${chatId}/members/admins`);
+    }
+    /**
+     * Добавить администратора в чат.
+     */
+    async addAdmin(chatId, userId) {
+        await this.http.post(`/chats/${chatId}/members/admins`, {
+            body: { user_id: userId },
+        });
+    }
+    /**
+     * Удалить администратора из чата.
+     */
+    async removeAdmin(chatId, userId) {
+        await this.http.delete(`/chats/${chatId}/members/admins/${userId}`);
+    }
+}
+exports.ChatsApi = ChatsApi;
+//# sourceMappingURL=ChatsApi.js.map

package/dist/cjs/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/cjs/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/cjs/api/MessagesApi.js

@@ -0,0 +1,66 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MessagesApi = void 0;
+/**
+ * API для работы с сообщениями.
+ */
+class MessagesApi {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    /**
+     * Получить сообщение по ID.
+     */
+    async getMessage(messageId) {
+        return this.http.get(`/messages/${encodeURIComponent(messageId)}`);
+    }
+    /**
+     * Отправить сообщение.
+     *
+     * @param params - Параметры отправки (user_id или chat_id)
+     * @param body - Тело сообщения (текст, вложения)
+     */
+    async sendMessage(params, body) {
+        return this.http.post("/messages", {
+            params: {
+                user_id: params.user_id,
+                chat_id: params.chat_id,
+                disable_link_preview: params.disable_link_preview,
+            },
+            body,
+        });
+    }
+    /**
+     * Редактировать сообщение.
+     */
+    async editMessage(messageId, body) {
+        await this.http.put("/messages", {
+            params: { message_id: messageId },
+            body,
+        });
+    }
+    /**
+     * Удалить сообщение.
+     */
+    async deleteMessage(messageId) {
+        await this.http.delete("/messages", {
+            params: { message_id: messageId },
+        });
+    }
+    /**
+     * Ответить на callback-запрос.
+     *
+     * Вызывается для закрытия "часиков" на кнопке и опционально показа уведомления.
+     * MAX API требует хотя бы одно из полей `message` или `notification`;
+     * при вызове без аргументов автоматически передаётся `notification: ""`.
+     */
+    async answerCallback(callbackId, data) {
+        await this.http.post("/answers", {
+            params: { callback_id: callbackId },
+            body: data ?? { notification: "" },
+        });
+    }
+}
+exports.MessagesApi = MessagesApi;
+//# sourceMappingURL=MessagesApi.js.map

package/dist/cjs/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/cjs/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/cjs/api/SubscriptionsApi.js

@@ -0,0 +1,69 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SubscriptionsApi = void 0;
+/**
+ * API для работы с подписками на обновления.
+ *
+ * Поддерживает два режима получения обновлений:
+ * - Webhook: MAX сам отправляет обновления на указанный URL
+ * - Long Polling: бот периодически запрашивает обновления
+ */
+class SubscriptionsApi {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    /**
+     * Получить информацию о текущей подписке.
+     *
+     * Позволяет проверить, настроен ли webhook.
+     */
+    async getSubscriptions() {
+        return this.http.get("/subscriptions");
+    }
+    /**
+     * Подписаться на обновления (установить webhook).
+     *
+     * URL должен быть HTTPS — требование API для безопасности.
+     */
+    async subscribe(request) {
+        await this.http.post("/subscriptions", {
+            body: request,
+        });
+    }
+    /**
+     * Отписаться от обновлений (удалить webhook).
+     *
+     * После удаления webhook можно использовать long polling.
+     */
+    async unsubscribe() {
+        await this.http.delete("/subscriptions");
+    }
+    /**
+     * Получить обновления (long polling).
+     *
+     * Запрос блокируется на сервере до появления обновлений или истечения таймаута.
+     * Это более эффективно, чем постоянные короткие запросы.
+     *
+     * @param params.timeout - Время ожидания в секундах (по умолчанию 30)
+     * @param params.limit - Максимальное количество обновлений (по умолчанию 100)
+     * @param params.marker - Маркер для пагинации (получен из предыдущего ответа)
+     */
+    async getUpdates(params, signal) {
+        return this.http.get("/updates", {
+            params: {
+                timeout: params?.timeout,
+                limit: params?.limit,
+                marker: params?.marker,
+                // API принимает типы через запятую: "message_created,message_callback"
+                ...(params?.update_types?.length
+                    ? { update_types: params.update_types.join(",") }
+                    : undefined),
+            },
+            // signal пробрасывается из LongPollingTransport для отмены при вызове stop()
+            signal,
+        });
+    }
+}
+exports.SubscriptionsApi = SubscriptionsApi;
+//# sourceMappingURL=SubscriptionsApi.js.map

package/dist/cjs/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/cjs/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/cjs/api/UploadsApi.js

@@ -0,0 +1,113 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UploadsApi = void 0;
+/**
+ * API для загрузки файлов.
+ *
+ * Процесс загрузки двухэтапный:
+ * 1. Получить URL для загрузки через getUploadUrl
+ * 2. Загрузить файл на полученный URL через uploadFile
+ */
+class UploadsApi {
+    http;
+    token;
+    constructor(http, 
+    // Токен передаётся явно — UploadsApi делает fetch напрямую на внешний URL,
+    // минуя HttpClient, поэтому не может взять заголовок из него
+    token) {
+        this.http = http;
+        this.token = token;
+    }
+    /**
+     * Получить URL для загрузки файла.
+     *
+     * @param type - Тип файла (image, video, audio, file)
+     */
+    async getUploadUrl(type) {
+        return this.http.post("/uploads", {
+            params: { type },
+        });
+    }
+    /**
+     * Загрузить файл на полученный URL.
+     *
+     * Используется multipart/form-data для передачи файла.
+     * Этот метод не проходит через rate limiter, так как загрузка
+     * идёт на отдельный сервер.
+     *
+     * Ограничения multipart upload:
+     * - Максимальный размер файла: 4 ГБ
+     * - Можно загружать только один файл за раз
+     */
+    async uploadFile(uploadUrl, file, filename) {
+        const formData = new FormData();
+        formData.append("data", file, filename);
+        // Загрузка идёт на внешний URL, поэтому используем fetch напрямую
+        const response = await fetch(uploadUrl, {
+            method: "POST",
+            headers: {
+                Authorization: this.token,
+            },
+            body: formData,
+        });
+        if (!response.ok) {
+            throw new Error(`Ошибка загрузки файла: ${response.status} ${response.statusText}`);
+        }
+        const text = await response.text();
+        if (!text) {
+            return {};
+        }
+        try {
+            return JSON.parse(text);
+        }
+        catch {
+            // Некоторые загрузочные серверы возвращают XML (например, <retval>1</retval>)
+            // В этом случае токен может быть уже выдан на шаге getUploadUrl
+            return {};
+        }
+    }
+    /**
+     * Resumable upload (без multipart/form-data).
+     *
+     * Загружает файл чанками с Content-Range.
+     */
+    async uploadFileResumable(uploadUrl, file, options) {
+        const chunkSize = options?.chunkSize ?? 8 * 1024 * 1024; // 8 MB
+        const total = file.size;
+        let uploaded = 0;
+        let lastResponseText = null;
+        while (uploaded < total) {
+            const end = Math.min(uploaded + chunkSize, total);
+            const chunk = file.slice(uploaded, end);
+            const response = await fetch(uploadUrl, {
+                method: "POST",
+                headers: {
+                    Authorization: this.token,
+                    "Content-Type": options?.contentType ?? "application/octet-stream",
+                    "Content-Range": `bytes ${uploaded}-${end - 1}/${total}`,
+                },
+                body: chunk,
+                signal: options?.signal,
+            });
+            if (!response.ok) {
+                throw new Error(`Ошибка загрузки файла: ${response.status} ${response.statusText}`);
+            }
+            lastResponseText = await response.text();
+            uploaded = end;
+            if (options?.onProgress) {
+                options.onProgress(uploaded, total);
+            }
+        }
+        if (!lastResponseText) {
+            return {};
+        }
+        try {
+            return JSON.parse(lastResponseText);
+        }
+        catch {
+            return {};
+        }
+    }
+}
+exports.UploadsApi = UploadsApi;
+//# sourceMappingURL=UploadsApi.js.map