@mtcute/core 0.27.2 → 0.27.3

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';
@@ -2378,6 +2380,313 @@ export interface TelegramClient extends ITelegramClient {
          */
         shouldDispatch?: true;
     }): Promise<Message>;
+    _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>;
+    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>;
+    /**
+     * 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 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
+     *
+     */
+    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 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
+     *
+     */
+    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>;
+    /**
+     * 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>;
+    /**
+     * 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.
      *
@@ -3902,36 +4211,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 +4230,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 +4325,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 +4360,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 +4382,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 +4410,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 +4448,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.
      *