@mtcute/core 0.25.8 → 0.26.1

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';
@@ -22,15 +21,14 @@ import { SendCopyGroupParams } from './methods/messages/send-copy-group.js';
 import { SendCopyParams } from './methods/messages/send-copy.js';
 import { QuoteParamsFrom } from './methods/messages/send-quote.js';
 import { CanApplyBoostResult } from './methods/premium/can-apply-boost.js';
-import { InputStarGiftAttributeIds, ResaleStarGiftsMeta, getStarGiftResaleOptions } from './methods/premium/get-resale-star-gifts.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.
      *
@@ -4071,14 +4043,6 @@ export interface TelegramClient extends ITelegramClient {
         /** Limit for pagination */
         limit?: number;
     }): Promise<ArrayPaginatedWithMeta<StarGiftUnique, string, ResaleStarGiftsMeta>>;
-    /**
-     * Get a list of star gifts up for resale
-     *
-     * **Available**: ✅ both users and bots
-     *
-     * @deprecated Deprecated alias, use `getStarGiftResaleOptions` instead
-     */
-    getResaleOptions(params: Parameters<typeof getStarGiftResaleOptions>[1]): Promise<ArrayPaginatedWithMeta<StarGiftUnique, string, ResaleStarGiftsMeta>>;
     /** Get one or more saved star gifts by their IDs */
     getSavedStarGiftsById(gifts: MaybeArray<InputStarGift>): Promise<SavedStarGift[]>;
     /**
@@ -4097,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 */
@@ -4116,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;
@@ -4148,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
          *
@@ -4189,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>;
     /**
@@ -4248,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.
      *
@@ -4475,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
      *
@@ -4533,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
      *
@@ -4547,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
          *
@@ -5058,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.
@@ -5166,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/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/get-resale-star-gifts.cjs

@@ -103,9 +103,5 @@ async function getStarGiftResaleOptions(client, params) {
     res.nextOffset
   );
 }
-async function getResaleOptions(client, params) {
-  return getStarGiftResaleOptions(client, params);
-}
 exports._normalizeResaleAttributes = _normalizeResaleAttributes;
-exports.getResaleOptions = getResaleOptions;
 exports.getStarGiftResaleOptions = getStarGiftResaleOptions;

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

@@ -43,9 +43,3 @@ export declare function getStarGiftResaleOptions(client: ITelegramClient, params
     /** Limit for pagination */
     limit?: number;
 }): Promise<ArrayPaginatedWithMeta<StarGiftUnique, string, ResaleStarGiftsMeta>>;
-/**
- * Get a list of star gifts up for resale
- *
- * @deprecated Deprecated alias, use `getStarGiftResaleOptions` instead
- */
-export declare function getResaleOptions(client: ITelegramClient, params: Parameters<typeof getStarGiftResaleOptions>[1]): Promise<ArrayPaginatedWithMeta<StarGiftUnique, string, ResaleStarGiftsMeta>>;

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

@@ -43,9 +43,3 @@ export declare function getStarGiftResaleOptions(client: ITelegramClient, params
     /** Limit for pagination */
     limit?: number;
 }): Promise<ArrayPaginatedWithMeta<StarGiftUnique, string, ResaleStarGiftsMeta>>;
-/**
- * Get a list of star gifts up for resale
- *
- * @deprecated Deprecated alias, use `getStarGiftResaleOptions` instead
- */
-export declare function getResaleOptions(client: ITelegramClient, params: Parameters<typeof getStarGiftResaleOptions>[1]): Promise<ArrayPaginatedWithMeta<StarGiftUnique, string, ResaleStarGiftsMeta>>;

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

@@ -96,11 +96,7 @@ async function getStarGiftResaleOptions(client, params) {
     res.nextOffset
   );
 }
-async function getResaleOptions(client, params) {
-  return getStarGiftResaleOptions(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
+};

package/highlevel/methods/premium/get-stars-transactions.cjs

@@ -8,7 +8,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const starsStatus = require("../../types/premium/stars-status.cjs");
 const resolvePeer = require("../users/resolve-peer.cjs");
 async function getStarsTransactions(client, peerId, params) {
-  const { direction, sort, subscriptionId, offset = "", limit = 100 } = params ?? {};
+  const { direction, sort, subscriptionId, offset = "", limit = 100, ton } = params ?? {};
   const res = await client.call({
     _: "payments.getStarsTransactions",
     peer: await resolvePeer.resolvePeer(client, peerId),
@@ -17,7 +17,8 @@ async function getStarsTransactions(client, peerId, params) {
     outbound: direction === "outgoing",
     inbound: direction === "incoming",
     ascending: sort === "asc",
-    subscriptionId
+    subscriptionId,
+    ton
   });
   return new starsStatus.StarsStatus(res);
 }

package/highlevel/methods/premium/get-stars-transactions.d.cts

@@ -25,6 +25,8 @@ export declare function getStarsTransactions(client: ITelegramClient, peerId: In
     subscriptionId?: string;
     /** Pagination offset */
     offset?: string;
+    /** Whether to return transactions made in TON */
+    ton?: boolean;
     /**
      * Pagination limit
      *

package/highlevel/methods/premium/get-stars-transactions.d.ts

@@ -25,6 +25,8 @@ export declare function getStarsTransactions(client: ITelegramClient, peerId: In
     subscriptionId?: string;
     /** Pagination offset */
     offset?: string;
+    /** Whether to return transactions made in TON */
+    ton?: boolean;
     /**
      * Pagination limit
      *

package/highlevel/methods/premium/get-stars-transactions.js

@@ -1,7 +1,7 @@
 import { StarsStatus as StarsStatus$2 } from "../../types/premium/stars-status.js";
 import { resolvePeer } from "../users/resolve-peer.js";
 async function getStarsTransactions(client, peerId, params) {
-  const { direction, sort, subscriptionId, offset = "", limit = 100 } = params ?? {};
+  const { direction, sort, subscriptionId, offset = "", limit = 100, ton } = params ?? {};
   const res = await client.call({
     _: "payments.getStarsTransactions",
     peer: await resolvePeer(client, peerId),
@@ -10,7 +10,8 @@ async function getStarsTransactions(client, peerId, params) {
     outbound: direction === "outgoing",
     inbound: direction === "incoming",
     ascending: sort === "asc",
-    subscriptionId
+    subscriptionId,
+    ton
   });
   return new StarsStatus$2(res);
 }

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

@@ -9,25 +9,30 @@ const savedStarGift = require("../../types/premium/saved-star-gift.cjs");
 const resolvePeer = require("../users/resolve-peer.cjs");
 const peersIndex = require("../../types/peers/peers-index.cjs");
 async function* iterSavedStarGifts(client, params) {
-  const owner = await resolvePeer.resolvePeer(client, params.owner);
-  let offset = "";
+  const {
+    owner,
+    offset: offsetInitial = "",
+    chunkSize = 100,
+    limit = Infinity,
+    ...rest
+  } = params;
+  const ownerPeer = await resolvePeer.resolvePeer(client, owner);
+  let offset = offsetInitial;
+  let current = 0;
   while (true) {
     const res = await client.call({
       _: "payments.getSavedStarGifts",
-      peer: owner,
-      excludeUnsaved: params.excludeUnsaved,
-      excludeSaved: params.excludeSaved,
-      excludeUnlimited: params.excludeUnlimited,
-      excludeLimited: params.excludeLimited,
-      excludeUnique: params.excludeUnique,
-      sortByValue: params.sortByValue,
+      peer: ownerPeer,
       offset,
-      limit: params.limit ?? 100
+      limit: Math.min(chunkSize, limit - current),
+      ...rest
     });
     const peers = peersIndex.PeersIndex.from(res);
     yield* res.gifts.map((it) => new savedStarGift.SavedStarGift(it, peers));
     if (!res.nextOffset) break;
     offset = res.nextOffset;
+    current += res.gifts.length;
+    if (current >= limit) break;
   }
 }
 exports.iterSavedStarGifts = iterSavedStarGifts;

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

@@ -1,27 +1,21 @@
 import { ITelegramClient } from '../../client.types.js';
-import { InputPeerLike } from '../../types/index.js';
+import { getSavedStarGifts } from './get-saved-star-gifts.js';
 import { SavedStarGift } from '../../types/premium/saved-star-gift.js';
 /**
  * Iterate over saved star gifts of a user,
  * wrapper over {@link getSavedStarGifts}
  */
-export declare function iterSavedStarGifts(client: ITelegramClient, 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 */
+export declare function iterSavedStarGifts(client: ITelegramClient, 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>;