@mtcute/core 0.6.0 → 0.7.0

package/cjs/highlevel/types/bots/keyboard-builder.js

@@ -0,0 +1,93 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BotKeyboardBuilder = void 0;
+/**
+ * Builder for bot keyboards
+ */
+class BotKeyboardBuilder {
+    constructor(maxRowWidth = 3) {
+        this.maxRowWidth = maxRowWidth;
+        this._buttons = [];
+    }
+    /**
+     * Add buttons, wrapping them once {@link maxRowWidth} is reached
+     *
+     * @param buttons  Buttons to add
+     */
+    push(...buttons) {
+        if (!buttons.length)
+            return this;
+        let row = [];
+        buttons.forEach((btn) => {
+            if (typeof btn === 'function')
+                btn = btn();
+            if (!btn)
+                return;
+            row.push(btn);
+            if (row.length === this.maxRowWidth) {
+                this._buttons.push(row);
+                row = [];
+            }
+        });
+        if (row.length) {
+            this._buttons.push(row);
+        }
+        return this;
+    }
+    /**
+     * Add a row of buttons. Will not be wrapped.
+     *
+     * @param row  Row or a function that will populate it
+     */
+    row(row) {
+        if (typeof row === 'function') {
+            const fn = row;
+            row = [];
+            fn(row);
+        }
+        const normal = row.filter(Boolean);
+        if (normal.length)
+            this._buttons.push(normal);
+        return this;
+    }
+    /**
+     * Append a button to the last row, wrapping if needed.
+     *
+     * @param btn  Button to add
+     * @param force  Whether to forcefully add the button (i.e. do not wrap)
+     */
+    append(btn, force = false) {
+        if (typeof btn === 'function')
+            btn = btn();
+        if (!btn)
+            return this;
+        if (this._buttons.length &&
+            (this.maxRowWidth === null || force || this._buttons[this._buttons.length - 1].length < this.maxRowWidth)) {
+            this._buttons[this._buttons.length - 1].push(btn);
+        }
+        else {
+            this._buttons.push([btn]);
+        }
+        return this;
+    }
+    /**
+     * Return contents of this builder as an inline keyboard
+     */
+    asInline() {
+        return {
+            type: 'inline',
+            buttons: this._buttons,
+        };
+    }
+    /**
+     * Return contents of this builder as a reply keyboard
+     */
+    asReply(params = {}) {
+        const ret = params;
+        ret.type = 'reply';
+        ret.buttons = this._buttons;
+        return ret;
+    }
+}
+exports.BotKeyboardBuilder = BotKeyboardBuilder;
+//# sourceMappingURL=keyboard-builder.js.map

package/cjs/highlevel/types/bots/keyboard-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyboard-builder.js","sourceRoot":"","sources":["../../../../../src/highlevel/types/bots/keyboard-builder.ts"],"names":[],"mappings":";;;AAMA;;GAEG;AACH,MAAa,kBAAkB;IAG3B,YAAqB,cAA6B,CAAC;QAA9B,gBAAW,GAAX,WAAW,CAAmB;QAF3C,aAAQ,GAA8B,EAAE,CAAA;IAEM,CAAC;IAEvD;;;;OAIG;IACH,IAAI,CAAC,GAAG,OAA4C;QAChD,IAAI,CAAC,OAAO,CAAC,MAAM;YAAE,OAAO,IAAI,CAAA;QAEhC,IAAI,GAAG,GAA4B,EAAE,CAAA;QACrC,OAAO,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE;YACpB,IAAI,OAAO,GAAG,KAAK,UAAU;gBAAE,GAAG,GAAG,GAAG,EAAE,CAAA;YAC1C,IAAI,CAAC,GAAG;gBAAE,OAAM;YAEhB,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;YAEb,IAAI,GAAG,CAAC,MAAM,KAAK,IAAI,CAAC,WAAW,EAAE;gBACjC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;gBACvB,GAAG,GAAG,EAAE,CAAA;aACX;QACL,CAAC,CAAC,CAAA;QAEF,IAAI,GAAG,CAAC,MAAM,EAAE;YACZ,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;SAC1B;QAED,OAAO,IAAI,CAAA;IACf,CAAC;IAED;;;;OAIG;IACH,GAAG,CAAC,GAAiD;QACjD,IAAI,OAAO,GAAG,KAAK,UAAU,EAAE;YAC3B,MAAM,EAAE,GAAG,GAAG,CAAA;YACd,GAAG,GAAG,EAAE,CAAA;YACR,EAAE,CAAC,GAAG,CAAC,CAAA;SACV;QAED,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,OAAO,CAA4B,CAAA;QAC7D,IAAI,MAAM,CAAC,MAAM;YAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;QAE7C,OAAO,IAAI,CAAA;IACf,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,GAAoC,EAAE,KAAK,GAAG,KAAK;QACtD,IAAI,OAAO,GAAG,KAAK,UAAU;YAAE,GAAG,GAAG,GAAG,EAAE,CAAA;QAC1C,IAAI,CAAC,GAAG;YAAE,OAAO,IAAI,CAAA;QAErB,IACI,IAAI,CAAC,QAAQ,CAAC,MAAM;YACpB,CAAC,IAAI,CAAC,WAAW,KAAK,IAAI,IAAI,KAAK,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,EAC3G;YACE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;SACpD;aAAM;YACH,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAA;SAC5B;QAED,OAAO,IAAI,CAAA;IACf,CAAC;IAED;;OAEG;IACH,QAAQ;QACJ,OAAO;YACH,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,IAAI,CAAC,QAAQ;SACzB,CAAA;IACL,CAAC;IAED;;OAEG;IACH,OAAO,CAAC,SAAwD,EAAE;QAC9D,MAAM,GAAG,GAAG,MAAyC,CAAA;QACrD,GAAG,CAAC,IAAI,GAAG,OAAO,CAAA;QAClB,GAAG,CAAC,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAA;QAE3B,OAAO,GAAG,CAAA;IACd,CAAC;CACJ;AA7FD,gDA6FC","sourcesContent":["import { tl } from '@mtcute/tl'\n\nimport type { InlineKeyboardMarkup, ReplyKeyboardMarkup } from './keyboards.js'\n\nexport type ButtonLike = tl.TypeKeyboardButton | false | null | undefined | void\n\n/**\n * Builder for bot keyboards\n */\nexport class BotKeyboardBuilder {\n    private _buttons: tl.TypeKeyboardButton[][] = []\n\n    constructor(readonly maxRowWidth: number | null = 3) {}\n\n    /**\n     * Add buttons, wrapping them once {@link maxRowWidth} is reached\n     *\n     * @param buttons  Buttons to add\n     */\n    push(...buttons: (ButtonLike | (() => ButtonLike))[]): this {\n        if (!buttons.length) return this\n\n        let row: tl.TypeKeyboardButton[] = []\n        buttons.forEach((btn) => {\n            if (typeof btn === 'function') btn = btn()\n            if (!btn) return\n\n            row.push(btn)\n\n            if (row.length === this.maxRowWidth) {\n                this._buttons.push(row)\n                row = []\n            }\n        })\n\n        if (row.length) {\n            this._buttons.push(row)\n        }\n\n        return this\n    }\n\n    /**\n     * Add a row of buttons. Will not be wrapped.\n     *\n     * @param row  Row or a function that will populate it\n     */\n    row(row: ButtonLike[] | ((arr: ButtonLike[]) => void)): this {\n        if (typeof row === 'function') {\n            const fn = row\n            row = []\n            fn(row)\n        }\n\n        const normal = row.filter(Boolean) as tl.TypeKeyboardButton[]\n        if (normal.length) this._buttons.push(normal)\n\n        return this\n    }\n\n    /**\n     * Append a button to the last row, wrapping if needed.\n     *\n     * @param btn  Button to add\n     * @param force  Whether to forcefully add the button (i.e. do not wrap)\n     */\n    append(btn: ButtonLike | (() => ButtonLike), force = false): this {\n        if (typeof btn === 'function') btn = btn()\n        if (!btn) return this\n\n        if (\n            this._buttons.length &&\n            (this.maxRowWidth === null || force || this._buttons[this._buttons.length - 1].length < this.maxRowWidth)\n        ) {\n            this._buttons[this._buttons.length - 1].push(btn)\n        } else {\n            this._buttons.push([btn])\n        }\n\n        return this\n    }\n\n    /**\n     * Return contents of this builder as an inline keyboard\n     */\n    asInline(): InlineKeyboardMarkup {\n        return {\n            type: 'inline',\n            buttons: this._buttons,\n        }\n    }\n\n    /**\n     * Return contents of this builder as a reply keyboard\n     */\n    asReply(params: Omit<ReplyKeyboardMarkup, 'type' | 'buttons'> = {}): ReplyKeyboardMarkup {\n        const ret = params as tl.Mutable<ReplyKeyboardMarkup>\n        ret.type = 'reply'\n        ret.buttons = this._buttons\n\n        return ret\n    }\n}\n"]}

package/cjs/highlevel/types/bots/keyboard-builder.test.d.ts

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

package/cjs/highlevel/types/bots/keyboard-builder.test.js

@@ -0,0 +1,162 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const keyboard_builder_js_1 = require("./keyboard-builder.js");
+(0, vitest_1.describe)('BotKeyboardBuilder', () => {
+    (0, vitest_1.describe)('#push', () => {
+        (0, vitest_1.it)('should add buttons', () => {
+            const builder = new keyboard_builder_js_1.BotKeyboardBuilder();
+            builder.push({ _: 'keyboardButton', text: '1' }, { _: 'keyboardButton', text: '2' }, { _: 'keyboardButton', text: '3' });
+            (0, vitest_1.expect)(builder.asInline()).toEqual({
+                type: 'inline',
+                buttons: [
+                    [
+                        { _: 'keyboardButton', text: '1' },
+                        { _: 'keyboardButton', text: '2' },
+                        { _: 'keyboardButton', text: '3' },
+                    ],
+                ],
+            });
+        });
+        (0, vitest_1.it)('should wrap long rows buttons', () => {
+            const builder = new keyboard_builder_js_1.BotKeyboardBuilder(3);
+            builder.push({ _: 'keyboardButton', text: '1' }, { _: 'keyboardButton', text: '2' }, { _: 'keyboardButton', text: '3' }, { _: 'keyboardButton', text: '4' });
+            (0, vitest_1.expect)(builder.asInline()).toEqual({
+                type: 'inline',
+                buttons: [
+                    [
+                        { _: 'keyboardButton', text: '1' },
+                        { _: 'keyboardButton', text: '2' },
+                        { _: 'keyboardButton', text: '3' },
+                    ],
+                    [{ _: 'keyboardButton', text: '4' }],
+                ],
+            });
+        });
+        (0, vitest_1.it)('should always add a new row', () => {
+            const builder = new keyboard_builder_js_1.BotKeyboardBuilder(3);
+            builder.push({ _: 'keyboardButton', text: '1' });
+            builder.push({ _: 'keyboardButton', text: '2' });
+            builder.push({ _: 'keyboardButton', text: '3' });
+            (0, vitest_1.expect)(builder.asInline()).toEqual({
+                type: 'inline',
+                buttons: [
+                    [{ _: 'keyboardButton', text: '1' }],
+                    [{ _: 'keyboardButton', text: '2' }],
+                    [{ _: 'keyboardButton', text: '3' }],
+                ],
+            });
+        });
+        (0, vitest_1.it)('should accept functions and falsy values', () => {
+            const builder = new keyboard_builder_js_1.BotKeyboardBuilder(3);
+            builder.push({ _: 'keyboardButton', text: '1' });
+            builder.push(() => ({ _: 'keyboardButton', text: '2' }));
+            builder.push(1 > 1 && { _: 'keyboardButton', text: '3' });
+            (0, vitest_1.expect)(builder.asInline()).toEqual({
+                type: 'inline',
+                buttons: [[{ _: 'keyboardButton', text: '1' }], [{ _: 'keyboardButton', text: '2' }]],
+            });
+        });
+    });
+    (0, vitest_1.describe)('#append', () => {
+        (0, vitest_1.it)('should append (or wrap) to the last row', () => {
+            const builder = new keyboard_builder_js_1.BotKeyboardBuilder(3);
+            builder.append({ _: 'keyboardButton', text: '1' });
+            builder.append({ _: 'keyboardButton', text: '2' });
+            builder.append({ _: 'keyboardButton', text: '3' });
+            builder.append({ _: 'keyboardButton', text: '4' });
+            (0, vitest_1.expect)(builder.asInline()).toEqual({
+                type: 'inline',
+                buttons: [
+                    [
+                        { _: 'keyboardButton', text: '1' },
+                        { _: 'keyboardButton', text: '2' },
+                        { _: 'keyboardButton', text: '3' },
+                    ],
+                    [{ _: 'keyboardButton', text: '4' }],
+                ],
+            });
+        });
+        (0, vitest_1.it)('accept functions and falsy values', () => {
+            const builder = new keyboard_builder_js_1.BotKeyboardBuilder(3);
+            builder.append({ _: 'keyboardButton', text: '1' });
+            builder.append(() => ({ _: 'keyboardButton', text: '2' }));
+            builder.append(1 > 1 && { _: 'keyboardButton', text: '3' });
+            (0, vitest_1.expect)(builder.asInline()).toEqual({
+                type: 'inline',
+                buttons: [
+                    [
+                        { _: 'keyboardButton', text: '1' },
+                        { _: 'keyboardButton', text: '2' },
+                    ],
+                ],
+            });
+        });
+    });
+    (0, vitest_1.it)('should accept custom row size', () => {
+        const builder = new keyboard_builder_js_1.BotKeyboardBuilder(5);
+        builder.append({ _: 'keyboardButton', text: '1' });
+        builder.append({ _: 'keyboardButton', text: '2' });
+        builder.append({ _: 'keyboardButton', text: '3' });
+        builder.append({ _: 'keyboardButton', text: '4' });
+        builder.append({ _: 'keyboardButton', text: '5' });
+        builder.append({ _: 'keyboardButton', text: '6' });
+        (0, vitest_1.expect)(builder.asInline()).toEqual({
+            type: 'inline',
+            buttons: [
+                [
+                    { _: 'keyboardButton', text: '1' },
+                    { _: 'keyboardButton', text: '2' },
+                    { _: 'keyboardButton', text: '3' },
+                    { _: 'keyboardButton', text: '4' },
+                    { _: 'keyboardButton', text: '5' },
+                ],
+                [{ _: 'keyboardButton', text: '6' }],
+            ],
+        });
+    });
+    (0, vitest_1.it)('#row should add entire rows of buttons', () => {
+        const builder = new keyboard_builder_js_1.BotKeyboardBuilder(3);
+        builder.row([
+            { _: 'keyboardButton', text: '1' },
+            { _: 'keyboardButton', text: '2' },
+            { _: 'keyboardButton', text: '3' },
+            { _: 'keyboardButton', text: '4' },
+            { _: 'keyboardButton', text: '5' },
+        ]);
+        builder.append({ _: 'keyboardButton', text: '6' });
+        (0, vitest_1.expect)(builder.asInline()).toEqual({
+            type: 'inline',
+            buttons: [
+                [
+                    { _: 'keyboardButton', text: '1' },
+                    { _: 'keyboardButton', text: '2' },
+                    { _: 'keyboardButton', text: '3' },
+                    { _: 'keyboardButton', text: '4' },
+                    { _: 'keyboardButton', text: '5' },
+                ],
+                [{ _: 'keyboardButton', text: '6' }],
+            ],
+        });
+    });
+    (0, vitest_1.it)('should support reply keyboards', () => {
+        const builder = new keyboard_builder_js_1.BotKeyboardBuilder(3);
+        builder.append({ _: 'keyboardButton', text: '1' });
+        builder.append({ _: 'keyboardButton', text: '2' });
+        builder.append({ _: 'keyboardButton', text: '3' });
+        builder.append({ _: 'keyboardButton', text: '4' });
+        (0, vitest_1.expect)(builder.asReply({ resize: true })).toEqual({
+            type: 'reply',
+            resize: true,
+            buttons: [
+                [
+                    { _: 'keyboardButton', text: '1' },
+                    { _: 'keyboardButton', text: '2' },
+                    { _: 'keyboardButton', text: '3' },
+                ],
+                [{ _: 'keyboardButton', text: '4' }],
+            ],
+        });
+    });
+});
+//# sourceMappingURL=keyboard-builder.test.js.map

package/cjs/highlevel/types/bots/keyboard-builder.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyboard-builder.test.js","sourceRoot":"","sources":["../../../../../src/highlevel/types/bots/keyboard-builder.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { describe, expect, it } from 'vitest'\n\nimport { BotKeyboardBuilder } from './keyboard-builder.js'\n\ndescribe('BotKeyboardBuilder', () => {\n    describe('#push', () => {\n        it('should add buttons', () => {\n            const builder = new BotKeyboardBuilder()\n\n            builder.push(\n                { _: 'keyboardButton', text: '1' },\n                { _: 'keyboardButton', text: '2' },\n                { _: 'keyboardButton', text: '3' },\n            )\n\n            expect(builder.asInline()).toEqual({\n                type: 'inline',\n                buttons: [\n                    [\n                        { _: 'keyboardButton', text: '1' },\n                        { _: 'keyboardButton', text: '2' },\n                        { _: 'keyboardButton', text: '3' },\n                    ],\n                ],\n            })\n        })\n\n        it('should wrap long rows buttons', () => {\n            const builder = new BotKeyboardBuilder(3)\n\n            builder.push(\n                { _: 'keyboardButton', text: '1' },\n                { _: 'keyboardButton', text: '2' },\n                { _: 'keyboardButton', text: '3' },\n                { _: 'keyboardButton', text: '4' },\n            )\n\n            expect(builder.asInline()).toEqual({\n                type: 'inline',\n                buttons: [\n                    [\n                        { _: 'keyboardButton', text: '1' },\n                        { _: 'keyboardButton', text: '2' },\n                        { _: 'keyboardButton', text: '3' },\n                    ],\n                    [{ _: 'keyboardButton', text: '4' }],\n                ],\n            })\n        })\n\n        it('should always add a new row', () => {\n            const builder = new BotKeyboardBuilder(3)\n\n            builder.push({ _: 'keyboardButton', text: '1' })\n            builder.push({ _: 'keyboardButton', text: '2' })\n            builder.push({ _: 'keyboardButton', text: '3' })\n\n            expect(builder.asInline()).toEqual({\n                type: 'inline',\n                buttons: [\n                    [{ _: 'keyboardButton', text: '1' }],\n                    [{ _: 'keyboardButton', text: '2' }],\n                    [{ _: 'keyboardButton', text: '3' }],\n                ],\n            })\n        })\n\n        it('should accept functions and falsy values', () => {\n            const builder = new BotKeyboardBuilder(3)\n\n            builder.push({ _: 'keyboardButton', text: '1' })\n            builder.push(() => ({ _: 'keyboardButton', text: '2' }))\n            builder.push(1 > 1 && { _: 'keyboardButton', text: '3' })\n\n            expect(builder.asInline()).toEqual({\n                type: 'inline',\n                buttons: [[{ _: 'keyboardButton', text: '1' }], [{ _: 'keyboardButton', text: '2' }]],\n            })\n        })\n    })\n\n    describe('#append', () => {\n        it('should append (or wrap) to the last row', () => {\n            const builder = new BotKeyboardBuilder(3)\n\n            builder.append({ _: 'keyboardButton', text: '1' })\n            builder.append({ _: 'keyboardButton', text: '2' })\n            builder.append({ _: 'keyboardButton', text: '3' })\n            builder.append({ _: 'keyboardButton', text: '4' })\n\n            expect(builder.asInline()).toEqual({\n                type: 'inline',\n                buttons: [\n                    [\n                        { _: 'keyboardButton', text: '1' },\n                        { _: 'keyboardButton', text: '2' },\n                        { _: 'keyboardButton', text: '3' },\n                    ],\n                    [{ _: 'keyboardButton', text: '4' }],\n                ],\n            })\n        })\n\n        it('accept functions and falsy values', () => {\n            const builder = new BotKeyboardBuilder(3)\n\n            builder.append({ _: 'keyboardButton', text: '1' })\n            builder.append(() => ({ _: 'keyboardButton', text: '2' }))\n            builder.append(1 > 1 && { _: 'keyboardButton', text: '3' })\n\n            expect(builder.asInline()).toEqual({\n                type: 'inline',\n                buttons: [\n                    [\n                        { _: 'keyboardButton', text: '1' },\n                        { _: 'keyboardButton', text: '2' },\n                    ],\n                ],\n            })\n        })\n    })\n\n    it('should accept custom row size', () => {\n        const builder = new BotKeyboardBuilder(5)\n\n        builder.append({ _: 'keyboardButton', text: '1' })\n        builder.append({ _: 'keyboardButton', text: '2' })\n        builder.append({ _: 'keyboardButton', text: '3' })\n        builder.append({ _: 'keyboardButton', text: '4' })\n        builder.append({ _: 'keyboardButton', text: '5' })\n        builder.append({ _: 'keyboardButton', text: '6' })\n\n        expect(builder.asInline()).toEqual({\n            type: 'inline',\n            buttons: [\n                [\n                    { _: 'keyboardButton', text: '1' },\n                    { _: 'keyboardButton', text: '2' },\n                    { _: 'keyboardButton', text: '3' },\n                    { _: 'keyboardButton', text: '4' },\n                    { _: 'keyboardButton', text: '5' },\n                ],\n                [{ _: 'keyboardButton', text: '6' }],\n            ],\n        })\n    })\n\n    it('#row should add entire rows of buttons', () => {\n        const builder = new BotKeyboardBuilder(3)\n\n        builder.row([\n            { _: 'keyboardButton', text: '1' },\n            { _: 'keyboardButton', text: '2' },\n            { _: 'keyboardButton', text: '3' },\n            { _: 'keyboardButton', text: '4' },\n            { _: 'keyboardButton', text: '5' },\n        ])\n        builder.append({ _: 'keyboardButton', text: '6' })\n\n        expect(builder.asInline()).toEqual({\n            type: 'inline',\n            buttons: [\n                [\n                    { _: 'keyboardButton', text: '1' },\n                    { _: 'keyboardButton', text: '2' },\n                    { _: 'keyboardButton', text: '3' },\n                    { _: 'keyboardButton', text: '4' },\n                    { _: 'keyboardButton', text: '5' },\n                ],\n                [{ _: 'keyboardButton', text: '6' }],\n            ],\n        })\n    })\n\n    it('should support reply keyboards', () => {\n        const builder = new BotKeyboardBuilder(3)\n\n        builder.append({ _: 'keyboardButton', text: '1' })\n        builder.append({ _: 'keyboardButton', text: '2' })\n        builder.append({ _: 'keyboardButton', text: '3' })\n        builder.append({ _: 'keyboardButton', text: '4' })\n\n        expect(builder.asReply({ resize: true })).toEqual({\n            type: 'reply',\n            resize: true,\n            buttons: [\n                [\n                    { _: 'keyboardButton', text: '1' },\n                    { _: 'keyboardButton', text: '2' },\n                    { _: 'keyboardButton', text: '3' },\n                ],\n                [{ _: 'keyboardButton', text: '4' }],\n            ],\n        })\n    })\n})\n"]}

package/cjs/highlevel/types/bots/keyboards.d.ts

@@ -0,0 +1,239 @@
+import { tl } from '@mtcute/tl';
+import { BotKeyboardBuilder } from './keyboard-builder.js';
+/**
+ * Reply keyboard markup
+ */
+export interface ReplyKeyboardMarkup extends Omit<tl.RawReplyKeyboardMarkup, '_' | 'rows'> {
+    readonly type: 'reply';
+    /**
+     * Two-dimensional array of buttons
+     */
+    readonly buttons: tl.TypeKeyboardButton[][];
+}
+/**
+ * Hide previously sent bot keyboard
+ */
+export interface ReplyKeyboardHide extends Omit<tl.RawReplyKeyboardHide, '_'> {
+    readonly type: 'reply_hide';
+}
+/**
+ * Force the user to send a reply
+ */
+export interface ReplyKeyboardForceReply extends Omit<tl.RawReplyKeyboardForceReply, '_'> {
+    readonly type: 'force_reply';
+}
+/**
+ * Inline keyboard markup
+ */
+export interface InlineKeyboardMarkup {
+    readonly type: 'inline';
+    /**
+     * Two-dimensional array of buttons
+     */
+    readonly buttons: tl.TypeKeyboardButton[][];
+}
+export type ReplyMarkup = ReplyKeyboardMarkup | ReplyKeyboardHide | ReplyKeyboardForceReply | InlineKeyboardMarkup | tl.TypeReplyMarkup;
+/**
+ * Convenience methods wrapping TL
+ * objects creation for bot keyboard buttons.
+ *
+ * You can also use the type-discriminated objects directly.
+ *
+ * > **Note**: Button creation functions are intended to be used
+ * > with inline reply markup, unless stated otherwise
+ * > in the description.
+ */
+export declare namespace BotKeyboard {
+    /** Create a keyboard builder */
+    function builder(maxRowWidth?: number | null): BotKeyboardBuilder;
+    /**
+     * Create an inline keyboard markup
+     *
+     * @param buttons  Two-dimensional array of buttons
+     */
+    function inline(buttons: tl.TypeKeyboardButton[][]): InlineKeyboardMarkup;
+    /**
+     * Create a reply keyboard markup
+     *
+     * @param buttons  Two-dimensional array of buttons
+     * @param params  Additional parameters for the keyboard
+     */
+    function reply(buttons: tl.TypeKeyboardButton[][], params?: Omit<ReplyKeyboardMarkup, 'type' | 'buttons'>): ReplyKeyboardMarkup;
+    /**
+     * Hide the previously sent reply keyboard
+     *
+     * @param selective
+     *     Whether to remove the keyboard for specific users only. Targets:
+     *      - users that are @mentioned in the text of the Message
+     *      - in case this is a reply, sender of the original message
+     */
+    function hideReply(selective?: boolean): ReplyKeyboardHide;
+    /**
+     * Force the user to send a reply
+     */
+    function forceReply(params?: Omit<ReplyKeyboardForceReply, 'type'>): ReplyKeyboardForceReply;
+    /**
+     * Create a text-only keyboard button.
+     *
+     * Used for reply keyboards, not inline!
+     *
+     * @param text  Button text
+     */
+    function text(text: string): tl.RawKeyboardButton;
+    /**
+     * Create a keyboard button requesting for user's contact.
+     * Available only for private chats.
+     *
+     * Used for reply keyboards, not inline!
+     *
+     * @param text  Button text
+     */
+    function requestContact(text: string): tl.RawKeyboardButtonRequestPhone;
+    /**
+     * Create a keyboard button requesting for user's geo location.
+     * Available only for private chats.
+     *
+     * Used for reply keyboards, not inline!
+     *
+     * @param text  Button text
+     */
+    function requestGeo(text: string): tl.RawKeyboardButtonRequestGeoLocation;
+    /**
+     * Create a keyboard button requesting the user to create and send a poll.
+     * Available only for private chats.
+     *
+     * Used for reply keyboards, not inline!
+     *
+     * @param text  Button text
+     * @param quiz  If set, only quiz polls can be sent
+     */
+    function requestPoll(text: string, quiz?: boolean): tl.RawKeyboardButtonRequestPoll;
+    /**
+     * Create a keyboard button with a link.
+     *
+     * Used for inline keyboards, not reply!
+     *
+     * @param text  Button text
+     * @param url  URL
+     */
+    function url(text: string, url: string): tl.RawKeyboardButtonUrl;
+    /**
+     * Create a keyboard button with a link.
+     *
+     * Used for inline keyboards, not reply!
+     *
+     * @param text  Button text
+     * @param data  Callback data (1-64 bytes). String will be converted to `Buffer`
+     * @param requiresPassword
+     *   Whether the user should verify their identity by entering 2FA password.
+     *   See more: {@link tl.RawKeyboardButtonCallback#requiresPassword}
+     */
+    function callback(text: string, data: string | Uint8Array, requiresPassword?: boolean): tl.RawKeyboardButtonCallback;
+    /**
+     * Button to force a user to switch to inline mode.
+     *
+     * Pressing the button will prompt the user to select
+     * one of their chats, open that chat and insert the bot‘s
+     * username and the specified inline query (if any) in the input field.
+     *
+     * Used for inline keyboards, not reply!
+     *
+     * @param text  Button text
+     * @param query  Inline query (can be empty or omitted)
+     * @param currentChat
+     *     If set, pressing the button will insert the bot's username
+     *     and the specified inline query in the current chat's input field
+     */
+    function switchInline(text: string, query?: string, currentChat?: boolean): tl.RawKeyboardButtonSwitchInline;
+    /**
+     * Button to start a game
+     *
+     * Used for inline keyboards, not reply!
+     *
+     * **Note**: This type of button must always be
+     * the first button in the first row. ID of the
+     * game is inferred from {@link InputMedia.game},
+     * thus this button should only be used with it.
+     */
+    function game(text: string): tl.RawKeyboardButtonGame;
+    /**
+     * Button to pay for a product.
+     *
+     * Used for inline keyboards, not reply!
+     *
+     * **Note**: This type of button must always be
+     * the first button in the first row. Related
+     * invoice is inferred from {@link InputMedia.invoice},
+     * thus this button should only be used with it.
+     */
+    function pay(text: string): tl.RawKeyboardButtonBuy;
+    /**
+     * Button to authorize a user
+     *
+     * Used for inline keyboards, not reply!
+     *
+     * @param text  Button label
+     * @param url  Authorization URL (see {@link tl.RawInputKeyboardButtonUrlAuth})
+     * @param params
+     */
+    function urlAuth(text: string, url: string, params?: {
+        /**
+         * Button label when forwarded
+         */
+        fwdText?: string;
+        /**
+         * Whether to request the permission for
+         * your bot to send messages to the user
+         */
+        requestWriteAccess?: boolean;
+        /**
+         * Bot, which will be used for user authorization.
+         * `url` domain must be the same as the domain linked
+         * with the bot.
+         *
+         * @default  current bot
+         */
+        bot?: tl.TypeInputUser;
+    }): tl.RawInputKeyboardButtonUrlAuth;
+    /**
+     * Button to open webview
+     *
+     * Used for both inline keyboards and reply ones
+     *
+     * @param text  Button label
+     * @param url  WebView URL
+     */
+    function webView(text: string, url: string): tl.RawKeyboardButtonWebView;
+    /**
+     * Button to open user profile
+     *
+     * @param text  Text of the button
+     * @param user  User to be opened (use {@link TelegramClient.resolvePeer})
+     */
+    function userProfile(text: string, user: tl.TypeInputPeer): tl.RawInputKeyboardButtonUserProfile;
+    /**
+     * Button to request a peer from the user
+     *
+     * @param text  Text of the button
+     * @param buttonId  ID of the button that will later be passed to the service message
+     */
+    function requestPeer(text: string, buttonId: number, params: {
+        /**
+         * Peer type, along with filters
+         */
+        peerType: tl.TypeRequestPeerType;
+        /**
+         * Maximum number of peers to be selected
+         *
+         * @default  1
+         */
+        count?: number;
+    }): tl.RawKeyboardButtonRequestPeer;
+    /**
+     * Find a button in the keyboard by its text or by predicate
+     *
+     * @param buttons  Two-dimensional array of buttons
+     * @param predicate  Button text or predicate function
+     */
+    function findButton(buttons: tl.TypeKeyboardButton[][], predicate: string | ((btn: tl.TypeKeyboardButton) => boolean)): tl.TypeKeyboardButton | null;
+}