@mtcute/dispatcher 0.1.2 → 0.2.1

package/cjs/callback-data-builder.js

@@ -56,6 +56,8 @@ class CallbackDataBuilder {
         }
         const ret = {};
         parts.forEach((it, idx) => {
+            if (idx === 0)
+                return; // skip prefix
             ret[this._fields[idx - 1]] = it;
         });
         return ret;

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/client'\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            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, MtArgumentError } from '@mtcute/client'\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"]}

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

@@ -0,0 +1 @@
+export {};

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

@@ -0,0 +1,74 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const client_1 = require("@mtcute/client");
+const utils_js_1 = require("@mtcute/client/utils.js");
+const test_1 = require("@mtcute/test");
+const callback_data_builder_js_1 = require("./callback-data-builder.js");
+(0, vitest_1.describe)('CallbackDataBuilder', () => {
+    (0, vitest_1.it)('should correctly build data', () => {
+        const cdb = new callback_data_builder_js_1.CallbackDataBuilder('prefix', 'foo', 'bar');
+        (0, vitest_1.expect)(cdb.build({ foo: 'foo', bar: 'bar' })).toEqual('prefix:foo:bar');
+    });
+    (0, vitest_1.it)('should correctly throw on invalid data when building', () => {
+        const cdb = new callback_data_builder_js_1.CallbackDataBuilder('prefix', 'foo', 'bar');
+        (0, vitest_1.expect)(() => cdb.build({ foo: 'foo:1', bar: 'bar' })).toThrow(client_1.MtArgumentError);
+    });
+    (0, vitest_1.it)('should correctly throw on too long data when building', () => {
+        const cdb = new callback_data_builder_js_1.CallbackDataBuilder('prefix', 'foo', 'bar');
+        (0, vitest_1.expect)(() => cdb.build({
+            foo: 'foooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooo',
+            bar: 'bar',
+        })).toThrow(client_1.MtArgumentError);
+    });
+    (0, vitest_1.it)('should correctly parse data', () => {
+        const cdb = new callback_data_builder_js_1.CallbackDataBuilder('prefix', 'foo', 'bar');
+        (0, vitest_1.expect)(cdb.parse('prefix:foo:bar')).toEqual({ foo: 'foo', bar: 'bar' });
+    });
+    (0, vitest_1.it)('should throw on invalid prefix when parsing', () => {
+        const cdb = new callback_data_builder_js_1.CallbackDataBuilder('prefix', 'foo', 'bar');
+        (0, vitest_1.expect)(() => cdb.parse('123:foo:bar')).toThrow(client_1.MtArgumentError);
+    });
+    (0, vitest_1.it)('should throw on invalid parts count when parsing', () => {
+        const cdb = new callback_data_builder_js_1.CallbackDataBuilder('prefix', 'foo', 'bar');
+        (0, vitest_1.expect)(() => cdb.parse('prefix:foo:bar:baz')).toThrow(client_1.MtArgumentError);
+    });
+    (0, vitest_1.describe)('filter', () => {
+        const createCb = (data) => new client_1.CallbackQuery((0, test_1.createStub)('updateBotCallbackQuery', {
+            data: (0, utils_js_1.utf8EncodeToBuffer)(data),
+        }), new client_1.PeersIndex());
+        const getFilterMatch = (filter, data) => {
+            const cb = createCb(data);
+            const matched = filter(cb);
+            if (!matched)
+                return null;
+            // eslint-disable-next-line
+            return cb.match;
+        };
+        (0, vitest_1.it)('should create a filter without params', () => {
+            const cdb = new callback_data_builder_js_1.CallbackDataBuilder('prefix', 'foo', 'bar');
+            (0, vitest_1.expect)(getFilterMatch(cdb.filter(), 'prefix:foo:bar')).toEqual({
+                foo: 'foo',
+                bar: 'bar',
+            });
+            (0, vitest_1.expect)(getFilterMatch(cdb.filter(), 'prefix:foo:bar:baz')).toEqual(null);
+        });
+        (0, vitest_1.it)('should create a filter with params', () => {
+            const cdb = new callback_data_builder_js_1.CallbackDataBuilder('prefix', 'foo', 'bar');
+            (0, vitest_1.expect)(getFilterMatch(cdb.filter({ foo: 'foo' }), 'prefix:foo:bar')).toEqual({
+                foo: 'foo',
+                bar: 'bar',
+            });
+            (0, vitest_1.expect)(getFilterMatch(cdb.filter({ foo: 'foo' }), 'prefix:bar:bar')).toEqual(null);
+        });
+        (0, vitest_1.it)('should create a filter with regex params', () => {
+            const cdb = new callback_data_builder_js_1.CallbackDataBuilder('prefix', 'foo', 'bar');
+            (0, vitest_1.expect)(getFilterMatch(cdb.filter({ foo: /\d+/ }), 'prefix:123:bar')).toEqual({
+                foo: '123',
+                bar: 'bar',
+            });
+            (0, vitest_1.expect)(getFilterMatch(cdb.filter({ foo: /\d+/ }), 'prefix:bar:bar')).toEqual(null);
+        });
+    });
+});
+//# sourceMappingURL=callback-data-builder.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"callback-data-builder.test.js","sourceRoot":"","sources":["../../src/callback-data-builder.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { describe, expect, it } from 'vitest'\n\nimport { CallbackQuery, MtArgumentError, PeersIndex } from '@mtcute/client'\nimport { utf8EncodeToBuffer } from '@mtcute/client/utils.js'\nimport { createStub } from '@mtcute/test'\n\nimport { CallbackDataBuilder } from './callback-data-builder.js'\nimport { UpdateFilter } from './filters/index.js'\n\ndescribe('CallbackDataBuilder', () => {\n    it('should correctly build data', () => {\n        const cdb = new CallbackDataBuilder('prefix', 'foo', 'bar')\n\n        expect(cdb.build({ foo: 'foo', bar: 'bar' })).toEqual('prefix:foo:bar')\n    })\n\n    it('should correctly throw on invalid data when building', () => {\n        const cdb = new CallbackDataBuilder('prefix', 'foo', 'bar')\n\n        expect(() => cdb.build({ foo: 'foo:1', bar: 'bar' })).toThrow(MtArgumentError)\n    })\n\n    it('should correctly throw on too long data when building', () => {\n        const cdb = new CallbackDataBuilder('prefix', 'foo', 'bar')\n\n        expect(() =>\n            cdb.build({\n                foo: 'foooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooo',\n                bar: 'bar',\n            }),\n        ).toThrow(MtArgumentError)\n    })\n\n    it('should correctly parse data', () => {\n        const cdb = new CallbackDataBuilder('prefix', 'foo', 'bar')\n\n        expect(cdb.parse('prefix:foo:bar')).toEqual({ foo: 'foo', bar: 'bar' })\n    })\n\n    it('should throw on invalid prefix when parsing', () => {\n        const cdb = new CallbackDataBuilder('prefix', 'foo', 'bar')\n\n        expect(() => cdb.parse('123:foo:bar')).toThrow(MtArgumentError)\n    })\n\n    it('should throw on invalid parts count when parsing', () => {\n        const cdb = new CallbackDataBuilder('prefix', 'foo', 'bar')\n\n        expect(() => cdb.parse('prefix:foo:bar:baz')).toThrow(MtArgumentError)\n    })\n\n    describe('filter', () => {\n        const createCb = (data: string) =>\n            new CallbackQuery(\n                createStub('updateBotCallbackQuery', {\n                    data: utf8EncodeToBuffer(data),\n                }),\n                new PeersIndex(),\n            )\n\n        const getFilterMatch = (filter: UpdateFilter<CallbackQuery>, data: string) => {\n            const cb = createCb(data)\n\n            const matched = filter(cb)\n            if (!matched) return null\n\n            // eslint-disable-next-line\n            return (cb as any).match\n        }\n\n        it('should create a filter without params', () => {\n            const cdb = new CallbackDataBuilder('prefix', 'foo', 'bar')\n\n            expect(getFilterMatch(cdb.filter(), 'prefix:foo:bar')).toEqual({\n                foo: 'foo',\n                bar: 'bar',\n            })\n            expect(getFilterMatch(cdb.filter(), 'prefix:foo:bar:baz')).toEqual(null)\n        })\n\n        it('should create a filter with params', () => {\n            const cdb = new CallbackDataBuilder('prefix', 'foo', 'bar')\n\n            expect(getFilterMatch(cdb.filter({ foo: 'foo' }), 'prefix:foo:bar')).toEqual({\n                foo: 'foo',\n                bar: 'bar',\n            })\n            expect(getFilterMatch(cdb.filter({ foo: 'foo' }), 'prefix:bar:bar')).toEqual(null)\n        })\n\n        it('should create a filter with regex params', () => {\n            const cdb = new CallbackDataBuilder('prefix', 'foo', 'bar')\n\n            expect(getFilterMatch(cdb.filter({ foo: /\\d+/ }), 'prefix:123:bar')).toEqual({\n                foo: '123',\n                bar: 'bar',\n            })\n            expect(getFilterMatch(cdb.filter({ foo: /\\d+/ }), 'prefix:bar:bar')).toEqual(null)\n        })\n    })\n})\n"]}

package/cjs/context/callback-query.d.ts

@@ -1,4 +1,4 @@
-import { CallbackQuery, TelegramClient } from '@mtcute/client';
+import { CallbackQuery, MaybeAsync, Message, TelegramClient } from '@mtcute/client';
 import { UpdateContext } from './base.js';
 /**
  * Context of a callback query update.
@@ -19,9 +19,13 @@ export declare class CallbackQueryContext extends CallbackQuery implements Updat
      *
      * Can only be used if `isInline = false`
      */
-    getMessage(): Promise<import("@mtcute/client").Message>;
+    getMessage(): Promise<Message>;
     /**
      * Edit the message that contained the callback button that was clicked.
      */
-    editMessage(params: Omit<Parameters<TelegramClient['editInlineMessage']>[0], 'messageId'>): Promise<void | import("@mtcute/client").Message>;
+    editMessage(params: Omit<Parameters<TelegramClient['editInlineMessage']>[0], 'messageId'>): Promise<void | Message>;
+    /**
+     * Shortcut for getting the message and editing it.
+     */
+    editMessageWith(handler: (msg: Message) => MaybeAsync<Parameters<CallbackQueryContext['editMessage']>[0]>): Promise<void | Message>;
 }

package/cjs/context/callback-query.js

@@ -51,6 +51,18 @@ class CallbackQueryContext extends client_1.CallbackQuery {
             ...params,
         });
     }
+    /**
+     * Shortcut for getting the message and editing it.
+     */
+    async editMessageWith(handler) {
+        const msg = await this.getMessage();
+        if (!msg)
+            return;
+        const res = await handler(msg);
+        if (!res)
+            return;
+        return this.editMessage(res);
+    }
 }
 exports.CallbackQueryContext = CallbackQueryContext;
 //# sourceMappingURL=callback-query.js.map

package/cjs/context/callback-query.js.map

@@ -1 +1 @@
-{"version":3,"file":"callback-query.js","sourceRoot":"","sources":["../../../src/context/callback-query.ts"],"names":[],"mappings":";;;AAAA,2CAAwH;AAIxH;;;;GAIG;AACH,MAAa,oBAAqB,SAAQ,sBAAa;IAGnD,YACa,MAAsB,EAC/B,KAAoB;QAEpB,KAAK,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;QAHrB,WAAM,GAAN,MAAM,CAAgB;QAH1B,UAAK,GAAG,gBAAgB,CAAA;IAOjC,CAAC;IAED,oCAAoC;IACpC,MAAM,CAAC,MAA4D;QAC/D,OAAO,IAAI,CAAC,MAAM,CAAC,mBAAmB,CAAC,IAAI,CAAC,EAAE,EAAE,MAAM,CAAC,CAAA;IAC3D,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,UAAU;QACZ,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,wBAAwB,EAAE;YACzC,MAAM,IAAI,wBAAe,CAAC,8CAA8C,CAAC,CAAA;SAC5E;QAED,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;QAE1E,IAAI,CAAC,GAAG,EAAE;YACN,MAAM,IAAI,+BAAsB,CAAC,IAAA,wBAAe,EAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,mBAAmB,CAAC,CAAA;SACxG;QAED,OAAO,GAAG,CAAA;IACd,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,WAAW,CAAC,MAA6E;QAC3F,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,8BAA8B,EAAE;YAC/C,OAAO,IAAI,CAAC,MAAM,CAAC,iBAAiB,CAAC;gBACjC,SAAS,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK;gBACzB,GAAG,MAAM;aACZ,CAAC,CAAA;SACL;QAED,OAAO,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC;YAC3B,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI;YACrB,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK;YACvB,GAAG,MAAM;SACZ,CAAC,CAAA;IACN,CAAC;CACJ;AAtDD,oDAsDC","sourcesContent":["import { CallbackQuery, getMarkedPeerId, MtArgumentError, MtMessageNotFoundError, TelegramClient } from '@mtcute/client'\n\nimport { UpdateContext } from './base.js'\n\n/**\n * Context of a callback query update.\n *\n * This is a subclass of {@link CallbackQuery}, so all its fields are also available.\n */\nexport class CallbackQueryContext extends CallbackQuery implements UpdateContext<CallbackQuery> {\n    readonly _name = 'callback_query'\n\n    constructor(\n        readonly client: TelegramClient,\n        query: CallbackQuery,\n    ) {\n        super(query.raw, query._peers)\n    }\n\n    /** Answer to this callback query */\n    answer(params: Parameters<TelegramClient['answerCallbackQuery']>[1]) {\n        return this.client.answerCallbackQuery(this.id, params)\n    }\n\n    /**\n     *      * Message that contained the callback button that was clicked.\n     *\n     * Note that the message may have been deleted, in which case\n     * `MessageNotFoundError` is thrown.\n     *\n     * Can only be used if `isInline = false`\n     */\n    async getMessage() {\n        if (this.raw._ !== 'updateBotCallbackQuery') {\n            throw new MtArgumentError('Cannot get message for inline callback query')\n        }\n\n        const [msg] = await this.client.getMessages(this.raw.peer, this.raw.msgId)\n\n        if (!msg) {\n            throw new MtMessageNotFoundError(getMarkedPeerId(this.raw.peer), this.raw.msgId, 'Message not found')\n        }\n\n        return msg\n    }\n\n    /**\n     * Edit the message that contained the callback button that was clicked.\n     */\n    async editMessage(params: Omit<Parameters<TelegramClient['editInlineMessage']>[0], 'messageId'>) {\n        if (this.raw._ === 'updateInlineBotCallbackQuery') {\n            return this.client.editInlineMessage({\n                messageId: this.raw.msgId,\n                ...params,\n            })\n        }\n\n        return this.client.editMessage({\n            chatId: this.raw.peer,\n            message: this.raw.msgId,\n            ...params,\n        })\n    }\n}\n"]}
+{"version":3,"file":"callback-query.js","sourceRoot":"","sources":["../../../src/context/callback-query.ts"],"names":[],"mappings":";;;AAAA,2CAQuB;AAIvB;;;;GAIG;AACH,MAAa,oBAAqB,SAAQ,sBAAa;IAGnD,YACa,MAAsB,EAC/B,KAAoB;QAEpB,KAAK,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;QAHrB,WAAM,GAAN,MAAM,CAAgB;QAH1B,UAAK,GAAG,gBAAgB,CAAA;IAOjC,CAAC;IAED,oCAAoC;IACpC,MAAM,CAAC,MAA4D;QAC/D,OAAO,IAAI,CAAC,MAAM,CAAC,mBAAmB,CAAC,IAAI,CAAC,EAAE,EAAE,MAAM,CAAC,CAAA;IAC3D,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,UAAU;QACZ,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,wBAAwB,EAAE;YACzC,MAAM,IAAI,wBAAe,CAAC,8CAA8C,CAAC,CAAA;SAC5E;QAED,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;QAE1E,IAAI,CAAC,GAAG,EAAE;YACN,MAAM,IAAI,+BAAsB,CAAC,IAAA,wBAAe,EAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,mBAAmB,CAAC,CAAA;SACxG;QAED,OAAO,GAAG,CAAA;IACd,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,WAAW,CAAC,MAA6E;QAC3F,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,8BAA8B,EAAE;YAC/C,OAAO,IAAI,CAAC,MAAM,CAAC,iBAAiB,CAAC;gBACjC,SAAS,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK;gBACzB,GAAG,MAAM;aACZ,CAAC,CAAA;SACL;QAED,OAAO,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC;YAC3B,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI;YACrB,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK;YACvB,GAAG,MAAM;SACZ,CAAC,CAAA;IACN,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,eAAe,CAAC,OAAyF;QAC3G,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,UAAU,EAAE,CAAA;QACnC,IAAI,CAAC,GAAG;YAAE,OAAM;QAEhB,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,CAAA;QAC9B,IAAI,CAAC,GAAG;YAAE,OAAM;QAEhB,OAAO,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAA;IAChC,CAAC;CACJ;AAnED,oDAmEC","sourcesContent":["import {\n    CallbackQuery,\n    getMarkedPeerId,\n    MaybeAsync,\n    Message,\n    MtArgumentError,\n    MtMessageNotFoundError,\n    TelegramClient,\n} from '@mtcute/client'\n\nimport { UpdateContext } from './base.js'\n\n/**\n * Context of a callback query update.\n *\n * This is a subclass of {@link CallbackQuery}, so all its fields are also available.\n */\nexport class CallbackQueryContext extends CallbackQuery implements UpdateContext<CallbackQuery> {\n    readonly _name = 'callback_query'\n\n    constructor(\n        readonly client: TelegramClient,\n        query: CallbackQuery,\n    ) {\n        super(query.raw, query._peers)\n    }\n\n    /** Answer to this callback query */\n    answer(params: Parameters<TelegramClient['answerCallbackQuery']>[1]) {\n        return this.client.answerCallbackQuery(this.id, params)\n    }\n\n    /**\n     *      * Message that contained the callback button that was clicked.\n     *\n     * Note that the message may have been deleted, in which case\n     * `MessageNotFoundError` is thrown.\n     *\n     * Can only be used if `isInline = false`\n     */\n    async getMessage() {\n        if (this.raw._ !== 'updateBotCallbackQuery') {\n            throw new MtArgumentError('Cannot get message for inline callback query')\n        }\n\n        const [msg] = await this.client.getMessages(this.raw.peer, this.raw.msgId)\n\n        if (!msg) {\n            throw new MtMessageNotFoundError(getMarkedPeerId(this.raw.peer), this.raw.msgId, 'Message not found')\n        }\n\n        return msg\n    }\n\n    /**\n     * Edit the message that contained the callback button that was clicked.\n     */\n    async editMessage(params: Omit<Parameters<TelegramClient['editInlineMessage']>[0], 'messageId'>) {\n        if (this.raw._ === 'updateInlineBotCallbackQuery') {\n            return this.client.editInlineMessage({\n                messageId: this.raw.msgId,\n                ...params,\n            })\n        }\n\n        return this.client.editMessage({\n            chatId: this.raw.peer,\n            message: this.raw.msgId,\n            ...params,\n        })\n    }\n\n    /**\n     * Shortcut for getting the message and editing it.\n     */\n    async editMessageWith(handler: (msg: Message) => MaybeAsync<Parameters<CallbackQueryContext['editMessage']>[0]>) {\n        const msg = await this.getMessage()\n        if (!msg) return\n\n        const res = await handler(msg)\n        if (!res) return\n\n        return this.editMessage(res)\n    }\n}\n"]}

package/cjs/context/index.d.ts

@@ -4,5 +4,5 @@ export * from './chat-join-request.js';
 export * from './chosen-inline-result.js';
 export * from './inline-query.js';
 export * from './message.js';
-export { UpdateContextType } from './parse.js';
+export type { UpdateContextType } from './parse.js';
 export * from './pre-checkout-query.js';

package/cjs/context/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/context/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,4CAAyB;AACzB,sDAAmC;AACnC,yDAAsC;AACtC,4DAAyC;AACzC,oDAAiC;AACjC,+CAA4B;AAE5B,0DAAuC","sourcesContent":["export * from './base.js'\nexport * from './callback-query.js'\nexport * from './chat-join-request.js'\nexport * from './chosen-inline-result.js'\nexport * from './inline-query.js'\nexport * from './message.js'\nexport { UpdateContextType } from './parse.js'\nexport * from './pre-checkout-query.js'\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/context/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,4CAAyB;AACzB,sDAAmC;AACnC,yDAAsC;AACtC,4DAAyC;AACzC,oDAAiC;AACjC,+CAA4B;AAE5B,0DAAuC","sourcesContent":["export * from './base.js'\nexport * from './callback-query.js'\nexport * from './chat-join-request.js'\nexport * from './chosen-inline-result.js'\nexport * from './inline-query.js'\nexport * from './message.js'\nexport type { UpdateContextType } from './parse.js'\nexport * from './pre-checkout-query.js'\n"]}

package/cjs/context/message.d.ts

@@ -1,4 +1,4 @@
-import { Message, OmitInputMessageId, ParametersSkip1, TelegramClient } from '@mtcute/client';
+import { Message, OmitInputMessageId, ParametersSkip1, Peer, TelegramClient } from '@mtcute/client';
 import { DeleteMessagesParams } from '@mtcute/client/methods/messages/delete-messages.js';
 import { ForwardMessageOptions } from '@mtcute/client/methods/messages/forward-messages.js';
 import { SendCopyParams } from '@mtcute/client/methods/messages/send-copy.js';
@@ -25,6 +25,12 @@ export declare class MessageContext extends Message implements UpdateContext<Mes
     /** Whether this update is about a message group */
     readonly isMessageGroup: boolean;
     constructor(client: TelegramClient, message: Message | Message[]);
+    /**
+     * Get complete information about {@link sender}
+     *
+     * Learn more: [Incomplete peers](https://mtcute.dev/guide/topics/peers.html#incomplete-peers)
+     */
+    getCompleteSender(): Promise<Peer>;
     /** Get a message that this message is a reply to */
     getReplyTo(): Promise<Message | null>;
     /** If this is a channel post, get its automatic forward in the discussion group */

package/cjs/context/message.js

@@ -21,6 +21,26 @@ class MessageContext extends client_1.Message {
         this.messages = Array.isArray(message) ? message.map((it) => new MessageContext(client, it)) : [this];
         this.isMessageGroup = Array.isArray(message);
     }
+    /**
+     * Get complete information about {@link sender}
+     *
+     * Learn more: [Incomplete peers](https://mtcute.dev/guide/topics/peers.html#incomplete-peers)
+     */
+    async getCompleteSender() {
+        if (!this.sender.isMin)
+            return this.sender;
+        let res;
+        if (this.sender.type === 'user') {
+            [res] = await this.client.getUsers(this.sender);
+        }
+        else {
+            res = await this.client.getChat(this.sender);
+        }
+        if (!res)
+            throw new client_1.MtPeerNotFoundError('Failed to fetch sender');
+        Object.defineProperty(this, 'sender', { value: res });
+        return res;
+    }
     /** Get a message that this message is a reply to */
     getReplyTo() {
         return this.client.getReplyTo(this);

package/cjs/context/message.js.map

@@ -1 +1 @@
-{"version":3,"file":"message.js","sourceRoot":"","sources":["../../../src/context/message.ts"],"names":[],"mappings":"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","sourcesContent":["import { Message, OmitInputMessageId, ParametersSkip1, TelegramClient } from '@mtcute/client'\nimport { DeleteMessagesParams } from '@mtcute/client/src/methods/messages/delete-messages.js'\nimport { ForwardMessageOptions } from '@mtcute/client/src/methods/messages/forward-messages.js'\nimport { SendCopyParams } from '@mtcute/client/src/methods/messages/send-copy.js'\nimport { SendCopyGroupParams } from '@mtcute/client/src/methods/messages/send-copy-group.js'\n\nimport { UpdateContext } from './base.js'\n\n/**\n * Context of a message-related update.\n *\n * This is a subclass of {@link Message}, 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 MessageContext#messages}.\n */\nexport class MessageContext extends Message implements UpdateContext<Message> {\n    // this is primarily for proper types in filters, so don't bother much with actual value\n    readonly _name = 'new_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: MessageContext[]\n\n    /** Whether this update is about a message group */\n    readonly isMessageGroup: boolean\n\n    constructor(\n        readonly client: TelegramClient,\n        message: Message | Message[],\n    ) {\n        const msg = Array.isArray(message) ? message[message.length - 1] : message\n        super(msg.raw, msg._peers, msg.isScheduled)\n\n        this.messages = Array.isArray(message) ? message.map((it) => new MessageContext(client, it)) : [this]\n        this.isMessageGroup = Array.isArray(message)\n    }\n\n    /** Get a message that this message is a reply to */\n    getReplyTo() {\n        return this.client.getReplyTo(this)\n    }\n\n    /** If this is a channel post, get its automatic forward in the discussion group */\n    getDiscussionMessage() {\n        return this.client.getDiscussionMessage({ chatId: this.chat.inputPeer, message: this.id })\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        return this.client.answerText(this, ...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        return this.client.answerMedia(this, ...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        return this.client.answerMediaGroup(this, ...params)\n    }\n\n    /** Send a text message in reply to this message */\n    replyText(...params: ParametersSkip1<TelegramClient['replyText']>) {\n        return this.client.replyText(this, ...params)\n    }\n\n    /** Send a media in reply to this message */\n    replyMedia(...params: ParametersSkip1<TelegramClient['replyMedia']>) {\n        return this.client.replyMedia(this, ...params)\n    }\n\n    /** Send a media group in reply to this message */\n    replyMediaGroup(...params: ParametersSkip1<TelegramClient['replyMediaGroup']>) {\n        return this.client.replyMediaGroup(this, ...params)\n    }\n\n    /** Send a text message in reply to this message */\n    quoteWithText(params: Parameters<TelegramClient['quoteWithText']>[1]) {\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        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        return this.client.quoteWithMediaGroup(this, params)\n    }\n\n    /** Send a text as a comment to this message */\n    commentText(...params: ParametersSkip1<TelegramClient['commentText']>) {\n        return this.client.commentText(this, ...params)\n    }\n\n    /** Send a media as a comment to this message */\n    commentMedia(...params: ParametersSkip1<TelegramClient['commentMedia']>) {\n        return this.client.commentMedia(this, ...params)\n    }\n\n    /** Send a media group as a comment to this message */\n    commentMediaGroup(...params: ParametersSkip1<TelegramClient['commentMediaGroup']>) {\n        return this.client.commentMediaGroup(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"]}
+{"version":3,"file":"message.js","sourceRoot":"","sources":["../../../src/context/message.ts"],"names":[],"mappings":"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","sourcesContent":["import { Message, MtPeerNotFoundError, OmitInputMessageId, ParametersSkip1, Peer, TelegramClient } from '@mtcute/client'\nimport { DeleteMessagesParams } from '@mtcute/client/src/methods/messages/delete-messages.js'\nimport { ForwardMessageOptions } from '@mtcute/client/src/methods/messages/forward-messages.js'\nimport { SendCopyParams } from '@mtcute/client/src/methods/messages/send-copy.js'\nimport { SendCopyGroupParams } from '@mtcute/client/src/methods/messages/send-copy-group.js'\n\nimport { UpdateContext } from './base.js'\n\n/**\n * Context of a message-related update.\n *\n * This is a subclass of {@link Message}, 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 MessageContext#messages}.\n */\nexport class MessageContext extends Message implements UpdateContext<Message> {\n    // this is primarily for proper types in filters, so don't bother much with actual value\n    readonly _name = 'new_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: MessageContext[]\n\n    /** Whether this update is about a message group */\n    readonly isMessageGroup: boolean\n\n    constructor(\n        readonly client: TelegramClient,\n        message: Message | Message[],\n    ) {\n        const msg = Array.isArray(message) ? message[message.length - 1] : message\n        super(msg.raw, msg._peers, msg.isScheduled)\n\n        this.messages = Array.isArray(message) ? message.map((it) => new MessageContext(client, it)) : [this]\n        this.isMessageGroup = Array.isArray(message)\n    }\n\n    /**\n     * Get complete information about {@link sender}\n     *\n     * Learn more: [Incomplete peers](https://mtcute.dev/guide/topics/peers.html#incomplete-peers)\n     */\n    async getCompleteSender(): Promise<Peer> {\n        if (!this.sender.isMin) return this.sender\n\n        let res\n\n        if (this.sender.type === 'user') {\n            [res] = await this.client.getUsers(this.sender)\n        } else {\n            res = await this.client.getChat(this.sender)\n        }\n\n        if (!res) throw new MtPeerNotFoundError('Failed to fetch sender')\n\n        Object.defineProperty(this, 'sender', { value: res })\n\n        return res\n    }\n\n    /** Get a message that this message is a reply to */\n    getReplyTo() {\n        return this.client.getReplyTo(this)\n    }\n\n    /** If this is a channel post, get its automatic forward in the discussion group */\n    getDiscussionMessage() {\n        return this.client.getDiscussionMessage({ chatId: this.chat.inputPeer, message: this.id })\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        return this.client.answerText(this, ...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        return this.client.answerMedia(this, ...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        return this.client.answerMediaGroup(this, ...params)\n    }\n\n    /** Send a text message in reply to this message */\n    replyText(...params: ParametersSkip1<TelegramClient['replyText']>) {\n        return this.client.replyText(this, ...params)\n    }\n\n    /** Send a media in reply to this message */\n    replyMedia(...params: ParametersSkip1<TelegramClient['replyMedia']>) {\n        return this.client.replyMedia(this, ...params)\n    }\n\n    /** Send a media group in reply to this message */\n    replyMediaGroup(...params: ParametersSkip1<TelegramClient['replyMediaGroup']>) {\n        return this.client.replyMediaGroup(this, ...params)\n    }\n\n    /** Send a text message in reply to this message */\n    quoteWithText(params: Parameters<TelegramClient['quoteWithText']>[1]) {\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        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        return this.client.quoteWithMediaGroup(this, params)\n    }\n\n    /** Send a text as a comment to this message */\n    commentText(...params: ParametersSkip1<TelegramClient['commentText']>) {\n        return this.client.commentText(this, ...params)\n    }\n\n    /** Send a media as a comment to this message */\n    commentMedia(...params: ParametersSkip1<TelegramClient['commentMedia']>) {\n        return this.client.commentMedia(this, ...params)\n    }\n\n    /** Send a media group as a comment to this message */\n    commentMediaGroup(...params: ParametersSkip1<TelegramClient['commentMediaGroup']>) {\n        return this.client.commentMediaGroup(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/dispatcher.d.ts

@@ -13,7 +13,7 @@ export interface DispatcherParams {
      */
     sceneName?: string;
     /**
-     * Custom storage for the dispatcher.
+     * Custom storage for this dispatcher and its children.
      *
      * @default  Client's storage
      */
@@ -57,25 +57,18 @@ 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;
+    private _onClientBeforeConnect;
+    private _onClientBeforeClose;
     /**
      * Bind the dispatcher to the client.
      * Called by the constructor automatically if
      * `client` was passed.
      *
-     * Under the hood, this replaces client's `dispatchUpdate`
-     * function, meaning you can't bind two different
-     * dispatchers to the same client at the same time.
-     * Instead, use {@link extend}, {@link addChild}
-     * or {@link addScene} on the existing, already bound dispatcher.
-     *
      * Dispatcher also uses bound client to throw errors
      */
     bindToClient(client: TelegramClient): void;
     /**
      * Unbind a dispatcher from the client.
-     *
-     * This will replace client's dispatchUpdate with a no-op.
-     * If this dispatcher is not bound, nothing will happen.
      */
     unbind(): void;
     /**
@@ -137,9 +130,9 @@ export declare class Dispatcher<State extends object = never> {
      * handler group.
      *
      * @param handler  Update handler to remove, its name or `'all'` to remove all
-     * @param group  Handler group index (-1 to affect all groups)
+     * @param group  Handler group index (null to affect all groups)
      */
-    removeUpdateHandler(handler: UpdateHandler | UpdateHandler['name'] | 'all', group?: number): void;
+    removeUpdateHandler(handler: UpdateHandler | UpdateHandler['name'] | 'all', group?: number | null): void;
     /**
      * Register an error handler.
      *