@dementevdev/maxbot-ts 1.0.0

package/dist/types/bot/context/CallbackContext.d.ts

@@ -0,0 +1,107 @@
+import type { ContextApi, SendOptions } from "./MessageContext.js";
+import type { User } from "../../types/common.js";
+import type { Message, NewMessageBody } from "../../types/message.js";
+import type { CallbackUpdate } from "../../types/update.js";
+import type { Context } from "../Bot.js";
+/**
+ * Опции ответа на callback
+ */
+export interface AnswerOptions {
+    /** Обновить текущее сообщение */
+    message?: NewMessageBody;
+    /** Одноразовое уведомление пользователю */
+    notification?: string;
+}
+/**
+ * Контекст callback-запроса (нажатие на inline-кнопку).
+ */
+export declare class CallbackContext {
+    private readonly update;
+    private readonly api;
+    /**
+     * Результат совпадения RegExp из `bot.action()`.
+     *
+     * Доступен только внутри обработчика `action()` с RegExp-паттерном.
+     * Содержит полный `RegExpExecArray`: `ctx.match[0]` — полное совпадение,
+     * `ctx.match[1]`, `ctx.match[2]`, ... — группы захвата.
+     *
+     * `null` если обработчик вызван не через `action()` или паттерн — строка.
+     *
+     * @example
+     * bot.action(/^buy:(\d+)$/, async (ctx) => {
+     *   if (isCallbackContext(ctx)) console.log(ctx.match?.[1]); // id товара
+     * });
+     */
+    match: RegExpExecArray | null;
+    constructor(update: CallbackUpdate, api: ContextApi);
+    /** Исходное обновление */
+    get raw(): CallbackUpdate;
+    /** ID callback-запроса */
+    get callbackId(): string;
+    /** Данные callback (payload кнопки) */
+    get data(): string;
+    /**
+     * Сообщение, к которому была прикреплена кнопка.
+     * Может отсутствовать, если сообщение было удалено к моменту callback.
+     */
+    get message(): Message | null;
+    /** ID чата */
+    get chatId(): number | null;
+    /** Пользователь, нажавший кнопку — гарантировано присутствие API */
+    get callbackUser(): User;
+    /** ID пользователя, нажавшего кнопку */
+    get userId(): number;
+    /** Локаль пользователя */
+    get locale(): string | null;
+    /**
+     * Ответить на callback.
+     *
+     * Закрывает "часики" на кнопке и опционально показывает уведомление.
+     */
+    answer(options?: AnswerOptions): Promise<void>;
+    /**
+     * Ответить сообщением в чат.
+     *
+     * Бросает ошибку, если chat_id недоступен — сообщение было удалено.
+     */
+    reply(text: string, options?: SendOptions): Promise<Message>;
+    /**
+     * Редактировать сообщение с кнопкой.
+     */
+    editMessage(text: string, options?: SendOptions): Promise<void>;
+    /**
+     * Удалить сообщение с кнопкой.
+     *
+     * Бросает ошибку, если сообщение было удалено до callback.
+     *
+     * @example
+     * await ctx.deleteMessage();
+     */
+    deleteMessage(): Promise<void>;
+    /**
+     * Отправить произвольное действие в чат.
+     *
+     * Распространённые значения: `"typing_on"`, `"sending_photo"`,
+     * `"sending_video"`, `"sending_audio"`, `"sending_file"`, `"mark_seen"`.
+     *
+     * Бросает ошибку, если chat_id недоступен — сообщение удалено.
+     *
+     * @example
+     * await ctx.sendAction('typing_on');
+     */
+    sendAction(action: string): Promise<void>;
+    /**
+     * Проверить тип контекста с сужением типа (type narrowing).
+     *
+     * @example
+     * ```ts
+     * bot.on('callback', async (ctx) => {
+     *   if (ctx.has(hasCallbackPayload('confirm'))) {
+     *     await ctx.answer({ notification: 'Подтверждено!' });
+     *   }
+     * });
+     * ```
+     */
+    has<R extends Context>(filter: (ctx: Context) => ctx is R): this is R;
+}
+//# sourceMappingURL=CallbackContext.d.ts.map

package/dist/types/bot/context/CallbackContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CallbackContext.d.ts","sourceRoot":"","sources":["../../../../src/bot/context/CallbackContext.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACnE,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACtE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,iCAAiC;IACjC,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,2CAA2C;IAC3C,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,qBAAa,eAAe;IAmBxB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,GAAG;IAnBtB;;;;;;;;;;;;;OAaG;IACH,KAAK,EAAE,eAAe,GAAG,IAAI,CAAQ;gBAIlB,MAAM,EAAE,cAAc,EACtB,GAAG,EAAE,UAAU;IAGlC,0BAA0B;IAC1B,IAAI,GAAG,IAAI,cAAc,CAExB;IAED,0BAA0B;IAC1B,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED,uCAAuC;IACvC,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;;OAGG;IACH,IAAI,OAAO,IAAI,OAAO,GAAG,IAAI,CAE5B;IAED,cAAc;IACd,IAAI,MAAM,IAAI,MAAM,GAAG,IAAI,CAE1B;IAED,oEAAoE;IACpE,IAAI,YAAY,IAAI,IAAI,CAEvB;IAED,wCAAwC;IACxC,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,0BAA0B;IAC1B,IAAI,MAAM,IAAI,MAAM,GAAG,IAAI,CAE1B;IAED;;;;OAIG;IACG,MAAM,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpD;;;;OAIG;IACG,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC;IAsBlE;;OAEG;IACG,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAerE;;;;;;;OAOG;IACG,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAUpC;;;;;;;;;;OAUG;IACG,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAU/C;;;;;;;;;;;OAWG;IACH,GAAG,CAAC,CAAC,SAAS,OAAO,EAAE,MAAM,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,GAAG,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC;CAGtE"}

package/dist/types/bot/context/ChatContext.d.ts

@@ -0,0 +1,35 @@
+import type { User } from "../../types/common.js";
+import type { ChatUpdate } from "../../types/update.js";
+import type { Context } from "../Bot.js";
+/**
+ * Контекст системного события чата (bot_added, bot_removed, user_added, user_removed, chat_title_changed).
+ *
+ * Системные события не содержат message — для них неприменимы reply/send.
+ * Отдельный тип предотвращает runtime ошибки при обращении к message в MessageContext.
+ */
+export declare class ChatContext {
+    private readonly update;
+    constructor(update: ChatUpdate);
+    /** Исходное обновление */
+    get raw(): ChatUpdate;
+    /** ID чата, в котором произошло событие */
+    get chatId(): number;
+    /** Пользователь, инициировавший событие */
+    get user(): User;
+    /** ID пользователя */
+    get userId(): number;
+    /** Является ли чат каналом */
+    get isChannel(): boolean;
+    /**
+     * Проверить тип контекста с сужением типа (type narrowing).
+     *
+     * @example
+     * ```ts
+     * bot.on('bot_added', async (ctx) => {
+     *   if (ctx.has(isPrivateChat)) { ... }
+     * });
+     * ```
+     */
+    has<R extends Context>(filter: (ctx: Context) => ctx is R): this is R;
+}
+//# sourceMappingURL=ChatContext.d.ts.map

package/dist/types/bot/context/ChatContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChatContext.d.ts","sourceRoot":"","sources":["../../../../src/bot/context/ChatContext.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC;;;;;GAKG;AACH,qBAAa,WAAW;IAGpB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,UAAU;IAGrC,0BAA0B;IAC1B,IAAI,GAAG,IAAI,UAAU,CAEpB;IAED,2CAA2C;IAC3C,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,2CAA2C;IAC3C,IAAI,IAAI,IAAI,IAAI,CAEf;IAED,sBAAsB;IACtB,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,8BAA8B;IAC9B,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED;;;;;;;;;OASG;IACH,GAAG,CAAC,CAAC,SAAS,OAAO,EAAE,MAAM,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,GAAG,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC;CAGtE"}

package/dist/types/bot/context/MessageContext.d.ts

@@ -0,0 +1,149 @@
+import type { IBotsApi, IChatsApi, IMessagesApi, ISubscriptionsApi, IUploadsApi } from "../../api/interfaces.js";
+import type { Attachment, Message, NewMessageBody } from "../../types/message.js";
+import type { MessageUpdate } from "../../types/update.js";
+import type { Context } from "../Bot.js";
+/**
+ * API, доступные в контексте
+ */
+export interface ContextApi {
+    bots: IBotsApi;
+    chats: IChatsApi;
+    messages: IMessagesApi;
+    subscriptions: ISubscriptionsApi;
+    uploads: IUploadsApi;
+}
+/**
+ * Опции отправки сообщения
+ */
+export interface SendOptions {
+    format?: "markdown" | "html";
+    attachments?: NewMessageBody["attachments"];
+    notify?: boolean;
+    disable_link_preview?: boolean;
+}
+/**
+ * Контекст сообщения.
+ *
+ * Оборачивает MessageUpdate и добавляет удобные методы для ответа.
+ * Избавляет разработчика от необходимости передавать chatId/userId в каждый метод.
+ */
+export declare class MessageContext {
+    private readonly update;
+    private readonly api;
+    /**
+     * Результат совпадения RegExp из `bot.hears()`.
+     *
+     * Доступен только внутри обработчика `hears()` с RegExp-паттерном.
+     * Содержит полный `RegExpExecArray`: `ctx.match[0]` — полное совпадение,
+     * `ctx.match[1]`, `ctx.match[2]`, ... — группы захвата.
+     *
+     * `null` если обработчик вызван не через `hears()` или паттерн — строка.
+     *
+     * @example
+     * bot.hears(/(\d+)/, async (ctx) => {
+     *   if (isMessageContext(ctx)) console.log(ctx.match?.[1]); // первая группа
+     * });
+     */
+    match: RegExpExecArray | null;
+    constructor(update: MessageUpdate, api: ContextApi);
+    /** Исходное обновление */
+    get raw(): MessageUpdate;
+    /** Сообщение */
+    get message(): Message;
+    /** Текст сообщения */
+    get text(): string | undefined;
+    /** ID сообщения. null если сообщение не содержит body (например, пересланное без текста). */
+    get messageId(): string | null;
+    /** ID чата (если сообщение из чата) */
+    get chatId(): number | null;
+    /** ID отправителя */
+    get senderId(): number | undefined;
+    /** Имя отправителя */
+    get senderName(): string | undefined;
+    /** Username отправителя */
+    get senderUsername(): string | null | undefined;
+    /** Локаль пользователя */
+    get locale(): string | null;
+    /** Тип чата */
+    get chatType(): "chat" | "dialog";
+    /** Это личное сообщение? */
+    get isPrivate(): boolean;
+    /** Это сообщение в группе? */
+    get isGroup(): boolean;
+    /** Вложения сообщения */
+    get attachments(): Attachment[] | null;
+    /**
+     * Ответить на сообщение.
+     *
+     * Бросает ошибку, если chat_id недоступен — это защищает от молчаливого падения если message.recipient не содержит chat_id.
+     */
+    reply(text: string, options?: SendOptions): Promise<Message>;
+    /**
+     * Ответить с цитированием исходного сообщения.
+     *
+     * Бросает ошибку, если chat_id или mid недоступны.
+     */
+    replyWithQuote(text: string, options?: SendOptions): Promise<Message>;
+    /**
+     * Отправить действие "печатает..." в чат.
+     *
+     * Бросает ошибку, если chat_id недоступен — согласован со стилем reply().
+     */
+    sendTyping(): Promise<void>;
+    /**
+     * Отправить произвольное действие в чат.
+     *
+     * Распространённые значения: `"typing_on"`, `"sending_photo"`,
+     * `"sending_video"`, `"sending_audio"`, `"sending_file"`, `"mark_seen"`.
+     *
+     * Бросает ошибку, если chat_id недоступен.
+     *
+     * @example
+     * await ctx.sendAction('sending_photo');
+     */
+    sendAction(action: string): Promise<void>;
+    /**
+     * Редактировать текущее сообщение.
+     *
+     * Бросает ошибку, если message_id недоступен.
+     *
+     * @example
+     * await ctx.editMessage('Обновлённый текст');
+     */
+    editMessage(text: string, options?: SendOptions): Promise<void>;
+    /**
+     * Удалить текущее сообщение.
+     *
+     * Бросает ошибку, если message_id недоступен.
+     *
+     * @example
+     * await ctx.deleteMessage();
+     */
+    deleteMessage(): Promise<void>;
+    /**
+     * Проверить тип контекста с сужением типа (type narrowing).
+     *
+     * Принимает предикат-фильтр и возвращает `true`, если данный контекст
+     * удовлетворяет условию. TypeScript автоматически суживает тип внутри
+     * блока `if` до более конкретного.
+     *
+     * @example С predicate из filters
+     * ```ts
+     * bot.on('message', async (ctx) => {
+     *   if (ctx.has(hasText)) {
+     *     console.log(ctx.text.toUpperCase()); // ctx.text: string (не undefined)
+     *   }
+     * });
+     * ```
+     *
+     * @example Произвольный предикат
+     * ```ts
+     * const isAdmin = (ctx: Context): ctx is MessageContext =>
+     *   isMessageContext(ctx) && ctx.senderId === ADMIN_ID;
+     *
+     * if (ctx.has(isAdmin)) { ... }
+     * ```
+     */
+    has<R extends Context>(filter: (ctx: Context) => ctx is R): this is R;
+}
+//# sourceMappingURL=MessageContext.d.ts.map

package/dist/types/bot/context/MessageContext.d.ts.map

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

package/dist/types/bot/context/guards.d.ts

@@ -0,0 +1,69 @@
+import { BotStartedContext } from "./BotStartedContext.js";
+import { CallbackContext } from "./CallbackContext.js";
+import { ChatContext } from "./ChatContext.js";
+import { MessageContext } from "./MessageContext.js";
+import type { Context } from "../Bot.js";
+/**
+ * Type guard: проверяет, что контекст является `MessageContext`.
+ *
+ * Применяется в middleware для сужения типа:
+ * @example
+ * bot.use(async (ctx, next) => {
+ *   if (isMessageContext(ctx)) {
+ *     console.log(ctx.text); // string | undefined — TS знает тип
+ *   }
+ *   await next();
+ * });
+ */
+export declare function isMessageContext(ctx: Context): ctx is MessageContext;
+/**
+ * Type guard: проверяет, что контекст является `CallbackContext`.
+ *
+ * @example
+ * bot.use(async (ctx, next) => {
+ *   if (isCallbackContext(ctx)) {
+ *     console.log(ctx.data); // payload кнопки
+ *   }
+ *   await next();
+ * });
+ */
+export declare function isCallbackContext(ctx: Context): ctx is CallbackContext;
+/**
+ * Type guard: проверяет, что контекст является `ChatContext`.
+ *
+ * @example
+ * bot.use(async (ctx, next) => {
+ *   if (isChatContext(ctx)) {
+ *     console.log(ctx.chatId); // number — всегда есть в ChatContext
+ *   }
+ *   await next();
+ * });
+ */
+export declare function isChatContext(ctx: Context): ctx is ChatContext;
+/**
+ * Type guard: проверяет, что контекст является `BotStartedContext`.
+ *
+ * Используй для обработки нажатия Start или перехода по deep link:
+ * @example
+ * bot.use(async (ctx, next) => {
+ *   if (isBotStartedContext(ctx)) {
+ *     console.log(ctx.startPayload); // payload из deep link или null
+ *   }
+ *   await next();
+ * });
+ */
+export declare function isBotStartedContext(ctx: Context): ctx is BotStartedContext;
+/**
+ * Type guard: проверяет конкретный `update_type`.
+ *
+ * Используй когда нужно сузить тип внутри MessageContext или ChatContext:
+ * @example
+ * bot.use(async (ctx, next) => {
+ *   if (isUpdateType(ctx, 'message_created')) {
+ *     // ctx — MessageContext с update_type === 'message_created'
+ *   }
+ *   await next();
+ * });
+ */
+export declare function isUpdateType<T extends Context>(ctx: Context, updateType: T["raw"]["update_type"]): ctx is T;
+//# sourceMappingURL=guards.d.ts.map

package/dist/types/bot/context/guards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guards.d.ts","sourceRoot":"","sources":["../../../../src/bot/context/guards.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,cAAc,CAEpE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,eAAe,CAEtE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,WAAW,CAE9D;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,iBAAiB,CAE1E;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,OAAO,EAC5C,GAAG,EAAE,OAAO,EACZ,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,aAAa,CAAC,GAClC,GAAG,IAAI,CAAC,CAEV"}

package/dist/types/bot/context/index.d.ts

@@ -0,0 +1,6 @@
+export { MessageContext, type SendOptions, type ContextApi, } from "./MessageContext.js";
+export { CallbackContext, type AnswerOptions } from "./CallbackContext.js";
+export { ChatContext } from "./ChatContext.js";
+export { BotStartedContext } from "./BotStartedContext.js";
+export { isMessageContext, isCallbackContext, isChatContext, isBotStartedContext, isUpdateType, } from "./guards.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/types/bot/context/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/bot/context/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,KAAK,WAAW,EAChB,KAAK,UAAU,GAChB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,eAAe,EAAE,KAAK,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC3E,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,aAAa,EACb,mBAAmB,EACnB,YAAY,GACb,MAAM,aAAa,CAAC"}

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

@@ -0,0 +1,51 @@
+import { type ContextApi } from "./context/MessageContext.js";
+import type { Middleware } from "../middleware/types.js";
+import type { Update } from "../types/update.js";
+import type { BotMetrics } from "./metrics.js";
+import type { Context, EventHandler } from "./Bot.js";
+/**
+ * Слой диспетчеризации и семафора.
+ *
+ * Отвечает за:
+ * - Создание контекста из сырого обновления (`createContext`)
+ * - Запуск пайплайна middleware + handlers (`handleUpdate`, `runHandlersWithSemaphore`)
+ * - Backpressure (семафор: `acquireSemaphore` / `releaseSemaphore`)
+ * - Маршрутизацию ошибок (`handleError`)
+ *
+ * Не содержит бизнес-логики маршрутизации — она вынесена в {@link BotRouting}.
+ */
+export declare abstract class BotDispatch<Ctx extends Context> {
+    protected readonly handlers: Map<string, EventHandler<Ctx>[]>;
+    protected readonly middlewares: Middleware<Ctx>[];
+    protected contextApi: ContextApi;
+    protected _contextFactory: (base: Context) => Ctx;
+    protected concurrency: number;
+    protected errorHandler: ((error: Error) => void) | null;
+    protected slowHandler: ((ms: number, updateType: string) => void) | null;
+    protected slowThresholdMs: number;
+    protected unknownUpdateHandler: ((raw: Record<string, unknown>) => void) | null;
+    protected metricsHandler: ((metrics: BotMetrics) => void) | null;
+    private activeCount;
+    private readonly waitQueue;
+    protected handleUpdate(update: Update): void;
+    private runHandlersWithSemaphore;
+    /**
+     * Захватить слот семафора.
+     * Если свободных слотов нет — ждём в очереди.
+     */
+    private acquireSemaphore;
+    /**
+     * Освободить слот семафора и разбудить следующего в очереди.
+     */
+    private releaseSemaphore;
+    protected handleError(error: Error): void;
+    /**
+     * Создаёт типизированный контекст из сырого обновления.
+     *
+     * Возвращает `null` если `update_type` неизвестен SDK **и** задан хук
+     * `onUnknownUpdate` — хук уже вызван, update нужно пропустить.
+     * Если хук не задан — бросает ошибку через `assertNever` → `errorHandler`.
+     */
+    private createContext;
+}
+//# sourceMappingURL=dispatch.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch.d.ts","sourceRoot":"","sources":["../../../src/bot/dispatch.ts"],"names":[],"mappings":"AAGA,OAAO,EAAkB,KAAK,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAG9E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAEtD;;;;;;;;;;GAUG;AACH,8BAAsB,WAAW,CAAC,GAAG,SAAS,OAAO;IAEnD,SAAS,CAAC,QAAQ,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC,CAAa;IAC1E,SAAS,CAAC,QAAQ,CAAC,WAAW,EAAE,UAAU,CAAC,GAAG,CAAC,EAAE,CAAM;IAKvD,SAAS,CAAC,UAAU,EAAG,UAAU,CAAC;IAClC,SAAS,CAAC,eAAe,EAAG,CAAC,IAAI,EAAE,OAAO,KAAK,GAAG,CAAC;IACnD,SAAS,CAAC,WAAW,EAAG,MAAM,CAAC;IAG/B,SAAS,CAAC,YAAY,EAAE,CAAC,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC,GAAG,IAAI,CAAQ;IAC/D,SAAS,CAAC,WAAW,EAAE,CAAC,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,IAAI,CACjE;IACP,SAAS,CAAC,eAAe,SAAK;IAC9B,SAAS,CAAC,oBAAoB,EAC1B,CAAC,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC,GACxC,IAAI,CAAQ;IAChB,SAAS,CAAC,cAAc,EAAE,CAAC,CAAC,OAAO,EAAE,UAAU,KAAK,IAAI,CAAC,GAAG,IAAI,CAAQ;IAGxE,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAyB;IAInD,SAAS,CAAC,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;YA6B9B,wBAAwB;IAoEtC;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IAUxB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAUxB,SAAS,CAAC,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAczC;;;;;;OAMG;IACH,OAAO,CAAC,aAAa;CAkCtB"}

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

@@ -0,0 +1,10 @@
+export { Bot, type BotConfig, type Context, type EventHandler } from "./Bot.js";
+export { Composer, type Filter } from "./Composer.js";
+export { type HearsTrigger, type CommandTrigger, matchCommand, } from "./triggers.js";
+export type { BotMetrics } from "./metrics.js";
+export { MessageContext, type ContextApi, type SendOptions, } from "./context/MessageContext.js";
+export { CallbackContext, type AnswerOptions, } from "./context/CallbackContext.js";
+export { ChatContext } from "./context/ChatContext.js";
+export { BotStartedContext } from "./context/BotStartedContext.js";
+export { isMessageContext, isCallbackContext, isChatContext, isBotStartedContext, isUpdateType, } from "./context/guards.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/bot/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,KAAK,SAAS,EAAE,KAAK,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,UAAU,CAAC;AAChF,OAAO,EAAE,QAAQ,EAAE,KAAK,MAAM,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,YAAY,GACb,MAAM,eAAe,CAAC;AACvB,YAAY,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EACL,cAAc,EACd,KAAK,UAAU,EACf,KAAK,WAAW,GACjB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,eAAe,EACf,KAAK,aAAa,GACnB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACnE,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,aAAa,EACb,mBAAmB,EACnB,YAAY,GACb,MAAM,qBAAqB,CAAC"}

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

@@ -0,0 +1,85 @@
+import type { IBotsApi, IChatsApi, IMessagesApi, ISubscriptionsApi, IUploadsApi } from "../api/interfaces.js";
+import type { IUpdateTransport } from "../transport/interfaces.js";
+import type { BotInfo } from "../types/bot.js";
+import type { Message } from "../types/message.js";
+import type { SubscriptionInfo } from "../types/subscription.js";
+import type { SendOptions } from "./context/MessageContext.js";
+import { BotRouting } from "./routing.js";
+import type { Context } from "./Bot.js";
+/**
+ * Слой жизненного цикла и удобных методов.
+ *
+ * Отвечает за:
+ * - Запуск / остановку бота (`start` / `stop`) с Promise-мьютексом
+ * - Управление webhook (`setWebhookUrl`, `deleteWebhook`, `getWebhookInfo`)
+ * - Высокоуровневые методы отправки (`sendMessage`, `sendPrivateMessage`, `getMe`)
+ * - Конфигурацию наблюдателей (`onError`, `onSlowHandler`)
+ *
+ * Расширяет {@link BotRouting} — использует маршруты и middleware из него.
+ *
+ * Поля `api` и `transport` объявлены как `abstract` — конкретные значения
+ * предоставляет конструктор `Bot`.
+ */
+export declare abstract class BotLifecycle<Ctx extends Context> extends BotRouting<Ctx> {
+    /** Доступ к низкоуровневым API для продвинутых сценариев */
+    abstract readonly api: {
+        readonly bots: IBotsApi;
+        readonly chats: IChatsApi;
+        readonly messages: IMessagesApi;
+        readonly subscriptions: ISubscriptionsApi;
+        readonly uploads: IUploadsApi;
+    };
+    /** Транспорт: LongPolling или Webhook */
+    protected abstract readonly transport: IUpdateTransport;
+    private startPromise;
+    /**
+     * Установить URL для webhook.
+     */
+    setWebhookUrl(url: string): Promise<void>;
+    /**
+     * Удалить webhook.
+     */
+    deleteWebhook(): Promise<void>;
+    /**
+     * Получить информацию о текущем webhook.
+     */
+    getWebhookInfo(): Promise<SubscriptionInfo>;
+    /**
+     * Зарегистрировать обработчик ошибок.
+     */
+    onError(handler: (error: Error) => void): this;
+    /**
+     * Назначить коллбэк для медленных обработчиков.
+     *
+     * Если обработка обновления заняла больше `thresholdMs` мс,
+     * вызывается `cb` с фактическим временем выполнения и типом обновления.
+     *
+     * @example
+     * bot.onSlowHandler(500, (ms, type) => {
+     *   log.warn({ ms, type }, 'slow handler detected');
+     * });
+     */
+    onSlowHandler(thresholdMs: number, cb: (ms: number, updateType: string) => void): this;
+    /**
+     * Получить информацию о боте.
+     */
+    getMe(): Promise<BotInfo>;
+    /**
+     * Отправить сообщение в чат.
+     */
+    sendMessage(chatId: number, text: string, options?: SendOptions): Promise<Message>;
+    /**
+     * Отправить личное сообщение пользователю.
+     */
+    sendPrivateMessage(userId: number, text: string, options?: SendOptions): Promise<Message>;
+    /**
+     * Запустить бота.
+     */
+    start(): Promise<void>;
+    /**
+     * Остановить бота.
+     */
+    stop(): Promise<void>;
+    private _doStart;
+}
+//# sourceMappingURL=lifecycle.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../../src/bot/lifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,QAAQ,EACR,SAAS,EACT,YAAY,EACZ,iBAAiB,EACjB,WAAW,EACZ,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,KAAK,EAAE,OAAO,EAAkB,MAAM,qBAAqB,CAAC;AACnE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAExC;;;;;;;;;;;;;GAaG;AACH,8BAAsB,YAAY,CAChC,GAAG,SAAS,OAAO,CACnB,SAAQ,UAAU,CAAC,GAAG,CAAC;IACvB,4DAA4D;IAC5D,QAAQ,CAAC,QAAQ,CAAC,GAAG,EAAE;QACrB,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;QACxB,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;QAC1B,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC;QAChC,QAAQ,CAAC,aAAa,EAAE,iBAAiB,CAAC;QAC1C,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;KAC/B,CAAC;IAEF,yCAAyC;IACzC,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,SAAS,EAAE,gBAAgB,CAAC;IAMxD,OAAO,CAAC,YAAY,CAA8B;IAIlD;;OAEG;IACG,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI/C;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAIpC;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,gBAAgB,CAAC;IAMjD;;OAEG;IACH,OAAO,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,IAAI;IAK9C;;;;;;;;;;OAUG;IACH,aAAa,CACX,WAAW,EAAE,MAAM,EACnB,EAAE,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,KAAK,IAAI,GAC3C,IAAI;IAQP;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,OAAO,CAAC;IAI/B;;OAEG;IACG,WAAW,CACf,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,OAAO,CAAC;IAgBnB;;OAEG;IACG,kBAAkB,CACtB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,OAAO,CAAC;IAkBnB;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA2B5B;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;YA8Bb,QAAQ;CAMvB"}

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

@@ -0,0 +1,18 @@
+/**
+ * Метрики обработки одного обновления.
+ *
+ * Передаются в колбэк `BotConfig.onMetrics` после каждого обработанного update.
+ */
+export interface BotMetrics {
+    /** Тип обновления (`message_created`, `message_callback`, и т.д.) */
+    updateType: string;
+    /** Общее время обработки update в миллисекундах (middleware + handlers) */
+    totalMs: number;
+    /** Размер очереди семафора **до** захвата слота (число ожидающих updates) */
+    queueSizeAtStart: number;
+    /** Число ошибок, выброшенных handlers во время обработки этого update */
+    handlerErrors: number;
+    /** Время выполнения каждого middleware в миллисекундах (в порядке регистрации) */
+    middlewareTimes: number[];
+}
+//# sourceMappingURL=metrics.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../../../src/bot/metrics.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACzB,qEAAqE;IACrE,UAAU,EAAE,MAAM,CAAC;IACnB,2EAA2E;IAC3E,OAAO,EAAE,MAAM,CAAC;IAChB,6EAA6E;IAC7E,gBAAgB,EAAE,MAAM,CAAC;IACzB,yEAAyE;IACzE,aAAa,EAAE,MAAM,CAAC;IACtB,kFAAkF;IAClF,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B"}