@mtcute/core 0.6.0 → 0.7.0

package/esm/highlevel/methods/chats/delete-group.js

@@ -0,0 +1,27 @@
+import { assertTrue } from '../../../utils/type-assertions.js';
+import { MtInvalidPeerTypeError } from '../../types/index.js';
+import { isInputPeerChat } from '../../utils/peer-utils.js';
+import { resolvePeer } from '../users/resolve-peer.js';
+/**
+ * Delete a legacy group chat for all members
+ *
+ * @param chatId  Chat ID
+ */
+export async function deleteGroup(client, chatId) {
+    const chat = await resolvePeer(client, chatId);
+    if (!isInputPeerChat(chat))
+        throw new MtInvalidPeerTypeError(chatId, 'chat');
+    const res = await client.call({
+        _: 'messages.deleteChatUser',
+        revokeHistory: true,
+        chatId: chat.chatId,
+        userId: { _: 'inputUserSelf' },
+    });
+    client.handleClientUpdate(res);
+    const r = await client.call({
+        _: 'messages.deleteChat',
+        chatId: chat.chatId,
+    });
+    assertTrue('messages.deleteChat', r);
+}
+//# sourceMappingURL=delete-group.js.map

package/esm/highlevel/methods/chats/delete-group.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete-group.js","sourceRoot":"","sources":["../../../../../src/highlevel/methods/chats/delete-group.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,mCAAmC,CAAA;AAE9D,OAAO,EAAiB,sBAAsB,EAAE,MAAM,sBAAsB,CAAA;AAC5E,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAA;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAA;AAEtD;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,MAAuB,EAAE,MAAqB;IAC5E,MAAM,IAAI,GAAG,MAAM,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC9C,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC;QAAE,MAAM,IAAI,sBAAsB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAE5E,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC;QAC1B,CAAC,EAAE,yBAAyB;QAC5B,aAAa,EAAE,IAAI;QACnB,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,MAAM,EAAE,EAAE,CAAC,EAAE,eAAe,EAAE;KACjC,CAAC,CAAA;IACF,MAAM,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAA;IAE9B,MAAM,CAAC,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC;QACxB,CAAC,EAAE,qBAAqB;QACxB,MAAM,EAAE,IAAI,CAAC,MAAM;KACtB,CAAC,CAAA;IAEF,UAAU,CAAC,qBAAqB,EAAE,CAAC,CAAC,CAAA;AACxC,CAAC","sourcesContent":["import { assertTrue } from '../../../utils/type-assertions.js'\nimport { ITelegramClient } from '../../client.types.js'\nimport { InputPeerLike, MtInvalidPeerTypeError } from '../../types/index.js'\nimport { isInputPeerChat } from '../../utils/peer-utils.js'\nimport { resolvePeer } from '../users/resolve-peer.js'\n\n/**\n * Delete a legacy group chat for all members\n *\n * @param chatId  Chat ID\n */\nexport async function deleteGroup(client: ITelegramClient, chatId: InputPeerLike): Promise<void> {\n    const chat = await resolvePeer(client, chatId)\n    if (!isInputPeerChat(chat)) throw new MtInvalidPeerTypeError(chatId, 'chat')\n\n    const res = await client.call({\n        _: 'messages.deleteChatUser',\n        revokeHistory: true,\n        chatId: chat.chatId,\n        userId: { _: 'inputUserSelf' },\n    })\n    client.handleClientUpdate(res)\n\n    const r = await client.call({\n        _: 'messages.deleteChat',\n        chatId: chat.chatId,\n    })\n\n    assertTrue('messages.deleteChat', r)\n}\n"]}

package/esm/highlevel/methods/chats/delete-history.d.ts

@@ -0,0 +1,24 @@
+import { ITelegramClient } from '../../client.types.js';
+import { InputPeerLike } from '../../types/index.js';
+/**
+ * Delete communication history (for private chats and legacy groups)
+ */
+export declare function deleteHistory(client: ITelegramClient, chat: InputPeerLike, params?: {
+    /**
+     * Deletion mode. Can be:
+     * - `delete`: delete messages (only for yourself)
+     * - `clear`: delete messages (only for yourself)
+     * - `revoke`: delete messages for all users
+     * - I'm not sure what's the difference between `delete` and `clear`,
+     * but they are in fact different flags in TL object.
+     *
+     * @default  'delete'
+     */
+    mode: 'delete' | 'clear' | 'revoke';
+    /**
+     * Maximum ID of message to delete.
+     *
+     * @default  0, i.e. remove all messages
+     */
+    maxId?: number;
+}): Promise<void>;

package/esm/highlevel/methods/chats/delete-history.js

@@ -0,0 +1,24 @@
+import { createDummyUpdate } from '../../updates/utils.js';
+import { isInputPeerChannel } from '../../utils/peer-utils.js';
+import { resolvePeer } from '../users/resolve-peer.js';
+/**
+ * Delete communication history (for private chats and legacy groups)
+ */
+export async function deleteHistory(client, chat, params) {
+    const { mode = 'delete', maxId = 0 } = params ?? {};
+    const peer = await resolvePeer(client, chat);
+    const res = await client.call({
+        _: 'messages.deleteHistory',
+        justClear: mode === 'clear',
+        revoke: mode === 'revoke',
+        peer,
+        maxId,
+    });
+    if (isInputPeerChannel(peer)) {
+        client.handleClientUpdate(createDummyUpdate(res.pts, res.ptsCount, peer.channelId));
+    }
+    else {
+        client.handleClientUpdate(createDummyUpdate(res.pts, res.ptsCount));
+    }
+}
+//# sourceMappingURL=delete-history.js.map

package/esm/highlevel/methods/chats/delete-history.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete-history.js","sourceRoot":"","sources":["../../../../../src/highlevel/methods/chats/delete-history.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAA;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAA;AAEtD;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAC/B,MAAuB,EACvB,IAAmB,EACnB,MAmBC;IAED,MAAM,EAAE,IAAI,GAAG,QAAQ,EAAE,KAAK,GAAG,CAAC,EAAE,GAAG,MAAM,IAAI,EAAE,CAAA;IAEnD,MAAM,IAAI,GAAG,MAAM,WAAW,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;IAE5C,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC;QAC1B,CAAC,EAAE,wBAAwB;QAC3B,SAAS,EAAE,IAAI,KAAK,OAAO;QAC3B,MAAM,EAAE,IAAI,KAAK,QAAQ;QACzB,IAAI;QACJ,KAAK;KACR,CAAC,CAAA;IAEF,IAAI,kBAAkB,CAAC,IAAI,CAAC,EAAE;QAC1B,MAAM,CAAC,kBAAkB,CAAC,iBAAiB,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,CAAA;KACtF;SAAM;QACH,MAAM,CAAC,kBAAkB,CAAC,iBAAiB,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAA;KACtE;AACL,CAAC","sourcesContent":["import { ITelegramClient } from '../../client.types.js'\nimport { InputPeerLike } from '../../types/index.js'\nimport { createDummyUpdate } from '../../updates/utils.js'\nimport { isInputPeerChannel } from '../../utils/peer-utils.js'\nimport { resolvePeer } from '../users/resolve-peer.js'\n\n/**\n * Delete communication history (for private chats and legacy groups)\n */\nexport async function deleteHistory(\n    client: ITelegramClient,\n    chat: InputPeerLike,\n    params?: {\n        /**\n         * Deletion mode. Can be:\n         * - `delete`: delete messages (only for yourself)\n         * - `clear`: delete messages (only for yourself)\n         * - `revoke`: delete messages for all users\n         * - I'm not sure what's the difference between `delete` and `clear`,\n         * but they are in fact different flags in TL object.\n         *\n         * @default  'delete'\n         */\n        mode: 'delete' | 'clear' | 'revoke'\n\n        /**\n         * Maximum ID of message to delete.\n         *\n         * @default  0, i.e. remove all messages\n         */\n        maxId?: number\n    },\n): Promise<void> {\n    const { mode = 'delete', maxId = 0 } = params ?? {}\n\n    const peer = await resolvePeer(client, chat)\n\n    const res = await client.call({\n        _: 'messages.deleteHistory',\n        justClear: mode === 'clear',\n        revoke: mode === 'revoke',\n        peer,\n        maxId,\n    })\n\n    if (isInputPeerChannel(peer)) {\n        client.handleClientUpdate(createDummyUpdate(res.pts, res.ptsCount, peer.channelId))\n    } else {\n        client.handleClientUpdate(createDummyUpdate(res.pts, res.ptsCount))\n    }\n}\n"]}

package/esm/highlevel/methods/chats/delete-user-history.d.ts

@@ -0,0 +1,11 @@
+import { ITelegramClient } from '../../client.types.js';
+import { InputPeerLike } from '../../types/index.js';
+/**
+ * Delete all messages of a user (or channel) in a supergroup
+ */
+export declare function deleteUserHistory(client: ITelegramClient, params: {
+    /** Chat ID */
+    chatId: InputPeerLike;
+    /** User/channel ID whose messages to delete */
+    participantId: InputPeerLike;
+}): Promise<void>;

package/esm/highlevel/methods/chats/delete-user-history.js

@@ -0,0 +1,17 @@
+import { createDummyUpdate } from '../../updates/utils.js';
+import { resolveChannel, resolvePeer } from '../users/resolve-peer.js';
+/**
+ * Delete all messages of a user (or channel) in a supergroup
+ */
+export async function deleteUserHistory(client, params) {
+    const { chatId, participantId } = params;
+    const channel = await resolveChannel(client, chatId);
+    const peer = await resolvePeer(client, participantId);
+    const res = await client.call({
+        _: 'channels.deleteParticipantHistory',
+        channel,
+        participant: peer,
+    });
+    client.handleClientUpdate(createDummyUpdate(res.pts, res.ptsCount, channel.channelId));
+}
+//# sourceMappingURL=delete-user-history.js.map

package/esm/highlevel/methods/chats/delete-user-history.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete-user-history.js","sourceRoot":"","sources":["../../../../../src/highlevel/methods/chats/delete-user-history.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAC1D,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAA;AAEtE;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACnC,MAAuB,EACvB,MAKC;IAED,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,CAAA;IAExC,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAEpD,MAAM,IAAI,GAAG,MAAM,WAAW,CAAC,MAAM,EAAE,aAAa,CAAC,CAAA;IAErD,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC;QAC1B,CAAC,EAAE,mCAAmC;QACtC,OAAO;QACP,WAAW,EAAE,IAAI;KACpB,CAAC,CAAA;IAEF,MAAM,CAAC,kBAAkB,CAAC,iBAAiB,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,QAAQ,EAAG,OAA8B,CAAC,SAAS,CAAC,CAAC,CAAA;AAClH,CAAC","sourcesContent":["import { tl } from '@mtcute/tl'\n\nimport { ITelegramClient } from '../../client.types.js'\nimport { InputPeerLike } from '../../types/index.js'\nimport { createDummyUpdate } from '../../updates/utils.js'\nimport { resolveChannel, resolvePeer } from '../users/resolve-peer.js'\n\n/**\n * Delete all messages of a user (or channel) in a supergroup\n */\nexport async function deleteUserHistory(\n    client: ITelegramClient,\n    params: {\n        /** Chat ID */\n        chatId: InputPeerLike\n        /** User/channel ID whose messages to delete */\n        participantId: InputPeerLike\n    },\n): Promise<void> {\n    const { chatId, participantId } = params\n\n    const channel = await resolveChannel(client, chatId)\n\n    const peer = await resolvePeer(client, participantId)\n\n    const res = await client.call({\n        _: 'channels.deleteParticipantHistory',\n        channel,\n        participant: peer,\n    })\n\n    client.handleClientUpdate(createDummyUpdate(res.pts, res.ptsCount, (channel as tl.RawInputChannel).channelId))\n}\n"]}

package/esm/highlevel/methods/chats/edit-admin-rights.d.ts

@@ -0,0 +1,16 @@
+import { tl } from '@mtcute/tl';
+import { ITelegramClient } from '../../client.types.js';
+import { InputPeerLike } from '../../types/index.js';
+/**
+ * Edit supergroup/channel admin rights of a user.
+ */
+export declare function editAdminRights(client: ITelegramClient, params: {
+    /** Chat ID */
+    chatId: InputPeerLike;
+    /** User ID */
+    userId: InputPeerLike;
+    /** New admin rights */
+    rights: Omit<tl.RawChatAdminRights, '_'>;
+    /** Custom admin rank */
+    rank?: string;
+}): Promise<void>;

package/esm/highlevel/methods/chats/edit-admin-rights.js

@@ -0,0 +1,21 @@
+import { resolveChannel, resolveUser } from '../users/resolve-peer.js';
+/**
+ * Edit supergroup/channel admin rights of a user.
+ */
+export async function editAdminRights(client, params) {
+    const { chatId, userId, rights, rank = '' } = params;
+    const chat = await resolveChannel(client, chatId);
+    const user = await resolveUser(client, userId);
+    const res = await client.call({
+        _: 'channels.editAdmin',
+        channel: chat,
+        userId: user,
+        adminRights: {
+            _: 'chatAdminRights',
+            ...rights,
+        },
+        rank,
+    });
+    client.handleClientUpdate(res);
+}
+//# sourceMappingURL=edit-admin-rights.js.map

package/esm/highlevel/methods/chats/edit-admin-rights.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"edit-admin-rights.js","sourceRoot":"","sources":["../../../../../src/highlevel/methods/chats/edit-admin-rights.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAA;AAEtE;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACjC,MAAuB,EACvB,MASC;IAED,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,GAAG,EAAE,EAAE,GAAG,MAAM,CAAA;IAEpD,MAAM,IAAI,GAAG,MAAM,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACjD,MAAM,IAAI,GAAG,MAAM,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAE9C,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC;QAC1B,CAAC,EAAE,oBAAoB;QACvB,OAAO,EAAE,IAAI;QACb,MAAM,EAAE,IAAI;QACZ,WAAW,EAAE;YACT,CAAC,EAAE,iBAAiB;YACpB,GAAG,MAAM;SACZ;QACD,IAAI;KACP,CAAC,CAAA;IAEF,MAAM,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAA;AAClC,CAAC","sourcesContent":["import { tl } from '@mtcute/tl'\n\nimport { ITelegramClient } from '../../client.types.js'\nimport { InputPeerLike } from '../../types/index.js'\nimport { resolveChannel, resolveUser } from '../users/resolve-peer.js'\n\n/**\n * Edit supergroup/channel admin rights of a user.\n */\nexport async function editAdminRights(\n    client: ITelegramClient,\n    params: {\n        /** Chat ID */\n        chatId: InputPeerLike\n        /** User ID */\n        userId: InputPeerLike\n        /** New admin rights */\n        rights: Omit<tl.RawChatAdminRights, '_'>\n        /** Custom admin rank */\n        rank?: string\n    },\n): Promise<void> {\n    const { chatId, userId, rights, rank = '' } = params\n\n    const chat = await resolveChannel(client, chatId)\n    const user = await resolveUser(client, userId)\n\n    const res = await client.call({\n        _: 'channels.editAdmin',\n        channel: chat,\n        userId: user,\n        adminRights: {\n            _: 'chatAdminRights',\n            ...rights,\n        },\n        rank,\n    })\n\n    client.handleClientUpdate(res)\n}\n"]}

package/esm/highlevel/methods/chats/get-chat-event-log.d.ts

@@ -0,0 +1,61 @@
+import { tl } from '@mtcute/tl';
+import { ITelegramClient } from '../../client.types.js';
+import { ChatEvent, InputPeerLike } from '../../types/index.js';
+import { InputChatEventFilters } from '../../types/peers/chat-event/filters.js';
+/**
+ * Get chat event log ("Recent actions" in official clients).
+ *
+ * Only available for supergroups and channels, and
+ * requires (any) administrator rights.
+ *
+ * Results are returned in reverse chronological
+ * order (i.e. newest first) and event IDs are
+ * in direct chronological order (i.e. newer
+ * events have bigger event ID)
+ *
+ * @param params
+ */
+export declare function getChatEventLog(client: ITelegramClient, chatId: InputPeerLike, params?: {
+    /**
+     * Search query
+     */
+    query?: string;
+    /**
+     * Minimum event ID to return
+     */
+    minId?: tl.Long;
+    /**
+     * Maximum event ID to return,
+     * can be used as a base offset
+     */
+    maxId?: tl.Long;
+    /**
+     * List of users whose actions to return
+     */
+    users?: InputPeerLike[];
+    /**
+     * Event filters. Can be a TL object, or one or more
+     * action types.
+     *
+     * Note that some filters are grouped in TL
+     * (i.e. `info=true` will return `title_changed`,
+     * `username_changed` and many more),
+     * and when passing one or more action types,
+     * they will be filtered locally.
+     */
+    filters?: InputChatEventFilters;
+    /**
+     * Limit the number of events returned.
+     *
+     * > Note: when using filters, there will likely be
+     * > less events returned than specified here.
+     * > This limit is only used to limit the number of
+     * > events to fetch from the server.
+     * >
+     * > If you need to limit the number of events
+     * > returned, use {@link iterChatEventLog} instead.
+     *
+     * @default  100
+     */
+    limit?: number;
+}): Promise<ChatEvent[]>;

package/esm/highlevel/methods/chats/get-chat-event-log.js

@@ -0,0 +1,48 @@
+import Long from 'long';
+import { ChatEvent, PeersIndex } from '../../types/index.js';
+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';
+/**
+ * Get chat event log ("Recent actions" in official clients).
+ *
+ * Only available for supergroups and channels, and
+ * requires (any) administrator rights.
+ *
+ * Results are returned in reverse chronological
+ * order (i.e. newest first) and event IDs are
+ * in direct chronological order (i.e. newer
+ * events have bigger event ID)
+ *
+ * @param params
+ */
+export async function getChatEventLog(client, chatId, params) {
+    const { maxId = Long.ZERO, minId = Long.ZERO, query = '', limit = 100, users, filters } = params ?? {};
+    const channel = await resolveChannel(client, chatId);
+    const admins = users ? await resolvePeerMany(client, users, toInputUser) : undefined;
+    const { serverFilter, localFilter } = normalizeChatEventFilters(filters);
+    const res = await client.call({
+        _: 'channels.getAdminLog',
+        channel,
+        q: query,
+        eventsFilter: serverFilter,
+        admins,
+        maxId,
+        minId,
+        limit,
+    });
+    if (!res.events.length)
+        return [];
+    const peers = PeersIndex.from(res);
+    const results = [];
+    for (const evt of res.events) {
+        const parsed = new ChatEvent(evt, peers);
+        if (localFilter && (!parsed.action || !localFilter[parsed.action.type])) {
+            continue;
+        }
+        results.push(parsed);
+    }
+    return results;
+}
+//# sourceMappingURL=get-chat-event-log.js.map

package/esm/highlevel/methods/chats/get-chat-event-log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-chat-event-log.js","sourceRoot":"","sources":["../../../../../src/highlevel/methods/chats/get-chat-event-log.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAA;AAKvB,OAAO,EAAE,SAAS,EAAiB,UAAU,EAAE,MAAM,sBAAsB,CAAA;AAC3E,OAAO,EAAyB,yBAAyB,EAAE,MAAM,yCAAyC,CAAA;AAC1G,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAA;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAA;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAA;AAE/D;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACjC,MAAuB,EACvB,MAAqB,EACrB,MAgDC;IAED,MAAM,EAAE,KAAK,GAAG,IAAI,CAAC,IAAI,EAAE,KAAK,GAAG,IAAI,CAAC,IAAI,EAAE,KAAK,GAAG,EAAE,EAAE,KAAK,GAAG,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,MAAM,IAAI,EAAE,CAAA;IAEtG,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAEpD,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,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC;QAC1B,CAAC,EAAE,sBAAsB;QACzB,OAAO;QACP,CAAC,EAAE,KAAK;QACR,YAAY,EAAE,YAAY;QAC1B,MAAM;QACN,KAAK;QACL,KAAK;QACL,KAAK;KACR,CAAC,CAAA;IAEF,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM;QAAE,OAAO,EAAE,CAAA;IAEjC,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IAElC,MAAM,OAAO,GAAgB,EAAE,CAAA;IAE/B,KAAK,MAAM,GAAG,IAAI,GAAG,CAAC,MAAM,EAAE;QAC1B,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;QAExC,IAAI,WAAW,IAAI,CAAC,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE;YACrE,SAAQ;SACX;QAED,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;KACvB;IAED,OAAO,OAAO,CAAA;AAClB,CAAC","sourcesContent":["import Long from 'long'\n\nimport { tl } from '@mtcute/tl'\n\nimport { ITelegramClient } from '../../client.types.js'\nimport { ChatEvent, InputPeerLike, PeersIndex } from '../../types/index.js'\nimport { InputChatEventFilters, 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'\n\n/**\n * Get chat event log (\"Recent actions\" in official clients).\n *\n * Only available for supergroups and channels, and\n * requires (any) administrator rights.\n *\n * Results are returned in reverse chronological\n * order (i.e. newest first) and event IDs are\n * in direct chronological order (i.e. newer\n * events have bigger event ID)\n *\n * @param params\n */\nexport async function getChatEventLog(\n    client: ITelegramClient,\n    chatId: InputPeerLike,\n    params?: {\n        /**\n         * Search query\n         */\n        query?: string\n\n        /**\n         * Minimum event ID to return\n         */\n        minId?: tl.Long\n\n        /**\n         * Maximum event ID to return,\n         * can be used as a base offset\n         */\n        maxId?: tl.Long\n\n        /**\n         * List of users whose actions to return\n         */\n        users?: InputPeerLike[]\n\n        /**\n         * Event filters. Can be a TL object, or one or more\n         * action types.\n         *\n         * Note that some filters are grouped in TL\n         * (i.e. `info=true` will return `title_changed`,\n         * `username_changed` and many more),\n         * and when passing one or more action types,\n         * they will be filtered locally.\n         */\n        filters?: InputChatEventFilters\n\n        /**\n         * Limit the number of events returned.\n         *\n         * > Note: when using filters, there will likely be\n         * > less events returned than specified here.\n         * > This limit is only used to limit the number of\n         * > events to fetch from the server.\n         * >\n         * > If you need to limit the number of events\n         * > returned, use {@link iterChatEventLog} instead.\n         *\n         * @default  100\n         */\n        limit?: number\n    },\n): Promise<ChatEvent[]> {\n    const { maxId = Long.ZERO, minId = Long.ZERO, query = '', limit = 100, users, filters } = params ?? {}\n\n    const channel = await resolveChannel(client, chatId)\n\n    const admins: tl.TypeInputUser[] | undefined = users ? await resolvePeerMany(client, users, toInputUser) : undefined\n\n    const { serverFilter, localFilter } = normalizeChatEventFilters(filters)\n\n    const res = await client.call({\n        _: 'channels.getAdminLog',\n        channel,\n        q: query,\n        eventsFilter: serverFilter,\n        admins,\n        maxId,\n        minId,\n        limit,\n    })\n\n    if (!res.events.length) return []\n\n    const peers = PeersIndex.from(res)\n\n    const results: ChatEvent[] = []\n\n    for (const evt of res.events) {\n        const parsed = new ChatEvent(evt, peers)\n\n        if (localFilter && (!parsed.action || !localFilter[parsed.action.type])) {\n            continue\n        }\n\n        results.push(parsed)\n    }\n\n    return results\n}\n"]}

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

@@ -0,0 +1,15 @@
+import { ITelegramClient } from '../../client.types.js';
+import { ChatMember, InputPeerLike } from '../../types/index.js';
+/**
+ * Get information about a single chat member
+ *
+ * @param chatId  Chat ID or username
+ * @param userId  User ID, username, phone number, `"me"` or `"self"`
+ * @returns  Chat member, or `null` if user is not a member of the chat
+ */
+export declare function getChatMember(client: ITelegramClient, params: {
+    /** Chat ID or username */
+    chatId: InputPeerLike;
+    /** User ID, username, phone number, `"me"` or `"self"` */
+    userId: InputPeerLike;
+}): Promise<ChatMember | null>;

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

@@ -0,0 +1,56 @@
+import { tl } from '@mtcute/tl';
+import { assertTypeIs } from '../../../utils/type-assertions.js';
+import { ChatMember, MtInvalidPeerTypeError, PeersIndex } from '../../types/index.js';
+import { isInputPeerChannel, isInputPeerChat, isInputPeerUser, toInputChannel } from '../../utils/peer-utils.js';
+import { resolvePeer } from '../users/resolve-peer.js';
+/**
+ * Get information about a single chat member
+ *
+ * @param chatId  Chat ID or username
+ * @param userId  User ID, username, phone number, `"me"` or `"self"`
+ * @returns  Chat member, or `null` if user is not a member of the chat
+ */
+export async function getChatMember(client, params) {
+    const { chatId, userId } = params;
+    const user = await resolvePeer(client, userId);
+    const chat = await resolvePeer(client, chatId);
+    if (isInputPeerChat(chat)) {
+        if (!isInputPeerUser(user)) {
+            throw new MtInvalidPeerTypeError(userId, 'user');
+        }
+        const res = await client.call({
+            _: 'messages.getFullChat',
+            chatId: chat.chatId,
+        });
+        assertTypeIs('getChatMember (@ messages.getFullChat)', res.fullChat, 'chatFull');
+        const members = res.fullChat.participants._ === 'chatParticipantsForbidden' ? [] : res.fullChat.participants.participants;
+        const peers = PeersIndex.from(res);
+        for (const m of members) {
+            if ((user._ === 'inputPeerSelf' && peers.user(m.userId).self) ||
+                (user._ === 'inputPeerUser' && m.userId === user.userId)) {
+                return new ChatMember(m, peers);
+            }
+        }
+        return null;
+    }
+    else if (isInputPeerChannel(chat)) {
+        try {
+            const res = await client.call({
+                _: 'channels.getParticipant',
+                channel: toInputChannel(chat),
+                participant: user,
+            });
+            const peers = PeersIndex.from(res);
+            return new ChatMember(res.participant, peers);
+        }
+        catch (e) {
+            if (tl.RpcError.is(e, 'USER_NOT_PARTICIPANT')) {
+                return null;
+            }
+            throw e;
+        }
+    }
+    else
+        throw new MtInvalidPeerTypeError(chatId, 'chat or channel');
+}
+//# sourceMappingURL=get-chat-member.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get-chat-member.js","sourceRoot":"","sources":["../../../../../src/highlevel/methods/chats/get-chat-member.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,YAAY,CAAA;AAE/B,OAAO,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAA;AAEhE,OAAO,EAAE,UAAU,EAAiB,sBAAsB,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AACpG,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAA;AAChH,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAA;AAEtD;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAC/B,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,IAAI,eAAe,CAAC,IAAI,CAAC,EAAE;QACvB,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,EAAE;YACxB,MAAM,IAAI,sBAAsB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;SACnD;QAED,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC;YAC1B,CAAC,EAAE,sBAAsB;YACzB,MAAM,EAAE,IAAI,CAAC,MAAM;SACtB,CAAC,CAAA;QAEF,YAAY,CAAC,wCAAwC,EAAE,GAAG,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAA;QAEhF,MAAM,OAAO,GACT,GAAG,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,KAAK,2BAA2B,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,YAAY,CAAC,YAAY,CAAA;QAE7G,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QAElC,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE;YACrB,IACI,CAAC,IAAI,CAAC,CAAC,KAAK,eAAe,IAAK,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAgB,CAAC,IAAI,CAAC;gBACzE,CAAC,IAAI,CAAC,CAAC,KAAK,eAAe,IAAI,CAAC,CAAC,MAAM,KAAK,IAAI,CAAC,MAAM,CAAC,EAC1D;gBACE,OAAO,IAAI,UAAU,CAAC,CAAC,EAAE,KAAK,CAAC,CAAA;aAClC;SACJ;QAED,OAAO,IAAI,CAAA;KACd;SAAM,IAAI,kBAAkB,CAAC,IAAI,CAAC,EAAE;QACjC,IAAI;YACA,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC;gBAC1B,CAAC,EAAE,yBAAyB;gBAC5B,OAAO,EAAE,cAAc,CAAC,IAAI,CAAC;gBAC7B,WAAW,EAAE,IAAI;aACpB,CAAC,CAAA;YAEF,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;YAElC,OAAO,IAAI,UAAU,CAAC,GAAG,CAAC,WAAW,EAAE,KAAK,CAAC,CAAA;SAChD;QAAC,OAAO,CAAC,EAAE;YACR,IAAI,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,EAAE,sBAAsB,CAAC,EAAE;gBAC3C,OAAO,IAAI,CAAA;aACd;YAED,MAAM,CAAC,CAAA;SACV;KACJ;;QAAM,MAAM,IAAI,sBAAsB,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAA;AACtE,CAAC","sourcesContent":["import { tl } from '@mtcute/tl'\n\nimport { assertTypeIs } from '../../../utils/type-assertions.js'\nimport { ITelegramClient } from '../../client.types.js'\nimport { ChatMember, InputPeerLike, MtInvalidPeerTypeError, PeersIndex } from '../../types/index.js'\nimport { isInputPeerChannel, isInputPeerChat, isInputPeerUser, toInputChannel } from '../../utils/peer-utils.js'\nimport { resolvePeer } from '../users/resolve-peer.js'\n\n/**\n * Get information about a single chat member\n *\n * @param chatId  Chat ID or username\n * @param userId  User ID, username, phone number, `\"me\"` or `\"self\"`\n * @returns  Chat member, or `null` if user is not a member of the chat\n */\nexport async function getChatMember(\n    client: ITelegramClient,\n    params: {\n        /** Chat ID or username */\n        chatId: InputPeerLike\n        /** User ID, username, phone number, `\"me\"` or `\"self\"` */\n        userId: InputPeerLike\n    },\n): Promise<ChatMember | null> {\n    const { chatId, userId } = params\n\n    const user = await resolvePeer(client, userId)\n    const chat = await resolvePeer(client, chatId)\n\n    if (isInputPeerChat(chat)) {\n        if (!isInputPeerUser(user)) {\n            throw new MtInvalidPeerTypeError(userId, 'user')\n        }\n\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        const members =\n            res.fullChat.participants._ === 'chatParticipantsForbidden' ? [] : res.fullChat.participants.participants\n\n        const peers = PeersIndex.from(res)\n\n        for (const m of members) {\n            if (\n                (user._ === 'inputPeerSelf' && (peers.user(m.userId) as tl.RawUser).self) ||\n                (user._ === 'inputPeerUser' && m.userId === user.userId)\n            ) {\n                return new ChatMember(m, peers)\n            }\n        }\n\n        return null\n    } else if (isInputPeerChannel(chat)) {\n        try {\n            const res = await client.call({\n                _: 'channels.getParticipant',\n                channel: toInputChannel(chat),\n                participant: user,\n            })\n\n            const peers = PeersIndex.from(res)\n\n            return new ChatMember(res.participant, peers)\n        } catch (e) {\n            if (tl.RpcError.is(e, 'USER_NOT_PARTICIPANT')) {\n                return null\n            }\n\n            throw e\n        }\n    } else throw new MtInvalidPeerTypeError(chatId, 'chat or channel')\n}\n"]}

package/esm/highlevel/methods/chats/get-chat-members.d.ts

@@ -0,0 +1,51 @@
+import { ITelegramClient } from '../../client.types.js';
+import { ArrayWithTotal, ChatMember, InputPeerLike } from '../../types/index.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
+ */
+export declare function getChatMembers(client: ITelegramClient, chatId: InputPeerLike, params?: {
+    /**
+     * Search query to filter members by their display names and usernames
+     *
+     * > **Note**: Only used for these values of `filter`:
+     * > `all, banned, restricted, mention, contacts`
+     *
+     * @default  `''` (empty string)
+     */
+    query?: string;
+    /**
+     * Sequential number of the first member to be returned.
+     */
+    offset?: number;
+    /**
+     * Maximum number of members to be retrieved.
+     *
+     * > **Note**: Telegram currently only allows you to ever retrieve at most
+     * > 200 members, regardless of offset/limit. I.e. when passing
+     * > `offset=201` nothing will ever be returned.
+     *
+     * @default  200
+     */
+    limit?: number;
+    /**
+     * Type of the query. Can be:
+     *  - `all`: get all members
+     *  - `banned`: get only banned members
+     *  - `restricted`: get only restricted members
+     *  - `bots`: get only bots
+     *  - `recent`: get recent members
+     *  - `admins`: get only administrators (and creator)
+     *  - `contacts`: get only contacts
+     *  - `mention`: get users that can be mentioned (see {@link tl.RawChannelParticipantsMentions})
+     *
+     *  Only used for channels and supergroups.
+     *
+     * @default  `recent`
+     */
+    type?: 'all' | 'banned' | 'restricted' | 'bots' | 'recent' | 'admins' | 'contacts' | 'mention';
+}): Promise<ArrayWithTotal<ChatMember>>;

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

@@ -0,0 +1,80 @@
+import Long from 'long';
+import { assertNever } from '../../../types/utils.js';
+import { assertTypeIs } from '../../../utils/type-assertions.js';
+import { ChatMember, MtInvalidPeerTypeError, PeersIndex } from '../../types/index.js';
+import { makeArrayWithTotal } from '../../utils/index.js';
+import { isInputPeerChannel, isInputPeerChat, toInputChannel } from '../../utils/peer-utils.js';
+import { resolvePeer } from '../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
+ */
+export async function getChatMembers(client, chatId, params) {
+    const { query = '', offset = 0, limit = 200, type = 'recent' } = params ?? {};
+    const chat = await resolvePeer(client, chatId);
+    if (isInputPeerChat(chat)) {
+        const res = await client.call({
+            _: 'messages.getFullChat',
+            chatId: chat.chatId,
+        });
+        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 = PeersIndex.from(res);
+        const ret = members.map((m) => new ChatMember(m, peers));
+        return makeArrayWithTotal(ret, ret.length);
+    }
+    if (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:
+                assertNever(type);
+        }
+        const res = await client.call({
+            _: 'channels.getParticipants',
+            channel: toInputChannel(chat),
+            filter,
+            offset,
+            limit,
+            hash: Long.ZERO,
+        });
+        assertTypeIs('getChatMembers (@ channels.getParticipants)', res, 'channels.channelParticipants');
+        const peers = PeersIndex.from(res);
+        const ret = res.participants.map((i) => new ChatMember(i, peers));
+        return makeArrayWithTotal(ret, res.count);
+    }
+    throw new MtInvalidPeerTypeError(chatId, 'chat or channel');
+}
+//# sourceMappingURL=get-chat-members.js.map

package/esm/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/esm/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/esm/highlevel/methods/chats/get-chat-preview.js

@@ -0,0 +1,26 @@
+import { MtArgumentError } from '../../../types/errors.js';
+import { ChatPreview, MtPeerNotFoundError } from '../../types/index.js';
+import { INVITE_LINK_REGEX } from '../../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.
+ */
+export async function getChatPreview(client, inviteLink) {
+    const m = inviteLink.match(INVITE_LINK_REGEX);
+    if (!m)
+        throw new MtArgumentError('Invalid invite link');
+    const res = await client.call({
+        _: 'messages.checkChatInvite',
+        hash: m[1],
+    });
+    if (res._ !== 'chatInvite') {
+        throw new MtPeerNotFoundError('You have already joined this chat!');
+    }
+    return new ChatPreview(res, inviteLink);
+}
+//# sourceMappingURL=get-chat-preview.js.map

package/esm/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,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAA;AAE1D,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAA;AACvE,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAA;AAE7D;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,MAAuB,EAAE,UAAkB;IAC5E,MAAM,CAAC,GAAG,UAAU,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAA;IAC7C,IAAI,CAAC,CAAC;QAAE,MAAM,IAAI,eAAe,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,mBAAmB,CAAC,oCAAoC,CAAC,CAAA;KACtE;IAED,OAAO,IAAI,WAAW,CAAC,GAAG,EAAE,UAAU,CAAC,CAAA;AAC3C,CAAC","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/esm/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/esm/highlevel/methods/chats/get-chat.js

@@ -0,0 +1,35 @@
+import { MtArgumentError } from '../../../types/errors.js';
+import { Chat, MtPeerNotFoundError } from '../../types/index.js';
+import { INVITE_LINK_REGEX } from '../../utils/peer-utils.js';
+import { resolvePeer } from '../users/resolve-peer.js';
+import { _getRawPeerBatched } from './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.
+ */
+export async function getChat(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)}`);
+            }
+            return new Chat(res.chat);
+        }
+    }
+    const peer = await resolvePeer(client, chatId);
+    const res = await _getRawPeerBatched(client, peer);
+    if (!res)
+        throw new MtPeerNotFoundError(`Chat ${JSON.stringify(chatId)} was not found`);
+    return new Chat(res);
+}
+//# sourceMappingURL=get-chat.js.map