@dementevdev/maxbot-ts 1.0.0

package/dist/types/transport/LongPollingTransport.d.ts

@@ -0,0 +1,33 @@
+import type { ISubscriptionsApi } from "../api/interfaces.js";
+import type { ErrorHandler, IUpdateTransport, LongPollingConfig, UpdateHandler } from "./interfaces.js";
+/**
+ * Транспорт на основе Long Polling.
+ *
+ * Long Polling проще в настройке — не нужен публичный IP и SSL.
+ * Подходит для разработки и небольших ботов.
+ */
+export declare class LongPollingTransport implements IUpdateTransport {
+    private readonly subscriptionsApi;
+    private readonly timeout;
+    private readonly limit;
+    private readonly retryDelay;
+    private readonly resetMarkerOnRestart;
+    private readonly allowedUpdates;
+    private isRunning;
+    private marker;
+    private updateHandler;
+    private errorHandler;
+    private abortController;
+    private pollPromise;
+    constructor(subscriptionsApi: ISubscriptionsApi, config?: LongPollingConfig);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    onUpdate(handler: UpdateHandler): void;
+    onError(handler: ErrorHandler): void;
+    private poll;
+    private isAbortError;
+    private emitUpdate;
+    private emitError;
+    private delay;
+}
+//# sourceMappingURL=LongPollingTransport.d.ts.map

package/dist/types/transport/LongPollingTransport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LongPollingTransport.d.ts","sourceRoot":"","sources":["../../../src/transport/LongPollingTransport.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAG9D,OAAO,KAAK,EACV,YAAY,EACZ,gBAAgB,EAChB,iBAAiB,EACjB,aAAa,EACd,MAAM,iBAAiB,CAAC;AAEzB;;;;;GAKG;AACH,qBAAa,oBAAqB,YAAW,gBAAgB;IAmBzD,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IAlBnC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAU;IAC/C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA2B;IAE1D,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,aAAa,CAA8B;IACnD,OAAO,CAAC,YAAY,CAA6B;IAIjD,OAAO,CAAC,eAAe,CAAgC;IAEvD,OAAO,CAAC,WAAW,CAA8B;gBAG9B,gBAAgB,EAAE,iBAAiB,EACpD,MAAM,CAAC,EAAE,iBAAiB;IAStB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAgBtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAmB3B,QAAQ,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI;IAItC,OAAO,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI;YAItB,IAAI;IAyDlB,OAAO,CAAC,YAAY;IAOpB,OAAO,CAAC,UAAU;IAalB,OAAO,CAAC,SAAS;IAYjB,OAAO,CAAC,KAAK;CAkBd"}

package/dist/types/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/types/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/types/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/types/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/types/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/types/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/types/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/types/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/types/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/types/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/types/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/types/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/types/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/types/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/types/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/types/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/types/types/message.d.ts

@@ -0,0 +1,162 @@
+import type { User } from "./common.js";
+import type { Recipient } from "./chat.js";
+import type { InlineKeyboardAttachment as KeyboardInlineKeyboardAttachment } from "./keyboard.js";
+/**
+ * Тип вложения
+ */
+export type AttachmentType = "image" | "video" | "audio" | "file" | "contact" | "sticker" | "inline_keyboard" | "location";
+/**
+ * Тип разметки текста
+ */
+export type MarkupType = "strong" | "emphasized" | "underlined" | "strikethrough" | "link" | "mention";
+/**
+ * Формат текста сообщения
+ */
+export type MessageFormat = "markdown" | "html";
+/**
+ * Тип связи с другим сообщением
+ */
+export type LinkType = "forward" | "reply";
+/**
+ * Вложение сообщения
+ */
+export interface ImageAttachment {
+    type: "image";
+    payload: {
+        url?: string | null;
+        token?: string | null;
+        photos?: Record<string, unknown> | null;
+    };
+}
+export interface VideoAttachment {
+    type: "video";
+    payload: {
+        token?: string;
+    } & Record<string, unknown>;
+}
+export interface AudioAttachment {
+    type: "audio";
+    payload: {
+        token?: string;
+    } & Record<string, unknown>;
+}
+export interface FileAttachment {
+    type: "file";
+    payload: {
+        token?: string;
+    } & Record<string, unknown>;
+}
+export interface StickerAttachment {
+    type: "sticker";
+    payload: {
+        code: string;
+    };
+}
+export interface ContactAttachment {
+    type: "contact";
+    payload: {
+        name?: string | null;
+        contact_id?: number | null;
+        vcf_info?: string | null;
+        vcf_phone?: string | null;
+        max_info?: User | null;
+    };
+}
+export interface LocationAttachment {
+    type: "location";
+    latitude: number;
+    longitude: number;
+    /** Входящее вложение может не содержать payload */
+    payload?: Record<string, unknown> | null;
+}
+export type Attachment = ImageAttachment | VideoAttachment | AudioAttachment | FileAttachment | StickerAttachment | ContactAttachment | KeyboardInlineKeyboardAttachment | LocationAttachment;
+/**
+ * Разметка текста
+ */
+export interface Markup {
+    type: MarkupType;
+    from: number;
+    length: number;
+}
+/**
+ * Статистика сообщения
+ */
+export interface MessageStat {
+    views: number | null;
+}
+/**
+ * Тело сообщения
+ */
+export interface MessageBody {
+    mid: string;
+    seq: number;
+    text?: string;
+    attachments: Attachment[] | null;
+    markup: Markup[] | null;
+}
+/**
+ * Связанное сообщение (пересланное или цитируемое)
+ */
+export interface LinkedMessage {
+    type: LinkType;
+    sender?: User;
+    chat_id?: number;
+    message: MessageBody;
+}
+/**
+ * Сообщение
+ */
+export interface Message {
+    sender?: User;
+    recipient: Recipient;
+    /** Unix-время создания */
+    timestamp: number;
+    /** Пересланное или ответное сообщение */
+    link?: LinkedMessage | null;
+    /** Содержимое сообщения. Текст + вложения. Может быть null, если сообщение содержит только пересланное сообщение */
+    body?: MessageBody | null;
+    /** Статистика сообщения */
+    stat?: MessageStat | null;
+    /** Публичная ссылка на пост в канале */
+    url?: string | null;
+}
+/**
+ * Ссылка на сообщение для ответа/пересылки
+ */
+export interface NewMessageLink {
+    type: LinkType;
+    mid: string;
+}
+/**
+ * Тело нового сообщения
+ */
+export interface NewMessageBody {
+    text?: string | null;
+    attachments?: Attachment[] | null;
+    link?: NewMessageLink | null;
+    /** Уведомлять ли участников */
+    notify?: boolean;
+    /** Формат текста */
+    format?: MessageFormat | null;
+}
+/**
+ * Параметры отправки сообщения
+ */
+export interface SendMessageParams {
+    user_id?: number;
+    chat_id?: number;
+    disable_link_preview?: boolean;
+}
+/**
+ * Ответ на отправку сообщения
+ */
+export interface SendMessageResponse {
+    message: Message;
+}
+/**
+ * Ответ со списком сообщений
+ */
+export interface MessagesResponse {
+    messages: Message[];
+}
+//# sourceMappingURL=message.d.ts.map

package/dist/types/types/message.d.ts.map

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

package/dist/types/types/subscription.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Информация о подписке (webhook)
+ */
+export interface SubscriptionInfo {
+    url: string | null;
+    /** Unix-время создания */
+    time: number | null;
+    /** Типы обновлений, на которые подписан бот */
+    update_types: string[] | null;
+    /** Версия API */
+    version: string | null;
+}
+/**
+ * Запрос на создание подписки
+ */
+export interface SubscribeRequest {
+    url: string;
+    /** Типы обновлений для подписки */
+    update_types?: string[];
+    /** Версия API */
+    version?: string;
+}
+//# sourceMappingURL=subscription.d.ts.map

package/dist/types/types/subscription.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscription.d.ts","sourceRoot":"","sources":["../../../src/types/subscription.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,0BAA0B;IAC1B,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,+CAA+C;IAC/C,YAAY,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAC9B,iBAAiB;IACjB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,mCAAmC;IACnC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,iBAAiB;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB"}