@dementevdev/maxbot-ts 1.0.0

package/dist/cjs/transport/LongPollingTransport.js

@@ -0,0 +1,153 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LongPollingTransport = void 0;
+const index_js_1 = require("../core/errors/index.js");
+/**
+ * Транспорт на основе Long Polling.
+ *
+ * Long Polling проще в настройке — не нужен публичный IP и SSL.
+ * Подходит для разработки и небольших ботов.
+ */
+class LongPollingTransport {
+    subscriptionsApi;
+    timeout;
+    limit;
+    retryDelay;
+    resetMarkerOnRestart;
+    allowedUpdates;
+    isRunning = false;
+    marker = null;
+    updateHandler = null;
+    errorHandler = null;
+    // AbortController живёт на протяжении одного сеанса polling —
+    // позволяет мгновенно прервать текущий fetch-запрос при вызове stop()
+    abortController = null;
+    // Храним Promise от poll() чтобы stop() мог дождаться чистого завершения цикла
+    pollPromise = null;
+    constructor(subscriptionsApi, config) {
+        this.subscriptionsApi = subscriptionsApi;
+        this.timeout = config?.timeout ?? 25;
+        this.limit = config?.limit ?? 100;
+        this.retryDelay = config?.retryDelay ?? 5000;
+        this.resetMarkerOnRestart = config?.resetMarkerOnRestart ?? false;
+        this.allowedUpdates = config?.allowedUpdates;
+    }
+    async start() {
+        // Отписка от webhook перед стартом polling —
+        // MAX API не позволяет использовать оба метода одновременно
+        try {
+            await this.subscriptionsApi.unsubscribe();
+        }
+        catch {
+            // Игнорируем ошибку — webhook мог быть не установлен
+        }
+        this.isRunning = true;
+        this.abortController = new AbortController();
+        // Запуск в отдельном "потоке" — не блокируем возврат из start()
+        this.pollPromise = this.poll();
+    }
+    async stop() {
+        this.isRunning = false;
+        // Прерываем текущий getUpdates или delay немедленно —
+        // без этого пришлось бы ждать до 25 секунд завершения long-poll запроса
+        this.abortController?.abort();
+        this.abortController = null;
+        // Дожидаемся завершения poll() — гарантируем чистую остановку
+        await this.pollPromise;
+        this.pollPromise = null;
+        // Сбрасываем маркер если настройка включена —
+        // следующий start() стартует с самых свежих обновлений
+        if (this.resetMarkerOnRestart) {
+            this.marker = null;
+        }
+    }
+    onUpdate(handler) {
+        this.updateHandler = handler;
+    }
+    onError(handler) {
+        this.errorHandler = handler;
+    }
+    async poll() {
+        while (this.isRunning) {
+            try {
+                const response = await this.subscriptionsApi.getUpdates({
+                    timeout: this.timeout,
+                    limit: this.limit,
+                    marker: this.marker ?? undefined,
+                    update_types: this.allowedUpdates,
+                }, this.abortController?.signal);
+                // Marker сохраняется между запросами —
+                // без него API вернёт те же обновления повторно
+                if (response.marker !== null) {
+                    this.marker = response.marker;
+                }
+                for (const update of response.updates) {
+                    // Fire-and-forget: один зависший обработчик не блокирует остальные.
+                    // Ошибки в обработчике логируются, но не останавливают polling.
+                    this.emitUpdate(update);
+                }
+            }
+            catch (error) {
+                // AbortError означает намеренную остановку через stop() — не ошибка
+                if (this.isAbortError(error)) {
+                    break;
+                }
+                // API вернул 400/404 — маркер устарел или невалиден.
+                // Сбрасываем маркер и сразу повторяем запрос без паузы —
+                // бот продолжит работу автономно даже после долгой остановки.
+                if (error instanceof index_js_1.ApiError &&
+                    (error.statusCode === 400 || error.statusCode === 404)) {
+                    this.marker = null;
+                    this.emitError(new Error(`Маркер устарел или невалиден (HTTP ${error.statusCode}), сброс позиции`));
+                    continue;
+                }
+                this.emitError(error instanceof Error ? error : new Error(String(error)));
+                // Пауза перед retry — защита от спама сервера при ошибках сети.
+                // delay тоже прерывается по сигналу, чтобы stop() не ждал retryDelay.
+                await this.delay(this.retryDelay, this.abortController?.signal);
+            }
+        }
+    }
+    isAbortError(error) {
+        return (error instanceof Error &&
+            (error.name === "AbortError" || error.name === "TimeoutError"));
+    }
+    emitUpdate(update) {
+        if (this.updateHandler) {
+            try {
+                this.updateHandler(update);
+            }
+            catch (error) {
+                // Ошибки в обработчике не должны ломать polling
+                this.emitError(error instanceof Error ? error : new Error(String(error)));
+            }
+        }
+    }
+    emitError(error) {
+        if (this.errorHandler) {
+            try {
+                this.errorHandler(error);
+            }
+            catch {
+                // Игнорируем ошибки в обработчике ошибок
+            }
+        }
+    }
+    // delay с поддержкой AbortSignal — stop() прерывает ожидание мгновенно,
+    // а не ждёт истечения retryDelay (до 5 секунд)
+    delay(ms, signal) {
+        return new Promise((resolve) => {
+            if (signal?.aborted) {
+                resolve();
+                return;
+            }
+            const tid = setTimeout(resolve, ms);
+            signal?.addEventListener("abort", () => {
+                clearTimeout(tid);
+                resolve();
+            }, { once: true });
+        });
+    }
+}
+exports.LongPollingTransport = LongPollingTransport;
+//# sourceMappingURL=LongPollingTransport.js.map

package/dist/cjs/transport/WebhookTransport.d.ts

@@ -0,0 +1,40 @@
+import { type IncomingMessage, type ServerResponse } from "node:http";
+import type { ISubscriptionsApi } from "../api/interfaces.js";
+import type { ErrorHandler, IUpdateTransport, UpdateHandler, WebhookConfig } from "./interfaces.js";
+/**
+ * Транспорт на основе Webhook.
+ *
+ * Webhook эффективнее для production — MAX сам присылает обновления.
+ * Требует публичный HTTPS endpoint.
+ */
+export declare class WebhookTransport implements IUpdateTransport {
+    private readonly subscriptionsApi;
+    private readonly path;
+    private readonly port;
+    private readonly host;
+    private readonly secretToken;
+    private readonly webhookUrl;
+    private readonly autoRegister;
+    private server;
+    private startPromise;
+    private updateHandler;
+    private errorHandler;
+    constructor(subscriptionsApi: ISubscriptionsApi, config?: WebhookConfig);
+    start(): Promise<void>;
+    private _doStart;
+    stop(): Promise<void>;
+    onUpdate(handler: UpdateHandler): void;
+    onError(handler: ErrorHandler): void;
+    /**
+     * Получить middleware для интеграции с Express/Fastify/Koa.
+     *
+     * Позволяет встроить webhook в существующий сервер разработчика.
+     */
+    getMiddleware(): (req: IncomingMessage, res: ServerResponse, next?: () => void) => void;
+    private handleRequest;
+    private verifyToken;
+    private parseBody;
+    private emitUpdate;
+    private emitError;
+}
+//# sourceMappingURL=WebhookTransport.d.ts.map

package/dist/cjs/transport/WebhookTransport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WebhookTransport.d.ts","sourceRoot":"","sources":["../../../src/transport/WebhookTransport.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,eAAe,EAEpB,KAAK,cAAc,EACpB,MAAM,WAAW,CAAC;AAEnB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAE9D,OAAO,KAAK,EACV,YAAY,EACZ,gBAAgB,EAChB,aAAa,EACb,aAAa,EACd,MAAM,iBAAiB,CAAC;AAKzB;;;;;GAKG;AACH,qBAAa,gBAAiB,YAAW,gBAAgB;IAgBrD,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IAfnC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAgB;IAC5C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAgB;IAC3C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAU;IAEvC,OAAO,CAAC,MAAM,CAAuB;IAGrC,OAAO,CAAC,YAAY,CAA8B;IAClD,OAAO,CAAC,aAAa,CAA8B;IACnD,OAAO,CAAC,YAAY,CAA6B;gBAG9B,gBAAgB,EAAE,iBAAiB,EACpD,MAAM,CAAC,EAAE,aAAa;IAUlB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YAWd,QAAQ;IAmBhB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAkD3B,QAAQ,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI;IAItC,OAAO,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI;IAIpC;;;;OAIG;IACH,aAAa,IAAI,CACf,GAAG,EAAE,eAAe,EACpB,GAAG,EAAE,cAAc,EACnB,IAAI,CAAC,EAAE,MAAM,IAAI,KACd,IAAI;IAeT,OAAO,CAAC,aAAa;IAiDrB,OAAO,CAAC,WAAW;IAYnB,OAAO,CAAC,SAAS;IAgCjB,OAAO,CAAC,UAAU;IAYlB,OAAO,CAAC,SAAS;CASlB"}

package/dist/cjs/transport/WebhookTransport.js

@@ -0,0 +1,229 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WebhookTransport = void 0;
+const node_http_1 = require("node:http");
+const node_crypto_1 = require("node:crypto");
+// Максимальный размер тела запроса — защита от переполнения памяти
+const MAX_BODY_SIZE = 1024 * 1024; // 1 MB
+/**
+ * Транспорт на основе Webhook.
+ *
+ * Webhook эффективнее для production — MAX сам присылает обновления.
+ * Требует публичный HTTPS endpoint.
+ */
+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 = (0, node_http_1.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 (0, node_crypto_1.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 {
+                // Игнорируем ошибки в обработчике ошибок
+            }
+        }
+    }
+}
+exports.WebhookTransport = WebhookTransport;
+//# sourceMappingURL=WebhookTransport.js.map

package/dist/cjs/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/cjs/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/cjs/transport/index.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WebhookTransport = exports.LongPollingTransport = void 0;
+var LongPollingTransport_js_1 = require("./LongPollingTransport.js");
+Object.defineProperty(exports, "LongPollingTransport", { enumerable: true, get: function () { return LongPollingTransport_js_1.LongPollingTransport; } });
+var WebhookTransport_js_1 = require("./WebhookTransport.js");
+Object.defineProperty(exports, "WebhookTransport", { enumerable: true, get: function () { return WebhookTransport_js_1.WebhookTransport; } });
+//# sourceMappingURL=index.js.map

package/dist/cjs/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/cjs/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/cjs/transport/interfaces.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=interfaces.js.map

package/dist/cjs/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/cjs/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/cjs/types/bot.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=bot.js.map

package/dist/cjs/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/cjs/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/cjs/types/chat.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=chat.js.map