@mtcute/core 0.19.7 → 0.20.0

package/client.cjs

@@ -186,6 +186,7 @@ const changeCloudPassword = require("./highlevel/methods/password/change-cloud-p
 const enableCloudPassword = require("./highlevel/methods/password/enable-cloud-password.cjs");
 const passwordEmail = require("./highlevel/methods/password/password-email.cjs");
 const removeCloudPassword = require("./highlevel/methods/password/remove-cloud-password.cjs");
+const _normalizeInputStarGift = require("./highlevel/methods/premium/_normalize-input-star-gift.cjs");
 const acceptStarGift = require("./highlevel/methods/premium/accept-star-gift.cjs");
 const applyBoost = require("./highlevel/methods/premium/apply-boost.cjs");
 const canApplyBoost = require("./highlevel/methods/premium/can-apply-boost.cjs");
@@ -196,10 +197,15 @@ const getBoosts = require("./highlevel/methods/premium/get-boosts.cjs");
 const getBusinessChatLinks = require("./highlevel/methods/premium/get-business-chat-links.cjs");
 const getBusinessConnection = require("./highlevel/methods/premium/get-business-connection.cjs");
 const getMyBoostSlots = require("./highlevel/methods/premium/get-my-boost-slots.cjs");
+const getSavedStarGiftsById = require("./highlevel/methods/premium/get-saved-star-gifts-by-id.cjs");
+const getSavedStarGifts = require("./highlevel/methods/premium/get-saved-star-gifts.cjs");
 const getStarGiftOptions = require("./highlevel/methods/premium/get-star-gift-options.cjs");
+const getStarGiftWithdrawalUrl = require("./highlevel/methods/premium/get-star-gift-withdrawal-url.cjs");
 const getStarGifts = require("./highlevel/methods/premium/get-star-gifts.cjs");
 const getStarsTransactions = require("./highlevel/methods/premium/get-stars-transactions.cjs");
+const getUniqueStarGift = require("./highlevel/methods/premium/get-unique-star-gift.cjs");
 const iterBoosters = require("./highlevel/methods/premium/iter-boosters.cjs");
+const iterSavedStarGifts = require("./highlevel/methods/premium/iter-saved-star-gifts.cjs");
 const iterStarGifts = require("./highlevel/methods/premium/iter-star-gifts.cjs");
 const iterStarsTransactions = require("./highlevel/methods/premium/iter-stars-transactions.cjs");
 const sendStarGift = require("./highlevel/methods/premium/send-star-gift.cjs");
@@ -1012,6 +1018,9 @@ TelegramClient.prototype.cancelPasswordEmail = function(...args) {
 TelegramClient.prototype.removeCloudPassword = function(...args) {
   return removeCloudPassword.removeCloudPassword(this._client, ...args);
 };
+TelegramClient.prototype._normalizeInputStarGift = function(...args) {
+  return _normalizeInputStarGift._normalizeInputStarGift(this._client, ...args);
+};
 TelegramClient.prototype.acceptStarGift = function(...args) {
   return acceptStarGift.acceptStarGift(this._client, ...args);
 };
@@ -1045,18 +1054,33 @@ TelegramClient.prototype.getBusinessConnection = function(...args) {
 TelegramClient.prototype.getMyBoostSlots = function(...args) {
   return getMyBoostSlots.getMyBoostSlots(this._client, ...args);
 };
+TelegramClient.prototype.getSavedStarGiftsById = function(...args) {
+  return getSavedStarGiftsById.getSavedStarGiftsById(this._client, ...args);
+};
+TelegramClient.prototype.getSavedStarGifts = function(...args) {
+  return getSavedStarGifts.getSavedStarGifts(this._client, ...args);
+};
 TelegramClient.prototype.getStarGiftOptions = function(...args) {
   return getStarGiftOptions.getStarGiftOptions(this._client, ...args);
 };
+TelegramClient.prototype.getStarGiftWithdrawalUrl = function(...args) {
+  return getStarGiftWithdrawalUrl.getStarGiftWithdrawalUrl(this._client, ...args);
+};
 TelegramClient.prototype.getStarGifts = function(...args) {
   return getStarGifts.getStarGifts(this._client, ...args);
 };
 TelegramClient.prototype.getStarsTransactions = function(...args) {
   return getStarsTransactions.getStarsTransactions(this._client, ...args);
 };
+TelegramClient.prototype.getUniqueStarGift = function(...args) {
+  return getUniqueStarGift.getUniqueStarGift(this._client, ...args);
+};
 TelegramClient.prototype.iterBoosters = function(...args) {
   return iterBoosters.iterBoosters(this._client, ...args);
 };
+TelegramClient.prototype.iterSavedStarGifts = function(...args) {
+  return iterSavedStarGifts.iterSavedStarGifts(this._client, ...args);
+};
 TelegramClient.prototype.iterStarGifts = function(...args) {
   return iterStarGifts.iterStarGifts(this._client, ...args);
 };

package/client.js

@@ -179,6 +179,7 @@ import { changeCloudPassword } from "./highlevel/methods/password/change-cloud-p
 import { enableCloudPassword } from "./highlevel/methods/password/enable-cloud-password.js";
 import { verifyPasswordEmail, resendPasswordEmail, cancelPasswordEmail } from "./highlevel/methods/password/password-email.js";
 import { removeCloudPassword } from "./highlevel/methods/password/remove-cloud-password.js";
+import { _normalizeInputStarGift } from "./highlevel/methods/premium/_normalize-input-star-gift.js";
 import { acceptStarGift } from "./highlevel/methods/premium/accept-star-gift.js";
 import { applyBoost } from "./highlevel/methods/premium/apply-boost.js";
 import { canApplyBoost } from "./highlevel/methods/premium/can-apply-boost.js";
@@ -189,10 +190,15 @@ import { getBoosts } from "./highlevel/methods/premium/get-boosts.js";
 import { getBusinessChatLinks } from "./highlevel/methods/premium/get-business-chat-links.js";
 import { getBusinessConnection } from "./highlevel/methods/premium/get-business-connection.js";
 import { getMyBoostSlots } from "./highlevel/methods/premium/get-my-boost-slots.js";
+import { getSavedStarGiftsById } from "./highlevel/methods/premium/get-saved-star-gifts-by-id.js";
+import { getSavedStarGifts } from "./highlevel/methods/premium/get-saved-star-gifts.js";
 import { getStarGiftOptions } from "./highlevel/methods/premium/get-star-gift-options.js";
+import { getStarGiftWithdrawalUrl } from "./highlevel/methods/premium/get-star-gift-withdrawal-url.js";
 import { getStarGifts } from "./highlevel/methods/premium/get-star-gifts.js";
 import { getStarsTransactions } from "./highlevel/methods/premium/get-stars-transactions.js";
+import { getUniqueStarGift } from "./highlevel/methods/premium/get-unique-star-gift.js";
 import { iterBoosters } from "./highlevel/methods/premium/iter-boosters.js";
+import { iterSavedStarGifts } from "./highlevel/methods/premium/iter-saved-star-gifts.js";
 import { iterStarGifts } from "./highlevel/methods/premium/iter-star-gifts.js";
 import { iterStarsTransactions } from "./highlevel/methods/premium/iter-stars-transactions.js";
 import { sendStarGift } from "./highlevel/methods/premium/send-star-gift.js";
@@ -1005,6 +1011,9 @@ TelegramClient.prototype.cancelPasswordEmail = function(...args) {
 TelegramClient.prototype.removeCloudPassword = function(...args) {
   return removeCloudPassword(this._client, ...args);
 };
+TelegramClient.prototype._normalizeInputStarGift = function(...args) {
+  return _normalizeInputStarGift(this._client, ...args);
+};
 TelegramClient.prototype.acceptStarGift = function(...args) {
   return acceptStarGift(this._client, ...args);
 };
@@ -1038,18 +1047,33 @@ TelegramClient.prototype.getBusinessConnection = function(...args) {
 TelegramClient.prototype.getMyBoostSlots = function(...args) {
   return getMyBoostSlots(this._client, ...args);
 };
+TelegramClient.prototype.getSavedStarGiftsById = function(...args) {
+  return getSavedStarGiftsById(this._client, ...args);
+};
+TelegramClient.prototype.getSavedStarGifts = function(...args) {
+  return getSavedStarGifts(this._client, ...args);
+};
 TelegramClient.prototype.getStarGiftOptions = function(...args) {
   return getStarGiftOptions(this._client, ...args);
 };
+TelegramClient.prototype.getStarGiftWithdrawalUrl = function(...args) {
+  return getStarGiftWithdrawalUrl(this._client, ...args);
+};
 TelegramClient.prototype.getStarGifts = function(...args) {
   return getStarGifts(this._client, ...args);
 };
 TelegramClient.prototype.getStarsTransactions = function(...args) {
   return getStarsTransactions(this._client, ...args);
 };
+TelegramClient.prototype.getUniqueStarGift = function(...args) {
+  return getUniqueStarGift(this._client, ...args);
+};
 TelegramClient.prototype.iterBoosters = function(...args) {
   return iterBoosters(this._client, ...args);
 };
+TelegramClient.prototype.iterSavedStarGifts = function(...args) {
+  return iterSavedStarGifts(this._client, ...args);
+};
 TelegramClient.prototype.iterStarGifts = function(...args) {
   return iterStarGifts(this._client, ...args);
 };

package/highlevel/base.cjs

@@ -125,8 +125,8 @@ class BaseTelegramClient {
   async notifyLoggedIn(auth) {
     const user = this.mt.network.notifyLoggedIn(auth);
     this.log.prefix = `[USER ${user.id}] `;
-    const self = await this.storage.self.storeFrom(user);
-    this.updates?.notifyLoggedIn(self);
+    await this.storage.self.storeFrom(user);
+    this.updates?.notifyLoggedIn();
     return user;
   }
   async notifyLoggedOut() {

package/highlevel/base.js

@@ -118,8 +118,8 @@ class BaseTelegramClient {
   async notifyLoggedIn(auth) {
     const user = this.mt.network.notifyLoggedIn(auth);
     this.log.prefix = `[USER ${user.id}] `;
-    const self = await this.storage.self.storeFrom(user);
-    this.updates?.notifyLoggedIn(self);
+    await this.storage.self.storeFrom(user);
+    this.updates?.notifyLoggedIn();
     return user;
   }
   async notifyLoggedOut() {

package/highlevel/client.d.cts

@@ -23,7 +23,7 @@ import { QuoteParamsFrom } from './methods/messages/send-quote.js';
 import { CanApplyBoostResult } from './methods/premium/can-apply-boost.js';
 import { CanSendStoryResult } from './methods/stories/can-send-story.js';
 import { ITelegramStorageProvider } from './storage/provider.js';
-import { AllStories, ArrayPaginated, ArrayWithTotal, 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, InputFileLike, InputInlineResult, InputMediaLike, InputMediaSticker, InputMessageId, InputPeerLike, InputPrivacyRule, InputReaction, InputStickerSet, InputStickerSetItem, InputText, InputWebview, MaybeDynamic, Message, MessageEffect, MessageMedia, MessageReactions, ParametersSkip2, ParsedUpdate, PeerReaction, PeerStories, Photo, Poll, PollUpdate, PollVoteUpdate, PreCheckoutQuery, RawDocument, ReplyMarkup, SentCode, StarGift, StarsStatus, StarsTransaction, Sticker, StickerSet, StickerType, StoriesStealthMode, Story, StoryInteractions, StoryUpdate, StoryViewer, StoryViewersList, TakeoutSession, TextWithEntities, TypingStatus, UploadedFile, UploadFileLike, User, UserStarGift, UserStatusUpdate, UserTypingUpdate, WebviewResult } from './types/index.js';
+import { AllStories, ArrayPaginated, ArrayWithTotal, 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, InputFileLike, InputInlineResult, InputMediaLike, InputMediaSticker, InputMessageId, InputPeerLike, InputPrivacyRule, InputReaction, InputStarGift, InputStickerSet, InputStickerSetItem, InputText, InputWebview, MaybeDynamic, Message, MessageEffect, MessageMedia, MessageReactions, ParametersSkip2, ParsedUpdate, PeerReaction, PeerStories, Photo, Poll, PollUpdate, PollVoteUpdate, PreCheckoutQuery, RawDocument, ReplyMarkup, SavedStarGift, SentCode, StarGift, StarGiftUnique, StarsStatus, StarsTransaction, Sticker, StickerSet, StickerType, StoriesStealthMode, Story, StoryInteractions, StoryUpdate, StoryViewer, StoryViewersList, TakeoutSession, TextWithEntities, TypingStatus, UploadedFile, UploadFileLike, User, UserStarGift, UserStatusUpdate, UserTypingUpdate, WebviewResult } from './types/index.js';
 import { ParsedUpdateHandlerParams } from './updates/parsed.js';
 import { RawUpdateInfo } from './updates/types.js';
 import { InputStringSessionData } from './utils/string-session.js';
@@ -3818,6 +3818,7 @@ export interface TelegramClient extends ITelegramClient {
      * @param password  2FA password as plaintext
      */
     removeCloudPassword(password: string): Promise<void>;
+    _normalizeInputStarGift(gift: InputStarGift): Promise<tl.TypeInputSavedStarGift>;
     /**
      * Accept, hide or convert a star gift.
      *
@@ -3826,8 +3827,8 @@ export interface TelegramClient extends ITelegramClient {
      * @returns  Whether the action was successful
      */
     acceptStarGift(params: {
-        /** ID of the message containing the gift */
-        message: number | Message;
+        /** Input star gift to accept */
+        gift: InputStarGift;
         /**
          * Action to perform on the gift.
          *  - `save` - save the gift to your profile
@@ -3939,12 +3940,41 @@ export interface TelegramClient extends ITelegramClient {
      *
      */
     getMyBoostSlots(): Promise<BoostSlot[]>;
+    /** 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 */
+    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 gifts with limited availability */
+        excludeLimited?: boolean;
+        /** Whether to exclude unique gifts */
+        excludeUnique?: boolean;
+        /** 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[]>;
+    getStarGiftWithdrawalUrl(params: {
+        /** The star gift to withdraw */
+        gift: InputStarGift;
+        /** 2FA password */
+        password: string;
+    }): Promise<string>;
     /**
      * Get a list of gifts sent to a user.
      *
@@ -3998,6 +4028,10 @@ export interface TelegramClient extends ITelegramClient {
          */
         limit?: number;
     }): Promise<StarsStatus>;
+    /**
+     * Get information about a unique star gift by its slug
+     */
+    getUniqueStarGift(slug: string): Promise<StarGiftUnique>;
     /**
      * Iterate over boosters of a channel.
      *
@@ -4020,6 +4054,30 @@ export interface TelegramClient extends ITelegramClient {
          */
         chunkSize?: number;
     }): AsyncIterableIterator<Boost>;
+    /**
+     * Iterate over saved star gifts of a user,
+     * wrapper over {@link getSavedStarGifts}
+     */
+    iterSavedStarGifts(params: {
+        /** Peer to get saved gifts from */
+        owner: InputPeerLike;
+        /** Whether to exclude unsaved gifts */
+        excludeUnsaved?: boolean;
+        /** Whether to exclude saved gifts */
+        excludeSaved?: boolean;
+        /** Whether to exclude gifts with unlimited availability */
+        excludeUnlimited?: boolean;
+        /** Whether to exclude gifts with limited availability */
+        excludeLimited?: boolean;
+        /** Whether to exclude unique gifts */
+        excludeUnique?: boolean;
+        /** Whether to sort by value */
+        sortByValue?: boolean;
+        /** Offset for pagination */
+        offset?: string;
+        /** Limit for pagination */
+        limit?: number;
+    }): AsyncIterableIterator<SavedStarGift>;
     /**
      * Iterate over gifts sent to a given user.
      *
@@ -4086,8 +4144,8 @@ export interface TelegramClient extends ITelegramClient {
      * @returns  Service message about the sent gift
      */
     sendStarGift(params: {
-        /** ID of the user to send the gift to */
-        userId: InputPeerLike;
+        /** ID of the peer to send the gift to */
+        peerId: InputPeerLike;
         /** ID of the gift to send */
         gift: Long | StarGift;
         /**
@@ -4157,8 +4215,8 @@ export interface TelegramClient extends ITelegramClient {
      * @returns  Service message about the transferred gift
      */
     transferStarGift(params: {
-        /** ID of the message containing the gift */
-        message: number | Message;
+        /** Star gift to transfer */
+        gift: InputStarGift;
         /** ID of the user to transfer the gift to */
         recepient: InputPeerLike;
         /**
@@ -4180,8 +4238,7 @@ export interface TelegramClient extends ITelegramClient {
      * @returns  Service message about the upgraded gift
      */
     upgradeStarGift(params: {
-        /** ID of the message containing the gift */
-        message: number | Message;
+        gift: InputStarGift;
         /**
          * Whether to retain the original details of the gift
          * (like sender, recipient, date, message)
@@ -4993,6 +5050,8 @@ export interface TelegramClient extends ITelegramClient {
         peerId: InputPeerLike;
         /** Custom emoji ID or `null` to remove the emoji */
         emoji: tl.Long | null;
+        /** When true, `emoji` is the ID of the collectible emoji */
+        isCollectible?: boolean;
         /**
          * Date when the emoji status should expire (only if `emoji` is not `null`)
          */

package/highlevel/client.d.ts

@@ -23,7 +23,7 @@ import { QuoteParamsFrom } from './methods/messages/send-quote.js';
 import { CanApplyBoostResult } from './methods/premium/can-apply-boost.js';
 import { CanSendStoryResult } from './methods/stories/can-send-story.js';
 import { ITelegramStorageProvider } from './storage/provider.js';
-import { AllStories, ArrayPaginated, ArrayWithTotal, 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, InputFileLike, InputInlineResult, InputMediaLike, InputMediaSticker, InputMessageId, InputPeerLike, InputPrivacyRule, InputReaction, InputStickerSet, InputStickerSetItem, InputText, InputWebview, MaybeDynamic, Message, MessageEffect, MessageMedia, MessageReactions, ParametersSkip2, ParsedUpdate, PeerReaction, PeerStories, Photo, Poll, PollUpdate, PollVoteUpdate, PreCheckoutQuery, RawDocument, ReplyMarkup, SentCode, StarGift, StarsStatus, StarsTransaction, Sticker, StickerSet, StickerType, StoriesStealthMode, Story, StoryInteractions, StoryUpdate, StoryViewer, StoryViewersList, TakeoutSession, TextWithEntities, TypingStatus, UploadedFile, UploadFileLike, User, UserStarGift, UserStatusUpdate, UserTypingUpdate, WebviewResult } from './types/index.js';
+import { AllStories, ArrayPaginated, ArrayWithTotal, 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, InputFileLike, InputInlineResult, InputMediaLike, InputMediaSticker, InputMessageId, InputPeerLike, InputPrivacyRule, InputReaction, InputStarGift, InputStickerSet, InputStickerSetItem, InputText, InputWebview, MaybeDynamic, Message, MessageEffect, MessageMedia, MessageReactions, ParametersSkip2, ParsedUpdate, PeerReaction, PeerStories, Photo, Poll, PollUpdate, PollVoteUpdate, PreCheckoutQuery, RawDocument, ReplyMarkup, SavedStarGift, SentCode, StarGift, StarGiftUnique, StarsStatus, StarsTransaction, Sticker, StickerSet, StickerType, StoriesStealthMode, Story, StoryInteractions, StoryUpdate, StoryViewer, StoryViewersList, TakeoutSession, TextWithEntities, TypingStatus, UploadedFile, UploadFileLike, User, UserStarGift, UserStatusUpdate, UserTypingUpdate, WebviewResult } from './types/index.js';
 import { ParsedUpdateHandlerParams } from './updates/parsed.js';
 import { RawUpdateInfo } from './updates/types.js';
 import { InputStringSessionData } from './utils/string-session.js';
@@ -3818,6 +3818,7 @@ export interface TelegramClient extends ITelegramClient {
      * @param password  2FA password as plaintext
      */
     removeCloudPassword(password: string): Promise<void>;
+    _normalizeInputStarGift(gift: InputStarGift): Promise<tl.TypeInputSavedStarGift>;
     /**
      * Accept, hide or convert a star gift.
      *
@@ -3826,8 +3827,8 @@ export interface TelegramClient extends ITelegramClient {
      * @returns  Whether the action was successful
      */
     acceptStarGift(params: {
-        /** ID of the message containing the gift */
-        message: number | Message;
+        /** Input star gift to accept */
+        gift: InputStarGift;
         /**
          * Action to perform on the gift.
          *  - `save` - save the gift to your profile
@@ -3939,12 +3940,41 @@ export interface TelegramClient extends ITelegramClient {
      *
      */
     getMyBoostSlots(): Promise<BoostSlot[]>;
+    /** 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 */
+    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 gifts with limited availability */
+        excludeLimited?: boolean;
+        /** Whether to exclude unique gifts */
+        excludeUnique?: boolean;
+        /** 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[]>;
+    getStarGiftWithdrawalUrl(params: {
+        /** The star gift to withdraw */
+        gift: InputStarGift;
+        /** 2FA password */
+        password: string;
+    }): Promise<string>;
     /**
      * Get a list of gifts sent to a user.
      *
@@ -3998,6 +4028,10 @@ export interface TelegramClient extends ITelegramClient {
          */
         limit?: number;
     }): Promise<StarsStatus>;
+    /**
+     * Get information about a unique star gift by its slug
+     */
+    getUniqueStarGift(slug: string): Promise<StarGiftUnique>;
     /**
      * Iterate over boosters of a channel.
      *
@@ -4020,6 +4054,30 @@ export interface TelegramClient extends ITelegramClient {
          */
         chunkSize?: number;
     }): AsyncIterableIterator<Boost>;
+    /**
+     * Iterate over saved star gifts of a user,
+     * wrapper over {@link getSavedStarGifts}
+     */
+    iterSavedStarGifts(params: {
+        /** Peer to get saved gifts from */
+        owner: InputPeerLike;
+        /** Whether to exclude unsaved gifts */
+        excludeUnsaved?: boolean;
+        /** Whether to exclude saved gifts */
+        excludeSaved?: boolean;
+        /** Whether to exclude gifts with unlimited availability */
+        excludeUnlimited?: boolean;
+        /** Whether to exclude gifts with limited availability */
+        excludeLimited?: boolean;
+        /** Whether to exclude unique gifts */
+        excludeUnique?: boolean;
+        /** Whether to sort by value */
+        sortByValue?: boolean;
+        /** Offset for pagination */
+        offset?: string;
+        /** Limit for pagination */
+        limit?: number;
+    }): AsyncIterableIterator<SavedStarGift>;
     /**
      * Iterate over gifts sent to a given user.
      *
@@ -4086,8 +4144,8 @@ export interface TelegramClient extends ITelegramClient {
      * @returns  Service message about the sent gift
      */
     sendStarGift(params: {
-        /** ID of the user to send the gift to */
-        userId: InputPeerLike;
+        /** ID of the peer to send the gift to */
+        peerId: InputPeerLike;
         /** ID of the gift to send */
         gift: Long | StarGift;
         /**
@@ -4157,8 +4215,8 @@ export interface TelegramClient extends ITelegramClient {
      * @returns  Service message about the transferred gift
      */
     transferStarGift(params: {
-        /** ID of the message containing the gift */
-        message: number | Message;
+        /** Star gift to transfer */
+        gift: InputStarGift;
         /** ID of the user to transfer the gift to */
         recepient: InputPeerLike;
         /**
@@ -4180,8 +4238,7 @@ export interface TelegramClient extends ITelegramClient {
      * @returns  Service message about the upgraded gift
      */
     upgradeStarGift(params: {
-        /** ID of the message containing the gift */
-        message: number | Message;
+        gift: InputStarGift;
         /**
          * Whether to retain the original details of the gift
          * (like sender, recipient, date, message)
@@ -4993,6 +5050,8 @@ export interface TelegramClient extends ITelegramClient {
         peerId: InputPeerLike;
         /** Custom emoji ID or `null` to remove the emoji */
         emoji: tl.Long | null;
+        /** When true, `emoji` is the ID of the collectible emoji */
+        isCollectible?: boolean;
         /**
          * Date when the emoji status should expire (only if `emoji` is not `null`)
          */

package/highlevel/methods/files/normalize-input-media.cjs

@@ -213,6 +213,12 @@ async function _normalizeInputMedia(client, media, params = {}, uploadMedia = fa
     inputFile = uploaded.inputFile;
     mime = uploaded.mime;
   };
+  let videoCover;
+  if (media.type === "video" && media.cover) {
+    const inputMedia = await _normalizeInputMedia(client, media.cover);
+    typeAssertions.assertTypeIs("uploadMediaIfNeeded", inputMedia, "inputMediaPhoto");
+    videoCover = inputMedia.id;
+  }
   const uploadPeer = params.uploadPeer ?? { _: "inputPeerSelf" };
   const uploadMediaIfNeeded = async (inputMedia, photo) => {
     if (!uploadMedia) return inputMedia;
@@ -248,7 +254,9 @@ async function _normalizeInputMedia(client, media, params = {}, uploadMedia = fa
         fileReference: res.document.fileReference
       },
       ttlSeconds: media.ttlSeconds,
-      spoiler: media.type === "video" && media.spoiler
+      spoiler: media.type === "video" && media.spoiler,
+      videoCover,
+      videoTimestamp: media.type === "video" ? media.timestamp : void 0
     };
   };
   const input = media.file;
@@ -358,7 +366,9 @@ async function _normalizeInputMedia(client, media, params = {}, uploadMedia = fa
       mimeType: mime,
       attributes,
       ttlSeconds: media.ttlSeconds,
-      spoiler: media.type === "video" && media.spoiler
+      spoiler: media.type === "video" && media.spoiler,
+      videoTimestamp: media.type === "video" ? media.timestamp : void 0,
+      videoCover
     },
     false
   );

package/highlevel/methods/files/normalize-input-media.js

@@ -206,6 +206,12 @@ async function _normalizeInputMedia(client, media, params = {}, uploadMedia = fa
     inputFile = uploaded.inputFile;
     mime = uploaded.mime;
   };
+  let videoCover;
+  if (media.type === "video" && media.cover) {
+    const inputMedia = await _normalizeInputMedia(client, media.cover);
+    assertTypeIs("uploadMediaIfNeeded", inputMedia, "inputMediaPhoto");
+    videoCover = inputMedia.id;
+  }
   const uploadPeer = params.uploadPeer ?? { _: "inputPeerSelf" };
   const uploadMediaIfNeeded = async (inputMedia, photo) => {
     if (!uploadMedia) return inputMedia;
@@ -241,7 +247,9 @@ async function _normalizeInputMedia(client, media, params = {}, uploadMedia = fa
         fileReference: res.document.fileReference
       },
       ttlSeconds: media.ttlSeconds,
-      spoiler: media.type === "video" && media.spoiler
+      spoiler: media.type === "video" && media.spoiler,
+      videoCover,
+      videoTimestamp: media.type === "video" ? media.timestamp : void 0
     };
   };
   const input = media.file;
@@ -351,7 +359,9 @@ async function _normalizeInputMedia(client, media, params = {}, uploadMedia = fa
       mimeType: mime,
       attributes,
       ttlSeconds: media.ttlSeconds,
-      spoiler: media.type === "video" && media.spoiler
+      spoiler: media.type === "video" && media.spoiler,
+      videoTimestamp: media.type === "video" ? media.timestamp : void 0,
+      videoCover
     },
     false
   );

package/highlevel/methods/messages/forward-messages.cjs

@@ -25,7 +25,8 @@ async function forwardMessagesById(client, params) {
     sendAs,
     noAuthor,
     noCaption,
-    allowPaidFloodskip
+    allowPaidFloodskip,
+    videoTimestamp
   } = params;
   if (messages.length > 100) {
     throw new errors.MtArgumentError("You can forward no more than 100 messages at once");
@@ -45,7 +46,8 @@ async function forwardMessagesById(client, params) {
     noforwards: forbidForwards,
     sendAs: sendAs ? await resolvePeer.resolvePeer(client, sendAs) : void 0,
     quickReplyShortcut: sendCommon._normalizeQuickReplyShortcut(params.quickReply),
-    allowPaidFloodskip
+    allowPaidFloodskip,
+    videoTimestamp
   });
   utils.assertIsUpdatesGroup("messages.forwardMessages", res);
   client.handleClientUpdate(res, !params.shouldDispatch);

package/highlevel/methods/messages/forward-messages.d.cts

@@ -57,6 +57,8 @@ export interface ForwardMessageOptions {
      * The Stars will be withdrawn from the bot's balance.
      */
     allowPaidFloodskip?: boolean;
+    /** Video timestamp to use for the forwarded video */
+    videoTimestamp?: number;
 }
 /**
  * Forward one or more messages by their IDs.

package/highlevel/methods/messages/forward-messages.d.ts

@@ -57,6 +57,8 @@ export interface ForwardMessageOptions {
      * The Stars will be withdrawn from the bot's balance.
      */
     allowPaidFloodskip?: boolean;
+    /** Video timestamp to use for the forwarded video */
+    videoTimestamp?: number;
 }
 /**
  * Forward one or more messages by their IDs.

package/highlevel/methods/messages/forward-messages.js

@@ -18,7 +18,8 @@ async function forwardMessagesById(client, params) {
     sendAs,
     noAuthor,
     noCaption,
-    allowPaidFloodskip
+    allowPaidFloodskip,
+    videoTimestamp
   } = params;
   if (messages.length > 100) {
     throw new MtArgumentError("You can forward no more than 100 messages at once");
@@ -38,7 +39,8 @@ async function forwardMessagesById(client, params) {
     noforwards: forbidForwards,
     sendAs: sendAs ? await resolvePeer(client, sendAs) : void 0,
     quickReplyShortcut: _normalizeQuickReplyShortcut(params.quickReply),
-    allowPaidFloodskip
+    allowPaidFloodskip,
+    videoTimestamp
   });
   assertIsUpdatesGroup("messages.forwardMessages", res);
   client.handleClientUpdate(res, !params.shouldDispatch);

package/highlevel/methods/premium/_normalize-input-star-gift.cjs

@@ -0,0 +1,23 @@
+if (typeof globalThis !== "undefined" && !globalThis._MTCUTE_CJS_DEPRECATION_WARNED) {
+  globalThis._MTCUTE_CJS_DEPRECATION_WARNED = true;
+  console.warn("[@mtcute/core] CommonJS support is deprecated and will be removed in 0.25.0. Please consider switching to ESM, it's " + (/* @__PURE__ */ new Date()).getFullYear() + " already.");
+  console.warn("[@mtcute/core] Learn more about switching to ESM: https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c");
+}
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const resolvePeer = require("../users/resolve-peer.cjs");
+async function _normalizeInputStarGift(client, gift) {
+  if ("message" in gift) {
+    return {
+      _: "inputSavedStarGiftUser",
+      msgId: typeof gift.message === "number" ? gift.message : gift.message.id
+    };
+  } else {
+    return {
+      _: "inputSavedStarGiftChat",
+      peer: await resolvePeer.resolvePeer(client, gift.owner),
+      savedId: gift.savedId
+    };
+  }
+}
+exports._normalizeInputStarGift = _normalizeInputStarGift;

package/highlevel/methods/premium/_normalize-input-star-gift.d.cts

@@ -0,0 +1,4 @@
+import { tl } from '@mtcute/tl';
+import { ITelegramClient } from '../../client.types.js';
+import { InputStarGift } from '../../types/index.js';
+export declare function _normalizeInputStarGift(client: ITelegramClient, gift: InputStarGift): Promise<tl.TypeInputSavedStarGift>;

package/highlevel/methods/premium/_normalize-input-star-gift.d.ts

@@ -0,0 +1,4 @@
+import { tl } from '@mtcute/tl';
+import { ITelegramClient } from '../../client.types.js';
+import { InputStarGift } from '../../types/index.js';
+export declare function _normalizeInputStarGift(client: ITelegramClient, gift: InputStarGift): Promise<tl.TypeInputSavedStarGift>;

package/highlevel/methods/premium/_normalize-input-star-gift.js

@@ -0,0 +1,18 @@
+import { resolvePeer } from "../users/resolve-peer.js";
+async function _normalizeInputStarGift(client, gift) {
+  if ("message" in gift) {
+    return {
+      _: "inputSavedStarGiftUser",
+      msgId: typeof gift.message === "number" ? gift.message : gift.message.id
+    };
+  } else {
+    return {
+      _: "inputSavedStarGiftChat",
+      peer: await resolvePeer(client, gift.owner),
+      savedId: gift.savedId
+    };
+  }
+}
+export {
+  _normalizeInputStarGift
+};