@dementevdev/maxbot-ts 1.0.0

package/dist/esm/bot/context/CallbackContext.js

@@ -0,0 +1,154 @@
+/**
+ * Контекст callback-запроса (нажатие на inline-кнопку).
+ */
+export class CallbackContext {
+    update;
+    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 = null;
+    constructor(
+    // CallbackUpdate — не общий Update: типизация гарантирует наличие callback-полей
+    update, api) {
+        this.update = update;
+        this.api = api;
+    }
+    /** Исходное обновление */
+    get raw() {
+        return this.update;
+    }
+    /** ID callback-запроса */
+    get callbackId() {
+        return this.update.callback.callback_id;
+    }
+    /** Данные callback (payload кнопки) */
+    get data() {
+        return this.update.callback.payload ?? "";
+    }
+    /**
+     * Сообщение, к которому была прикреплена кнопка.
+     * Может отсутствовать, если сообщение было удалено к моменту callback.
+     */
+    get message() {
+        return this.update.message ?? null;
+    }
+    /** ID чата */
+    get chatId() {
+        return this.update.message?.recipient.chat_id ?? null;
+    }
+    /** Пользователь, нажавший кнопку — гарантировано присутствие API */
+    get callbackUser() {
+        return this.update.callback.user;
+    }
+    /** ID пользователя, нажавшего кнопку */
+    get userId() {
+        return this.update.callback.user.user_id;
+    }
+    /** Локаль пользователя */
+    get locale() {
+        return this.update.user_locale ?? null;
+    }
+    /**
+     * Ответить на callback.
+     *
+     * Закрывает "часики" на кнопке и опционально показывает уведомление.
+     */
+    async answer(options) {
+        await this.api.messages.answerCallback(this.callbackId, options);
+    }
+    /**
+     * Ответить сообщением в чат.
+     *
+     * Бросает ошибку, если chat_id недоступен — сообщение было удалено.
+     */
+    async reply(text, options) {
+        const chatId = this.chatId;
+        if (!chatId) {
+            throw new Error(`CallbackContext.reply: chat_id недоступен — сообщение удалено`);
+        }
+        const body = {
+            text,
+            format: options?.format,
+            attachments: options?.attachments,
+            notify: options?.notify,
+        };
+        const response = await this.api.messages.sendMessage({ chat_id: chatId, disable_link_preview: options?.disable_link_preview }, body);
+        return response.message;
+    }
+    /**
+     * Редактировать сообщение с кнопкой.
+     */
+    async editMessage(text, options) {
+        const body = {
+            text,
+            format: options?.format,
+            attachments: options?.attachments,
+        };
+        const messageId = this.message?.body?.mid;
+        if (!messageId) {
+            throw new Error("Невозможно редактировать сообщение без message_id");
+        }
+        await this.api.messages.editMessage(messageId, body);
+    }
+    /**
+     * Удалить сообщение с кнопкой.
+     *
+     * Бросает ошибку, если сообщение было удалено до callback.
+     *
+     * @example
+     * await ctx.deleteMessage();
+     */
+    async deleteMessage() {
+        const messageId = this.message?.body?.mid;
+        if (!messageId) {
+            throw new Error(`CallbackContext.deleteMessage: message_id недоступен — сообщение удалено`);
+        }
+        await this.api.messages.deleteMessage(messageId);
+    }
+    /**
+     * Отправить произвольное действие в чат.
+     *
+     * Распространённые значения: `"typing_on"`, `"sending_photo"`,
+     * `"sending_video"`, `"sending_audio"`, `"sending_file"`, `"mark_seen"`.
+     *
+     * Бросает ошибку, если chat_id недоступен — сообщение удалено.
+     *
+     * @example
+     * await ctx.sendAction('typing_on');
+     */
+    async sendAction(action) {
+        const chatId = this.chatId;
+        if (!chatId) {
+            throw new Error(`CallbackContext.sendAction: chat_id недоступен — сообщение удалено`);
+        }
+        await this.api.chats.sendAction(chatId, action);
+    }
+    /**
+     * Проверить тип контекста с сужением типа (type narrowing).
+     *
+     * @example
+     * ```ts
+     * bot.on('callback', async (ctx) => {
+     *   if (ctx.has(hasCallbackPayload('confirm'))) {
+     *     await ctx.answer({ notification: 'Подтверждено!' });
+     *   }
+     * });
+     * ```
+     */
+    has(filter) {
+        return filter(this);
+    }
+}
+//# sourceMappingURL=CallbackContext.js.map

package/dist/esm/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/esm/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/esm/bot/context/ChatContext.js

@@ -0,0 +1,48 @@
+/**
+ * Контекст системного события чата (bot_added, bot_removed, user_added, user_removed, chat_title_changed).
+ *
+ * Системные события не содержат message — для них неприменимы reply/send.
+ * Отдельный тип предотвращает runtime ошибки при обращении к message в MessageContext.
+ */
+export class ChatContext {
+    update;
+    constructor(
+    // ChatUpdate — не общий Update: типизация гарантирует chat_id и user
+    update) {
+        this.update = update;
+    }
+    /** Исходное обновление */
+    get raw() {
+        return this.update;
+    }
+    /** ID чата, в котором произошло событие */
+    get chatId() {
+        return this.update.chat_id;
+    }
+    /** Пользователь, инициировавший событие */
+    get user() {
+        return this.update.user;
+    }
+    /** ID пользователя */
+    get userId() {
+        return this.update.user.user_id;
+    }
+    /** Является ли чат каналом */
+    get isChannel() {
+        return this.update.is_channel ?? false;
+    }
+    /**
+     * Проверить тип контекста с сужением типа (type narrowing).
+     *
+     * @example
+     * ```ts
+     * bot.on('bot_added', async (ctx) => {
+     *   if (ctx.has(isPrivateChat)) { ... }
+     * });
+     * ```
+     */
+    has(filter) {
+        return filter(this);
+    }
+}
+//# sourceMappingURL=ChatContext.js.map

package/dist/esm/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/esm/bot/context/MessageContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MessageContext.d.ts","sourceRoot":"","sources":["../../../../src/bot/context/MessageContext.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,QAAQ,EACR,SAAS,EACT,YAAY,EACZ,iBAAiB,EACjB,WAAW,EACZ,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EACV,UAAU,EACV,OAAO,EACP,cAAc,EACf,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,EAAE,SAAS,CAAC;IACjB,QAAQ,EAAE,YAAY,CAAC;IACvB,aAAa,EAAE,iBAAiB,CAAC;IACjC,OAAO,EAAE,WAAW,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,EAAE,UAAU,GAAG,MAAM,CAAC;IAC7B,WAAW,CAAC,EAAE,cAAc,CAAC,aAAa,CAAC,CAAC;IAC5C,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC;AAED;;;;;GAKG;AACH,qBAAa,cAAc;IAmBvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,GAAG;IAnBtB;;;;;;;;;;;;;OAaG;IACH,KAAK,EAAE,eAAe,GAAG,IAAI,CAAQ;gBAIlB,MAAM,EAAE,aAAa,EACrB,GAAG,EAAE,UAAU;IAGlC,0BAA0B;IAC1B,IAAI,GAAG,IAAI,aAAa,CAEvB;IAED,gBAAgB;IAChB,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,sBAAsB;IACtB,IAAI,IAAI,IAAI,MAAM,GAAG,SAAS,CAE7B;IAED,6FAA6F;IAC7F,IAAI,SAAS,IAAI,MAAM,GAAG,IAAI,CAE7B;IAED,uCAAuC;IACvC,IAAI,MAAM,IAAI,MAAM,GAAG,IAAI,CAE1B;IAED,qBAAqB;IACrB,IAAI,QAAQ,IAAI,MAAM,GAAG,SAAS,CAEjC;IAED,sBAAsB;IACtB,IAAI,UAAU,IAAI,MAAM,GAAG,SAAS,CAQnC;IAED,2BAA2B;IAC3B,IAAI,cAAc,IAAI,MAAM,GAAG,IAAI,GAAG,SAAS,CAE9C;IAED,0BAA0B;IAC1B,IAAI,MAAM,IAAI,MAAM,GAAG,IAAI,CAE1B;IAED,eAAe;IACf,IAAI,QAAQ,IAAI,MAAM,GAAG,QAAQ,CAEhC;IAED,4BAA4B;IAC5B,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,8BAA8B;IAC9B,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,yBAAyB;IACzB,IAAI,WAAW,IAAI,UAAU,EAAE,GAAG,IAAI,CAErC;IAED;;;;OAIG;IACG,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC;IAsBlE;;;;OAIG;IACG,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC;IAiC3E;;;;OAIG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAIjC;;;;;;;;;;OAUG;IACG,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAU/C;;;;;;;OAOG;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;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,GAAG,CAAC,CAAC,SAAS,OAAO,EAAE,MAAM,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,GAAG,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC;CAGtE"}

package/dist/esm/bot/context/MessageContext.js

@@ -0,0 +1,224 @@
+/**
+ * Контекст сообщения.
+ *
+ * Оборачивает MessageUpdate и добавляет удобные методы для ответа.
+ * Избавляет разработчика от необходимости передавать chatId/userId в каждый метод.
+ */
+export class MessageContext {
+    update;
+    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 = null;
+    constructor(
+    // MessageUpdate — не общий Update: типизация гарантирует наличие поля message
+    update, api) {
+        this.update = update;
+        this.api = api;
+    }
+    /** Исходное обновление */
+    get raw() {
+        return this.update;
+    }
+    /** Сообщение */
+    get message() {
+        return this.update.message;
+    }
+    /** Текст сообщения */
+    get text() {
+        return this.message.body?.text;
+    }
+    /** ID сообщения. null если сообщение не содержит body (например, пересланное без текста). */
+    get messageId() {
+        return this.message.body?.mid ?? null;
+    }
+    /** ID чата (если сообщение из чата) */
+    get chatId() {
+        return this.message.recipient.chat_id;
+    }
+    /** ID отправителя */
+    get senderId() {
+        return this.message.sender?.user_id;
+    }
+    /** Имя отправителя */
+    get senderName() {
+        const sender = this.message.sender;
+        if (!sender)
+            return undefined;
+        if (sender.last_name) {
+            return `${sender.first_name} ${sender.last_name}`;
+        }
+        return sender.first_name;
+    }
+    /** Username отправителя */
+    get senderUsername() {
+        return this.message.sender?.username;
+    }
+    /** Локаль пользователя */
+    get locale() {
+        return this.update.user_locale ?? null;
+    }
+    /** Тип чата */
+    get chatType() {
+        return this.message.recipient.chat_type;
+    }
+    /** Это личное сообщение? */
+    get isPrivate() {
+        return this.chatType === "dialog";
+    }
+    /** Это сообщение в группе? */
+    get isGroup() {
+        return this.chatType === "chat";
+    }
+    /** Вложения сообщения */
+    get attachments() {
+        return this.message.body?.attachments ?? null;
+    }
+    /**
+     * Ответить на сообщение.
+     *
+     * Бросает ошибку, если chat_id недоступен — это защищает от молчаливого падения если message.recipient не содержит chat_id.
+     */
+    async reply(text, options) {
+        const chatId = this.chatId;
+        if (!chatId) {
+            throw new Error(`MessageContext.reply: chat_id недоступен для этого обновления`);
+        }
+        const body = {
+            text,
+            format: options?.format,
+            attachments: options?.attachments,
+            notify: options?.notify,
+        };
+        const response = await this.api.messages.sendMessage({ chat_id: chatId, disable_link_preview: options?.disable_link_preview }, body);
+        return response.message;
+    }
+    /**
+     * Ответить с цитированием исходного сообщения.
+     *
+     * Бросает ошибку, если chat_id или mid недоступны.
+     */
+    async replyWithQuote(text, options) {
+        const chatId = this.chatId;
+        if (!chatId) {
+            throw new Error(`MessageContext.replyWithQuote: chat_id недоступен для этого обновления`);
+        }
+        const mid = this.messageId;
+        if (!mid) {
+            throw new Error(`MessageContext.replyWithQuote: message_id недоступен — сообщение не содержит body`);
+        }
+        const body = {
+            text,
+            format: options?.format,
+            attachments: options?.attachments,
+            notify: options?.notify,
+            link: {
+                type: "reply",
+                mid,
+            },
+        };
+        const response = await this.api.messages.sendMessage({ chat_id: chatId, disable_link_preview: options?.disable_link_preview }, body);
+        return response.message;
+    }
+    /**
+     * Отправить действие "печатает..." в чат.
+     *
+     * Бросает ошибку, если chat_id недоступен — согласован со стилем reply().
+     */
+    async sendTyping() {
+        await this.sendAction("typing_on");
+    }
+    /**
+     * Отправить произвольное действие в чат.
+     *
+     * Распространённые значения: `"typing_on"`, `"sending_photo"`,
+     * `"sending_video"`, `"sending_audio"`, `"sending_file"`, `"mark_seen"`.
+     *
+     * Бросает ошибку, если chat_id недоступен.
+     *
+     * @example
+     * await ctx.sendAction('sending_photo');
+     */
+    async sendAction(action) {
+        const chatId = this.chatId;
+        if (!chatId) {
+            throw new Error(`MessageContext.sendAction: chat_id недоступен для этого обновления`);
+        }
+        await this.api.chats.sendAction(chatId, action);
+    }
+    /**
+     * Редактировать текущее сообщение.
+     *
+     * Бросает ошибку, если message_id недоступен.
+     *
+     * @example
+     * await ctx.editMessage('Обновлённый текст');
+     */
+    async editMessage(text, options) {
+        const mid = this.messageId;
+        if (!mid) {
+            throw new Error(`MessageContext.editMessage: message_id недоступен — сообщение не содержит body`);
+        }
+        const body = {
+            text,
+            format: options?.format,
+            attachments: options?.attachments,
+        };
+        await this.api.messages.editMessage(mid, body);
+    }
+    /**
+     * Удалить текущее сообщение.
+     *
+     * Бросает ошибку, если message_id недоступен.
+     *
+     * @example
+     * await ctx.deleteMessage();
+     */
+    async deleteMessage() {
+        const mid = this.messageId;
+        if (!mid) {
+            throw new Error(`MessageContext.deleteMessage: message_id недоступен — сообщение не содержит body`);
+        }
+        await this.api.messages.deleteMessage(mid);
+    }
+    /**
+     * Проверить тип контекста с сужением типа (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(filter) {
+        return filter(this);
+    }
+}
+//# sourceMappingURL=MessageContext.js.map