@mtcute/core 0.27.2 → 0.27.4

package/highlevel/client.d.ts

@@ -7,6 +7,8 @@ import { ITelegramClient } from './client.types.js';
 import { LogOutResult } from './methods/auth/log-out.js';
 import { CreateGroupResult } from './methods/chats/create-group.js';
 import { GetForumTopicsOffset, getForumTopics } from './methods/forums/get-forum-topics.js';
+import { InputStarGiftAttributeIds, ResaleStarGiftsMeta } from './methods/gifts/get-resale-star-gifts.js';
+import { StarGiftUpgradeOptions } from './methods/gifts/get-star-gift-upgrade-options.js';
 import { GetInviteLinksOffset, getInviteLinks } from './methods/invite-links/get-invite-links.js';
 import { DeleteMessagesParams } from './methods/messages/delete-messages.js';
 import { ForwardMessageOptions } from './methods/messages/forward-messages.js';
@@ -20,8 +22,8 @@ import { CommonSendParams } from './methods/messages/send-common.js';
 import { SendCopyGroupParams } from './methods/messages/send-copy-group.js';
 import { SendCopyParams } from './methods/messages/send-copy.js';
 import { QuoteParamsFrom } from './methods/messages/send-quote.js';
+import { InputStarsAmount } from './methods/premium/_normalize-stars-amount.js';
 import { CanApplyBoostResult } from './methods/premium/can-apply-boost.js';
-import { InputStarGiftAttributeIds, ResaleStarGiftsMeta } from './methods/premium/get-resale-star-gifts.js';
 import { CanSendStoryResult } from './methods/stories/can-send-story.js';
 import { ITelegramStorageProvider } from './storage/provider.js';
 import { AllStories, ArrayPaginated, ArrayPaginatedWithMeta, ArrayWithTotal, Audio, Boost, BoostSlot, BoostStats, BotChatJoinRequestUpdate, BotCommands, BotReactionCountUpdate, BotReactionUpdate, BotStoppedUpdate, BusinessCallbackQuery, BusinessChatLink, BusinessConnection, BusinessMessage, BusinessWorkHoursDay, CallbackQuery, Chat, ChatEvent, ChatInviteLink, ChatInviteLinkMember, ChatJoinRequestUpdate, ChatlistPreview, ChatMember, ChatMemberUpdate, ChatPreview, ChosenInlineResult, CollectibleInfo, DeleteBusinessMessageUpdate, DeleteMessageUpdate, DeleteStoryUpdate, Dialog, FactCheck, FileDownloadLocation, FileDownloadParameters, ForumTopic, FullChat, FullUser, GameHighScore, HistoryReadUpdate, InlineCallbackQuery, InlineQuery, InputChatEventFilters, InputDialogFolder, InputDocumentId, InputFileLike, InputInlineResult, InputMediaAudio, InputMediaLike, InputMediaSticker, InputMessageId, InputPeerLike, InputPrivacyRule, InputReaction, InputStarGift, InputStickerSet, InputStickerSetItem, InputText, InputWebview, MaybeDynamic, Message, MessageEffect, MessageMedia, MessageReactions, ParametersSkip2, ParsedUpdate, Peer, PeerReaction, PeerSettings, PeerStories, Photo, Poll, PollUpdate, PollVoteUpdate, PreCheckoutQuery, RawDocument, ReplyMarkup, SavedStarGift, SentCode, StarGift, StarGiftUnique, StarGiftValue, StarsStatus, StarsTransaction, Sticker, StickerSet, StickerType, StoriesStealthMode, Story, StoryInteractions, StoryUpdate, StoryViewer, StoryViewersList, TakeoutSession, TextWithEntities, TypingStatus, UploadedFile, UploadFileLike, User, UserStatusUpdate, UserTypingUpdate, WebPageMedia, WebviewResult } from './types/index.js';
@@ -31,12 +33,12 @@ import { InputStringSessionData } from './utils/string-session.js';
 import { Emitter } from '@fuman/utils';
 import { getChatEventLog } from './methods/chats/get-chat-event-log.js';
 import { getChatMembers } from './methods/chats/get-chat-members.js';
+import { getSavedStarGifts } from './methods/gifts/get-saved-star-gifts.js';
 import { getInviteLinkMembers } from './methods/invite-links/get-invite-link-members.js';
 import { sendMediaGroup } from './methods/messages/send-media-group.js';
 import { sendMedia } from './methods/messages/send-media.js';
 import { sendText } from './methods/messages/send-text.js';
 import { getBoosts } from './methods/premium/get-boosts.js';
-import { getSavedStarGifts } from './methods/premium/get-saved-star-gifts.js';
 import { getStarsTransactions } from './methods/premium/get-stars-transactions.js';
 import { getAllStories } from './methods/stories/get-all-stories.js';
 import { getProfileStories } from './methods/stories/get-profile-stories.js';
@@ -2033,7 +2035,16 @@ export interface TelegramClient extends ITelegramClient {
      *
      * @param params  Download parameters
      */
-    downloadAsIterable(input: FileDownloadLocation, params?: FileDownloadParameters): AsyncIterableIterator<Uint8Array>;
+    downloadAsIterable(input: FileDownloadLocation, params?: FileDownloadParameters & {
+        /**
+         * A function to apply backpressure to the download.
+         *
+         * If the consumer isn't keeping up, the function is supposed to return a promise that resolves when the consumer is ready to receive more data.
+         *
+         * Note that this function will likely get called multiple times simultaneously, since the download is parallelized.
+         */
+        throttle?: (chunkSize: number) => MaybePromise<void>;
+    }): AsyncIterableIterator<Uint8Array>;
     /**
      * Download a remote file as a Node.js Readable stream.
      *
@@ -2043,14 +2054,25 @@ export interface TelegramClient extends ITelegramClient {
      */
     downloadAsNodeStream(location: FileDownloadLocation, params?: FileDownloadParameters): import('node:stream').Readable;
     /**
-     * Download a file and return it as a `@fuman/io` stream,
+     * Download a file and return it as a Web Stream,
      * streaming file contents.
      *
      * **Available**: ✅ both users and bots
      *
      * @param params  File download parameters
      */
-    downloadAsStream(location: FileDownloadLocation, params?: FileDownloadParameters): ReadableStream<Uint8Array>;
+    downloadAsStream(location: FileDownloadLocation, params?: FileDownloadParameters & {
+        /**
+         * If passed, the maximum number of bytes that can be buffered in the stream.
+         *
+         * If the consumer isn't keeping up, the stream will pause until the buffer is below this limit.
+         *
+         * Note that this parameter is not guaranteed to be strictly the maximum number of bytes
+         * buffered at once, since the underlying download is parallelized, and is treated merely as a hint.
+         * The actual number of bytes buffered at once can be as much as `partSize * numWorkers`
+         */
+        highWaterMark?: number;
+    }): ReadableStream<Uint8Array>;
     /**
      * Normalize a {@link InputFileLike} to `InputFile`,
      * uploading it if needed.
@@ -2378,194 +2400,501 @@ export interface TelegramClient extends ITelegramClient {
          */
         shouldDispatch?: true;
     }): Promise<Message>;
+    _normalizeInputStarGift(gift: InputStarGift): Promise<tl.TypeInputSavedStarGift>;
     /**
-     * Create an additional invite link for the chat.
-     *
-     * You must be an administrator and have appropriate rights.
+     * Accept, hide or convert a star gift.
      *
      * **Available**: 👤 users only
      *
-     * @param chatId  Chat ID
-     * @param params
+     * @returns  Whether the action was successful
      */
-    createInviteLink(chatId: InputPeerLike, params?: {
-        /**
-         * Date when this link will expire.
-         * If `number` is passed, UNIX time in ms is expected.
-         */
-        expires?: number | Date;
-        /**
-         * Maximum number of users that can be members of this chat
-         * at the same time after joining using this link.
-         *
-         * Integer in range `[1, 99999]` or `Infinity`
-         *
-         * @default  `Infinity`
-         */
-        usageLimit?: number;
+    acceptStarGift(params: {
+        /** Input star gift to accept */
+        gift: InputStarGift;
         /**
-         * Whether users to be joined via this link need to be
-         * approved by an admin
+         * Action to perform on the gift.
+         *  - `save` - save the gift to your profile
+         *  - `hide` - hide the gift from your profile
+         *  - `convert` - convert the gift to stars (can't be undone)
          */
-        withApproval?: boolean;
+        action: 'save' | 'hide' | 'convert';
+    }): Promise<boolean>;
+    buyResaleGift(params: {
+        /** Slug of the star gift to buy */
+        slug: string;
+        /** ID of the user to buy the gift for */
+        recipient: InputPeerLike;
         /**
-         * When a pricing plan is passed, this link will become a paid subscription link
-         *
-         * Currently the only allowed `.period` is 1 month, i.e. `2592000`
+         * Whether to dispatch the new message event
+         * to the client's update handler.
          */
-        subscriptionPricing?: tl.TypeStarsSubscriptionPricing;
-    }): Promise<ChatInviteLink>;
+        shouldDispatch?: true;
+        /** Whether to use TON currency for payment */
+        ton?: boolean;
+    }): Promise<Message | null>;
     /**
-     * Edit an invite link. You can only edit non-primary
-     * invite links.
-     *
-     * Only pass the fields that you want to modify.
-     *
+     * Get a list of star gifts up for resale
      * **Available**: 👤 users only
      *
-     * @param chatId  Chat ID
-     * @param link  Invite link to edit
-     * @param params
-     * @returns  Modified invite link
      */
-    editInviteLink(params: {
-        /** Chat ID */
-        chatId: InputPeerLike;
-        /** Invite link to edit */
-        link: string | ChatInviteLink;
-        /**
-         * Date when this link will expire.
-         * If `number` is passed, UNIX time in ms is expected.
-         */
-        expires?: number | Date;
+    getStarGiftResaleOptions(params: {
+        /** ID of the gift to get resale options for */
+        giftId: tl.Long;
         /**
-         * Maximum number of users that can be members of this chat
-         * at the same time after joining using this link.
+         * Sorting attribute
          *
-         * Integer in range `[1, 99999]` or `Infinity`,
+         * - `price`: Sort by price
+         * - `num`: Sort by its unique number
          */
-        usageLimit?: number;
+        sort?: 'price' | 'num';
         /**
-         * Whether users to be joined via this link need to be
-         * approved by an admin
+         * Hash of the `attributes` field, as returned by the server in the first response
          */
-        withApproval?: boolean;
-    }): Promise<ChatInviteLink>;
+        attributesHash?: Long;
+        /** Attributes to filter for */
+        attributes?: tl.TypeStarGiftAttributeId[] | InputStarGiftAttributeIds;
+        /** Offset for pagination */
+        offset?: string;
+        /** Limit for pagination */
+        limit?: number;
+    }): Promise<ArrayPaginatedWithMeta<StarGiftUnique, string, ResaleStarGiftsMeta>>;
+    /** Get one or more saved star gifts by their IDs */
+    getSavedStarGiftsById(gifts: MaybeArray<InputStarGift>): Promise<SavedStarGift[]>;
     /**
-     * Generate a new primary invite link for a chat,
-     * old primary link is revoked.
-     *
-     * > **Note**: each administrator has their own primary invite link,
-     * > and bots by default don't have one.
+     * Get a list of saved star gifts of a user/channel
      *
+     * Note that filters currently only work for channels
      * **Available**: 👤 users only
      *
-     * @param chatId  Chat IDs
      */
-    exportInviteLink(chatId: InputPeerLike): Promise<ChatInviteLink>;
+    getSavedStarGifts(params: {
+        /** Peer to get saved gifts from */
+        owner: InputPeerLike;
+        /** Whether to exclude hidden gifts */
+        excludeHidden?: boolean;
+        /** Whether to exclude publicly visible gifts */
+        excludePublic?: boolean;
+        /** Whether to exclude gifts with unlimited availability */
+        excludeUnlimited?: boolean;
+        /** Whether to exclude unique gifts */
+        excludeUnique?: boolean;
+        /** Whether to exclude gifts that cannot be upgraded (either not limited or already upgraded) */
+        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 */
+        sortByValue?: boolean;
+        /** Offset for pagination */
+        offset?: string;
+        /** Limit for pagination */
+        limit?: number;
+    }): Promise<ArrayPaginated<SavedStarGift, string>>;
     /**
-     * Iterate over users who have joined
-     * the chat with the given invite link.
-     *
+     * Get the list of available star gifts.
      * **Available**: 👤 users only
      *
-     * @param chatId  Chat ID
-     * @param params  Additional params
      */
-    getInviteLinkMembers(chatId: InputPeerLike, params?: {
-        /**
-         * Invite link for which to get members
-         */
-        link?: string | ChatInviteLink;
-        /**
-         * Maximum number of users to return
-         *
-         * @default  100
-         */
-        limit?: number;
-        /**
-         * Offset request/join date used as an anchor for pagination.
-         */
-        offsetDate?: Date | number;
-        /**
-         * Offset user used as an anchor for pagination
-         */
-        offsetUser?: tl.TypeInputUser;
-        /**
-         * Whether to get users who have requested to join
-         * the chat but weren't accepted yet
-         */
-        requested?: boolean;
-        /**
-         * Search for a user in the pending join requests list
-         * (if passed, {@link requested} is assumed to be true)
-         *
-         * Doesn't work when {@link link} is set (Telegram limitation)
-         */
-        requestedSearch?: string;
-    }): Promise<ArrayPaginated<ChatInviteLinkMember, {
-        date: number;
-        user: tl.TypeInputUser;
-    }>>;
+    getStarGiftOptions(): Promise<StarGift[]>;
     /**
-     * Get detailed information about an invite link
-     *
+     * Get a list of all possible attributes when upgrading a given star gift
+     */
+    getStarGiftUpgradeOptions(giftId: tl.Long): Promise<StarGiftUpgradeOptions>;
+    /**
+     * Get the value of a unique star gift
      * **Available**: 👤 users only
      *
-     * @param chatId  Chat ID
-     * @param link  The invite link
      */
-    getInviteLink(chatId: InputPeerLike, link: string): Promise<ChatInviteLink>;
+    getStarGiftValue(params: {
+        /** Slug of the star gift */
+        slug: string;
+    }): Promise<StarGiftValue>;
+    getStarGiftWithdrawalUrl(params: {
+        /** The star gift to withdraw */
+        gift: InputStarGift;
+        /** 2FA password */
+        password: string;
+    }): Promise<string>;
     /**
-     * Get invite links created by some administrator in the chat.
-     *
-     * As an administrator you can only get your own links
-     * (i.e. `adminId = "self"`), as a creator you can get
-     * any other admin's links.
+     * Get information about a unique star gift by its slug
+     * **Available**: 👤 users only
      *
+     */
+    getUniqueStarGift(slug: string): Promise<StarGiftUnique>;
+    /**
+     * Iterate over saved star gifts of a user,
+     * wrapper over {@link getSavedStarGifts}
      * **Available**: 👤 users only
      *
-     * @param chatId  Chat ID
-     * @param adminId  Admin who created the links
-     * @param params
      */
-    getInviteLinks(chatId: InputPeerLike, params?: {
+    iterSavedStarGifts(params: Parameters<typeof getSavedStarGifts>[1] & {
         /**
-         * Only return this admin's links.
+         * Number of gifts to fetch per request
          *
-         * @default `"self"`
-         */
-        admin?: InputPeerLike;
-        /**
-         * Whether to fetch revoked invite links
+         * @default 100
          */
-        revoked?: boolean;
+        chunkSize?: number;
         /**
-         * Limit the number of invite links to be fetched.
+         * Total number of gifts to fetch
          *
-         * @default  100
+         * @default Infinity
          */
         limit?: number;
-        /**
-         * Offset for pagination.
-         */
-        offset?: GetInviteLinksOffset;
-    }): Promise<ArrayPaginated<ChatInviteLink, GetInviteLinksOffset>>;
+    }): AsyncIterableIterator<SavedStarGift>;
     /**
-     * Get primary invite link of a chat
-     *
+     * Toggles whether one or more star gift is pinned to the top of the list
      * **Available**: 👤 users only
      *
-     * @param chatId  Chat ID
      */
-    getPrimaryInviteLink(chatId: InputPeerLike): Promise<ChatInviteLink>;
+    togglePinnedStarGifts(params: {
+        /** One or more gifts to pin */
+        gifts: MaybeArray<InputStarGift>;
+        /** Peer where the gift is sent */
+        peer: InputPeerLike;
+    }): Promise<void>;
     /**
-     * Approve or decline multiple join requests to a chat.
-     * **Available**: 👤 users only
+     * Pay for other user's star gift upgrade.
      *
-     */
-    hideAllJoinRequests(params: {
-        /** Chat/channel ID */
+     * > **Note**: this method is not indended to be used by full-fledged clients,
+     * > as this method hides the actual invoice and payment form from the user.
+     * > For GUI clients, you should refer to the method's source code and
+     * > present the payment form to the user.
+     *
+     * **Available**: 👤 users only
+     *
+     * @returns  Service message about the payment for the upgrade, if one was generated.
+     */
+    prepayStarGiftUpgrade(params: {
+        peer: InputPeerLike;
+        /** Prepaid upgrade hash, taken from `SavedStarGift.prepaidUpgradeHash` */
+        hash: string;
+        /**
+         * Whether to dispatch the new message event
+         * to the client's update handler.
+         */
+        shouldDispatch?: true;
+    }): Promise<Message | null>;
+    /**
+     * Accept or decline a purchase offer for a star gift
+     *
+     * @returns The generated service message
+     */
+    resolveStarGiftOffer(options: {
+        /** ID of the message containing the offer */
+        message: number;
+        /** Whether to accept or decline the offer */
+        action: 'accept' | 'decline';
+        /**
+         * Whether to dispatch the new message event
+         * to the client's update handler.
+         */
+        shouldDispatch?: true;
+    }): Promise<Message>;
+    /**
+     * Create a purchase offer for a unique star gift
+     * @param client
+     * @param params
+     */
+    sendStarGiftOffer(params: {
+        /** ID of the peer to send the offer to */
+        peerId: InputPeerLike;
+        /** Slug of the star gift to create an offer for */
+        slug: string;
+        /** Amount of stars to offer */
+        price: InputStarsAmount;
+        /** Duration of the offer in seconds */
+        duration: number;
+        /** When the recipient has paid messages enabled, the maximum number of stars that you are willing to spend */
+        allowPaidMessages?: tl.Long;
+        /**
+         * Whether to dispatch the new message event
+         * to the client's update handler.
+         */
+        shouldDispatch?: true;
+    }): Promise<Message>;
+    /**
+     * Send a star gift to a user.
+     *
+     * > **Note**: this method is not indended to be used by full-fledged clients,
+     * > as this method hides the actual invoice and payment form from the user.
+     * > For GUI clients, you should refer to the method's source code and
+     * > present the payment form to the user.
+     *
+     * **Available**: 👤 users only
+     *
+     * @returns  Service message about the sent gift, if one was generated.
+     */
+    sendStarGift(params: {
+        /** ID of the peer to send the gift to */
+        peerId: InputPeerLike;
+        /** ID of the gift to send */
+        gift: Long | StarGift;
+        /**
+         * Whether to send the gift anonymously
+         * (i.e. if the recipient chooses to display the gift
+         * on their profile, your name won't be visible)
+         */
+        anonymous?: boolean;
+        /** Message to send along with the gift */
+        message?: InputText;
+        /** Whether to automatically upgrade the gift to a unique star gift */
+        withUpgrade?: boolean;
+        /**
+         * Whether to dispatch the new message event
+         * to the client's update handler.
+         */
+        shouldDispatch?: true;
+    }): Promise<Message | null>;
+    /** Set resale price for an owned star gift */
+    setResaleStarGiftPrice(params: {
+        /** Star gift to update the price of */
+        gift: InputStarGift;
+        /**
+         * New price of the gift (in stars), or `null` to unlist
+         */
+        price: InputStarsAmount | null;
+    }): Promise<void>;
+    /**
+     * Transfer a unique star gift.
+     *
+     * > **Note**: this method is not indended to be used by full-fledged clients,
+     * > as this method hides the actual invoice and payment form from the user.
+     * > For GUI clients, you should refer to the method's source code and
+     * > present the payment form to the user.
+     *
+     * **Available**: 👤 users only
+     *
+     * @returns  Service message about the transferred gift, if one was generated.
+     */
+    transferStarGift(params: {
+        /** Star gift to transfer */
+        gift: InputStarGift;
+        /** ID of the user to transfer the gift to */
+        recipient: InputPeerLike;
+        /**
+         * Whether to dispatch the new message event
+         * to the client's update handler.
+         */
+        shouldDispatch?: true;
+    }): Promise<Message | null>;
+    /**
+     * Upgrades a star gift to a unique gift.
+     *
+     * > **Note**: this method is not indended to be used by full-fledged clients,
+     * > as this method hides the actual invoice and payment form from the user.
+     * > For GUI clients, you should refer to the method's source code and
+     * > present the payment form to the user.
+     *
+     * **Available**: 👤 users only
+     *
+     * @returns  Service message about the upgraded gift, if one was generated.
+     */
+    upgradeStarGift(params: {
+        gift: InputStarGift;
+        /**
+         * Whether to retain the original details of the gift
+         * (like sender, recipient, date, message)
+         */
+        keepOriginalDetails?: boolean;
+        /**
+         * Whether to dispatch the new message event
+         * to the client's update handler.
+         */
+        shouldDispatch?: true;
+    }): Promise<Message | null>;
+    /**
+     * Create an additional invite link for the chat.
+     *
+     * You must be an administrator and have appropriate rights.
+     *
+     * **Available**: 👤 users only
+     *
+     * @param chatId  Chat ID
+     * @param params
+     */
+    createInviteLink(chatId: InputPeerLike, params?: {
+        /**
+         * Date when this link will expire.
+         * If `number` is passed, UNIX time in ms is expected.
+         */
+        expires?: number | Date;
+        /**
+         * Maximum number of users that can be members of this chat
+         * at the same time after joining using this link.
+         *
+         * Integer in range `[1, 99999]` or `Infinity`
+         *
+         * @default  `Infinity`
+         */
+        usageLimit?: number;
+        /**
+         * Whether users to be joined via this link need to be
+         * approved by an admin
+         */
+        withApproval?: boolean;
+        /**
+         * When a pricing plan is passed, this link will become a paid subscription link
+         *
+         * Currently the only allowed `.period` is 1 month, i.e. `2592000`
+         */
+        subscriptionPricing?: tl.TypeStarsSubscriptionPricing;
+    }): Promise<ChatInviteLink>;
+    /**
+     * Edit an invite link. You can only edit non-primary
+     * invite links.
+     *
+     * Only pass the fields that you want to modify.
+     *
+     * **Available**: 👤 users only
+     *
+     * @param chatId  Chat ID
+     * @param link  Invite link to edit
+     * @param params
+     * @returns  Modified invite link
+     */
+    editInviteLink(params: {
+        /** Chat ID */
+        chatId: InputPeerLike;
+        /** Invite link to edit */
+        link: string | ChatInviteLink;
+        /**
+         * Date when this link will expire.
+         * If `number` is passed, UNIX time in ms is expected.
+         */
+        expires?: number | Date;
+        /**
+         * Maximum number of users that can be members of this chat
+         * at the same time after joining using this link.
+         *
+         * Integer in range `[1, 99999]` or `Infinity`,
+         */
+        usageLimit?: number;
+        /**
+         * Whether users to be joined via this link need to be
+         * approved by an admin
+         */
+        withApproval?: boolean;
+    }): Promise<ChatInviteLink>;
+    /**
+     * Generate a new primary invite link for a chat,
+     * old primary link is revoked.
+     *
+     * > **Note**: each administrator has their own primary invite link,
+     * > and bots by default don't have one.
+     *
+     * **Available**: 👤 users only
+     *
+     * @param chatId  Chat IDs
+     */
+    exportInviteLink(chatId: InputPeerLike): Promise<ChatInviteLink>;
+    /**
+     * Iterate over users who have joined
+     * the chat with the given invite link.
+     *
+     * **Available**: 👤 users only
+     *
+     * @param chatId  Chat ID
+     * @param params  Additional params
+     */
+    getInviteLinkMembers(chatId: InputPeerLike, params?: {
+        /**
+         * Invite link for which to get members
+         */
+        link?: string | ChatInviteLink;
+        /**
+         * Maximum number of users to return
+         *
+         * @default  100
+         */
+        limit?: number;
+        /**
+         * Offset request/join date used as an anchor for pagination.
+         */
+        offsetDate?: Date | number;
+        /**
+         * Offset user used as an anchor for pagination
+         */
+        offsetUser?: tl.TypeInputUser;
+        /**
+         * Whether to get users who have requested to join
+         * the chat but weren't accepted yet
+         */
+        requested?: boolean;
+        /**
+         * Search for a user in the pending join requests list
+         * (if passed, {@link requested} is assumed to be true)
+         *
+         * Doesn't work when {@link link} is set (Telegram limitation)
+         */
+        requestedSearch?: string;
+    }): Promise<ArrayPaginated<ChatInviteLinkMember, {
+        date: number;
+        user: tl.TypeInputUser;
+    }>>;
+    /**
+     * Get detailed information about an invite link
+     *
+     * **Available**: 👤 users only
+     *
+     * @param chatId  Chat ID
+     * @param link  The invite link
+     */
+    getInviteLink(chatId: InputPeerLike, link: string): Promise<ChatInviteLink>;
+    /**
+     * Get invite links created by some administrator in the chat.
+     *
+     * As an administrator you can only get your own links
+     * (i.e. `adminId = "self"`), as a creator you can get
+     * any other admin's links.
+     *
+     * **Available**: 👤 users only
+     *
+     * @param chatId  Chat ID
+     * @param adminId  Admin who created the links
+     * @param params
+     */
+    getInviteLinks(chatId: InputPeerLike, params?: {
+        /**
+         * Only return this admin's links.
+         *
+         * @default `"self"`
+         */
+        admin?: InputPeerLike;
+        /**
+         * Whether to fetch revoked invite links
+         */
+        revoked?: boolean;
+        /**
+         * Limit the number of invite links to be fetched.
+         *
+         * @default  100
+         */
+        limit?: number;
+        /**
+         * Offset for pagination.
+         */
+        offset?: GetInviteLinksOffset;
+    }): Promise<ArrayPaginated<ChatInviteLink, GetInviteLinksOffset>>;
+    /**
+     * Get primary invite link of a chat
+     *
+     * **Available**: 👤 users only
+     *
+     * @param chatId  Chat ID
+     */
+    getPrimaryInviteLink(chatId: InputPeerLike): Promise<ChatInviteLink>;
+    /**
+     * Approve or decline multiple join requests to a chat.
+     * **Available**: 👤 users only
+     *
+     */
+    hideAllJoinRequests(params: {
+        /** Chat/channel ID */
         chatId: InputPeerLike;
         /** Whether to approve or decline the join requests */
         action: 'approve' | 'decline';
@@ -3902,36 +4231,17 @@ export interface TelegramClient extends ITelegramClient {
     /**
      * Cancel the code that was sent to verify an email to use as 2FA recovery method
      * **Available**: 👤 users only
-     *
-     */
-    cancelPasswordEmail(): Promise<void>;
-    /**
-     * Remove 2FA password from your account
-     *
-     * **Available**: 👤 users only
-     *
-     * @param password  2FA password as plaintext
-     */
-    removeCloudPassword(password: string): Promise<void>;
-    _normalizeInputStarGift(gift: InputStarGift): Promise<tl.TypeInputSavedStarGift>;
-    /**
-     * Accept, hide or convert a star gift.
-     *
-     * **Available**: 👤 users only
-     *
-     * @returns  Whether the action was successful
-     */
-    acceptStarGift(params: {
-        /** Input star gift to accept */
-        gift: InputStarGift;
-        /**
-         * Action to perform on the gift.
-         *  - `save` - save the gift to your profile
-         *  - `hide` - hide the gift from your profile
-         *  - `convert` - convert the gift to stars (can't be undone)
-         */
-        action: 'save' | 'hide' | 'convert';
-    }): Promise<boolean>;
+     *
+     */
+    cancelPasswordEmail(): Promise<void>;
+    /**
+     * Remove 2FA password from your account
+     *
+     * **Available**: 👤 users only
+     *
+     * @param password  2FA password as plaintext
+     */
+    removeCloudPassword(password: string): Promise<void>;
     /**
      * Boost a given channel
      *
@@ -3940,19 +4250,6 @@ export interface TelegramClient extends ITelegramClient {
      * @param peerId  Peer ID to boost
      */
     applyBoost(peerId: InputPeerLike): Promise<void>;
-    buyResaleGift(params: {
-        /** Slug of the star gift to buy */
-        slug: string;
-        /** ID of the user to buy the gift for */
-        recipient: InputPeerLike;
-        /**
-         * Whether to dispatch the new message event
-         * to the client's update handler.
-         */
-        shouldDispatch?: true;
-        /** Whether to use TON currency for payment */
-        ton?: boolean;
-    }): Promise<Message | null>;
     /**
      * Check if the current user can apply boost to some channel
      *
@@ -4048,90 +4345,6 @@ export interface TelegramClient extends ITelegramClient {
      *
      */
     getMyBoostSlots(): Promise<BoostSlot[]>;
-    /**
-     * Get a list of star gifts up for resale
-     * **Available**: 👤 users only
-     *
-     */
-    getStarGiftResaleOptions(params: {
-        /** ID of the gift to get resale options for */
-        giftId: tl.Long;
-        /**
-         * Sorting attribute
-         *
-         * - `price`: Sort by price
-         * - `num`: Sort by its unique number
-         */
-        sort?: 'price' | 'num';
-        /**
-         * Hash of the `attributes` field, as returned by the server in the first response
-         */
-        attributesHash?: Long;
-        /** Attributes to filter for */
-        attributes?: tl.TypeStarGiftAttributeId[] | InputStarGiftAttributeIds;
-        /** Offset for pagination */
-        offset?: string;
-        /** Limit for pagination */
-        limit?: number;
-    }): Promise<ArrayPaginatedWithMeta<StarGiftUnique, string, ResaleStarGiftsMeta>>;
-    /** Get one or more saved star gifts by their IDs */
-    getSavedStarGiftsById(gifts: MaybeArray<InputStarGift>): Promise<SavedStarGift[]>;
-    /**
-     * Get a list of saved star gifts of a user/channel
-     *
-     * Note that filters currently only work for channels
-     * **Available**: 👤 users only
-     *
-     */
-    getSavedStarGifts(params: {
-        /** Peer to get saved gifts from */
-        owner: InputPeerLike;
-        /** Whether to exclude hidden gifts */
-        excludeHidden?: boolean;
-        /** Whether to exclude publicly visible gifts */
-        excludePublic?: boolean;
-        /** Whether to exclude gifts with unlimited availability */
-        excludeUnlimited?: boolean;
-        /** Whether to exclude unique gifts */
-        excludeUnique?: boolean;
-        /** Whether to exclude gifts that cannot be upgraded (either not limited or already upgraded) */
-        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 */
-        sortByValue?: boolean;
-        /** Offset for pagination */
-        offset?: string;
-        /** Limit for pagination */
-        limit?: number;
-    }): Promise<ArrayPaginated<SavedStarGift, string>>;
-    /**
-     * Get the list of available star gifts.
-     * **Available**: 👤 users only
-     *
-     */
-    getStarGiftOptions(): Promise<StarGift[]>;
-    /**
-     * Get the value of a unique star gift
-     * **Available**: 👤 users only
-     *
-     */
-    getStarGiftValue(params: {
-        /** Slug of the star gift */
-        slug: string;
-    }): Promise<StarGiftValue>;
-    getStarGiftWithdrawalUrl(params: {
-        /** The star gift to withdraw */
-        gift: InputStarGift;
-        /** 2FA password */
-        password: string;
-    }): Promise<string>;
     /**
      * Get Telegram Stars transactions for a given peer.
      *
@@ -4167,12 +4380,6 @@ export interface TelegramClient extends ITelegramClient {
          */
         limit?: number;
     }): Promise<StarsStatus>;
-    /**
-     * Get information about a unique star gift by its slug
-     * **Available**: 👤 users only
-     *
-     */
-    getUniqueStarGift(slug: string): Promise<StarGiftUnique>;
     /**
      * Iterate over boosters of a channel.
      *
@@ -4195,26 +4402,6 @@ export interface TelegramClient extends ITelegramClient {
          */
         chunkSize?: number;
     }): AsyncIterableIterator<Boost>;
-    /**
-     * Iterate over saved star gifts of a user,
-     * wrapper over {@link getSavedStarGifts}
-     * **Available**: 👤 users only
-     *
-     */
-    iterSavedStarGifts(params: Parameters<typeof getSavedStarGifts>[1] & {
-        /**
-         * Number of gifts to fetch per request
-         *
-         * @default 100
-         */
-        chunkSize?: number;
-        /**
-         * Total number of gifts to fetch
-         *
-         * @default Infinity
-         */
-        limit?: number;
-    }): AsyncIterableIterator<SavedStarGift>;
     /**
      * Iterate over Telegram Stars transactions for a given peer.
      *
@@ -4243,72 +4430,6 @@ export interface TelegramClient extends ITelegramClient {
          */
         chunkSize?: number;
     }): AsyncIterableIterator<StarsTransaction>;
-    /**
-     * Toggles whether one or more star gift is pinned to the top of the list
-     * **Available**: 👤 users only
-     *
-     */
-    togglePinnedStarGifts(params: {
-        /** One or more gifts to pin */
-        gifts: MaybeArray<InputStarGift>;
-        /** Peer where the gift is sent */
-        peer: InputPeerLike;
-    }): Promise<void>;
-    /**
-     * Pay for other user's star gift upgrade.
-     *
-     * > **Note**: this method is not indended to be used by full-fledged clients,
-     * > as this method hides the actual invoice and payment form from the user.
-     * > For GUI clients, you should refer to the method's source code and
-     * > present the payment form to the user.
-     *
-     * **Available**: 👤 users only
-     *
-     * @returns  Service message about the payment for the upgrade, if one was generated.
-     */
-    prepayStarGiftUpgrade(params: {
-        peer: InputPeerLike;
-        /** Prepaid upgrade hash, taken from `SavedStarGift.prepaidUpgradeHash` */
-        hash: string;
-        /**
-         * Whether to dispatch the new message event
-         * to the client's update handler.
-         */
-        shouldDispatch?: true;
-    }): Promise<Message | null>;
-    /**
-     * Send a star gift to a user.
-     *
-     * > **Note**: this method is not indended to be used by full-fledged clients,
-     * > as this method hides the actual invoice and payment form from the user.
-     * > For GUI clients, you should refer to the method's source code and
-     * > present the payment form to the user.
-     *
-     * **Available**: 👤 users only
-     *
-     * @returns  Service message about the sent gift, if one was generated.
-     */
-    sendStarGift(params: {
-        /** ID of the peer to send the gift to */
-        peerId: InputPeerLike;
-        /** ID of the gift to send */
-        gift: Long | StarGift;
-        /**
-         * Whether to send the gift anonymously
-         * (i.e. if the recipient chooses to display the gift
-         * on their profile, your name won't be visible)
-         */
-        anonymous?: boolean;
-        /** Message to send along with the gift */
-        message?: InputText;
-        /** Whether to automatically upgrade the gift to a unique star gift */
-        withUpgrade?: boolean;
-        /**
-         * Whether to dispatch the new message event
-         * to the client's update handler.
-         */
-        shouldDispatch?: true;
-    }): Promise<Message | null>;
     /**
      * Set current user's business introduction.
      *
@@ -4347,63 +4468,6 @@ export interface TelegramClient extends ITelegramClient {
         /** Business work intervals, raw intervals */
         intervals: tl.TypeBusinessWeeklyOpen[];
     })) | null): Promise<void>;
-    /** Set resale price for an owned star gift */
-    setResaleStarGiftPrice(params: {
-        /** Star gift to update the price of */
-        gift: InputStarGift;
-        /**
-         * New price of the gift (in stars), or `null` to unlist
-         */
-        price: tl.Long | number | tl.TypeStarsAmount | null;
-    }): Promise<void>;
-    /**
-     * Transfer a unique star gift.
-     *
-     * > **Note**: this method is not indended to be used by full-fledged clients,
-     * > as this method hides the actual invoice and payment form from the user.
-     * > For GUI clients, you should refer to the method's source code and
-     * > present the payment form to the user.
-     *
-     * **Available**: 👤 users only
-     *
-     * @returns  Service message about the transferred gift, if one was generated.
-     */
-    transferStarGift(params: {
-        /** Star gift to transfer */
-        gift: InputStarGift;
-        /** ID of the user to transfer the gift to */
-        recipient: InputPeerLike;
-        /**
-         * Whether to dispatch the new message event
-         * to the client's update handler.
-         */
-        shouldDispatch?: true;
-    }): Promise<Message | null>;
-    /**
-     * Upgrades a star gift to a unique gift.
-     *
-     * > **Note**: this method is not indended to be used by full-fledged clients,
-     * > as this method hides the actual invoice and payment form from the user.
-     * > For GUI clients, you should refer to the method's source code and
-     * > present the payment form to the user.
-     *
-     * **Available**: 👤 users only
-     *
-     * @returns  Service message about the upgraded gift, if one was generated.
-     */
-    upgradeStarGift(params: {
-        gift: InputStarGift;
-        /**
-         * Whether to retain the original details of the gift
-         * (like sender, recipient, date, message)
-         */
-        keepOriginalDetails?: boolean;
-        /**
-         * Whether to dispatch the new message event
-         * to the client's update handler.
-         */
-        shouldDispatch?: true;
-    }): Promise<Message | null>;
     /**
      * Add a sticker to a sticker set.
      *