@mtcute/core 0.5.0 → 0.7.0

package/esm/highlevel/methods/messages/send-text.js

@@ -0,0 +1,91 @@
+import { MtTypeAssertionError } from '../../../types/errors.js';
+import { randomLong } from '../../../utils/long-utils.js';
+import { getMarkedPeerId } from '../../../utils/peer-utils.js';
+import { BotKeyboard } from '../../types/bots/keyboards.js';
+import { Message } from '../../types/messages/message.js';
+import { PeersIndex } from '../../types/peers/index.js';
+import { createDummyUpdate } from '../../updates/utils.js';
+import { inputPeerToPeer } from '../../utils/peer-utils.js';
+import { _getRawPeerBatched } from '../chats/batched-queries.js';
+import { _normalizeInputText } from '../misc/normalize-text.js';
+import { resolvePeer } from '../users/resolve-peer.js';
+import { _findMessageInUpdate } from './find-in-update.js';
+import { _processCommonSendParameters } from './send-common.js';
+/**
+ * Send a text message
+ *
+ * @param chatId  ID of the chat, its username, phone or `"me"` or `"self"`
+ * @param text  Text of the message
+ * @param params  Additional sending parameters
+ */
+export async function sendText(client, chatId, text, params) {
+    if (!params)
+        params = {};
+    const [message, entities] = await _normalizeInputText(client, text);
+    const replyMarkup = BotKeyboard._convertToTl(params.replyMarkup);
+    const { peer, replyTo, scheduleDate, chainId } = await _processCommonSendParameters(client, chatId, params);
+    const res = await client.call({
+        _: 'messages.sendMessage',
+        peer,
+        noWebpage: params.disableWebPreview,
+        silent: params.silent,
+        replyTo,
+        randomId: randomLong(),
+        scheduleDate,
+        replyMarkup,
+        message,
+        entities,
+        clearDraft: params.clearDraft,
+        noforwards: params.forbidForwards,
+        sendAs: params.sendAs ? await resolvePeer(client, params.sendAs) : undefined,
+        invertMedia: params.invertMedia,
+    }, { chainId });
+    if (res._ === 'updateShortSentMessage') {
+        // todo extract this to updates manager?
+        const msg = {
+            _: 'message',
+            id: res.id,
+            peerId: inputPeerToPeer(peer),
+            fromId: { _: 'peerUser', userId: client.storage.self.getCached().userId },
+            message,
+            date: res.date,
+            out: res.out,
+            replyMarkup,
+            entities: res.entities,
+        };
+        // is this needed?
+        // this._date = res.date
+        client.handleClientUpdate(createDummyUpdate(res.pts, res.ptsCount));
+        const peers = new PeersIndex();
+        const fetchPeer = async (peer) => {
+            const id = getMarkedPeerId(peer);
+            let cached = await client.storage.peers.getCompleteById(id);
+            if (!cached) {
+                cached = await _getRawPeerBatched(client, await resolvePeer(client, peer));
+            }
+            if (!cached) {
+                throw new MtTypeAssertionError('sendText (@ getFullPeerById)', 'user | chat', 'null');
+            }
+            switch (cached._) {
+                case 'user':
+                    peers.users.set(cached.id, cached);
+                    break;
+                case 'chat':
+                case 'chatForbidden':
+                case 'channel':
+                case 'channelForbidden':
+                    peers.chats.set(cached.id, cached);
+                    break;
+                default:
+                    throw new MtTypeAssertionError('sendText (@ users.getUsers)', 'user | chat | channel', // not very accurate, but good enough
+                    cached._);
+            }
+        };
+        await Promise.all([fetchPeer(peer), fetchPeer(msg.fromId)]);
+        const ret = new Message(msg, peers);
+        return ret;
+    }
+    const msg = _findMessageInUpdate(client, res, false, !params.shouldDispatch);
+    return msg;
+}
+//# sourceMappingURL=send-text.js.map

package/esm/highlevel/methods/messages/send-text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"send-text.js","sourceRoot":"","sources":["../../../../../src/highlevel/methods/messages/send-text.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAA;AAC/D,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAA;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAA;AAE9D,OAAO,EAAE,WAAW,EAAe,MAAM,+BAA+B,CAAA;AACxE,OAAO,EAAE,OAAO,EAAE,MAAM,iCAAiC,CAAA;AAEzD,OAAO,EAAiB,UAAU,EAAE,MAAM,4BAA4B,CAAA;AACtE,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAA;AAC3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAA;AAChE,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAA;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAA;AACtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAA;AAE1D,OAAO,EAAE,4BAA4B,EAAoB,MAAM,kBAAkB,CAAA;AAEjF;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC1B,MAAuB,EACvB,MAAqB,EACrB,IAAe,EACf,MAmBC;IAED,IAAI,CAAC,MAAM;QAAE,MAAM,GAAG,EAAE,CAAA;IAExB,MAAM,CAAC,OAAO,EAAE,QAAQ,CAAC,GAAG,MAAM,mBAAmB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;IAEnE,MAAM,WAAW,GAAG,WAAW,CAAC,YAAY,CAAC,MAAM,CAAC,WAAW,CAAC,CAAA;IAChE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,GAAG,MAAM,4BAA4B,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;IAE3G,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,IAAI,CACzB;QACI,CAAC,EAAE,sBAAsB;QACzB,IAAI;QACJ,SAAS,EAAE,MAAM,CAAC,iBAAiB;QACnC,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,OAAO;QACP,QAAQ,EAAE,UAAU,EAAE;QACtB,YAAY;QACZ,WAAW;QACX,OAAO;QACP,QAAQ;QACR,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,UAAU,EAAE,MAAM,CAAC,cAAc;QACjC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS;QAC5E,WAAW,EAAE,MAAM,CAAC,WAAW;KAClC,EACD,EAAE,OAAO,EAAE,CACd,CAAA;IAED,IAAI,GAAG,CAAC,CAAC,KAAK,wBAAwB,EAAE;QACpC,wCAAwC;QACxC,MAAM,GAAG,GAAkB;YACvB,CAAC,EAAE,SAAS;YACZ,EAAE,EAAE,GAAG,CAAC,EAAE;YACV,MAAM,EAAE,eAAe,CAAC,IAAI,CAAC;YAC7B,MAAM,EAAE,EAAE,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,EAAG,CAAC,MAAM,EAAE;YAC1E,OAAO;YACP,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,GAAG,EAAE,GAAG,CAAC,GAAG;YACZ,WAAW;YACX,QAAQ,EAAE,GAAG,CAAC,QAAQ;SACzB,CAAA;QAED,kBAAkB;QAClB,wBAAwB;QACxB,MAAM,CAAC,kBAAkB,CAAC,iBAAiB,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAA;QAEnE,MAAM,KAAK,GAAG,IAAI,UAAU,EAAE,CAAA;QAE9B,MAAM,SAAS,GAAG,KAAK,EAAE,IAAoC,EAAiB,EAAE;YAC5E,MAAM,EAAE,GAAG,eAAe,CAAC,IAAI,CAAC,CAAA;YAEhC,IAAI,MAAM,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,eAAe,CAAC,EAAE,CAAC,CAAA;YAE3D,IAAI,CAAC,MAAM,EAAE;gBACT,MAAM,GAAG,MAAM,kBAAkB,CAAC,MAAM,EAAE,MAAM,WAAW,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAA;aAC7E;YAED,IAAI,CAAC,MAAM,EAAE;gBACT,MAAM,IAAI,oBAAoB,CAAC,8BAA8B,EAAE,aAAa,EAAE,MAAM,CAAC,CAAA;aACxF;YAED,QAAQ,MAAM,CAAC,CAAC,EAAE;gBACd,KAAK,MAAM;oBACP,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,CAAA;oBAClC,MAAK;gBACT,KAAK,MAAM,CAAC;gBACZ,KAAK,eAAe,CAAC;gBACrB,KAAK,SAAS,CAAC;gBACf,KAAK,kBAAkB;oBACnB,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,CAAA;oBAClC,MAAK;gBACT;oBACI,MAAM,IAAI,oBAAoB,CAC1B,6BAA6B,EAC7B,uBAAuB,EAAE,qCAAqC;oBAC9D,MAAM,CAAC,CAAC,CACX,CAAA;aACR;QACL,CAAC,CAAA;QAED,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,SAAS,CAAC,GAAG,CAAC,MAAO,CAAC,CAAC,CAAC,CAAA;QAE5D,MAAM,GAAG,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;QAEnC,OAAO,GAAG,CAAA;KACb;IAED,MAAM,GAAG,GAAG,oBAAoB,CAAC,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,MAAM,CAAC,cAAc,CAAC,CAAA;IAE5E,OAAO,GAAG,CAAA;AACd,CAAC","sourcesContent":["import { tl } from '@mtcute/tl'\n\nimport { MtTypeAssertionError } from '../../../types/errors.js'\nimport { randomLong } from '../../../utils/long-utils.js'\nimport { getMarkedPeerId } from '../../../utils/peer-utils.js'\nimport { ITelegramClient } from '../../client.types.js'\nimport { BotKeyboard, ReplyMarkup } from '../../types/bots/keyboards.js'\nimport { Message } from '../../types/messages/message.js'\nimport { InputText } from '../../types/misc/entities.js'\nimport { InputPeerLike, PeersIndex } from '../../types/peers/index.js'\nimport { createDummyUpdate } from '../../updates/utils.js'\nimport { inputPeerToPeer } from '../../utils/peer-utils.js'\nimport { _getRawPeerBatched } from '../chats/batched-queries.js'\nimport { _normalizeInputText } from '../misc/normalize-text.js'\nimport { resolvePeer } from '../users/resolve-peer.js'\nimport { _findMessageInUpdate } from './find-in-update.js'\nimport { _getDiscussionMessage } from './get-discussion-message.js'\nimport { _processCommonSendParameters, CommonSendParams } from './send-common.js'\n\n/**\n * Send a text message\n *\n * @param chatId  ID of the chat, its username, phone or `\"me\"` or `\"self\"`\n * @param text  Text of the message\n * @param params  Additional sending parameters\n */\nexport async function sendText(\n    client: ITelegramClient,\n    chatId: InputPeerLike,\n    text: InputText,\n    params?: CommonSendParams & {\n        /**\n         * For bots: inline or reply markup or an instruction\n         * to hide a reply keyboard or to force a reply.\n         */\n        replyMarkup?: ReplyMarkup\n\n        /**\n         * Whether to disable links preview in this message\n         */\n        disableWebPreview?: boolean\n\n        /**\n         * Whether to invert media position.\n         *\n         * Currently only supported for web previews and makes the\n         * client render the preview above the caption and not below.\n         */\n        invertMedia?: boolean\n    },\n): Promise<Message> {\n    if (!params) params = {}\n\n    const [message, entities] = await _normalizeInputText(client, text)\n\n    const replyMarkup = BotKeyboard._convertToTl(params.replyMarkup)\n    const { peer, replyTo, scheduleDate, chainId } = await _processCommonSendParameters(client, chatId, params)\n\n    const res = await client.call(\n        {\n            _: 'messages.sendMessage',\n            peer,\n            noWebpage: params.disableWebPreview,\n            silent: params.silent,\n            replyTo,\n            randomId: randomLong(),\n            scheduleDate,\n            replyMarkup,\n            message,\n            entities,\n            clearDraft: params.clearDraft,\n            noforwards: params.forbidForwards,\n            sendAs: params.sendAs ? await resolvePeer(client, params.sendAs) : undefined,\n            invertMedia: params.invertMedia,\n        },\n        { chainId },\n    )\n\n    if (res._ === 'updateShortSentMessage') {\n        // todo extract this to updates manager?\n        const msg: tl.RawMessage = {\n            _: 'message',\n            id: res.id,\n            peerId: inputPeerToPeer(peer),\n            fromId: { _: 'peerUser', userId: client.storage.self.getCached()!.userId },\n            message,\n            date: res.date,\n            out: res.out,\n            replyMarkup,\n            entities: res.entities,\n        }\n\n        // is this needed?\n        // this._date = res.date\n        client.handleClientUpdate(createDummyUpdate(res.pts, res.ptsCount))\n\n        const peers = new PeersIndex()\n\n        const fetchPeer = async (peer: tl.TypePeer | tl.TypeInputPeer): Promise<void> => {\n            const id = getMarkedPeerId(peer)\n\n            let cached = await client.storage.peers.getCompleteById(id)\n\n            if (!cached) {\n                cached = await _getRawPeerBatched(client, await resolvePeer(client, peer))\n            }\n\n            if (!cached) {\n                throw new MtTypeAssertionError('sendText (@ getFullPeerById)', 'user | chat', 'null')\n            }\n\n            switch (cached._) {\n                case 'user':\n                    peers.users.set(cached.id, cached)\n                    break\n                case 'chat':\n                case 'chatForbidden':\n                case 'channel':\n                case 'channelForbidden':\n                    peers.chats.set(cached.id, cached)\n                    break\n                default:\n                    throw new MtTypeAssertionError(\n                        'sendText (@ users.getUsers)',\n                        'user | chat | channel', // not very accurate, but good enough\n                        cached._,\n                    )\n            }\n        }\n\n        await Promise.all([fetchPeer(peer), fetchPeer(msg.fromId!)])\n\n        const ret = new Message(msg, peers)\n\n        return ret\n    }\n\n    const msg = _findMessageInUpdate(client, res, false, !params.shouldDispatch)\n\n    return msg\n}\n"]}

package/esm/highlevel/methods/messages/send-text.test.d.ts

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

package/esm/highlevel/methods/messages/send-text.test.js

@@ -0,0 +1,135 @@
+import Long from 'long';
+import { describe, expect, it, vi } from 'vitest';
+import { createStub, StubTelegramClient } from '@mtcute/test';
+import { toggleChannelIdMark } from '../../../utils/peer-utils.js';
+import { sendText } from './send-text.js';
+const stubUser = createStub('user', {
+    id: 123123,
+    accessHash: Long.fromBits(123, 456),
+});
+const stubChannel = createStub('channel', {
+    id: 444222,
+    accessHash: Long.fromBits(666, 777),
+    megagroup: true,
+});
+describe('sendText', () => {
+    it('should correctly handle updateNewMessage', async () => {
+        const client = new StubTelegramClient();
+        client.respondWith('messages.sendMessage', (req) => createStub('updates', {
+            users: [stubUser],
+            updates: [
+                {
+                    _: 'updateMessageID',
+                    randomId: req.randomId,
+                    id: 123,
+                },
+                {
+                    _: 'updateNewMessage',
+                    pts: 0,
+                    ptsCount: 1,
+                    message: createStub('message', {
+                        id: 123,
+                        message: req.message,
+                        peerId: {
+                            _: 'peerUser',
+                            userId: stubUser.id,
+                        },
+                    }),
+                },
+            ],
+        }));
+        await client.with(async () => {
+            const msg = await sendText(client, stubUser.id, 'test');
+            expect(msg).toBeDefined();
+            expect(msg.id).toEqual(123);
+            expect(msg.chat.chatType).toEqual('private');
+            expect(msg.chat.id).toEqual(stubUser.id);
+            expect(msg.text).toEqual('test');
+        });
+    });
+    it('should correctly handle updateNewChannelMessage', async () => {
+        const client = new StubTelegramClient();
+        client.respondWith('messages.sendMessage', (req) => createStub('updates', {
+            users: [stubUser],
+            chats: [stubChannel],
+            updates: [
+                {
+                    _: 'updateMessageID',
+                    randomId: req.randomId,
+                    id: 123,
+                },
+                {
+                    _: 'updateNewChannelMessage',
+                    pts: 0,
+                    ptsCount: 1,
+                    message: createStub('message', {
+                        id: 123,
+                        message: req.message,
+                        peerId: {
+                            _: 'peerChannel',
+                            channelId: stubChannel.id,
+                        },
+                    }),
+                },
+            ],
+        }));
+        await client.with(async () => {
+            const markedChannelId = toggleChannelIdMark(stubChannel.id);
+            const msg = await sendText(client, markedChannelId, 'test');
+            expect(msg).toBeDefined();
+            expect(msg.id).toEqual(123);
+            expect(msg.chat.chatType).toEqual('supergroup');
+            expect(msg.chat.id).toEqual(markedChannelId);
+            expect(msg.text).toEqual('test');
+        });
+    });
+    it('should correctly handle updateShortSentMessage with cached peer', async () => {
+        const client = new StubTelegramClient();
+        await client.storage.self.store({
+            userId: stubUser.id,
+            isBot: false,
+            isPremium: false,
+            usernames: [],
+        });
+        await client.registerPeers(stubUser);
+        client.respondWith('messages.sendMessage', () => createStub('updateShortSentMessage', {
+            id: 123,
+            out: true,
+        }));
+        await client.with(async () => {
+            const msg = await sendText(client, stubUser.id, 'test');
+            expect(msg).toBeDefined();
+            expect(msg.id).toEqual(123);
+            expect(msg.chat.chatType).toEqual('private');
+            expect(msg.chat.id).toEqual(stubUser.id);
+            expect(msg.text).toEqual('test');
+        });
+    });
+    it('should correctly handle updateShortSentMessage without cached peer', async () => {
+        const client = new StubTelegramClient();
+        await client.storage.self.store({
+            userId: stubUser.id,
+            isBot: false,
+            isPremium: false,
+            usernames: [],
+        });
+        const getUsersFn = client.respondWith('users.getUsers', vi.fn(() => [stubUser]));
+        client.respondWith('messages.sendMessage', () => createStub('updateShortSentMessage', {
+            id: 123,
+            out: true,
+        }));
+        await client.with(async () => {
+            const msg = await sendText(client, stubUser.id, 'test');
+            expect(getUsersFn).toHaveBeenCalledWith({
+                _: 'users.getUsers',
+                id: [{ _: 'inputUser', userId: stubUser.id, accessHash: Long.ZERO }],
+            });
+            expect(msg).toBeDefined();
+            expect(msg.id).toEqual(123);
+            expect(msg.chat.chatType).toEqual('private');
+            expect(msg.chat.id).toEqual(stubUser.id);
+            expect(msg.text).toEqual('test');
+        });
+    });
+});
+//# sourceMappingURL=send-text.test.js.map

package/esm/highlevel/methods/messages/send-text.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"send-text.test.js","sourceRoot":"","sources":["../../../../../src/highlevel/methods/messages/send-text.test.ts"],"names":[],"mappings":"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","sourcesContent":["import Long from 'long'\nimport { describe, expect, it, vi } from 'vitest'\n\nimport { createStub, StubTelegramClient } from '@mtcute/test'\n\nimport { toggleChannelIdMark } from '../../../utils/peer-utils.js'\nimport { sendText } from './send-text.js'\n\nconst stubUser = createStub('user', {\n    id: 123123,\n    accessHash: Long.fromBits(123, 456),\n})\nconst stubChannel = createStub('channel', {\n    id: 444222,\n    accessHash: Long.fromBits(666, 777),\n    megagroup: true,\n})\n\ndescribe('sendText', () => {\n    it('should correctly handle updateNewMessage', async () => {\n        const client = new StubTelegramClient()\n\n        client.respondWith('messages.sendMessage', (req) =>\n            createStub('updates', {\n                users: [stubUser],\n                updates: [\n                    {\n                        _: 'updateMessageID',\n                        randomId: req.randomId,\n                        id: 123,\n                    },\n                    {\n                        _: 'updateNewMessage',\n                        pts: 0,\n                        ptsCount: 1,\n                        message: createStub('message', {\n                            id: 123,\n                            message: req.message,\n                            peerId: {\n                                _: 'peerUser',\n                                userId: stubUser.id,\n                            },\n                        }),\n                    },\n                ],\n            }),\n        )\n\n        await client.with(async () => {\n            const msg = await sendText(client, stubUser.id, 'test')\n\n            expect(msg).toBeDefined()\n            expect(msg.id).toEqual(123)\n            expect(msg.chat.chatType).toEqual('private')\n            expect(msg.chat.id).toEqual(stubUser.id)\n            expect(msg.text).toEqual('test')\n        })\n    })\n\n    it('should correctly handle updateNewChannelMessage', async () => {\n        const client = new StubTelegramClient()\n\n        client.respondWith('messages.sendMessage', (req) =>\n            createStub('updates', {\n                users: [stubUser],\n                chats: [stubChannel],\n                updates: [\n                    {\n                        _: 'updateMessageID',\n                        randomId: req.randomId,\n                        id: 123,\n                    },\n                    {\n                        _: 'updateNewChannelMessage',\n                        pts: 0,\n                        ptsCount: 1,\n                        message: createStub('message', {\n                            id: 123,\n                            message: req.message,\n                            peerId: {\n                                _: 'peerChannel',\n                                channelId: stubChannel.id,\n                            },\n                        }),\n                    },\n                ],\n            }),\n        )\n\n        await client.with(async () => {\n            const markedChannelId = toggleChannelIdMark(stubChannel.id)\n\n            const msg = await sendText(client, markedChannelId, 'test')\n\n            expect(msg).toBeDefined()\n            expect(msg.id).toEqual(123)\n            expect(msg.chat.chatType).toEqual('supergroup')\n            expect(msg.chat.id).toEqual(markedChannelId)\n            expect(msg.text).toEqual('test')\n        })\n    })\n\n    it('should correctly handle updateShortSentMessage with cached peer', async () => {\n        const client = new StubTelegramClient()\n\n        await client.storage.self.store({\n            userId: stubUser.id,\n            isBot: false,\n            isPremium: false,\n            usernames: [],\n        })\n        await client.registerPeers(stubUser)\n\n        client.respondWith('messages.sendMessage', () =>\n            createStub('updateShortSentMessage', {\n                id: 123,\n                out: true,\n            }),\n        )\n\n        await client.with(async () => {\n            const msg = await sendText(client, stubUser.id, 'test')\n\n            expect(msg).toBeDefined()\n            expect(msg.id).toEqual(123)\n            expect(msg.chat.chatType).toEqual('private')\n            expect(msg.chat.id).toEqual(stubUser.id)\n            expect(msg.text).toEqual('test')\n        })\n    })\n\n    it('should correctly handle updateShortSentMessage without cached peer', async () => {\n        const client = new StubTelegramClient()\n\n        await client.storage.self.store({\n            userId: stubUser.id,\n            isBot: false,\n            isPremium: false,\n            usernames: [],\n        })\n\n        const getUsersFn = client.respondWith(\n            'users.getUsers',\n            vi.fn(() => [stubUser]),\n        )\n\n        client.respondWith('messages.sendMessage', () =>\n            createStub('updateShortSentMessage', {\n                id: 123,\n                out: true,\n            }),\n        )\n\n        await client.with(async () => {\n            const msg = await sendText(client, stubUser.id, 'test')\n\n            expect(getUsersFn).toHaveBeenCalledWith({\n                _: 'users.getUsers',\n                id: [{ _: 'inputUser', userId: stubUser.id, accessHash: Long.ZERO }],\n            })\n\n            expect(msg).toBeDefined()\n            expect(msg.id).toEqual(123)\n            expect(msg.chat.chatType).toEqual('private')\n            expect(msg.chat.id).toEqual(stubUser.id)\n            expect(msg.text).toEqual('test')\n        })\n    })\n})\n"]}

package/esm/highlevel/methods/messages/send-typing.d.ts

@@ -0,0 +1,25 @@
+import { tl } from '@mtcute/tl';
+import { ITelegramClient } from '../../client.types.js';
+import { InputPeerLike, TypingStatus } from '../../types/index.js';
+/**
+ * Sends a current user/bot typing event
+ * to a conversation partner or group.
+ *
+ * This status is set for 6 seconds, and is
+ * automatically cancelled if you send a
+ * message.
+ *
+ * @param chatId  Chat ID
+ * @param status  Typing status
+ * @param params
+ */
+export declare function sendTyping(client: ITelegramClient, chatId: InputPeerLike, status?: Exclude<TypingStatus, 'interaction' | 'interaction_seen'> | tl.TypeSendMessageAction, params?: {
+    /**
+     * For `upload_*` and history import actions, progress of the upload
+     */
+    progress?: number;
+    /**
+     * For comment threads, ID of the thread (i.e. top message)
+     */
+    threadId?: number;
+}): Promise<void>;

package/esm/highlevel/methods/messages/send-typing.js

@@ -0,0 +1,80 @@
+import { assertNever } from '../../../types/utils.js';
+import { assertTrue } from '../../../utils/type-assertions.js';
+import { resolvePeer } from '../users/resolve-peer.js';
+/**
+ * Sends a current user/bot typing event
+ * to a conversation partner or group.
+ *
+ * This status is set for 6 seconds, and is
+ * automatically cancelled if you send a
+ * message.
+ *
+ * @param chatId  Chat ID
+ * @param status  Typing status
+ * @param params
+ */
+export async function sendTyping(client, chatId, status = 'typing', params) {
+    if (typeof status === 'string') {
+        const progress = params?.progress ?? 0;
+        switch (status) {
+            case 'typing':
+                status = { _: 'sendMessageTypingAction' };
+                break;
+            case 'cancel':
+                status = { _: 'sendMessageCancelAction' };
+                break;
+            case 'record_video':
+                status = { _: 'sendMessageRecordVideoAction' };
+                break;
+            case 'upload_video':
+                status = { _: 'sendMessageUploadVideoAction', progress };
+                break;
+            case 'record_voice':
+                status = { _: 'sendMessageRecordAudioAction' };
+                break;
+            case 'upload_voice':
+                status = { _: 'sendMessageUploadAudioAction', progress };
+                break;
+            case 'upload_photo':
+                status = { _: 'sendMessageUploadPhotoAction', progress };
+                break;
+            case 'upload_document':
+                status = { _: 'sendMessageUploadDocumentAction', progress };
+                break;
+            case 'geo':
+                status = { _: 'sendMessageGeoLocationAction' };
+                break;
+            case 'contact':
+                status = { _: 'sendMessageChooseContactAction' };
+                break;
+            case 'game':
+                status = { _: 'sendMessageGamePlayAction' };
+                break;
+            case 'record_round':
+                status = { _: 'sendMessageRecordRoundAction' };
+                break;
+            case 'upload_round':
+                status = { _: 'sendMessageUploadRoundAction', progress };
+                break;
+            case 'speak_call':
+                status = { _: 'speakingInGroupCallAction' };
+                break;
+            case 'history_import':
+                status = { _: 'sendMessageHistoryImportAction', progress };
+                break;
+            case 'sticker':
+                status = { _: 'sendMessageChooseStickerAction' };
+                break;
+            default:
+                assertNever(status);
+        }
+    }
+    const r = await client.call({
+        _: 'messages.setTyping',
+        peer: await resolvePeer(client, chatId),
+        action: status,
+        topMsgId: params?.threadId,
+    });
+    assertTrue('messages.setTyping', r);
+}
+//# sourceMappingURL=send-typing.js.map

package/esm/highlevel/methods/messages/send-typing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"send-typing.js","sourceRoot":"","sources":["../../../../../src/highlevel/methods/messages/send-typing.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,mCAAmC,CAAA;AAG9D,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAA;AAEtD;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC5B,MAAuB,EACvB,MAAqB,EACrB,SAA+F,QAAQ,EACvG,MAUC;IAED,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE;QAC5B,MAAM,QAAQ,GAAG,MAAM,EAAE,QAAQ,IAAI,CAAC,CAAA;QAEtC,QAAQ,MAAM,EAAE;YACZ,KAAK,QAAQ;gBACT,MAAM,GAAG,EAAE,CAAC,EAAE,yBAAyB,EAAE,CAAA;gBACzC,MAAK;YACT,KAAK,QAAQ;gBACT,MAAM,GAAG,EAAE,CAAC,EAAE,yBAAyB,EAAE,CAAA;gBACzC,MAAK;YACT,KAAK,cAAc;gBACf,MAAM,GAAG,EAAE,CAAC,EAAE,8BAA8B,EAAE,CAAA;gBAC9C,MAAK;YACT,KAAK,cAAc;gBACf,MAAM,GAAG,EAAE,CAAC,EAAE,8BAA8B,EAAE,QAAQ,EAAE,CAAA;gBACxD,MAAK;YACT,KAAK,cAAc;gBACf,MAAM,GAAG,EAAE,CAAC,EAAE,8BAA8B,EAAE,CAAA;gBAC9C,MAAK;YACT,KAAK,cAAc;gBACf,MAAM,GAAG,EAAE,CAAC,EAAE,8BAA8B,EAAE,QAAQ,EAAE,CAAA;gBACxD,MAAK;YACT,KAAK,cAAc;gBACf,MAAM,GAAG,EAAE,CAAC,EAAE,8BAA8B,EAAE,QAAQ,EAAE,CAAA;gBACxD,MAAK;YACT,KAAK,iBAAiB;gBAClB,MAAM,GAAG,EAAE,CAAC,EAAE,iCAAiC,EAAE,QAAQ,EAAE,CAAA;gBAC3D,MAAK;YACT,KAAK,KAAK;gBACN,MAAM,GAAG,EAAE,CAAC,EAAE,8BAA8B,EAAE,CAAA;gBAC9C,MAAK;YACT,KAAK,SAAS;gBACV,MAAM,GAAG,EAAE,CAAC,EAAE,gCAAgC,EAAE,CAAA;gBAChD,MAAK;YACT,KAAK,MAAM;gBACP,MAAM,GAAG,EAAE,CAAC,EAAE,2BAA2B,EAAE,CAAA;gBAC3C,MAAK;YACT,KAAK,cAAc;gBACf,MAAM,GAAG,EAAE,CAAC,EAAE,8BAA8B,EAAE,CAAA;gBAC9C,MAAK;YACT,KAAK,cAAc;gBACf,MAAM,GAAG,EAAE,CAAC,EAAE,8BAA8B,EAAE,QAAQ,EAAE,CAAA;gBACxD,MAAK;YACT,KAAK,YAAY;gBACb,MAAM,GAAG,EAAE,CAAC,EAAE,2BAA2B,EAAE,CAAA;gBAC3C,MAAK;YACT,KAAK,gBAAgB;gBACjB,MAAM,GAAG,EAAE,CAAC,EAAE,gCAAgC,EAAE,QAAQ,EAAE,CAAA;gBAC1D,MAAK;YACT,KAAK,SAAS;gBACV,MAAM,GAAG,EAAE,CAAC,EAAE,gCAAgC,EAAE,CAAA;gBAChD,MAAK;YACT;gBACI,WAAW,CAAC,MAAM,CAAC,CAAA;SAC1B;KACJ;IAED,MAAM,CAAC,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC;QACxB,CAAC,EAAE,oBAAoB;QACvB,IAAI,EAAE,MAAM,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC;QACvC,MAAM,EAAE,MAAM;QACd,QAAQ,EAAE,MAAM,EAAE,QAAQ;KAC7B,CAAC,CAAA;IAEF,UAAU,CAAC,oBAAoB,EAAE,CAAC,CAAC,CAAA;AACvC,CAAC","sourcesContent":["import { tl } from '@mtcute/tl'\n\nimport { assertNever } from '../../../types/utils.js'\nimport { assertTrue } from '../../../utils/type-assertions.js'\nimport { ITelegramClient } from '../../client.types.js'\nimport { InputPeerLike, TypingStatus } from '../../types/index.js'\nimport { resolvePeer } from '../users/resolve-peer.js'\n\n/**\n * Sends a current user/bot typing event\n * to a conversation partner or group.\n *\n * This status is set for 6 seconds, and is\n * automatically cancelled if you send a\n * message.\n *\n * @param chatId  Chat ID\n * @param status  Typing status\n * @param params\n */\nexport async function sendTyping(\n    client: ITelegramClient,\n    chatId: InputPeerLike,\n    status: Exclude<TypingStatus, 'interaction' | 'interaction_seen'> | tl.TypeSendMessageAction = 'typing',\n    params?: {\n        /**\n         * For `upload_*` and history import actions, progress of the upload\n         */\n        progress?: number\n\n        /**\n         * For comment threads, ID of the thread (i.e. top message)\n         */\n        threadId?: number\n    },\n): Promise<void> {\n    if (typeof status === 'string') {\n        const progress = params?.progress ?? 0\n\n        switch (status) {\n            case 'typing':\n                status = { _: 'sendMessageTypingAction' }\n                break\n            case 'cancel':\n                status = { _: 'sendMessageCancelAction' }\n                break\n            case 'record_video':\n                status = { _: 'sendMessageRecordVideoAction' }\n                break\n            case 'upload_video':\n                status = { _: 'sendMessageUploadVideoAction', progress }\n                break\n            case 'record_voice':\n                status = { _: 'sendMessageRecordAudioAction' }\n                break\n            case 'upload_voice':\n                status = { _: 'sendMessageUploadAudioAction', progress }\n                break\n            case 'upload_photo':\n                status = { _: 'sendMessageUploadPhotoAction', progress }\n                break\n            case 'upload_document':\n                status = { _: 'sendMessageUploadDocumentAction', progress }\n                break\n            case 'geo':\n                status = { _: 'sendMessageGeoLocationAction' }\n                break\n            case 'contact':\n                status = { _: 'sendMessageChooseContactAction' }\n                break\n            case 'game':\n                status = { _: 'sendMessageGamePlayAction' }\n                break\n            case 'record_round':\n                status = { _: 'sendMessageRecordRoundAction' }\n                break\n            case 'upload_round':\n                status = { _: 'sendMessageUploadRoundAction', progress }\n                break\n            case 'speak_call':\n                status = { _: 'speakingInGroupCallAction' }\n                break\n            case 'history_import':\n                status = { _: 'sendMessageHistoryImportAction', progress }\n                break\n            case 'sticker':\n                status = { _: 'sendMessageChooseStickerAction' }\n                break\n            default:\n                assertNever(status)\n        }\n    }\n\n    const r = await client.call({\n        _: 'messages.setTyping',\n        peer: await resolvePeer(client, chatId),\n        action: status,\n        topMsgId: params?.threadId,\n    })\n\n    assertTrue('messages.setTyping', r)\n}\n"]}

package/esm/highlevel/methods/messages/send-vote.d.ts

@@ -0,0 +1,15 @@
+import { MaybeArray } from '../../../types/utils.js';
+import { ITelegramClient } from '../../client.types.js';
+import { InputMessageId, Poll } from '../../types/index.js';
+/**
+ * Send or retract a vote in a poll.
+ */
+export declare function sendVote(client: ITelegramClient, params: InputMessageId & {
+    /**
+     * Selected options, or `null` to retract.
+     * You can pass indexes of the answers or the `Buffer`s
+     * representing them. In case of indexes, the poll will first
+     * be requested from the server.
+     */
+    options: null | MaybeArray<number | Uint8Array>;
+}): Promise<Poll>;

package/esm/highlevel/methods/messages/send-vote.js

@@ -0,0 +1,52 @@
+import { MtArgumentError, MtTypeAssertionError } from '../../../types/errors.js';
+import { getMarkedPeerId } from '../../../utils/peer-utils.js';
+import { assertTypeIs } from '../../../utils/type-assertions.js';
+import { MtMessageNotFoundError, normalizeInputMessageId, PeersIndex, Poll } from '../../types/index.js';
+import { assertIsUpdatesGroup } from '../../updates/utils.js';
+import { resolvePeer } from '../users/resolve-peer.js';
+import { getMessages } from './get-messages.js';
+/**
+ * Send or retract a vote in a poll.
+ */
+export async function sendVote(client, params) {
+    const { chatId, message } = normalizeInputMessageId(params);
+    let { options } = params;
+    if (options === null)
+        options = [];
+    if (!Array.isArray(options))
+        options = [options];
+    const peer = await resolvePeer(client, chatId);
+    let poll = undefined;
+    if (options.some((it) => typeof it === 'number')) {
+        const [msg] = await getMessages(client, peer, message);
+        if (!msg) {
+            throw new MtMessageNotFoundError(getMarkedPeerId(peer), message, 'to vote in');
+        }
+        if (!(msg.media instanceof Poll)) {
+            throw new MtArgumentError('This message does not contain a poll');
+        }
+        poll = msg.media;
+        options = options.map((opt) => {
+            if (typeof opt === 'number') {
+                return poll.raw.answers[opt].option;
+            }
+            return opt;
+        });
+    }
+    const res = await client.call({
+        _: 'messages.sendVote',
+        peer,
+        msgId: message,
+        options: options,
+    });
+    assertIsUpdatesGroup('messages.sendVote', res);
+    client.handleClientUpdate(res, true);
+    const upd = res.updates[0];
+    assertTypeIs('messages.sendVote (@ .updates[0])', upd, 'updateMessagePoll');
+    if (!upd.poll) {
+        throw new MtTypeAssertionError('messages.sendVote (@ .updates[0].poll)', 'poll', 'undefined');
+    }
+    const peers = PeersIndex.from(res);
+    return new Poll(upd.poll, peers, upd.results);
+}
+//# sourceMappingURL=send-vote.js.map

package/esm/highlevel/methods/messages/send-vote.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"send-vote.js","sourceRoot":"","sources":["../../../../../src/highlevel/methods/messages/send-vote.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAA;AAEhF,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAA;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAA;AAEhE,OAAO,EAAkB,sBAAsB,EAAE,uBAAuB,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAA;AACxH,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAA;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAE/C;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC1B,MAAuB,EACvB,MAQC;IAED,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,uBAAuB,CAAC,MAAM,CAAC,CAAA;IAC3D,IAAI,EAAE,OAAO,EAAE,GAAG,MAAM,CAAA;IAExB,IAAI,OAAO,KAAK,IAAI;QAAE,OAAO,GAAG,EAAE,CAAA;IAClC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;QAAE,OAAO,GAAG,CAAC,OAAO,CAAC,CAAA;IAEhD,MAAM,IAAI,GAAG,MAAM,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAE9C,IAAI,IAAI,GAAqB,SAAS,CAAA;IAEtC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,OAAO,EAAE,KAAK,QAAQ,CAAC,EAAE;QAC9C,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM,WAAW,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,CAAA;QAEtD,IAAI,CAAC,GAAG,EAAE;YACN,MAAM,IAAI,sBAAsB,CAAC,eAAe,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,YAAY,CAAC,CAAA;SACjF;QAED,IAAI,CAAC,CAAC,GAAG,CAAC,KAAK,YAAY,IAAI,CAAC,EAAE;YAC9B,MAAM,IAAI,eAAe,CAAC,sCAAsC,CAAC,CAAA;SACpE;QAED,IAAI,GAAG,GAAG,CAAC,KAAK,CAAA;QAChB,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;YAC1B,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE;gBACzB,OAAO,IAAK,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,CAAA;aACvC;YAED,OAAO,GAAG,CAAA;QACd,CAAC,CAAC,CAAA;KACL;IAED,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC;QAC1B,CAAC,EAAE,mBAAmB;QACtB,IAAI;QACJ,KAAK,EAAE,OAAO;QACd,OAAO,EAAE,OAAuB;KACnC,CAAC,CAAA;IAEF,oBAAoB,CAAC,mBAAmB,EAAE,GAAG,CAAC,CAAA;IAE9C,MAAM,CAAC,kBAAkB,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;IAEpC,MAAM,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAA;IAC1B,YAAY,CAAC,mCAAmC,EAAE,GAAG,EAAE,mBAAmB,CAAC,CAAA;IAE3E,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE;QACX,MAAM,IAAI,oBAAoB,CAAC,wCAAwC,EAAE,MAAM,EAAE,WAAW,CAAC,CAAA;KAChG;IAED,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IAElC,OAAO,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,CAAC,OAAO,CAAC,CAAA;AACjD,CAAC","sourcesContent":["import { MtArgumentError, MtTypeAssertionError } from '../../../types/errors.js'\nimport { MaybeArray } from '../../../types/utils.js'\nimport { getMarkedPeerId } from '../../../utils/peer-utils.js'\nimport { assertTypeIs } from '../../../utils/type-assertions.js'\nimport { ITelegramClient } from '../../client.types.js'\nimport { InputMessageId, MtMessageNotFoundError, normalizeInputMessageId, PeersIndex, Poll } from '../../types/index.js'\nimport { assertIsUpdatesGroup } from '../../updates/utils.js'\nimport { resolvePeer } from '../users/resolve-peer.js'\nimport { getMessages } from './get-messages.js'\n\n/**\n * Send or retract a vote in a poll.\n */\nexport async function sendVote(\n    client: ITelegramClient,\n    params: InputMessageId & {\n        /**\n         * Selected options, or `null` to retract.\n         * You can pass indexes of the answers or the `Buffer`s\n         * representing them. In case of indexes, the poll will first\n         * be requested from the server.\n         */\n        options: null | MaybeArray<number | Uint8Array>\n    },\n): Promise<Poll> {\n    const { chatId, message } = normalizeInputMessageId(params)\n    let { options } = params\n\n    if (options === null) options = []\n    if (!Array.isArray(options)) options = [options]\n\n    const peer = await resolvePeer(client, chatId)\n\n    let poll: Poll | undefined = undefined\n\n    if (options.some((it) => typeof it === 'number')) {\n        const [msg] = await getMessages(client, peer, message)\n\n        if (!msg) {\n            throw new MtMessageNotFoundError(getMarkedPeerId(peer), message, 'to vote in')\n        }\n\n        if (!(msg.media instanceof Poll)) {\n            throw new MtArgumentError('This message does not contain a poll')\n        }\n\n        poll = msg.media\n        options = options.map((opt) => {\n            if (typeof opt === 'number') {\n                return poll!.raw.answers[opt].option\n            }\n\n            return opt\n        })\n    }\n\n    const res = await client.call({\n        _: 'messages.sendVote',\n        peer,\n        msgId: message,\n        options: options as Uint8Array[],\n    })\n\n    assertIsUpdatesGroup('messages.sendVote', res)\n\n    client.handleClientUpdate(res, true)\n\n    const upd = res.updates[0]\n    assertTypeIs('messages.sendVote (@ .updates[0])', upd, 'updateMessagePoll')\n\n    if (!upd.poll) {\n        throw new MtTypeAssertionError('messages.sendVote (@ .updates[0].poll)', 'poll', 'undefined')\n    }\n\n    const peers = PeersIndex.from(res)\n\n    return new Poll(upd.poll, peers, upd.results)\n}\n"]}

package/esm/highlevel/methods/messages/translate-message.d.ts

@@ -0,0 +1,11 @@
+import { ITelegramClient } from '../../client.types.js';
+import { InputMessageId, TextWithEntities } from '../../types/index.js';
+/**
+ * Translate message text to a given language.
+ *
+ * Returns `null` if it could not translate the message.
+ */
+export declare function translateMessage(client: ITelegramClient, params: InputMessageId & {
+    /** Target language (two-letter ISO 639-1 language code) */
+    toLanguage: string;
+}): Promise<TextWithEntities>;

package/esm/highlevel/methods/messages/translate-message.js

@@ -0,0 +1,22 @@
+import { normalizeInputMessageId } from '../../types/index.js';
+import { resolvePeer } from '../users/resolve-peer.js';
+/**
+ * Translate message text to a given language.
+ *
+ * Returns `null` if it could not translate the message.
+ */
+export async function translateMessage(client, params) {
+    const { toLanguage } = params;
+    const { chatId, message } = normalizeInputMessageId(params);
+    const res = await client.call({
+        _: 'messages.translateText',
+        peer: await resolvePeer(client, chatId),
+        id: [message],
+        toLang: toLanguage,
+    });
+    return {
+        text: res.result[0].text,
+        entities: res.result[0].entities,
+    };
+}
+//# sourceMappingURL=translate-message.js.map

package/esm/highlevel/methods/messages/translate-message.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"translate-message.js","sourceRoot":"","sources":["../../../../../src/highlevel/methods/messages/translate-message.ts"],"names":[],"mappings":"AACA,OAAO,EAAkB,uBAAuB,EAAoB,MAAM,sBAAsB,CAAA;AAChG,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAA;AAEtD;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAClC,MAAuB,EACvB,MAGC;IAED,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,CAAA;IAC7B,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,uBAAuB,CAAC,MAAM,CAAC,CAAA;IAE3D,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC;QAC1B,CAAC,EAAE,wBAAwB;QAC3B,IAAI,EAAE,MAAM,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC;QACvC,EAAE,EAAE,CAAC,OAAO,CAAC;QACb,MAAM,EAAE,UAAU;KACrB,CAAC,CAAA;IAEF,OAAO;QACH,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI;QACxB,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ;KACnC,CAAA;AACL,CAAC","sourcesContent":["import { ITelegramClient } from '../../client.types.js'\nimport { InputMessageId, normalizeInputMessageId, TextWithEntities } from '../../types/index.js'\nimport { resolvePeer } from '../users/resolve-peer.js'\n\n/**\n * Translate message text to a given language.\n *\n * Returns `null` if it could not translate the message.\n */\nexport async function translateMessage(\n    client: ITelegramClient,\n    params: InputMessageId & {\n        /** Target language (two-letter ISO 639-1 language code) */\n        toLanguage: string\n    },\n): Promise<TextWithEntities> {\n    const { toLanguage } = params\n    const { chatId, message } = normalizeInputMessageId(params)\n\n    const res = await client.call({\n        _: 'messages.translateText',\n        peer: await resolvePeer(client, chatId),\n        id: [message],\n        toLang: toLanguage,\n    })\n\n    return {\n        text: res.result[0].text,\n        entities: res.result[0].entities,\n    }\n}\n"]}

package/esm/highlevel/methods/messages/translate-text.d.ts

@@ -0,0 +1,9 @@
+import { ITelegramClient } from '../../client.types.js';
+import { InputText, TextWithEntities } from '../../types/misc/entities.js';
+/**
+ * Translate text to a given language.
+ *
+ * @param text  Text to translate
+ * @param toLanguage  Target language (two-letter ISO 639-1 language code)
+ */
+export declare function translateText(client: ITelegramClient, text: InputText, toLanguage: string): Promise<TextWithEntities>;

package/esm/highlevel/methods/messages/translate-text.js

@@ -0,0 +1,30 @@
+import { MtTypeAssertionError } from '../../../types/errors.js';
+import { _normalizeInputText } from '../misc/normalize-text.js';
+/**
+ * Translate text to a given language.
+ *
+ * @param text  Text to translate
+ * @param toLanguage  Target language (two-letter ISO 639-1 language code)
+ */
+export async function translateText(client, text, toLanguage) {
+    const [message, entities] = await _normalizeInputText(client, text);
+    const res = await client.call({
+        _: 'messages.translateText',
+        text: [
+            {
+                _: 'textWithEntities',
+                text: message,
+                entities: entities || [],
+            },
+        ],
+        toLang: toLanguage,
+    });
+    if (!res.result[0]) {
+        throw new MtTypeAssertionError('messages.translateResult#result', 'not empty', 'empty');
+    }
+    return {
+        text: res.result[0].text,
+        entities: res.result[0].entities,
+    };
+}
+//# sourceMappingURL=translate-text.js.map

package/esm/highlevel/methods/messages/translate-text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"translate-text.js","sourceRoot":"","sources":["../../../../../src/highlevel/methods/messages/translate-text.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAA;AAG/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAA;AAE/D;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAC/B,MAAuB,EACvB,IAAe,EACf,UAAkB;IAElB,MAAM,CAAC,OAAO,EAAE,QAAQ,CAAC,GAAG,MAAM,mBAAmB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;IAEnE,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC;QAC1B,CAAC,EAAE,wBAAwB;QAC3B,IAAI,EAAE;YACF;gBACI,CAAC,EAAE,kBAAkB;gBACrB,IAAI,EAAE,OAAO;gBACb,QAAQ,EAAE,QAAQ,IAAI,EAAE;aAC3B;SACJ;QACD,MAAM,EAAE,UAAU;KACrB,CAAC,CAAA;IAEF,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE;QAChB,MAAM,IAAI,oBAAoB,CAAC,iCAAiC,EAAE,WAAW,EAAE,OAAO,CAAC,CAAA;KAC1F;IAED,OAAO;QACH,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI;QACxB,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ;KACnC,CAAA;AACL,CAAC","sourcesContent":["import { MtTypeAssertionError } from '../../../types/errors.js'\nimport { ITelegramClient } from '../../client.types.js'\nimport { InputText, TextWithEntities } from '../../types/misc/entities.js'\nimport { _normalizeInputText } from '../misc/normalize-text.js'\n\n/**\n * Translate text to a given language.\n *\n * @param text  Text to translate\n * @param toLanguage  Target language (two-letter ISO 639-1 language code)\n */\nexport async function translateText(\n    client: ITelegramClient,\n    text: InputText,\n    toLanguage: string,\n): Promise<TextWithEntities> {\n    const [message, entities] = await _normalizeInputText(client, text)\n\n    const res = await client.call({\n        _: 'messages.translateText',\n        text: [\n            {\n                _: 'textWithEntities',\n                text: message,\n                entities: entities || [],\n            },\n        ],\n        toLang: toLanguage,\n    })\n\n    if (!res.result[0]) {\n        throw new MtTypeAssertionError('messages.translateResult#result', 'not empty', 'empty')\n    }\n\n    return {\n        text: res.result[0].text,\n        entities: res.result[0].entities,\n    }\n}\n"]}

package/esm/highlevel/methods/messages/unpin-all-messages.d.ts

@@ -0,0 +1,13 @@
+import { ITelegramClient } from '../../client.types.js';
+import { InputPeerLike } from '../../types/index.js';
+/**
+ * Unpin all pinned messages in a chat.
+ *
+ * @param chatId  Chat or user ID
+ */
+export declare function unpinAllMessages(client: ITelegramClient, chatId: InputPeerLike, params?: {
+    /**
+     * For forums - unpin only messages from the given topic
+     */
+    topicId?: number;
+}): Promise<void>;

package/esm/highlevel/methods/messages/unpin-all-messages.js

@@ -0,0 +1,24 @@
+import { createDummyUpdate } from '../../updates/utils.js';
+import { isInputPeerChannel } from '../../utils/peer-utils.js';
+import { resolvePeer } from '../users/resolve-peer.js';
+/**
+ * Unpin all pinned messages in a chat.
+ *
+ * @param chatId  Chat or user ID
+ */
+export async function unpinAllMessages(client, chatId, params) {
+    const { topicId } = params ?? {};
+    const peer = await resolvePeer(client, chatId);
+    const res = await client.call({
+        _: 'messages.unpinAllMessages',
+        peer,
+        topMsgId: topicId,
+    });
+    if (isInputPeerChannel(peer)) {
+        client.handleClientUpdate(createDummyUpdate(res.pts, res.ptsCount, peer.channelId));
+    }
+    else {
+        client.handleClientUpdate(createDummyUpdate(res.pts, res.ptsCount));
+    }
+}
+//# sourceMappingURL=unpin-all-messages.js.map

package/esm/highlevel/methods/messages/unpin-all-messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unpin-all-messages.js","sourceRoot":"","sources":["../../../../../src/highlevel/methods/messages/unpin-all-messages.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAA;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAA;AAEtD;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAClC,MAAuB,EACvB,MAAqB,EACrB,MAKC;IAED,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,IAAI,EAAE,CAAA;IAEhC,MAAM,IAAI,GAAG,MAAM,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAE9C,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC;QAC1B,CAAC,EAAE,2BAA2B;QAC9B,IAAI;QACJ,QAAQ,EAAE,OAAO;KACpB,CAAC,CAAA;IAEF,IAAI,kBAAkB,CAAC,IAAI,CAAC,EAAE;QAC1B,MAAM,CAAC,kBAAkB,CAAC,iBAAiB,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,CAAA;KACtF;SAAM;QACH,MAAM,CAAC,kBAAkB,CAAC,iBAAiB,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAA;KACtE;AACL,CAAC","sourcesContent":["import { ITelegramClient } from '../../client.types.js'\nimport { InputPeerLike } from '../../types/index.js'\nimport { createDummyUpdate } from '../../updates/utils.js'\nimport { isInputPeerChannel } from '../../utils/peer-utils.js'\nimport { resolvePeer } from '../users/resolve-peer.js'\n\n/**\n * Unpin all pinned messages in a chat.\n *\n * @param chatId  Chat or user ID\n */\nexport async function unpinAllMessages(\n    client: ITelegramClient,\n    chatId: InputPeerLike,\n    params?: {\n        /**\n         * For forums - unpin only messages from the given topic\n         */\n        topicId?: number\n    },\n): Promise<void> {\n    const { topicId } = params ?? {}\n\n    const peer = await resolvePeer(client, chatId)\n\n    const res = await client.call({\n        _: 'messages.unpinAllMessages',\n        peer,\n        topMsgId: topicId,\n    })\n\n    if (isInputPeerChannel(peer)) {\n        client.handleClientUpdate(createDummyUpdate(res.pts, res.ptsCount, peer.channelId))\n    } else {\n        client.handleClientUpdate(createDummyUpdate(res.pts, res.ptsCount))\n    }\n}\n"]}

package/esm/highlevel/methods/messages/unpin-message.d.ts

@@ -0,0 +1,12 @@
+import { ITelegramClient } from '../../client.types.js';
+import { InputMessageId } from '../../types/index.js';
+/**
+ * Unpin a message in a group, supergroup, channel or PM.
+ *
+ * For supergroups/channels, you must have appropriate permissions,
+ * either as an admin, or as default permissions
+ *
+ * @param chatId  Chat ID, username, phone number, `"self"` or `"me"`
+ * @param messageId  Message ID
+ */
+export declare function unpinMessage(client: ITelegramClient, params: InputMessageId): Promise<void>;