@mtcute/core 0.27.0 → 0.27.2

package/highlevel/client.d.ts

@@ -169,7 +169,7 @@ export interface TelegramClient extends ITelegramClient {
      * When you log out, you can immediately log back in using
      * the same {@link TelegramClient} instance.
      *
-     * **Available**: ✅ both users and bots
+     * **Available**: 👤 users only
      *
      * @returns  On success, `true` is returned
      */
@@ -231,7 +231,7 @@ export interface TelegramClient extends ITelegramClient {
     /**
      * Authorize a bot using its token issued by [@BotFather](//t.me/BotFather)
      *
-     * **Available**: ✅ both users and bots
+     * **Available**: 👤 users only
      *
      * @param token  Bot token issued by BotFather
      * @returns  Bot's {@link User} object
@@ -297,7 +297,7 @@ export interface TelegramClient extends ITelegramClient {
      * > **Note**: Using this method assumes that you
      * > are using a test DC in `primaryDc` parameter.
      *
-     * **Available**: ✅ both users and bots
+     * **Available**: 👤 users only
      *
      * @param params  Additional parameters
      */
@@ -328,9 +328,9 @@ export interface TelegramClient extends ITelegramClient {
      * All parameters are `MaybeDynamic<T>`, meaning you
      * can either supply `T`, or a function that returns `MaybePromise<T>`
      *
-     * This method is intended for simple and fast use in automated
-     * scripts and bots. If you are developing a custom client,
-     * you'll probably need to use other auth methods.
+     * This method is intended for *interactive* login.
+     * If you are building some kind of headless service, you will most likely
+     * want to use the underlying authorization methods directly.
      * **Available**: ✅ both users and bots
      *
      */
@@ -412,7 +412,7 @@ export interface TelegramClient extends ITelegramClient {
     /**
      * Send an answer to a callback query.
      *
-     * **Available**: 🤖 bots only
+     * **Available**: 👤 users only
      *
      * @param queryId  ID of the callback query, or the query itself
      * @param params  Parameters of the answer
@@ -452,7 +452,7 @@ export interface TelegramClient extends ITelegramClient {
     /**
      * Answer an inline query.
      *
-     * **Available**: 🤖 bots only
+     * **Available**: 👤 users only
      *
      * @param queryId  Inline query ID
      * @param results  Results of the query
@@ -538,7 +538,7 @@ export interface TelegramClient extends ITelegramClient {
     /**
      * Answer a pre-checkout query.
      *
-     * **Available**: 🤖 bots only
+     * **Available**: 👤 users only
      *
      * @param queryId  Pre-checkout query ID
      */
@@ -552,7 +552,7 @@ export interface TelegramClient extends ITelegramClient {
      * Does the same as passing `null` to  {@link setMyCommands}
      *
      * Learn more about scopes in the [Bot API docs](https://core.telegram.org/bots/api#botcommandscope)
-     * **Available**: 🤖 bots only
+     * **Available**: 👤 users only
      *
      */
     deleteMyCommands(params?: {
@@ -569,7 +569,7 @@ export interface TelegramClient extends ITelegramClient {
     }): Promise<void>;
     /**
      * Gets information about a bot the current uzer owns (or the current bot)
-     * **Available**: ✅ both users and bots
+     * **Available**: 👤 users only
      *
      */
     getBotInfo(params: {
@@ -586,7 +586,7 @@ export interface TelegramClient extends ITelegramClient {
     }): Promise<tl.bots.RawBotInfo>;
     /**
      * Fetches the menu button set for the given user.
-     * **Available**: 🤖 bots only
+     * **Available**: 👤 users only
      *
      */
     getBotMenuButton(user: InputPeerLike): Promise<tl.TypeBotMenuButton>;
@@ -632,7 +632,7 @@ export interface TelegramClient extends ITelegramClient {
     }): Promise<tl.messages.TypeBotCallbackAnswer>;
     /**
      * Get high scores of a game
-     * **Available**: 🤖 bots only
+     * **Available**: 👤 users only
      *
      */
     getGameHighScores(params: InputMessageId & {
@@ -642,7 +642,7 @@ export interface TelegramClient extends ITelegramClient {
     /**
      * Get high scores of a game from an inline message
      *
-     * **Available**: 🤖 bots only
+     * **Available**: 👤 users only
      *
      * @param messageId  ID of the inline message containing the game
      * @param userId  ID of the user to find high scores for
@@ -653,7 +653,7 @@ export interface TelegramClient extends ITelegramClient {
      * and user language. If they are not set, empty set is returned.
      *
      * Learn more about scopes in the [Bot API docs](https://core.telegram.org/bots/api#botcommandscope)
-     * **Available**: 🤖 bots only
+     * **Available**: 👤 users only
      *
      */
     getMyCommands(params?: {
@@ -744,7 +744,7 @@ export interface TelegramClient extends ITelegramClient {
     /**
      * Prepare an inline message result to be sent later via the
      * `shareMessage` [mini-app api method](https://core.telegram.org/bots/webapps#initializing-mini-apps).
-     * **Available**: 🤖 bots only
+     * **Available**: 👤 users only
      *
      */
     prepareInlineMessage(params: {
@@ -773,7 +773,7 @@ export interface TelegramClient extends ITelegramClient {
     }): Promise<tl.messages.TypeBotPreparedInlineMessage>;
     /**
      * Sets information about a bot the current uzer owns (or the current bot)
-     * **Available**: ✅ both users and bots
+     * **Available**: 👤 users only
      *
      */
     setBotInfo(params: {
@@ -796,14 +796,14 @@ export interface TelegramClient extends ITelegramClient {
     }): Promise<void>;
     /**
      * Sets a menu button for the given user.
-     * **Available**: 🤖 bots only
+     * **Available**: 👤 users only
      *
      */
     setBotMenuButton(user: InputPeerLike, button: tl.TypeBotMenuButton): Promise<void>;
     /**
      * Set a score of a user in a game
      *
-     * **Available**: 🤖 bots only
+     * **Available**: 👤 users only
      *
      * @param params
      * @returns  The modified message
@@ -833,7 +833,7 @@ export interface TelegramClient extends ITelegramClient {
      * Set a score of a user in a game contained in
      * an inline message
      *
-     * **Available**: 🤖 bots only
+     * **Available**: 👤 users only
      *
      * @param params
      */
@@ -859,7 +859,7 @@ export interface TelegramClient extends ITelegramClient {
      * Set or delete commands for the current bot and the given scope
      *
      * Learn more about scopes in the [Bot API docs](https://core.telegram.org/bots/api#botcommandscope)
-     * **Available**: 🤖 bots only
+     * **Available**: 👤 users only
      *
      */
     setMyCommands(params: {
@@ -882,7 +882,7 @@ export interface TelegramClient extends ITelegramClient {
     }): Promise<void>;
     /**
      * Sets the default chat permissions for the bot in the supergroup or channel.
-     * **Available**: 🤖 bots only
+     * **Available**: 👤 users only
      *
      */
     setMyDefaultRights(params: {
@@ -936,7 +936,7 @@ export interface TelegramClient extends ITelegramClient {
      * When banning a channel, the user won't be able to use
      * any of their channels to post until the ban is lifted.
      *
-     * **Available**: ✅ both users and bots
+     * **Available**: 👤 users only
      *
      * @returns  Service message about removed user, if one was generated.
      */
@@ -1042,7 +1042,7 @@ export interface TelegramClient extends ITelegramClient {
      *
      * You must be an administrator and have the appropriate permissions.
      *
-     * **Available**: ✅ both users and bots
+     * **Available**: 👤 users only
      *
      * @param chatId  Chat ID or username
      */
@@ -1095,7 +1095,7 @@ export interface TelegramClient extends ITelegramClient {
     }): Promise<void>;
     /**
      * Edit supergroup/channel admin rights of a user.
-     * **Available**: ✅ both users and bots
+     * **Available**: 👤 users only
      *
      */
     editAdminRights(params: {
@@ -1170,7 +1170,7 @@ export interface TelegramClient extends ITelegramClient {
     /**
      * Get information about a single chat member
      *
-     * **Available**: ✅ both users and bots
+     * **Available**: 👤 users only
      *
      * @param chatId  Chat ID or username
      * @param userId  User ID, username, phone number, `"me"` or `"self"`
@@ -1187,7 +1187,7 @@ export interface TelegramClient extends ITelegramClient {
      *
      * You can retrieve up to 200 members at once
      *
-     * **Available**: ✅ both users and bots
+     * **Available**: 👤 users only
      *
      * @param chatId  Chat ID or username
      * @param params  Additional parameters
@@ -1385,7 +1385,7 @@ export interface TelegramClient extends ITelegramClient {
     /**
      * Leave a group chat, supergroup or channel
      *
-     * **Available**: ✅ both users and bots
+     * **Available**: 👤 users only
      *
      * @param chatId  Chat ID or username
      */
@@ -1441,7 +1441,7 @@ export interface TelegramClient extends ITelegramClient {
     reorderUsernames(peerId: InputPeerLike, order: string[]): Promise<void>;
     /**
      * Restrict a user in a supergroup.
-     * **Available**: ✅ both users and bots
+     * **Available**: 👤 users only
      *
      */
     restrictChatMember(params: {
@@ -1507,8 +1507,6 @@ export interface TelegramClient extends ITelegramClient {
         /**
          * Whether to set this color for the profile
          * header instead of chat name/replies.
-         *
-         * Currently only available for the current user.
          */
         forProfile?: boolean;
     }): Promise<void>;
@@ -1517,7 +1515,7 @@ export interface TelegramClient extends ITelegramClient {
      *
      * You must be an administrator in the chat and have appropriate permissions.
      *
-     * **Available**: ✅ both users and bots
+     * **Available**: 👤 users only
      *
      * @param chatId  Chat ID or username
      * @param restrictions
@@ -1532,7 +1530,7 @@ export interface TelegramClient extends ITelegramClient {
      *
      * You must be an administrator and have the appropriate permissions.
      *
-     * **Available**: ✅ both users and bots
+     * **Available**: 👤 users only
      *
      * @param chatId  Chat ID or username
      * @param description  New chat description, 0-255 characters
@@ -1542,7 +1540,7 @@ export interface TelegramClient extends ITelegramClient {
      * Set a new chat photo or video.
      *
      * You must be an administrator and have the appropriate permissions.
-     * **Available**: ✅ both users and bots
+     * **Available**: 👤 users only
      *
      */
     setChatPhoto(params: {
@@ -1563,7 +1561,7 @@ export interface TelegramClient extends ITelegramClient {
      *
      * You must be an administrator and have the appropriate permissions.
      *
-     * **Available**: ✅ both users and bots
+     * **Available**: 👤 users only
      *
      * @param chatId  Chat ID or username
      * @param title  New chat title, 1-255 characters
@@ -1669,7 +1667,7 @@ export interface TelegramClient extends ITelegramClient {
      * just allows the user to join the chat again, if they want.
      *
      * This method acts as a no-op in case a legacy group is passed.
-     * **Available**: ✅ both users and bots
+     * **Available**: 👤 users only
      *
      */
     unbanChatMember(params: {
@@ -1685,7 +1683,7 @@ export interface TelegramClient extends ITelegramClient {
      * just allows the user to join the chat again, if they want.
      *
      * This method acts as a no-op in case a legacy group is passed.
-     * **Available**: ✅ both users and bots
+     * **Available**: 👤 users only
      *
      */
     unrestrictChatMember(params: {
@@ -1721,6 +1719,10 @@ export interface TelegramClient extends ITelegramClient {
          * @default false
          */
         sharePhone?: boolean;
+        /**
+         * Note to the contact
+         */
+        note?: InputText;
     }): Promise<User>;
     /**
      * Delete one or more contacts from your Telegram contacts list
@@ -1747,6 +1749,13 @@ export interface TelegramClient extends ITelegramClient {
      * @param contacts  List of contacts
      */
     importContacts(contacts: PartialOnly<Omit<tl.RawInputPhoneContact, '_'>, 'clientId'>[]): Promise<tl.contacts.RawImportedContacts>;
+    /**
+     * Set a note for a contact
+     *
+     * @param userId  ID of the user to set the note for
+     * @param note  Note text
+     */
+    setContactNote(userId: InputPeerLike, note: InputText): Promise<void>;
     /**
      * Create a folder from given parameters
      *
@@ -1971,6 +1980,35 @@ export interface TelegramClient extends ITelegramClient {
      * @param params  File download parameters
      */
     downloadAsBuffer(location: FileDownloadLocation, params?: FileDownloadParameters): Promise<Uint8Array>;
+    /**
+     * Download a single chunk of a file, using [`precise`](https://core.telegram.org/api/files#downloading-files) download mode
+     *
+     * **Available**: 👤 users only
+     *
+     * @param params  Download parameters
+     */
+    downloadChunk(params: {
+        /** File from which to download a chunk */
+        location: FileDownloadLocation;
+        /**
+         * DC id from which the file will be downloaded.
+         *
+         * If provided DC is not the one storing the file,
+         * redirection will be handled automatically.
+         */
+        dcId?: number;
+        /** Offset of the chunk in bytes */
+        offset: number;
+        /**
+         * Number of bytes to download (starting from the offset)
+         *
+         * Max 1MB (1048576)
+         */
+        limit: number;
+        maxRetryCount?: number;
+        floodSleepThreshold?: number;
+        abortSignal?: AbortSignal;
+    }): Promise<Uint8Array>;
     /**
      * Download a remote file to a local file (only for Node.js).
      * Promise will resolve once the download is complete.
@@ -1981,6 +2019,11 @@ export interface TelegramClient extends ITelegramClient {
      * @param params  File download parameters
      */
     downloadToFile(filename: string, location: FileDownloadLocation, params?: FileDownloadParameters): Promise<void>;
+    _normalizeFileDownloadLocation(input: FileDownloadLocation): Promise<{
+        location: tl.TypeInputFileLocation | tl.TypeInputWebFileLocation | Uint8Array<ArrayBufferLike>;
+        dcId?: number;
+        fileSize?: number;
+    }>;
     /**
      * Download a file and return it as an iterable, which yields file contents
      * in chunks of a given size. Order of the chunks is guaranteed to be
@@ -2024,7 +2067,7 @@ export interface TelegramClient extends ITelegramClient {
     /**
      * Normalize an {@link InputMediaLike} to `InputMedia`,
      * uploading the file if needed.
-     * **Available**: ✅ both users and bots
+     * **Available**: 👤 users only
      *
      */
     _normalizeInputMedia(media: InputMediaLike, params?: {
@@ -2114,7 +2157,7 @@ export interface TelegramClient extends ITelegramClient {
      * the returned object will act like a message media
      * and contain fields like File ID.
      *
-     * **Available**: ✅ both users and bots
+     * **Available**: 👤 users only
      *
      * @param media  Media to upload
      * @param [params={}]  Upload parameters
@@ -2128,8 +2171,6 @@ export interface TelegramClient extends ITelegramClient {
      *
      * Only admins with `manageTopics` permission can do this.
      *
-     * **Available**: ✅ both users and bots
-     *
      * @returns  Service message for the created topic
      */
     createForumTopic(params: {
@@ -2161,8 +2202,6 @@ export interface TelegramClient extends ITelegramClient {
     /**
      * Delete a forum topic and all its history
      *
-     * **Available**: ✅ both users and bots
-     *
      * @param chat  Chat or user ID, username, phone number, `"me"` or `"self"`
      * @param topicId  ID of the topic (i.e. its top message ID)
      */
@@ -2178,8 +2217,6 @@ export interface TelegramClient extends ITelegramClient {
      *
      * Only admins with `manageTopics` permission can do this.
      *
-     * **Available**: ✅ both users and bots
-     *
      * @param chatId  Chat ID or username
      * @param topicId  ID of the topic (i.e. its top message ID)
      * @returns  Service message about the modification
@@ -2205,20 +2242,20 @@ export interface TelegramClient extends ITelegramClient {
          * to the client's update handler.
          */
         shouldDispatch?: true;
+        /** Whether to (un)close the topic */
+        closed?: boolean;
+        /** Whether to (un)hide the topic */
+        hidden?: boolean;
     }): Promise<Message>;
     /**
      * Get forum topics by their IDs
      *
-     * **Available**: 👤 users only
-     *
      * @param chatId  Chat ID or username
      */
     getForumTopicsById(chatId: InputPeerLike, ids: MaybeArray<number>): Promise<ForumTopic[]>;
     /**
      * Get forum topics
      *
-     * **Available**: 👤 users only
-     *
      * @param chatId  Chat ID or username
      */
     getForumTopics(chatId: InputPeerLike, params?: {
@@ -2260,8 +2297,6 @@ export interface TelegramClient extends ITelegramClient {
      * Reorder pinned forum topics
      *
      * Only admins with `manageTopics` permission can do this.
-     * **Available**: 👤 users only
-     *
      */
     reorderPinnedForumTopics(params: {
         /** Chat ID or username */
@@ -2280,8 +2315,6 @@ export interface TelegramClient extends ITelegramClient {
      *
      * Only admins with `manageTopics` permission can do this.
      *
-     * **Available**: ✅ both users and bots
-     *
      * @returns  Service message about the modification
      */
     toggleForumTopicClosed(parmas: {
@@ -2301,8 +2334,6 @@ export interface TelegramClient extends ITelegramClient {
      * Toggle whether a topic in a forum is pinned
      *
      * Only admins with `manageTopics` permission can do this.
-     * **Available**: 👤 users only
-     *
      */
     toggleForumTopicPinned(params: {
         /** Chat ID or username */
@@ -2332,7 +2363,7 @@ export interface TelegramClient extends ITelegramClient {
      *
      * Only admins with `manageTopics` permission can do this.
      *
-     * **Available**: ✅ both users and bots
+     * **Available**: 👤 users only
      *
      * @returns  Service message about the modification
      */
@@ -2352,7 +2383,7 @@ export interface TelegramClient extends ITelegramClient {
      *
      * You must be an administrator and have appropriate rights.
      *
-     * **Available**: ✅ both users and bots
+     * **Available**: 👤 users only
      *
      * @param chatId  Chat ID
      * @param params
@@ -2390,7 +2421,7 @@ export interface TelegramClient extends ITelegramClient {
      *
      * Only pass the fields that you want to modify.
      *
-     * **Available**: ✅ both users and bots
+     * **Available**: 👤 users only
      *
      * @param chatId  Chat ID
      * @param link  Invite link to edit
@@ -2427,7 +2458,7 @@ export interface TelegramClient extends ITelegramClient {
      * > **Note**: each administrator has their own primary invite link,
      * > and bots by default don't have one.
      *
-     * **Available**: ✅ both users and bots
+     * **Available**: 👤 users only
      *
      * @param chatId  Chat IDs
      */
@@ -2543,7 +2574,7 @@ export interface TelegramClient extends ITelegramClient {
     }): Promise<void>;
     /**
      * Approve or decline join request to a chat.
-     * **Available**: ✅ both users and bots
+     * **Available**: 👤 users only
      *
      */
     hideJoinRequest(params: {
@@ -2610,7 +2641,7 @@ export interface TelegramClient extends ITelegramClient {
      * If `link` is a primary invite link, a new invite link will be
      * generated automatically by Telegram
      *
-     * **Available**: ✅ both users and bots
+     * **Available**: 👤 users only
      *
      * @param chatId  Chat ID
      * @param link  Invite link to revoke
@@ -2620,7 +2651,7 @@ export interface TelegramClient extends ITelegramClient {
     /**
      * Append item(s) to a todo list
      *
-     * **Available**: ✅ both users and bots
+     * **Available**: 👤 users only
      *
      * @returns  Service message about the appended todo item(s), if any.
      */
@@ -2638,7 +2669,7 @@ export interface TelegramClient extends ITelegramClient {
      *
      * Once closed, poll can't be re-opened, and nobody
      * will be able to vote in it
-     * **Available**: ✅ both users and bots
+     * **Available**: 👤 users only
      *
      */
     closePoll(params: InputMessageId & {
@@ -2651,7 +2682,7 @@ export interface TelegramClient extends ITelegramClient {
     /**
      * Delete messages by their IDs
      *
-     * **Available**: ✅ both users and bots
+     * **Available**: 👤 users only
      *
      * @param chatId  Chat's marked ID, its username, phone or `"me"` or `"self"`.
      * @param ids  Message(s) ID(s) to delete.
@@ -2677,7 +2708,7 @@ export interface TelegramClient extends ITelegramClient {
     /**
      * Edit sent inline message text, media and reply markup.
      *
-     * **Available**: ✅ both users and bots
+     * **Available**: 👤 users only
      *
      * @param messageId
      *     Inline message ID, either as a TL object, or as a
@@ -2783,7 +2814,7 @@ export interface TelegramClient extends ITelegramClient {
      * Forward one or more messages by their IDs.
      * You can forward no more than 100 messages at once.
      *
-     * **Available**: ✅ both users and bots
+     * **Available**: 👤 users only
      *
      * @param toChatId  Destination chat ID, username, phone, `"me"` or `"self"`
      * @param fromChatId  Source chat ID, username, phone, `"me"` or `"self"`
@@ -2968,7 +2999,7 @@ export interface TelegramClient extends ITelegramClient {
      * For messages that were not found, `null` will be
      * returned at that position.
      *
-     * **Available**: ✅ both users and bots
+     * **Available**: 👤 users only
      *
      * @param messageIds  Messages IDs
      * @param [fromReply]
@@ -3148,7 +3179,7 @@ export interface TelegramClient extends ITelegramClient {
      * For supergroups/channels, you must have appropriate permissions,
      * either as an admin, or as default permissions
      *
-     * **Available**: ✅ both users and bots
+     * **Available**: 👤 users only
      *
      * @returns  Service message about pinned message, if one was generated.
      */
@@ -3709,7 +3740,7 @@ export interface TelegramClient extends ITelegramClient {
      *
      * This status is automatically renewed by mtcute until a further
      * call with `cancel` is made, or a message is sent to the chat.
-     * **Available**: ✅ both users and bots
+     * **Available**: 👤 users only
      *
      */
     setTyping(params: {
@@ -3737,7 +3768,7 @@ export interface TelegramClient extends ITelegramClient {
     /**
      * Toggle the completion status of a todo list item(s)
      *
-     * **Available**: ✅ both users and bots
+     * **Available**: 👤 users only
      *
      * @returns  Service message about the toggled items, if any.
      */
@@ -3775,7 +3806,7 @@ export interface TelegramClient extends ITelegramClient {
     /**
      * Unpin all pinned messages in a chat.
      *
-     * **Available**: ✅ both users and bots
+     * **Available**: 👤 users only
      *
      * @param chatId  Chat or user ID
      */
@@ -3796,7 +3827,7 @@ export interface TelegramClient extends ITelegramClient {
      * For supergroups/channels, you must have appropriate permissions,
      * either as an admin, or as default permissions
      *
-     * **Available**: ✅ both users and bots
+     * **Available**: 👤 users only
      *
      * @param chatId  Chat ID, username, phone number, `"self"` or `"me"`
      * @param messageId  Message ID
@@ -4019,7 +4050,7 @@ export interface TelegramClient extends ITelegramClient {
     getMyBoostSlots(): Promise<BoostSlot[]>;
     /**
      * Get a list of star gifts up for resale
-     * **Available**: ✅ both users and bots
+     * **Available**: 👤 users only
      *
      */
     getStarGiftResaleOptions(params: {
@@ -4049,7 +4080,7 @@ export interface TelegramClient extends ITelegramClient {
      * Get a list of saved star gifts of a user/channel
      *
      * Note that filters currently only work for channels
-     * **Available**: ✅ both users and bots
+     * **Available**: 👤 users only
      *
      */
     getSavedStarGifts(params: {
@@ -4067,6 +4098,10 @@ export interface TelegramClient extends ITelegramClient {
         excludeUnupgradable?: boolean;
         /** Whether to exclude gifts that can be upgraded */
         excludeUpgradable?: boolean;
+        /** Whether to exclude "hosted" gifts (i.e. those that are actually stored on the TON blockchain) */
+        excludeHosted?: boolean;
+        /** Whether to only return gifts with peer color available */
+        peerColorAvailable?: boolean;
         /** ID of the collection to get gifts from */
         collectionId?: number;
         /** Whether to sort by value */
@@ -4084,6 +4119,8 @@ export interface TelegramClient extends ITelegramClient {
     getStarGiftOptions(): Promise<StarGift[]>;
     /**
      * Get the value of a unique star gift
+     * **Available**: 👤 users only
+     *
      */
     getStarGiftValue(params: {
         /** Slug of the star gift */
@@ -4101,7 +4138,7 @@ export interface TelegramClient extends ITelegramClient {
      * You can either pass `self` to get your own transactions,
      * or a chat/bot ID to get transactions of that peer.
      *
-     * **Available**: ✅ both users and bots
+     * **Available**: 👤 users only
      *
      * @param peerId  Peer ID
      * @param params  Additional parameters
@@ -4132,7 +4169,7 @@ export interface TelegramClient extends ITelegramClient {
     }): Promise<StarsStatus>;
     /**
      * Get information about a unique star gift by its slug
-     * **Available**: ✅ both users and bots
+     * **Available**: 👤 users only
      *
      */
     getUniqueStarGift(slug: string): Promise<StarGiftUnique>;
@@ -4161,7 +4198,7 @@ export interface TelegramClient extends ITelegramClient {
     /**
      * Iterate over saved star gifts of a user,
      * wrapper over {@link getSavedStarGifts}
-     * **Available**: ✅ both users and bots
+     * **Available**: 👤 users only
      *
      */
     iterSavedStarGifts(params: Parameters<typeof getSavedStarGifts>[1] & {
@@ -4208,7 +4245,7 @@ export interface TelegramClient extends ITelegramClient {
     }): AsyncIterableIterator<StarsTransaction>;
     /**
      * Toggles whether one or more star gift is pinned to the top of the list
-     * **Available**: ✅ both users and bots
+     * **Available**: 👤 users only
      *
      */
     togglePinnedStarGifts(params: {
@@ -4372,7 +4409,7 @@ export interface TelegramClient extends ITelegramClient {
      *
      * For bots the sticker set must have been created by this bot.
      *
-     * **Available**: ✅ both users and bots
+     * **Available**: 👤 users only
      *
      * @param setId  Sticker set short name or TL object with input sticker set
      * @param sticker  Sticker to be added
@@ -4391,7 +4428,7 @@ export interface TelegramClient extends ITelegramClient {
     /**
      * Create a new sticker set.
      *
-     * **Available**: ✅ both users and bots
+     * **Available**: 👤 users only
      *
      * @param params
      * @returns  Newly created sticker set
@@ -4459,7 +4496,7 @@ export interface TelegramClient extends ITelegramClient {
      *
      * For bots the sticker set must have been created by this bot.
      *
-     * **Available**: ✅ both users and bots
+     * **Available**: 👤 users only
      *
      * @param sticker
      *     TDLib and Bot API compatible File ID, or a
@@ -4470,7 +4507,7 @@ export interface TelegramClient extends ITelegramClient {
     /**
      * Get custom emoji stickers by their IDs
      *
-     * **Available**: ✅ both users and bots
+     * **Available**: 👤 users only
      *
      * @param ids  IDs of the stickers (as defined in {@link MessageEntity.emojiId})
      */
@@ -4505,7 +4542,7 @@ export interface TelegramClient extends ITelegramClient {
     /**
      * Get a sticker set and stickers inside of it.
      *
-     * **Available**: ✅ both users and bots
+     * **Available**: 👤 users only
      *
      * @param setId  Sticker set identifier
      */
@@ -4516,7 +4553,7 @@ export interface TelegramClient extends ITelegramClient {
      *
      * For bots the sticker set must have been created by this bot.
      *
-     * **Available**: ✅ both users and bots
+     * **Available**: 👤 users only
      *
      * @param sticker
      *     TDLib and Bot API compatible File ID, or a
@@ -4550,7 +4587,7 @@ export interface TelegramClient extends ITelegramClient {
     /**
      * Set group sticker set for a supergroup
      *
-     * **Available**: ✅ both users and bots
+     * **Available**: 👤 users only
      *
      * @param setId  Sticker set short name or a TL object with input sticker set
      * @param thumb  Sticker set thumbnail
@@ -4561,7 +4598,7 @@ export interface TelegramClient extends ITelegramClient {
     /**
      * Set sticker set thumbnail
      *
-     * **Available**: ✅ both users and bots
+     * **Available**: 👤 users only
      *
      * @param id  Sticker set short name or a TL object with input sticker set
      * @param thumb  Sticker set thumbnail
@@ -5002,7 +5039,7 @@ export interface TelegramClient extends ITelegramClient {
     getGlobalTtl(): Promise<number>;
     /**
      * Get currently authorized user's full information
-     * **Available**: ✅ both users and bots
+     * **Available**: 👤 users only
      *
      */
     getMe(): Promise<User>;
@@ -5020,7 +5057,7 @@ export interface TelegramClient extends ITelegramClient {
     /**
      * Get a single profile picture of a user by its ID
      *
-     * **Available**: ✅ both users and bots
+     * **Available**: 👤 users only
      *
      * @param userId  User ID, username, phone number, `"me"` or `"self"`
      * @param photoId  ID of the photo to fetch
@@ -5030,7 +5067,7 @@ export interface TelegramClient extends ITelegramClient {
     /**
      * Get a list of profile pictures of a user
      *
-     * **Available**: ✅ both users and bots
+     * **Available**: 👤 users only
      *
      * @param userId  User ID, username, phone number, `"me"` or `"self"`
      * @param params
@@ -5051,6 +5088,8 @@ export interface TelegramClient extends ITelegramClient {
     }): Promise<ArrayPaginated<Photo, number>>;
     /**
      * Get music files saved to the user's profile
+     * **Available**: 👤 users only
+     *
      */
     getSavedMusic(params: {
         /** User ID, username, phone number, `"me"` or `"self"` */
@@ -5192,6 +5231,8 @@ export interface TelegramClient extends ITelegramClient {
      *  - yourself (`self`)
      *  - supergroups or channels with enough boosts which you are an admin of
      *  - for bots – users who gave you the appropriate permissions
+     * **Available**: 👤 users only
+     *
      */
     setEmojiStatus(params: {
         /** User or chat where the emoji status should be set */
@@ -5231,7 +5272,7 @@ export interface TelegramClient extends ITelegramClient {
      * Set a new profile photo or video for the current user.
      *
      * You can also pass a file ID or an InputPhoto to re-use existing photo.
-     * **Available**: ✅ both users and bots
+     * **Available**: 👤 users only
      *
      */
     setMyProfilePhoto(params: {