@mtcute/dispatcher 0.11.1 → 0.12.3

package/cjs/callback-data-builder.d.ts

@@ -1,4 +1,4 @@
-import { CallbackQuery, MaybeArray } from '@mtcute/core';
+import { CallbackQuery, MaybeArray, MaybePromise } from '@mtcute/core';
 import { UpdateFilter } from './filters/types.js';
 /**
  * Callback data builder, inspired by [aiogram](https://github.com/aiogram/aiogram).
@@ -31,13 +31,17 @@ export declare class CallbackDataBuilder<T extends string> {
     /**
      * Create a filter for this callback data.
      *
-     * > **Note**: `params` object will be compiled to a RegExp,
-     * > so avoid using characters that have special meaning in regex,
-     * > or use RegExp directly to let the IDE guide you.
+     * You can either pass an object with field names as keys and values as strings or regexes,
+     * which will be compiled to a RegExp, or a function that will be called with the parsed data.
+     * Note that the strings will be passed to `RegExp` **directly**, so you may want to escape them.
+     *
+     * When using a function, you can either return a boolean, or an object with field names as keys
+     * and values as strings or regexes. In the latter case, the resulting object will be matched
+     * against the parsed data the same way as if you passed it directly.
      *
      * @param params
      */
-    filter(params?: Partial<Record<T, MaybeArray<string | RegExp>>>): UpdateFilter<CallbackQuery, {
+    filter(params?: ((upd: CallbackQuery, parsed: Record<T, string>) => MaybePromise<Partial<Record<T, MaybeArray<string | RegExp>>> | boolean>) | Partial<Record<T, MaybeArray<string | RegExp>>>): UpdateFilter<CallbackQuery, {
         match: Record<T, string>;
     }>;
 }

package/cjs/callback-data-builder.js

@@ -67,13 +67,48 @@ class CallbackDataBuilder {
     /**
      * Create a filter for this callback data.
      *
-     * > **Note**: `params` object will be compiled to a RegExp,
-     * > so avoid using characters that have special meaning in regex,
-     * > or use RegExp directly to let the IDE guide you.
+     * You can either pass an object with field names as keys and values as strings or regexes,
+     * which will be compiled to a RegExp, or a function that will be called with the parsed data.
+     * Note that the strings will be passed to `RegExp` **directly**, so you may want to escape them.
+     *
+     * When using a function, you can either return a boolean, or an object with field names as keys
+     * and values as strings or regexes. In the latter case, the resulting object will be matched
+     * against the parsed data the same way as if you passed it directly.
      *
      * @param params
      */
     filter(params = {}) {
+        if (typeof params === 'function') {
+            return async (query) => {
+                if (!query.dataStr)
+                    return false;
+                const data = this.parse(query.dataStr);
+                const fnResult = await params(query, data);
+                if (typeof fnResult === 'boolean') {
+                    query.match = data;
+                    return fnResult;
+                }
+                // validate result
+                for (const key in fnResult) {
+                    const value = data[key];
+                    if (value === undefined)
+                        return false;
+                    let matchers = fnResult[key];
+                    if (!Array.isArray(matchers))
+                        matchers = [matchers];
+                    for (const matcher of matchers) {
+                        if (typeof matcher === 'string') {
+                            if (value !== matcher)
+                                return false;
+                        }
+                        else if (!matcher.test(value))
+                            return false;
+                    }
+                }
+                query.match = data;
+                return true;
+            };
+        }
         const parts = [];
         this._fields.forEach((field) => {
             if (!(field in params)) {

package/cjs/callback-data-builder.js.map

@@ -1 +1 @@
-{"version":3,"file":"callback-data-builder.js","sourceRoot":"","sources":["../../src/callback-data-builder.ts"],"names":[],"mappings":"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","sourcesContent":["import { CallbackQuery, MaybeArray, MtArgumentError } from '@mtcute/core'\n\nimport { UpdateFilter } from './filters/types.js'\n\n/**\n * Callback data builder, inspired by [aiogram](https://github.com/aiogram/aiogram).\n *\n * This can be used to simplify management of different callbacks.\n *\n * [Learn more in the docs](/guide/topics/keyboards.html#callback-data-builders)\n */\nexport class CallbackDataBuilder<T extends string> {\n    private readonly _fields: T[]\n\n    sep = ':'\n\n    /**\n     * @param prefix  Prefix for the data. Use something unique across your bot.\n     * @param fields  Field names in the order they will be serialized.\n     */\n    constructor(\n        public prefix: string,\n        ...fields: T[]\n    ) {\n        this._fields = fields\n    }\n\n    /**\n     * Build a callback data string\n     *\n     * @param obj  Object containing the data\n     */\n    build(obj: Record<T, string>): string {\n        const ret =\n            this.prefix +\n            this.sep +\n            this._fields\n                .map((f) => {\n                    const val = obj[f]\n\n                    if (val.includes(this.sep)) {\n                        throw new MtArgumentError(\n                            `Value for ${f} ${val} contains separator ${this.sep} and cannot be used.`,\n                        )\n                    }\n\n                    return val\n                })\n                .join(this.sep)\n\n        if (ret.length > 64) {\n            throw new MtArgumentError('Resulting callback data is too long.')\n        }\n\n        return ret\n    }\n\n    /**\n     * Parse callback data to object\n     *\n     * @param data  Callback data as string\n     */\n    parse(data: string): Record<T, string> {\n        const parts = data.split(this.sep)\n\n        if (parts[0] !== this.prefix) {\n            throw new MtArgumentError('Invalid data passed')\n        }\n\n        if (parts.length !== this._fields.length + 1) {\n            throw new MtArgumentError('Invalid data passed')\n        }\n\n        const ret = {} as Record<T, string>\n        parts.forEach((it, idx) => {\n            if (idx === 0) return // skip prefix\n\n            ret[this._fields[idx - 1]] = it\n        })\n\n        return ret\n    }\n\n    /**\n     * Create a filter for this callback data.\n     *\n     * > **Note**: `params` object will be compiled to a RegExp,\n     * > so avoid using characters that have special meaning in regex,\n     * > or use RegExp directly to let the IDE guide you.\n     *\n     * @param params\n     */\n    filter(params: Partial<Record<T, MaybeArray<string | RegExp>>> = {}): UpdateFilter<\n        CallbackQuery,\n        {\n            match: Record<T, string>\n        }\n    > {\n        const parts: string[] = []\n\n        this._fields.forEach((field) => {\n            if (!(field in params)) {\n                parts.push(`[^${this.sep}]*?`)\n\n                return\n            }\n\n            const value = params[field]\n\n            if (Array.isArray(value)) {\n                parts.push(`(${value.map((i) => (typeof i === 'string' ? i : i.source)).join('|')})`)\n            } else {\n                // noinspection SuspiciousTypeOfGuard\n                parts.push(typeof value === 'string' ? value : (value as RegExp).source)\n            }\n        })\n\n        const regex = new RegExp(`^${this.prefix}${this.sep}${parts.join(this.sep)}$`)\n\n        return (query) => {\n            const m = query.dataStr?.match(regex)\n            if (!m) return false\n            ;(\n                query as CallbackQuery & {\n                    match: Record<T, string>\n                }\n            ).match = this.parse(m[0])\n\n            return true\n        }\n    }\n}\n"]}
+{"version":3,"file":"callback-data-builder.js","sourceRoot":"","sources":["../../src/callback-data-builder.ts"],"names":[],"mappings":"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","sourcesContent":["import { CallbackQuery, MaybeArray, MaybePromise, MtArgumentError } from '@mtcute/core'\n\nimport { UpdateFilter } from './filters/types.js'\n\n/**\n * Callback data builder, inspired by [aiogram](https://github.com/aiogram/aiogram).\n *\n * This can be used to simplify management of different callbacks.\n *\n * [Learn more in the docs](/guide/topics/keyboards.html#callback-data-builders)\n */\nexport class CallbackDataBuilder<T extends string> {\n    private readonly _fields: T[]\n\n    sep = ':'\n\n    /**\n     * @param prefix  Prefix for the data. Use something unique across your bot.\n     * @param fields  Field names in the order they will be serialized.\n     */\n    constructor(\n        public prefix: string,\n        ...fields: T[]\n    ) {\n        this._fields = fields\n    }\n\n    /**\n     * Build a callback data string\n     *\n     * @param obj  Object containing the data\n     */\n    build(obj: Record<T, string>): string {\n        const ret =\n            this.prefix +\n            this.sep +\n            this._fields\n                .map((f) => {\n                    const val = obj[f]\n\n                    if (val.includes(this.sep)) {\n                        throw new MtArgumentError(\n                            `Value for ${f} ${val} contains separator ${this.sep} and cannot be used.`,\n                        )\n                    }\n\n                    return val\n                })\n                .join(this.sep)\n\n        if (ret.length > 64) {\n            throw new MtArgumentError('Resulting callback data is too long.')\n        }\n\n        return ret\n    }\n\n    /**\n     * Parse callback data to object\n     *\n     * @param data  Callback data as string\n     */\n    parse(data: string): Record<T, string> {\n        const parts = data.split(this.sep)\n\n        if (parts[0] !== this.prefix) {\n            throw new MtArgumentError('Invalid data passed')\n        }\n\n        if (parts.length !== this._fields.length + 1) {\n            throw new MtArgumentError('Invalid data passed')\n        }\n\n        const ret = {} as Record<T, string>\n        parts.forEach((it, idx) => {\n            if (idx === 0) return // skip prefix\n\n            ret[this._fields[idx - 1]] = it\n        })\n\n        return ret\n    }\n\n    /**\n     * Create a filter for this callback data.\n     *\n     * You can either pass an object with field names as keys and values as strings or regexes,\n     * which will be compiled to a RegExp, or a function that will be called with the parsed data.\n     * Note that the strings will be passed to `RegExp` **directly**, so you may want to escape them.\n     *\n     * When using a function, you can either return a boolean, or an object with field names as keys\n     * and values as strings or regexes. In the latter case, the resulting object will be matched\n     * against the parsed data the same way as if you passed it directly.\n     *\n     * @param params\n     */\n    filter(\n        params:\n            | ((\n                  upd: CallbackQuery,\n                  parsed: Record<T, string>,\n              ) => MaybePromise<Partial<Record<T, MaybeArray<string | RegExp>>> | boolean>)\n            | Partial<Record<T, MaybeArray<string | RegExp>>> = {},\n    ): UpdateFilter<\n        CallbackQuery,\n        {\n            match: Record<T, string>\n        }\n    > {\n        if (typeof params === 'function') {\n            return async (query) => {\n                if (!query.dataStr) return false\n\n                const data = this.parse(query.dataStr)\n                const fnResult = await params(query, data)\n\n                if (typeof fnResult === 'boolean') {\n                    (\n                        query as CallbackQuery & {\n                            match: Record<T, string>\n                        }\n                    ).match = data\n\n                    return fnResult\n                }\n\n                // validate result\n                for (const key in fnResult) {\n                    const value = data[key]\n                    if (value === undefined) return false\n\n                    let matchers = fnResult[key] as MaybeArray<string | RegExp>\n                    if (!Array.isArray(matchers)) matchers = [matchers]\n\n                    for (const matcher of matchers) {\n                        if (typeof matcher === 'string') {\n                            if (value !== matcher) return false\n                        } else if (!matcher.test(value)) return false\n                    }\n                }\n\n                (\n                    query as CallbackQuery & {\n                        match: Record<T, string>\n                    }\n                ).match = data\n\n                return true\n            }\n        }\n\n        const parts: string[] = []\n\n        this._fields.forEach((field) => {\n            if (!(field in params)) {\n                parts.push(`[^${this.sep}]*?`)\n\n                return\n            }\n\n            const value = params[field]\n\n            if (Array.isArray(value)) {\n                parts.push(`(${value.map((i) => (typeof i === 'string' ? i : i.source)).join('|')})`)\n            } else {\n                // noinspection SuspiciousTypeOfGuard\n                parts.push(typeof value === 'string' ? value : (value as RegExp).source)\n            }\n        })\n\n        const regex = new RegExp(`^${this.prefix}${this.sep}${parts.join(this.sep)}$`)\n\n        return (query) => {\n            const m = query.dataStr?.match(regex)\n            if (!m) return false\n            ;(\n                query as CallbackQuery & {\n                    match: Record<T, string>\n                }\n            ).match = this.parse(m[0])\n\n            return true\n        }\n    }\n}\n"]}

package/cjs/context/business-message.d.ts

@@ -0,0 +1,60 @@
+import { BusinessMessage, OmitInputMessageId, ParametersSkip1 } from '@mtcute/core';
+import { TelegramClient } from '@mtcute/core/client.js';
+import { DeleteMessagesParams, ForwardMessageOptions, SendCopyGroupParams, SendCopyParams } from '@mtcute/core/methods.js';
+import { UpdateContext } from './base.js';
+/**
+ * Context of a business message related update.
+ *
+ * This is a subclass of {@link BusinessMessage}, so all fields
+ * of the message are available.
+ *
+ * For message groups, own fields are related to the last message
+ * in the group. To access all messages, use {@link BusinessMessageContext#messages}.
+ */
+export declare class BusinessMessageContext extends BusinessMessage implements UpdateContext<BusinessMessage> {
+    readonly client: TelegramClient;
+    readonly _name = "new_business_message";
+    /**
+     * List of messages in the message group.
+     *
+     * For other updates, this is a list with a single element (`this`).
+     */
+    readonly messages: BusinessMessageContext[];
+    /** Whether this update is about a message group */
+    readonly isMessageGroup: boolean;
+    constructor(client: TelegramClient, message: BusinessMessage | BusinessMessage[]);
+    /** Get all custom emojis contained in this message (message group), if any */
+    getCustomEmojis(): Promise<import("@mtcute/core").Sticker[]>;
+    /** Send a text message to the same chat (and topic, if applicable) as a given message */
+    answerText(...params: ParametersSkip1<TelegramClient['answerText']>): Promise<import("@mtcute/core").Message>;
+    /** Send a media to the same chat (and topic, if applicable) as a given message */
+    answerMedia(...params: ParametersSkip1<TelegramClient['answerMedia']>): Promise<import("@mtcute/core").Message>;
+    /** Send a media group to the same chat (and topic, if applicable) as a given message */
+    answerMediaGroup(...params: ParametersSkip1<TelegramClient['answerMediaGroup']>): Promise<import("@mtcute/core").Message[]>;
+    /** Send a text message in reply to this message */
+    replyText(...params: ParametersSkip1<TelegramClient['replyText']>): Promise<import("@mtcute/core").Message>;
+    /** Send a media in reply to this message */
+    replyMedia(...params: ParametersSkip1<TelegramClient['replyMedia']>): Promise<import("@mtcute/core").Message>;
+    /** Send a media group in reply to this message */
+    replyMediaGroup(...params: ParametersSkip1<TelegramClient['replyMediaGroup']>): Promise<import("@mtcute/core").Message[]>;
+    /** Send a text message in reply to this message */
+    quoteWithText(params: Parameters<TelegramClient['quoteWithText']>[1]): Promise<import("@mtcute/core").Message>;
+    /** Send a media in reply to this message */
+    quoteWithMedia(params: Parameters<TelegramClient['quoteWithMedia']>[1]): Promise<import("@mtcute/core").Message>;
+    /** Send a media group in reply to this message */
+    quoteWithMediaGroup(params: Parameters<TelegramClient['quoteWithMediaGroup']>[1]): Promise<import("@mtcute/core").Message[]>;
+    /** Delete this message (message group) */
+    delete(params?: DeleteMessagesParams): Promise<void>;
+    /** Pin this message */
+    pin(params?: OmitInputMessageId<Parameters<TelegramClient['pinMessage']>[0]>): Promise<import("@mtcute/core").Message | null>;
+    /** Unpin this message */
+    unpin(): Promise<void>;
+    /** Edit this message */
+    edit(params: OmitInputMessageId<Parameters<TelegramClient['editMessage']>[0]>): Promise<import("@mtcute/core").Message>;
+    /** Forward this message (message group) */
+    forwardTo(params: ForwardMessageOptions): Promise<import("@mtcute/core").Message[]>;
+    /** Send a copy of this message (message group) */
+    copy(params: SendCopyParams & SendCopyGroupParams): Promise<import("@mtcute/core").Message> | Promise<import("@mtcute/core").Message[]>;
+    /** React to this message */
+    react(params: OmitInputMessageId<Parameters<TelegramClient['sendReaction']>[0]>): Promise<import("@mtcute/core").Message | null>;
+}

package/cjs/context/business-message.js

@@ -0,0 +1,146 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BusinessMessageContext = void 0;
+const core_1 = require("@mtcute/core");
+/**
+ * Context of a business message related update.
+ *
+ * This is a subclass of {@link BusinessMessage}, so all fields
+ * of the message are available.
+ *
+ * For message groups, own fields are related to the last message
+ * in the group. To access all messages, use {@link BusinessMessageContext#messages}.
+ */
+class BusinessMessageContext extends core_1.BusinessMessage {
+    client;
+    // this is primarily for proper types in filters, so don't bother much with actual value
+    _name = 'new_business_message';
+    /**
+     * List of messages in the message group.
+     *
+     * For other updates, this is a list with a single element (`this`).
+     */
+    messages;
+    /** Whether this update is about a message group */
+    isMessageGroup;
+    constructor(client, message) {
+        const msg = Array.isArray(message) ? message[message.length - 1] : message;
+        super(msg.update, msg._peers);
+        this.client = client;
+        this.messages = Array.isArray(message) ? message.map((it) => new BusinessMessageContext(client, it)) : [this];
+        this.isMessageGroup = Array.isArray(message);
+    }
+    /** Get all custom emojis contained in this message (message group), if any */
+    getCustomEmojis() {
+        return this.client.getCustomEmojisFromMessages(this.messages);
+    }
+    /** Send a text message to the same chat (and topic, if applicable) as a given message */
+    answerText(...params) {
+        const [send, params_ = {}] = params;
+        params_.businessConnectionId = this.update.connectionId;
+        return this.client.answerText(this, send, params_);
+    }
+    /** Send a media to the same chat (and topic, if applicable) as a given message */
+    answerMedia(...params) {
+        const [send, params_ = {}] = params;
+        params_.businessConnectionId = this.update.connectionId;
+        return this.client.answerMedia(this, send, params_);
+    }
+    /** Send a media group to the same chat (and topic, if applicable) as a given message */
+    answerMediaGroup(...params) {
+        const [send, params_ = {}] = params;
+        params_.businessConnectionId = this.update.connectionId;
+        return this.client.answerMediaGroup(this, send, params_);
+    }
+    /** Send a text message in reply to this message */
+    replyText(...params) {
+        const [send, params_ = {}] = params;
+        params_.businessConnectionId = this.update.connectionId;
+        return this.client.replyText(this, send, params_);
+    }
+    /** Send a media in reply to this message */
+    replyMedia(...params) {
+        const [send, params_ = {}] = params;
+        params_.businessConnectionId = this.update.connectionId;
+        return this.client.replyMedia(this, send, params_);
+    }
+    /** Send a media group in reply to this message */
+    replyMediaGroup(...params) {
+        const [send, params_ = {}] = params;
+        params_.businessConnectionId = this.update.connectionId;
+        return this.client.replyMediaGroup(this, send, params_);
+    }
+    /** Send a text message in reply to this message */
+    quoteWithText(params) {
+        params.businessConnectionId = this.update.connectionId;
+        return this.client.quoteWithText(this, params);
+    }
+    /** Send a media in reply to this message */
+    quoteWithMedia(params) {
+        params.businessConnectionId = this.update.connectionId;
+        return this.client.quoteWithMedia(this, params);
+    }
+    /** Send a media group in reply to this message */
+    quoteWithMediaGroup(params) {
+        params.businessConnectionId = this.update.connectionId;
+        return this.client.quoteWithMediaGroup(this, params);
+    }
+    /** Delete this message (message group) */
+    delete(params) {
+        return this.client.deleteMessagesById(this.chat.inputPeer, this.messages.map((it) => it.id), params);
+    }
+    /** Pin this message */
+    pin(params) {
+        return this.client.pinMessage({
+            chatId: this.chat.inputPeer,
+            message: this.id,
+            ...params,
+        });
+    }
+    /** Unpin this message */
+    unpin() {
+        return this.client.unpinMessage({
+            chatId: this.chat.inputPeer,
+            message: this.id,
+        });
+    }
+    /** Edit this message */
+    edit(params) {
+        return this.client.editMessage({
+            chatId: this.chat.inputPeer,
+            message: this.id,
+            ...params,
+        });
+    }
+    /** Forward this message (message group) */
+    forwardTo(params) {
+        return this.client.forwardMessagesById({
+            fromChatId: this.chat.inputPeer,
+            messages: this.messages.map((it) => it.id),
+            ...params,
+        });
+    }
+    /** Send a copy of this message (message group) */
+    copy(params) {
+        if (this.isMessageGroup) {
+            return this.client.sendCopyGroup({
+                messages: this.messages,
+                ...params,
+            });
+        }
+        return this.client.sendCopy({
+            message: this,
+            ...params,
+        });
+    }
+    /** React to this message */
+    react(params) {
+        return this.client.sendReaction({
+            chatId: this.chat.inputPeer,
+            message: this.id,
+            ...params,
+        });
+    }
+}
+exports.BusinessMessageContext = BusinessMessageContext;
+//# sourceMappingURL=business-message.js.map

package/cjs/context/business-message.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"business-message.js","sourceRoot":"","sources":["../../../src/context/business-message.ts"],"names":[],"mappings":";;;AAAA,uCAAmF;AAWnF;;;;;;;;GAQG;AACH,MAAa,sBAAuB,SAAQ,sBAAe;IAe1C;IAdb,wFAAwF;IAC/E,KAAK,GAAG,sBAAsB,CAAA;IAEvC;;;;OAIG;IACM,QAAQ,CAA0B;IAE3C,mDAAmD;IAC1C,cAAc,CAAS;IAEhC,YACa,MAAsB,EAC/B,OAA4C;QAE5C,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAA;QAC1E,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;QAJpB,WAAM,GAAN,MAAM,CAAgB;QAM/B,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,sBAAsB,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAA;QAC7G,IAAI,CAAC,cAAc,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;IAChD,CAAC;IAED,8EAA8E;IAC9E,eAAe;QACX,OAAO,IAAI,CAAC,MAAM,CAAC,2BAA2B,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;IACjE,CAAC;IAED,yFAAyF;IACzF,UAAU,CAAC,GAAG,MAAqD;QAC/D,MAAM,CAAC,IAAI,EAAE,OAAO,GAAG,EAAE,CAAC,GAAG,MAAM,CAAA;QACnC,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,MAAM,CAAC,YAAY,CAAA;QAEvD,OAAO,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,CAAA;IACtD,CAAC;IAED,kFAAkF;IAClF,WAAW,CAAC,GAAG,MAAsD;QACjE,MAAM,CAAC,IAAI,EAAE,OAAO,GAAG,EAAE,CAAC,GAAG,MAAM,CAAA;QACnC,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,MAAM,CAAC,YAAY,CAAA;QAEvD,OAAO,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,CAAA;IACvD,CAAC;IAED,wFAAwF;IACxF,gBAAgB,CAAC,GAAG,MAA2D;QAC3E,MAAM,CAAC,IAAI,EAAE,OAAO,GAAG,EAAE,CAAC,GAAG,MAAM,CAAA;QACnC,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,MAAM,CAAC,YAAY,CAAA;QAEvD,OAAO,IAAI,CAAC,MAAM,CAAC,gBAAgB,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,CAAA;IAC5D,CAAC;IAED,mDAAmD;IACnD,SAAS,CAAC,GAAG,MAAoD;QAC7D,MAAM,CAAC,IAAI,EAAE,OAAO,GAAG,EAAE,CAAC,GAAG,MAAM,CAAA;QACnC,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,MAAM,CAAC,YAAY,CAAA;QAEvD,OAAO,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,CAAA;IACrD,CAAC;IAED,4CAA4C;IAC5C,UAAU,CAAC,GAAG,MAAqD;QAC/D,MAAM,CAAC,IAAI,EAAE,OAAO,GAAG,EAAE,CAAC,GAAG,MAAM,CAAA;QACnC,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,MAAM,CAAC,YAAY,CAAA;QAEvD,OAAO,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,CAAA;IACtD,CAAC;IAED,kDAAkD;IAClD,eAAe,CAAC,GAAG,MAA0D;QACzE,MAAM,CAAC,IAAI,EAAE,OAAO,GAAG,EAAE,CAAC,GAAG,MAAM,CAAA;QACnC,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,MAAM,CAAC,YAAY,CAAA;QAEvD,OAAO,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,CAAA;IAC3D,CAAC;IAED,mDAAmD;IACnD,aAAa,CAAC,MAAsD;QAChE,MAAM,CAAC,oBAAoB,GAAG,IAAI,CAAC,MAAM,CAAC,YAAY,CAAA;QAEtD,OAAO,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;IAClD,CAAC;IAED,4CAA4C;IAC5C,cAAc,CAAC,MAAuD;QAClE,MAAM,CAAC,oBAAoB,GAAG,IAAI,CAAC,MAAM,CAAC,YAAY,CAAA;QAEtD,OAAO,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;IACnD,CAAC;IAED,kDAAkD;IAClD,mBAAmB,CAAC,MAA4D;QAC5E,MAAM,CAAC,oBAAoB,GAAG,IAAI,CAAC,MAAM,CAAC,YAAY,CAAA;QAEtD,OAAO,IAAI,CAAC,MAAM,CAAC,mBAAmB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;IACxD,CAAC;IAED,0CAA0C;IAC1C,MAAM,CAAC,MAA6B;QAChC,OAAO,IAAI,CAAC,MAAM,CAAC,kBAAkB,CACjC,IAAI,CAAC,IAAI,CAAC,SAAS,EACnB,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAChC,MAAM,CACT,CAAA;IACL,CAAC;IAED,uBAAuB;IACvB,GAAG,CAAC,MAAwE;QACxE,OAAO,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC;YAC1B,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS;YAC3B,OAAO,EAAE,IAAI,CAAC,EAAE;YAChB,GAAG,MAAM;SACZ,CAAC,CAAA;IACN,CAAC;IAED,yBAAyB;IACzB,KAAK;QACD,OAAO,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC;YAC5B,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS;YAC3B,OAAO,EAAE,IAAI,CAAC,EAAE;SACnB,CAAC,CAAA;IACN,CAAC;IAED,wBAAwB;IACxB,IAAI,CAAC,MAAwE;QACzE,OAAO,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC;YAC3B,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS;YAC3B,OAAO,EAAE,IAAI,CAAC,EAAE;YAChB,GAAG,MAAM;SACZ,CAAC,CAAA;IACN,CAAC;IAED,2CAA2C;IAC3C,SAAS,CAAC,MAA6B;QACnC,OAAO,IAAI,CAAC,MAAM,CAAC,mBAAmB,CAAC;YACnC,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS;YAC/B,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;YAC1C,GAAG,MAAM;SACZ,CAAC,CAAA;IACN,CAAC;IAED,kDAAkD;IAClD,IAAI,CAAC,MAA4C;QAC7C,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YACtB,OAAO,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC;gBAC7B,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,GAAG,MAAM;aACZ,CAAC,CAAA;QACN,CAAC;QAED,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC;YACxB,OAAO,EAAE,IAAI;YACb,GAAG,MAAM;SACZ,CAAC,CAAA;IACN,CAAC;IAED,4BAA4B;IAC5B,KAAK,CAAC,MAAyE;QAC3E,OAAO,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC;YAC5B,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS;YAC3B,OAAO,EAAE,IAAI,CAAC,EAAE;YAChB,GAAG,MAAM;SACZ,CAAC,CAAA;IACN,CAAC;CACJ;AAtKD,wDAsKC","sourcesContent":["import { BusinessMessage, OmitInputMessageId, ParametersSkip1 } from '@mtcute/core'\nimport { TelegramClient } from '@mtcute/core/client.js'\nimport {\n    DeleteMessagesParams,\n    ForwardMessageOptions,\n    SendCopyGroupParams,\n    SendCopyParams,\n} from '@mtcute/core/methods.js'\n\nimport { UpdateContext } from './base.js'\n\n/**\n * Context of a business message related update.\n *\n * This is a subclass of {@link BusinessMessage}, so all fields\n * of the message are available.\n *\n * For message groups, own fields are related to the last message\n * in the group. To access all messages, use {@link BusinessMessageContext#messages}.\n */\nexport class BusinessMessageContext extends BusinessMessage implements UpdateContext<BusinessMessage> {\n    // this is primarily for proper types in filters, so don't bother much with actual value\n    readonly _name = 'new_business_message'\n\n    /**\n     * List of messages in the message group.\n     *\n     * For other updates, this is a list with a single element (`this`).\n     */\n    readonly messages: BusinessMessageContext[]\n\n    /** Whether this update is about a message group */\n    readonly isMessageGroup: boolean\n\n    constructor(\n        readonly client: TelegramClient,\n        message: BusinessMessage | BusinessMessage[],\n    ) {\n        const msg = Array.isArray(message) ? message[message.length - 1] : message\n        super(msg.update, msg._peers)\n\n        this.messages = Array.isArray(message) ? message.map((it) => new BusinessMessageContext(client, it)) : [this]\n        this.isMessageGroup = Array.isArray(message)\n    }\n\n    /** Get all custom emojis contained in this message (message group), if any */\n    getCustomEmojis() {\n        return this.client.getCustomEmojisFromMessages(this.messages)\n    }\n\n    /** Send a text message to the same chat (and topic, if applicable) as a given message */\n    answerText(...params: ParametersSkip1<TelegramClient['answerText']>) {\n        const [send, params_ = {}] = params\n        params_.businessConnectionId = this.update.connectionId\n\n        return this.client.answerText(this, send, params_)\n    }\n\n    /** Send a media to the same chat (and topic, if applicable) as a given message */\n    answerMedia(...params: ParametersSkip1<TelegramClient['answerMedia']>) {\n        const [send, params_ = {}] = params\n        params_.businessConnectionId = this.update.connectionId\n\n        return this.client.answerMedia(this, send, params_)\n    }\n\n    /** Send a media group to the same chat (and topic, if applicable) as a given message */\n    answerMediaGroup(...params: ParametersSkip1<TelegramClient['answerMediaGroup']>) {\n        const [send, params_ = {}] = params\n        params_.businessConnectionId = this.update.connectionId\n\n        return this.client.answerMediaGroup(this, send, params_)\n    }\n\n    /** Send a text message in reply to this message */\n    replyText(...params: ParametersSkip1<TelegramClient['replyText']>) {\n        const [send, params_ = {}] = params\n        params_.businessConnectionId = this.update.connectionId\n\n        return this.client.replyText(this, send, params_)\n    }\n\n    /** Send a media in reply to this message */\n    replyMedia(...params: ParametersSkip1<TelegramClient['replyMedia']>) {\n        const [send, params_ = {}] = params\n        params_.businessConnectionId = this.update.connectionId\n\n        return this.client.replyMedia(this, send, params_)\n    }\n\n    /** Send a media group in reply to this message */\n    replyMediaGroup(...params: ParametersSkip1<TelegramClient['replyMediaGroup']>) {\n        const [send, params_ = {}] = params\n        params_.businessConnectionId = this.update.connectionId\n\n        return this.client.replyMediaGroup(this, send, params_)\n    }\n\n    /** Send a text message in reply to this message */\n    quoteWithText(params: Parameters<TelegramClient['quoteWithText']>[1]) {\n        params.businessConnectionId = this.update.connectionId\n\n        return this.client.quoteWithText(this, params)\n    }\n\n    /** Send a media in reply to this message */\n    quoteWithMedia(params: Parameters<TelegramClient['quoteWithMedia']>[1]) {\n        params.businessConnectionId = this.update.connectionId\n\n        return this.client.quoteWithMedia(this, params)\n    }\n\n    /** Send a media group in reply to this message */\n    quoteWithMediaGroup(params: Parameters<TelegramClient['quoteWithMediaGroup']>[1]) {\n        params.businessConnectionId = this.update.connectionId\n\n        return this.client.quoteWithMediaGroup(this, params)\n    }\n\n    /** Delete this message (message group) */\n    delete(params?: DeleteMessagesParams) {\n        return this.client.deleteMessagesById(\n            this.chat.inputPeer,\n            this.messages.map((it) => it.id),\n            params,\n        )\n    }\n\n    /** Pin this message */\n    pin(params?: OmitInputMessageId<Parameters<TelegramClient['pinMessage']>[0]>) {\n        return this.client.pinMessage({\n            chatId: this.chat.inputPeer,\n            message: this.id,\n            ...params,\n        })\n    }\n\n    /** Unpin this message */\n    unpin() {\n        return this.client.unpinMessage({\n            chatId: this.chat.inputPeer,\n            message: this.id,\n        })\n    }\n\n    /** Edit this message */\n    edit(params: OmitInputMessageId<Parameters<TelegramClient['editMessage']>[0]>) {\n        return this.client.editMessage({\n            chatId: this.chat.inputPeer,\n            message: this.id,\n            ...params,\n        })\n    }\n\n    /** Forward this message (message group) */\n    forwardTo(params: ForwardMessageOptions) {\n        return this.client.forwardMessagesById({\n            fromChatId: this.chat.inputPeer,\n            messages: this.messages.map((it) => it.id),\n            ...params,\n        })\n    }\n\n    /** Send a copy of this message (message group) */\n    copy(params: SendCopyParams & SendCopyGroupParams) {\n        if (this.isMessageGroup) {\n            return this.client.sendCopyGroup({\n                messages: this.messages,\n                ...params,\n            })\n        }\n\n        return this.client.sendCopy({\n            message: this,\n            ...params,\n        })\n    }\n\n    /** React to this message */\n    react(params: OmitInputMessageId<Parameters<TelegramClient['sendReaction']>[0]>) {\n        return this.client.sendReaction({\n            chatId: this.chat.inputPeer,\n            message: this.id,\n            ...params,\n        })\n    }\n}\n"]}

package/cjs/context/parse.d.ts

@@ -1 +1,13 @@
+import { ParsedUpdate } from '@mtcute/core';
+import { TelegramClient } from '@mtcute/core/client.js';
+import { UpdateContextDistributed } from './base.js';
+import { BusinessMessageContext } from './business-message.js';
+import { CallbackQueryContext } from './callback-query.js';
+import { ChatJoinRequestUpdateContext } from './chat-join-request.js';
+import { ChosenInlineResultContext } from './chosen-inline-result.js';
+import { InlineQueryContext } from './inline-query.js';
+import { MessageContext } from './message.js';
+import { PreCheckoutQueryContext } from './pre-checkout-query.js';
+/** @internal */
+export declare function _parsedUpdateToContext(client: TelegramClient, update: ParsedUpdate): BusinessMessageContext | CallbackQueryContext | ChatJoinRequestUpdateContext | ChosenInlineResultContext | InlineQueryContext | MessageContext | PreCheckoutQueryContext | UpdateContextDistributed<import("@mtcute/core").DeleteMessageUpdate | import("@mtcute/core").ChatMemberUpdate | import("@mtcute/core").InlineCallbackQuery | import("@mtcute/core").PollUpdate | import("@mtcute/core").PollVoteUpdate | import("@mtcute/core").UserStatusUpdate | import("@mtcute/core").UserTypingUpdate | import("@mtcute/core").HistoryReadUpdate | import("@mtcute/core").BotStoppedUpdate | import("@mtcute/core").ChatJoinRequestUpdate | import("@mtcute/core").StoryUpdate | import("@mtcute/core").DeleteStoryUpdate | import("@mtcute/core").BotReactionUpdate | import("@mtcute/core").BotReactionCountUpdate | import("@mtcute/core").BusinessConnection | import("@mtcute/core").DeleteBusinessMessageUpdate>;
 export type UpdateContextType = ReturnType<typeof _parsedUpdateToContext>;

package/cjs/context/parse.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports._parsedUpdateToContext = void 0;
+const business_message_js_1 = require("./business-message.js");
 const callback_query_js_1 = require("./callback-query.js");
 const chat_join_request_js_1 = require("./chat-join-request.js");
 const chosen_inline_result_js_1 = require("./chosen-inline-result.js");
@@ -24,6 +25,10 @@ function _parsedUpdateToContext(client, update) {
             return new chat_join_request_js_1.ChatJoinRequestUpdateContext(client, update.data);
         case 'pre_checkout_query':
             return new pre_checkout_query_js_1.PreCheckoutQueryContext(client, update.data);
+        case 'new_business_message':
+        case 'edit_business_message':
+        case 'business_message_group':
+            return new business_message_js_1.BusinessMessageContext(client, update.data);
     }
     const _update = update.data;
     _update.client = client;

package/cjs/context/parse.js.map

@@ -1 +1 @@
-{"version":3,"file":"parse.js","sourceRoot":"","sources":["../../../src/context/parse.ts"],"names":[],"mappings":";;;AAIA,2DAA0D;AAC1D,iEAAqE;AACrE,uEAAqE;AACrE,uDAAsD;AACtD,6CAA6C;AAC7C,mEAAiE;AAEjE,gBAAgB;AAChB,SAAgB,sBAAsB,CAAC,MAAsB,EAAE,MAAoB;IAC/E,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;QAClB,KAAK,aAAa,CAAC;QACnB,KAAK,cAAc,CAAC;QACpB,KAAK,eAAe;YAChB,OAAO,IAAI,2BAAc,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,CAAA;QAClD,KAAK,cAAc;YACf,OAAO,IAAI,oCAAkB,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,CAAA;QACtD,KAAK,sBAAsB;YACvB,OAAO,IAAI,mDAAyB,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,CAAA;QAC7D,KAAK,gBAAgB;YACjB,OAAO,IAAI,wCAAoB,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,CAAA;QACxD,KAAK,uBAAuB;YACxB,OAAO,IAAI,mDAA4B,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,CAAA;QAChE,KAAK,oBAAoB;YACrB,OAAO,IAAI,+CAAuB,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,CAAA;IAC/D,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,CAAC,IAAoD,CAAA;IAC3E,OAAO,CAAC,MAAM,GAAG,MAAM,CAAA;IACvB,OAAO,CAAC,KAAK,GAAG,MAAM,CAAC,IAAI,CAAA;IAE3B,OAAO,OAAO,CAAA;AAClB,CAAC;AAvBD,wDAuBC","sourcesContent":["import { ParsedUpdate } from '@mtcute/core'\nimport { TelegramClient } from '@mtcute/core/client.js'\n\nimport { UpdateContextDistributed } from './base.js'\nimport { CallbackQueryContext } from './callback-query.js'\nimport { ChatJoinRequestUpdateContext } from './chat-join-request.js'\nimport { ChosenInlineResultContext } from './chosen-inline-result.js'\nimport { InlineQueryContext } from './inline-query.js'\nimport { MessageContext } from './message.js'\nimport { PreCheckoutQueryContext } from './pre-checkout-query.js'\n\n/** @internal */\nexport function _parsedUpdateToContext(client: TelegramClient, update: ParsedUpdate) {\n    switch (update.name) {\n        case 'new_message':\n        case 'edit_message':\n        case 'message_group':\n            return new MessageContext(client, update.data)\n        case 'inline_query':\n            return new InlineQueryContext(client, update.data)\n        case 'chosen_inline_result':\n            return new ChosenInlineResultContext(client, update.data)\n        case 'callback_query':\n            return new CallbackQueryContext(client, update.data)\n        case 'bot_chat_join_request':\n            return new ChatJoinRequestUpdateContext(client, update.data)\n        case 'pre_checkout_query':\n            return new PreCheckoutQueryContext(client, update.data)\n    }\n\n    const _update = update.data as UpdateContextDistributed<typeof update.data>\n    _update.client = client\n    _update._name = update.name\n\n    return _update\n}\n\nexport type UpdateContextType = ReturnType<typeof _parsedUpdateToContext>\n"]}
+{"version":3,"file":"parse.js","sourceRoot":"","sources":["../../../src/context/parse.ts"],"names":[],"mappings":";;;AAIA,+DAA8D;AAC9D,2DAA0D;AAC1D,iEAAqE;AACrE,uEAAqE;AACrE,uDAAsD;AACtD,6CAA6C;AAC7C,mEAAiE;AAEjE,gBAAgB;AAChB,SAAgB,sBAAsB,CAAC,MAAsB,EAAE,MAAoB;IAC/E,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;QAClB,KAAK,aAAa,CAAC;QACnB,KAAK,cAAc,CAAC;QACpB,KAAK,eAAe;YAChB,OAAO,IAAI,2BAAc,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,CAAA;QAClD,KAAK,cAAc;YACf,OAAO,IAAI,oCAAkB,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,CAAA;QACtD,KAAK,sBAAsB;YACvB,OAAO,IAAI,mDAAyB,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,CAAA;QAC7D,KAAK,gBAAgB;YACjB,OAAO,IAAI,wCAAoB,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,CAAA;QACxD,KAAK,uBAAuB;YACxB,OAAO,IAAI,mDAA4B,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,CAAA;QAChE,KAAK,oBAAoB;YACrB,OAAO,IAAI,+CAAuB,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,CAAA;QAC3D,KAAK,sBAAsB,CAAC;QAC5B,KAAK,uBAAuB,CAAC;QAC7B,KAAK,wBAAwB;YACzB,OAAO,IAAI,4CAAsB,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,CAAA;IAC9D,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,CAAC,IAAoD,CAAA;IAC3E,OAAO,CAAC,MAAM,GAAG,MAAM,CAAA;IACvB,OAAO,CAAC,KAAK,GAAG,MAAM,CAAC,IAAI,CAAA;IAE3B,OAAO,OAAO,CAAA;AAClB,CAAC;AA3BD,wDA2BC","sourcesContent":["import { ParsedUpdate } from '@mtcute/core'\nimport { TelegramClient } from '@mtcute/core/client.js'\n\nimport { UpdateContextDistributed } from './base.js'\nimport { BusinessMessageContext } from './business-message.js'\nimport { CallbackQueryContext } from './callback-query.js'\nimport { ChatJoinRequestUpdateContext } from './chat-join-request.js'\nimport { ChosenInlineResultContext } from './chosen-inline-result.js'\nimport { InlineQueryContext } from './inline-query.js'\nimport { MessageContext } from './message.js'\nimport { PreCheckoutQueryContext } from './pre-checkout-query.js'\n\n/** @internal */\nexport function _parsedUpdateToContext(client: TelegramClient, update: ParsedUpdate) {\n    switch (update.name) {\n        case 'new_message':\n        case 'edit_message':\n        case 'message_group':\n            return new MessageContext(client, update.data)\n        case 'inline_query':\n            return new InlineQueryContext(client, update.data)\n        case 'chosen_inline_result':\n            return new ChosenInlineResultContext(client, update.data)\n        case 'callback_query':\n            return new CallbackQueryContext(client, update.data)\n        case 'bot_chat_join_request':\n            return new ChatJoinRequestUpdateContext(client, update.data)\n        case 'pre_checkout_query':\n            return new PreCheckoutQueryContext(client, update.data)\n        case 'new_business_message':\n        case 'edit_business_message':\n        case 'business_message_group':\n            return new BusinessMessageContext(client, update.data)\n    }\n\n    const _update = update.data as UpdateContextDistributed<typeof update.data>\n    _update.client = client\n    _update._name = update.name\n\n    return _update\n}\n\nexport type UpdateContextType = ReturnType<typeof _parsedUpdateToContext>\n"]}

package/cjs/dispatcher.d.ts

@@ -1,9 +1,10 @@
-import { BotReactionCountUpdate, BotReactionUpdate, BotStoppedUpdate, ChatJoinRequestUpdate, ChatMemberUpdate, DeleteMessageUpdate, DeleteStoryUpdate, HistoryReadUpdate, MaybePromise, ParsedUpdate, PeersIndex, PollUpdate, PollVoteUpdate, StoryUpdate, tl, UserStatusUpdate, UserTypingUpdate } from '@mtcute/core';
+import { BotReactionCountUpdate, BotReactionUpdate, BotStoppedUpdate, BusinessConnection, ChatJoinRequestUpdate, ChatMemberUpdate, DeleteBusinessMessageUpdate, DeleteMessageUpdate, DeleteStoryUpdate, HistoryReadUpdate, MaybePromise, ParsedUpdate, PeersIndex, PollUpdate, PollVoteUpdate, StoryUpdate, tl, UserStatusUpdate, UserTypingUpdate } from '@mtcute/core';
 import { TelegramClient } from '@mtcute/core/client.js';
 import { UpdateContext } from './context/base.js';
+import { BusinessMessageContext } from './context/business-message.js';
 import { CallbackQueryContext, ChatJoinRequestUpdateContext, ChosenInlineResultContext, InlineCallbackQueryContext, InlineQueryContext, MessageContext, PreCheckoutQueryContext } from './context/index.js';
 import { filters, UpdateFilter } from './filters/index.js';
-import { BotChatJoinRequestHandler, BotReactionCountUpdateHandler, BotReactionUpdateHandler, BotStoppedHandler, CallbackQueryHandler, ChatJoinRequestHandler, ChatMemberUpdateHandler, ChosenInlineResultHandler, DeleteMessageHandler, DeleteStoryHandler, EditMessageHandler, HistoryReadHandler, InlineCallbackQueryHandler, InlineQueryHandler, MessageGroupHandler, NewMessageHandler, PollUpdateHandler, PollVoteHandler, PreCheckoutQueryHandler, RawUpdateHandler, StoryUpdateHandler, UpdateHandler, UserStatusUpdateHandler, UserTypingHandler } from './handler.js';
+import { BotChatJoinRequestHandler, BotReactionCountUpdateHandler, BotReactionUpdateHandler, BotStoppedHandler, BusinessConnectionUpdateHandler, BusinessMessageGroupHandler, CallbackQueryHandler, ChatJoinRequestHandler, ChatMemberUpdateHandler, ChosenInlineResultHandler, DeleteBusinessMessageHandler, DeleteMessageHandler, DeleteStoryHandler, EditBusinessMessageHandler, EditMessageHandler, HistoryReadHandler, InlineCallbackQueryHandler, InlineQueryHandler, MessageGroupHandler, NewBusinessMessageHandler, NewMessageHandler, PollUpdateHandler, PollVoteHandler, PreCheckoutQueryHandler, RawUpdateHandler, StoryUpdateHandler, UpdateHandler, UserStatusUpdateHandler, UserTypingHandler } from './handler.js';
 import { PropagationAction } from './propagation.js';
 import { IStateStorageProvider, StateKeyDelegate, UpdateState } from './state/index.js';
 export interface DispatcherParams {
@@ -24,6 +25,8 @@ export interface DispatcherParams {
      */
     key?: StateKeyDelegate;
 }
+export interface DispatcherDependencies {
+}
 /**
  * Updates dispatcher
  */
@@ -40,6 +43,7 @@ export declare class Dispatcher<State extends object = never> {
     private _stateKeyDelegate?;
     private _customStateKeyDelegate?;
     private _customStorage?;
+    private _deps;
     private _errorHandler?;
     private _preUpdateHandler?;
     private _postUpdateHandler?;
@@ -58,6 +62,22 @@ export declare class Dispatcher<State extends object = never> {
     static scene<State extends object = Record<never, never>>(name: string, params?: Omit<DispatcherParams, 'sceneName'>): Dispatcher<State>;
     /** For scene dispatchers, name of the scene */
     get sceneName(): string | undefined;
+    /**
+     * Inject a dependency to be available in this dispatcher and all its children.
+     *
+     * **Note**: This is only available for the root dispatcher.
+     */
+    inject<Name extends keyof DispatcherDependencies>(name: Name, value: DispatcherDependencies[Name]): void;
+    /**
+     * Inject dependencies to be available in this dispatcher and all its children.
+     *
+     * **Note**: This is only available for the root dispatcher.
+     */
+    inject(deps: Partial<DispatcherDependencies>): void;
+    /**
+     * Get the dependencies injected into this dispatcher.
+     */
+    get deps(): DispatcherDependencies;
     /**
      * Bind the dispatcher to the client.
      * Called by the constructor automatically if
@@ -690,4 +710,103 @@ export declare class Dispatcher<State extends object = never> {
      * @param group  Handler group index
      */
     onBotReactionCountUpdate<Mod>(filter: UpdateFilter<UpdateContext<BotReactionCountUpdate>, Mod>, handler: BotReactionCountUpdateHandler<filters.Modify<UpdateContext<BotReactionCountUpdate>, Mod>>['callback'], group?: number): void;
+    /**
+     * Register a business connection update handler without any filters
+     *
+     * @param handler  Business connection update handler
+     * @param group  Handler group index
+     */
+    onBusinessConnectionUpdate(handler: BusinessConnectionUpdateHandler['callback'], group?: number): void;
+    /**
+     * Register a business connection update handler with a filter
+     *
+     * @param filter  Update filter
+     * @param handler  Business connection update handler
+     * @param group  Handler group index
+     */
+    onBusinessConnectionUpdate<Mod>(filter: UpdateFilter<UpdateContext<BusinessConnection>, Mod>, handler: BusinessConnectionUpdateHandler<filters.Modify<UpdateContext<BusinessConnection>, Mod>>['callback'], group?: number): void;
+    /**
+     * Register a new business message handler without any filters
+     *
+     * @param handler  New business message handler
+     * @param group  Handler group index
+     */
+    onNewBusinessMessage(handler: NewBusinessMessageHandler<BusinessMessageContext, State extends never ? never : UpdateState<State>>['callback'], group?: number): void;
+    /**
+     * Register a new business message handler with a filter
+     *
+     * @param filter  Update filter
+     * @param handler  New business message handler
+     * @param group  Handler group index
+     */
+    onNewBusinessMessage<Mod>(filter: UpdateFilter<BusinessMessageContext, Mod, State>, handler: NewBusinessMessageHandler<filters.Modify<BusinessMessageContext, Mod>, State extends never ? never : UpdateState<State>>['callback'], group?: number): void;
+    /**
+     * Register a new business message handler with a filter
+     *
+     * @param filter  Update filter
+     * @param handler  New business message handler
+     * @param group  Handler group index
+     */
+    onNewBusinessMessage<Mod>(filter: UpdateFilter<BusinessMessageContext, Mod>, handler: NewBusinessMessageHandler<filters.Modify<BusinessMessageContext, Mod>, State extends never ? never : UpdateState<State>>['callback'], group?: number): void;
+    /**
+     * Register an edit business message handler without any filters
+     *
+     * @param handler  Edit business message handler
+     * @param group  Handler group index
+     */
+    onEditBusinessMessage(handler: EditBusinessMessageHandler<BusinessMessageContext, State extends never ? never : UpdateState<State>>['callback'], group?: number): void;
+    /**
+     * Register an edit business message handler with a filter
+     *
+     * @param filter  Update filter
+     * @param handler  Edit business message handler
+     * @param group  Handler group index
+     */
+    onEditBusinessMessage<Mod>(filter: UpdateFilter<BusinessMessageContext, Mod, State>, handler: EditBusinessMessageHandler<filters.Modify<BusinessMessageContext, Mod>, State extends never ? never : UpdateState<State>>['callback'], group?: number): void;
+    /**
+     * Register an edit business message handler with a filter
+     *
+     * @param filter  Update filter
+     * @param handler  Edit business message handler
+     * @param group  Handler group index
+     */
+    onEditBusinessMessage<Mod>(filter: UpdateFilter<BusinessMessageContext, Mod>, handler: EditBusinessMessageHandler<filters.Modify<BusinessMessageContext, Mod>, State extends never ? never : UpdateState<State>>['callback'], group?: number): void;
+    /**
+     * Register a business message group handler without any filters
+     *
+     * @param handler  Business message group handler
+     * @param group  Handler group index
+     */
+    onBusinessMessageGroup(handler: BusinessMessageGroupHandler<BusinessMessageContext, State extends never ? never : UpdateState<State>>['callback'], group?: number): void;
+    /**
+     * Register a business message group handler with a filter
+     *
+     * @param filter  Update filter
+     * @param handler  Business message group handler
+     * @param group  Handler group index
+     */
+    onBusinessMessageGroup<Mod>(filter: UpdateFilter<BusinessMessageContext, Mod, State>, handler: BusinessMessageGroupHandler<filters.Modify<BusinessMessageContext, Mod>, State extends never ? never : UpdateState<State>>['callback'], group?: number): void;
+    /**
+     * Register a business message group handler with a filter
+     *
+     * @param filter  Update filter
+     * @param handler  Business message group handler
+     * @param group  Handler group index
+     */
+    onBusinessMessageGroup<Mod>(filter: UpdateFilter<BusinessMessageContext, Mod>, handler: BusinessMessageGroupHandler<filters.Modify<BusinessMessageContext, Mod>, State extends never ? never : UpdateState<State>>['callback'], group?: number): void;
+    /**
+     * Register a delete business message handler without any filters
+     *
+     * @param handler  Delete business message handler
+     * @param group  Handler group index
+     */
+    onDeleteBusinessMessage(handler: DeleteBusinessMessageHandler['callback'], group?: number): void;
+    /**
+     * Register a delete business message handler with a filter
+     *
+     * @param filter  Update filter
+     * @param handler  Delete business message handler
+     * @param group  Handler group index
+     */
+    onDeleteBusinessMessage<Mod>(filter: UpdateFilter<UpdateContext<DeleteBusinessMessageUpdate>, Mod>, handler: DeleteBusinessMessageHandler<filters.Modify<UpdateContext<DeleteBusinessMessageUpdate>, Mod>>['callback'], group?: number): void;
 }