@mtcute/core 0.25.8 → 0.26.0

package/highlevel/methods.d.cts

@@ -4,7 +4,6 @@ export { logOut } from './methods/auth/log-out.js';
 export type { LogOutResult } from './methods/auth/log-out.js';
 export { recoverPassword } from './methods/auth/recover-password.js';
 export { resendCode } from './methods/auth/resend-code.js';
-export { run } from './methods/auth/run.js';
 export { sendCode } from './methods/auth/send-code.js';
 export { sendRecoveryCode } from './methods/auth/send-recovery-code.js';
 export { signInBot } from './methods/auth/sign-in-bot.js';
@@ -115,7 +114,6 @@ export { iterForumTopics } from './methods/forums/iter-forum-topics.js';
 export { reorderPinnedForumTopics } from './methods/forums/reorder-pinned-forum-topics.js';
 export { toggleForumTopicClosed } from './methods/forums/toggle-forum-topic-closed.js';
 export { toggleForumTopicPinned } from './methods/forums/toggle-forum-topic-pinned.js';
-export { toggleForum } from './methods/forums/toggle-forum.js';
 export { updateForumSettings } from './methods/forums/toggle-forum.js';
 export { toggleGeneralTopicHidden } from './methods/forums/toggle-general-topic-hidden.js';
 export { createInviteLink } from './methods/invite-links/create-invite-link.js';
@@ -232,11 +230,11 @@ export { getBusinessChatLinks } from './methods/premium/get-business-chat-links.
 export { getBusinessConnection } from './methods/premium/get-business-connection.js';
 export { getMyBoostSlots } from './methods/premium/get-my-boost-slots.js';
 export { getStarGiftResaleOptions } from './methods/premium/get-resale-star-gifts.js';
-export { getResaleOptions } from './methods/premium/get-resale-star-gifts.js';
 export type { InputStarGiftAttributeIds, ResaleStarGiftsMeta } from './methods/premium/get-resale-star-gifts.js';
 export { getSavedStarGiftsById } from './methods/premium/get-saved-star-gifts-by-id.js';
 export { getSavedStarGifts } from './methods/premium/get-saved-star-gifts.js';
 export { getStarGiftOptions } from './methods/premium/get-star-gift-options.js';
+export { getStarGiftValue } from './methods/premium/get-star-gift-value.js';
 export { getStarGiftWithdrawalUrl } from './methods/premium/get-star-gift-withdrawal-url.js';
 export { getStarsTransactions } from './methods/premium/get-stars-transactions.js';
 export { getUniqueStarGift } from './methods/premium/get-unique-star-gift.js';
@@ -244,6 +242,7 @@ export { iterBoosters } from './methods/premium/iter-boosters.js';
 export { iterSavedStarGifts } from './methods/premium/iter-saved-star-gifts.js';
 export { iterStarsTransactions } from './methods/premium/iter-stars-transactions.js';
 export { togglePinnedStarGifts } from './methods/premium/pin-star-gift.js';
+export { prepayStarGiftUpgrade } from './methods/premium/prepay-star-gift-upgrade.js';
 export { sendStarGift } from './methods/premium/send-star-gift.js';
 export { setBusinessIntro } from './methods/premium/set-business-intro.js';
 export { setBusinessWorkHours } from './methods/premium/set-business-work-hours.js';
@@ -294,6 +293,7 @@ export { getMyUsername } from './methods/users/get-my-username.js';
 export { getPeerSettings } from './methods/users/get-peer-settings.js';
 export { getProfilePhoto } from './methods/users/get-profile-photo.js';
 export { getProfilePhotos } from './methods/users/get-profile-photos.js';
+export { getSavedMusic } from './methods/users/get-saved-music.js';
 export { getUsers } from './methods/users/get-users.js';
 export { isPeerAvailable } from './methods/users/is-peer-available.js';
 export { iterProfilePhotos } from './methods/users/iter-profile-photos.js';
@@ -302,7 +302,8 @@ export { resolvePeer } from './methods/users/resolve-peer.js';
 export { resolveUser } from './methods/users/resolve-peer.js';
 export { resolveChannel } from './methods/users/resolve-peer.js';
 export { resolvePhoneNumber } from './methods/users/resolve-phone-number.js';
-export { setMyEmojiStatus } from './methods/users/set-emoji-status.js';
+export { saveMusicToProfile } from './methods/users/save-music-to-profile.js';
+export { unsaveMusicFromProfile } from './methods/users/save-music-to-profile.js';
 export { setEmojiStatus } from './methods/users/set-emoji-status.js';
 export { setGlobalTtl } from './methods/users/set-global-ttl.js';
 export { setMyBirthday } from './methods/users/set-my-birthday.js';

package/highlevel/methods.d.ts

@@ -4,7 +4,6 @@ export { logOut } from './methods/auth/log-out.js';
 export type { LogOutResult } from './methods/auth/log-out.js';
 export { recoverPassword } from './methods/auth/recover-password.js';
 export { resendCode } from './methods/auth/resend-code.js';
-export { run } from './methods/auth/run.js';
 export { sendCode } from './methods/auth/send-code.js';
 export { sendRecoveryCode } from './methods/auth/send-recovery-code.js';
 export { signInBot } from './methods/auth/sign-in-bot.js';
@@ -115,7 +114,6 @@ export { iterForumTopics } from './methods/forums/iter-forum-topics.js';
 export { reorderPinnedForumTopics } from './methods/forums/reorder-pinned-forum-topics.js';
 export { toggleForumTopicClosed } from './methods/forums/toggle-forum-topic-closed.js';
 export { toggleForumTopicPinned } from './methods/forums/toggle-forum-topic-pinned.js';
-export { toggleForum } from './methods/forums/toggle-forum.js';
 export { updateForumSettings } from './methods/forums/toggle-forum.js';
 export { toggleGeneralTopicHidden } from './methods/forums/toggle-general-topic-hidden.js';
 export { createInviteLink } from './methods/invite-links/create-invite-link.js';
@@ -232,11 +230,11 @@ export { getBusinessChatLinks } from './methods/premium/get-business-chat-links.
 export { getBusinessConnection } from './methods/premium/get-business-connection.js';
 export { getMyBoostSlots } from './methods/premium/get-my-boost-slots.js';
 export { getStarGiftResaleOptions } from './methods/premium/get-resale-star-gifts.js';
-export { getResaleOptions } from './methods/premium/get-resale-star-gifts.js';
 export type { InputStarGiftAttributeIds, ResaleStarGiftsMeta } from './methods/premium/get-resale-star-gifts.js';
 export { getSavedStarGiftsById } from './methods/premium/get-saved-star-gifts-by-id.js';
 export { getSavedStarGifts } from './methods/premium/get-saved-star-gifts.js';
 export { getStarGiftOptions } from './methods/premium/get-star-gift-options.js';
+export { getStarGiftValue } from './methods/premium/get-star-gift-value.js';
 export { getStarGiftWithdrawalUrl } from './methods/premium/get-star-gift-withdrawal-url.js';
 export { getStarsTransactions } from './methods/premium/get-stars-transactions.js';
 export { getUniqueStarGift } from './methods/premium/get-unique-star-gift.js';
@@ -244,6 +242,7 @@ export { iterBoosters } from './methods/premium/iter-boosters.js';
 export { iterSavedStarGifts } from './methods/premium/iter-saved-star-gifts.js';
 export { iterStarsTransactions } from './methods/premium/iter-stars-transactions.js';
 export { togglePinnedStarGifts } from './methods/premium/pin-star-gift.js';
+export { prepayStarGiftUpgrade } from './methods/premium/prepay-star-gift-upgrade.js';
 export { sendStarGift } from './methods/premium/send-star-gift.js';
 export { setBusinessIntro } from './methods/premium/set-business-intro.js';
 export { setBusinessWorkHours } from './methods/premium/set-business-work-hours.js';
@@ -294,6 +293,7 @@ export { getMyUsername } from './methods/users/get-my-username.js';
 export { getPeerSettings } from './methods/users/get-peer-settings.js';
 export { getProfilePhoto } from './methods/users/get-profile-photo.js';
 export { getProfilePhotos } from './methods/users/get-profile-photos.js';
+export { getSavedMusic } from './methods/users/get-saved-music.js';
 export { getUsers } from './methods/users/get-users.js';
 export { isPeerAvailable } from './methods/users/is-peer-available.js';
 export { iterProfilePhotos } from './methods/users/iter-profile-photos.js';
@@ -302,7 +302,8 @@ export { resolvePeer } from './methods/users/resolve-peer.js';
 export { resolveUser } from './methods/users/resolve-peer.js';
 export { resolveChannel } from './methods/users/resolve-peer.js';
 export { resolvePhoneNumber } from './methods/users/resolve-phone-number.js';
-export { setMyEmojiStatus } from './methods/users/set-emoji-status.js';
+export { saveMusicToProfile } from './methods/users/save-music-to-profile.js';
+export { unsaveMusicFromProfile } from './methods/users/save-music-to-profile.js';
 export { setEmojiStatus } from './methods/users/set-emoji-status.js';
 export { setGlobalTtl } from './methods/users/set-global-ttl.js';
 export { setMyBirthday } from './methods/users/set-my-birthday.js';

package/highlevel/types/files/utils.d.cts

@@ -40,6 +40,13 @@ export type UploadFileLike = URL | Uint8Array | File | Blob | string | IReadable
  *  - `td.RawFullRemoteFileLocation` (parsed File ID)
  */
 export type InputFileLike = UploadFileLike | UploadedFile | tl.TypeInputFile | tl.TypeInputMedia | tdFileId.RawFullRemoteFileLocation;
+/**
+ * ID of an already uploaded document. Can be a:
+ *  - `string` with a TDLib and Bot API compatible File ID
+ *  - `td.RawFullRemoteFileLocation` (parsed File ID)
+ *  - `tl.TypeInputDocument` (raw TL object)
+ */
+export type InputDocumentId = string | tdFileId.RawFullRemoteFileLocation | tl.RawInputDocument;
 /**
  * File location which should be downloaded.
  * You can also provide TDLib and Bot API compatible File ID

package/highlevel/types/files/utils.d.ts

@@ -40,6 +40,13 @@ export type UploadFileLike = URL | Uint8Array | File | Blob | string | IReadable
  *  - `td.RawFullRemoteFileLocation` (parsed File ID)
  */
 export type InputFileLike = UploadFileLike | UploadedFile | tl.TypeInputFile | tl.TypeInputMedia | tdFileId.RawFullRemoteFileLocation;
+/**
+ * ID of an already uploaded document. Can be a:
+ *  - `string` with a TDLib and Bot API compatible File ID
+ *  - `td.RawFullRemoteFileLocation` (parsed File ID)
+ *  - `tl.TypeInputDocument` (raw TL object)
+ */
+export type InputDocumentId = string | tdFileId.RawFullRemoteFileLocation | tl.RawInputDocument;
 /**
  * File location which should be downloaded.
  * You can also provide TDLib and Bot API compatible File ID

package/highlevel/types/media/document.d.cts

@@ -45,7 +45,7 @@ export declare abstract class RawDocument extends FileLocation {
      * Input document TL object generated from this object,
      * to be used with methods that use it
      */
-    get inputDocument(): tl.TypeInputDocument;
+    get inputDocument(): tl.RawInputDocument;
     /**
      * Input media TL object generated from this object,
      * to be used inside {@link InputMediaLike} and

package/highlevel/types/media/document.d.ts

@@ -45,7 +45,7 @@ export declare abstract class RawDocument extends FileLocation {
      * Input document TL object generated from this object,
      * to be used with methods that use it
      */
-    get inputDocument(): tl.TypeInputDocument;
+    get inputDocument(): tl.RawInputDocument;
     /**
      * Input media TL object generated from this object,
      * to be used inside {@link InputMediaLike} and

package/highlevel/types/messages/message-action.cjs

@@ -183,9 +183,17 @@ function _messageActionFromTl(act) {
         action: act.message
       };
     case "messageActionSetChatTheme":
+      if (act.theme._ === "chatThemeUniqueGift") {
+        utils.assert(act.theme.gift._ === "starGiftUnique");
+        return {
+          type: "theme_changed_unique",
+          gift: new starsGiftUnique.StarGiftUnique(act.theme.gift, this._peers),
+          themeSettings: act.theme.themeSettings
+        };
+      }
       return {
         type: "theme_changed",
-        emoji: act.emoticon
+        emoji: act.theme.emoticon
       };
     case "messageActionChatJoinedByRequest":
       return {
@@ -286,10 +294,19 @@ function _messageActionFromTl(act) {
         boostPeer: peer.parsePeer(act.boostPeer, this._peers),
         giveawayMessageId: act.giveawayMsgId
       };
+    // todo: cleanup in the next breaking update
     case "messageActionStarGift":
       utils.assert(act.gift._ === "starGift");
+      if (act.prepaidUpgrade) {
+        return {
+          type: "star_gift_upgrade_paid",
+          gift: new starsGift.StarGift(act.gift, this._peers),
+          giftMsgId: act.giftMsgId ?? void 0,
+          upgradeMsgId: act.upgradeMsgId ?? null
+        };
+      }
       return {
-        type: "stars_gift",
+        type: "star_gift_sent",
         nameHidden: act.nameHidden,
         saved: act.saved,
         converted: act.converted,
@@ -301,33 +318,38 @@ function _messageActionFromTl(act) {
         upgraded: act.upgraded,
         upgradeStars: act.upgradeStars ?? Long.ZERO,
         upgradeMsgId: act.upgradeMsgId ?? null,
-        fromId: act.fromId ? peerUtils.getMarkedPeerId(act.fromId) : void 0,
-        toId: act.peer ? peerUtils.getMarkedPeerId(act.peer) : void 0,
-        savedId: act.savedId
+        savedId: act.savedId,
+        prepaidUpgradeHash: act.prepaidUpgradeHash ?? void 0
       };
-    case "messageActionStarGiftUnique":
+    case "messageActionStarGiftUnique": {
       utils.assert(act.gift._ === "starGiftUnique");
-      return {
-        type: "stars_gift",
-        nameHidden: false,
+      const common = {
         saved: act.saved,
-        converted: false,
-        convertStars: Long.ZERO,
         refunded: act.refunded,
         gift: new starsGiftUnique.StarGiftUnique(act.gift, this._peers),
-        message: null,
-        canUpgrade: false,
-        upgraded: true,
-        upgradeStars: Long.ZERO,
-        upgradeMsgId: null,
-        canTransferSince: act.canTransferAt ? new Date(act.canTransferAt * 1e3) : void 0,
-        resaleStars: act.resaleAmount?._ === "starsAmount" ? act.resaleAmount.amount : void 0,
-        resaleTon: act.resaleAmount?._ === "starsTonAmount" ? act.resaleAmount.amount : void 0,
+        canTransferAt: act.canTransferAt ? new Date(act.canTransferAt * 1e3) : void 0,
         canResellAt: act.canResellAt ? new Date(act.canResellAt * 1e3) : void 0,
-        fromId: act.fromId ? peerUtils.getMarkedPeerId(act.fromId) : void 0,
-        toId: act.peer ? peerUtils.getMarkedPeerId(act.peer) : void 0,
+        canExportAt: act.canExportAt ? new Date(act.canExportAt * 1e3) : void 0,
         savedId: act.savedId
       };
+      if (act.resaleAmount) {
+        return {
+          type: "star_gift_bought_resale",
+          ...common,
+          amount: act.resaleAmount
+        };
+      }
+      if (act.upgrade) {
+        return {
+          type: "star_gift_upgraded",
+          ...common
+        };
+      }
+      return {
+        type: "star_gift_transferred",
+        ...common
+      };
+    }
     case "messageActionPaidMessagesPrice":
       return {
         type: "messages_paid",

package/highlevel/types/messages/message-action.d.cts

@@ -2,7 +2,6 @@ import { tl } from '@mtcute/tl';
 import { TextWithEntities } from '../misc/entities.js';
 import { Peer } from '../peers/peer.js';
 import { Message } from './message.js';
-import { default as Long } from 'long';
 import { Photo } from '../media/photo.js';
 import { StarGiftUnique } from '../premium/stars-gift-unique.js';
 import { StarGift } from '../premium/stars-gift.js';
@@ -244,6 +243,14 @@ export interface ActionThemeChanged {
     /** Emoji representing the new theme */
     emoji: string;
 }
+/** Chat theme was changed to a unique star gift based one */
+export interface ActionThemeChangedUnique {
+    readonly type: 'theme_changed_unique';
+    /** Unique star gift */
+    gift: StarGiftUnique;
+    /** Theme settings */
+    themeSettings: tl.TypeThemeSettings[];
+}
 /** Data was sent from a WebView (user-side action) */
 export interface ActionWebviewDataSent {
     readonly type: 'webview_sent';
@@ -399,8 +406,8 @@ export interface ActionStarsPrize {
     giveawayMessageId: number;
 }
 /** A star gift was sent */
-export interface ActionStarGift {
-    readonly type: 'stars_gift';
+export interface ActionStarGiftSent {
+    readonly type: 'star_gift_sent';
     /** Whether the sender chose to send the gift anonymously */
     nameHidden: boolean;
     /** Whether this gift was saved to the recipient's profile */
@@ -414,6 +421,10 @@ export interface ActionStarGift {
      * (0 if the gift cannot be converted)
      */
     convertStars: tl.Long;
+    /** The gift itself */
+    gift: StarGift;
+    /** Message attached to the gift */
+    message: TextWithEntities | null;
     /** Whether this gift can be upgraded to a unique gift */
     canUpgrade: boolean;
     /** Whether this gift was upgraded to a unique gift */
@@ -422,21 +433,50 @@ export interface ActionStarGift {
     upgradeStars: tl.Long;
     /** If the gift was upgraded, ID of the message where this happened */
     upgradeMsgId: number | null;
-    /** If the gift can be transferred, date when it can be re-sold */
-    canTransferSince?: Date;
-    /** Number of stars this gift is up for resell for */
-    resaleStars?: tl.Long;
-    /** Number of nanoton this gift is up for resell for */
-    resaleTon?: tl.Long;
+    /** ID of the related saved profile gift */
+    savedId?: tl.Long;
+    /** If available, you can pay for this gift's upgrade by passing this hash to `prepayStarGiftUpgrade` */
+    prepaidUpgradeHash?: string;
+}
+/** A star gift upgrade was paid for */
+export interface ActionStarGiftUpgradePaid {
+    readonly type: 'star_gift_upgrade_paid';
+    /** The gift itself */
+    gift: StarGift;
+    /** ID of the message where the gift was upgraded */
+    upgradeMsgId: number | null;
+    /** ID of the message containing the originally sent gift, if available */
+    giftMsgId?: number;
+}
+interface StarGiftUniqueCommon {
+    /** Whether this gift was saved to the recipient's profile */
+    saved: boolean;
+    /** Whether this gift was refunded */
+    refunded: boolean;
+    /** The gift itself */
+    gift: StarGiftUnique;
+    /** If the gift can be transferred, date when it will become available */
+    canTransferAt?: Date;
     /** If the gift can be re-sold, date when it will become available */
     canResellAt?: Date;
-    /** The gift itself */
-    gift: StarGift | StarGiftUnique;
-    /** Message attached to the gift */
-    message: TextWithEntities | null;
-    fromId?: number;
-    toId?: number;
-    savedId?: Long;
+    /** If the gift can be exported to blockchain, date when it will become available */
+    canExportAt?: Date;
+    /** ID of the related saved profile gift */
+    savedId?: tl.Long;
+}
+/** A star gift was upgraded to a unique one */
+export interface ActionStarGiftUpgraded extends StarGiftUniqueCommon {
+    readonly type: 'star_gift_upgraded';
+}
+/** A star gift was bought from a resale listing */
+export interface ActionStarGiftBoughtResale extends StarGiftUniqueCommon {
+    readonly type: 'star_gift_bought_resale';
+    /** Number of stars/TON that were paid for the gift */
+    amount: tl.TypeStarsAmount;
+}
+/** A star gift was transferred */
+export interface ActionStarGiftTransferred extends StarGiftUniqueCommon {
+    readonly type: 'star_gift_transferred';
 }
 /** Paid messages were paid for */
 export interface ActionPaidMessagesPaid {
@@ -482,6 +522,7 @@ export interface ActionTonGift {
     /** Transaction ID */
     transactionId?: string;
 }
-export type MessageAction = ActionChatCreated | ActionChannelCreated | ActionChatMigrateTo | ActionChannelMigrateFrom | ActionMessagePinned | ActionHistoryCleared | ActionGameScore | ActionContactJoined | ActionTitleChanged | ActionPhotoChanged | ActionPhotoDeleted | ActionUsersAdded | ActionUserLeft | ActionUserRemoved | ActionUserJoinedLink | ActionPaymentReceived | ActionPaymentSent | ActionCall | ActionScreenshotTaken | ActionBotAllowed | ActionGeoProximity | ActionGroupCallStarted | ActionGroupCallEnded | ActionGroupCallScheduled | ActionGroupInvite | ActionTtlChanged | ActionTopicCreated | ActionTopicEdited | ActionCustom | ActionThemeChanged | ActionUserJoinedApproved | ActionWebviewDataSent | ActionWebviewDataReceived | ActionPremiumGifted | ActionPhotoSuggested | ActionPeerSent | ActionPeerChosen | ActionWallpaperChanged | ActionGiftCode | ActionGiveawayStarted | ActionGiveawayEnded | ActionBoostApply | ActionPaymentRefunded | ActionStarGifted | ActionStarsPrize | ActionStarGift | ActionPaidMessagesPaid | ActionPaidMessagesRefunded | ActionTodoCompletions | ActionTodoAppendTasks | ActionTonGift | null;
+export type MessageAction = ActionChatCreated | ActionChannelCreated | ActionChatMigrateTo | ActionChannelMigrateFrom | ActionMessagePinned | ActionHistoryCleared | ActionGameScore | ActionContactJoined | ActionTitleChanged | ActionPhotoChanged | ActionPhotoDeleted | ActionUsersAdded | ActionUserLeft | ActionUserRemoved | ActionUserJoinedLink | ActionPaymentReceived | ActionPaymentSent | ActionCall | ActionScreenshotTaken | ActionBotAllowed | ActionGeoProximity | ActionGroupCallStarted | ActionGroupCallEnded | ActionGroupCallScheduled | ActionGroupInvite | ActionTtlChanged | ActionTopicCreated | ActionTopicEdited | ActionCustom | ActionThemeChanged | ActionThemeChangedUnique | ActionUserJoinedApproved | ActionWebviewDataSent | ActionWebviewDataReceived | ActionPremiumGifted | ActionPhotoSuggested | ActionPeerSent | ActionPeerChosen | ActionWallpaperChanged | ActionGiftCode | ActionGiveawayStarted | ActionGiveawayEnded | ActionBoostApply | ActionPaymentRefunded | ActionStarGifted | ActionStarsPrize | ActionStarGiftSent | ActionStarGiftUpgradePaid | ActionStarGiftUpgraded | ActionStarGiftBoughtResale | ActionStarGiftTransferred | ActionPaidMessagesPaid | ActionPaidMessagesRefunded | ActionTodoCompletions | ActionTodoAppendTasks | ActionTonGift | null;
 /** @internal */
 export declare function _messageActionFromTl(this: Message, act: tl.TypeMessageAction): MessageAction;
+export {};

package/highlevel/types/messages/message-action.d.ts

@@ -2,7 +2,6 @@ import { tl } from '@mtcute/tl';
 import { TextWithEntities } from '../misc/entities.js';
 import { Peer } from '../peers/peer.js';
 import { Message } from './message.js';
-import { default as Long } from 'long';
 import { Photo } from '../media/photo.js';
 import { StarGiftUnique } from '../premium/stars-gift-unique.js';
 import { StarGift } from '../premium/stars-gift.js';
@@ -244,6 +243,14 @@ export interface ActionThemeChanged {
     /** Emoji representing the new theme */
     emoji: string;
 }
+/** Chat theme was changed to a unique star gift based one */
+export interface ActionThemeChangedUnique {
+    readonly type: 'theme_changed_unique';
+    /** Unique star gift */
+    gift: StarGiftUnique;
+    /** Theme settings */
+    themeSettings: tl.TypeThemeSettings[];
+}
 /** Data was sent from a WebView (user-side action) */
 export interface ActionWebviewDataSent {
     readonly type: 'webview_sent';
@@ -399,8 +406,8 @@ export interface ActionStarsPrize {
     giveawayMessageId: number;
 }
 /** A star gift was sent */
-export interface ActionStarGift {
-    readonly type: 'stars_gift';
+export interface ActionStarGiftSent {
+    readonly type: 'star_gift_sent';
     /** Whether the sender chose to send the gift anonymously */
     nameHidden: boolean;
     /** Whether this gift was saved to the recipient's profile */
@@ -414,6 +421,10 @@ export interface ActionStarGift {
      * (0 if the gift cannot be converted)
      */
     convertStars: tl.Long;
+    /** The gift itself */
+    gift: StarGift;
+    /** Message attached to the gift */
+    message: TextWithEntities | null;
     /** Whether this gift can be upgraded to a unique gift */
     canUpgrade: boolean;
     /** Whether this gift was upgraded to a unique gift */
@@ -422,21 +433,50 @@ export interface ActionStarGift {
     upgradeStars: tl.Long;
     /** If the gift was upgraded, ID of the message where this happened */
     upgradeMsgId: number | null;
-    /** If the gift can be transferred, date when it can be re-sold */
-    canTransferSince?: Date;
-    /** Number of stars this gift is up for resell for */
-    resaleStars?: tl.Long;
-    /** Number of nanoton this gift is up for resell for */
-    resaleTon?: tl.Long;
+    /** ID of the related saved profile gift */
+    savedId?: tl.Long;
+    /** If available, you can pay for this gift's upgrade by passing this hash to `prepayStarGiftUpgrade` */
+    prepaidUpgradeHash?: string;
+}
+/** A star gift upgrade was paid for */
+export interface ActionStarGiftUpgradePaid {
+    readonly type: 'star_gift_upgrade_paid';
+    /** The gift itself */
+    gift: StarGift;
+    /** ID of the message where the gift was upgraded */
+    upgradeMsgId: number | null;
+    /** ID of the message containing the originally sent gift, if available */
+    giftMsgId?: number;
+}
+interface StarGiftUniqueCommon {
+    /** Whether this gift was saved to the recipient's profile */
+    saved: boolean;
+    /** Whether this gift was refunded */
+    refunded: boolean;
+    /** The gift itself */
+    gift: StarGiftUnique;
+    /** If the gift can be transferred, date when it will become available */
+    canTransferAt?: Date;
     /** If the gift can be re-sold, date when it will become available */
     canResellAt?: Date;
-    /** The gift itself */
-    gift: StarGift | StarGiftUnique;
-    /** Message attached to the gift */
-    message: TextWithEntities | null;
-    fromId?: number;
-    toId?: number;
-    savedId?: Long;
+    /** If the gift can be exported to blockchain, date when it will become available */
+    canExportAt?: Date;
+    /** ID of the related saved profile gift */
+    savedId?: tl.Long;
+}
+/** A star gift was upgraded to a unique one */
+export interface ActionStarGiftUpgraded extends StarGiftUniqueCommon {
+    readonly type: 'star_gift_upgraded';
+}
+/** A star gift was bought from a resale listing */
+export interface ActionStarGiftBoughtResale extends StarGiftUniqueCommon {
+    readonly type: 'star_gift_bought_resale';
+    /** Number of stars/TON that were paid for the gift */
+    amount: tl.TypeStarsAmount;
+}
+/** A star gift was transferred */
+export interface ActionStarGiftTransferred extends StarGiftUniqueCommon {
+    readonly type: 'star_gift_transferred';
 }
 /** Paid messages were paid for */
 export interface ActionPaidMessagesPaid {
@@ -482,6 +522,7 @@ export interface ActionTonGift {
     /** Transaction ID */
     transactionId?: string;
 }
-export type MessageAction = ActionChatCreated | ActionChannelCreated | ActionChatMigrateTo | ActionChannelMigrateFrom | ActionMessagePinned | ActionHistoryCleared | ActionGameScore | ActionContactJoined | ActionTitleChanged | ActionPhotoChanged | ActionPhotoDeleted | ActionUsersAdded | ActionUserLeft | ActionUserRemoved | ActionUserJoinedLink | ActionPaymentReceived | ActionPaymentSent | ActionCall | ActionScreenshotTaken | ActionBotAllowed | ActionGeoProximity | ActionGroupCallStarted | ActionGroupCallEnded | ActionGroupCallScheduled | ActionGroupInvite | ActionTtlChanged | ActionTopicCreated | ActionTopicEdited | ActionCustom | ActionThemeChanged | ActionUserJoinedApproved | ActionWebviewDataSent | ActionWebviewDataReceived | ActionPremiumGifted | ActionPhotoSuggested | ActionPeerSent | ActionPeerChosen | ActionWallpaperChanged | ActionGiftCode | ActionGiveawayStarted | ActionGiveawayEnded | ActionBoostApply | ActionPaymentRefunded | ActionStarGifted | ActionStarsPrize | ActionStarGift | ActionPaidMessagesPaid | ActionPaidMessagesRefunded | ActionTodoCompletions | ActionTodoAppendTasks | ActionTonGift | null;
+export type MessageAction = ActionChatCreated | ActionChannelCreated | ActionChatMigrateTo | ActionChannelMigrateFrom | ActionMessagePinned | ActionHistoryCleared | ActionGameScore | ActionContactJoined | ActionTitleChanged | ActionPhotoChanged | ActionPhotoDeleted | ActionUsersAdded | ActionUserLeft | ActionUserRemoved | ActionUserJoinedLink | ActionPaymentReceived | ActionPaymentSent | ActionCall | ActionScreenshotTaken | ActionBotAllowed | ActionGeoProximity | ActionGroupCallStarted | ActionGroupCallEnded | ActionGroupCallScheduled | ActionGroupInvite | ActionTtlChanged | ActionTopicCreated | ActionTopicEdited | ActionCustom | ActionThemeChanged | ActionThemeChangedUnique | ActionUserJoinedApproved | ActionWebviewDataSent | ActionWebviewDataReceived | ActionPremiumGifted | ActionPhotoSuggested | ActionPeerSent | ActionPeerChosen | ActionWallpaperChanged | ActionGiftCode | ActionGiveawayStarted | ActionGiveawayEnded | ActionBoostApply | ActionPaymentRefunded | ActionStarGifted | ActionStarsPrize | ActionStarGiftSent | ActionStarGiftUpgradePaid | ActionStarGiftUpgraded | ActionStarGiftBoughtResale | ActionStarGiftTransferred | ActionPaidMessagesPaid | ActionPaidMessagesRefunded | ActionTodoCompletions | ActionTodoAppendTasks | ActionTonGift | null;
 /** @internal */
 export declare function _messageActionFromTl(this: Message, act: tl.TypeMessageAction): MessageAction;
+export {};

package/highlevel/types/messages/message-action.js

@@ -176,9 +176,17 @@ function _messageActionFromTl(act) {
         action: act.message
       };
     case "messageActionSetChatTheme":
+      if (act.theme._ === "chatThemeUniqueGift") {
+        assert(act.theme.gift._ === "starGiftUnique");
+        return {
+          type: "theme_changed_unique",
+          gift: new StarGiftUnique$2(act.theme.gift, this._peers),
+          themeSettings: act.theme.themeSettings
+        };
+      }
       return {
         type: "theme_changed",
-        emoji: act.emoticon
+        emoji: act.theme.emoticon
       };
     case "messageActionChatJoinedByRequest":
       return {
@@ -279,10 +287,19 @@ function _messageActionFromTl(act) {
         boostPeer: parsePeer(act.boostPeer, this._peers),
         giveawayMessageId: act.giveawayMsgId
       };
+    // todo: cleanup in the next breaking update
     case "messageActionStarGift":
       assert(act.gift._ === "starGift");
+      if (act.prepaidUpgrade) {
+        return {
+          type: "star_gift_upgrade_paid",
+          gift: new StarGift$2(act.gift, this._peers),
+          giftMsgId: act.giftMsgId ?? void 0,
+          upgradeMsgId: act.upgradeMsgId ?? null
+        };
+      }
       return {
-        type: "stars_gift",
+        type: "star_gift_sent",
         nameHidden: act.nameHidden,
         saved: act.saved,
         converted: act.converted,
@@ -294,33 +311,38 @@ function _messageActionFromTl(act) {
         upgraded: act.upgraded,
         upgradeStars: act.upgradeStars ?? Long.ZERO,
         upgradeMsgId: act.upgradeMsgId ?? null,
-        fromId: act.fromId ? getMarkedPeerId(act.fromId) : void 0,
-        toId: act.peer ? getMarkedPeerId(act.peer) : void 0,
-        savedId: act.savedId
+        savedId: act.savedId,
+        prepaidUpgradeHash: act.prepaidUpgradeHash ?? void 0
       };
-    case "messageActionStarGiftUnique":
+    case "messageActionStarGiftUnique": {
       assert(act.gift._ === "starGiftUnique");
-      return {
-        type: "stars_gift",
-        nameHidden: false,
+      const common = {
         saved: act.saved,
-        converted: false,
-        convertStars: Long.ZERO,
         refunded: act.refunded,
         gift: new StarGiftUnique$2(act.gift, this._peers),
-        message: null,
-        canUpgrade: false,
-        upgraded: true,
-        upgradeStars: Long.ZERO,
-        upgradeMsgId: null,
-        canTransferSince: act.canTransferAt ? new Date(act.canTransferAt * 1e3) : void 0,
-        resaleStars: act.resaleAmount?._ === "starsAmount" ? act.resaleAmount.amount : void 0,
-        resaleTon: act.resaleAmount?._ === "starsTonAmount" ? act.resaleAmount.amount : void 0,
+        canTransferAt: act.canTransferAt ? new Date(act.canTransferAt * 1e3) : void 0,
         canResellAt: act.canResellAt ? new Date(act.canResellAt * 1e3) : void 0,
-        fromId: act.fromId ? getMarkedPeerId(act.fromId) : void 0,
-        toId: act.peer ? getMarkedPeerId(act.peer) : void 0,
+        canExportAt: act.canExportAt ? new Date(act.canExportAt * 1e3) : void 0,
         savedId: act.savedId
       };
+      if (act.resaleAmount) {
+        return {
+          type: "star_gift_bought_resale",
+          ...common,
+          amount: act.resaleAmount
+        };
+      }
+      if (act.upgrade) {
+        return {
+          type: "star_gift_upgraded",
+          ...common
+        };
+      }
+      return {
+        type: "star_gift_transferred",
+        ...common
+      };
+    }
     case "messageActionPaidMessagesPrice":
       return {
         type: "messages_paid",

package/highlevel/types/peers/full-user.cjs

@@ -7,6 +7,7 @@ if (typeof globalThis !== "undefined" && !globalThis._MTCUTE_CJS_DEPRECATION_WAR
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const inspectable = require("../../utils/inspectable.cjs");
 const memoize = require("../../utils/memoize.cjs");
+const documentUtils = require("../media/document-utils.cjs");
 const photo = require("../media/photo.cjs");
 const businessAccount = require("../premium/business-account.cjs");
 const botVerification = require("./bot-verification.cjs");
@@ -234,6 +235,13 @@ class FullUser extends user.User {
       date: new Date(this.full.starsMyPendingRatingDate * 1e3)
     };
   }
+  /** User's last saved audio file, to be displayed in the profile under their name */
+  get lastSavedMusic() {
+    if (this.full.savedMusic?._ !== "document") return null;
+    const doc = documentUtils.parseDocument(this.full.savedMusic);
+    if (doc.type !== "audio") return null;
+    return doc;
+  }
 }
 const FullUser$1 = /* @__PURE__ */ memoize.memoizeGetters(FullUser, [
   "fullPhoto",
@@ -243,7 +251,8 @@ const FullUser$1 = /* @__PURE__ */ memoize.memoizeGetters(FullUser, [
   "personalChannel",
   "business",
   "botVerification",
-  "starsRatingPending"
+  "starsRatingPending",
+  "lastSavedMusic"
 ]);
 const FullUser$2 = /* @__PURE__ */ inspectable.makeInspectable(FullUser$1);
 exports.FullUser = FullUser$2;

package/highlevel/types/peers/full-user.d.cts

@@ -1,4 +1,5 @@
 import { tl } from '@mtcute/tl';
+import { Audio } from '../media/audio.js';
 import { Photo } from '../media/photo.js';
 import { BusinessAccount } from '../premium/business-account.js';
 import { BotVerification } from './bot-verification.js';
@@ -132,4 +133,6 @@ export declare class FullUser extends User {
         rating: tl.RawStarsRating;
         date: Date;
     } | null;
+    /** User's last saved audio file, to be displayed in the profile under their name */
+    get lastSavedMusic(): Audio | null;
 }