@mtcute/core 0.6.0 → 0.7.0

package/esm/highlevel/methods/users/get-common-chats.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-common-chats.js","sourceRoot":"","sources":["../../../../../src/highlevel/methods/users/get-common-chats.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAiB,MAAM,sBAAsB,CAAA;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAE/C;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,MAAuB,EAAE,MAAqB;IAC/E,OAAO,MAAM;SACR,IAAI,CAAC;QACF,CAAC,EAAE,yBAAyB;QAC5B,MAAM,EAAE,MAAM,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC;QACzC,KAAK,EAAE,CAAC;QACR,KAAK,EAAE,GAAG;KACb,CAAC;SACD,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;AAC3D,CAAC","sourcesContent":["import { ITelegramClient } from '../../client.types.js'\nimport { Chat, InputPeerLike } from '../../types/index.js'\nimport { resolveUser } from './resolve-peer.js'\n\n/**\n * Get a list of common chats you have with a given user\n *\n * @param userId  User's ID, username or phone number\n * @throws MtInvalidPeerTypeError\n */\nexport async function getCommonChats(client: ITelegramClient, userId: InputPeerLike): Promise<Chat[]> {\n    return client\n        .call({\n            _: 'messages.getCommonChats',\n            userId: await resolveUser(client, userId),\n            maxId: 0,\n            limit: 100,\n        })\n        .then((res) => res.chats.map((it) => new Chat(it)))\n}\n"]}

package/esm/highlevel/methods/users/get-global-ttl.d.ts

@@ -0,0 +1,5 @@
+import { ITelegramClient } from '../../client.types.js';
+/**
+ * Gets the current default value of the Time-To-Live setting, applied to all new chats.
+ */
+export declare function getGlobalTtl(client: ITelegramClient): Promise<number>;

package/esm/highlevel/methods/users/get-global-ttl.js

@@ -0,0 +1,11 @@
+/**
+ * Gets the current default value of the Time-To-Live setting, applied to all new chats.
+ */
+export async function getGlobalTtl(client) {
+    return client
+        .call({
+        _: 'messages.getDefaultHistoryTTL',
+    })
+        .then((r) => r.period);
+}
+//# sourceMappingURL=get-global-ttl.js.map

package/esm/highlevel/methods/users/get-global-ttl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-global-ttl.js","sourceRoot":"","sources":["../../../../../src/highlevel/methods/users/get-global-ttl.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,MAAuB;IACtD,OAAO,MAAM;SACR,IAAI,CAAC;QACF,CAAC,EAAE,+BAA+B;KACrC,CAAC;SACD,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAA;AAC9B,CAAC","sourcesContent":["import { ITelegramClient } from '../../client.types.js'\n\n/**\n * Gets the current default value of the Time-To-Live setting, applied to all new chats.\n */\nexport async function getGlobalTtl(client: ITelegramClient): Promise<number> {\n    return client\n        .call({\n            _: 'messages.getDefaultHistoryTTL',\n        })\n        .then((r) => r.period)\n}\n"]}

package/esm/highlevel/methods/users/get-me.d.ts

@@ -0,0 +1,6 @@
+import { ITelegramClient } from '../../client.types.js';
+import { User } from '../../types/index.js';
+/**
+ * Get currently authorized user's full information
+ */
+export declare function getMe(client: ITelegramClient): Promise<User>;

package/esm/highlevel/methods/users/get-me.js

@@ -0,0 +1,22 @@
+import { assertTypeIs } from '../../../utils/type-assertions.js';
+import { User } from '../../types/index.js';
+/**
+ * Get currently authorized user's full information
+ */
+export function getMe(client) {
+    return client
+        .call({
+        _: 'users.getUsers',
+        id: [
+            {
+                _: 'inputUserSelf',
+            },
+        ],
+    })
+        .then(async ([user]) => {
+        assertTypeIs('getMe (@ users.getUsers)', user, 'user');
+        await client.storage.self.storeFrom(user);
+        return new User(user);
+    });
+}
+//# sourceMappingURL=get-me.js.map

package/esm/highlevel/methods/users/get-me.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-me.js","sourceRoot":"","sources":["../../../../../src/highlevel/methods/users/get-me.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAA;AAEhE,OAAO,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAA;AAE3C;;GAEG;AACH,MAAM,UAAU,KAAK,CAAC,MAAuB;IACzC,OAAO,MAAM;SACR,IAAI,CAAC;QACF,CAAC,EAAE,gBAAgB;QACnB,EAAE,EAAE;YACA;gBACI,CAAC,EAAE,eAAe;aACrB;SACJ;KACJ,CAAC;SACD,IAAI,CAAC,KAAK,EAAE,CAAC,IAAI,CAAC,EAAE,EAAE;QACnB,YAAY,CAAC,0BAA0B,EAAE,IAAI,EAAE,MAAM,CAAC,CAAA;QAEtD,MAAM,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAA;QAEzC,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,CAAA;IACzB,CAAC,CAAC,CAAA;AACV,CAAC","sourcesContent":["import { assertTypeIs } from '../../../utils/type-assertions.js'\nimport { ITelegramClient } from '../../client.types.js'\nimport { User } from '../../types/index.js'\n\n/**\n * Get currently authorized user's full information\n */\nexport function getMe(client: ITelegramClient): Promise<User> {\n    return client\n        .call({\n            _: 'users.getUsers',\n            id: [\n                {\n                    _: 'inputUserSelf',\n                },\n            ],\n        })\n        .then(async ([user]) => {\n            assertTypeIs('getMe (@ users.getUsers)', user, 'user')\n\n            await client.storage.self.storeFrom(user)\n\n            return new User(user)\n        })\n}\n"]}

package/esm/highlevel/methods/users/get-my-username.d.ts

@@ -0,0 +1,8 @@
+import { ITelegramClient } from '../../client.types.js';
+/**
+ * Get currently authorized user's username.
+ *
+ * This method uses locally available information and
+ * does not call any API methods.
+ */
+export declare function getMyUsername(client: ITelegramClient): Promise<string | null>;

package/esm/highlevel/methods/users/get-my-username.js

@@ -0,0 +1,10 @@
+/**
+ * Get currently authorized user's username.
+ *
+ * This method uses locally available information and
+ * does not call any API methods.
+ */
+export async function getMyUsername(client) {
+    return client.storage.self.fetch().then((self) => self?.usernames[0] ?? null);
+}
+//# sourceMappingURL=get-my-username.js.map

package/esm/highlevel/methods/users/get-my-username.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-my-username.js","sourceRoot":"","sources":["../../../../../src/highlevel/methods/users/get-my-username.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,MAAuB;IACvD,OAAO,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAA;AACjF,CAAC","sourcesContent":["import { ITelegramClient } from '../../client.types.js'\n\n/**\n * Get currently authorized user's username.\n *\n * This method uses locally available information and\n * does not call any API methods.\n */\nexport async function getMyUsername(client: ITelegramClient): Promise<string | null> {\n    return client.storage.self.fetch().then((self) => self?.usernames[0] ?? null)\n}\n"]}

package/esm/highlevel/methods/users/get-profile-photo.d.ts

@@ -0,0 +1,11 @@
+import { tl } from '@mtcute/tl';
+import { ITelegramClient } from '../../client.types.js';
+import { InputPeerLike, Photo } from '../../types/index.js';
+/**
+ * Get a single profile picture of a user by its ID
+ *
+ * @param userId  User ID, username, phone number, `"me"` or `"self"`
+ * @param photoId  ID of the photo to fetch
+ * @param params
+ */
+export declare function getProfilePhoto(client: ITelegramClient, userId: InputPeerLike, photoId: tl.Long): Promise<Photo>;

package/esm/highlevel/methods/users/get-profile-photo.js

@@ -0,0 +1,23 @@
+import { assertTypeIs } from '../../../utils/type-assertions.js';
+import { Photo } from '../../types/index.js';
+import { resolveUser } from './resolve-peer.js';
+/**
+ * Get a single profile picture of a user by its ID
+ *
+ * @param userId  User ID, username, phone number, `"me"` or `"self"`
+ * @param photoId  ID of the photo to fetch
+ * @param params
+ */
+export async function getProfilePhoto(client, userId, photoId) {
+    const res = await client.call({
+        _: 'photos.getUserPhotos',
+        userId: await resolveUser(client, userId),
+        offset: -1,
+        limit: 1,
+        maxId: photoId,
+    });
+    const photo = res.photos[0];
+    assertTypeIs('getProfilePhotos', photo, 'photo');
+    return new Photo(photo);
+}
+//# sourceMappingURL=get-profile-photo.js.map

package/esm/highlevel/methods/users/get-profile-photo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-profile-photo.js","sourceRoot":"","sources":["../../../../../src/highlevel/methods/users/get-profile-photo.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAA;AAEhE,OAAO,EAAiB,KAAK,EAAE,MAAM,sBAAsB,CAAA;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAE/C;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACjC,MAAuB,EACvB,MAAqB,EACrB,OAAgB;IAEhB,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC;QAC1B,CAAC,EAAE,sBAAsB;QACzB,MAAM,EAAE,MAAM,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC;QACzC,MAAM,EAAE,CAAC,CAAC;QACV,KAAK,EAAE,CAAC;QACR,KAAK,EAAE,OAAO;KACjB,CAAC,CAAA;IAEF,MAAM,KAAK,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAA;IAC3B,YAAY,CAAC,kBAAkB,EAAE,KAAK,EAAE,OAAO,CAAC,CAAA;IAEhD,OAAO,IAAI,KAAK,CAAC,KAAK,CAAC,CAAA;AAC3B,CAAC","sourcesContent":["import { tl } from '@mtcute/tl'\n\nimport { assertTypeIs } from '../../../utils/type-assertions.js'\nimport { ITelegramClient } from '../../client.types.js'\nimport { InputPeerLike, Photo } from '../../types/index.js'\nimport { resolveUser } from './resolve-peer.js'\n\n/**\n * Get a single profile picture of a user by its ID\n *\n * @param userId  User ID, username, phone number, `\"me\"` or `\"self\"`\n * @param photoId  ID of the photo to fetch\n * @param params\n */\nexport async function getProfilePhoto(\n    client: ITelegramClient,\n    userId: InputPeerLike,\n    photoId: tl.Long,\n): Promise<Photo> {\n    const res = await client.call({\n        _: 'photos.getUserPhotos',\n        userId: await resolveUser(client, userId),\n        offset: -1,\n        limit: 1,\n        maxId: photoId,\n    })\n\n    const photo = res.photos[0]\n    assertTypeIs('getProfilePhotos', photo, 'photo')\n\n    return new Photo(photo)\n}\n"]}

package/esm/highlevel/methods/users/get-profile-photos.d.ts

@@ -0,0 +1,22 @@
+import { ITelegramClient } from '../../client.types.js';
+import { ArrayPaginated, InputPeerLike, Photo } from '../../types/index.js';
+/**
+ * Get a list of profile pictures of a user
+ *
+ * @param userId  User ID, username, phone number, `"me"` or `"self"`
+ * @param params
+ */
+export declare function getProfilePhotos(client: ITelegramClient, userId: InputPeerLike, params?: {
+    /**
+     * Offset from which to fetch.
+     *
+     * @default  `0`
+     */
+    offset?: number;
+    /**
+     * Maximum number of items to fetch (up to 100)
+     *
+     * @default  `100`
+     */
+    limit?: number;
+}): Promise<ArrayPaginated<Photo, number>>;

package/esm/highlevel/methods/users/get-profile-photos.js

@@ -0,0 +1,28 @@
+import Long from 'long';
+import { assertTypeIs } from '../../../utils/type-assertions.js';
+import { Photo } from '../../types/index.js';
+import { makeArrayPaginated } from '../../utils/index.js';
+import { resolveUser } from './resolve-peer.js';
+/**
+ * Get a list of profile pictures of a user
+ *
+ * @param userId  User ID, username, phone number, `"me"` or `"self"`
+ * @param params
+ */
+export async function getProfilePhotos(client, userId, params) {
+    if (!params)
+        params = {};
+    const { offset = 0, limit = 100 } = params;
+    const res = await client.call({
+        _: 'photos.getUserPhotos',
+        userId: await resolveUser(client, userId),
+        offset,
+        limit,
+        maxId: Long.ZERO,
+    });
+    return makeArrayPaginated(res.photos.map((it) => {
+        assertTypeIs('getProfilePhotos', it, 'photo');
+        return new Photo(it);
+    }), res.count ?? res.photos.length, offset + res.photos.length);
+}
+//# sourceMappingURL=get-profile-photos.js.map

package/esm/highlevel/methods/users/get-profile-photos.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-profile-photos.js","sourceRoot":"","sources":["../../../../../src/highlevel/methods/users/get-profile-photos.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAA;AAIvB,OAAO,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAA;AAEhE,OAAO,EAAiC,KAAK,EAAE,MAAM,sBAAsB,CAAA;AAC3E,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAE/C;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAClC,MAAuB,EACvB,MAAqB,EACrB,MAcC;IAED,IAAI,CAAC,MAAM;QAAE,MAAM,GAAG,EAAE,CAAA;IAExB,MAAM,EAAE,MAAM,GAAG,CAAC,EAAE,KAAK,GAAG,GAAG,EAAE,GAAG,MAAM,CAAA;IAE1C,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC;QAC1B,CAAC,EAAE,sBAAsB;QACzB,MAAM,EAAE,MAAM,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC;QACzC,MAAM;QACN,KAAK;QACL,KAAK,EAAE,IAAI,CAAC,IAAI;KACnB,CAAC,CAAA;IAEF,OAAO,kBAAkB,CACrB,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE;QAClB,YAAY,CAAC,kBAAkB,EAAE,EAAE,EAAE,OAAO,CAAC,CAAA;QAE7C,OAAO,IAAI,KAAK,CAAC,EAAE,CAAC,CAAA;IACxB,CAAC,CAAC,EACD,GAAgC,CAAC,KAAK,IAAI,GAAG,CAAC,MAAM,CAAC,MAAM,EAC5D,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,MAAM,CAC7B,CAAA;AACL,CAAC","sourcesContent":["import Long from 'long'\n\nimport { tl } from '@mtcute/tl'\n\nimport { assertTypeIs } from '../../../utils/type-assertions.js'\nimport { ITelegramClient } from '../../client.types.js'\nimport { ArrayPaginated, InputPeerLike, Photo } from '../../types/index.js'\nimport { makeArrayPaginated } from '../../utils/index.js'\nimport { resolveUser } from './resolve-peer.js'\n\n/**\n * Get a list of profile pictures of a user\n *\n * @param userId  User ID, username, phone number, `\"me\"` or `\"self\"`\n * @param params\n */\nexport async function getProfilePhotos(\n    client: ITelegramClient,\n    userId: InputPeerLike,\n    params?: {\n        /**\n         * Offset from which to fetch.\n         *\n         * @default  `0`\n         */\n        offset?: number\n\n        /**\n         * Maximum number of items to fetch (up to 100)\n         *\n         * @default  `100`\n         */\n        limit?: number\n    },\n): Promise<ArrayPaginated<Photo, number>> {\n    if (!params) params = {}\n\n    const { offset = 0, limit = 100 } = params\n\n    const res = await client.call({\n        _: 'photos.getUserPhotos',\n        userId: await resolveUser(client, userId),\n        offset,\n        limit,\n        maxId: Long.ZERO,\n    })\n\n    return makeArrayPaginated(\n        res.photos.map((it) => {\n            assertTypeIs('getProfilePhotos', it, 'photo')\n\n            return new Photo(it)\n        }),\n        (res as tl.photos.RawPhotosSlice).count ?? res.photos.length,\n        offset + res.photos.length,\n    )\n}\n"]}

package/esm/highlevel/methods/users/get-users.d.ts

@@ -0,0 +1,12 @@
+import { MaybeArray } from '../../../types/utils.js';
+import { ITelegramClient } from '../../client.types.js';
+import { InputPeerLike, User } from '../../types/index.js';
+/**
+ * Get information about multiple users.
+ * You can retrieve up to 200 users at once.
+ *
+ * Note that order is not guaranteed.
+ *
+ * @param ids  Users' identifiers. Can be ID, username, phone number, `"me"`, `"self"` or TL object
+ */
+export declare function getUsers(client: ITelegramClient, ids: MaybeArray<InputPeerLike>): Promise<(User | null)[]>;

package/esm/highlevel/methods/users/get-users.js

@@ -0,0 +1,25 @@
+import { User } from '../../types/index.js';
+import { toInputUser } from '../../utils/peer-utils.js';
+import { _getUsersBatched } from '../chats/batched-queries.js';
+import { resolveUser } from './resolve-peer.js';
+import { resolvePeerMany } from './resolve-peer-many.js';
+/**
+ * Get information about multiple users.
+ * You can retrieve up to 200 users at once.
+ *
+ * Note that order is not guaranteed.
+ *
+ * @param ids  Users' identifiers. Can be ID, username, phone number, `"me"`, `"self"` or TL object
+ */
+export async function getUsers(client, ids) {
+    if (!Array.isArray(ids)) {
+        // avoid unnecessary overhead of Promise.all and resolvePeerMany
+        const res = await _getUsersBatched(client, await resolveUser(client, ids));
+        return [res ? new User(res) : null];
+    }
+    const inputPeers = await resolvePeerMany(client, ids, toInputUser);
+    // pooling will be done by the helper
+    const res = await Promise.all(inputPeers.map((peer) => _getUsersBatched(client, peer)));
+    return res.map((it) => (it ? new User(it) : null));
+}
+//# sourceMappingURL=get-users.js.map

package/esm/highlevel/methods/users/get-users.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-users.js","sourceRoot":"","sources":["../../../../../src/highlevel/methods/users/get-users.ts"],"names":[],"mappings":"AAEA,OAAO,EAAiB,IAAI,EAAE,MAAM,sBAAsB,CAAA;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAA;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAA;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AAExD;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,MAAuB,EAAE,GAA8B;IAClF,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE;QACrB,gEAAgE;QAChE,MAAM,GAAG,GAAG,MAAM,gBAAgB,CAAC,MAAM,EAAE,MAAM,WAAW,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAA;QAE1E,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAA;KACtC;IAED,MAAM,UAAU,GAAG,MAAM,eAAe,CAAC,MAAM,EAAE,GAAG,EAAE,WAAW,CAAC,CAAA;IAElE,qCAAqC;IACrC,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,gBAAgB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,CAAA;IAEvF,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAA;AACtD,CAAC","sourcesContent":["import { MaybeArray } from '../../../types/utils.js'\nimport { ITelegramClient } from '../../client.types.js'\nimport { InputPeerLike, User } from '../../types/index.js'\nimport { toInputUser } from '../../utils/peer-utils.js'\nimport { _getUsersBatched } from '../chats/batched-queries.js'\nimport { resolveUser } from './resolve-peer.js'\nimport { resolvePeerMany } from './resolve-peer-many.js'\n\n/**\n * Get information about multiple users.\n * You can retrieve up to 200 users at once.\n *\n * Note that order is not guaranteed.\n *\n * @param ids  Users' identifiers. Can be ID, username, phone number, `\"me\"`, `\"self\"` or TL object\n */\nexport async function getUsers(client: ITelegramClient, ids: MaybeArray<InputPeerLike>): Promise<(User | null)[]> {\n    if (!Array.isArray(ids)) {\n        // avoid unnecessary overhead of Promise.all and resolvePeerMany\n        const res = await _getUsersBatched(client, await resolveUser(client, ids))\n\n        return [res ? new User(res) : null]\n    }\n\n    const inputPeers = await resolvePeerMany(client, ids, toInputUser)\n\n    // pooling will be done by the helper\n    const res = await Promise.all(inputPeers.map((peer) => _getUsersBatched(client, peer)))\n\n    return res.map((it) => (it ? new User(it) : null))\n}\n"]}

package/esm/highlevel/methods/users/get-users.test.d.ts

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

package/esm/highlevel/methods/users/get-users.test.js

@@ -0,0 +1,28 @@
+import Long from 'long';
+import { describe, expect, it } from 'vitest';
+import { createStub, StubTelegramClient } from '@mtcute/test';
+import { assertTypeIs } from '../../../utils/type-assertions.js';
+import { User } from '../../types/index.js';
+import { getUsers } from './get-users.js';
+describe('getUsers', () => {
+    const client = new StubTelegramClient();
+    client.respondWith('users.getUsers', ({ id }) => id.map((it) => {
+        assertTypeIs('', it, 'inputUser');
+        if (it.userId === 1)
+            return { _: 'userEmpty', id: 1 };
+        return createStub('user', { id: it.userId, accessHash: Long.ZERO });
+    }));
+    it('should return users returned by users.getUsers', async () => {
+        expect(await getUsers(client, [123, 456])).toEqual([
+            new User(createStub('user', { id: 123, accessHash: Long.ZERO })),
+            new User(createStub('user', { id: 456, accessHash: Long.ZERO })),
+        ]);
+    });
+    it('should work for one user', async () => {
+        expect(await getUsers(client, 123)).toEqual([new User(createStub('user', { id: 123, accessHash: Long.ZERO }))]);
+    });
+    it('should return null for userEmpty', async () => {
+        expect(await getUsers(client, 1)).toEqual([null]);
+    });
+});
+//# sourceMappingURL=get-users.test.js.map

package/esm/highlevel/methods/users/get-users.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-users.test.js","sourceRoot":"","sources":["../../../../../src/highlevel/methods/users/get-users.test.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAA;AACvB,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAA;AAE7C,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAA;AAE7D,OAAO,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAA;AAChE,OAAO,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAA;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAEzC,QAAQ,CAAC,UAAU,EAAE,GAAG,EAAE;IACtB,MAAM,MAAM,GAAG,IAAI,kBAAkB,EAAE,CAAA;IAEvC,MAAM,CAAC,WAAW,CAAC,gBAAgB,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAC5C,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE;QACV,YAAY,CAAC,EAAE,EAAE,EAAE,EAAE,WAAW,CAAC,CAAA;QAEjC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC,EAAE,CAAA;QAErD,OAAO,UAAU,CAAC,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAA;IACvE,CAAC,CAAC,CACL,CAAA;IAED,EAAE,CAAC,gDAAgD,EAAE,KAAK,IAAI,EAAE;QAC5D,MAAM,CAAC,MAAM,QAAQ,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;YAC/C,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,UAAU,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;YAChE,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,UAAU,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;SACnE,CAAC,CAAA;IACN,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,0BAA0B,EAAE,KAAK,IAAI,EAAE;QACtC,MAAM,CAAC,MAAM,QAAQ,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,UAAU,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAA;IACnH,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,kCAAkC,EAAE,KAAK,IAAI,EAAE;QAC9C,MAAM,CAAC,MAAM,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAA;IACrD,CAAC,CAAC,CAAA;AACN,CAAC,CAAC,CAAA","sourcesContent":["import Long from 'long'\nimport { describe, expect, it } from 'vitest'\n\nimport { createStub, StubTelegramClient } from '@mtcute/test'\n\nimport { assertTypeIs } from '../../../utils/type-assertions.js'\nimport { User } from '../../types/index.js'\nimport { getUsers } from './get-users.js'\n\ndescribe('getUsers', () => {\n    const client = new StubTelegramClient()\n\n    client.respondWith('users.getUsers', ({ id }) =>\n        id.map((it) => {\n            assertTypeIs('', it, 'inputUser')\n\n            if (it.userId === 1) return { _: 'userEmpty', id: 1 }\n\n            return createStub('user', { id: it.userId, accessHash: Long.ZERO })\n        }),\n    )\n\n    it('should return users returned by users.getUsers', async () => {\n        expect(await getUsers(client, [123, 456])).toEqual([\n            new User(createStub('user', { id: 123, accessHash: Long.ZERO })),\n            new User(createStub('user', { id: 456, accessHash: Long.ZERO })),\n        ])\n    })\n\n    it('should work for one user', async () => {\n        expect(await getUsers(client, 123)).toEqual([new User(createStub('user', { id: 123, accessHash: Long.ZERO }))])\n    })\n\n    it('should return null for userEmpty', async () => {\n        expect(await getUsers(client, 1)).toEqual([null])\n    })\n})\n"]}

package/esm/highlevel/methods/users/iter-profile-photos.d.ts

@@ -0,0 +1,23 @@
+import { ITelegramClient } from '../../client.types.js';
+import { InputPeerLike, Photo } from '../../types/index.js';
+import { getProfilePhotos } from './get-profile-photos.js';
+/**
+ * Iterate over profile photos
+ *
+ * @param userId  User ID, username, phone number, `"me"` or `"self"`
+ * @param params
+ */
+export declare function iterProfilePhotos(client: ITelegramClient, userId: InputPeerLike, params?: Parameters<typeof getProfilePhotos>[2] & {
+    /**
+     * Maximum number of items to fetch
+     *
+     * @default  `Infinity`, i.e. all items are fetched
+     */
+    limit?: number;
+    /**
+     * Size of chunks which are fetched. Usually not needed.
+     *
+     * @default  100
+     */
+    chunkSize?: number;
+}): AsyncIterableIterator<Photo>;

package/esm/highlevel/methods/users/iter-profile-photos.js

@@ -0,0 +1,31 @@
+import { getProfilePhotos } from './get-profile-photos.js';
+import { resolveUser } from './resolve-peer.js';
+/**
+ * Iterate over profile photos
+ *
+ * @param userId  User ID, username, phone number, `"me"` or `"self"`
+ * @param params
+ */
+export async function* iterProfilePhotos(client, userId, params) {
+    if (!params)
+        params = {};
+    const peer = await resolveUser(client, userId);
+    const { limit = Infinity, chunkSize = 100 } = params;
+    let { offset } = params;
+    let current = 0;
+    for (;;) {
+        const res = await getProfilePhotos(client, peer, {
+            offset,
+            limit: Math.min(chunkSize, limit - current),
+        });
+        for (const it of res) {
+            yield it;
+            if (++current >= limit)
+                return;
+        }
+        if (!res.next)
+            return;
+        offset = res.next;
+    }
+}
+//# sourceMappingURL=iter-profile-photos.js.map

package/esm/highlevel/methods/users/iter-profile-photos.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"iter-profile-photos.js","sourceRoot":"","sources":["../../../../../src/highlevel/methods/users/iter-profile-photos.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAE/C;;;;;GAKG;AACH,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,iBAAiB,CACpC,MAAuB,EACvB,MAAqB,EACrB,MAcC;IAED,IAAI,CAAC,MAAM;QAAE,MAAM,GAAG,EAAE,CAAA;IAExB,MAAM,IAAI,GAAG,MAAM,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAE9C,MAAM,EAAE,KAAK,GAAG,QAAQ,EAAE,SAAS,GAAG,GAAG,EAAE,GAAG,MAAM,CAAA;IAEpD,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,CAAA;IACvB,IAAI,OAAO,GAAG,CAAC,CAAA;IAEf,SAAS;QACL,MAAM,GAAG,GAAG,MAAM,gBAAgB,CAAC,MAAM,EAAE,IAAI,EAAE;YAC7C,MAAM;YACN,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,KAAK,GAAG,OAAO,CAAC;SAC9C,CAAC,CAAA;QAEF,KAAK,MAAM,EAAE,IAAI,GAAG,EAAE;YAClB,MAAM,EAAE,CAAA;YAER,IAAI,EAAE,OAAO,IAAI,KAAK;gBAAE,OAAM;SACjC;QAED,IAAI,CAAC,GAAG,CAAC,IAAI;YAAE,OAAM;QACrB,MAAM,GAAG,GAAG,CAAC,IAAI,CAAA;KACpB;AACL,CAAC","sourcesContent":["import { ITelegramClient } from '../../client.types.js'\nimport { InputPeerLike, Photo } from '../../types/index.js'\nimport { getProfilePhotos } from './get-profile-photos.js'\nimport { resolveUser } from './resolve-peer.js'\n\n/**\n * Iterate over profile photos\n *\n * @param userId  User ID, username, phone number, `\"me\"` or `\"self\"`\n * @param params\n */\nexport async function* iterProfilePhotos(\n    client: ITelegramClient,\n    userId: InputPeerLike,\n    params?: Parameters<typeof getProfilePhotos>[2] & {\n        /**\n         * Maximum number of items to fetch\n         *\n         * @default  `Infinity`, i.e. all items are fetched\n         */\n        limit?: number\n\n        /**\n         * Size of chunks which are fetched. Usually not needed.\n         *\n         * @default  100\n         */\n        chunkSize?: number\n    },\n): AsyncIterableIterator<Photo> {\n    if (!params) params = {}\n\n    const peer = await resolveUser(client, userId)\n\n    const { limit = Infinity, chunkSize = 100 } = params\n\n    let { offset } = params\n    let current = 0\n\n    for (;;) {\n        const res = await getProfilePhotos(client, peer, {\n            offset,\n            limit: Math.min(chunkSize, limit - current),\n        })\n\n        for (const it of res) {\n            yield it\n\n            if (++current >= limit) return\n        }\n\n        if (!res.next) return\n        offset = res.next\n    }\n}\n"]}

package/esm/highlevel/methods/users/resolve-peer-many.d.ts

@@ -0,0 +1,22 @@
+import { tl } from '@mtcute/tl';
+import { ITelegramClient } from '../../client.types.js';
+import { InputPeerLike } from '../../types/index.js';
+/**
+ * Get multiple `InputPeer`s at once,
+ * while also normalizing and removing
+ * peers that can't be normalized to that type.
+ *
+ * Uses async pool internally, with a concurrent limit of 8
+ *
+ * @param peerIds  Peer Ids
+ * @param normalizer  Normalization function
+ */
+export declare function resolvePeerMany<T extends tl.TypeInputPeer | tl.TypeInputUser | tl.TypeInputChannel>(client: ITelegramClient, peerIds: InputPeerLike[], normalizer: (obj: tl.TypeInputPeer) => T | null): Promise<T[]>;
+/**
+ * Get multiple `InputPeer`s at once.
+ *
+ * Uses async pool internally, with a concurrent limit of 8
+ *
+ * @param peerIds  Peer Ids
+ */
+export declare function resolvePeerMany(client: ITelegramClient, peerIds: InputPeerLike[]): Promise<tl.TypeInputPeer[]>;

package/esm/highlevel/methods/users/resolve-peer-many.js

@@ -0,0 +1,66 @@
+import { ConditionVariable } from '../../../utils/condition-variable.js';
+import { resolvePeer } from './resolve-peer.js';
+/**
+ * @internal
+ */
+export async function resolvePeerMany(client, peerIds, normalizer) {
+    const ret = [];
+    const limit = 8;
+    if (peerIds.length < limit) {
+        // no point in using async pool for <limit peers
+        const res = await Promise.all(peerIds.map((it) => resolvePeer(client, it)));
+        if (!normalizer)
+            return res;
+        for (const value of res) {
+            const norm = normalizer(value);
+            if (norm) {
+                ret.push(norm);
+            }
+        }
+        return ret;
+    }
+    const cv = new ConditionVariable();
+    const buffer = {};
+    let nextIdx = 0;
+    let nextWorkerIdx = 0;
+    const fetchNext = async (idx = nextWorkerIdx++) => {
+        const result = await resolvePeer(client, peerIds[idx]);
+        buffer[idx] = result;
+        if (nextIdx === idx) {
+            cv.notify();
+        }
+        if (nextWorkerIdx < peerIds.length) {
+            await fetchNext(nextWorkerIdx++);
+        }
+    };
+    let error = undefined;
+    void Promise.all(Array.from({ length: limit }, (_, i) => fetchNext(i))).catch((e) => {
+        client.log.debug('resolvePeerMany errored: %s', e.message);
+        error = e;
+        cv.notify();
+    });
+    while (nextIdx < peerIds.length) {
+        await cv.wait();
+        // eslint-disable-next-line @typescript-eslint/no-throw-literal
+        if (error)
+            throw error;
+        while (nextIdx in buffer) {
+            const buf = buffer[nextIdx];
+            delete buffer[nextIdx];
+            nextIdx++;
+            if (!buf)
+                continue;
+            if (!normalizer) {
+                ret.push(buf);
+            }
+            else {
+                const norm = normalizer(buf);
+                if (norm) {
+                    ret.push(norm);
+                }
+            }
+        }
+    }
+    return ret;
+}
+//# sourceMappingURL=resolve-peer-many.js.map

package/esm/highlevel/methods/users/resolve-peer-many.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-peer-many.js","sourceRoot":"","sources":["../../../../../src/highlevel/methods/users/resolve-peer-many.ts"],"names":[],"mappings":"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","sourcesContent":["import { tl } from '@mtcute/tl'\n\nimport { ConditionVariable } from '../../../utils/condition-variable.js'\nimport { ITelegramClient } from '../../client.types.js'\nimport { InputPeerLike } from '../../types/index.js'\nimport { resolvePeer } from './resolve-peer.js'\n\n/**\n * Get multiple `InputPeer`s at once,\n * while also normalizing and removing\n * peers that can't be normalized to that type.\n *\n * Uses async pool internally, with a concurrent limit of 8\n *\n * @param peerIds  Peer Ids\n * @param normalizer  Normalization function\n */\nexport async function resolvePeerMany<T extends tl.TypeInputPeer | tl.TypeInputUser | tl.TypeInputChannel>(\n    client: ITelegramClient,\n    peerIds: InputPeerLike[],\n    normalizer: (obj: tl.TypeInputPeer) => T | null,\n): Promise<T[]>\n\n/**\n * Get multiple `InputPeer`s at once.\n *\n * Uses async pool internally, with a concurrent limit of 8\n *\n * @param peerIds  Peer Ids\n */\nexport async function resolvePeerMany(client: ITelegramClient, peerIds: InputPeerLike[]): Promise<tl.TypeInputPeer[]>\n\n/**\n * @internal\n */\nexport async function resolvePeerMany(\n    client: ITelegramClient,\n    peerIds: InputPeerLike[],\n    normalizer?: (obj: tl.TypeInputPeer) => tl.TypeInputPeer | tl.TypeInputUser | tl.TypeInputChannel | null,\n): Promise<(tl.TypeInputPeer | tl.TypeInputUser | tl.TypeInputChannel)[]> {\n    const ret: (tl.TypeInputPeer | tl.TypeInputUser | tl.TypeInputChannel)[] = []\n\n    const limit = 8\n\n    if (peerIds.length < limit) {\n        // no point in using async pool for <limit peers\n        const res = await Promise.all(peerIds.map((it) => resolvePeer(client, it)))\n\n        if (!normalizer) return res\n\n        for (const value of res) {\n            const norm = normalizer(value)\n\n            if (norm) {\n                ret.push(norm)\n            }\n        }\n\n        return ret\n    }\n\n    const cv = new ConditionVariable()\n    const buffer: Record<number, tl.TypeInputPeer | null> = {}\n\n    let nextIdx = 0\n    let nextWorkerIdx = 0\n\n    const fetchNext = async (idx = nextWorkerIdx++): Promise<void> => {\n        const result = await resolvePeer(client, peerIds[idx])\n\n        buffer[idx] = result\n\n        if (nextIdx === idx) {\n            cv.notify()\n        }\n\n        if (nextWorkerIdx < peerIds.length) {\n            await fetchNext(nextWorkerIdx++)\n        }\n    }\n\n    let error: unknown = undefined\n    void Promise.all(Array.from({ length: limit }, (_, i) => fetchNext(i))).catch((e) => {\n        client.log.debug('resolvePeerMany errored: %s', e.message)\n        error = e\n        cv.notify()\n    })\n\n    while (nextIdx < peerIds.length) {\n        await cv.wait()\n\n        // eslint-disable-next-line @typescript-eslint/no-throw-literal\n        if (error) throw error\n\n        while (nextIdx in buffer) {\n            const buf = buffer[nextIdx]\n            delete buffer[nextIdx]\n\n            nextIdx++\n\n            if (!buf) continue\n\n            if (!normalizer) {\n                ret.push(buf)\n            } else {\n                const norm = normalizer(buf)\n\n                if (norm) {\n                    ret.push(norm)\n                }\n            }\n        }\n    }\n\n    return ret\n}\n"]}

package/esm/highlevel/methods/users/resolve-peer.d.ts

@@ -0,0 +1,19 @@
+import { tl } from '@mtcute/tl';
+import { ITelegramClient } from '../../client.types.js';
+import { InputPeerLike } from '../../types/peers/index.js';
+/**
+ * Get the `InputPeer` of a known peer id.
+ * Useful when an `InputPeer` is needed in Raw API.
+ *
+ * @param peerId  The peer identifier that you want to extract the `InputPeer` from.
+ * @param force  Whether to force re-fetch the peer from the server (only for usernames and phone numbers)
+ */
+export declare function resolvePeer(client: ITelegramClient, peerId: InputPeerLike, force?: boolean): Promise<tl.TypeInputPeer>;
+/**
+ * Shorthand for `resolvePeer` that converts the input peer to `InputUser`.
+ */
+export declare function resolveUser(client: ITelegramClient, peerId: InputPeerLike, force?: boolean): Promise<tl.TypeInputUser>;
+/**
+ * Shorthand for `resolvePeer` that converts the input peer to `InputChannel`.
+ */
+export declare function resolveChannel(client: ITelegramClient, peerId: InputPeerLike, force?: boolean): Promise<tl.TypeInputChannel>;

package/esm/highlevel/methods/users/resolve-peer.js

@@ -0,0 +1,154 @@
+import Long from 'long';
+import { tl } from '@mtcute/tl';
+import { MtTypeAssertionError } from '../../../types/errors.js';
+import { getMarkedPeerId, parseMarkedPeerId, toggleChannelIdMark } from '../../../utils/peer-utils.js';
+import { MtPeerNotFoundError } from '../../types/errors.js';
+import { toInputChannel, toInputPeer, toInputUser } from '../../utils/peer-utils.js';
+// @available=both
+/**
+ * Get the `InputPeer` of a known peer id.
+ * Useful when an `InputPeer` is needed in Raw API.
+ *
+ * @param peerId  The peer identifier that you want to extract the `InputPeer` from.
+ * @param force  Whether to force re-fetch the peer from the server (only for usernames and phone numbers)
+ */
+export async function resolvePeer(client, peerId, force = false) {
+    // for convenience we also accept tl and User/Chat objects directly
+    if (typeof peerId === 'object') {
+        if (tl.isAnyPeer(peerId)) {
+            peerId = getMarkedPeerId(peerId);
+        }
+        else if ('inputPeer' in peerId) {
+            // User | Chat
+            peerId = peerId.inputPeer;
+        }
+        else {
+            peerId = toInputPeer(peerId);
+        }
+    }
+    if (typeof peerId === 'object') {
+        switch (peerId._) {
+            case 'mtcute.dummyInputPeerMinUser':
+                peerId = peerId.userId;
+                break;
+            case 'mtcute.dummyInputPeerMinChannel':
+                peerId = toggleChannelIdMark(peerId.channelId);
+                break;
+            default:
+                return peerId;
+        }
+    }
+    if (typeof peerId === 'number' && !force) {
+        const fromStorage = await client.storage.peers.getById(peerId);
+        if (fromStorage)
+            return fromStorage;
+    }
+    if (typeof peerId === 'string') {
+        if (peerId === 'self' || peerId === 'me')
+            return { _: 'inputPeerSelf' };
+        peerId = peerId.replace(/[@+\s()]/g, '');
+        let res;
+        if (peerId.match(/^\d+$/)) {
+            // phone number
+            const fromStorage = await client.storage.peers.getByPhone(peerId);
+            if (fromStorage)
+                return fromStorage;
+            res = await client.call({
+                _: 'contacts.resolvePhone',
+                phone: peerId,
+            });
+        }
+        else {
+            // username
+            if (!force) {
+                const fromStorage = await client.storage.peers.getByUsername(peerId);
+                if (fromStorage)
+                    return fromStorage;
+            }
+            res = await client.call({
+                _: 'contacts.resolveUsername',
+                username: peerId,
+            });
+        }
+        if (res.peer._ === 'peerUser') {
+            const id = res.peer.userId;
+            const found = res.users.find((it) => it.id === id);
+            if (found && found._ === 'user') {
+                if (!found.accessHash) {
+                    // no access hash, we can't use it
+                    // this may happen when bot resolves a username
+                    // of a user who hasn't started a conversation with it
+                    throw new MtPeerNotFoundError(`Peer (user) with username ${peerId} was found, but it has no access hash`);
+                }
+                return {
+                    _: 'inputPeerUser',
+                    userId: found.id,
+                    accessHash: found.accessHash,
+                };
+            }
+        }
+        else if (res.peer._ === 'peerChannel') {
+            const id = res.peer.channelId;
+            const found = res.chats.find((it) => it.id === id);
+            if (found) {
+                if (!(found._ === 'channel' || found._ === 'channelForbidden')) {
+                    // chats can't have usernames
+                    // furthermore, our id is a channel id, so it must be a channel
+                    // this should never happen, unless Telegram goes crazy
+                    throw new MtTypeAssertionError('contacts.resolveUsername#chats', 'channel', found._);
+                }
+                if (!found.accessHash) {
+                    // shouldn't happen? but just in case
+                    throw new MtPeerNotFoundError(`Peer (channel) with ${peerId} was found, but it has no access hash`);
+                }
+                return {
+                    _: 'inputPeerChannel',
+                    channelId: found.id,
+                    accessHash: found.accessHash,
+                };
+            }
+        }
+        else {
+            // chats can't have usernames
+            throw new MtTypeAssertionError('contacts.resolveUsername', 'user or channel', res.peer._);
+        }
+        throw new MtPeerNotFoundError(`Could not find a peer by ${peerId}`);
+    }
+    // in some cases, the server allows us to use access_hash=0.
+    // particularly, when we're a bot or we're referencing a user
+    // who we have "seen" recently
+    // if it's not the case, we'll get an `PEER_ID_INVALID` error anyways
+    const [peerType, bareId] = parseMarkedPeerId(peerId);
+    switch (peerType) {
+        case 'user':
+            return {
+                _: 'inputPeerUser',
+                userId: bareId,
+                accessHash: Long.ZERO,
+            };
+        case 'chat':
+            return {
+                _: 'inputPeerChat',
+                chatId: bareId,
+            };
+        case 'channel':
+            return {
+                _: 'inputPeerChannel',
+                channelId: bareId,
+                accessHash: Long.ZERO,
+            };
+    }
+}
+/**
+ * Shorthand for `resolvePeer` that converts the input peer to `InputUser`.
+ */
+export async function resolveUser(client, peerId, force = false) {
+    return toInputUser(await resolvePeer(client, peerId, force), peerId);
+}
+/**
+ * Shorthand for `resolvePeer` that converts the input peer to `InputChannel`.
+ */
+export async function resolveChannel(client, peerId, force = false) {
+    return toInputChannel(await resolvePeer(client, peerId, force), peerId);
+}
+//# sourceMappingURL=resolve-peer.js.map