@mtcute/core 0.5.0 → 0.7.0

package/esm/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,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAA;AAE1D,OAAO,EAAE,IAAI,EAAiB,mBAAmB,EAAE,MAAM,sBAAsB,CAAA;AAC/E,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAA;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAA;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AAEzD,kBAAkB;AAClB;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,MAAuB,EAAE,MAAqB;IACxE,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE;QAC5B,MAAM,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,iBAAiB,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,eAAe,CAAC,sBAAsB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;aAC/E;YAED,OAAO,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;SAC5B;KACJ;IAED,MAAM,IAAI,GAAG,MAAM,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAE9C,MAAM,GAAG,GAAG,MAAM,kBAAkB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;IAElD,IAAI,CAAC,GAAG;QAAE,MAAM,IAAI,mBAAmB,CAAC,QAAQ,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAA;IAEvF,OAAO,IAAI,IAAI,CAAC,GAAG,CAAC,CAAA;AACxB,CAAC","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/esm/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/esm/highlevel/methods/chats/get-full-chat.js

@@ -0,0 +1,53 @@
+import { MtArgumentError } from '../../../types/errors.js';
+import { Chat } from '../../types/index.js';
+import { INVITE_LINK_REGEX, isInputPeerChannel, isInputPeerChat, isInputPeerUser, toInputChannel, toInputUser, } from '../../utils/peer-utils.js';
+import { resolvePeer } from '../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.
+ */
+export async function getFullChat(client, chatId) {
+    if (typeof chatId === 'string') {
+        const m = chatId.match(INVITE_LINK_REGEX);
+        if (m) {
+            const res = await client.call({
+                _: 'messages.checkChatInvite',
+                hash: m[1],
+            });
+            if (res._ === 'chatInvite') {
+                throw new MtArgumentError(`You haven't joined ${JSON.stringify(res.title)}`);
+            }
+            // we still need to fetch full chat info
+            chatId = res.chat.id;
+        }
+    }
+    const peer = await resolvePeer(client, chatId);
+    let res;
+    if (isInputPeerChannel(peer)) {
+        res = await client.call({
+            _: 'channels.getFullChannel',
+            channel: toInputChannel(peer),
+        });
+    }
+    else if (isInputPeerUser(peer)) {
+        res = await client.call({
+            _: 'users.getFullUser',
+            id: toInputUser(peer),
+        });
+    }
+    else if (isInputPeerChat(peer)) {
+        res = await client.call({
+            _: 'messages.getFullChat',
+            chatId: peer.chatId,
+        });
+    }
+    else
+        throw new Error('should not happen');
+    return Chat._parseFull(res);
+}
+//# sourceMappingURL=get-full-chat.js.map

package/esm/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,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAA;AAE1D,OAAO,EAAE,IAAI,EAAiB,MAAM,sBAAsB,CAAA;AAC1D,OAAO,EACH,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,EACf,eAAe,EACf,cAAc,EACd,WAAW,GACd,MAAM,2BAA2B,CAAA;AAClC,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAA;AAEtD,kBAAkB;AAClB;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,MAAuB,EAAE,MAAqB;IAC5E,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE;QAC5B,MAAM,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,iBAAiB,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,eAAe,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,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAE9C,IAAI,GAAqD,CAAA;IACzD,IAAI,kBAAkB,CAAC,IAAI,CAAC,EAAE;QAC1B,GAAG,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC;YACpB,CAAC,EAAE,yBAAyB;YAC5B,OAAO,EAAE,cAAc,CAAC,IAAI,CAAC;SAChC,CAAC,CAAA;KACL;SAAM,IAAI,eAAe,CAAC,IAAI,CAAC,EAAE;QAC9B,GAAG,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC;YACpB,CAAC,EAAE,mBAAmB;YACtB,EAAE,EAAE,WAAW,CAAC,IAAI,CAAE;SACzB,CAAC,CAAA;KACL;SAAM,IAAI,eAAe,CAAC,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,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAA;AAC/B,CAAC","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/esm/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/esm/highlevel/methods/chats/get-nearby-chats.js

@@ -0,0 +1,38 @@
+import { getMarkedPeerId } from '../../../utils/peer-utils.js';
+import { assertTypeIs } from '../../../utils/type-assertions.js';
+import { Chat } from '../../types/index.js';
+import { assertIsUpdatesGroup } from '../../updates/utils.js';
+/**
+ * Get nearby chats
+ *
+ * @param latitude  Latitude of the location
+ * @param longitude  Longitude of the location
+ */
+export async function getNearbyChats(client, latitude, longitude) {
+    const res = await client.call({
+        _: 'contacts.getLocated',
+        geoPoint: {
+            _: 'inputGeoPoint',
+            lat: latitude,
+            long: longitude,
+        },
+    });
+    assertIsUpdatesGroup('contacts.getLocated', res);
+    // client.handleClientUpdate(res, true)
+    if (!res.updates.length)
+        return [];
+    assertTypeIs('contacts.getLocated (@ .updates[0])', res.updates[0], 'updatePeerLocated');
+    const chats = res.chats.map((it) => new Chat(it));
+    const index = {};
+    chats.forEach((c) => (index[c.id] = c));
+    res.updates[0].peers.forEach((peer) => {
+        if (peer._ === 'peerSelfLocated')
+            return;
+        const id = getMarkedPeerId(peer.peer);
+        if (index[id]) {
+            index[id].distance = peer.distance;
+        }
+    });
+    return chats;
+}
+//# sourceMappingURL=get-nearby-chats.js.map

package/esm/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,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAA;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAA;AAEhE,OAAO,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAA;AAC3C,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA;AAE7D;;;;;GAKG;AACH,MAAM,CAAC,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,oBAAoB,CAAC,qBAAqB,EAAE,GAAG,CAAC,CAAA;IAChD,uCAAuC;IAEvC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM;QAAE,OAAO,EAAE,CAAA;IAElC,YAAY,CAAC,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,IAAI,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,eAAe,CAAC,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","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/esm/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/esm/highlevel/methods/chats/get-similar-channels.js

@@ -0,0 +1,27 @@
+import { Chat } from '../../types/index.js';
+import { makeArrayWithTotal } from '../../utils/misc-utils.js';
+import { resolveChannel } from '../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.
+ */
+export async function getSimilarChannels(client, channel) {
+    const res = await client.call({
+        _: 'channels.getChannelRecommendations',
+        channel: await resolveChannel(client, channel),
+    });
+    const parsed = res.chats.map((chat) => new Chat(chat));
+    switch (res._) {
+        case 'messages.chatsSlice':
+            return makeArrayWithTotal(parsed, res.count);
+        case 'messages.chats':
+            return makeArrayWithTotal(parsed, parsed.length);
+    }
+}
+//# sourceMappingURL=get-similar-channels.js.map

package/esm/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,OAAO,EAAkB,IAAI,EAAiB,MAAM,sBAAsB,CAAA;AAC1E,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAA;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAA;AAEzD,kBAAkB;AAClB;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACpC,MAAuB,EACvB,OAAsB;IAEtB,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC;QAC1B,CAAC,EAAE,oCAAoC;QACvC,OAAO,EAAE,MAAM,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC;KACjD,CAAC,CAAA;IAEF,MAAM,MAAM,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,CAAA;IAEtD,QAAQ,GAAG,CAAC,CAAC,EAAE;QACX,KAAK,qBAAqB;YACtB,OAAO,kBAAkB,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,CAAC,CAAA;QAChD,KAAK,gBAAgB;YACjB,OAAO,kBAAkB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAA;KACvD;AACL,CAAC","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/esm/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/esm/highlevel/methods/chats/iter-chat-event-log.js

@@ -0,0 +1,50 @@
+import Long from 'long';
+import { normalizeChatEventFilters } from '../../types/peers/chat-event/filters.js';
+import { toInputUser } from '../../utils/peer-utils.js';
+import { resolveChannel } from '../users/resolve-peer.js';
+import { resolvePeerMany } from '../users/resolve-peer-many.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 async function* iterChatEventLog(client, chatId, params) {
+    if (!params)
+        params = {};
+    const channel = await resolveChannel(client, chatId);
+    const { minId = Long.ZERO, query = '', limit = Infinity, chunkSize = 100, users, filters } = params;
+    const admins = users ? await resolvePeerMany(client, users, toInputUser) : undefined;
+    const { serverFilter, localFilter } = normalizeChatEventFilters(filters);
+    let current = 0;
+    let maxId = params.maxId ?? Long.ZERO;
+    for (;;) {
+        const chunk = await 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;
+        }
+    }
+}
+//# sourceMappingURL=iter-chat-event-log.js.map

package/esm/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,OAAO,IAAI,MAAM,MAAM,CAAA;AAMvB,OAAO,EAAE,yBAAyB,EAAE,MAAM,yCAAyC,CAAA;AACnF,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAA;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAA;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAA;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA;AAEzD;;;;;;;GAOG;AACH,MAAM,CAAC,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,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAEpD,MAAM,EAAE,KAAK,GAAG,IAAI,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,eAAe,CAAC,MAAM,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;IAEpH,MAAM,EAAE,YAAY,EAAE,WAAW,EAAE,GAAG,yBAAyB,CAAC,OAAO,CAAC,CAAA;IAExE,IAAI,OAAO,GAAG,CAAC,CAAA;IACf,IAAI,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,IAAI,CAAC,IAAI,CAAA;IAErC,SAAS;QACL,MAAM,KAAK,GAAG,MAAM,eAAe,CAAC,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","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/esm/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/esm/highlevel/methods/chats/iter-chat-members.js

@@ -0,0 +1,49 @@
+import { isInputPeerChat } from '../../utils/peer-utils.js';
+import { resolvePeer } from '../users/resolve-peer.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 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 resolvePeer(client, chatId);
+    for (;;) {
+        const members = await getChatMembers(client, chat, {
+            offset,
+            limit,
+            query: params.query,
+            type: params.type,
+        });
+        if (!members.length)
+            break;
+        if (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;
+        }
+    }
+}
+//# sourceMappingURL=iter-chat-members.js.map

package/esm/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,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAA;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAA;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AAEtD;;;;;;;;;GASG;AACH,MAAM,CAAC,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,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAE9C,SAAS;QACL,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC,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,eAAe,CAAC,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","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/esm/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>;

package/esm/highlevel/methods/chats/join-chat.js

@@ -0,0 +1,37 @@
+import { Chat } from '../../types/index.js';
+import { assertIsUpdatesGroup } from '../../updates/utils.js';
+import { INVITE_LINK_REGEX } from '../../utils/peer-utils.js';
+import { resolveChannel } from '../users/resolve-peer.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 async function joinChat(client, chatId) {
+    if (typeof chatId === 'string') {
+        const m = chatId.match(INVITE_LINK_REGEX);
+        if (m) {
+            const res = await client.call({
+                _: 'messages.importChatInvite',
+                hash: m[1],
+            });
+            assertIsUpdatesGroup('messages.importChatInvite', res);
+            client.handleClientUpdate(res);
+            return new Chat(res.chats[0]);
+        }
+    }
+    const res = await client.call({
+        _: 'channels.joinChannel',
+        channel: await resolveChannel(client, chatId),
+    });
+    assertIsUpdatesGroup('channels.joinChannel', res);
+    client.handleClientUpdate(res);
+    return new Chat(res.chats[0]);
+}
+//# sourceMappingURL=join-chat.js.map

package/esm/highlevel/methods/chats/join-chat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"join-chat.js","sourceRoot":"","sources":["../../../../../src/highlevel/methods/chats/join-chat.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAiB,MAAM,sBAAsB,CAAA;AAC1D,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAA;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAA;AAEzD;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,MAAuB,EAAE,MAAqB;IACzE,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE;QAC5B,MAAM,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAA;QAEzC,IAAI,CAAC,EAAE;YACH,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC;gBAC1B,CAAC,EAAE,2BAA2B;gBAC9B,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;aACb,CAAC,CAAA;YACF,oBAAoB,CAAC,2BAA2B,EAAE,GAAG,CAAC,CAAA;YAEtD,MAAM,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAA;YAE9B,OAAO,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;SAChC;KACJ;IAED,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC;QAC1B,CAAC,EAAE,sBAAsB;QACzB,OAAO,EAAE,MAAM,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC;KAChD,CAAC,CAAA;IAEF,oBAAoB,CAAC,sBAAsB,EAAE,GAAG,CAAC,CAAA;IAEjD,MAAM,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAA;IAE9B,OAAO,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;AACjC,CAAC","sourcesContent":["import { ITelegramClient } from '../../client.types.js'\nimport { Chat, InputPeerLike } from '../../types/index.js'\nimport { assertIsUpdatesGroup } from '../../updates/utils.js'\nimport { INVITE_LINK_REGEX } from '../../utils/peer-utils.js'\nimport { resolveChannel } from '../users/resolve-peer.js'\n\n/**\n * Join a channel or supergroup\n *\n * When using with invite links, this method may throw RPC error\n * `INVITE_REQUEST_SENT`, which means that you need to wait for admin approval.\n * You will get into the chat once they do so.\n *\n * @param chatId\n *   Chat identifier. Either an invite link (`t.me/joinchat/*`), a username (`@username`)\n *   or ID of the linked supergroup or channel.\n */\nexport async function joinChat(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.importChatInvite',\n                hash: m[1],\n            })\n            assertIsUpdatesGroup('messages.importChatInvite', res)\n\n            client.handleClientUpdate(res)\n\n            return new Chat(res.chats[0])\n        }\n    }\n\n    const res = await client.call({\n        _: 'channels.joinChannel',\n        channel: await resolveChannel(client, chatId),\n    })\n\n    assertIsUpdatesGroup('channels.joinChannel', res)\n\n    client.handleClientUpdate(res)\n\n    return new Chat(res.chats[0])\n}\n"]}

package/esm/highlevel/methods/chats/kick-chat-member.d.ts

@@ -0,0 +1,15 @@
+import { ITelegramClient } from '../../client.types.js';
+import { InputPeerLike, Message } from '../../types/index.js';
+/**
+ * Kick a user from a chat.
+ *
+ * This effectively bans a user and immediately unbans them.
+ *
+ *  @returns  Service message about removed user, if one was generated.
+ */
+export declare function kickChatMember(client: ITelegramClient, params: {
+    /** Chat ID */
+    chatId: InputPeerLike;
+    /** User ID */
+    userId: InputPeerLike;
+}): Promise<Message | null>;

package/esm/highlevel/methods/chats/kick-chat-member.js

@@ -0,0 +1,26 @@
+import { sleep } from '../../../utils/misc-utils.js';
+import { isInputPeerChannel } from '../../utils/peer-utils.js';
+import { resolvePeer } from '../users/resolve-peer.js';
+import { banChatMember } from './ban-chat-member.js';
+import { unbanChatMember } from './unban-chat-member.js';
+/**
+ * Kick a user from a chat.
+ *
+ * This effectively bans a user and immediately unbans them.
+ *
+ *  @returns  Service message about removed user, if one was generated.
+ */
+export async function kickChatMember(client, params) {
+    const { chatId, userId } = params;
+    const chat = await resolvePeer(client, chatId);
+    const user = await resolvePeer(client, userId);
+    const msg = await banChatMember(client, { chatId: chat, participantId: user });
+    // not needed in case this is a legacy group
+    if (isInputPeerChannel(chat)) {
+        // i fucking love telegram serverside race conditions
+        await sleep(1000);
+        await unbanChatMember(client, { chatId: chat, participantId: user });
+    }
+    return msg;
+}
+//# sourceMappingURL=kick-chat-member.js.map

package/esm/highlevel/methods/chats/kick-chat-member.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kick-chat-member.js","sourceRoot":"","sources":["../../../../../src/highlevel/methods/chats/kick-chat-member.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,8BAA8B,CAAA;AAGpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAA;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAA;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AAExD;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAChC,MAAuB,EACvB,MAKC;IAED,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAAA;IAEjC,MAAM,IAAI,GAAG,MAAM,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC9C,MAAM,IAAI,GAAG,MAAM,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAE9C,MAAM,GAAG,GAAG,MAAM,aAAa,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAA;IAE9E,4CAA4C;IAC5C,IAAI,kBAAkB,CAAC,IAAI,CAAC,EAAE;QAC1B,qDAAqD;QACrD,MAAM,KAAK,CAAC,IAAI,CAAC,CAAA;QACjB,MAAM,eAAe,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAA;KACvE;IAED,OAAO,GAAG,CAAA;AACd,CAAC","sourcesContent":["import { sleep } from '../../../utils/misc-utils.js'\nimport { ITelegramClient } from '../../client.types.js'\nimport { InputPeerLike, Message } from '../../types/index.js'\nimport { isInputPeerChannel } from '../../utils/peer-utils.js'\nimport { resolvePeer } from '../users/resolve-peer.js'\nimport { banChatMember } from './ban-chat-member.js'\nimport { unbanChatMember } from './unban-chat-member.js'\n\n/**\n * Kick a user from a chat.\n *\n * This effectively bans a user and immediately unbans them.\n *\n *  @returns  Service message about removed user, if one was generated.\n */\nexport async function kickChatMember(\n    client: ITelegramClient,\n    params: {\n        /** Chat ID */\n        chatId: InputPeerLike\n        /** User ID */\n        userId: InputPeerLike\n    },\n): Promise<Message | null> {\n    const { chatId, userId } = params\n\n    const chat = await resolvePeer(client, chatId)\n    const user = await resolvePeer(client, userId)\n\n    const msg = await banChatMember(client, { chatId: chat, participantId: user })\n\n    // not needed in case this is a legacy group\n    if (isInputPeerChannel(chat)) {\n        // i fucking love telegram serverside race conditions\n        await sleep(1000)\n        await unbanChatMember(client, { chatId: chat, participantId: user })\n    }\n\n    return msg\n}\n"]}

package/esm/highlevel/methods/chats/leave-chat.d.ts

@@ -0,0 +1,13 @@
+import { ITelegramClient } from '../../client.types.js';
+import { InputPeerLike } from '../../types/index.js';
+/**
+ * Leave a group chat, supergroup or channel
+ *
+ * @param chatId  Chat ID or username
+ */
+export declare function leaveChat(client: ITelegramClient, chatId: InputPeerLike, params?: {
+    /**
+     * Whether to clear history after leaving (only for legacy group chats)
+     */
+    clear?: boolean;
+}): Promise<void>;

package/esm/highlevel/methods/chats/leave-chat.js

@@ -0,0 +1,33 @@
+import { MtInvalidPeerTypeError } from '../../types/index.js';
+import { isInputPeerChannel, isInputPeerChat, toInputChannel } from '../../utils/peer-utils.js';
+import { resolvePeer } from '../users/resolve-peer.js';
+import { deleteHistory } from './delete-history.js';
+/**
+ * Leave a group chat, supergroup or channel
+ *
+ * @param chatId  Chat ID or username
+ */
+export async function leaveChat(client, chatId, params) {
+    const chat = await resolvePeer(client, chatId);
+    if (isInputPeerChannel(chat)) {
+        const res = await client.call({
+            _: 'channels.leaveChannel',
+            channel: toInputChannel(chat),
+        });
+        client.handleClientUpdate(res);
+    }
+    else if (isInputPeerChat(chat)) {
+        const res = await client.call({
+            _: 'messages.deleteChatUser',
+            chatId: chat.chatId,
+            userId: { _: 'inputUserSelf' },
+        });
+        client.handleClientUpdate(res);
+        if (params?.clear) {
+            await deleteHistory(client, chat);
+        }
+    }
+    else
+        throw new MtInvalidPeerTypeError(chatId, 'chat or channel');
+}
+//# sourceMappingURL=leave-chat.js.map

package/esm/highlevel/methods/chats/leave-chat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"leave-chat.js","sourceRoot":"","sources":["../../../../../src/highlevel/methods/chats/leave-chat.ts"],"names":[],"mappings":"AACA,OAAO,EAAiB,sBAAsB,EAAE,MAAM,sBAAsB,CAAA;AAC5E,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAA;AAC/F,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAA;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAEnD;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC3B,MAAuB,EACvB,MAAqB,EACrB,MAKC;IAED,MAAM,IAAI,GAAG,MAAM,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAE9C,IAAI,kBAAkB,CAAC,IAAI,CAAC,EAAE;QAC1B,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC;YAC1B,CAAC,EAAE,uBAAuB;YAC1B,OAAO,EAAE,cAAc,CAAC,IAAI,CAAC;SAChC,CAAC,CAAA;QACF,MAAM,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAA;KACjC;SAAM,IAAI,eAAe,CAAC,IAAI,CAAC,EAAE;QAC9B,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC;YAC1B,CAAC,EAAE,yBAAyB;YAC5B,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,MAAM,EAAE,EAAE,CAAC,EAAE,eAAe,EAAE;SACjC,CAAC,CAAA;QACF,MAAM,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAA;QAE9B,IAAI,MAAM,EAAE,KAAK,EAAE;YACf,MAAM,aAAa,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;SACpC;KACJ;;QAAM,MAAM,IAAI,sBAAsB,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAA;AACtE,CAAC","sourcesContent":["import { ITelegramClient } from '../../client.types.js'\nimport { InputPeerLike, MtInvalidPeerTypeError } from '../../types/index.js'\nimport { isInputPeerChannel, isInputPeerChat, toInputChannel } from '../../utils/peer-utils.js'\nimport { resolvePeer } from '../users/resolve-peer.js'\nimport { deleteHistory } from './delete-history.js'\n\n/**\n * Leave a group chat, supergroup or channel\n *\n * @param chatId  Chat ID or username\n */\nexport async function leaveChat(\n    client: ITelegramClient,\n    chatId: InputPeerLike,\n    params?: {\n        /**\n         * Whether to clear history after leaving (only for legacy group chats)\n         */\n        clear?: boolean\n    },\n): Promise<void> {\n    const chat = await resolvePeer(client, chatId)\n\n    if (isInputPeerChannel(chat)) {\n        const res = await client.call({\n            _: 'channels.leaveChannel',\n            channel: toInputChannel(chat),\n        })\n        client.handleClientUpdate(res)\n    } else if (isInputPeerChat(chat)) {\n        const res = await client.call({\n            _: 'messages.deleteChatUser',\n            chatId: chat.chatId,\n            userId: { _: 'inputUserSelf' },\n        })\n        client.handleClientUpdate(res)\n\n        if (params?.clear) {\n            await deleteHistory(client, chat)\n        }\n    } else throw new MtInvalidPeerTypeError(chatId, 'chat or channel')\n}\n"]}

package/esm/highlevel/methods/chats/mark-chat-unread.d.ts

@@ -0,0 +1,8 @@
+import { ITelegramClient } from '../../client.types.js';
+import { InputPeerLike } from '../../types/index.js';
+/**
+ * Mark a chat as unread
+ *
+ * @param chatId  Chat ID
+ */
+export declare function markChatUnread(client: ITelegramClient, chatId: InputPeerLike): Promise<void>;

package/esm/highlevel/methods/chats/mark-chat-unread.js

@@ -0,0 +1,19 @@
+import { assertTrue } from '../../../utils/type-assertions.js';
+import { resolvePeer } from '../users/resolve-peer.js';
+/**
+ * Mark a chat as unread
+ *
+ * @param chatId  Chat ID
+ */
+export async function markChatUnread(client, chatId) {
+    const r = await client.call({
+        _: 'messages.markDialogUnread',
+        peer: {
+            _: 'inputDialogPeer',
+            peer: await resolvePeer(client, chatId),
+        },
+        unread: true,
+    });
+    assertTrue('messages.markDialogUnread', r);
+}
+//# sourceMappingURL=mark-chat-unread.js.map

package/esm/highlevel/methods/chats/mark-chat-unread.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mark-chat-unread.js","sourceRoot":"","sources":["../../../../../src/highlevel/methods/chats/mark-chat-unread.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,mCAAmC,CAAA;AAG9D,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAA;AAEtD;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,MAAuB,EAAE,MAAqB;IAC/E,MAAM,CAAC,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC;QACxB,CAAC,EAAE,2BAA2B;QAC9B,IAAI,EAAE;YACF,CAAC,EAAE,iBAAiB;YACpB,IAAI,EAAE,MAAM,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC;SAC1C;QACD,MAAM,EAAE,IAAI;KACf,CAAC,CAAA;IAEF,UAAU,CAAC,2BAA2B,EAAE,CAAC,CAAC,CAAA;AAC9C,CAAC","sourcesContent":["import { assertTrue } from '../../../utils/type-assertions.js'\nimport { ITelegramClient } from '../../client.types.js'\nimport { InputPeerLike } from '../../types/index.js'\nimport { resolvePeer } from '../users/resolve-peer.js'\n\n/**\n * Mark a chat as unread\n *\n * @param chatId  Chat ID\n */\nexport async function markChatUnread(client: ITelegramClient, chatId: InputPeerLike): Promise<void> {\n    const r = await client.call({\n        _: 'messages.markDialogUnread',\n        peer: {\n            _: 'inputDialogPeer',\n            peer: await resolvePeer(client, chatId),\n        },\n        unread: true,\n    })\n\n    assertTrue('messages.markDialogUnread', r)\n}\n"]}

package/esm/highlevel/methods/chats/open-chat.d.ts

@@ -0,0 +1,21 @@
+import { ITelegramClient } from '../../client.types.js';
+import { InputPeerLike } from '../../types/peers/index.js';
+/**
+ * Inform the library that the user has opened a chat.
+ *
+ * Some library logic depends on this, for example, the library will
+ * periodically ping the server to keep the updates flowing.
+ *
+ * @param chat  Chat to open
+ */
+export declare function openChat(client: ITelegramClient, chat: InputPeerLike): Promise<void>;
+/**
+ * Inform the library that the user has closed a chat.
+ * Un-does the effect of {@link openChat}.
+ *
+ * Some library logic depends on this, for example, the library will
+ * periodically ping the server to keep the updates flowing.
+ *
+ * @param chat  Chat to open
+ */
+export declare function closeChat(client: ITelegramClient, chat: InputPeerLike): Promise<void>;

package/esm/highlevel/methods/chats/open-chat.js

@@ -0,0 +1,38 @@
+import { isInputPeerChannel } from '../../utils/peer-utils.js';
+import { getPeerDialogs } from '../dialogs/get-peer-dialogs.js';
+import { resolvePeer } from '../users/resolve-peer.js';
+/**
+ * Inform the library that the user has opened a chat.
+ *
+ * Some library logic depends on this, for example, the library will
+ * periodically ping the server to keep the updates flowing.
+ *
+ * @param chat  Chat to open
+ */
+export async function openChat(client, chat) {
+    const peer = await resolvePeer(client, chat);
+    if (isInputPeerChannel(peer)) {
+        const [dialog] = await getPeerDialogs(client, peer);
+        await client.notifyChannelOpened(peer.channelId, dialog.raw.pts);
+    }
+    // todo: once we have proper dialogs/peers db, we should also
+    // update full info here and fetch auxillary info (like channel members etc)
+}
+/**
+ * Inform the library that the user has closed a chat.
+ * Un-does the effect of {@link openChat}.
+ *
+ * Some library logic depends on this, for example, the library will
+ * periodically ping the server to keep the updates flowing.
+ *
+ * @param chat  Chat to open
+ */
+export async function closeChat(client, chat) {
+    const peer = await resolvePeer(client, chat);
+    if (isInputPeerChannel(peer)) {
+        await client.notifyChannelClosed(peer.channelId);
+    }
+    // todo: once we have proper dialogs/peers db, we should also
+    // update full info here and fetch auxillary info (like channel members etc)
+}
+//# sourceMappingURL=open-chat.js.map