@dementevdev/maxbot-ts 1.0.0

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

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

package/dist/esm/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/esm/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/esm/types/subscription.js

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

package/dist/esm/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/esm/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/esm/types/update.js

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

package/dist/esm/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/esm/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/esm/types/upload.js

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

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

package/dist/esm/utils/Histogram.js

@@ -0,0 +1,99 @@
+/**
+ * Стандартные границы корзин гистограммы в миллисекундах.
+ *
+ * Покрывают диапазон от быстрых (~5ms) до медленных (~1s) обработчиков.
+ * Совпадают с дефолтными bucket-ами Prometheus Go-клиента (DefBuckets).
+ */
+export const DEFAULT_BUCKETS = [
+    5, 10, 25, 50, 100, 250, 500, 1000,
+];
+/**
+ * Гистограмма задержек.
+ *
+ * Накапливает измерения (в мс) по заранее заданным 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 class Histogram {
+    boundaries;
+    /** Кумулятивные счётчики: counts[i] = число наблюдений ≤ boundaries[i] */
+    counts;
+    _sum = 0;
+    _count = 0;
+    /**
+     * @param boundaries - Границы корзин в мс (порядок не важен, будут отсортированы).
+     *   По умолчанию — {@link DEFAULT_BUCKETS}.
+     */
+    constructor(boundaries = DEFAULT_BUCKETS) {
+        // Дедупликация и сортировка по возрастанию
+        this.boundaries = [...new Set(boundaries)].sort((a, b) => a - b);
+        this.counts = new Array(this.boundaries.length).fill(0);
+    }
+    /**
+     * Записывает одно измерение.
+     *
+     * Инкрементирует все корзины, чья граница ≥ `ms` (кумулятивный формат).
+     *
+     * @param ms - Значение в миллисекундах (обычно `BotMetrics.totalMs`)
+     */
+    observe(ms) {
+        this._sum += ms;
+        this._count++;
+        for (let i = 0; i < this.boundaries.length; i++) {
+            if (ms <= this.boundaries[i]) {
+                this.counts[i]++;
+            }
+        }
+    }
+    /**
+     * Возвращает текущий снимок гистограммы (не изменяет состояние).
+     *
+     * Структура `buckets` — кумулятивные счётчики Prometheus:
+     * - `"5"` → число наблюдений ≤ 5ms
+     * - `"10"` → число наблюдений ≤ 10ms
+     * - …
+     * - `"+Inf"` → общее число наблюдений
+     */
+    snapshot() {
+        const buckets = {};
+        for (let i = 0; i < this.boundaries.length; i++) {
+            buckets[String(this.boundaries[i])] = this.counts[i];
+        }
+        buckets["+Inf"] = this._count;
+        return { buckets, sum: this._sum, count: this._count };
+    }
+    /**
+     * Сбрасывает все счётчики.
+     *
+     * Используйте для скользящих окон (например, раз в минуту).
+     */
+    reset() {
+        this.counts.fill(0);
+        this._sum = 0;
+        this._count = 0;
+    }
+}
+//# sourceMappingURL=Histogram.js.map

package/dist/esm/utils/assertNever.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Exhaustiveness check для discriminated union-ов.
+ *
+ * Вызывается в `default`-ветке switch чтобы TypeScript статически гарантировал,
+ * что все варианты union обработаны. Если ветка достигается в рантайме —
+ * бросает ошибку с понятным сообщением вместо молчаливого некорректного поведения.
+ *
+ * @example
+ * ```typescript
+ * switch (update.update_type) {
+ *   case "message_created": ...
+ *   case "message_callback": ...
+ *   default:
+ *     assertNever(update); // ошибка компиляции если добавить новый update_type
+ * }
+ * ```
+ */
+export declare function assertNever(value: never): never;
+//# sourceMappingURL=assertNever.d.ts.map

package/dist/esm/utils/assertNever.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assertNever.d.ts","sourceRoot":"","sources":["../../../src/utils/assertNever.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,KAAK,CAI/C"}

package/dist/esm/utils/assertNever.js

@@ -0,0 +1,21 @@
+/**
+ * Exhaustiveness check для discriminated union-ов.
+ *
+ * Вызывается в `default`-ветке switch чтобы TypeScript статически гарантировал,
+ * что все варианты union обработаны. Если ветка достигается в рантайме —
+ * бросает ошибку с понятным сообщением вместо молчаливого некорректного поведения.
+ *
+ * @example
+ * ```typescript
+ * switch (update.update_type) {
+ *   case "message_created": ...
+ *   case "message_callback": ...
+ *   default:
+ *     assertNever(update); // ошибка компиляции если добавить новый update_type
+ * }
+ * ```
+ */
+export function assertNever(value) {
+    throw new Error(`assertNever: необработанный вариант: ${JSON.stringify(value)}`);
+}
+//# sourceMappingURL=assertNever.js.map

package/dist/esm/utils/format.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Утилиты форматирования текста сообщений.
+ */
+export declare const md: {
+    readonly bold: (text: string) => string;
+    readonly italic: (text: string) => string;
+    readonly strike: (text: string) => string;
+    readonly underline: (text: string) => string;
+    readonly link: (text: string, url: string) => string;
+    readonly mention: (userId: number, text: string) => string;
+    readonly escape: (text: string) => string;
+};
+export declare const html: {
+    readonly bold: (text: string) => string;
+    readonly italic: (text: string) => string;
+    readonly strike: (text: string) => string;
+    readonly underline: (text: string) => string;
+    readonly link: (text: string, url: string) => string;
+    readonly mention: (userId: number, text: string) => string;
+    readonly escape: (text: string) => string;
+};
+//# sourceMappingURL=format.d.ts.map

package/dist/esm/utils/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../../src/utils/format.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,EAAE;0BACA,MAAM;4BACJ,MAAM;4BACN,MAAM;+BACH,MAAM;0BACX,MAAM,OAAO,MAAM;+BACd,MAAM,QAAQ,MAAM;4BACvB,MAAM;CACb,CAAC;AAEX,eAAO,MAAM,IAAI;0BACF,MAAM;4BACJ,MAAM;4BACN,MAAM;+BACH,MAAM;0BACX,MAAM,OAAO,MAAM;+BACd,MAAM,QAAQ,MAAM;4BAEvB,MAAM;CAEb,CAAC"}

package/dist/esm/utils/format.js

@@ -0,0 +1,22 @@
+/**
+ * Утилиты форматирования текста сообщений.
+ */
+export const md = {
+    bold: (text) => `**${text}**`,
+    italic: (text) => `_${text}_`,
+    strike: (text) => `~~${text}~~`,
+    underline: (text) => `++${text}++`,
+    link: (text, url) => `[${text}](${url})`,
+    mention: (userId, text) => `[${text}](max://user/${userId})`,
+    escape: (text) => text.replace(/[*_~+\[\]()\\]/g, "\\$&"),
+};
+export const html = {
+    bold: (text) => `<b>${text}</b>`,
+    italic: (text) => `<i>${text}</i>`,
+    strike: (text) => `<del>${text}</del>`,
+    underline: (text) => `<ins>${text}</ins>`,
+    link: (text, url) => `<a href="${url}">${text}</a>`,
+    mention: (userId, text) => `<a href="max://user/${userId}">${text}</a>`,
+    escape: (text) => text.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;"),
+};
+//# sourceMappingURL=format.js.map

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

@@ -0,0 +1,6 @@
+export { InlineKeyboard } from "./keyboard.js";
+export { md, html } from "./format.js";
+export { assertNever } from "./assertNever.js";
+export { Histogram, DEFAULT_BUCKETS } from "./Histogram.js";
+export type { HistogramSnapshot } from "./Histogram.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAC5D,YAAY,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/esm/utils/index.js

@@ -0,0 +1,5 @@
+export { InlineKeyboard } from "./keyboard.js";
+export { md, html } from "./format.js";
+export { assertNever } from "./assertNever.js";
+export { Histogram, DEFAULT_BUCKETS } from "./Histogram.js";
+//# sourceMappingURL=index.js.map