@dementevdev/maxbot-ts 1.0.0

package/dist/esm/transport/WebhookTransport.js

@@ -0,0 +1,225 @@
+import { createServer, } from "node:http";
+import { timingSafeEqual } from "node:crypto";
+// Максимальный размер тела запроса — защита от переполнения памяти
+const MAX_BODY_SIZE = 1024 * 1024; // 1 MB
+/**
+ * Транспорт на основе Webhook.
+ *
+ * Webhook эффективнее для production — MAX сам присылает обновления.
+ * Требует публичный HTTPS endpoint.
+ */
+export class WebhookTransport {
+    subscriptionsApi;
+    path;
+    port;
+    host;
+    secretToken;
+    webhookUrl;
+    autoRegister;
+    server = null;
+    // startPromise — мьютекс жизненного цикла (аналог Bot.startPromise):
+    // не null пока сервер поднимается или работает, предотвращает двойной listen.
+    startPromise = null;
+    updateHandler = null;
+    errorHandler = null;
+    constructor(subscriptionsApi, config) {
+        this.subscriptionsApi = subscriptionsApi;
+        this.path = config?.path ?? "/webhook";
+        this.port = config?.port ?? 3000;
+        this.host = config?.host ?? "0.0.0.0";
+        this.secretToken = config?.secretToken ?? null;
+        this.webhookUrl = config?.url ?? null;
+        this.autoRegister = config?.autoRegister ?? false;
+    }
+    async start() {
+        if (this.startPromise !== null) {
+            await this.startPromise;
+            throw new Error("WebhookTransport уже запущен. Вызовите stop() перед повторным запуском.");
+        }
+        this.startPromise = this._doStart();
+        return this.startPromise;
+    }
+    async _doStart() {
+        // Автоматическая регистрация webhook URL если указан
+        if (this.autoRegister && this.webhookUrl) {
+            await this.subscriptionsApi.subscribe({ url: this.webhookUrl });
+        }
+        const server = createServer(this.handleRequest.bind(this));
+        await new Promise((resolve, reject) => {
+            server.once("error", (err) => {
+                this.startPromise = null; // сбрасываем мьютекс при ошибке
+                reject(err);
+            });
+            server.listen(this.port, this.host, () => resolve());
+        });
+        this.server = server;
+    }
+    async stop() {
+        if (this.startPromise === null) {
+            return; // уже остановлен — идемпотентно
+        }
+        // Держим mutex (startPromise) установленным на весь период остановки.
+        // Это закрывает race condition: параллельный start() увидит не-null promise
+        // и заблокируется до полного завершения stop(), а не до сброса null.
+        const stopTask = (async () => {
+            // Дожидаемся завершения старта перед остановкой
+            try {
+                await this.startPromise;
+            }
+            catch {
+                /* start упал — сервер не поднят */
+            }
+            // Отписка при остановке — только если autoRegister, только если сервер поднялся
+            if (this.autoRegister && this.server) {
+                try {
+                    await this.subscriptionsApi.unsubscribe();
+                }
+                catch {
+                    // Игнорируем ошибки при остановке
+                }
+            }
+            await new Promise((resolve) => {
+                if (this.server) {
+                    this.server.close(() => {
+                        this.server = null;
+                        resolve();
+                    });
+                }
+                else {
+                    resolve();
+                }
+            });
+        })();
+        // Заменяем mutex на stopTask — он не-null до полного завершения
+        this.startPromise = stopTask;
+        try {
+            await stopTask;
+        }
+        finally {
+            // Сбрасываем только если никто не перезаписал mutex между await-ами
+            if (this.startPromise === stopTask) {
+                this.startPromise = null;
+            }
+        }
+    }
+    onUpdate(handler) {
+        this.updateHandler = handler;
+    }
+    onError(handler) {
+        this.errorHandler = handler;
+    }
+    /**
+     * Получить middleware для интеграции с Express/Fastify/Koa.
+     *
+     * Позволяет встроить webhook в существующий сервер разработчика.
+     */
+    getMiddleware() {
+        return (req, res, next) => {
+            const url = new URL(req.url ?? "/", `http://${req.headers.host}`);
+            if (url.pathname === this.path && req.method === "POST") {
+                this.handleRequest(req, res);
+            }
+            else if (next) {
+                next();
+            }
+            else {
+                res.writeHead(404);
+                res.end();
+            }
+        };
+    }
+    handleRequest(req, res) {
+        const url = new URL(req.url ?? "/", `http://${req.headers.host}`);
+        // Проверяем path и метод
+        if (url.pathname !== this.path || req.method !== "POST") {
+            res.writeHead(404);
+            res.end();
+            return;
+        }
+        // Валидация секретного токена — защита от поддельных запросов
+        if (this.secretToken) {
+            const receivedToken = req.headers["x-secret-token"];
+            if (typeof receivedToken !== "string" ||
+                !this.verifyToken(receivedToken)) {
+                // Timing-safe сравнение защищает от timing attack —
+                // злоумышленник не сможет подобрать токен по времени ответа
+                res.writeHead(403);
+                res.end();
+                return;
+            }
+        }
+        // Проверка Content-Length — защита от переполнения памяти
+        const contentLength = parseInt(req.headers["content-length"] ?? "0", 10);
+        if (contentLength > MAX_BODY_SIZE) {
+            res.writeHead(413); // Payload Too Large
+            res.end();
+            return;
+        }
+        // Отвечаем 200 до обработки —
+        // MAX ждёт подтверждения и сделает retry при долгом ответе
+        res.writeHead(200);
+        res.end();
+        // Обработка асинхронно — не задерживаем ответ сервера
+        this.parseBody(req)
+            .then((update) => this.emitUpdate(update))
+            .catch((error) => this.emitError(error instanceof Error ? error : new Error(String(error))));
+    }
+    verifyToken(received) {
+        if (!this.secretToken)
+            return true;
+        const a = Buffer.from(received);
+        const b = Buffer.from(this.secretToken);
+        // Длины должны совпадать для timingSafeEqual
+        if (a.length !== b.length)
+            return false;
+        return timingSafeEqual(a, b);
+    }
+    parseBody(req) {
+        return new Promise((resolve, reject) => {
+            const chunks = [];
+            let size = 0;
+            req.on("data", (chunk) => {
+                size += chunk.length;
+                // Дополнительная проверка размера при потоковом чтении
+                if (size > MAX_BODY_SIZE) {
+                    req.destroy();
+                    reject(new Error("Превышен максимальный размер тела запроса"));
+                    return;
+                }
+                chunks.push(chunk);
+            });
+            req.on("end", () => {
+                try {
+                    const body = Buffer.concat(chunks).toString("utf-8");
+                    const update = JSON.parse(body);
+                    resolve(update);
+                }
+                catch {
+                    reject(new Error("Ошибка парсинга тела запроса"));
+                }
+            });
+            req.on("error", reject);
+        });
+    }
+    emitUpdate(update) {
+        if (this.updateHandler) {
+            try {
+                this.updateHandler(update);
+            }
+            catch (error) {
+                this.emitError(error instanceof Error ? error : new Error(String(error)));
+            }
+        }
+    }
+    emitError(error) {
+        if (this.errorHandler) {
+            try {
+                this.errorHandler(error);
+            }
+            catch {
+                // Игнорируем ошибки в обработчике ошибок
+            }
+        }
+    }
+}
+//# sourceMappingURL=WebhookTransport.js.map

package/dist/esm/transport/index.d.ts

@@ -0,0 +1,4 @@
+export { LongPollingTransport } from "./LongPollingTransport.js";
+export { WebhookTransport } from "./WebhookTransport.js";
+export type { IUpdateTransport, LongPollingConfig, WebhookConfig, UpdateHandler, ErrorHandler, } from "./interfaces.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/transport/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/transport/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD,YAAY,EACV,gBAAgB,EAChB,iBAAiB,EACjB,aAAa,EACb,aAAa,EACb,YAAY,GACb,MAAM,iBAAiB,CAAC"}

package/dist/esm/transport/index.js

@@ -0,0 +1,3 @@
+export { LongPollingTransport } from "./LongPollingTransport.js";
+export { WebhookTransport } from "./WebhookTransport.js";
+//# sourceMappingURL=index.js.map

package/dist/esm/transport/interfaces.d.ts

@@ -0,0 +1,74 @@
+import type { Update, UpdateType } from "../types/update.js";
+/**
+ * Обработчик обновлений
+ */
+export type UpdateHandler = (update: Update) => void;
+/**
+ * Обработчик ошибок
+ */
+export type ErrorHandler = (error: Error) => void;
+/**
+ * Конфигурация Long Polling
+ */
+export interface LongPollingConfig {
+    /** Таймаут ожидания обновлений в секундах (по умолчанию 25) */
+    timeout?: number;
+    /** Максимальное количество обновлений за запрос (по умолчанию 100) */
+    limit?: number;
+    /** Задержка перед повторной попыткой при ошибке в мс (по умолчанию 5000) */
+    retryDelay?: number;
+    /**
+     * Фильтр типов обновлений — бот получит только перечисленные типы.
+     * Если не указан — приходят все типы.
+     *
+     * @example Получать только сообщения и нажатия кнопок
+     * allowedUpdates: ['message_created', 'message_callback']
+     */
+    allowedUpdates?: UpdateType[];
+    /**
+     * Сбрасывать маркер при перезапуске (по умолчанию `false`).
+     *
+     * По умолчанию (значение `false`) бот продолжает с последнего запомненного
+     * маркера — обновления, пришедшие во время остановки, будут получены
+     * после старта. Установите `true` если хотите всегда начинать с самых
+     * актуальных обновлений без обработки пропущенных во время остановки.
+     *
+     * Внезависимо от этой настройки, маркер автоматически сбрасывается
+     * если API возвращает 400/404 (маркер устарел или невалиден).
+     */
+    resetMarkerOnRestart?: boolean;
+}
+/**
+ * Конфигурация Webhook
+ */
+export interface WebhookConfig {
+    /** URL path для вебхука (по умолчанию '/webhook') */
+    path?: string;
+    /** Порт сервера (по умолчанию 3000) */
+    port?: number;
+    /** Хост сервера (по умолчанию '0.0.0.0') */
+    host?: string;
+    /** Секретный токен для валидации запросов */
+    secretToken?: string;
+    /** Публичный URL для регистрации webhook */
+    url?: string;
+    /** Автоматически регистрировать webhook при старте */
+    autoRegister?: boolean;
+}
+/**
+ * Интерфейс транспорта для получения обновлений.
+ *
+ * Позволяет использовать разные стратегии (Long Polling / Webhook)
+ * с единым интерфейсом.
+ */
+export interface IUpdateTransport {
+    /** Запустить транспорт */
+    start(): Promise<void>;
+    /** Остановить транспорт */
+    stop(): Promise<void>;
+    /** Установить обработчик обновлений */
+    onUpdate(handler: UpdateHandler): void;
+    /** Установить обработчик ошибок */
+    onError(handler: ErrorHandler): void;
+}
+//# sourceMappingURL=interfaces.d.ts.map

package/dist/esm/transport/interfaces.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interfaces.d.ts","sourceRoot":"","sources":["../../../src/transport/interfaces.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAE7D;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;AAErD;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;AAElD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,+DAA+D;IAC/D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sEAAsE;IACtE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4EAA4E;IAC5E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;;;OAMG;IACH,cAAc,CAAC,EAAE,UAAU,EAAE,CAAC;IAC9B;;;;;;;;;;OAUG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,qDAAqD;IACrD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uCAAuC;IACvC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,4CAA4C;IAC5C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6CAA6C;IAC7C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4CAA4C;IAC5C,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,sDAAsD;IACtD,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,0BAA0B;IAC1B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,2BAA2B;IAC3B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,uCAAuC;IACvC,QAAQ,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,CAAC;IACvC,mCAAmC;IACnC,OAAO,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI,CAAC;CACtC"}

package/dist/esm/transport/interfaces.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=interfaces.js.map

package/dist/esm/types/bot.d.ts

@@ -0,0 +1,19 @@
+import type { User } from "./common.js";
+/**
+ * Команда бота
+ */
+export interface BotCommand {
+    command: string;
+    /** Описание команды — необязательное (в API не nullable, но может отсутствовать) */
+    description?: string | null;
+}
+/**
+ * Информация о боте
+ */
+export interface BotInfo extends User {
+    description: string | null;
+    avatar_url: string | null;
+    full_avatar_url: string | null;
+    commands: BotCommand[] | null;
+}
+//# sourceMappingURL=bot.d.ts.map

package/dist/esm/types/bot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bot.d.ts","sourceRoot":"","sources":["../../../src/types/bot.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAExC;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,oFAAoF;IACpF,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,OAAQ,SAAQ,IAAI;IACnC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,QAAQ,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC;CAC/B"}

package/dist/esm/types/bot.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=bot.js.map

package/dist/esm/types/chat.d.ts

@@ -0,0 +1,94 @@
+import type { Image, User, UserWithPhoto } from "./common.js";
+import type { Message } from "./message.js";
+/**
+ * Статус чата
+ */
+export type ChatStatus = "active" | "removed" | "left" | "closed";
+/**
+ * Тип чата
+ */
+export type ChatType = "chat" | "dialog";
+/**
+ * Групповой чат
+ */
+export interface Chat {
+    chat_id: number;
+    type: "chat";
+    status: ChatStatus;
+    title: string | null;
+    icon: Image | null;
+    /** Unix-время последнего события */
+    last_event_time: number;
+    participants_count: number;
+    owner_id: number | null;
+    /** Участники с временем последней активности */
+    participants: Record<string, number> | null;
+    is_public: boolean;
+    link: string | null;
+    description: string | null;
+    /** Собеседник в диалоге */
+    dialog_with_user?: UserWithPhoto;
+    /** ID сообщения с кнопкой, через которую был инициирован чат */
+    chat_message_id: string | null;
+    pinned_message?: Message | null;
+}
+/**
+ * Участник чата
+ */
+export interface ChatMember extends User {
+    permissions: string[] | null;
+}
+/**
+ * Получатель сообщения
+ */
+export interface Recipient {
+    chat_id: number | null;
+    chat_type: ChatType;
+    user_id: number | null;
+}
+/**
+ * Параметры получения списка чатов
+ */
+export interface GetChatsParams {
+    count?: number;
+    marker?: number;
+}
+/**
+ * Ответ со списком чатов
+ */
+export interface ChatsResponse {
+    chats: Chat[];
+    marker: number | null;
+}
+/**
+ * Запрос на обновление чата
+ */
+export interface UpdateChatRequest {
+    title?: string | null;
+    description?: string | null;
+}
+/**
+ * Запрос на добавление участников
+ */
+export interface AddMembersRequest {
+    user_ids: number[];
+}
+/**
+ * Запрос на добавление администратора
+ */
+export interface AddAdminRequest {
+    user_id: number;
+}
+/**
+ * Запрос на отправку действия в чат
+ */
+export interface SendActionRequest {
+    action: string;
+}
+/**
+ * Запрос на закрепление сообщения
+ */
+export interface PinMessageRequest {
+    message_id: string;
+}
+//# sourceMappingURL=chat.d.ts.map

package/dist/esm/types/chat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat.d.ts","sourceRoot":"","sources":["../../../src/types/chat.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAE5C;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,QAAQ,CAAC;AAElE;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,QAAQ,CAAC;AAEzC;;GAEG;AACH,MAAM,WAAW,IAAI;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,UAAU,CAAC;IACnB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,IAAI,EAAE,KAAK,GAAG,IAAI,CAAC;IACnB,oCAAoC;IACpC,eAAe,EAAE,MAAM,CAAC;IACxB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,gDAAgD;IAChD,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;IAC5C,SAAS,EAAE,OAAO,CAAC;IACnB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,2BAA2B;IAC3B,gBAAgB,CAAC,EAAE,aAAa,CAAC;IACjC,gEAAgE;IAChE,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,cAAc,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,UAAW,SAAQ,IAAI;IACtC,WAAW,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,SAAS,EAAE,QAAQ,CAAC;IACpB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC;CACpB"}

package/dist/esm/types/chat.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=chat.js.map

package/dist/esm/types/common.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Базовые типы, используемые во всём SDK
+ */
+/**
+ * Пользователь MAX
+ */
+export interface User {
+    user_id: number;
+    first_name: string;
+    last_name: string | null;
+    /** @deprecated Устаревшее поле, используйте first_name + last_name */
+    name?: string | null;
+    username: string | null;
+    is_bot: boolean;
+    /** Unix-время в миллисекундах */
+    last_activity_time: number;
+}
+/**
+ * Пользователь с аватаром
+ */
+export interface UserWithPhoto extends User {
+    avatar_url: string | null;
+    full_avatar_url: string | null;
+}
+/**
+ * Изображение (аватар, иконка)
+ */
+export interface Image {
+    url: string;
+}
+/**
+ * Ответ API с ошибкой
+ */
+export interface ApiErrorResponse {
+    code: string;
+    message: string;
+}
+//# sourceMappingURL=common.d.ts.map

package/dist/esm/types/common.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../../src/types/common.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,WAAW,IAAI;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,sEAAsE;IACtE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,EAAE,OAAO,CAAC;IAChB,iCAAiC;IACjC,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,aAAc,SAAQ,IAAI;IACzC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,KAAK;IACpB,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB"}

package/dist/esm/types/common.js

@@ -0,0 +1,5 @@
+/**
+ * Базовые типы, используемые во всём SDK
+ */
+export {};
+//# sourceMappingURL=common.js.map

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

@@ -0,0 +1,9 @@
+export * from "./common.js";
+export * from "./bot.js";
+export * from "./chat.js";
+export * from "./message.js";
+export * from "./update.js";
+export * from "./subscription.js";
+export * from "./keyboard.js";
+export * from "./upload.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":"AACA,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC"}

package/dist/esm/types/index.js

@@ -0,0 +1,10 @@
+// Реэкспорт всех типов для удобного импорта
+export * from "./common.js";
+export * from "./bot.js";
+export * from "./chat.js";
+export * from "./message.js";
+export * from "./update.js";
+export * from "./subscription.js";
+export * from "./keyboard.js";
+export * from "./upload.js";
+//# sourceMappingURL=index.js.map

package/dist/esm/types/keyboard.d.ts

@@ -0,0 +1,97 @@
+/**
+ * Намерение кнопки (цвет)
+ */
+export type ButtonIntent = "default" | "positive" | "negative";
+/** Кнопка с callback-данными */
+export interface CallbackButton {
+    type: "callback";
+    /** Видимый текст кнопки (1-128 символов) */
+    text: string;
+    /** Данные callback (до 1024 символов) */
+    payload: string;
+    intent?: ButtonIntent;
+}
+/** Кнопка-ссылка */
+export interface LinkButton {
+    type: "link";
+    text: string;
+    /** URL (до 2048 символов) */
+    url: string;
+    intent?: ButtonIntent;
+}
+/** Запрос контакта */
+export interface RequestContactButton {
+    type: "request_contact";
+    text: string;
+    intent?: ButtonIntent;
+}
+/** Запрос геолокации */
+export interface RequestGeoLocationButton {
+    type: "request_geo_location";
+    text: string;
+    /** Отправить геолокацию без подтверждения */
+    quick?: boolean;
+    intent?: ButtonIntent;
+}
+/** Открыть мини-приложение */
+export interface OpenAppButton {
+    type: "open_app";
+    text: string;
+    web_app?: string;
+    contact_id?: number;
+    payload?: string;
+    intent?: ButtonIntent;
+}
+/** Отправить текстовое сообщение от пользователя */
+export interface MessageButton {
+    type: "message";
+    text: string;
+    intent?: ButtonIntent;
+}
+/**
+ * Кнопка создания нового чата с ботом.
+ * При нажатии открывается диалог создания чата с заданным заголовком.
+ */
+export interface ChatButton {
+    type: "chat";
+    text: string;
+    /** Название создаваемого чата */
+    chat_title: string;
+    /** Описание чата (опционально) */
+    chat_description?: string | null;
+    /** Payload, который будет передан боту при старте чата через bot_started */
+    start_payload?: string | null;
+    /** UUID для дедупликации — позволяет избежать создания дублирующих чатов */
+    uuid?: string | null;
+}
+/**
+ * Дискриминированный union кнопок — TypeScript проверяет обязательные поля для каждого типа.
+ * Например, payload обязателен только для callback, url только для link.
+ */
+export type Button = CallbackButton | LinkButton | RequestContactButton | RequestGeoLocationButton | OpenAppButton | MessageButton | ChatButton;
+/**
+ * Payload inline-клавиатуры
+ */
+export interface InlineKeyboardPayload {
+    buttons: Button[][];
+}
+/**
+ * Вложение inline-клавиатуры
+ */
+export interface InlineKeyboardAttachment {
+    type: "inline_keyboard";
+    payload: InlineKeyboardPayload;
+}
+/**
+ * Кнопка inline-клавиатуры для API (только callback, legacy-тип)
+ */
+export interface InlineKeyboardButton {
+    type: "callback";
+    /** Видимый текст кнопки (1-128 символов) */
+    text: string;
+    /** Токен кнопки (до 1024 символов) */
+    payload: string;
+    /** Намерение (по умолчанию "default") */
+    intent?: ButtonIntent;
+}
+//# sourceMappingURL=keyboard.d.ts.map

package/dist/esm/types/keyboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyboard.d.ts","sourceRoot":"","sources":["../../../src/types/keyboard.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,UAAU,GAAG,UAAU,CAAC;AAE/D,gCAAgC;AAChC,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,UAAU,CAAC;IACjB,4CAA4C;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,yCAAyC;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB;AAED,oBAAoB;AACpB,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,6BAA6B;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB;AAED,sBAAsB;AACtB,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,iBAAiB,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB;AAED,wBAAwB;AACxB,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,sBAAsB,CAAC;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,6CAA6C;IAC7C,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB;AAED,8BAA8B;AAC9B,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,UAAU,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB;AAED,oDAAoD;AACpD,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,SAAS,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB;AAED;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,iCAAiC;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,kCAAkC;IAClC,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,4EAA4E;IAC5E,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,4EAA4E;IAC5E,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED;;;GAGG;AACH,MAAM,MAAM,MAAM,GACd,cAAc,GACd,UAAU,GACV,oBAAoB,GACpB,wBAAwB,GACxB,aAAa,GACb,aAAa,GACb,UAAU,CAAC;AAEf;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,iBAAiB,CAAC;IACxB,OAAO,EAAE,qBAAqB,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,UAAU,CAAC;IACjB,4CAA4C;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,sCAAsC;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,yCAAyC;IACzC,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB"}

package/dist/esm/types/keyboard.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=keyboard.js.map