@mtcute/core 0.21.1 → 0.22.0

package/client.cjs

@@ -150,6 +150,7 @@ const getMessages = require("./highlevel/methods/messages/get-messages.cjs");
 const getReactionUsers = require("./highlevel/methods/messages/get-reaction-users.cjs");
 const getReplyTo = require("./highlevel/methods/messages/get-reply-to.cjs");
 const getScheduledMessages = require("./highlevel/methods/messages/get-scheduled-messages.cjs");
+const getWebPagePreview = require("./highlevel/methods/messages/get-web-page-preview.cjs");
 const iterHistory = require("./highlevel/methods/messages/iter-history.cjs");
 const iterReactionUsers = require("./highlevel/methods/messages/iter-reaction-users.cjs");
 const iterSearchGlobal = require("./highlevel/methods/messages/iter-search-global.cjs");
@@ -202,13 +203,12 @@ const getSavedStarGiftsById = require("./highlevel/methods/premium/get-saved-sta
 const getSavedStarGifts = require("./highlevel/methods/premium/get-saved-star-gifts.cjs");
 const getStarGiftOptions = require("./highlevel/methods/premium/get-star-gift-options.cjs");
 const getStarGiftWithdrawalUrl = require("./highlevel/methods/premium/get-star-gift-withdrawal-url.cjs");
-const getStarGifts = require("./highlevel/methods/premium/get-star-gifts.cjs");
 const getStarsTransactions = require("./highlevel/methods/premium/get-stars-transactions.cjs");
 const getUniqueStarGift = require("./highlevel/methods/premium/get-unique-star-gift.cjs");
 const iterBoosters = require("./highlevel/methods/premium/iter-boosters.cjs");
 const iterSavedStarGifts = require("./highlevel/methods/premium/iter-saved-star-gifts.cjs");
-const iterStarGifts = require("./highlevel/methods/premium/iter-star-gifts.cjs");
 const iterStarsTransactions = require("./highlevel/methods/premium/iter-stars-transactions.cjs");
+const pinStarGift = require("./highlevel/methods/premium/pin-star-gift.cjs");
 const sendStarGift = require("./highlevel/methods/premium/send-star-gift.cjs");
 const setBusinessIntro = require("./highlevel/methods/premium/set-business-intro.cjs");
 const setBusinessWorkHours = require("./highlevel/methods/premium/set-business-work-hours.cjs");
@@ -252,6 +252,7 @@ const getCommonChats = require("./highlevel/methods/users/get-common-chats.cjs")
 const getGlobalTtl = require("./highlevel/methods/users/get-global-ttl.cjs");
 const getMe = require("./highlevel/methods/users/get-me.cjs");
 const getMyUsername = require("./highlevel/methods/users/get-my-username.cjs");
+const getPeerSettings = require("./highlevel/methods/users/get-peer-settings.cjs");
 const getProfilePhoto = require("./highlevel/methods/users/get-profile-photo.cjs");
 const getProfilePhotos = require("./highlevel/methods/users/get-profile-photos.cjs");
 const getUsers = require("./highlevel/methods/users/get-users.cjs");
@@ -315,6 +316,7 @@ class TelegramClient {
     }
     Object.defineProperty(this, "log", { value: this._client.log });
     Object.defineProperty(this, "storage", { value: this._client.storage });
+    Object.defineProperty(this, "timers", { value: this._client.timers });
     Object.defineProperty(this, "stopSignal", { value: this._client.stopSignal });
     Object.defineProperty(this, "appConfig", { value: this._client.appConfig });
     Object.defineProperty(this, "onServerUpdate", { value: this._client.onServerUpdate });
@@ -881,6 +883,9 @@ TelegramClient.prototype.getReplyTo = function(...args) {
 TelegramClient.prototype.getScheduledMessages = function(...args) {
   return getScheduledMessages.getScheduledMessages(this._client, ...args);
 };
+TelegramClient.prototype.getWebPagePreview = function(...args) {
+  return getWebPagePreview.getWebPagePreview(this._client, ...args);
+};
 TelegramClient.prototype.iterHistory = function(...args) {
   return iterHistory.iterHistory(this._client, ...args);
 };
@@ -1070,9 +1075,6 @@ TelegramClient.prototype.getStarGiftOptions = function(...args) {
 TelegramClient.prototype.getStarGiftWithdrawalUrl = function(...args) {
   return getStarGiftWithdrawalUrl.getStarGiftWithdrawalUrl(this._client, ...args);
 };
-TelegramClient.prototype.getStarGifts = function(...args) {
-  return getStarGifts.getStarGifts(this._client, ...args);
-};
 TelegramClient.prototype.getStarsTransactions = function(...args) {
   return getStarsTransactions.getStarsTransactions(this._client, ...args);
 };
@@ -1085,12 +1087,12 @@ TelegramClient.prototype.iterBoosters = function(...args) {
 TelegramClient.prototype.iterSavedStarGifts = function(...args) {
   return iterSavedStarGifts.iterSavedStarGifts(this._client, ...args);
 };
-TelegramClient.prototype.iterStarGifts = function(...args) {
-  return iterStarGifts.iterStarGifts(this._client, ...args);
-};
 TelegramClient.prototype.iterStarsTransactions = function(...args) {
   return iterStarsTransactions.iterStarsTransactions(this._client, ...args);
 };
+TelegramClient.prototype.togglePinnedStarGifts = function(...args) {
+  return pinStarGift.togglePinnedStarGifts(this._client, ...args);
+};
 TelegramClient.prototype.sendStarGift = function(...args) {
   return sendStarGift.sendStarGift(this._client, ...args);
 };
@@ -1226,6 +1228,9 @@ TelegramClient.prototype.getMe = function(...args) {
 TelegramClient.prototype.getMyUsername = function(...args) {
   return getMyUsername.getMyUsername(this._client, ...args);
 };
+TelegramClient.prototype.getPeerSettings = function(...args) {
+  return getPeerSettings.getPeerSettings(this._client, ...args);
+};
 TelegramClient.prototype.getProfilePhoto = function(...args) {
   return getProfilePhoto.getProfilePhoto(this._client, ...args);
 };

package/client.js

@@ -143,6 +143,7 @@ import { getMessages } from "./highlevel/methods/messages/get-messages.js";
 import { getReactionUsers } from "./highlevel/methods/messages/get-reaction-users.js";
 import { getReplyTo } from "./highlevel/methods/messages/get-reply-to.js";
 import { getScheduledMessages } from "./highlevel/methods/messages/get-scheduled-messages.js";
+import { getWebPagePreview } from "./highlevel/methods/messages/get-web-page-preview.js";
 import { iterHistory } from "./highlevel/methods/messages/iter-history.js";
 import { iterReactionUsers } from "./highlevel/methods/messages/iter-reaction-users.js";
 import { iterSearchGlobal } from "./highlevel/methods/messages/iter-search-global.js";
@@ -195,13 +196,12 @@ import { getSavedStarGiftsById } from "./highlevel/methods/premium/get-saved-sta
 import { getSavedStarGifts } from "./highlevel/methods/premium/get-saved-star-gifts.js";
 import { getStarGiftOptions } from "./highlevel/methods/premium/get-star-gift-options.js";
 import { getStarGiftWithdrawalUrl } from "./highlevel/methods/premium/get-star-gift-withdrawal-url.js";
-import { getStarGifts } from "./highlevel/methods/premium/get-star-gifts.js";
 import { getStarsTransactions } from "./highlevel/methods/premium/get-stars-transactions.js";
 import { getUniqueStarGift } from "./highlevel/methods/premium/get-unique-star-gift.js";
 import { iterBoosters } from "./highlevel/methods/premium/iter-boosters.js";
 import { iterSavedStarGifts } from "./highlevel/methods/premium/iter-saved-star-gifts.js";
-import { iterStarGifts } from "./highlevel/methods/premium/iter-star-gifts.js";
 import { iterStarsTransactions } from "./highlevel/methods/premium/iter-stars-transactions.js";
+import { togglePinnedStarGifts } from "./highlevel/methods/premium/pin-star-gift.js";
 import { sendStarGift } from "./highlevel/methods/premium/send-star-gift.js";
 import { setBusinessIntro } from "./highlevel/methods/premium/set-business-intro.js";
 import { setBusinessWorkHours } from "./highlevel/methods/premium/set-business-work-hours.js";
@@ -245,6 +245,7 @@ import { getCommonChats } from "./highlevel/methods/users/get-common-chats.js";
 import { getGlobalTtl } from "./highlevel/methods/users/get-global-ttl.js";
 import { getMe } from "./highlevel/methods/users/get-me.js";
 import { getMyUsername } from "./highlevel/methods/users/get-my-username.js";
+import { getPeerSettings } from "./highlevel/methods/users/get-peer-settings.js";
 import { getProfilePhoto } from "./highlevel/methods/users/get-profile-photo.js";
 import { getProfilePhotos } from "./highlevel/methods/users/get-profile-photos.js";
 import { getUsers } from "./highlevel/methods/users/get-users.js";
@@ -308,6 +309,7 @@ class TelegramClient {
     }
     Object.defineProperty(this, "log", { value: this._client.log });
     Object.defineProperty(this, "storage", { value: this._client.storage });
+    Object.defineProperty(this, "timers", { value: this._client.timers });
     Object.defineProperty(this, "stopSignal", { value: this._client.stopSignal });
     Object.defineProperty(this, "appConfig", { value: this._client.appConfig });
     Object.defineProperty(this, "onServerUpdate", { value: this._client.onServerUpdate });
@@ -874,6 +876,9 @@ TelegramClient.prototype.getReplyTo = function(...args) {
 TelegramClient.prototype.getScheduledMessages = function(...args) {
   return getScheduledMessages(this._client, ...args);
 };
+TelegramClient.prototype.getWebPagePreview = function(...args) {
+  return getWebPagePreview(this._client, ...args);
+};
 TelegramClient.prototype.iterHistory = function(...args) {
   return iterHistory(this._client, ...args);
 };
@@ -1063,9 +1068,6 @@ TelegramClient.prototype.getStarGiftOptions = function(...args) {
 TelegramClient.prototype.getStarGiftWithdrawalUrl = function(...args) {
   return getStarGiftWithdrawalUrl(this._client, ...args);
 };
-TelegramClient.prototype.getStarGifts = function(...args) {
-  return getStarGifts(this._client, ...args);
-};
 TelegramClient.prototype.getStarsTransactions = function(...args) {
   return getStarsTransactions(this._client, ...args);
 };
@@ -1078,12 +1080,12 @@ TelegramClient.prototype.iterBoosters = function(...args) {
 TelegramClient.prototype.iterSavedStarGifts = function(...args) {
   return iterSavedStarGifts(this._client, ...args);
 };
-TelegramClient.prototype.iterStarGifts = function(...args) {
-  return iterStarGifts(this._client, ...args);
-};
 TelegramClient.prototype.iterStarsTransactions = function(...args) {
   return iterStarsTransactions(this._client, ...args);
 };
+TelegramClient.prototype.togglePinnedStarGifts = function(...args) {
+  return togglePinnedStarGifts(this._client, ...args);
+};
 TelegramClient.prototype.sendStarGift = function(...args) {
   return sendStarGift(this._client, ...args);
 };
@@ -1219,6 +1221,9 @@ TelegramClient.prototype.getMe = function(...args) {
 TelegramClient.prototype.getMyUsername = function(...args) {
   return getMyUsername(this._client, ...args);
 };
+TelegramClient.prototype.getPeerSettings = function(...args) {
+  return getPeerSettings(this._client, ...args);
+};
 TelegramClient.prototype.getProfilePhoto = function(...args) {
   return getProfilePhoto(this._client, ...args);
 };

package/highlevel/client.d.cts

@@ -23,7 +23,7 @@ import { QuoteParamsFrom } from './methods/messages/send-quote.js';
 import { CanApplyBoostResult } from './methods/premium/can-apply-boost.js';
 import { CanSendStoryResult } from './methods/stories/can-send-story.js';
 import { ITelegramStorageProvider } from './storage/provider.js';
-import { AllStories, ArrayPaginated, ArrayWithTotal, Boost, BoostSlot, BoostStats, BotChatJoinRequestUpdate, BotCommands, BotReactionCountUpdate, BotReactionUpdate, BotStoppedUpdate, BusinessCallbackQuery, BusinessChatLink, BusinessConnection, BusinessMessage, BusinessWorkHoursDay, CallbackQuery, Chat, ChatEvent, ChatInviteLink, ChatInviteLinkMember, ChatJoinRequestUpdate, ChatlistPreview, ChatMember, ChatMemberUpdate, ChatPreview, ChosenInlineResult, CollectibleInfo, DeleteBusinessMessageUpdate, DeleteMessageUpdate, DeleteStoryUpdate, Dialog, FactCheck, FileDownloadLocation, FileDownloadParameters, ForumTopic, FullChat, FullUser, GameHighScore, HistoryReadUpdate, InlineCallbackQuery, InlineQuery, InputChatEventFilters, InputDialogFolder, InputFileLike, InputInlineResult, InputMediaLike, InputMediaSticker, InputMessageId, InputPeerLike, InputPrivacyRule, InputReaction, InputStarGift, InputStickerSet, InputStickerSetItem, InputText, InputWebview, MaybeDynamic, Message, MessageEffect, MessageMedia, MessageReactions, ParametersSkip2, ParsedUpdate, Peer, PeerReaction, PeerStories, Photo, Poll, PollUpdate, PollVoteUpdate, PreCheckoutQuery, RawDocument, ReplyMarkup, SavedStarGift, SentCode, StarGift, StarGiftUnique, StarsStatus, StarsTransaction, Sticker, StickerSet, StickerType, StoriesStealthMode, Story, StoryInteractions, StoryUpdate, StoryViewer, StoryViewersList, TakeoutSession, TextWithEntities, TypingStatus, UploadedFile, UploadFileLike, User, UserStarGift, UserStatusUpdate, UserTypingUpdate, WebviewResult } from './types/index.js';
+import { AllStories, ArrayPaginated, ArrayWithTotal, Boost, BoostSlot, BoostStats, BotChatJoinRequestUpdate, BotCommands, BotReactionCountUpdate, BotReactionUpdate, BotStoppedUpdate, BusinessCallbackQuery, BusinessChatLink, BusinessConnection, BusinessMessage, BusinessWorkHoursDay, CallbackQuery, Chat, ChatEvent, ChatInviteLink, ChatInviteLinkMember, ChatJoinRequestUpdate, ChatlistPreview, ChatMember, ChatMemberUpdate, ChatPreview, ChosenInlineResult, CollectibleInfo, DeleteBusinessMessageUpdate, DeleteMessageUpdate, DeleteStoryUpdate, Dialog, FactCheck, FileDownloadLocation, FileDownloadParameters, ForumTopic, FullChat, FullUser, GameHighScore, HistoryReadUpdate, InlineCallbackQuery, InlineQuery, InputChatEventFilters, InputDialogFolder, InputFileLike, InputInlineResult, InputMediaLike, InputMediaSticker, InputMessageId, InputPeerLike, InputPrivacyRule, InputReaction, InputStarGift, InputStickerSet, InputStickerSetItem, InputText, InputWebview, MaybeDynamic, Message, MessageEffect, MessageMedia, MessageReactions, ParametersSkip2, ParsedUpdate, 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 { ParsedUpdateHandlerParams } from './updates/parsed.js';
 import { RawUpdateInfo } from './updates/types.js';
 import { InputStringSessionData } from './utils/string-session.js';
@@ -36,7 +36,6 @@ 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 { getStarGifts } from './methods/premium/get-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';
@@ -3026,6 +3025,14 @@ export interface TelegramClient extends ITelegramClient {
      * @param messageIds  Scheduled messages IDs
      */
     getScheduledMessages(chatId: InputPeerLike, messageIds: MaybeArray<number>): Promise<(Message | null)[]>;
+    /**
+     * Get a preview of a web page contained in the message
+     *
+     * **Available**: 👤 users only
+     *
+     * @param text  Text of the message, or simply the link for which the preview should be retrieved
+     */
+    getWebPagePreview(text: InputText): Promise<WebPageMedia | null>;
     /**
      * Iterate over chat history. Wrapper over {@link getHistory}
      *
@@ -3521,8 +3528,14 @@ export interface TelegramClient extends ITelegramClient {
      *   The message is normally available for users, but may not be available for bots in PMs.
      */
     sendPaidReaction(params: InputMessageId & {
-        /** Whether to send the reaction anonymously */
+        /**
+         * Whether to send the reaction anonymously
+         */
         anonymous?: boolean;
+        /**
+         * Peer as which to send the reaction, mutually exclusive with `anonymous`
+         */
+        asPeer?: InputPeerLike;
         /**
          * Number of reactions to send
          *
@@ -3981,27 +3994,6 @@ export interface TelegramClient extends ITelegramClient {
         /** 2FA password */
         password: string;
     }): Promise<string>;
-    /**
-     * Get a list of gifts sent to a user.
-     *
-     * **Available**: ✅ both users and bots
-     *
-     * @param userId  User whose gifts to fetch
-     * @deprecated  Use {@link getSavedStarGifts} instead
-     * @returns  Gifts sent to the user
-     */
-    getStarGifts(userId: InputPeerLike, params?: {
-        /**
-         * Offset for pagination.
-         */
-        offset?: string;
-        /**
-         * Maximum number of gifts to fetch.
-         *
-         * @default  100
-         */
-        limit?: number;
-    }): Promise<ArrayPaginated<SavedStarGift, string>>;
     /**
      * Get Telegram Stars transactions for a given peer.
      *
@@ -4085,31 +4077,6 @@ export interface TelegramClient extends ITelegramClient {
         /** Limit for pagination */
         limit?: number;
     }): AsyncIterableIterator<SavedStarGift>;
-    /**
-     * Iterate over gifts sent to a given user.
-     *
-     * Wrapper over {@link getStarGifts}
-     *
-     * **Available**: 👤 users only
-     *
-     * @param peerId  Peer ID
-     * @param params  Additional parameters
-     */
-    iterStarGifts(peerId: InputPeerLike, params?: Parameters<typeof getStarGifts>[2] & {
-        /**
-         * Total number of gifts to fetch
-         *
-         * @default  Infinity, i.e. fetch all gifts
-         */
-        limit?: number;
-        /**
-         * Number of gifts to fetch per request
-         * Usually you don't need to change this
-         *
-         * @default  100
-         */
-        chunkSize?: number;
-    }): AsyncIterableIterator<UserStarGift>;
     /**
      * Iterate over Telegram Stars transactions for a given peer.
      *
@@ -4138,6 +4105,15 @@ export interface TelegramClient extends ITelegramClient {
          */
         chunkSize?: number;
     }): AsyncIterableIterator<StarsTransaction>;
+    /**
+     * Toggles whether one or more star gift is pinned to the top of the list
+     */
+    togglePinnedStarGifts(params: {
+        /** One or more gifts to pin */
+        gifts: MaybeArray<InputStarGift>;
+        /** Peer where the gift is sent */
+        peer: InputPeerLike;
+    }): Promise<void>;
     /**
      * Send a star gift to a user.
      *
@@ -4901,6 +4877,8 @@ export interface TelegramClient extends ITelegramClient {
      *
      */
     getMyUsername(): Promise<string | null>;
+    /** Get {@link PeerSettings} for a peer */
+    getPeerSettings(peerId: InputPeerLike): Promise<PeerSettings>;
     /**
      * Get a single profile picture of a user by its ID
      *

package/highlevel/client.d.ts

@@ -23,7 +23,7 @@ import { QuoteParamsFrom } from './methods/messages/send-quote.js';
 import { CanApplyBoostResult } from './methods/premium/can-apply-boost.js';
 import { CanSendStoryResult } from './methods/stories/can-send-story.js';
 import { ITelegramStorageProvider } from './storage/provider.js';
-import { AllStories, ArrayPaginated, ArrayWithTotal, Boost, BoostSlot, BoostStats, BotChatJoinRequestUpdate, BotCommands, BotReactionCountUpdate, BotReactionUpdate, BotStoppedUpdate, BusinessCallbackQuery, BusinessChatLink, BusinessConnection, BusinessMessage, BusinessWorkHoursDay, CallbackQuery, Chat, ChatEvent, ChatInviteLink, ChatInviteLinkMember, ChatJoinRequestUpdate, ChatlistPreview, ChatMember, ChatMemberUpdate, ChatPreview, ChosenInlineResult, CollectibleInfo, DeleteBusinessMessageUpdate, DeleteMessageUpdate, DeleteStoryUpdate, Dialog, FactCheck, FileDownloadLocation, FileDownloadParameters, ForumTopic, FullChat, FullUser, GameHighScore, HistoryReadUpdate, InlineCallbackQuery, InlineQuery, InputChatEventFilters, InputDialogFolder, InputFileLike, InputInlineResult, InputMediaLike, InputMediaSticker, InputMessageId, InputPeerLike, InputPrivacyRule, InputReaction, InputStarGift, InputStickerSet, InputStickerSetItem, InputText, InputWebview, MaybeDynamic, Message, MessageEffect, MessageMedia, MessageReactions, ParametersSkip2, ParsedUpdate, Peer, PeerReaction, PeerStories, Photo, Poll, PollUpdate, PollVoteUpdate, PreCheckoutQuery, RawDocument, ReplyMarkup, SavedStarGift, SentCode, StarGift, StarGiftUnique, StarsStatus, StarsTransaction, Sticker, StickerSet, StickerType, StoriesStealthMode, Story, StoryInteractions, StoryUpdate, StoryViewer, StoryViewersList, TakeoutSession, TextWithEntities, TypingStatus, UploadedFile, UploadFileLike, User, UserStarGift, UserStatusUpdate, UserTypingUpdate, WebviewResult } from './types/index.js';
+import { AllStories, ArrayPaginated, ArrayWithTotal, Boost, BoostSlot, BoostStats, BotChatJoinRequestUpdate, BotCommands, BotReactionCountUpdate, BotReactionUpdate, BotStoppedUpdate, BusinessCallbackQuery, BusinessChatLink, BusinessConnection, BusinessMessage, BusinessWorkHoursDay, CallbackQuery, Chat, ChatEvent, ChatInviteLink, ChatInviteLinkMember, ChatJoinRequestUpdate, ChatlistPreview, ChatMember, ChatMemberUpdate, ChatPreview, ChosenInlineResult, CollectibleInfo, DeleteBusinessMessageUpdate, DeleteMessageUpdate, DeleteStoryUpdate, Dialog, FactCheck, FileDownloadLocation, FileDownloadParameters, ForumTopic, FullChat, FullUser, GameHighScore, HistoryReadUpdate, InlineCallbackQuery, InlineQuery, InputChatEventFilters, InputDialogFolder, InputFileLike, InputInlineResult, InputMediaLike, InputMediaSticker, InputMessageId, InputPeerLike, InputPrivacyRule, InputReaction, InputStarGift, InputStickerSet, InputStickerSetItem, InputText, InputWebview, MaybeDynamic, Message, MessageEffect, MessageMedia, MessageReactions, ParametersSkip2, ParsedUpdate, 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 { ParsedUpdateHandlerParams } from './updates/parsed.js';
 import { RawUpdateInfo } from './updates/types.js';
 import { InputStringSessionData } from './utils/string-session.js';
@@ -36,7 +36,6 @@ 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 { getStarGifts } from './methods/premium/get-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';
@@ -3026,6 +3025,14 @@ export interface TelegramClient extends ITelegramClient {
      * @param messageIds  Scheduled messages IDs
      */
     getScheduledMessages(chatId: InputPeerLike, messageIds: MaybeArray<number>): Promise<(Message | null)[]>;
+    /**
+     * Get a preview of a web page contained in the message
+     *
+     * **Available**: 👤 users only
+     *
+     * @param text  Text of the message, or simply the link for which the preview should be retrieved
+     */
+    getWebPagePreview(text: InputText): Promise<WebPageMedia | null>;
     /**
      * Iterate over chat history. Wrapper over {@link getHistory}
      *
@@ -3521,8 +3528,14 @@ export interface TelegramClient extends ITelegramClient {
      *   The message is normally available for users, but may not be available for bots in PMs.
      */
     sendPaidReaction(params: InputMessageId & {
-        /** Whether to send the reaction anonymously */
+        /**
+         * Whether to send the reaction anonymously
+         */
         anonymous?: boolean;
+        /**
+         * Peer as which to send the reaction, mutually exclusive with `anonymous`
+         */
+        asPeer?: InputPeerLike;
         /**
          * Number of reactions to send
          *
@@ -3981,27 +3994,6 @@ export interface TelegramClient extends ITelegramClient {
         /** 2FA password */
         password: string;
     }): Promise<string>;
-    /**
-     * Get a list of gifts sent to a user.
-     *
-     * **Available**: ✅ both users and bots
-     *
-     * @param userId  User whose gifts to fetch
-     * @deprecated  Use {@link getSavedStarGifts} instead
-     * @returns  Gifts sent to the user
-     */
-    getStarGifts(userId: InputPeerLike, params?: {
-        /**
-         * Offset for pagination.
-         */
-        offset?: string;
-        /**
-         * Maximum number of gifts to fetch.
-         *
-         * @default  100
-         */
-        limit?: number;
-    }): Promise<ArrayPaginated<SavedStarGift, string>>;
     /**
      * Get Telegram Stars transactions for a given peer.
      *
@@ -4085,31 +4077,6 @@ export interface TelegramClient extends ITelegramClient {
         /** Limit for pagination */
         limit?: number;
     }): AsyncIterableIterator<SavedStarGift>;
-    /**
-     * Iterate over gifts sent to a given user.
-     *
-     * Wrapper over {@link getStarGifts}
-     *
-     * **Available**: 👤 users only
-     *
-     * @param peerId  Peer ID
-     * @param params  Additional parameters
-     */
-    iterStarGifts(peerId: InputPeerLike, params?: Parameters<typeof getStarGifts>[2] & {
-        /**
-         * Total number of gifts to fetch
-         *
-         * @default  Infinity, i.e. fetch all gifts
-         */
-        limit?: number;
-        /**
-         * Number of gifts to fetch per request
-         * Usually you don't need to change this
-         *
-         * @default  100
-         */
-        chunkSize?: number;
-    }): AsyncIterableIterator<UserStarGift>;
     /**
      * Iterate over Telegram Stars transactions for a given peer.
      *
@@ -4138,6 +4105,15 @@ export interface TelegramClient extends ITelegramClient {
          */
         chunkSize?: number;
     }): AsyncIterableIterator<StarsTransaction>;
+    /**
+     * Toggles whether one or more star gift is pinned to the top of the list
+     */
+    togglePinnedStarGifts(params: {
+        /** One or more gifts to pin */
+        gifts: MaybeArray<InputStarGift>;
+        /** Peer where the gift is sent */
+        peer: InputPeerLike;
+    }): Promise<void>;
     /**
      * Send a star gift to a user.
      *
@@ -4901,6 +4877,8 @@ export interface TelegramClient extends ITelegramClient {
      *
      */
     getMyUsername(): Promise<string | null>;
+    /** Get {@link PeerSettings} for a peer */
+    getPeerSettings(peerId: InputPeerLike): Promise<PeerSettings>;
     /**
      * Get a single profile picture of a user by its ID
      *

package/highlevel/methods/auth/sign-in-qr.cjs

@@ -7,9 +7,9 @@ if (typeof globalThis !== "undefined" && !globalThis._MTCUTE_CJS_DEPRECATION_WAR
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const utils = require("@fuman/utils");
 const tl = require("@mtcute/tl");
-const miscUtils$1 = require("../../../utils/misc-utils.cjs");
+const miscUtils = require("../../../utils/misc-utils.cjs");
 const typeAssertions = require("../../../utils/type-assertions.cjs");
-const miscUtils = require("../../utils/misc-utils.cjs");
+const miscUtils$1 = require("../../utils/misc-utils.cjs");
 const checkPassword = require("./check-password.cjs");
 const user = require("../../types/peers/user.cjs");
 async function signInQr(client, params) {
@@ -30,7 +30,7 @@ async function signInQr(client, params) {
   async function handle2fa(input) {
     const isDynamic = typeof input === "function";
     while (true) {
-      const password = await miscUtils.resolveMaybeDynamic(input);
+      const password = await miscUtils$1.resolveMaybeDynamic(input);
       try {
         return await checkPassword.checkPassword(client, {
           password,
@@ -81,7 +81,7 @@ async function signInQr(client, params) {
           waiter = new utils.Deferred();
           await Promise.race([
             waiter.promise,
-            miscUtils$1.sleepWithAbort(res.expires * 1e3 - Date.now(), client.stopSignal)
+            miscUtils.sleepWithAbort(res.expires * 1e3 - Date.now(), client.stopSignal)
           ]);
           break;
         case "auth.loginTokenMigrateTo": {

package/highlevel/methods/files/download-iterable.cjs

@@ -9,9 +9,11 @@ const utils = require("@fuman/utils");
 const fileId = require("@mtcute/file-id");
 const tl = require("@mtcute/tl");
 const errors = require("../../../types/errors.cjs");
+const peerUtils = require("../../../utils/peer-utils.cjs");
 const convertFileId = require("../../utils/convert-file-id.cjs");
 const fileUtils = require("../../utils/file-utils.cjs");
 const fileLocation = require("../../types/files/file-location.cjs");
+const errors$1 = require("../../types/errors.cjs");
 const SMALL_FILE_MAX_SIZE = 131072;
 const REQUESTS_PER_CONNECTION = 3;
 async function* downloadAsIterable(client, input, params) {
@@ -47,6 +49,29 @@ async function* downloadAsIterable(client, input, params) {
     location = input;
   }
   const isWeb = tl.tl.isAnyInputWebFileLocation(location);
+  if (location._ === "inputPeerPhotoFileLocation") {
+    if (location.peer._ === "mtcute.dummyInputPeerMinUser" || location.peer._ === "mtcute.dummyInputPeerMinChannel") {
+      const peerId = location.peer._ === "mtcute.dummyInputPeerMinUser" ? location.peer.userId : peerUtils.toggleChannelIdMark(location.peer.channelId);
+      const accessHash = await client.storage.peers.getMinAccessHash(peerId);
+      if (!accessHash) {
+        throw new errors$1.MtPeerNotFoundError(`Peer ${peerId} not found`);
+      }
+      location = {
+        _: "inputPeerPhotoFileLocation",
+        peer: location.peer._ === "mtcute.dummyInputPeerMinUser" ? {
+          _: "inputPeerUser",
+          userId: location.peer.userId,
+          accessHash
+        } : {
+          _: "inputPeerChannel",
+          channelId: location.peer.channelId,
+          accessHash
+        },
+        photoId: location.photoId,
+        big: location.big
+      };
+    }
+  }
   const primaryDcId = await client.getPrimaryDcId();
   if (!dcId) dcId = primaryDcId;
   const partSizeKb = params?.partSize ?? (fileSize ? fileUtils.determinePartSize(fileSize) : 64);

package/highlevel/methods/files/download-iterable.js

@@ -2,9 +2,11 @@ import { ConditionVariable } from "@fuman/utils";
 import { parseFileId } from "@mtcute/file-id";
 import { tl } from "@mtcute/tl";
 import { MtArgumentError, MtUnsupportedError } from "../../../types/errors.js";
+import { toggleChannelIdMark } from "../../../utils/peer-utils.js";
 import { fileIdToInputWebFileLocation, fileIdToInputFileLocation } from "../../utils/convert-file-id.js";
 import { determinePartSize } from "../../utils/file-utils.js";
 import { FileLocation as FileLocation$1 } from "../../types/files/file-location.js";
+import { MtPeerNotFoundError } from "../../types/errors.js";
 const SMALL_FILE_MAX_SIZE = 131072;
 const REQUESTS_PER_CONNECTION = 3;
 async function* downloadAsIterable(client, input, params) {
@@ -40,6 +42,29 @@ async function* downloadAsIterable(client, input, params) {
     location = input;
   }
   const isWeb = tl.isAnyInputWebFileLocation(location);
+  if (location._ === "inputPeerPhotoFileLocation") {
+    if (location.peer._ === "mtcute.dummyInputPeerMinUser" || location.peer._ === "mtcute.dummyInputPeerMinChannel") {
+      const peerId = location.peer._ === "mtcute.dummyInputPeerMinUser" ? location.peer.userId : toggleChannelIdMark(location.peer.channelId);
+      const accessHash = await client.storage.peers.getMinAccessHash(peerId);
+      if (!accessHash) {
+        throw new MtPeerNotFoundError(`Peer ${peerId} not found`);
+      }
+      location = {
+        _: "inputPeerPhotoFileLocation",
+        peer: location.peer._ === "mtcute.dummyInputPeerMinUser" ? {
+          _: "inputPeerUser",
+          userId: location.peer.userId,
+          accessHash
+        } : {
+          _: "inputPeerChannel",
+          channelId: location.peer.channelId,
+          accessHash
+        },
+        photoId: location.photoId,
+        big: location.big
+      };
+    }
+  }
   const primaryDcId = await client.getPrimaryDcId();
   if (!dcId) dcId = primaryDcId;
   const partSizeKb = params?.partSize ?? (fileSize ? determinePartSize(fileSize) : 64);

package/highlevel/methods/files/upload-file.js

@@ -2,7 +2,7 @@ import { Bytes, webReadableToFuman, read } from "@fuman/io";
 import { AsyncLock } from "@fuman/utils";
 import { MtArgumentError } from "../../../types/errors.js";
 import { randomLong } from "../../../utils/long-utils.js";
-import { guessFileMime, MIME_TO_EXTENSION } from "../../utils/file-type.js";
+import { MIME_TO_EXTENSION, guessFileMime } from "../../utils/file-type.js";
 import { determinePartSize, isProbablyPlainText } from "../../utils/file-utils.js";
 const OVERRIDE_MIME = {
   // tg doesn't interpret `audio/opus` files as voice messages for some reason

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

@@ -47,7 +47,8 @@ async function forwardMessagesById(client, params) {
     sendAs: sendAs ? await resolvePeer.resolvePeer(client, sendAs) : void 0,
     quickReplyShortcut: sendCommon._normalizeQuickReplyShortcut(params.quickReply),
     allowPaidFloodskip,
-    videoTimestamp
+    videoTimestamp,
+    allowPaidStars: params.allowPaidMessages
   });
   utils.assertIsUpdatesGroup("messages.forwardMessages", res);
   client.handleClientUpdate(res, !params.shouldDispatch);

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

@@ -1,3 +1,4 @@
+import { tl } from '@mtcute/tl';
 import { ITelegramClient } from '../../client.types.js';
 import { InputPeerLike, Message } from '../../types/index.js';
 export interface ForwardMessageOptions {
@@ -57,6 +58,11 @@ export interface ForwardMessageOptions {
      * The Stars will be withdrawn from the bot's balance.
      */
     allowPaidFloodskip?: boolean;
+    /**
+     * Whether to allow payment for messages.
+     * If set, the value represents the maximum number of stars to be paid
+     */
+    allowPaidMessages?: tl.Long;
     /** Video timestamp to use for the forwarded video */
     videoTimestamp?: number;
 }

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

@@ -1,3 +1,4 @@
+import { tl } from '@mtcute/tl';
 import { ITelegramClient } from '../../client.types.js';
 import { InputPeerLike, Message } from '../../types/index.js';
 export interface ForwardMessageOptions {
@@ -57,6 +58,11 @@ export interface ForwardMessageOptions {
      * The Stars will be withdrawn from the bot's balance.
      */
     allowPaidFloodskip?: boolean;
+    /**
+     * Whether to allow payment for messages.
+     * If set, the value represents the maximum number of stars to be paid
+     */
+    allowPaidMessages?: tl.Long;
     /** Video timestamp to use for the forwarded video */
     videoTimestamp?: number;
 }

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

@@ -40,7 +40,8 @@ async function forwardMessagesById(client, params) {
     sendAs: sendAs ? await resolvePeer(client, sendAs) : void 0,
     quickReplyShortcut: _normalizeQuickReplyShortcut(params.quickReply),
     allowPaidFloodskip,
-    videoTimestamp
+    videoTimestamp,
+    allowPaidStars: params.allowPaidMessages
   });
   assertIsUpdatesGroup("messages.forwardMessages", res);
   client.handleClientUpdate(res, !params.shouldDispatch);

package/highlevel/methods/messages/get-web-page-preview.cjs

@@ -0,0 +1,22 @@
+if (typeof globalThis !== "undefined" && !globalThis._MTCUTE_CJS_DEPRECATION_WARNED) {
+  globalThis._MTCUTE_CJS_DEPRECATION_WARNED = true;
+  console.warn("[@mtcute/core] CommonJS support is deprecated and will be removed in 0.25.0. Please consider switching to ESM, it's " + (/* @__PURE__ */ new Date()).getFullYear() + " already.");
+  console.warn("[@mtcute/core] Learn more about switching to ESM: https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c");
+}
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const utils = require("@fuman/utils");
+const webPage = require("../../types/media/web-page.cjs");
+const normalizeText = require("../misc/normalize-text.cjs");
+async function getWebPagePreview(client, text) {
+  const [message, entities] = await normalizeText._normalizeInputText(client, text);
+  const res = await client.call({
+    _: "messages.getWebPagePreview",
+    message,
+    entities
+  });
+  if (res.media._ === "messageMediaEmpty") return null;
+  utils.assert(res.media._ === "messageMediaWebPage");
+  return new webPage.WebPageMedia(res.media);
+}
+exports.getWebPagePreview = getWebPagePreview;

package/highlevel/methods/messages/get-web-page-preview.d.cts

@@ -0,0 +1,9 @@
+import { ITelegramClient } from '../../client.types.js';
+import { InputText } from '../../types/misc/entities.js';
+import { WebPageMedia } from '../../types/media/web-page.js';
+/**
+ * Get a preview of a web page contained in the message
+ *
+ * @param text  Text of the message, or simply the link for which the preview should be retrieved
+ */
+export declare function getWebPagePreview(client: ITelegramClient, text: InputText): Promise<WebPageMedia | null>;