@mtcute/core 0.6.0 → 0.7.0

package/cjs/highlevel/methods/messages/get-discussion-message.d.ts

@@ -0,0 +1,17 @@
+import { ITelegramClient } from '../../client.types.js';
+import { InputMessageId, Message } from '../../types/messages/index.js';
+/**
+ * Get discussion message for some channel post.
+ *
+ * Returns `null` if the post does not have a discussion
+ * message.
+ *
+ * This method might throw `FLOOD_WAIT_X` error in case
+ * the discussion message was not *yet* created. Error
+ * is usually handled by the client, but if you disabled that,
+ * you'll need to handle it manually.
+ *
+ * @param peer  Channel where the post was found
+ * @param message  ID of the channel post
+ */
+export declare function getDiscussionMessage(client: ITelegramClient, params: InputMessageId): Promise<Message | null>;

package/cjs/highlevel/methods/messages/get-discussion-message.js

@@ -0,0 +1,63 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getDiscussionMessage = exports._getDiscussionMessage = void 0;
+const index_js_1 = require("../../types/messages/index.js");
+const index_js_2 = require("../../types/peers/index.js");
+const resolve_peer_js_1 = require("../users/resolve-peer.js");
+/** @internal */
+async function _getDiscussionMessage(client, peer, message) {
+    const inputPeer = await (0, resolve_peer_js_1.resolvePeer)(client, peer);
+    const res = await client.call({
+        _: 'messages.getDiscussionMessage',
+        peer: inputPeer,
+        msgId: message,
+    });
+    if (!res.messages.length || res.messages[0]._ === 'messageEmpty') {
+        // no discussion message (i guess?), return the same msg
+        return [inputPeer, message];
+    }
+    const msg = res.messages[0];
+    const chat = res.chats.find((it) => it.id === msg.peerId.channelId);
+    return [
+        {
+            _: 'inputPeerChannel',
+            channelId: chat.id,
+            accessHash: chat.accessHash,
+        },
+        msg.id,
+    ];
+}
+exports._getDiscussionMessage = _getDiscussionMessage;
+// public version of the same method because why not
+/**
+ * Get discussion message for some channel post.
+ *
+ * Returns `null` if the post does not have a discussion
+ * message.
+ *
+ * This method might throw `FLOOD_WAIT_X` error in case
+ * the discussion message was not *yet* created. Error
+ * is usually handled by the client, but if you disabled that,
+ * you'll need to handle it manually.
+ *
+ * @param peer  Channel where the post was found
+ * @param message  ID of the channel post
+ */
+async function getDiscussionMessage(client, params) {
+    const { chatId, message } = (0, index_js_1.normalizeInputMessageId)(params);
+    const inputPeer = await (0, resolve_peer_js_1.resolvePeer)(client, chatId);
+    const res = await client.call({
+        _: 'messages.getDiscussionMessage',
+        peer: inputPeer,
+        msgId: message,
+    });
+    if (!res.messages.length || res.messages[0]._ === 'messageEmpty') {
+        // no discussion message (i guess?), return the same msg
+        return null;
+    }
+    const msg = res.messages[0];
+    const peers = index_js_2.PeersIndex.from(res);
+    return new index_js_1.Message(msg, peers);
+}
+exports.getDiscussionMessage = getDiscussionMessage;
+//# sourceMappingURL=get-discussion-message.js.map

package/cjs/highlevel/methods/messages/get-discussion-message.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-discussion-message.js","sourceRoot":"","sources":["../../../../../src/highlevel/methods/messages/get-discussion-message.ts"],"names":[],"mappings":";;;AAGA,4DAAgG;AAChG,yDAAsE;AACtE,8DAAsD;AAEtD,gBAAgB;AACT,KAAK,UAAU,qBAAqB,CACvC,MAAuB,EACvB,IAAmB,EACnB,OAAe;IAEf,MAAM,SAAS,GAAG,MAAM,IAAA,6BAAW,EAAC,MAAM,EAAE,IAAI,CAAC,CAAA;IAEjD,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC;QAC1B,CAAC,EAAE,+BAA+B;QAClC,IAAI,EAAE,SAAS;QACf,KAAK,EAAE,OAAO;KACjB,CAAC,CAAA;IAEF,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,cAAc,EAAE;QAC9D,wDAAwD;QACxD,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,CAAA;KAC9B;IAED,MAAM,GAAG,GAAG,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAA;IAC3B,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,KAAM,GAAG,CAAC,MAA4B,CAAC,SAAS,CAAmB,CAAA;IAE5G,OAAO;QACH;YACI,CAAC,EAAE,kBAAkB;YACrB,SAAS,EAAE,IAAI,CAAC,EAAE;YAClB,UAAU,EAAE,IAAI,CAAC,UAAW;SAC/B;QACD,GAAG,CAAC,EAAE;KACT,CAAA;AACL,CAAC;AA7BD,sDA6BC;AAED,oDAAoD;AAEpD;;;;;;;;;;;;;GAaG;AACI,KAAK,UAAU,oBAAoB,CACtC,MAAuB,EACvB,MAAsB;IAEtB,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,IAAA,kCAAuB,EAAC,MAAM,CAAC,CAAA;IAE3D,MAAM,SAAS,GAAG,MAAM,IAAA,6BAAW,EAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAEnD,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC;QAC1B,CAAC,EAAE,+BAA+B;QAClC,IAAI,EAAE,SAAS;QACf,KAAK,EAAE,OAAO;KACjB,CAAC,CAAA;IAEF,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,cAAc,EAAE;QAC9D,wDAAwD;QACxD,OAAO,IAAI,CAAA;KACd;IAED,MAAM,GAAG,GAAG,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAA;IAC3B,MAAM,KAAK,GAAG,qBAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IAElC,OAAO,IAAI,kBAAO,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;AAClC,CAAC;AAvBD,oDAuBC","sourcesContent":["import { tl } from '@mtcute/tl'\n\nimport { ITelegramClient } from '../../client.types.js'\nimport { InputMessageId, Message, normalizeInputMessageId } from '../../types/messages/index.js'\nimport { InputPeerLike, PeersIndex } from '../../types/peers/index.js'\nimport { resolvePeer } from '../users/resolve-peer.js'\n\n/** @internal */\nexport async function _getDiscussionMessage(\n    client: ITelegramClient,\n    peer: InputPeerLike,\n    message: number,\n): Promise<[tl.TypeInputPeer, number]> {\n    const inputPeer = await resolvePeer(client, peer)\n\n    const res = await client.call({\n        _: 'messages.getDiscussionMessage',\n        peer: inputPeer,\n        msgId: message,\n    })\n\n    if (!res.messages.length || res.messages[0]._ === 'messageEmpty') {\n        // no discussion message (i guess?), return the same msg\n        return [inputPeer, message]\n    }\n\n    const msg = res.messages[0]\n    const chat = res.chats.find((it) => it.id === (msg.peerId as tl.RawPeerChannel).channelId)! as tl.RawChannel\n\n    return [\n        {\n            _: 'inputPeerChannel',\n            channelId: chat.id,\n            accessHash: chat.accessHash!,\n        },\n        msg.id,\n    ]\n}\n\n// public version of the same method because why not\n\n/**\n * Get discussion message for some channel post.\n *\n * Returns `null` if the post does not have a discussion\n * message.\n *\n * This method might throw `FLOOD_WAIT_X` error in case\n * the discussion message was not *yet* created. Error\n * is usually handled by the client, but if you disabled that,\n * you'll need to handle it manually.\n *\n * @param peer  Channel where the post was found\n * @param message  ID of the channel post\n */\nexport async function getDiscussionMessage(\n    client: ITelegramClient,\n    params: InputMessageId,\n): Promise<Message | null> {\n    const { chatId, message } = normalizeInputMessageId(params)\n\n    const inputPeer = await resolvePeer(client, chatId)\n\n    const res = await client.call({\n        _: 'messages.getDiscussionMessage',\n        peer: inputPeer,\n        msgId: message,\n    })\n\n    if (!res.messages.length || res.messages[0]._ === 'messageEmpty') {\n        // no discussion message (i guess?), return the same msg\n        return null\n    }\n\n    const msg = res.messages[0]\n    const peers = PeersIndex.from(res)\n\n    return new Message(msg, peers)\n}\n"]}

package/cjs/highlevel/methods/messages/get-history.d.ts

@@ -0,0 +1,61 @@
+import { ITelegramClient } from '../../client.types.js';
+import { ArrayPaginated, InputPeerLike, Message } from '../../types/index.js';
+export interface GetHistoryOffset {
+    id: number;
+    date: number;
+}
+/**
+ * Get chat history.
+ *
+ * @param chatId  Chat's marked ID, its username, phone or `"me"` or `"self"`.
+ * @param params  Additional fetch parameters
+ */
+export declare function getHistory(client: ITelegramClient, chatId: InputPeerLike, params?: {
+    /**
+     * Limits the number of messages to be retrieved.
+     *
+     * @default  100
+     */
+    limit?: number;
+    /**
+     * Offset for pagination
+     */
+    offset?: GetHistoryOffset;
+    /**
+     * Additional offset from {@link offset}, in resulting messages.
+     *
+     * This can be used for advanced use cases, like:
+     * - Loading 20 messages newer than message with ID `MSGID`:
+     *   `offset = MSGID, addOffset = -20, limit = 20`
+     * - Loading 20 messages around message with ID `MSGID`:
+     *   `offset = MSGID, addOffset = -10, limit = 20`
+     *
+     * @default  `0` (disabled)
+     */
+    addOffset?: number;
+    /**
+     * Minimum message ID to return
+     *
+     * @default  `0` (disabled).
+     */
+    minId?: number;
+    /**
+     * Maximum message ID to return.
+     *
+     * Unless {@link addOffset} is used, this will work the same as {@link offset}.
+     *
+     * @default  `0` (disabled).
+     */
+    maxId?: number;
+    /**
+     * Whether to retrieve messages in reversed order (from older to recent),
+     * starting from {@link offset} (inclusive).
+     *
+     * > **Note**: Using `reverse=true` requires you to pass offset from which to start
+     * > fetching the messages "downwards". If you call `getHistory` with `reverse=true`
+     * > and without any offset, it will return an empty array.
+     *
+     * @default false
+     */
+    reverse?: boolean;
+}): Promise<ArrayPaginated<Message, GetHistoryOffset>>;

package/cjs/highlevel/methods/messages/get-history.js

@@ -0,0 +1,54 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getHistory = void 0;
+const long_1 = __importDefault(require("long"));
+const type_assertions_js_1 = require("../../../utils/type-assertions.js");
+const index_js_1 = require("../../types/index.js");
+const index_js_2 = require("../../utils/index.js");
+const resolve_peer_js_1 = require("../users/resolve-peer.js");
+const defaultOffset = {
+    id: 0,
+    date: 0,
+};
+/**
+ * Get chat history.
+ *
+ * @param chatId  Chat's marked ID, its username, phone or `"me"` or `"self"`.
+ * @param params  Additional fetch parameters
+ */
+async function getHistory(client, chatId, params) {
+    if (!params)
+        params = {};
+    const { limit = 100, offset: { id: offsetId = 0, date: offsetDate = 0 } = defaultOffset, addOffset = 0, minId = 0, maxId = 0, reverse = false, } = params;
+    const addOffsetAdjusted = addOffset + (reverse ? -limit : 0);
+    const peer = await (0, resolve_peer_js_1.resolvePeer)(client, chatId);
+    const res = await client.call({
+        _: 'messages.getHistory',
+        peer,
+        offsetId,
+        offsetDate,
+        addOffset: addOffsetAdjusted,
+        limit,
+        maxId,
+        minId,
+        hash: long_1.default.ZERO,
+    });
+    (0, type_assertions_js_1.assertTypeIsNot)('getHistory', res, 'messages.messagesNotModified');
+    const peers = index_js_1.PeersIndex.from(res);
+    const msgs = res.messages.filter((msg) => msg._ !== 'messageEmpty').map((msg) => new index_js_1.Message(msg, peers));
+    if (reverse)
+        msgs.reverse();
+    const last = msgs[msgs.length - 1];
+    const next = last ?
+        {
+            id: last.id + (reverse ? 1 : 0),
+            date: last.raw.date,
+        } :
+        undefined;
+    return (0, index_js_2.makeArrayPaginated)(msgs, res.count ?? msgs.length, next);
+}
+exports.getHistory = getHistory;
+//# sourceMappingURL=get-history.js.map

package/cjs/highlevel/methods/messages/get-history.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-history.js","sourceRoot":"","sources":["../../../../../src/highlevel/methods/messages/get-history.ts"],"names":[],"mappings":";;;;;;AAAA,gDAAuB;AAIvB,0EAAmE;AAEnE,mDAAyF;AACzF,mDAAyD;AACzD,8DAAsD;AAQtD,MAAM,aAAa,GAAqB;IACpC,EAAE,EAAE,CAAC;IACL,IAAI,EAAE,CAAC;CACV,CAAA;AAED;;;;;GAKG;AACI,KAAK,UAAU,UAAU,CAC5B,MAAuB,EACvB,MAAqB,EACrB,MAsDC;IAED,IAAI,CAAC,MAAM;QAAE,MAAM,GAAG,EAAE,CAAA;IAExB,MAAM,EACF,KAAK,GAAG,GAAG,EACX,MAAM,EAAE,EAAE,EAAE,EAAE,QAAQ,GAAG,CAAC,EAAE,IAAI,EAAE,UAAU,GAAG,CAAC,EAAE,GAAG,aAAa,EAClE,SAAS,GAAG,CAAC,EACb,KAAK,GAAG,CAAC,EACT,KAAK,GAAG,CAAC,EACT,OAAO,GAAG,KAAK,GAClB,GAAG,MAAM,CAAA;IAEV,MAAM,iBAAiB,GAAG,SAAS,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IAE5D,MAAM,IAAI,GAAG,MAAM,IAAA,6BAAW,EAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAE9C,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC;QAC1B,CAAC,EAAE,qBAAqB;QACxB,IAAI;QACJ,QAAQ;QACR,UAAU;QACV,SAAS,EAAE,iBAAiB;QAC5B,KAAK;QACL,KAAK;QACL,KAAK;QACL,IAAI,EAAE,cAAI,CAAC,IAAI;KAClB,CAAC,CAAA;IAEF,IAAA,oCAAe,EAAC,YAAY,EAAE,GAAG,EAAE,8BAA8B,CAAC,CAAA;IAElE,MAAM,KAAK,GAAG,qBAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IAClC,MAAM,IAAI,GAAG,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,KAAK,cAAc,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,kBAAO,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAA;IAEzG,IAAI,OAAO;QAAE,IAAI,CAAC,OAAO,EAAE,CAAA;IAE3B,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;IAClC,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC;QACf;YACI,EAAE,EAAE,IAAI,CAAC,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC/B,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI;SACtB,CAAC,CAAC;QACH,SAAS,CAAA;IAEb,OAAO,IAAA,6BAAkB,EAAC,IAAI,EAAG,GAAoC,CAAC,KAAK,IAAI,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;AACrG,CAAC;AAtGD,gCAsGC","sourcesContent":["import Long from 'long'\n\nimport { tl } from '@mtcute/tl'\n\nimport { assertTypeIsNot } from '../../../utils/type-assertions.js'\nimport { ITelegramClient } from '../../client.types.js'\nimport { ArrayPaginated, InputPeerLike, Message, PeersIndex } from '../../types/index.js'\nimport { makeArrayPaginated } from '../../utils/index.js'\nimport { resolvePeer } from '../users/resolve-peer.js'\n\n// @exported\nexport interface GetHistoryOffset {\n    id: number\n    date: number\n}\n\nconst defaultOffset: GetHistoryOffset = {\n    id: 0,\n    date: 0,\n}\n\n/**\n * Get chat history.\n *\n * @param chatId  Chat's marked ID, its username, phone or `\"me\"` or `\"self\"`.\n * @param params  Additional fetch parameters\n */\nexport async function getHistory(\n    client: ITelegramClient,\n    chatId: InputPeerLike,\n    params?: {\n        /**\n         * Limits the number of messages to be retrieved.\n         *\n         * @default  100\n         */\n        limit?: number\n\n        /**\n         * Offset for pagination\n         */\n        offset?: GetHistoryOffset\n\n        /**\n         * Additional offset from {@link offset}, in resulting messages.\n         *\n         * This can be used for advanced use cases, like:\n         * - Loading 20 messages newer than message with ID `MSGID`:\n         *   `offset = MSGID, addOffset = -20, limit = 20`\n         * - Loading 20 messages around message with ID `MSGID`:\n         *   `offset = MSGID, addOffset = -10, limit = 20`\n         *\n         * @default  `0` (disabled)\n         */\n\n        addOffset?: number\n\n        /**\n         * Minimum message ID to return\n         *\n         * @default  `0` (disabled).\n         */\n        minId?: number\n\n        /**\n         * Maximum message ID to return.\n         *\n         * Unless {@link addOffset} is used, this will work the same as {@link offset}.\n         *\n         * @default  `0` (disabled).\n         */\n        maxId?: number\n\n        /**\n         * Whether to retrieve messages in reversed order (from older to recent),\n         * starting from {@link offset} (inclusive).\n         *\n         * > **Note**: Using `reverse=true` requires you to pass offset from which to start\n         * > fetching the messages \"downwards\". If you call `getHistory` with `reverse=true`\n         * > and without any offset, it will return an empty array.\n         *\n         * @default false\n         */\n        reverse?: boolean\n    },\n): Promise<ArrayPaginated<Message, GetHistoryOffset>> {\n    if (!params) params = {}\n\n    const {\n        limit = 100,\n        offset: { id: offsetId = 0, date: offsetDate = 0 } = defaultOffset,\n        addOffset = 0,\n        minId = 0,\n        maxId = 0,\n        reverse = false,\n    } = params\n\n    const addOffsetAdjusted = addOffset + (reverse ? -limit : 0)\n\n    const peer = await resolvePeer(client, chatId)\n\n    const res = await client.call({\n        _: 'messages.getHistory',\n        peer,\n        offsetId,\n        offsetDate,\n        addOffset: addOffsetAdjusted,\n        limit,\n        maxId,\n        minId,\n        hash: Long.ZERO,\n    })\n\n    assertTypeIsNot('getHistory', res, 'messages.messagesNotModified')\n\n    const peers = PeersIndex.from(res)\n    const msgs = res.messages.filter((msg) => msg._ !== 'messageEmpty').map((msg) => new Message(msg, peers))\n\n    if (reverse) msgs.reverse()\n\n    const last = msgs[msgs.length - 1]\n    const next = last ?\n        {\n            id: last.id + (reverse ? 1 : 0),\n            date: last.raw.date,\n        } :\n        undefined\n\n    return makeArrayPaginated(msgs, (res as tl.messages.RawMessagesSlice).count ?? msgs.length, next)\n}\n"]}

package/cjs/highlevel/methods/messages/get-message-by-link.d.ts

@@ -0,0 +1,6 @@
+import { ITelegramClient } from '../../client.types.js';
+import { Message } from '../../types/messages/index.js';
+/**
+ * Given a message link (e.g. `t.me/durov/1`), fetch the relevant message.
+ */
+export declare function getMessageByLink(client: ITelegramClient, link: string): Promise<Message | null>;

package/cjs/highlevel/methods/messages/get-message-by-link.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getMessageByLink = void 0;
+const errors_js_1 = require("../../../types/errors.js");
+const index_js_1 = require("../../../utils/links/index.js");
+const peer_utils_js_1 = require("../../../utils/peer-utils.js");
+const resolve_peer_js_1 = require("../users/resolve-peer.js");
+const get_discussion_message_js_1 = require("./get-discussion-message.js");
+const get_messages_js_1 = require("./get-messages.js");
+/**
+ * Given a message link (e.g. `t.me/durov/1`), fetch the relevant message.
+ */
+async function getMessageByLink(client, link) {
+    const parsed = index_js_1.links.message.parse(link);
+    if (!parsed) {
+        throw new errors_js_1.MtArgumentError(`Invalid message link: ${link}`);
+    }
+    let peer;
+    if ('username' in parsed) {
+        peer = await (0, resolve_peer_js_1.resolvePeer)(client, parsed.username);
+    }
+    else {
+        peer = await (0, resolve_peer_js_1.resolvePeer)(client, (0, peer_utils_js_1.toggleChannelIdMark)(parsed.channelId));
+    }
+    let msgId = parsed.id;
+    if (parsed.commentId) {
+        [peer] = await (0, get_discussion_message_js_1._getDiscussionMessage)(client, peer, parsed.id);
+        msgId = parsed.commentId;
+    }
+    const [msg] = await (0, get_messages_js_1.getMessages)(client, peer, msgId);
+    return msg;
+}
+exports.getMessageByLink = getMessageByLink;
+//# sourceMappingURL=get-message-by-link.js.map

package/cjs/highlevel/methods/messages/get-message-by-link.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-message-by-link.js","sourceRoot":"","sources":["../../../../../src/highlevel/methods/messages/get-message-by-link.ts"],"names":[],"mappings":";;;AAAA,wDAA0D;AAC1D,4DAAqD;AACrD,gEAAkE;AAGlE,8DAAsD;AACtD,2EAAmE;AACnE,uDAA+C;AAE/C;;GAEG;AACI,KAAK,UAAU,gBAAgB,CAAC,MAAuB,EAAE,IAAY;IACxE,MAAM,MAAM,GAAG,gBAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IAExC,IAAI,CAAC,MAAM,EAAE;QACT,MAAM,IAAI,2BAAe,CAAC,yBAAyB,IAAI,EAAE,CAAC,CAAA;KAC7D;IAED,IAAI,IAAI,CAAA;IAER,IAAI,UAAU,IAAI,MAAM,EAAE;QACtB,IAAI,GAAG,MAAM,IAAA,6BAAW,EAAC,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAA;KACpD;SAAM;QACH,IAAI,GAAG,MAAM,IAAA,6BAAW,EAAC,MAAM,EAAE,IAAA,mCAAmB,EAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAA;KAC1E;IAED,IAAI,KAAK,GAAG,MAAM,CAAC,EAAE,CAAA;IAErB,IAAI,MAAM,CAAC,SAAS,EAAE;QAClB,CAAC,IAAI,CAAC,GAAG,MAAM,IAAA,iDAAqB,EAAC,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC,CAAA;QAC7D,KAAK,GAAG,MAAM,CAAC,SAAS,CAAA;KAC3B;IAED,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM,IAAA,6BAAW,EAAC,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,CAAA;IAEpD,OAAO,GAAG,CAAA;AACd,CAAC;AAzBD,4CAyBC","sourcesContent":["import { MtArgumentError } from '../../../types/errors.js'\nimport { links } from '../../../utils/links/index.js'\nimport { toggleChannelIdMark } from '../../../utils/peer-utils.js'\nimport { ITelegramClient } from '../../client.types.js'\nimport { Message } from '../../types/messages/index.js'\nimport { resolvePeer } from '../users/resolve-peer.js'\nimport { _getDiscussionMessage } from './get-discussion-message.js'\nimport { getMessages } from './get-messages.js'\n\n/**\n * Given a message link (e.g. `t.me/durov/1`), fetch the relevant message.\n */\nexport async function getMessageByLink(client: ITelegramClient, link: string): Promise<Message | null> {\n    const parsed = links.message.parse(link)\n\n    if (!parsed) {\n        throw new MtArgumentError(`Invalid message link: ${link}`)\n    }\n\n    let peer\n\n    if ('username' in parsed) {\n        peer = await resolvePeer(client, parsed.username)\n    } else {\n        peer = await resolvePeer(client, toggleChannelIdMark(parsed.channelId))\n    }\n\n    let msgId = parsed.id\n\n    if (parsed.commentId) {\n        [peer] = await _getDiscussionMessage(client, peer, parsed.id)\n        msgId = parsed.commentId\n    }\n\n    const [msg] = await getMessages(client, peer, msgId)\n\n    return msg\n}\n"]}

package/cjs/highlevel/methods/messages/get-message-group.d.ts

@@ -0,0 +1,9 @@
+import { ITelegramClient } from '../../client.types.js';
+import { InputMessageId, Message } from '../../types/index.js';
+/**
+ * Get all messages inside of a message group
+ *
+ * @param chatId  Chat ID
+ * @param message  ID of one of the messages in the group
+ */
+export declare function getMessageGroup(client: ITelegramClient, params: InputMessageId): Promise<Message[]>;

package/cjs/highlevel/methods/messages/get-message-group.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getMessageGroup = void 0;
+const errors_js_1 = require("../../../types/errors.js");
+const type_assertions_js_1 = require("../../../utils/type-assertions.js");
+const index_js_1 = require("../../types/index.js");
+const peer_utils_js_1 = require("../../utils/peer-utils.js");
+const resolve_peer_js_1 = require("../users/resolve-peer.js");
+const get_messages_js_1 = require("./get-messages.js");
+/**
+ * Get all messages inside of a message group
+ *
+ * @param chatId  Chat ID
+ * @param message  ID of one of the messages in the group
+ */
+async function getMessageGroup(client, params) {
+    const { chatId, message } = (0, index_js_1.normalizeInputMessageId)(params);
+    // awesome hack stolen from pyrogram
+    // groups have no more than 10 items
+    // however, since for non-channels message ids are shared,
+    // we use larger number.
+    // still, this might not be enough :shrug:
+    const peer = await (0, resolve_peer_js_1.resolvePeer)(client, chatId);
+    const delta = (0, peer_utils_js_1.isInputPeerChannel)(peer) ? 9 : 19;
+    const ids = [];
+    for (let i = Math.max(message - delta, 0); i <= message + delta; i++) {
+        ids.push(i);
+    }
+    const messages = await (0, get_messages_js_1.getMessages)(client, chatId, ids);
+    const groupedId = messages.find((it) => it?.id === message).groupedId;
+    if (!groupedId)
+        throw new errors_js_1.MtArgumentError('This message is not grouped');
+    return messages.filter(type_assertions_js_1.isPresent).filter((it) => it.groupedId?.eq(groupedId));
+}
+exports.getMessageGroup = getMessageGroup;
+//# sourceMappingURL=get-message-group.js.map

package/cjs/highlevel/methods/messages/get-message-group.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-message-group.js","sourceRoot":"","sources":["../../../../../src/highlevel/methods/messages/get-message-group.ts"],"names":[],"mappings":";;;AAAA,wDAA0D;AAC1D,0EAA6D;AAE7D,mDAAuF;AACvF,6DAA8D;AAC9D,8DAAsD;AACtD,uDAA+C;AAE/C;;;;;GAKG;AACI,KAAK,UAAU,eAAe,CAAC,MAAuB,EAAE,MAAsB;IACjF,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,IAAA,kCAAuB,EAAC,MAAM,CAAC,CAAA;IAE3D,oCAAoC;IACpC,oCAAoC;IACpC,0DAA0D;IAC1D,wBAAwB;IACxB,0CAA0C;IAE1C,MAAM,IAAI,GAAG,MAAM,IAAA,6BAAW,EAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAE9C,MAAM,KAAK,GAAG,IAAA,kCAAkB,EAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;IAE/C,MAAM,GAAG,GAAa,EAAE,CAAA;IAExB,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,GAAG,KAAK,EAAE,CAAC,CAAC,EAAE,CAAC,IAAI,OAAO,GAAG,KAAK,EAAE,CAAC,EAAE,EAAE;QAClE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;KACd;IAED,MAAM,QAAQ,GAAG,MAAM,IAAA,6BAAW,EAAC,MAAM,EAAE,MAAM,EAAE,GAAG,CAAC,CAAA;IACvD,MAAM,SAAS,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,KAAK,OAAO,CAAE,CAAC,SAAS,CAAA;IAEtE,IAAI,CAAC,SAAS;QAAE,MAAM,IAAI,2BAAe,CAAC,6BAA6B,CAAC,CAAA;IAExE,OAAO,QAAQ,CAAC,MAAM,CAAC,8BAAS,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,CAAC,CAAA;AACjF,CAAC;AAzBD,0CAyBC","sourcesContent":["import { MtArgumentError } from '../../../types/errors.js'\nimport { isPresent } from '../../../utils/type-assertions.js'\nimport { ITelegramClient } from '../../client.types.js'\nimport { InputMessageId, Message, normalizeInputMessageId } from '../../types/index.js'\nimport { isInputPeerChannel } from '../../utils/peer-utils.js'\nimport { resolvePeer } from '../users/resolve-peer.js'\nimport { getMessages } from './get-messages.js'\n\n/**\n * Get all messages inside of a message group\n *\n * @param chatId  Chat ID\n * @param message  ID of one of the messages in the group\n */\nexport async function getMessageGroup(client: ITelegramClient, params: InputMessageId): Promise<Message[]> {\n    const { chatId, message } = normalizeInputMessageId(params)\n\n    // awesome hack stolen from pyrogram\n    // groups have no more than 10 items\n    // however, since for non-channels message ids are shared,\n    // we use larger number.\n    // still, this might not be enough :shrug:\n\n    const peer = await resolvePeer(client, chatId)\n\n    const delta = isInputPeerChannel(peer) ? 9 : 19\n\n    const ids: number[] = []\n\n    for (let i = Math.max(message - delta, 0); i <= message + delta; i++) {\n        ids.push(i)\n    }\n\n    const messages = await getMessages(client, chatId, ids)\n    const groupedId = messages.find((it) => it?.id === message)!.groupedId\n\n    if (!groupedId) throw new MtArgumentError('This message is not grouped')\n\n    return messages.filter(isPresent).filter((it) => it.groupedId?.eq(groupedId))\n}\n"]}

package/cjs/highlevel/methods/messages/get-message-reactions.d.ts

@@ -0,0 +1,28 @@
+import { ITelegramClient } from '../../client.types.js';
+import { InputPeerLike, Message, MessageReactions } from '../../types/index.js';
+/**
+ * Get reactions to messages by their IDs.
+ *
+ * > Apps should short-poll reactions for visible messages
+ * > (that weren't sent by the user) once every 15-30 seconds,
+ * > but only if `message.reactions` is set
+ *
+ * @param chatId  ID of the chat with messages
+ * @param messages  Message IDs
+ * @returns  Reactions to corresponding messages, or `null` if there are none
+ */
+export declare function getMessageReactionsById(client: ITelegramClient, chatId: InputPeerLike, messages: number[]): Promise<(MessageReactions | null)[]>;
+/**
+ * Get reactions to {@link Message}s.
+ *
+ * > **Note**: messages must all be from the same chat.
+ *
+ * > Apps should short-poll reactions for visible messages
+ * > (that weren't sent by the user) once every 15-30 seconds,
+ * > but only if `message.reactions` is set
+ *
+ * @param chatId  ID of the chat with messages
+ * @param messages  Message IDs
+ * @returns  Reactions to corresponding messages, or `null` if there are none
+ */
+export declare function getMessageReactions(client: ITelegramClient, messages: Message[]): Promise<(MessageReactions | null)[]>;

package/cjs/highlevel/methods/messages/get-message-reactions.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getMessageReactions = exports.getMessageReactionsById = void 0;
+const peer_utils_js_1 = require("../../../utils/peer-utils.js");
+const type_assertions_js_1 = require("../../../utils/type-assertions.js");
+const index_js_1 = require("../../types/index.js");
+const utils_js_1 = require("../../updates/utils.js");
+const resolve_peer_js_1 = require("../users/resolve-peer.js");
+/**
+ * Get reactions to messages by their IDs.
+ *
+ * > Apps should short-poll reactions for visible messages
+ * > (that weren't sent by the user) once every 15-30 seconds,
+ * > but only if `message.reactions` is set
+ *
+ * @param chatId  ID of the chat with messages
+ * @param messages  Message IDs
+ * @returns  Reactions to corresponding messages, or `null` if there are none
+ */
+async function getMessageReactionsById(client, chatId, messages) {
+    const res = await client.call({
+        _: 'messages.getMessagesReactions',
+        peer: await (0, resolve_peer_js_1.resolvePeer)(client, chatId),
+        id: messages,
+    });
+    (0, utils_js_1.assertIsUpdatesGroup)('messages.getMessagesReactions', res);
+    // normally the group contains updateMessageReactions
+    // for each message requested that has reactions
+    //
+    // these updates are not ordered in any way, so
+    // we don't need to pass them to updates engine
+    const index = {};
+    const peers = index_js_1.PeersIndex.from(res);
+    for (const update of res.updates) {
+        (0, type_assertions_js_1.assertTypeIs)('messages.getMessagesReactions', update, 'updateMessageReactions');
+        index[update.msgId] = new index_js_1.MessageReactions(update.msgId, (0, peer_utils_js_1.getMarkedPeerId)(update.peer), update.reactions, peers);
+    }
+    return messages.map((messageId) => index[messageId] ?? null);
+}
+exports.getMessageReactionsById = getMessageReactionsById;
+/**
+ * Get reactions to {@link Message}s.
+ *
+ * > **Note**: messages must all be from the same chat.
+ *
+ * > Apps should short-poll reactions for visible messages
+ * > (that weren't sent by the user) once every 15-30 seconds,
+ * > but only if `message.reactions` is set
+ *
+ * @param chatId  ID of the chat with messages
+ * @param messages  Message IDs
+ * @returns  Reactions to corresponding messages, or `null` if there are none
+ */
+async function getMessageReactions(client, messages) {
+    return getMessageReactionsById(client, messages[0].chat.inputPeer, messages.map((it) => it.id));
+}
+exports.getMessageReactions = getMessageReactions;
+//# sourceMappingURL=get-message-reactions.js.map

package/cjs/highlevel/methods/messages/get-message-reactions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-message-reactions.js","sourceRoot":"","sources":["../../../../../src/highlevel/methods/messages/get-message-reactions.ts"],"names":[],"mappings":";;;AAAA,gEAA8D;AAC9D,0EAAgE;AAEhE,mDAA2F;AAC3F,qDAA6D;AAC7D,8DAAsD;AAEtD;;;;;;;;;;GAUG;AACI,KAAK,UAAU,uBAAuB,CACzC,MAAuB,EACvB,MAAqB,EACrB,QAAkB;IAElB,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC;QAC1B,CAAC,EAAE,+BAA+B;QAClC,IAAI,EAAE,MAAM,IAAA,6BAAW,EAAC,MAAM,EAAE,MAAM,CAAC;QACvC,EAAE,EAAE,QAAQ;KACf,CAAC,CAAA;IAEF,IAAA,+BAAoB,EAAC,+BAA+B,EAAE,GAAG,CAAC,CAAA;IAE1D,qDAAqD;IACrD,gDAAgD;IAChD,EAAE;IACF,+CAA+C;IAC/C,+CAA+C;IAE/C,MAAM,KAAK,GAAqC,EAAE,CAAA;IAElD,MAAM,KAAK,GAAG,qBAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IAElC,KAAK,MAAM,MAAM,IAAI,GAAG,CAAC,OAAO,EAAE;QAC9B,IAAA,iCAAY,EAAC,+BAA+B,EAAE,MAAM,EAAE,wBAAwB,CAAC,CAAA;QAE/E,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,2BAAgB,CAAC,MAAM,CAAC,KAAK,EAAE,IAAA,+BAAe,EAAC,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,SAAS,EAAE,KAAK,CAAC,CAAA;KAClH;IAED,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC,CAAA;AAChE,CAAC;AA9BD,0DA8BC;AAED;;;;;;;;;;;;GAYG;AACI,KAAK,UAAU,mBAAmB,CACrC,MAAuB,EACvB,QAAmB;IAEnB,OAAO,uBAAuB,CAC1B,MAAM,EACN,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,EAC1B,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAC9B,CAAA;AACL,CAAC;AATD,kDASC","sourcesContent":["import { getMarkedPeerId } from '../../../utils/peer-utils.js'\nimport { assertTypeIs } from '../../../utils/type-assertions.js'\nimport { ITelegramClient } from '../../client.types.js'\nimport { InputPeerLike, Message, MessageReactions, PeersIndex } from '../../types/index.js'\nimport { assertIsUpdatesGroup } from '../../updates/utils.js'\nimport { resolvePeer } from '../users/resolve-peer.js'\n\n/**\n * Get reactions to messages by their IDs.\n *\n * > Apps should short-poll reactions for visible messages\n * > (that weren't sent by the user) once every 15-30 seconds,\n * > but only if `message.reactions` is set\n *\n * @param chatId  ID of the chat with messages\n * @param messages  Message IDs\n * @returns  Reactions to corresponding messages, or `null` if there are none\n */\nexport async function getMessageReactionsById(\n    client: ITelegramClient,\n    chatId: InputPeerLike,\n    messages: number[],\n): Promise<(MessageReactions | null)[]> {\n    const res = await client.call({\n        _: 'messages.getMessagesReactions',\n        peer: await resolvePeer(client, chatId),\n        id: messages,\n    })\n\n    assertIsUpdatesGroup('messages.getMessagesReactions', res)\n\n    // normally the group contains updateMessageReactions\n    // for each message requested that has reactions\n    //\n    // these updates are not ordered in any way, so\n    // we don't need to pass them to updates engine\n\n    const index: Record<number, MessageReactions> = {}\n\n    const peers = PeersIndex.from(res)\n\n    for (const update of res.updates) {\n        assertTypeIs('messages.getMessagesReactions', update, 'updateMessageReactions')\n\n        index[update.msgId] = new MessageReactions(update.msgId, getMarkedPeerId(update.peer), update.reactions, peers)\n    }\n\n    return messages.map((messageId) => index[messageId] ?? null)\n}\n\n/**\n * Get reactions to {@link Message}s.\n *\n * > **Note**: messages must all be from the same chat.\n *\n * > Apps should short-poll reactions for visible messages\n * > (that weren't sent by the user) once every 15-30 seconds,\n * > but only if `message.reactions` is set\n *\n * @param chatId  ID of the chat with messages\n * @param messages  Message IDs\n * @returns  Reactions to corresponding messages, or `null` if there are none\n */\nexport async function getMessageReactions(\n    client: ITelegramClient,\n    messages: Message[],\n): Promise<(MessageReactions | null)[]> {\n    return getMessageReactionsById(\n        client,\n        messages[0].chat.inputPeer,\n        messages.map((it) => it.id),\n    )\n}\n"]}

package/cjs/highlevel/methods/messages/get-messages-unsafe.d.ts

@@ -0,0 +1,19 @@
+import { MaybeArray } from '../../../types/utils.js';
+import { ITelegramClient } from '../../client.types.js';
+import { Message } from '../../types/index.js';
+/**
+ * Get messages from PM or legacy group by their IDs.
+ * For channels, use {@link getMessages}.
+ *
+ * Unlike {@link getMessages}, this method does not
+ * check if the message belongs to some chat.
+ *
+ * Fot messages that were not found, `null` will be
+ * returned at that position.
+ *
+ * @param messageIds  Messages IDs
+ * @param [fromReply=false]
+ *     Whether the reply to a given message should be fetched
+ *     (i.e. `getMessages(msg.chat.id, msg.id, true).id === msg.replyToMessageId`)
+ */
+export declare function getMessagesUnsafe(client: ITelegramClient, messageIds: MaybeArray<number>, fromReply?: boolean): Promise<(Message | null)[]>;

package/cjs/highlevel/methods/messages/get-messages-unsafe.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getMessagesUnsafe = void 0;
+const type_assertions_js_1 = require("../../../utils/type-assertions.js");
+const index_js_1 = require("../../types/index.js");
+/**
+ * Get messages from PM or legacy group by their IDs.
+ * For channels, use {@link getMessages}.
+ *
+ * Unlike {@link getMessages}, this method does not
+ * check if the message belongs to some chat.
+ *
+ * Fot messages that were not found, `null` will be
+ * returned at that position.
+ *
+ * @param messageIds  Messages IDs
+ * @param [fromReply=false]
+ *     Whether the reply to a given message should be fetched
+ *     (i.e. `getMessages(msg.chat.id, msg.id, true).id === msg.replyToMessageId`)
+ */
+async function getMessagesUnsafe(client, messageIds, fromReply = false) {
+    if (!Array.isArray(messageIds))
+        messageIds = [messageIds];
+    const type = fromReply ? 'inputMessageReplyTo' : 'inputMessageID';
+    const ids = messageIds.map((it) => ({
+        _: type,
+        id: it,
+    }));
+    const res = await client.call({
+        _: 'messages.getMessages',
+        id: ids,
+    });
+    (0, type_assertions_js_1.assertTypeIsNot)('getMessagesUnsafe', res, 'messages.messagesNotModified');
+    const peers = index_js_1.PeersIndex.from(res);
+    return res.messages.map((msg) => {
+        if (msg._ === 'messageEmpty')
+            return null;
+        return new index_js_1.Message(msg, peers);
+    });
+}
+exports.getMessagesUnsafe = getMessagesUnsafe;
+//# sourceMappingURL=get-messages-unsafe.js.map

package/cjs/highlevel/methods/messages/get-messages-unsafe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-messages-unsafe.js","sourceRoot":"","sources":["../../../../../src/highlevel/methods/messages/get-messages-unsafe.ts"],"names":[],"mappings":";;;AAGA,0EAAmE;AAEnE,mDAA0D;AAE1D;;;;;;;;;;;;;;GAcG;AACI,KAAK,UAAU,iBAAiB,CACnC,MAAuB,EACvB,UAA8B,EAC9B,SAAS,GAAG,KAAK;IAEjB,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC;QAAE,UAAU,GAAG,CAAC,UAAU,CAAC,CAAA;IAEzD,MAAM,IAAI,GAAG,SAAS,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,gBAAgB,CAAA;IACjE,MAAM,GAAG,GAA0B,UAAU,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;QACvD,CAAC,EAAE,IAAI;QACP,EAAE,EAAE,EAAE;KACT,CAAC,CAAC,CAAA;IAEH,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC;QAC1B,CAAC,EAAE,sBAAsB;QACzB,EAAE,EAAE,GAAG;KACV,CAAC,CAAA;IAEF,IAAA,oCAAe,EAAC,mBAAmB,EAAE,GAAG,EAAE,8BAA8B,CAAC,CAAA;IAEzE,MAAM,KAAK,GAAG,qBAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IAElC,OAAO,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;QAC5B,IAAI,GAAG,CAAC,CAAC,KAAK,cAAc;YAAE,OAAO,IAAI,CAAA;QAEzC,OAAO,IAAI,kBAAO,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;IAClC,CAAC,CAAC,CAAA;AACN,CAAC;AA3BD,8CA2BC","sourcesContent":["import { tl } from '@mtcute/tl'\n\nimport { MaybeArray } from '../../../types/utils.js'\nimport { assertTypeIsNot } from '../../../utils/type-assertions.js'\nimport { ITelegramClient } from '../../client.types.js'\nimport { Message, PeersIndex } from '../../types/index.js'\n\n/**\n * Get messages from PM or legacy group by their IDs.\n * For channels, use {@link getMessages}.\n *\n * Unlike {@link getMessages}, this method does not\n * check if the message belongs to some chat.\n *\n * Fot messages that were not found, `null` will be\n * returned at that position.\n *\n * @param messageIds  Messages IDs\n * @param [fromReply=false]\n *     Whether the reply to a given message should be fetched\n *     (i.e. `getMessages(msg.chat.id, msg.id, true).id === msg.replyToMessageId`)\n */\nexport async function getMessagesUnsafe(\n    client: ITelegramClient,\n    messageIds: MaybeArray<number>,\n    fromReply = false,\n): Promise<(Message | null)[]> {\n    if (!Array.isArray(messageIds)) messageIds = [messageIds]\n\n    const type = fromReply ? 'inputMessageReplyTo' : 'inputMessageID'\n    const ids: tl.TypeInputMessage[] = messageIds.map((it) => ({\n        _: type,\n        id: it,\n    }))\n\n    const res = await client.call({\n        _: 'messages.getMessages',\n        id: ids,\n    })\n\n    assertTypeIsNot('getMessagesUnsafe', res, 'messages.messagesNotModified')\n\n    const peers = PeersIndex.from(res)\n\n    return res.messages.map((msg) => {\n        if (msg._ === 'messageEmpty') return null\n\n        return new Message(msg, peers)\n    })\n}\n"]}

package/cjs/highlevel/methods/messages/get-messages.d.ts

@@ -0,0 +1,17 @@
+import { MaybeArray } from '../../../types/utils.js';
+import { ITelegramClient } from '../../client.types.js';
+import { Message } from '../../types/messages/index.js';
+import { InputPeerLike } from '../../types/peers/index.js';
+/**
+ * Get messages in chat by their IDs
+ *
+ * Fot messages that were not found, `null` will be
+ * returned at that position.
+ *
+ * @param chatId  Chat's marked ID, its username, phone or `"me"` or `"self"`
+ * @param messageIds  Messages IDs
+ * @param [fromReply=false]
+ *     Whether the reply to a given message should be fetched
+ *     (i.e. `getMessages(msg.chat.id, msg.id, true).id === msg.replyToMessageId`)
+ */
+export declare function getMessages(client: ITelegramClient, chatId: InputPeerLike, messageIds: MaybeArray<number>, fromReply?: boolean): Promise<(Message | null)[]>;

package/cjs/highlevel/methods/messages/get-messages.js

@@ -0,0 +1,76 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getMessages = void 0;
+const type_assertions_js_1 = require("../../../utils/type-assertions.js");
+const index_js_1 = require("../../types/messages/index.js");
+const index_js_2 = require("../../types/peers/index.js");
+const peer_utils_js_1 = require("../../utils/peer-utils.js");
+const resolve_peer_js_1 = require("../users/resolve-peer.js");
+// @available=both
+/**
+ * Get messages in chat by their IDs
+ *
+ * Fot messages that were not found, `null` will be
+ * returned at that position.
+ *
+ * @param chatId  Chat's marked ID, its username, phone or `"me"` or `"self"`
+ * @param messageIds  Messages IDs
+ * @param [fromReply=false]
+ *     Whether the reply to a given message should be fetched
+ *     (i.e. `getMessages(msg.chat.id, msg.id, true).id === msg.replyToMessageId`)
+ */
+async function getMessages(client, chatId, messageIds, fromReply = false) {
+    const peer = await (0, resolve_peer_js_1.resolvePeer)(client, chatId);
+    if (!Array.isArray(messageIds))
+        messageIds = [messageIds];
+    const type = fromReply ? 'inputMessageReplyTo' : 'inputMessageID';
+    const ids = messageIds.map((it) => ({
+        _: type,
+        id: it,
+    }));
+    const isChannel = (0, peer_utils_js_1.isInputPeerChannel)(peer);
+    const res = await client.call(isChannel ?
+        {
+            _: 'channels.getMessages',
+            id: ids,
+            channel: (0, peer_utils_js_1.toInputChannel)(peer),
+        } :
+        {
+            _: 'messages.getMessages',
+            id: ids,
+        });
+    (0, type_assertions_js_1.assertTypeIsNot)('getMessages', res, 'messages.messagesNotModified');
+    const peers = index_js_2.PeersIndex.from(res);
+    let selfId = undefined;
+    return res.messages.map((msg) => {
+        if (msg._ === 'messageEmpty')
+            return null;
+        if (!isChannel) {
+            // make sure that the messages belong to the given chat
+            // (channels have their own message numbering)
+            switch (peer._) {
+                case 'inputPeerSelf':
+                    if (selfId === undefined)
+                        selfId = client.storage.self.getCached()?.userId ?? null;
+                    if (!(msg.peerId._ === 'peerUser' && msg.peerId.userId === selfId)) {
+                        return null;
+                    }
+                    break;
+                case 'inputPeerUser':
+                case 'inputPeerUserFromMessage':
+                    if (!(msg.peerId._ === 'peerUser' && msg.peerId.userId === peer.userId)) {
+                        return null;
+                    }
+                    break;
+                case 'inputPeerChat':
+                    if (!(msg.peerId._ === 'peerChat' && msg.peerId.chatId === peer.chatId)) {
+                        return null;
+                    }
+                    break;
+            }
+        }
+        return new index_js_1.Message(msg, peers);
+    });
+}
+exports.getMessages = getMessages;
+//# sourceMappingURL=get-messages.js.map

package/cjs/highlevel/methods/messages/get-messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-messages.js","sourceRoot":"","sources":["../../../../../src/highlevel/methods/messages/get-messages.ts"],"names":[],"mappings":";;;AAGA,0EAAmE;AAEnE,4DAAuD;AACvD,yDAAsE;AACtE,6DAA8E;AAC9E,8DAAsD;AAEtD,kBAAkB;AAClB;;;;;;;;;;;GAWG;AACI,KAAK,UAAU,WAAW,CAC7B,MAAuB,EACvB,MAAqB,EACrB,UAA8B,EAC9B,SAAS,GAAG,KAAK;IAEjB,MAAM,IAAI,GAAG,MAAM,IAAA,6BAAW,EAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC9C,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC;QAAE,UAAU,GAAG,CAAC,UAAU,CAAC,CAAA;IAEzD,MAAM,IAAI,GAAG,SAAS,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,gBAAgB,CAAA;IACjE,MAAM,GAAG,GAA0B,UAAU,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;QACvD,CAAC,EAAE,IAAI;QACP,EAAE,EAAE,EAAE;KACT,CAAC,CAAC,CAAA;IAEH,MAAM,SAAS,GAAG,IAAA,kCAAkB,EAAC,IAAI,CAAC,CAAA;IAE1C,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,IAAI,CACzB,SAAS,CAAC,CAAC;QACP;YACI,CAAC,EAAE,sBAAsB;YACzB,EAAE,EAAE,GAAG;YACP,OAAO,EAAE,IAAA,8BAAc,EAAC,IAAI,CAAC;SAChC,CAAC,CAAC;QACH;YACI,CAAC,EAAE,sBAAsB;YACzB,EAAE,EAAE,GAAG;SACV,CACR,CAAA;IAED,IAAA,oCAAe,EAAC,aAAa,EAAE,GAAG,EAAE,8BAA8B,CAAC,CAAA;IAEnE,MAAM,KAAK,GAAG,qBAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IAElC,IAAI,MAAM,GAA8B,SAAS,CAAA;IAEjD,OAAO,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;QAC5B,IAAI,GAAG,CAAC,CAAC,KAAK,cAAc;YAAE,OAAO,IAAI,CAAA;QAEzC,IAAI,CAAC,SAAS,EAAE;YACZ,uDAAuD;YACvD,8CAA8C;YAC9C,QAAQ,IAAI,CAAC,CAAC,EAAE;gBACZ,KAAK,eAAe;oBAChB,IAAI,MAAM,KAAK,SAAS;wBAAE,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,MAAM,IAAI,IAAI,CAAA;oBAElF,IAAI,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,KAAK,UAAU,IAAI,GAAG,CAAC,MAAM,CAAC,MAAM,KAAK,MAAM,CAAC,EAAE;wBAChE,OAAO,IAAI,CAAA;qBACd;oBACD,MAAK;gBACT,KAAK,eAAe,CAAC;gBACrB,KAAK,0BAA0B;oBAC3B,IAAI,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,KAAK,UAAU,IAAI,GAAG,CAAC,MAAM,CAAC,MAAM,KAAK,IAAI,CAAC,MAAM,CAAC,EAAE;wBACrE,OAAO,IAAI,CAAA;qBACd;oBACD,MAAK;gBACT,KAAK,eAAe;oBAChB,IAAI,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,KAAK,UAAU,IAAI,GAAG,CAAC,MAAM,CAAC,MAAM,KAAK,IAAI,CAAC,MAAM,CAAC,EAAE;wBACrE,OAAO,IAAI,CAAA;qBACd;oBACD,MAAK;aACZ;SACJ;QAED,OAAO,IAAI,kBAAO,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;IAClC,CAAC,CAAC,CAAA;AACN,CAAC;AAlED,kCAkEC","sourcesContent":["import { tl } from '@mtcute/tl'\n\nimport { MaybeArray } from '../../../types/utils.js'\nimport { assertTypeIsNot } from '../../../utils/type-assertions.js'\nimport { ITelegramClient } from '../../client.types.js'\nimport { Message } from '../../types/messages/index.js'\nimport { InputPeerLike, PeersIndex } from '../../types/peers/index.js'\nimport { isInputPeerChannel, toInputChannel } from '../../utils/peer-utils.js'\nimport { resolvePeer } from '../users/resolve-peer.js'\n\n// @available=both\n/**\n * Get messages in chat by their IDs\n *\n * Fot messages that were not found, `null` will be\n * returned at that position.\n *\n * @param chatId  Chat's marked ID, its username, phone or `\"me\"` or `\"self\"`\n * @param messageIds  Messages IDs\n * @param [fromReply=false]\n *     Whether the reply to a given message should be fetched\n *     (i.e. `getMessages(msg.chat.id, msg.id, true).id === msg.replyToMessageId`)\n */\nexport async function getMessages(\n    client: ITelegramClient,\n    chatId: InputPeerLike,\n    messageIds: MaybeArray<number>,\n    fromReply = false,\n): Promise<(Message | null)[]> {\n    const peer = await resolvePeer(client, chatId)\n    if (!Array.isArray(messageIds)) messageIds = [messageIds]\n\n    const type = fromReply ? 'inputMessageReplyTo' : 'inputMessageID'\n    const ids: tl.TypeInputMessage[] = messageIds.map((it) => ({\n        _: type,\n        id: it,\n    }))\n\n    const isChannel = isInputPeerChannel(peer)\n\n    const res = await client.call(\n        isChannel ?\n            {\n                _: 'channels.getMessages',\n                id: ids,\n                channel: toInputChannel(peer),\n            } :\n            {\n                _: 'messages.getMessages',\n                id: ids,\n            },\n    )\n\n    assertTypeIsNot('getMessages', res, 'messages.messagesNotModified')\n\n    const peers = PeersIndex.from(res)\n\n    let selfId: number | null | undefined = undefined\n\n    return res.messages.map((msg) => {\n        if (msg._ === 'messageEmpty') return null\n\n        if (!isChannel) {\n            // make sure that the messages belong to the given chat\n            // (channels have their own message numbering)\n            switch (peer._) {\n                case 'inputPeerSelf':\n                    if (selfId === undefined) selfId = client.storage.self.getCached()?.userId ?? null\n\n                    if (!(msg.peerId._ === 'peerUser' && msg.peerId.userId === selfId)) {\n                        return null\n                    }\n                    break\n                case 'inputPeerUser':\n                case 'inputPeerUserFromMessage':\n                    if (!(msg.peerId._ === 'peerUser' && msg.peerId.userId === peer.userId)) {\n                        return null\n                    }\n                    break\n                case 'inputPeerChat':\n                    if (!(msg.peerId._ === 'peerChat' && msg.peerId.chatId === peer.chatId)) {\n                        return null\n                    }\n                    break\n            }\n        }\n\n        return new Message(msg, peers)\n    })\n}\n"]}

package/cjs/highlevel/methods/messages/get-reaction-users.d.ts

@@ -0,0 +1,24 @@
+import { ITelegramClient } from '../../client.types.js';
+import { ArrayPaginated, InputMessageId, InputReaction, PeerReaction } from '../../types/index.js';
+export type GetReactionUsersOffset = string;
+/**
+ * Get users who have reacted to the message.
+ *
+ * @param params
+ */
+export declare function getReactionUsers(client: ITelegramClient, params: InputMessageId & {
+    /**
+     * Get only reactions with the specified emoji
+     */
+    emoji?: InputReaction;
+    /**
+     * Limit the number of users returned.
+     *
+     * @default  100
+     */
+    limit?: number;
+    /**
+     * Offset for pagination
+     */
+    offset?: GetReactionUsersOffset;
+}): Promise<ArrayPaginated<PeerReaction, GetReactionUsersOffset>>;