@mtcute/core 0.25.7 → 0.26.0

package/highlevel/client.d.ts

@@ -1,4 +1,3 @@
-import { tdFileId } from '@mtcute/file-id';
 import { tl } from '@mtcute/tl';
 import { default as Long } from 'long';
 import { RpcCallOptions } from '../network/index.js';
@@ -25,12 +24,11 @@ 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, 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, Peer, PeerReaction, PeerSettings, 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, UserStatusUpdate, UserTypingUpdate, WebPageMedia, WebviewResult } from './types/index.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';
 import { ParsedUpdateHandlerParams } from './updates/parsed.js';
 import { RawUpdateInfo } from './updates/types.js';
 import { InputStringSessionData } from './utils/string-session.js';
 import { Emitter } from '@fuman/utils';
-import { start } from './methods/auth/start.js';
 import { getChatEventLog } from './methods/chats/get-chat-event-log.js';
 import { getChatMembers } from './methods/chats/get-chat-members.js';
 import { getInviteLinkMembers } from './methods/invite-links/get-invite-link-members.js';
@@ -38,6 +36,7 @@ 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';
@@ -203,21 +202,6 @@ export interface TelegramClient extends ITelegramClient {
         /** Abort signal */
         abortSignal?: AbortSignal;
     }): Promise<SentCode>;
-    /**
-     * Simple wrapper that calls {@link start} and then
-     * provided callback function (if any) without the
-     * need to introduce a `main()` function manually.
-     *
-     * Errors that were encountered while calling {@link start}
-     * and `then` will be emitted as usual, and can be caught with {@link onError}
-     *
-     * **Available**: ✅ both users and bots
-     *
-     * @param params  Parameters to be passed to {@link start}
-     * @param then  Function to be called after {@link start} returns
-     * @deprecated  This method provides no real value over {@link start}, please use it instead
-     */
-    run(params: Parameters<typeof start>[1], then?: (user: User) => void | Promise<void>): void;
     /**
      * Send the confirmation code to the given phone number
      *
@@ -2328,18 +2312,6 @@ export interface TelegramClient extends ITelegramClient {
         /** Whether the topic should be pinned */
         pinned: boolean;
     }): Promise<void>;
-    /**
-     * Set whether a supergroup is a forum.
-     *
-     * Only owner of the supergroup can change this setting.
-     *
-     * **Available**: 👤 users only
-     *
-     * @param chatId  Chat ID or username
-     * @param [enabled=false]  Whether the supergroup should be a forum
-     * @deprecated Use {@link updateForumSettings} instead
-     */
-    toggleForum(chatId: InputPeerLike, enabled?: boolean): Promise<void>;
     /**
      * Update forum settings of a supergroup.
      *
@@ -3947,6 +3919,8 @@ export interface TelegramClient extends ITelegramClient {
          * 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,7 +4022,7 @@ export interface TelegramClient extends ITelegramClient {
      * **Available**: ✅ both users and bots
      *
      */
-    getResaleOptions(params: {
+    getStarGiftResaleOptions(params: {
         /** ID of the gift to get resale options for */
         giftId: tl.Long;
         /**
@@ -4087,10 +4061,12 @@ export interface TelegramClient extends ITelegramClient {
         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 exclude gifts that cannot be upgraded (either not limited or already upgraded) */
+        excludeUnupgradable?: boolean;
+        /** Whether to exclude gifts that can be upgraded */
+        excludeUpgradable?: boolean;
         /** ID of the collection to get gifts from */
         collectionId?: number;
         /** Whether to sort by value */
@@ -4106,6 +4082,13 @@ export interface TelegramClient extends ITelegramClient {
      *
      */
     getStarGiftOptions(): Promise<StarGift[]>;
+    /**
+     * Get the value of a unique star gift
+     */
+    getStarGiftValue(params: {
+        /** Slug of the star gift */
+        slug: string;
+    }): Promise<StarGiftValue>;
     getStarGiftWithdrawalUrl(params: {
         /** The star gift to withdraw */
         gift: InputStarGift;
@@ -4138,6 +4121,8 @@ export interface TelegramClient extends ITelegramClient {
         subscriptionId?: string;
         /** Pagination offset */
         offset?: string;
+        /** Whether to return transactions made in TON */
+        ton?: boolean;
         /**
          * Pagination limit
          *
@@ -4179,24 +4164,18 @@ export interface TelegramClient extends ITelegramClient {
      * **Available**: ✅ both users and bots
      *
      */
-    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 */
+    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>;
     /**
@@ -4238,6 +4217,28 @@ export interface TelegramClient extends ITelegramClient {
         /** 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.
      *
@@ -4465,7 +4466,7 @@ export interface TelegramClient extends ITelegramClient {
      *     TL object representing a sticker to be removed
      * @returns  Modfiied sticker set
      */
-    deleteStickerFromSet(sticker: string | tdFileId.RawFullRemoteFileLocation | tl.TypeInputDocument): Promise<StickerSet>;
+    deleteStickerFromSet(sticker: InputDocumentId): Promise<StickerSet>;
     /**
      * Get custom emoji stickers by their IDs
      *
@@ -4523,7 +4524,7 @@ export interface TelegramClient extends ITelegramClient {
      * @param position  New sticker position (starting from 0)
      * @returns  Modified sticker set
      */
-    moveStickerInSet(sticker: string | tdFileId.RawFullRemoteFileLocation | tl.TypeInputDocument, position: number): Promise<StickerSet>;
+    moveStickerInSet(sticker: InputDocumentId, position: number): Promise<StickerSet>;
     /**
      * Replace a sticker in a sticker set with another sticker
      *
@@ -4537,7 +4538,7 @@ export interface TelegramClient extends ITelegramClient {
      * @param newSticker  New sticker to replace the old one with
      * @returns  Modfiied sticker set
      */
-    replaceStickerInSet(sticker: string | tdFileId.RawFullRemoteFileLocation | tl.TypeInputDocument, newSticker: InputStickerSetItem, params?: {
+    replaceStickerInSet(sticker: InputDocumentId, newSticker: InputStickerSetItem, params?: {
         /**
          * Upload progress callback
          *
@@ -5048,6 +5049,17 @@ export interface TelegramClient extends ITelegramClient {
          */
         limit?: number;
     }): Promise<ArrayPaginated<Photo, number>>;
+    /**
+     * Get music files saved to the user's profile
+     */
+    getSavedMusic(params: {
+        /** User ID, username, phone number, `"me"` or `"self"` */
+        userId: InputPeerLike;
+        /** Offset for pagination */
+        offset?: number;
+        /** Limit for pagination */
+        limit?: number;
+    }): Promise<ArrayPaginated<Audio, number>>;
     /**
      * Get information about multiple users.
      * You can retrieve up to 200 users at once.
@@ -5156,18 +5168,22 @@ export interface TelegramClient extends ITelegramClient {
      * @param [force=false]  Whether to force re-fetch the peer from the server
      */
     resolvePhoneNumber(phone: string, force?: boolean): Promise<tl.TypeInputPeer>;
-    /**
-     * Set an emoji status for the current user
-     *
-     * **Available**: ✅ both users and bots
-     *
-     * @deprecated – use {@link setEmojiStatus} with `self` instead
-     */
-    setMyEmojiStatus(emoji: tl.Long | null, params?: {
+    saveMusicToProfile(params: {
+        /** Audio file to save (or its ID) */
+        audio: InputMediaAudio | InputDocumentId;
+        /** Optionally, document ID after which we should insert the music */
+        after?: InputDocumentId;
         /**
-         * Date when the emoji status should expire (only if `emoji` is not `null`)
+         * Upload progress callback
+         *
+         * @param uploaded  Number of bytes uploaded
+         * @param total  Total file size
          */
-        until?: number | Date;
+        progressCallback?: (uploaded: number, total: number) => void;
+    }): Promise<void>;
+    unsaveMusicFromProfile(params: {
+        /** ID of the Audio file to unsave */
+        audio: InputDocumentId;
     }): Promise<void>;
     /**
      * Set an emoji status for the given user/chat

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

@@ -278,11 +278,14 @@ async function _normalizeInputMedia(client, media, params = {}, uploadMedia = fa
   };
   const input = media.file;
   if (fileId.tdFileId.isFileIdLike(input)) {
+    const spoiler = (media.type === "video" || media.type === "photo") && media.spoiler;
     if (typeof input === "string" && input.match(/^https?:\/\//)) {
       return uploadMediaIfNeeded(
         {
           _: media.type === "photo" ? "inputMediaPhotoExternal" : "inputMediaDocumentExternal",
-          url: input
+          url: input,
+          ttlSeconds: media.ttlSeconds,
+          spoiler
         },
         media.type === "photo"
       );
@@ -293,20 +296,26 @@ async function _normalizeInputMedia(client, media, params = {}, uploadMedia = fa
       if (parsed.location._ === "photo") {
         return {
           _: "inputMediaPhoto",
-          id: convertFileId.fileIdToInputPhoto(parsed)
+          id: convertFileId.fileIdToInputPhoto(parsed),
+          ttlSeconds: media.ttlSeconds,
+          spoiler
         };
       } else if (parsed.location._ === "web") {
         return uploadMediaIfNeeded(
           {
             _: parsed.type === fileId.tdFileId.FileType.Photo ? "inputMediaPhotoExternal" : "inputMediaDocumentExternal",
-            url: parsed.location.url
+            url: parsed.location.url,
+            ttlSeconds: media.ttlSeconds,
+            spoiler
           },
           parsed.type === fileId.tdFileId.FileType.Photo
         );
       }
       return {
         _: "inputMediaDocument",
-        id: convertFileId.fileIdToInputDocument(parsed)
+        id: convertFileId.fileIdToInputDocument(parsed),
+        ttlSeconds: media.ttlSeconds,
+        spoiler
       };
     }
   } else if (typeof input === "object" && tl.tl.isAnyInputMedia(input)) {

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

@@ -271,11 +271,14 @@ async function _normalizeInputMedia(client, media, params = {}, uploadMedia = fa
   };
   const input = media.file;
   if (tdFileId.isFileIdLike(input)) {
+    const spoiler = (media.type === "video" || media.type === "photo") && media.spoiler;
     if (typeof input === "string" && input.match(/^https?:\/\//)) {
       return uploadMediaIfNeeded(
         {
           _: media.type === "photo" ? "inputMediaPhotoExternal" : "inputMediaDocumentExternal",
-          url: input
+          url: input,
+          ttlSeconds: media.ttlSeconds,
+          spoiler
         },
         media.type === "photo"
       );
@@ -286,20 +289,26 @@ async function _normalizeInputMedia(client, media, params = {}, uploadMedia = fa
       if (parsed.location._ === "photo") {
         return {
           _: "inputMediaPhoto",
-          id: fileIdToInputPhoto(parsed)
+          id: fileIdToInputPhoto(parsed),
+          ttlSeconds: media.ttlSeconds,
+          spoiler
         };
       } else if (parsed.location._ === "web") {
         return uploadMediaIfNeeded(
           {
             _: parsed.type === tdFileId.FileType.Photo ? "inputMediaPhotoExternal" : "inputMediaDocumentExternal",
-            url: parsed.location.url
+            url: parsed.location.url,
+            ttlSeconds: media.ttlSeconds,
+            spoiler
           },
           parsed.type === tdFileId.FileType.Photo
         );
       }
       return {
         _: "inputMediaDocument",
-        id: fileIdToInputDocument(parsed)
+        id: fileIdToInputDocument(parsed),
+        ttlSeconds: media.ttlSeconds,
+        spoiler
       };
     }
   } else if (typeof input === "object" && tl.isAnyInputMedia(input)) {

package/highlevel/methods/forums/toggle-forum.cjs

@@ -6,15 +6,6 @@ if (typeof globalThis !== "undefined" && !globalThis._MTCUTE_CJS_DEPRECATION_WAR
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const resolvePeer = require("../users/resolve-peer.cjs");
-async function toggleForum(client, chatId, enabled = false) {
-  const res = await client.call({
-    _: "channels.toggleForum",
-    channel: await resolvePeer.resolveChannel(client, chatId),
-    enabled,
-    tabs: false
-  });
-  client.handleClientUpdate(res);
-}
 async function updateForumSettings(client, chatId, settings) {
   const res = await client.call({
     _: "channels.toggleForum",
@@ -24,5 +15,4 @@ async function updateForumSettings(client, chatId, settings) {
   });
   client.handleClientUpdate(res);
 }
-exports.toggleForum = toggleForum;
 exports.updateForumSettings = updateForumSettings;

package/highlevel/methods/forums/toggle-forum.d.cts

@@ -1,15 +1,5 @@
 import { ITelegramClient } from '../../client.types.js';
 import { InputPeerLike } from '../../types/index.js';
-/**
- * Set whether a supergroup is a forum.
- *
- * Only owner of the supergroup can change this setting.
- *
- * @param chatId  Chat ID or username
- * @param enabled  Whether the supergroup should be a forum
- * @deprecated Use {@link updateForumSettings} instead
- */
-export declare function toggleForum(client: ITelegramClient, chatId: InputPeerLike, enabled?: boolean): Promise<void>;
 /**
  * Update forum settings of a supergroup.
  *

package/highlevel/methods/forums/toggle-forum.d.ts

@@ -1,15 +1,5 @@
 import { ITelegramClient } from '../../client.types.js';
 import { InputPeerLike } from '../../types/index.js';
-/**
- * Set whether a supergroup is a forum.
- *
- * Only owner of the supergroup can change this setting.
- *
- * @param chatId  Chat ID or username
- * @param enabled  Whether the supergroup should be a forum
- * @deprecated Use {@link updateForumSettings} instead
- */
-export declare function toggleForum(client: ITelegramClient, chatId: InputPeerLike, enabled?: boolean): Promise<void>;
 /**
  * Update forum settings of a supergroup.
  *

package/highlevel/methods/forums/toggle-forum.js

@@ -1,13 +1,4 @@
 import { resolveChannel } from "../users/resolve-peer.js";
-async function toggleForum(client, chatId, enabled = false) {
-  const res = await client.call({
-    _: "channels.toggleForum",
-    channel: await resolveChannel(client, chatId),
-    enabled,
-    tabs: false
-  });
-  client.handleClientUpdate(res);
-}
 async function updateForumSettings(client, chatId, settings) {
   const res = await client.call({
     _: "channels.toggleForum",
@@ -18,6 +9,5 @@ async function updateForumSettings(client, chatId, settings) {
   client.handleClientUpdate(res);
 }
 export {
-  toggleForum,
   updateForumSettings
 };

package/highlevel/methods/premium/buy-resale-gift.cjs

@@ -9,11 +9,12 @@ const typeAssertions = require("../../../utils/type-assertions.cjs");
 const findInUpdate = require("../messages/find-in-update.cjs");
 const resolvePeer = require("../users/resolve-peer.cjs");
 async function buyResaleGift(client, params) {
-  const { slug, recipient, shouldDispatch } = params;
+  const { slug, recipient, shouldDispatch, ton } = params;
   const invoice = {
     _: "inputInvoiceStarGiftResale",
     slug,
-    toId: await resolvePeer.resolvePeer(client, recipient)
+    toId: await resolvePeer.resolvePeer(client, recipient),
+    ton
   };
   const form = await client.call({
     _: "payments.getPaymentForm",

package/highlevel/methods/premium/buy-resale-gift.d.cts

@@ -10,4 +10,6 @@ export declare function buyResaleGift(client: ITelegramClient, params: {
      * to the client's update handler.
      */
     shouldDispatch?: true;
+    /** Whether to use TON currency for payment */
+    ton?: boolean;
 }): Promise<Message | null>;

package/highlevel/methods/premium/buy-resale-gift.d.ts

@@ -10,4 +10,6 @@ export declare function buyResaleGift(client: ITelegramClient, params: {
      * to the client's update handler.
      */
     shouldDispatch?: true;
+    /** Whether to use TON currency for payment */
+    ton?: boolean;
 }): Promise<Message | null>;

package/highlevel/methods/premium/buy-resale-gift.js

@@ -2,11 +2,12 @@ import { assertTypeIs } from "../../../utils/type-assertions.js";
 import { _findMessageInUpdate } from "../messages/find-in-update.js";
 import { resolvePeer } from "../users/resolve-peer.js";
 async function buyResaleGift(client, params) {
-  const { slug, recipient, shouldDispatch } = params;
+  const { slug, recipient, shouldDispatch, ton } = params;
   const invoice = {
     _: "inputInvoiceStarGiftResale",
     slug,
-    toId: await resolvePeer(client, recipient)
+    toId: await resolvePeer(client, recipient),
+    ton
   };
   const form = await client.call({
     _: "payments.getPaymentForm",

package/highlevel/methods/premium/get-resale-star-gifts.cjs

@@ -63,7 +63,7 @@ function _normalizeResaleAttributes(attrs) {
   }
   return res;
 }
-async function getResaleOptions(client, params) {
+async function getStarGiftResaleOptions(client, params) {
   const res = await client.call({
     _: "payments.getResaleStarGifts",
     sortByNum: params.sort === "num",
@@ -104,4 +104,4 @@ async function getResaleOptions(client, params) {
   );
 }
 exports._normalizeResaleAttributes = _normalizeResaleAttributes;
-exports.getResaleOptions = getResaleOptions;
+exports.getStarGiftResaleOptions = getStarGiftResaleOptions;

package/highlevel/methods/premium/get-resale-star-gifts.d.cts

@@ -22,7 +22,7 @@ export interface ResaleStarGiftsMeta {
 /**
  * Get a list of star gifts up for resale
  */
-export declare function getResaleOptions(client: ITelegramClient, params: {
+export declare function getStarGiftResaleOptions(client: ITelegramClient, params: {
     /** ID of the gift to get resale options for */
     giftId: tl.Long;
     /**

package/highlevel/methods/premium/get-resale-star-gifts.d.ts

@@ -22,7 +22,7 @@ export interface ResaleStarGiftsMeta {
 /**
  * Get a list of star gifts up for resale
  */
-export declare function getResaleOptions(client: ITelegramClient, params: {
+export declare function getStarGiftResaleOptions(client: ITelegramClient, params: {
     /** ID of the gift to get resale options for */
     giftId: tl.Long;
     /**

package/highlevel/methods/premium/get-resale-star-gifts.js

@@ -56,7 +56,7 @@ function _normalizeResaleAttributes(attrs) {
   }
   return res;
 }
-async function getResaleOptions(client, params) {
+async function getStarGiftResaleOptions(client, params) {
   const res = await client.call({
     _: "payments.getResaleStarGifts",
     sortByNum: params.sort === "num",
@@ -98,5 +98,5 @@ async function getResaleOptions(client, params) {
 }
 export {
   _normalizeResaleAttributes,
-  getResaleOptions
+  getStarGiftResaleOptions
 };

package/highlevel/methods/premium/get-saved-star-gifts.cjs

@@ -16,7 +16,8 @@ async function getSavedStarGifts(client, params) {
     excludeUnsaved: params.excludeHidden,
     excludeSaved: params.excludePublic,
     excludeUnlimited: params.excludeUnlimited,
-    excludeLimited: params.excludeLimited,
+    excludeUnupgradable: params.excludeUnupgradable,
+    excludeUpgradable: params.excludeUpgradable,
     excludeUnique: params.excludeUnique,
     sortByValue: params.sortByValue,
     collectionId: params.collectionId,

package/highlevel/methods/premium/get-saved-star-gifts.d.cts

@@ -15,10 +15,12 @@ export declare function getSavedStarGifts(client: ITelegramClient, params: {
     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 exclude gifts that cannot be upgraded (either not limited or already upgraded) */
+    excludeUnupgradable?: boolean;
+    /** Whether to exclude gifts that can be upgraded */
+    excludeUpgradable?: boolean;
     /** ID of the collection to get gifts from */
     collectionId?: number;
     /** Whether to sort by value */

package/highlevel/methods/premium/get-saved-star-gifts.d.ts

@@ -15,10 +15,12 @@ export declare function getSavedStarGifts(client: ITelegramClient, params: {
     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 exclude gifts that cannot be upgraded (either not limited or already upgraded) */
+    excludeUnupgradable?: boolean;
+    /** Whether to exclude gifts that can be upgraded */
+    excludeUpgradable?: boolean;
     /** ID of the collection to get gifts from */
     collectionId?: number;
     /** Whether to sort by value */

package/highlevel/methods/premium/get-saved-star-gifts.js

@@ -9,7 +9,8 @@ async function getSavedStarGifts(client, params) {
     excludeUnsaved: params.excludeHidden,
     excludeSaved: params.excludePublic,
     excludeUnlimited: params.excludeUnlimited,
-    excludeLimited: params.excludeLimited,
+    excludeUnupgradable: params.excludeUnupgradable,
+    excludeUpgradable: params.excludeUpgradable,
     excludeUnique: params.excludeUnique,
     sortByValue: params.sortByValue,
     collectionId: params.collectionId,

package/highlevel/methods/{auth/run.cjs → premium/get-star-gift-value.cjs}

@@ -5,9 +5,12 @@ if (typeof globalThis !== "undefined" && !globalThis._MTCUTE_CJS_DEPRECATION_WAR
 }
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const utils = require("@fuman/utils");
-const start = require("./start.cjs");
-function run(client, params, then) {
-  start.start(client, params).then(then).catch((err) => client.onError.emit(utils.unknownToError(err)));
+const starGiftValue = require("../../types/premium/star-gift-value.cjs");
+async function getStarGiftValue(client, params) {
+  const res = await client.call({
+    _: "payments.getUniqueStarGiftValueInfo",
+    slug: params.slug
+  });
+  return new starGiftValue.StarGiftValue(res);
 }
-exports.run = run;
+exports.getStarGiftValue = getStarGiftValue;

package/highlevel/methods/premium/get-star-gift-value.d.cts

@@ -0,0 +1,9 @@
+import { ITelegramClient } from '../../client.types.js';
+import { StarGiftValue } from '../../types/premium/star-gift-value.js';
+/**
+ * Get the value of a unique star gift
+ */
+export declare function getStarGiftValue(client: ITelegramClient, params: {
+    /** Slug of the star gift */
+    slug: string;
+}): Promise<StarGiftValue>;

package/highlevel/methods/premium/get-star-gift-value.d.ts

@@ -0,0 +1,9 @@
+import { ITelegramClient } from '../../client.types.js';
+import { StarGiftValue } from '../../types/premium/star-gift-value.js';
+/**
+ * Get the value of a unique star gift
+ */
+export declare function getStarGiftValue(client: ITelegramClient, params: {
+    /** Slug of the star gift */
+    slug: string;
+}): Promise<StarGiftValue>;

package/highlevel/methods/premium/get-star-gift-value.js

@@ -0,0 +1,11 @@
+import { StarGiftValue as StarGiftValue$2 } from "../../types/premium/star-gift-value.js";
+async function getStarGiftValue(client, params) {
+  const res = await client.call({
+    _: "payments.getUniqueStarGiftValueInfo",
+    slug: params.slug
+  });
+  return new StarGiftValue$2(res);
+}
+export {
+  getStarGiftValue
+};