@mtcute/core 0.6.0 → 0.7.0

package/cjs/highlevel/methods/chats/get-chat-members.js

@@ -0,0 +1,87 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getChatMembers = void 0;
+const long_1 = __importDefault(require("long"));
+const utils_js_1 = require("../../../types/utils.js");
+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 peer_utils_js_1 = require("../../utils/peer-utils.js");
+const resolve_peer_js_1 = require("../users/resolve-peer.js");
+/**
+ * Get a chunk of members of some chat.
+ *
+ * You can retrieve up to 200 members at once
+ *
+ * @param chatId  Chat ID or username
+ * @param params  Additional parameters
+ */
+async function getChatMembers(client, chatId, params) {
+    const { query = '', offset = 0, limit = 200, type = 'recent' } = params ?? {};
+    const chat = await (0, resolve_peer_js_1.resolvePeer)(client, chatId);
+    if ((0, peer_utils_js_1.isInputPeerChat)(chat)) {
+        const res = await client.call({
+            _: 'messages.getFullChat',
+            chatId: chat.chatId,
+        });
+        (0, type_assertions_js_1.assertTypeIs)('getChatMember (@ messages.getFullChat)', res.fullChat, 'chatFull');
+        let members = res.fullChat.participants._ === 'chatParticipantsForbidden' ? [] : res.fullChat.participants.participants;
+        if (offset)
+            members = members.slice(offset);
+        if (limit)
+            members = members.slice(0, limit);
+        const peers = index_js_1.PeersIndex.from(res);
+        const ret = members.map((m) => new index_js_1.ChatMember(m, peers));
+        return (0, index_js_2.makeArrayWithTotal)(ret, ret.length);
+    }
+    if ((0, peer_utils_js_1.isInputPeerChannel)(chat)) {
+        const q = query;
+        let filter;
+        switch (type) {
+            case 'all':
+                filter = { _: 'channelParticipantsSearch', q };
+                break;
+            case 'banned':
+                filter = { _: 'channelParticipantsKicked', q };
+                break;
+            case 'restricted':
+                filter = { _: 'channelParticipantsBanned', q };
+                break;
+            case 'mention':
+                filter = { _: 'channelParticipantsMentions', q };
+                break;
+            case 'bots':
+                filter = { _: 'channelParticipantsBots' };
+                break;
+            case 'recent':
+                filter = { _: 'channelParticipantsRecent' };
+                break;
+            case 'admins':
+                filter = { _: 'channelParticipantsAdmins' };
+                break;
+            case 'contacts':
+                filter = { _: 'channelParticipantsContacts', q };
+                break;
+            default:
+                (0, utils_js_1.assertNever)(type);
+        }
+        const res = await client.call({
+            _: 'channels.getParticipants',
+            channel: (0, peer_utils_js_1.toInputChannel)(chat),
+            filter,
+            offset,
+            limit,
+            hash: long_1.default.ZERO,
+        });
+        (0, type_assertions_js_1.assertTypeIs)('getChatMembers (@ channels.getParticipants)', res, 'channels.channelParticipants');
+        const peers = index_js_1.PeersIndex.from(res);
+        const ret = res.participants.map((i) => new index_js_1.ChatMember(i, peers));
+        return (0, index_js_2.makeArrayWithTotal)(ret, res.count);
+    }
+    throw new index_js_1.MtInvalidPeerTypeError(chatId, 'chat or channel');
+}
+exports.getChatMembers = getChatMembers;
+//# sourceMappingURL=get-chat-members.js.map

package/cjs/highlevel/methods/chats/get-chat-members.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-chat-members.js","sourceRoot":"","sources":["../../../../../src/highlevel/methods/chats/get-chat-members.ts"],"names":[],"mappings":"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","sourcesContent":["import Long from 'long'\n\nimport { tl } from '@mtcute/tl'\n\nimport { assertNever } from '../../../types/utils.js'\nimport { assertTypeIs } from '../../../utils/type-assertions.js'\nimport { ITelegramClient } from '../../client.types.js'\nimport { ArrayWithTotal, ChatMember, InputPeerLike, MtInvalidPeerTypeError, PeersIndex } from '../../types/index.js'\nimport { makeArrayWithTotal } from '../../utils/index.js'\nimport { isInputPeerChannel, isInputPeerChat, toInputChannel } from '../../utils/peer-utils.js'\nimport { resolvePeer } from '../users/resolve-peer.js'\n\n/**\n * Get a chunk of members of some chat.\n *\n * You can retrieve up to 200 members at once\n *\n * @param chatId  Chat ID or username\n * @param params  Additional parameters\n */\nexport async function getChatMembers(\n    client: ITelegramClient,\n    chatId: InputPeerLike,\n    params?: {\n        /**\n         * Search query to filter members by their display names and usernames\n         *\n         * > **Note**: Only used for these values of `filter`:\n         * > `all, banned, restricted, mention, contacts`\n         *\n         * @default  `''` (empty string)\n         */\n        query?: string\n\n        /**\n         * Sequential number of the first member to be returned.\n         */\n        offset?: number\n\n        /**\n         * Maximum number of members to be retrieved.\n         *\n         * > **Note**: Telegram currently only allows you to ever retrieve at most\n         * > 200 members, regardless of offset/limit. I.e. when passing\n         * > `offset=201` nothing will ever be returned.\n         *\n         * @default  200\n         */\n        limit?: number\n\n        /**\n         * Type of the query. Can be:\n         *  - `all`: get all members\n         *  - `banned`: get only banned members\n         *  - `restricted`: get only restricted members\n         *  - `bots`: get only bots\n         *  - `recent`: get recent members\n         *  - `admins`: get only administrators (and creator)\n         *  - `contacts`: get only contacts\n         *  - `mention`: get users that can be mentioned (see {@link tl.RawChannelParticipantsMentions})\n         *\n         *  Only used for channels and supergroups.\n         *\n         * @default  `recent`\n         */\n        type?: 'all' | 'banned' | 'restricted' | 'bots' | 'recent' | 'admins' | 'contacts' | 'mention'\n    },\n): Promise<ArrayWithTotal<ChatMember>> {\n    const { query = '', offset = 0, limit = 200, type = 'recent' } = params ?? {}\n\n    const chat = await resolvePeer(client, chatId)\n\n    if (isInputPeerChat(chat)) {\n        const res = await client.call({\n            _: 'messages.getFullChat',\n            chatId: chat.chatId,\n        })\n\n        assertTypeIs('getChatMember (@ messages.getFullChat)', res.fullChat, 'chatFull')\n\n        let members =\n            res.fullChat.participants._ === 'chatParticipantsForbidden' ? [] : res.fullChat.participants.participants\n\n        if (offset) members = members.slice(offset)\n        if (limit) members = members.slice(0, limit)\n\n        const peers = PeersIndex.from(res)\n\n        const ret = members.map((m) => new ChatMember(m, peers))\n\n        return makeArrayWithTotal(ret, ret.length)\n    }\n\n    if (isInputPeerChannel(chat)) {\n        const q = query\n\n        let filter: tl.TypeChannelParticipantsFilter\n\n        switch (type) {\n            case 'all':\n                filter = { _: 'channelParticipantsSearch', q }\n                break\n            case 'banned':\n                filter = { _: 'channelParticipantsKicked', q }\n                break\n            case 'restricted':\n                filter = { _: 'channelParticipantsBanned', q }\n                break\n            case 'mention':\n                filter = { _: 'channelParticipantsMentions', q }\n                break\n            case 'bots':\n                filter = { _: 'channelParticipantsBots' }\n                break\n            case 'recent':\n                filter = { _: 'channelParticipantsRecent' }\n                break\n            case 'admins':\n                filter = { _: 'channelParticipantsAdmins' }\n                break\n            case 'contacts':\n                filter = { _: 'channelParticipantsContacts', q }\n                break\n            default:\n                assertNever(type)\n        }\n\n        const res = await client.call({\n            _: 'channels.getParticipants',\n            channel: toInputChannel(chat),\n            filter,\n            offset,\n            limit,\n            hash: Long.ZERO,\n        })\n\n        assertTypeIs('getChatMembers (@ channels.getParticipants)', res, 'channels.channelParticipants')\n\n        const peers = PeersIndex.from(res)\n\n        const ret = res.participants.map((i) => new ChatMember(i, peers))\n\n        return makeArrayWithTotal(ret, res.count)\n    }\n\n    throw new MtInvalidPeerTypeError(chatId, 'chat or channel')\n}\n"]}

package/cjs/highlevel/methods/chats/get-chat-preview.d.ts

@@ -0,0 +1,12 @@
+import { ITelegramClient } from '../../client.types.js';
+import { ChatPreview } from '../../types/index.js';
+/**
+ * Get preview information about a private chat.
+ *
+ * @param inviteLink  Invite link
+ * @throws MtArgumentError  In case invite link has invalid format
+ * @throws MtPeerNotFoundError
+ *   In case you are trying to get info about private chat that you have already joined.
+ *   Use {@link getChat} or {@link getFullChat} instead.
+ */
+export declare function getChatPreview(client: ITelegramClient, inviteLink: string): Promise<ChatPreview>;

package/cjs/highlevel/methods/chats/get-chat-preview.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getChatPreview = void 0;
+const errors_js_1 = require("../../../types/errors.js");
+const index_js_1 = require("../../types/index.js");
+const peer_utils_js_1 = require("../../utils/peer-utils.js");
+/**
+ * Get preview information about a private chat.
+ *
+ * @param inviteLink  Invite link
+ * @throws MtArgumentError  In case invite link has invalid format
+ * @throws MtPeerNotFoundError
+ *   In case you are trying to get info about private chat that you have already joined.
+ *   Use {@link getChat} or {@link getFullChat} instead.
+ */
+async function getChatPreview(client, inviteLink) {
+    const m = inviteLink.match(peer_utils_js_1.INVITE_LINK_REGEX);
+    if (!m)
+        throw new errors_js_1.MtArgumentError('Invalid invite link');
+    const res = await client.call({
+        _: 'messages.checkChatInvite',
+        hash: m[1],
+    });
+    if (res._ !== 'chatInvite') {
+        throw new index_js_1.MtPeerNotFoundError('You have already joined this chat!');
+    }
+    return new index_js_1.ChatPreview(res, inviteLink);
+}
+exports.getChatPreview = getChatPreview;
+//# sourceMappingURL=get-chat-preview.js.map

package/cjs/highlevel/methods/chats/get-chat-preview.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-chat-preview.js","sourceRoot":"","sources":["../../../../../src/highlevel/methods/chats/get-chat-preview.ts"],"names":[],"mappings":";;;AAAA,wDAA0D;AAE1D,mDAAuE;AACvE,6DAA6D;AAE7D;;;;;;;;GAQG;AACI,KAAK,UAAU,cAAc,CAAC,MAAuB,EAAE,UAAkB;IAC5E,MAAM,CAAC,GAAG,UAAU,CAAC,KAAK,CAAC,iCAAiB,CAAC,CAAA;IAC7C,IAAI,CAAC,CAAC;QAAE,MAAM,IAAI,2BAAe,CAAC,qBAAqB,CAAC,CAAA;IAExD,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC;QAC1B,CAAC,EAAE,0BAA0B;QAC7B,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;KACb,CAAC,CAAA;IAEF,IAAI,GAAG,CAAC,CAAC,KAAK,YAAY,EAAE;QACxB,MAAM,IAAI,8BAAmB,CAAC,oCAAoC,CAAC,CAAA;KACtE;IAED,OAAO,IAAI,sBAAW,CAAC,GAAG,EAAE,UAAU,CAAC,CAAA;AAC3C,CAAC;AAdD,wCAcC","sourcesContent":["import { MtArgumentError } from '../../../types/errors.js'\nimport { ITelegramClient } from '../../client.types.js'\nimport { ChatPreview, MtPeerNotFoundError } from '../../types/index.js'\nimport { INVITE_LINK_REGEX } from '../../utils/peer-utils.js'\n\n/**\n * Get preview information about a private chat.\n *\n * @param inviteLink  Invite link\n * @throws MtArgumentError  In case invite link has invalid format\n * @throws MtPeerNotFoundError\n *   In case you are trying to get info about private chat that you have already joined.\n *   Use {@link getChat} or {@link getFullChat} instead.\n */\nexport async function getChatPreview(client: ITelegramClient, inviteLink: string): Promise<ChatPreview> {\n    const m = inviteLink.match(INVITE_LINK_REGEX)\n    if (!m) throw new MtArgumentError('Invalid invite link')\n\n    const res = await client.call({\n        _: 'messages.checkChatInvite',\n        hash: m[1],\n    })\n\n    if (res._ !== 'chatInvite') {\n        throw new MtPeerNotFoundError('You have already joined this chat!')\n    }\n\n    return new ChatPreview(res, inviteLink)\n}\n"]}

package/cjs/highlevel/methods/chats/get-chat.d.ts

@@ -0,0 +1,11 @@
+import { ITelegramClient } from '../../client.types.js';
+import { Chat, InputPeerLike } from '../../types/index.js';
+/**
+ * Get basic information about a chat.
+ *
+ * @param chatId  ID of the chat, its username or invite link
+ * @throws MtArgumentError
+ *   In case you are trying to get info about private chat that you haven't joined.
+ *   Use {@link getChatPreview} instead.
+ */
+export declare function getChat(client: ITelegramClient, chatId: InputPeerLike): Promise<Chat>;

package/cjs/highlevel/methods/chats/get-chat.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getChat = void 0;
+const errors_js_1 = require("../../../types/errors.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 batched_queries_js_1 = require("./batched-queries.js");
+// @available=both
+/**
+ * Get basic information about a chat.
+ *
+ * @param chatId  ID of the chat, its username or invite link
+ * @throws MtArgumentError
+ *   In case you are trying to get info about private chat that you haven't joined.
+ *   Use {@link getChatPreview} instead.
+ */
+async function getChat(client, chatId) {
+    if (typeof chatId === 'string') {
+        const m = chatId.match(peer_utils_js_1.INVITE_LINK_REGEX);
+        if (m) {
+            const res = await client.call({
+                _: 'messages.checkChatInvite',
+                hash: m[1],
+            });
+            if (res._ === 'chatInvite') {
+                throw new errors_js_1.MtArgumentError(`You haven't joined ${JSON.stringify(res.title)}`);
+            }
+            return new index_js_1.Chat(res.chat);
+        }
+    }
+    const peer = await (0, resolve_peer_js_1.resolvePeer)(client, chatId);
+    const res = await (0, batched_queries_js_1._getRawPeerBatched)(client, peer);
+    if (!res)
+        throw new index_js_1.MtPeerNotFoundError(`Chat ${JSON.stringify(chatId)} was not found`);
+    return new index_js_1.Chat(res);
+}
+exports.getChat = getChat;
+//# sourceMappingURL=get-chat.js.map

package/cjs/highlevel/methods/chats/get-chat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-chat.js","sourceRoot":"","sources":["../../../../../src/highlevel/methods/chats/get-chat.ts"],"names":[],"mappings":";;;AAAA,wDAA0D;AAE1D,mDAA+E;AAC/E,6DAA6D;AAC7D,8DAAsD;AACtD,6DAAyD;AAEzD,kBAAkB;AAClB;;;;;;;GAOG;AACI,KAAK,UAAU,OAAO,CAAC,MAAuB,EAAE,MAAqB;IACxE,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE;QAC5B,MAAM,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,iCAAiB,CAAC,CAAA;QAEzC,IAAI,CAAC,EAAE;YACH,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC;gBAC1B,CAAC,EAAE,0BAA0B;gBAC7B,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;aACb,CAAC,CAAA;YAEF,IAAI,GAAG,CAAC,CAAC,KAAK,YAAY,EAAE;gBACxB,MAAM,IAAI,2BAAe,CAAC,sBAAsB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;aAC/E;YAED,OAAO,IAAI,eAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;SAC5B;KACJ;IAED,MAAM,IAAI,GAAG,MAAM,IAAA,6BAAW,EAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAE9C,MAAM,GAAG,GAAG,MAAM,IAAA,uCAAkB,EAAC,MAAM,EAAE,IAAI,CAAC,CAAA;IAElD,IAAI,CAAC,GAAG;QAAE,MAAM,IAAI,8BAAmB,CAAC,QAAQ,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAA;IAEvF,OAAO,IAAI,eAAI,CAAC,GAAG,CAAC,CAAA;AACxB,CAAC;AAzBD,0BAyBC","sourcesContent":["import { MtArgumentError } from '../../../types/errors.js'\nimport { ITelegramClient } from '../../client.types.js'\nimport { Chat, InputPeerLike, MtPeerNotFoundError } from '../../types/index.js'\nimport { INVITE_LINK_REGEX } from '../../utils/peer-utils.js'\nimport { resolvePeer } from '../users/resolve-peer.js'\nimport { _getRawPeerBatched } from './batched-queries.js'\n\n// @available=both\n/**\n * Get basic information about a chat.\n *\n * @param chatId  ID of the chat, its username or invite link\n * @throws MtArgumentError\n *   In case you are trying to get info about private chat that you haven't joined.\n *   Use {@link getChatPreview} instead.\n */\nexport async function getChat(client: ITelegramClient, chatId: InputPeerLike): Promise<Chat> {\n    if (typeof chatId === 'string') {\n        const m = chatId.match(INVITE_LINK_REGEX)\n\n        if (m) {\n            const res = await client.call({\n                _: 'messages.checkChatInvite',\n                hash: m[1],\n            })\n\n            if (res._ === 'chatInvite') {\n                throw new MtArgumentError(`You haven't joined ${JSON.stringify(res.title)}`)\n            }\n\n            return new Chat(res.chat)\n        }\n    }\n\n    const peer = await resolvePeer(client, chatId)\n\n    const res = await _getRawPeerBatched(client, peer)\n\n    if (!res) throw new MtPeerNotFoundError(`Chat ${JSON.stringify(chatId)} was not found`)\n\n    return new Chat(res)\n}\n"]}

package/cjs/highlevel/methods/chats/get-full-chat.d.ts

@@ -0,0 +1,11 @@
+import { ITelegramClient } from '../../client.types.js';
+import { Chat, InputPeerLike } from '../../types/index.js';
+/**
+ * Get full information about a chat.
+ *
+ * @param chatId  ID of the chat, its username or invite link
+ * @throws MtArgumentError
+ *   In case you are trying to get info about private chat that you haven't joined.
+ *   Use {@link getChatPreview} instead.
+ */
+export declare function getFullChat(client: ITelegramClient, chatId: InputPeerLike): Promise<Chat>;

package/cjs/highlevel/methods/chats/get-full-chat.js

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getFullChat = void 0;
+const errors_js_1 = require("../../../types/errors.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");
+// @available=both
+/**
+ * Get full information about a chat.
+ *
+ * @param chatId  ID of the chat, its username or invite link
+ * @throws MtArgumentError
+ *   In case you are trying to get info about private chat that you haven't joined.
+ *   Use {@link getChatPreview} instead.
+ */
+async function getFullChat(client, chatId) {
+    if (typeof chatId === 'string') {
+        const m = chatId.match(peer_utils_js_1.INVITE_LINK_REGEX);
+        if (m) {
+            const res = await client.call({
+                _: 'messages.checkChatInvite',
+                hash: m[1],
+            });
+            if (res._ === 'chatInvite') {
+                throw new errors_js_1.MtArgumentError(`You haven't joined ${JSON.stringify(res.title)}`);
+            }
+            // we still need to fetch full chat info
+            chatId = res.chat.id;
+        }
+    }
+    const peer = await (0, resolve_peer_js_1.resolvePeer)(client, chatId);
+    let res;
+    if ((0, peer_utils_js_1.isInputPeerChannel)(peer)) {
+        res = await client.call({
+            _: 'channels.getFullChannel',
+            channel: (0, peer_utils_js_1.toInputChannel)(peer),
+        });
+    }
+    else if ((0, peer_utils_js_1.isInputPeerUser)(peer)) {
+        res = await client.call({
+            _: 'users.getFullUser',
+            id: (0, peer_utils_js_1.toInputUser)(peer),
+        });
+    }
+    else if ((0, peer_utils_js_1.isInputPeerChat)(peer)) {
+        res = await client.call({
+            _: 'messages.getFullChat',
+            chatId: peer.chatId,
+        });
+    }
+    else
+        throw new Error('should not happen');
+    return index_js_1.Chat._parseFull(res);
+}
+exports.getFullChat = getFullChat;
+//# sourceMappingURL=get-full-chat.js.map

package/cjs/highlevel/methods/chats/get-full-chat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-full-chat.js","sourceRoot":"","sources":["../../../../../src/highlevel/methods/chats/get-full-chat.ts"],"names":[],"mappings":";;;AAEA,wDAA0D;AAE1D,mDAA0D;AAC1D,6DAOkC;AAClC,8DAAsD;AAEtD,kBAAkB;AAClB;;;;;;;GAOG;AACI,KAAK,UAAU,WAAW,CAAC,MAAuB,EAAE,MAAqB;IAC5E,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE;QAC5B,MAAM,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,iCAAiB,CAAC,CAAA;QAEzC,IAAI,CAAC,EAAE;YACH,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC;gBAC1B,CAAC,EAAE,0BAA0B;gBAC7B,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;aACb,CAAC,CAAA;YAEF,IAAI,GAAG,CAAC,CAAC,KAAK,YAAY,EAAE;gBACxB,MAAM,IAAI,2BAAe,CAAC,sBAAsB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;aAC/E;YAED,wCAAwC;YACxC,MAAM,GAAG,GAAG,CAAC,IAAI,CAAC,EAAE,CAAA;SACvB;KACJ;IAED,MAAM,IAAI,GAAG,MAAM,IAAA,6BAAW,EAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAE9C,IAAI,GAAqD,CAAA;IACzD,IAAI,IAAA,kCAAkB,EAAC,IAAI,CAAC,EAAE;QAC1B,GAAG,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC;YACpB,CAAC,EAAE,yBAAyB;YAC5B,OAAO,EAAE,IAAA,8BAAc,EAAC,IAAI,CAAC;SAChC,CAAC,CAAA;KACL;SAAM,IAAI,IAAA,+BAAe,EAAC,IAAI,CAAC,EAAE;QAC9B,GAAG,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC;YACpB,CAAC,EAAE,mBAAmB;YACtB,EAAE,EAAE,IAAA,2BAAW,EAAC,IAAI,CAAE;SACzB,CAAC,CAAA;KACL;SAAM,IAAI,IAAA,+BAAe,EAAC,IAAI,CAAC,EAAE;QAC9B,GAAG,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC;YACpB,CAAC,EAAE,sBAAsB;YACzB,MAAM,EAAE,IAAI,CAAC,MAAM;SACtB,CAAC,CAAA;KACL;;QAAM,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAA;IAE3C,OAAO,eAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAA;AAC/B,CAAC;AAxCD,kCAwCC","sourcesContent":["import { tl } from '@mtcute/tl'\n\nimport { MtArgumentError } from '../../../types/errors.js'\nimport { ITelegramClient } from '../../client.types.js'\nimport { Chat, InputPeerLike } from '../../types/index.js'\nimport {\n    INVITE_LINK_REGEX,\n    isInputPeerChannel,\n    isInputPeerChat,\n    isInputPeerUser,\n    toInputChannel,\n    toInputUser,\n} from '../../utils/peer-utils.js'\nimport { resolvePeer } from '../users/resolve-peer.js'\n\n// @available=both\n/**\n * Get full information about a chat.\n *\n * @param chatId  ID of the chat, its username or invite link\n * @throws MtArgumentError\n *   In case you are trying to get info about private chat that you haven't joined.\n *   Use {@link getChatPreview} instead.\n */\nexport async function getFullChat(client: ITelegramClient, chatId: InputPeerLike): Promise<Chat> {\n    if (typeof chatId === 'string') {\n        const m = chatId.match(INVITE_LINK_REGEX)\n\n        if (m) {\n            const res = await client.call({\n                _: 'messages.checkChatInvite',\n                hash: m[1],\n            })\n\n            if (res._ === 'chatInvite') {\n                throw new MtArgumentError(`You haven't joined ${JSON.stringify(res.title)}`)\n            }\n\n            // we still need to fetch full chat info\n            chatId = res.chat.id\n        }\n    }\n\n    const peer = await resolvePeer(client, chatId)\n\n    let res: tl.messages.TypeChatFull | tl.users.TypeUserFull\n    if (isInputPeerChannel(peer)) {\n        res = await client.call({\n            _: 'channels.getFullChannel',\n            channel: toInputChannel(peer),\n        })\n    } else if (isInputPeerUser(peer)) {\n        res = await client.call({\n            _: 'users.getFullUser',\n            id: toInputUser(peer)!,\n        })\n    } else if (isInputPeerChat(peer)) {\n        res = await client.call({\n            _: 'messages.getFullChat',\n            chatId: peer.chatId,\n        })\n    } else throw new Error('should not happen')\n\n    return Chat._parseFull(res)\n}\n"]}

package/cjs/highlevel/methods/chats/get-nearby-chats.d.ts

@@ -0,0 +1,9 @@
+import { ITelegramClient } from '../../client.types.js';
+import { Chat } from '../../types/index.js';
+/**
+ * Get nearby chats
+ *
+ * @param latitude  Latitude of the location
+ * @param longitude  Longitude of the location
+ */
+export declare function getNearbyChats(client: ITelegramClient, latitude: number, longitude: number): Promise<Chat[]>;

package/cjs/highlevel/methods/chats/get-nearby-chats.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getNearbyChats = 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");
+/**
+ * Get nearby chats
+ *
+ * @param latitude  Latitude of the location
+ * @param longitude  Longitude of the location
+ */
+async function getNearbyChats(client, latitude, longitude) {
+    const res = await client.call({
+        _: 'contacts.getLocated',
+        geoPoint: {
+            _: 'inputGeoPoint',
+            lat: latitude,
+            long: longitude,
+        },
+    });
+    (0, utils_js_1.assertIsUpdatesGroup)('contacts.getLocated', res);
+    // client.handleClientUpdate(res, true)
+    if (!res.updates.length)
+        return [];
+    (0, type_assertions_js_1.assertTypeIs)('contacts.getLocated (@ .updates[0])', res.updates[0], 'updatePeerLocated');
+    const chats = res.chats.map((it) => new index_js_1.Chat(it));
+    const index = {};
+    chats.forEach((c) => (index[c.id] = c));
+    res.updates[0].peers.forEach((peer) => {
+        if (peer._ === 'peerSelfLocated')
+            return;
+        const id = (0, peer_utils_js_1.getMarkedPeerId)(peer.peer);
+        if (index[id]) {
+            index[id].distance = peer.distance;
+        }
+    });
+    return chats;
+}
+exports.getNearbyChats = getNearbyChats;
+//# sourceMappingURL=get-nearby-chats.js.map

package/cjs/highlevel/methods/chats/get-nearby-chats.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-nearby-chats.js","sourceRoot":"","sources":["../../../../../src/highlevel/methods/chats/get-nearby-chats.ts"],"names":[],"mappings":";;;AAEA,gEAA8D;AAC9D,0EAAgE;AAEhE,mDAA2C;AAC3C,qDAA6D;AAE7D;;;;;GAKG;AACI,KAAK,UAAU,cAAc,CAAC,MAAuB,EAAE,QAAgB,EAAE,SAAiB;IAC7F,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC;QAC1B,CAAC,EAAE,qBAAqB;QACxB,QAAQ,EAAE;YACN,CAAC,EAAE,eAAe;YAClB,GAAG,EAAE,QAAQ;YACb,IAAI,EAAE,SAAS;SAClB;KACJ,CAAC,CAAA;IAEF,IAAA,+BAAoB,EAAC,qBAAqB,EAAE,GAAG,CAAC,CAAA;IAChD,uCAAuC;IAEvC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM;QAAE,OAAO,EAAE,CAAA;IAElC,IAAA,iCAAY,EAAC,qCAAqC,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,mBAAmB,CAAC,CAAA;IAExF,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,eAAI,CAAC,EAAE,CAAC,CAAC,CAAA;IAEjD,MAAM,KAAK,GAAyB,EAAE,CAAA;IACtC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;IAEvC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;QAClC,IAAI,IAAI,CAAC,CAAC,KAAK,iBAAiB;YAAE,OAAM;QAExC,MAAM,EAAE,GAAG,IAAA,+BAAe,EAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAErC,IAAI,KAAK,CAAC,EAAE,CAAC,EAAE;YACV,KAAK,CAAC,EAAE,CAAsB,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAA;SAC3D;IACL,CAAC,CAAC,CAAA;IAEF,OAAO,KAAK,CAAA;AAChB,CAAC;AAjCD,wCAiCC","sourcesContent":["import { tl } from '@mtcute/tl'\n\nimport { getMarkedPeerId } from '../../../utils/peer-utils.js'\nimport { assertTypeIs } from '../../../utils/type-assertions.js'\nimport { ITelegramClient } from '../../client.types.js'\nimport { Chat } from '../../types/index.js'\nimport { assertIsUpdatesGroup } from '../../updates/utils.js'\n\n/**\n * Get nearby chats\n *\n * @param latitude  Latitude of the location\n * @param longitude  Longitude of the location\n */\nexport async function getNearbyChats(client: ITelegramClient, latitude: number, longitude: number): Promise<Chat[]> {\n    const res = await client.call({\n        _: 'contacts.getLocated',\n        geoPoint: {\n            _: 'inputGeoPoint',\n            lat: latitude,\n            long: longitude,\n        },\n    })\n\n    assertIsUpdatesGroup('contacts.getLocated', res)\n    // client.handleClientUpdate(res, true)\n\n    if (!res.updates.length) return []\n\n    assertTypeIs('contacts.getLocated (@ .updates[0])', res.updates[0], 'updatePeerLocated')\n\n    const chats = res.chats.map((it) => new Chat(it))\n\n    const index: Record<number, Chat> = {}\n    chats.forEach((c) => (index[c.id] = c))\n\n    res.updates[0].peers.forEach((peer) => {\n        if (peer._ === 'peerSelfLocated') return\n\n        const id = getMarkedPeerId(peer.peer)\n\n        if (index[id]) {\n            (index[id] as tl.Mutable<Chat>).distance = peer.distance\n        }\n    })\n\n    return chats\n}\n"]}

package/cjs/highlevel/methods/chats/get-similar-channels.d.ts

@@ -0,0 +1,12 @@
+import { ITelegramClient } from '../../client.types.js';
+import { ArrayWithTotal, Chat, InputPeerLike } from '../../types/index.js';
+/**
+ * Get channels that are similar to a given channel
+ *
+ * > **Note**: This method only returns the channels that the current user
+ * > is not subscribed to. For non-premium users, this method will only return
+ * > a few channels (with the total number of similar channels being specified in `.total`)
+ * >
+ * > Returns empty array in case there are no similar channels available.
+ */
+export declare function getSimilarChannels(client: ITelegramClient, channel: InputPeerLike): Promise<ArrayWithTotal<Chat>>;

package/cjs/highlevel/methods/chats/get-similar-channels.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getSimilarChannels = void 0;
+const index_js_1 = require("../../types/index.js");
+const misc_utils_js_1 = require("../../utils/misc-utils.js");
+const resolve_peer_js_1 = require("../users/resolve-peer.js");
+// @available=user
+/**
+ * Get channels that are similar to a given channel
+ *
+ * > **Note**: This method only returns the channels that the current user
+ * > is not subscribed to. For non-premium users, this method will only return
+ * > a few channels (with the total number of similar channels being specified in `.total`)
+ * >
+ * > Returns empty array in case there are no similar channels available.
+ */
+async function getSimilarChannels(client, channel) {
+    const res = await client.call({
+        _: 'channels.getChannelRecommendations',
+        channel: await (0, resolve_peer_js_1.resolveChannel)(client, channel),
+    });
+    const parsed = res.chats.map((chat) => new index_js_1.Chat(chat));
+    switch (res._) {
+        case 'messages.chatsSlice':
+            return (0, misc_utils_js_1.makeArrayWithTotal)(parsed, res.count);
+        case 'messages.chats':
+            return (0, misc_utils_js_1.makeArrayWithTotal)(parsed, parsed.length);
+    }
+}
+exports.getSimilarChannels = getSimilarChannels;
+//# sourceMappingURL=get-similar-channels.js.map

package/cjs/highlevel/methods/chats/get-similar-channels.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-similar-channels.js","sourceRoot":"","sources":["../../../../../src/highlevel/methods/chats/get-similar-channels.ts"],"names":[],"mappings":";;;AACA,mDAA0E;AAC1E,6DAA8D;AAC9D,8DAAyD;AAEzD,kBAAkB;AAClB;;;;;;;;GAQG;AACI,KAAK,UAAU,kBAAkB,CACpC,MAAuB,EACvB,OAAsB;IAEtB,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC;QAC1B,CAAC,EAAE,oCAAoC;QACvC,OAAO,EAAE,MAAM,IAAA,gCAAc,EAAC,MAAM,EAAE,OAAO,CAAC;KACjD,CAAC,CAAA;IAEF,MAAM,MAAM,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,eAAI,CAAC,IAAI,CAAC,CAAC,CAAA;IAEtD,QAAQ,GAAG,CAAC,CAAC,EAAE;QACX,KAAK,qBAAqB;YACtB,OAAO,IAAA,kCAAkB,EAAC,MAAM,EAAE,GAAG,CAAC,KAAK,CAAC,CAAA;QAChD,KAAK,gBAAgB;YACjB,OAAO,IAAA,kCAAkB,EAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAA;KACvD;AACL,CAAC;AAjBD,gDAiBC","sourcesContent":["import { ITelegramClient } from '../../client.types.js'\nimport { ArrayWithTotal, Chat, InputPeerLike } from '../../types/index.js'\nimport { makeArrayWithTotal } from '../../utils/misc-utils.js'\nimport { resolveChannel } from '../users/resolve-peer.js'\n\n// @available=user\n/**\n * Get channels that are similar to a given channel\n *\n * > **Note**: This method only returns the channels that the current user\n * > is not subscribed to. For non-premium users, this method will only return\n * > a few channels (with the total number of similar channels being specified in `.total`)\n * >\n * > Returns empty array in case there are no similar channels available.\n */\nexport async function getSimilarChannels(\n    client: ITelegramClient,\n    channel: InputPeerLike,\n): Promise<ArrayWithTotal<Chat>> {\n    const res = await client.call({\n        _: 'channels.getChannelRecommendations',\n        channel: await resolveChannel(client, channel),\n    })\n\n    const parsed = res.chats.map((chat) => new Chat(chat))\n\n    switch (res._) {\n        case 'messages.chatsSlice':\n            return makeArrayWithTotal(parsed, res.count)\n        case 'messages.chats':\n            return makeArrayWithTotal(parsed, parsed.length)\n    }\n}\n"]}

package/cjs/highlevel/methods/chats/iter-chat-event-log.d.ts

@@ -0,0 +1,26 @@
+import { ITelegramClient } from '../../client.types.js';
+import { ChatEvent, InputPeerLike } from '../../types/index.js';
+import { getChatEventLog } from './get-chat-event-log.js';
+/**
+ * Iterate over chat event log.
+ *
+ * Small wrapper over {@link getChatEventLog}
+ *
+ * @param chatId  Chat ID
+ * @param params
+ */
+export declare function iterChatEventLog(client: ITelegramClient, chatId: InputPeerLike, params?: Parameters<typeof getChatEventLog>[2] & {
+    /**
+     * Total number of events to return.
+     *
+     * @default  Infinity
+     */
+    limit?: number;
+    /**
+     * Chunk size, passed as `limit` to {@link getChatEventLog}.
+     * Usually you don't need to touch this.
+     *
+     * @default  100
+     */
+    chunkSize?: number;
+}): AsyncIterableIterator<ChatEvent>;

package/cjs/highlevel/methods/chats/iter-chat-event-log.js

@@ -0,0 +1,57 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.iterChatEventLog = void 0;
+const long_1 = __importDefault(require("long"));
+const filters_js_1 = require("../../types/peers/chat-event/filters.js");
+const peer_utils_js_1 = require("../../utils/peer-utils.js");
+const resolve_peer_js_1 = require("../users/resolve-peer.js");
+const resolve_peer_many_js_1 = require("../users/resolve-peer-many.js");
+const get_chat_event_log_js_1 = require("./get-chat-event-log.js");
+/**
+ * Iterate over chat event log.
+ *
+ * Small wrapper over {@link getChatEventLog}
+ *
+ * @param chatId  Chat ID
+ * @param params
+ */
+async function* iterChatEventLog(client, chatId, params) {
+    if (!params)
+        params = {};
+    const channel = await (0, resolve_peer_js_1.resolveChannel)(client, chatId);
+    const { minId = long_1.default.ZERO, query = '', limit = Infinity, chunkSize = 100, users, filters } = params;
+    const admins = users ? await (0, resolve_peer_many_js_1.resolvePeerMany)(client, users, peer_utils_js_1.toInputUser) : undefined;
+    const { serverFilter, localFilter } = (0, filters_js_1.normalizeChatEventFilters)(filters);
+    let current = 0;
+    let maxId = params.maxId ?? long_1.default.ZERO;
+    for (;;) {
+        const chunk = await (0, get_chat_event_log_js_1.getChatEventLog)(client, channel, {
+            minId,
+            maxId,
+            query,
+            limit: localFilter ? chunkSize : Math.min(limit - current, chunkSize),
+            // provide already resolved users to avoid resolving them again
+            users: admins,
+            // local filters may mess with pagination
+            filters: { serverFilter },
+        });
+        if (!chunk.length)
+            break;
+        const last = chunk[chunk.length - 1];
+        maxId = last.id;
+        for (const item of chunk) {
+            if (localFilter && (!item.action || !localFilter[item.action.type])) {
+                continue;
+            }
+            current += 1;
+            yield item;
+            if (current >= limit)
+                break;
+        }
+    }
+}
+exports.iterChatEventLog = iterChatEventLog;
+//# sourceMappingURL=iter-chat-event-log.js.map

package/cjs/highlevel/methods/chats/iter-chat-event-log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"iter-chat-event-log.js","sourceRoot":"","sources":["../../../../../src/highlevel/methods/chats/iter-chat-event-log.ts"],"names":[],"mappings":";;;;;;AAAA,gDAAuB;AAMvB,wEAAmF;AACnF,6DAAuD;AACvD,8DAAyD;AACzD,wEAA+D;AAC/D,mEAAyD;AAEzD;;;;;;;GAOG;AACI,KAAK,SAAS,CAAC,CAAC,gBAAgB,CACnC,MAAuB,EACvB,MAAqB,EACrB,MAeC;IAED,IAAI,CAAC,MAAM;QAAE,MAAM,GAAG,EAAE,CAAA;IAExB,MAAM,OAAO,GAAG,MAAM,IAAA,gCAAc,EAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAEpD,MAAM,EAAE,KAAK,GAAG,cAAI,CAAC,IAAI,EAAE,KAAK,GAAG,EAAE,EAAE,KAAK,GAAG,QAAQ,EAAE,SAAS,GAAG,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,MAAM,CAAA;IAEnG,MAAM,MAAM,GAAmC,KAAK,CAAC,CAAC,CAAC,MAAM,IAAA,sCAAe,EAAC,MAAM,EAAE,KAAK,EAAE,2BAAW,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;IAEpH,MAAM,EAAE,YAAY,EAAE,WAAW,EAAE,GAAG,IAAA,sCAAyB,EAAC,OAAO,CAAC,CAAA;IAExE,IAAI,OAAO,GAAG,CAAC,CAAA;IACf,IAAI,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,cAAI,CAAC,IAAI,CAAA;IAErC,SAAS;QACL,MAAM,KAAK,GAAG,MAAM,IAAA,uCAAe,EAAC,MAAM,EAAE,OAAO,EAAE;YACjD,KAAK;YACL,KAAK;YACL,KAAK;YACL,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG,OAAO,EAAE,SAAS,CAAC;YACrE,+DAA+D;YAC/D,KAAK,EAAE,MAAM;YACb,yCAAyC;YACzC,OAAO,EAAE,EAAE,YAAY,EAAE;SAC5B,CAAC,CAAA;QAEF,IAAI,CAAC,KAAK,CAAC,MAAM;YAAE,MAAK;QAExB,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;QACpC,KAAK,GAAG,IAAI,CAAC,EAAE,CAAA;QAEf,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE;YACtB,IAAI,WAAW,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE;gBACjE,SAAQ;aACX;YAED,OAAO,IAAI,CAAC,CAAA;YACZ,MAAM,IAAI,CAAA;YAEV,IAAI,OAAO,IAAI,KAAK;gBAAE,MAAK;SAC9B;KACJ;AACL,CAAC;AA7DD,4CA6DC","sourcesContent":["import Long from 'long'\n\nimport { tl } from '@mtcute/tl'\n\nimport { ITelegramClient } from '../../client.types.js'\nimport { ChatEvent, InputPeerLike } from '../../types/index.js'\nimport { normalizeChatEventFilters } from '../../types/peers/chat-event/filters.js'\nimport { toInputUser } from '../../utils/peer-utils.js'\nimport { resolveChannel } from '../users/resolve-peer.js'\nimport { resolvePeerMany } from '../users/resolve-peer-many.js'\nimport { getChatEventLog } from './get-chat-event-log.js'\n\n/**\n * Iterate over chat event log.\n *\n * Small wrapper over {@link getChatEventLog}\n *\n * @param chatId  Chat ID\n * @param params\n */\nexport async function* iterChatEventLog(\n    client: ITelegramClient,\n    chatId: InputPeerLike,\n    params?: Parameters<typeof getChatEventLog>[2] & {\n        /**\n         * Total number of events to return.\n         *\n         * @default  Infinity\n         */\n        limit?: number\n\n        /**\n         * Chunk size, passed as `limit` to {@link getChatEventLog}.\n         * Usually you don't need to touch this.\n         *\n         * @default  100\n         */\n        chunkSize?: number\n    },\n): AsyncIterableIterator<ChatEvent> {\n    if (!params) params = {}\n\n    const channel = await resolveChannel(client, chatId)\n\n    const { minId = Long.ZERO, query = '', limit = Infinity, chunkSize = 100, users, filters } = params\n\n    const admins: tl.TypeInputUser[] | undefined = users ? await resolvePeerMany(client, users, toInputUser) : undefined\n\n    const { serverFilter, localFilter } = normalizeChatEventFilters(filters)\n\n    let current = 0\n    let maxId = params.maxId ?? Long.ZERO\n\n    for (;;) {\n        const chunk = await getChatEventLog(client, channel, {\n            minId,\n            maxId,\n            query,\n            limit: localFilter ? chunkSize : Math.min(limit - current, chunkSize),\n            // provide already resolved users to avoid resolving them again\n            users: admins,\n            // local filters may mess with pagination\n            filters: { serverFilter },\n        })\n\n        if (!chunk.length) break\n\n        const last = chunk[chunk.length - 1]\n        maxId = last.id\n\n        for (const item of chunk) {\n            if (localFilter && (!item.action || !localFilter[item.action.type])) {\n                continue\n            }\n\n            current += 1\n            yield item\n\n            if (current >= limit) break\n        }\n    }\n}\n"]}

package/cjs/highlevel/methods/chats/iter-chat-members.d.ts

@@ -0,0 +1,22 @@
+import { ITelegramClient } from '../../client.types.js';
+import { ChatMember, InputPeerLike } from '../../types/index.js';
+import { getChatMembers } from './get-chat-members.js';
+/**
+ * Iterate through chat members
+ *
+ * This method is a small wrapper over {@link getChatMembers},
+ * which also handles duplicate entries (i.e. does not yield
+ * the same member twice)
+ *
+ * @param chatId  Chat ID or username
+ * @param params  Additional parameters
+ */
+export declare function iterChatMembers(client: ITelegramClient, chatId: InputPeerLike, params?: Parameters<typeof getChatMembers>[2] & {
+    /**
+     * Chunk size, which will be passed as `limit` parameter
+     * to {@link getChatMembers}. Usually you shouldn't care about this.
+     *
+     * @default  `200`
+     */
+    chunkSize?: number;
+}): AsyncIterableIterator<ChatMember>;

package/cjs/highlevel/methods/chats/iter-chat-members.js

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.iterChatMembers = void 0;
+const peer_utils_js_1 = require("../../utils/peer-utils.js");
+const resolve_peer_js_1 = require("../users/resolve-peer.js");
+const get_chat_members_js_1 = require("./get-chat-members.js");
+/**
+ * Iterate through chat members
+ *
+ * This method is a small wrapper over {@link getChatMembers},
+ * which also handles duplicate entries (i.e. does not yield
+ * the same member twice)
+ *
+ * @param chatId  Chat ID or username
+ * @param params  Additional parameters
+ */
+async function* iterChatMembers(client, chatId, params) {
+    if (!params)
+        params = {};
+    let current = 0;
+    let total = params.limit || Infinity;
+    const limit = Math.min(params.chunkSize ?? 200, total);
+    let offset = params.offset ?? 0;
+    const yielded = new Set();
+    const chat = await (0, resolve_peer_js_1.resolvePeer)(client, chatId);
+    for (;;) {
+        const members = await (0, get_chat_members_js_1.getChatMembers)(client, chat, {
+            offset,
+            limit,
+            query: params.query,
+            type: params.type,
+        });
+        if (!members.length)
+            break;
+        if ((0, peer_utils_js_1.isInputPeerChat)(chat)) {
+            total = members.length;
+        }
+        offset += members.length;
+        for (const m of members) {
+            const uid = m.user.id;
+            // handle duplicates
+            if (yielded.has(uid))
+                continue;
+            yielded.add(uid);
+            yield m;
+            current += 1;
+            if (current >= total)
+                return;
+        }
+    }
+}
+exports.iterChatMembers = iterChatMembers;
+//# sourceMappingURL=iter-chat-members.js.map

package/cjs/highlevel/methods/chats/iter-chat-members.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"iter-chat-members.js","sourceRoot":"","sources":["../../../../../src/highlevel/methods/chats/iter-chat-members.ts"],"names":[],"mappings":";;;AAEA,6DAA2D;AAC3D,8DAAsD;AACtD,+DAAsD;AAEtD;;;;;;;;;GASG;AACI,KAAK,SAAS,CAAC,CAAC,eAAe,CAClC,MAAuB,EACvB,MAAqB,EACrB,MAQC;IAED,IAAI,CAAC,MAAM;QAAE,MAAM,GAAG,EAAE,CAAA;IAExB,IAAI,OAAO,GAAG,CAAC,CAAA;IACf,IAAI,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,QAAQ,CAAA;IACpC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,IAAI,GAAG,EAAE,KAAK,CAAC,CAAA;IACtD,IAAI,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,CAAC,CAAA;IAE/B,MAAM,OAAO,GAAG,IAAI,GAAG,EAAE,CAAA;IACzB,MAAM,IAAI,GAAG,MAAM,IAAA,6BAAW,EAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAE9C,SAAS;QACL,MAAM,OAAO,GAAG,MAAM,IAAA,oCAAc,EAAC,MAAM,EAAE,IAAI,EAAE;YAC/C,MAAM;YACN,KAAK;YACL,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,IAAI,EAAE,MAAM,CAAC,IAAI;SACpB,CAAC,CAAA;QAEF,IAAI,CAAC,OAAO,CAAC,MAAM;YAAE,MAAK;QAE1B,IAAI,IAAA,+BAAe,EAAC,IAAI,CAAC,EAAE;YACvB,KAAK,GAAG,OAAO,CAAC,MAAM,CAAA;SACzB;QAED,MAAM,IAAI,OAAO,CAAC,MAAM,CAAA;QAExB,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE;YACrB,MAAM,GAAG,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,CAAA;YAErB,oBAAoB;YACpB,IAAI,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC;gBAAE,SAAQ;YAC9B,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;YAEhB,MAAM,CAAC,CAAA;YAEP,OAAO,IAAI,CAAC,CAAA;YACZ,IAAI,OAAO,IAAI,KAAK;gBAAE,OAAM;SAC/B;KACJ;AACL,CAAC;AApDD,0CAoDC","sourcesContent":["import { ITelegramClient } from '../../client.types.js'\nimport { ChatMember, InputPeerLike } from '../../types/index.js'\nimport { isInputPeerChat } from '../../utils/peer-utils.js'\nimport { resolvePeer } from '../users/resolve-peer.js'\nimport { getChatMembers } from './get-chat-members.js'\n\n/**\n * Iterate through chat members\n *\n * This method is a small wrapper over {@link getChatMembers},\n * which also handles duplicate entries (i.e. does not yield\n * the same member twice)\n *\n * @param chatId  Chat ID or username\n * @param params  Additional parameters\n */\nexport async function* iterChatMembers(\n    client: ITelegramClient,\n    chatId: InputPeerLike,\n    params?: Parameters<typeof getChatMembers>[2] & {\n        /**\n         * Chunk size, which will be passed as `limit` parameter\n         * to {@link getChatMembers}. Usually you shouldn't care about this.\n         *\n         * @default  `200`\n         */\n        chunkSize?: number\n    },\n): AsyncIterableIterator<ChatMember> {\n    if (!params) params = {}\n\n    let current = 0\n    let total = params.limit || Infinity\n    const limit = Math.min(params.chunkSize ?? 200, total)\n    let offset = params.offset ?? 0\n\n    const yielded = new Set()\n    const chat = await resolvePeer(client, chatId)\n\n    for (;;) {\n        const members = await getChatMembers(client, chat, {\n            offset,\n            limit,\n            query: params.query,\n            type: params.type,\n        })\n\n        if (!members.length) break\n\n        if (isInputPeerChat(chat)) {\n            total = members.length\n        }\n\n        offset += members.length\n\n        for (const m of members) {\n            const uid = m.user.id\n\n            // handle duplicates\n            if (yielded.has(uid)) continue\n            yielded.add(uid)\n\n            yield m\n\n            current += 1\n            if (current >= total) return\n        }\n    }\n}\n"]}

package/cjs/highlevel/methods/chats/join-chat.d.ts

@@ -0,0 +1,14 @@
+import { ITelegramClient } from '../../client.types.js';
+import { Chat, InputPeerLike } from '../../types/index.js';
+/**
+ * Join a channel or supergroup
+ *
+ * When using with invite links, this method may throw RPC error
+ * `INVITE_REQUEST_SENT`, which means that you need to wait for admin approval.
+ * You will get into the chat once they do so.
+ *
+ * @param chatId
+ *   Chat identifier. Either an invite link (`t.me/joinchat/*`), a username (`@username`)
+ *   or ID of the linked supergroup or channel.
+ */
+export declare function joinChat(client: ITelegramClient, chatId: InputPeerLike): Promise<Chat>;