@mtcute/core 0.17.1 → 0.18.0

package/highlevel/methods/users/block-user.cjs

@@ -0,0 +1,17 @@
+if (typeof globalThis !== "undefined" && !globalThis._MTCUTE_CJS_DEPRECATION_WARNED) {
+  globalThis._MTCUTE_CJS_DEPRECATION_WARNED = true;
+  console.warn("[mtcute-workspace] CommonJS support is deprecated and will be removed in 0.20.0. Please consider switching to ESM, it's " + (/* @__PURE__ */ new Date()).getFullYear() + " already.");
+  console.warn("[mtcute-workspace] Learn more about switching to ESM: https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c");
+}
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const typeAssertions = require("../../../utils/type-assertions.cjs");
+const resolvePeer = require("./resolve-peer.cjs");
+async function blockUser(client, id) {
+  const r = await client.call({
+    _: "contacts.block",
+    id: await resolvePeer.resolvePeer(client, id)
+  });
+  typeAssertions.assertTrue("contacts.block", r);
+}
+exports.blockUser = blockUser;

package/highlevel/methods/users/block-user.d.cts

@@ -0,0 +1,8 @@
+import { ITelegramClient } from '../../client.types.js';
+import { InputPeerLike } from '../../types/index.js';
+/**
+ * Block a user
+ *
+ * @param id  User ID, username or phone number
+ */
+export declare function blockUser(client: ITelegramClient, id: InputPeerLike): Promise<void>;

package/highlevel/methods/users/block-user.js

@@ -0,0 +1,12 @@
+import { assertTrue } from "../../../utils/type-assertions.js";
+import { resolvePeer } from "./resolve-peer.js";
+async function blockUser(client, id) {
+  const r = await client.call({
+    _: "contacts.block",
+    id: await resolvePeer(client, id)
+  });
+  assertTrue("contacts.block", r);
+}
+export {
+  blockUser
+};

package/highlevel/methods/users/delete-profile-photos.cjs

@@ -0,0 +1,22 @@
+if (typeof globalThis !== "undefined" && !globalThis._MTCUTE_CJS_DEPRECATION_WARNED) {
+  globalThis._MTCUTE_CJS_DEPRECATION_WARNED = true;
+  console.warn("[mtcute-workspace] CommonJS support is deprecated and will be removed in 0.20.0. Please consider switching to ESM, it's " + (/* @__PURE__ */ new Date()).getFullYear() + " already.");
+  console.warn("[mtcute-workspace] Learn more about switching to ESM: https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c");
+}
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const convertFileId = require("../../utils/convert-file-id.cjs");
+async function deleteProfilePhotos(client, ids) {
+  if (!Array.isArray(ids)) ids = [ids];
+  const photos = ids.map((id) => {
+    if (typeof id === "string") {
+      return convertFileId.fileIdToInputPhoto(id);
+    }
+    return id;
+  });
+  await client.call({
+    _: "photos.deletePhotos",
+    id: photos
+  });
+}
+exports.deleteProfilePhotos = deleteProfilePhotos;

package/highlevel/methods/users/delete-profile-photos.d.cts

@@ -0,0 +1,9 @@
+import { tl } from '@mtcute/tl';
+import { MaybeArray } from '../../../types/utils.js';
+import { ITelegramClient } from '../../client.types.js';
+/**
+ * Delete your own profile photos
+ *
+ * @param ids  ID(s) of the photos. Can be file IDs or raw TL objects
+ */
+export declare function deleteProfilePhotos(client: ITelegramClient, ids: MaybeArray<string | tl.TypeInputPhoto>): Promise<void>;

package/highlevel/methods/users/delete-profile-photos.js

@@ -0,0 +1,17 @@
+import { fileIdToInputPhoto } from "../../utils/convert-file-id.js";
+async function deleteProfilePhotos(client, ids) {
+  if (!Array.isArray(ids)) ids = [ids];
+  const photos = ids.map((id) => {
+    if (typeof id === "string") {
+      return fileIdToInputPhoto(id);
+    }
+    return id;
+  });
+  await client.call({
+    _: "photos.deletePhotos",
+    id: photos
+  });
+}
+export {
+  deleteProfilePhotos
+};

package/highlevel/methods/users/edit-close-friends.cjs

@@ -0,0 +1,31 @@
+if (typeof globalThis !== "undefined" && !globalThis._MTCUTE_CJS_DEPRECATION_WARNED) {
+  globalThis._MTCUTE_CJS_DEPRECATION_WARNED = true;
+  console.warn("[mtcute-workspace] CommonJS support is deprecated and will be removed in 0.20.0. Please consider switching to ESM, it's " + (/* @__PURE__ */ new Date()).getFullYear() + " already.");
+  console.warn("[mtcute-workspace] Learn more about switching to ESM: https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c");
+}
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const typeAssertions = require("../../../utils/type-assertions.cjs");
+const resolvePeerMany = require("./resolve-peer-many.cjs");
+const peerUtils = require("../../utils/peer-utils.cjs");
+async function editCloseFriendsRaw(client, ids) {
+  const r = await client.call({
+    _: "contacts.editCloseFriends",
+    id: ids
+  });
+  typeAssertions.assertTrue("contacts.editCloseFriends", r);
+}
+async function editCloseFriends(client, ids) {
+  const r = await client.call({
+    _: "contacts.editCloseFriends",
+    id: await resolvePeerMany.resolvePeerMany(client, ids, peerUtils.toInputUser).then(
+      (r2) => r2.map((u) => {
+        if ("userId" in u) return u.userId;
+        return 0;
+      })
+    )
+  });
+  typeAssertions.assertTrue("contacts.editCloseFriends", r);
+}
+exports.editCloseFriends = editCloseFriends;
+exports.editCloseFriendsRaw = editCloseFriendsRaw;

package/highlevel/methods/users/edit-close-friends.d.cts

@@ -0,0 +1,14 @@
+import { ITelegramClient } from '../../client.types.js';
+import { InputPeerLike } from '../../types/index.js';
+/**
+ * Edit "close friends" list directly using user IDs
+ *
+ * @param ids  User IDs
+ */
+export declare function editCloseFriendsRaw(client: ITelegramClient, ids: number[]): Promise<void>;
+/**
+ * Edit "close friends" list using `InputPeerLike`s
+ *
+ * @param ids  User IDs
+ */
+export declare function editCloseFriends(client: ITelegramClient, ids: InputPeerLike[]): Promise<void>;

package/highlevel/methods/users/edit-close-friends.js

@@ -0,0 +1,26 @@
+import { assertTrue } from "../../../utils/type-assertions.js";
+import { resolvePeerMany } from "./resolve-peer-many.js";
+import { toInputUser } from "../../utils/peer-utils.js";
+async function editCloseFriendsRaw(client, ids) {
+  const r = await client.call({
+    _: "contacts.editCloseFriends",
+    id: ids
+  });
+  assertTrue("contacts.editCloseFriends", r);
+}
+async function editCloseFriends(client, ids) {
+  const r = await client.call({
+    _: "contacts.editCloseFriends",
+    id: await resolvePeerMany(client, ids, toInputUser).then(
+      (r2) => r2.map((u) => {
+        if ("userId" in u) return u.userId;
+        return 0;
+      })
+    )
+  });
+  assertTrue("contacts.editCloseFriends", r);
+}
+export {
+  editCloseFriends,
+  editCloseFriendsRaw
+};

package/highlevel/methods/users/get-common-chats.cjs

@@ -0,0 +1,18 @@
+if (typeof globalThis !== "undefined" && !globalThis._MTCUTE_CJS_DEPRECATION_WARNED) {
+  globalThis._MTCUTE_CJS_DEPRECATION_WARNED = true;
+  console.warn("[mtcute-workspace] CommonJS support is deprecated and will be removed in 0.20.0. Please consider switching to ESM, it's " + (/* @__PURE__ */ new Date()).getFullYear() + " already.");
+  console.warn("[mtcute-workspace] Learn more about switching to ESM: https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c");
+}
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const resolvePeer = require("./resolve-peer.cjs");
+const chat = require("../../types/peers/chat.cjs");
+async function getCommonChats(client, userId) {
+  return client.call({
+    _: "messages.getCommonChats",
+    userId: await resolvePeer.resolveUser(client, userId),
+    maxId: 0,
+    limit: 100
+  }).then((res) => res.chats.map((it) => new chat.Chat(it)));
+}
+exports.getCommonChats = getCommonChats;

package/highlevel/methods/users/get-common-chats.d.cts

@@ -0,0 +1,9 @@
+import { ITelegramClient } from '../../client.types.js';
+import { InputPeerLike, Chat } from '../../types/index.js';
+/**
+ * Get a list of common chats you have with a given user
+ *
+ * @param userId  User's ID, username or phone number
+ * @throws MtInvalidPeerTypeError
+ */
+export declare function getCommonChats(client: ITelegramClient, userId: InputPeerLike): Promise<Chat[]>;

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

@@ -0,0 +1,13 @@
+import { resolveUser } from "./resolve-peer.js";
+import { Chat as Chat$2 } from "../../types/peers/chat.js";
+async function getCommonChats(client, userId) {
+  return client.call({
+    _: "messages.getCommonChats",
+    userId: await resolveUser(client, userId),
+    maxId: 0,
+    limit: 100
+  }).then((res) => res.chats.map((it) => new Chat$2(it)));
+}
+export {
+  getCommonChats
+};

package/highlevel/methods/users/get-global-ttl.cjs

@@ -0,0 +1,13 @@
+if (typeof globalThis !== "undefined" && !globalThis._MTCUTE_CJS_DEPRECATION_WARNED) {
+  globalThis._MTCUTE_CJS_DEPRECATION_WARNED = true;
+  console.warn("[mtcute-workspace] CommonJS support is deprecated and will be removed in 0.20.0. Please consider switching to ESM, it's " + (/* @__PURE__ */ new Date()).getFullYear() + " already.");
+  console.warn("[mtcute-workspace] Learn more about switching to ESM: https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c");
+}
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+async function getGlobalTtl(client) {
+  return client.call({
+    _: "messages.getDefaultHistoryTTL"
+  }).then((r) => r.period);
+}
+exports.getGlobalTtl = getGlobalTtl;

package/highlevel/methods/users/get-global-ttl.d.cts

@@ -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/highlevel/methods/users/get-global-ttl.js

@@ -0,0 +1,8 @@
+async function getGlobalTtl(client) {
+  return client.call({
+    _: "messages.getDefaultHistoryTTL"
+  }).then((r) => r.period);
+}
+export {
+  getGlobalTtl
+};

package/highlevel/methods/users/get-me.cjs

@@ -0,0 +1,24 @@
+if (typeof globalThis !== "undefined" && !globalThis._MTCUTE_CJS_DEPRECATION_WARNED) {
+  globalThis._MTCUTE_CJS_DEPRECATION_WARNED = true;
+  console.warn("[mtcute-workspace] CommonJS support is deprecated and will be removed in 0.20.0. Please consider switching to ESM, it's " + (/* @__PURE__ */ new Date()).getFullYear() + " already.");
+  console.warn("[mtcute-workspace] Learn more about switching to ESM: https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c");
+}
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const typeAssertions = require("../../../utils/type-assertions.cjs");
+const user = require("../../types/peers/user.cjs");
+function getMe(client) {
+  return client.call({
+    _: "users.getUsers",
+    id: [
+      {
+        _: "inputUserSelf"
+      }
+    ]
+  }).then(async ([user$1]) => {
+    typeAssertions.assertTypeIs("getMe (@ users.getUsers)", user$1, "user");
+    await client.storage.self.storeFrom(user$1);
+    return new user.User(user$1);
+  });
+}
+exports.getMe = getMe;

package/highlevel/methods/users/get-me.d.cts

@@ -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/highlevel/methods/users/get-me.js

@@ -0,0 +1,19 @@
+import { assertTypeIs } from "../../../utils/type-assertions.js";
+import { User as User$2 } from "../../types/peers/user.js";
+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$2(user);
+  });
+}
+export {
+  getMe
+};

package/highlevel/methods/users/get-my-username.cjs

@@ -0,0 +1,11 @@
+if (typeof globalThis !== "undefined" && !globalThis._MTCUTE_CJS_DEPRECATION_WARNED) {
+  globalThis._MTCUTE_CJS_DEPRECATION_WARNED = true;
+  console.warn("[mtcute-workspace] CommonJS support is deprecated and will be removed in 0.20.0. Please consider switching to ESM, it's " + (/* @__PURE__ */ new Date()).getFullYear() + " already.");
+  console.warn("[mtcute-workspace] Learn more about switching to ESM: https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c");
+}
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+async function getMyUsername(client) {
+  return client.storage.self.fetch().then((self) => self?.usernames[0] ?? null);
+}
+exports.getMyUsername = getMyUsername;

package/highlevel/methods/users/get-my-username.d.cts

@@ -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/highlevel/methods/users/get-my-username.js

@@ -0,0 +1,6 @@
+async function getMyUsername(client) {
+  return client.storage.self.fetch().then((self) => self?.usernames[0] ?? null);
+}
+export {
+  getMyUsername
+};

package/highlevel/methods/users/get-profile-photo.cjs

@@ -0,0 +1,23 @@
+if (typeof globalThis !== "undefined" && !globalThis._MTCUTE_CJS_DEPRECATION_WARNED) {
+  globalThis._MTCUTE_CJS_DEPRECATION_WARNED = true;
+  console.warn("[mtcute-workspace] CommonJS support is deprecated and will be removed in 0.20.0. Please consider switching to ESM, it's " + (/* @__PURE__ */ new Date()).getFullYear() + " already.");
+  console.warn("[mtcute-workspace] Learn more about switching to ESM: https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c");
+}
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const typeAssertions = require("../../../utils/type-assertions.cjs");
+const resolvePeer = require("./resolve-peer.cjs");
+const photo = require("../../types/media/photo.cjs");
+async function getProfilePhoto(client, userId, photoId) {
+  const res = await client.call({
+    _: "photos.getUserPhotos",
+    userId: await resolvePeer.resolveUser(client, userId),
+    offset: -1,
+    limit: 1,
+    maxId: photoId
+  });
+  const photo$1 = res.photos[0];
+  typeAssertions.assertTypeIs("getProfilePhotos", photo$1, "photo");
+  return new photo.Photo(photo$1);
+}
+exports.getProfilePhoto = getProfilePhoto;

package/highlevel/methods/users/get-profile-photo.d.cts

@@ -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/highlevel/methods/users/get-profile-photo.js

@@ -0,0 +1,18 @@
+import { assertTypeIs } from "../../../utils/type-assertions.js";
+import { resolveUser } from "./resolve-peer.js";
+import { Photo as Photo$2 } from "../../types/media/photo.js";
+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$2(photo);
+}
+export {
+  getProfilePhoto
+};

package/highlevel/methods/users/get-profile-photos.cjs

@@ -0,0 +1,32 @@
+if (typeof globalThis !== "undefined" && !globalThis._MTCUTE_CJS_DEPRECATION_WARNED) {
+  globalThis._MTCUTE_CJS_DEPRECATION_WARNED = true;
+  console.warn("[mtcute-workspace] CommonJS support is deprecated and will be removed in 0.20.0. Please consider switching to ESM, it's " + (/* @__PURE__ */ new Date()).getFullYear() + " already.");
+  console.warn("[mtcute-workspace] Learn more about switching to ESM: https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c");
+}
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const Long = require("long");
+const typeAssertions = require("../../../utils/type-assertions.cjs");
+const resolvePeer = require("./resolve-peer.cjs");
+const miscUtils = require("../../utils/misc-utils.cjs");
+const photo = require("../../types/media/photo.cjs");
+async function getProfilePhotos(client, userId, params) {
+  if (!params) params = {};
+  const { offset = 0, limit = 100 } = params;
+  const res = await client.call({
+    _: "photos.getUserPhotos",
+    userId: await resolvePeer.resolveUser(client, userId),
+    offset,
+    limit,
+    maxId: Long.ZERO
+  });
+  return miscUtils.makeArrayPaginated(
+    res.photos.map((it) => {
+      typeAssertions.assertTypeIs("getProfilePhotos", it, "photo");
+      return new photo.Photo(it);
+    }),
+    res.count ?? res.photos.length,
+    offset + res.photos.length
+  );
+}
+exports.getProfilePhotos = getProfilePhotos;

package/highlevel/methods/users/get-profile-photos.d.cts

@@ -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/highlevel/methods/users/get-profile-photos.js

@@ -0,0 +1,27 @@
+import Long from "long";
+import { assertTypeIs } from "../../../utils/type-assertions.js";
+import { resolveUser } from "./resolve-peer.js";
+import { makeArrayPaginated } from "../../utils/misc-utils.js";
+import { Photo as Photo$2 } from "../../types/media/photo.js";
+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$2(it);
+    }),
+    res.count ?? res.photos.length,
+    offset + res.photos.length
+  );
+}
+export {
+  getProfilePhotos
+};

package/highlevel/methods/users/get-users.cjs

@@ -0,0 +1,22 @@
+if (typeof globalThis !== "undefined" && !globalThis._MTCUTE_CJS_DEPRECATION_WARNED) {
+  globalThis._MTCUTE_CJS_DEPRECATION_WARNED = true;
+  console.warn("[mtcute-workspace] CommonJS support is deprecated and will be removed in 0.20.0. Please consider switching to ESM, it's " + (/* @__PURE__ */ new Date()).getFullYear() + " already.");
+  console.warn("[mtcute-workspace] Learn more about switching to ESM: https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c");
+}
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const peerUtils = require("../../utils/peer-utils.cjs");
+const batchedQueries = require("../chats/batched-queries.cjs");
+const resolvePeerMany = require("./resolve-peer-many.cjs");
+const resolvePeer = require("./resolve-peer.cjs");
+const user = require("../../types/peers/user.cjs");
+async function getUsers(client, ids) {
+  if (!Array.isArray(ids)) {
+    const res2 = await batchedQueries._getUsersBatched(client, await resolvePeer.resolveUser(client, ids));
+    return [res2 ? new user.User(res2) : null];
+  }
+  const inputPeers = await resolvePeerMany.resolvePeerMany(client, ids, peerUtils.toInputUser);
+  const res = await Promise.all(inputPeers.map((peer) => batchedQueries._getUsersBatched(client, peer)));
+  return res.map((it) => it ? new user.User(it) : null);
+}
+exports.getUsers = getUsers;

package/highlevel/methods/users/get-users.d.cts

@@ -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/highlevel/methods/users/get-users.js

@@ -0,0 +1,17 @@
+import { toInputUser } from "../../utils/peer-utils.js";
+import { _getUsersBatched } from "../chats/batched-queries.js";
+import { resolvePeerMany } from "./resolve-peer-many.js";
+import { resolveUser } from "./resolve-peer.js";
+import { User as User$2 } from "../../types/peers/user.js";
+async function getUsers(client, ids) {
+  if (!Array.isArray(ids)) {
+    const res2 = await _getUsersBatched(client, await resolveUser(client, ids));
+    return [res2 ? new User$2(res2) : null];
+  }
+  const inputPeers = await resolvePeerMany(client, ids, toInputUser);
+  const res = await Promise.all(inputPeers.map((peer) => _getUsersBatched(client, peer)));
+  return res.map((it) => it ? new User$2(it) : null);
+}
+export {
+  getUsers
+};

package/highlevel/methods/users/is-peer-available.cjs

@@ -0,0 +1,40 @@
+if (typeof globalThis !== "undefined" && !globalThis._MTCUTE_CJS_DEPRECATION_WARNED) {
+  globalThis._MTCUTE_CJS_DEPRECATION_WARNED = true;
+  console.warn("[mtcute-workspace] CommonJS support is deprecated and will be removed in 0.20.0. Please consider switching to ESM, it's " + (/* @__PURE__ */ new Date()).getFullYear() + " already.");
+  console.warn("[mtcute-workspace] Learn more about switching to ESM: https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c");
+}
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const peerUtils = require("../../../utils/peer-utils.cjs");
+const resolvePeer = require("./resolve-peer.cjs");
+async function isPeerAvailable(client, peerId) {
+  peerId = resolvePeer._normalizePeerId(peerId);
+  if (typeof peerId === "object") {
+    return true;
+  }
+  if (typeof peerId === "number") {
+    const fromStorage = await client.storage.peers.getById(peerId);
+    if (fromStorage) return true;
+    const [peerType] = peerUtils.parseMarkedPeerId(peerId);
+    if (peerType === "chat" || client.storage.self.getCached(true)?.isBot) {
+      return true;
+    }
+    return false;
+  }
+  if (typeof peerId === "string") {
+    if (peerId === "self" || peerId === "me") {
+      return true;
+    }
+    peerId = peerId.replace(/[@+\s()]/g, "");
+    if (peerId.match(/^\d+$/)) {
+      const fromStorage = await client.storage.peers.getByPhone(peerId);
+      if (fromStorage) return true;
+    } else {
+      const fromStorage = await client.storage.peers.getByUsername(peerId);
+      if (fromStorage) return true;
+    }
+    return false;
+  }
+  return false;
+}
+exports.isPeerAvailable = isPeerAvailable;

package/highlevel/methods/users/is-peer-available.d.cts

@@ -0,0 +1,20 @@
+import { ITelegramClient } from '../../client.types.js';
+import { InputPeerLike } from '../../types/index.js';
+/**
+ * Check whether a given peer ID can be used to actually
+ * interact with the Telegram API.
+ * This method checks the internal peers cache for the given
+ * input peer, and returns `true` if it is available there.
+ *
+ * You can think of this method as a stripped down version of
+ * {@link resolvePeer}, which only returns `true` or `false`.
+ *
+ * > **Note:** This method works offline and never sends any requests.
+ * > This means that when passing a username or phone number, it will
+ * > only return `true` if the user with that username/phone number
+ * > is cached in the storage, and will not try to resolve the peer by calling the API,
+ * > which *may* lead to false negatives.
+ *
+ * @returns
+ */
+export declare function isPeerAvailable(client: ITelegramClient, peerId: InputPeerLike): Promise<boolean>;

package/highlevel/methods/users/is-peer-available.js

@@ -0,0 +1,35 @@
+import { parseMarkedPeerId } from "../../../utils/peer-utils.js";
+import { _normalizePeerId } from "./resolve-peer.js";
+async function isPeerAvailable(client, peerId) {
+  peerId = _normalizePeerId(peerId);
+  if (typeof peerId === "object") {
+    return true;
+  }
+  if (typeof peerId === "number") {
+    const fromStorage = await client.storage.peers.getById(peerId);
+    if (fromStorage) return true;
+    const [peerType] = parseMarkedPeerId(peerId);
+    if (peerType === "chat" || client.storage.self.getCached(true)?.isBot) {
+      return true;
+    }
+    return false;
+  }
+  if (typeof peerId === "string") {
+    if (peerId === "self" || peerId === "me") {
+      return true;
+    }
+    peerId = peerId.replace(/[@+\s()]/g, "");
+    if (peerId.match(/^\d+$/)) {
+      const fromStorage = await client.storage.peers.getByPhone(peerId);
+      if (fromStorage) return true;
+    } else {
+      const fromStorage = await client.storage.peers.getByUsername(peerId);
+      if (fromStorage) return true;
+    }
+    return false;
+  }
+  return false;
+}
+export {
+  isPeerAvailable
+};