@dementevdev/maxbot-ts 1.0.0

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

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Базовые типы, используемые во всём SDK
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=common.js.map

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

@@ -0,0 +1,26 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+// Реэкспорт всех типов для удобного импорта
+__exportStar(require("./common.js"), exports);
+__exportStar(require("./bot.js"), exports);
+__exportStar(require("./chat.js"), exports);
+__exportStar(require("./message.js"), exports);
+__exportStar(require("./update.js"), exports);
+__exportStar(require("./subscription.js"), exports);
+__exportStar(require("./keyboard.js"), exports);
+__exportStar(require("./upload.js"), exports);
+//# sourceMappingURL=index.js.map

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

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

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

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

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

package/dist/cjs/types/subscription.js

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

package/dist/cjs/types/update.d.ts

@@ -0,0 +1,99 @@
+import type { Message } from "./message.js";
+import type { User } from "./common.js";
+/**
+ * Тип обновления
+ */
+export type UpdateType = "message_created" | "message_edited" | "message_removed" | "message_callback" | "bot_started" | "bot_added" | "bot_removed" | "user_added" | "user_removed" | "chat_title_changed";
+/**
+ * Базовые поля, присутствующие во всех обновлениях
+ */
+interface BaseUpdate {
+    update_type: UpdateType;
+    /** Unix-время события */
+    timestamp: number;
+}
+/**
+ * Обновление: новое сообщение или редактирование (message_created, message_edited, message_removed)
+ */
+export interface MessageUpdate extends BaseUpdate {
+    update_type: "message_created" | "message_edited" | "message_removed";
+    message: Message;
+    /** Локаль пользователя (IETF BCP 47). Доступна только в диалогах. */
+    user_locale?: string | null;
+}
+/**
+ * Обновление: нажатие на inline-кнопку (message_callback).
+ *
+ * message опционален — кнопка могла быть удалена к моменту callback.
+ */
+export interface CallbackUpdate extends BaseUpdate {
+    update_type: "message_callback";
+    callback: {
+        /** Идентификатор callback, передаётся в /answers */
+        callback_id: string;
+        /** Payload кнопки (поле payload в InlineKeyboardButton) */
+        payload?: string | null;
+        /** Пользователь, нажавший кнопку */
+        user: User;
+        /** Unix-время нажатия */
+        timestamp: number;
+    };
+    /** Сообщение с кнопкой — может отсутствовать, если было удалено */
+    message?: Message | null;
+    /** Локаль пользователя (IETF BCP 47) */
+    user_locale?: string | null;
+}
+/**
+ * Обновление: системные события чата
+ */
+export interface ChatUpdate extends BaseUpdate {
+    update_type: "bot_added" | "bot_removed" | "user_added" | "user_removed" | "chat_title_changed";
+    chat_id: number;
+    user: User;
+    is_channel?: boolean;
+}
+/**
+ * Обновление: пользователь нажал кнопку Start или перешёл по deep link.
+ *
+ * `payload` содержит значение параметра `start`, переданного в ссылке вида
+ * `https://max.ru/...?start=<payload>`. Используется для реферальных ссылок,
+ * onboarding-флоу и любых сценариев с deep linking.
+ */
+export interface BotStartedUpdate extends BaseUpdate {
+    update_type: "bot_started";
+    /** ID чата (диалога), в котором произошло событие */
+    chat_id: number;
+    /** Пользователь, нажавший Start */
+    user: User;
+    /** Payload из deep link. `null` если Start нажат без параметра. */
+    payload?: string | null;
+}
+/**
+ * Дискриминированный union всех типов обновлений
+ */
+export type Update = MessageUpdate | CallbackUpdate | ChatUpdate | BotStartedUpdate;
+/**
+ * Параметры получения обновлений
+ */
+export interface GetUpdatesParams {
+    limit?: number;
+    timeout?: number;
+    marker?: number;
+    /**
+     * Фильтр типов обновлений — бот получит только перечисленные типы.
+     * Если не указан — приходят все типы.
+     *
+     * @example Только сообщения и callback
+     * update_types: ['message_created', 'message_callback']
+     */
+    update_types?: UpdateType[];
+}
+/**
+ * Ответ с обновлениями
+ */
+export interface UpdatesResponse {
+    updates: Update[];
+    marker: number | null;
+}
+export {};
+//# sourceMappingURL=update.d.ts.map

package/dist/cjs/types/update.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../../src/types/update.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAExC;;GAEG;AACH,MAAM,MAAM,UAAU,GAClB,iBAAiB,GACjB,gBAAgB,GAChB,iBAAiB,GACjB,kBAAkB,GAClB,aAAa,GACb,WAAW,GACX,aAAa,GACb,YAAY,GACZ,cAAc,GACd,oBAAoB,CAAC;AAEzB;;GAEG;AACH,UAAU,UAAU;IAClB,WAAW,EAAE,UAAU,CAAC;IACxB,yBAAyB;IACzB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,aAAc,SAAQ,UAAU;IAC/C,WAAW,EAAE,iBAAiB,GAAG,gBAAgB,GAAG,iBAAiB,CAAC;IACtE,OAAO,EAAE,OAAO,CAAC;IACjB,qEAAqE;IACrE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED;;;;GAIG;AACH,MAAM,WAAW,cAAe,SAAQ,UAAU;IAChD,WAAW,EAAE,kBAAkB,CAAC;IAChC,QAAQ,EAAE;QACR,oDAAoD;QACpD,WAAW,EAAE,MAAM,CAAC;QACpB,2DAA2D;QAC3D,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACxB,oCAAoC;QACpC,IAAI,EAAE,IAAI,CAAC;QACX,yBAAyB;QACzB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,mEAAmE;IACnE,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IACzB,wCAAwC;IACxC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,UAAW,SAAQ,UAAU;IAC5C,WAAW,EACP,WAAW,GACX,aAAa,GACb,YAAY,GACZ,cAAc,GACd,oBAAoB,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,IAAI,CAAC;IACX,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,gBAAiB,SAAQ,UAAU;IAClD,WAAW,EAAE,aAAa,CAAC;IAC3B,qDAAqD;IACrD,OAAO,EAAE,MAAM,CAAC;IAChB,mCAAmC;IACnC,IAAI,EAAE,IAAI,CAAC;IACX,mEAAmE;IACnE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,MAAM,MAAM,GACd,aAAa,GACb,cAAc,GACd,UAAU,GACV,gBAAgB,CAAC;AAErB;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;;OAMG;IACH,YAAY,CAAC,EAAE,UAAU,EAAE,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB"}

package/dist/cjs/types/update.js

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

package/dist/cjs/types/upload.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Тип загружаемого файла
+ */
+export type UploadType = "image" | "video" | "audio" | "file";
+/**
+ * Информация о загруженном файле
+ */
+export interface UploadedFile {
+    /** Токен файла для использования в сообщениях */
+    token: string;
+}
+/**
+ * Payload вложения после загрузки (структура зависит от типа)
+ */
+export type UploadPayload = Record<string, unknown>;
+/**
+ * Ответ на загрузку файла
+ */
+export type UploadResponse = UploadPayload | Record<string, UploadPayload>;
+/**
+ * Ответ на получение URL для загрузки
+ */
+export interface UploadUrlResponse {
+    /** URL для загрузки */
+    url: string;
+    /** Токен для видео/аудио (если возвращается API) */
+    token?: string;
+}
+//# sourceMappingURL=upload.d.ts.map

package/dist/cjs/types/upload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload.d.ts","sourceRoot":"","sources":["../../../src/types/upload.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,CAAC;AAE9D;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,iDAAiD;IACjD,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEpD;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;AAE3E;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,uBAAuB;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,oDAAoD;IACpD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}

package/dist/cjs/types/upload.js

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

package/dist/cjs/utils/Histogram.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Стандартные границы корзин гистограммы в миллисекундах.
+ *
+ * Покрывают диапазон от быстрых (~5ms) до медленных (~1s) обработчиков.
+ * Совпадают с дефолтными bucket-ами Prometheus Go-клиента (DefBuckets).
+ */
+export declare const DEFAULT_BUCKETS: readonly number[];
+/**
+ * Снимок гистограммы в момент вызова {@link Histogram.snapshot}.
+ */
+export interface HistogramSnapshot {
+    /**
+     * Накопленные счётчики по корзинам.
+     *
+     * Ключи — строковые границы корзин (`"5"`, `"10"`, …), последний — `"+Inf"`.
+     * Каждая корзина содержит **кумулятивное** число наблюдений,
+     * т.е. `buckets["50"]` = число значений ≤ 50ms.
+     *
+     * Формат совместим с Prometheus histogram (cumulative).
+     */
+    buckets: Record<string, number>;
+    /** Сумма всех наблюдаемых значений (мс). Используется для расчёта среднего. */
+    sum: number;
+    /** Общее число наблюдений. Равно `buckets["+Inf"]`. */
+    count: number;
+}
+/**
+ * Гистограмма задержек.
+ *
+ * Накапливает измерения (в мс) по заранее заданным boundary-корзинам.
+ * Формат снимка ({@link HistogramSnapshot}) совместим с Prometheus histogram
+ * — можно скармировать напрямую `prom-client` или аналогу.
+ *
+ * @example Интеграция с onMetrics
+ * ```ts
+ * const histogram = new Histogram();
+ *
+ * bot = new Bot({
+ *   token: process.env.MAX_BOT_TOKEN!,
+ *   transport: "polling",
+ *   onMetrics: (m) => histogram.observe(m.totalMs),
+ * });
+ *
+ * // Раз в минуту — публикуем снимок
+ * setInterval(() => {
+ *   const snap = histogram.snapshot();
+ *   console.log(`p50≈${snap.buckets["50"]} count=${snap.count} sum=${snap.sum}ms`);
+ *   histogram.reset(); // сбрасываем для следующего окна
+ * }, 60_000);
+ * ```
+ *
+ * @example Кастомные корзины
+ * ```ts
+ * const h = new Histogram([10, 50, 200, 1000, 5000]);
+ * ```
+ */
+export declare class Histogram {
+    private readonly boundaries;
+    /** Кумулятивные счётчики: counts[i] = число наблюдений ≤ boundaries[i] */
+    private readonly counts;
+    private _sum;
+    private _count;
+    /**
+     * @param boundaries - Границы корзин в мс (порядок не важен, будут отсортированы).
+     *   По умолчанию — {@link DEFAULT_BUCKETS}.
+     */
+    constructor(boundaries?: readonly number[]);
+    /**
+     * Записывает одно измерение.
+     *
+     * Инкрементирует все корзины, чья граница ≥ `ms` (кумулятивный формат).
+     *
+     * @param ms - Значение в миллисекундах (обычно `BotMetrics.totalMs`)
+     */
+    observe(ms: number): void;
+    /**
+     * Возвращает текущий снимок гистограммы (не изменяет состояние).
+     *
+     * Структура `buckets` — кумулятивные счётчики Prometheus:
+     * - `"5"` → число наблюдений ≤ 5ms
+     * - `"10"` → число наблюдений ≤ 10ms
+     * - …
+     * - `"+Inf"` → общее число наблюдений
+     */
+    snapshot(): HistogramSnapshot;
+    /**
+     * Сбрасывает все счётчики.
+     *
+     * Используйте для скользящих окон (например, раз в минуту).
+     */
+    reset(): void;
+}
+//# sourceMappingURL=Histogram.d.ts.map

package/dist/cjs/utils/Histogram.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Histogram.d.ts","sourceRoot":"","sources":["../../../src/utils/Histogram.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,eAAe,EAAE,SAAS,MAAM,EAEnC,CAAC;AAEX;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;;;;;OAQG;IACH,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,+EAA+E;IAC/E,GAAG,EAAE,MAAM,CAAC;IACZ,uDAAuD;IACvD,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAoB;IAC/C,0EAA0E;IAC1E,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAW;IAClC,OAAO,CAAC,IAAI,CAAK;IACjB,OAAO,CAAC,MAAM,CAAK;IAEnB;;;OAGG;gBACS,UAAU,GAAE,SAAS,MAAM,EAAoB;IAM3D;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAUzB;;;;;;;;OAQG;IACH,QAAQ,IAAI,iBAAiB;IAS7B;;;;OAIG;IACH,KAAK,IAAI,IAAI;CAKd"}