feat!: updated to layer 189

breaking:
- removed `reportStory` method (report flow changed, and i dont want to get into it rn)
- removed `sourceType` from SticketSet as stickersets can now be mixed

packages/core/src/highlevel/client.ts

@@ -14,7 +14,7 @@ import { MtUnsupportedError } from '../types/index.js'
 import type { BaseTelegramClientOptions } from './base.js'
 import { BaseTelegramClient } from './base.js'
 import type { ITelegramClient } from './client.types.js'
-import type { AllStories, ArrayPaginated, ArrayWithTotal, Boost, BoostSlot, BoostStats, BotChatJoinRequestUpdate, BotCommands, BotReactionCountUpdate, BotReactionUpdate, BotStoppedUpdate, BusinessCallbackQuery, BusinessChatLink, BusinessConnection, BusinessMessage, BusinessWorkHoursDay, CallbackQuery, Chat, ChatEvent, ChatInviteLink, ChatInviteLinkMember, ChatJoinRequestUpdate, ChatMember, ChatMemberUpdate, ChatPreview, ChatlistPreview, ChosenInlineResult, CollectibleInfo, DeleteBusinessMessageUpdate, DeleteMessageUpdate, DeleteStoryUpdate, Dialog, FactCheck, FileDownloadLocation, FileDownloadParameters, ForumTopic, FullChat, GameHighScore, HistoryReadUpdate, InlineCallbackQuery, InlineQuery, InputChatEventFilters, InputDialogFolder, InputFileLike, InputInlineResult, InputMediaLike, InputMediaSticker, InputMessageId, InputPeerLike, InputPrivacyRule, InputReaction, InputStickerSet, InputStickerSetItem, InputText, MaybeDynamic, Message, MessageEffect, MessageMedia, MessageReactions, ParametersSkip2, ParsedUpdate, PeerReaction, PeerStories, PeersIndex, Photo, Poll, PollUpdate, PollVoteUpdate, PreCheckoutQuery, RawDocument, ReplyMarkup, SentCode, StarsStatus, StarsTransaction, Sticker, StickerSet, StickerSourceType, StickerType, StoriesStealthMode, Story, StoryInteractions, StoryUpdate, StoryViewer, StoryViewersList, TakeoutSession, TextWithEntities, TypingStatus, UploadFileLike, UploadedFile, User, UserStatusUpdate, UserTypingUpdate } from './types/index.js'
+import type { AllStories, ArrayPaginated, ArrayWithTotal, Boost, BoostSlot, BoostStats, BotChatJoinRequestUpdate, BotCommands, BotReactionCountUpdate, BotReactionUpdate, BotStoppedUpdate, BusinessCallbackQuery, BusinessChatLink, BusinessConnection, BusinessMessage, BusinessWorkHoursDay, CallbackQuery, Chat, ChatEvent, ChatInviteLink, ChatInviteLinkMember, ChatJoinRequestUpdate, ChatMember, ChatMemberUpdate, ChatPreview, ChatlistPreview, ChosenInlineResult, CollectibleInfo, DeleteBusinessMessageUpdate, DeleteMessageUpdate, DeleteStoryUpdate, Dialog, FactCheck, FileDownloadLocation, FileDownloadParameters, ForumTopic, FullChat, GameHighScore, HistoryReadUpdate, InlineCallbackQuery, InlineQuery, InputChatEventFilters, InputDialogFolder, InputFileLike, InputInlineResult, InputMediaLike, InputMediaSticker, InputMessageId, InputPeerLike, InputPrivacyRule, InputReaction, InputStickerSet, InputStickerSetItem, InputText, MaybeDynamic, Message, MessageEffect, MessageMedia, MessageReactions, ParametersSkip2, ParsedUpdate, PeerReaction, PeerStories, PeersIndex, Photo, Poll, PollUpdate, PollVoteUpdate, PreCheckoutQuery, RawDocument, ReplyMarkup, SentCode, StarGift, StarsStatus, StarsTransaction, Sticker, StickerSet, StickerType, StoriesStealthMode, Story, StoryInteractions, StoryUpdate, StoryViewer, StoryViewersList, TakeoutSession, TextWithEntities, TypingStatus, UploadFileLike, UploadedFile, User, UserStarGift, UserStatusUpdate, UserTypingUpdate } from './types/index.js'
 import type { StringSessionData } from './utils/string-session.js'
 import type { ITelegramStorageProvider } from './storage/provider.js'
 import { Conversation } from './types/conversation.js'
@@ -207,6 +207,7 @@ import { changeCloudPassword } from './methods/password/change-cloud-password.js
 import { enableCloudPassword } from './methods/password/enable-cloud-password.js'
 import { cancelPasswordEmail, resendPasswordEmail, verifyPasswordEmail } from './methods/password/password-email.js'
 import { removeCloudPassword } from './methods/password/remove-cloud-password.js'
+import { acceptStarGift } from './methods/premium/accept-star-gift.js'
 import { applyBoost } from './methods/premium/apply-boost.js'
 import type { CanApplyBoostResult } from './methods/premium/can-apply-boost.js'
 import { canApplyBoost } from './methods/premium/can-apply-boost.js'
@@ -217,9 +218,13 @@ import { getBoosts } from './methods/premium/get-boosts.js'
 import { getBusinessChatLinks } from './methods/premium/get-business-chat-links.js'
 import { getBusinessConnection } from './methods/premium/get-business-connection.js'
 import { getMyBoostSlots } from './methods/premium/get-my-boost-slots.js'
+import { getStarGiftOptions } from './methods/premium/get-star-gift-options.js'
+import { getStarGifts } from './methods/premium/get-star-gifts.js'
 import { getStarsTransactions } from './methods/premium/get-stars-transactions.js'
 import { iterBoosters } from './methods/premium/iter-boosters.js'
+import { iterStarGifts } from './methods/premium/iter-star-gifts.js'
 import { iterStarsTransactions } from './methods/premium/iter-stars-transactions.js'
+import { sendStarGift } from './methods/premium/send-star-gift.js'
 import { setBusinessIntro } from './methods/premium/set-business-intro.js'
 import { setBusinessWorkHours } from './methods/premium/set-business-work-hours.js'
 import { addStickerToSet } from './methods/stickers/add-sticker-to-set.js'
@@ -250,7 +255,6 @@ import { iterAllStories } from './methods/stories/iter-all-stories.js'
 import { iterProfileStories } from './methods/stories/iter-profile-stories.js'
 import { iterStoryViewers } from './methods/stories/iter-story-viewers.js'
 import { readStories } from './methods/stories/read-stories.js'
-import { reportStory } from './methods/stories/report-story.js'
 import { sendStoryReaction } from './methods/stories/send-story-reaction.js'
 import { sendStory } from './methods/stories/send-story.js'
 import { togglePeerStoriesArchived } from './methods/stories/toggle-peer-stories-archived.js'
@@ -2579,6 +2583,15 @@ export interface TelegramClient extends ITelegramClient {
              * the stream will be buffered in memory and the file size will be inferred from the buffer.
              */
             requireFileSize?: boolean
+
+            /**
+             * When using `inputMediaUploadedPhoto` (e.g. when sending an uploaded photo) require
+             * the file extension to be known beforehand.
+             *
+             * This will make the library try to guess the file extension from the file mime type,
+             * or throw an error if it cannot be guessed.
+             */
+            requireExtension?: boolean
         }): Promise<UploadedFile>
     /**
      * Upload a media to Telegram servers, without actually
@@ -4481,6 +4494,24 @@ export interface TelegramClient extends ITelegramClient {
      * @param password  2FA password as plaintext
      */
     removeCloudPassword(password: string): Promise<void>
+
+    /**
+     * Accept, hide or convert a star gift.
+     *
+     * **Available**: 👤 users only
+     *
+     * @returns  Whether the action was successful
+     */
+    acceptStarGift(
+        params: InputMessageId & {
+        /**
+         * Action to perform on the gift.
+         *  - `save` - save the gift to your profile
+         *  - `hide` - hide the gift from your profile
+         *  - `convert` - convert the gift to stars (can't be undone)
+         */
+            action: 'save' | 'hide' | 'convert'
+        }): Promise<boolean>
     /**
      * Boost a given channel
      *
@@ -4598,6 +4629,37 @@ export interface TelegramClient extends ITelegramClient {
      *
      */
     getMyBoostSlots(): Promise<BoostSlot[]>
+
+    /**
+     * Get the list of available star gifts.
+     * **Available**: 👤 users only
+     *
+     */
+    getStarGiftOptions(): Promise<StarGift[]>
+
+    /**
+     * Get a list of gifts sent to a user.
+     *
+     * **Available**: 👤 users only
+     *
+     * @param userId  User whose gifts to fetch
+     * @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<UserStarGift, string>>
     /**
      * Get Telegram Stars transactions for a given peer.
      *
@@ -4658,6 +4720,35 @@ export interface TelegramClient extends ITelegramClient {
              */
             chunkSize?: number
         }): AsyncIterableIterator<Boost>
+
+    /**
+     * 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.
      *
@@ -4689,6 +4780,42 @@ export interface TelegramClient extends ITelegramClient {
              */
             chunkSize?: number
         }): AsyncIterableIterator<StarsTransaction>
+    /**
+     * Send a star gift to a user.
+     *
+     * > **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 sent gift
+     */
+    sendStarGift(
+        params: {
+        /** ID of the user to send the gift to */
+            userId: InputPeerLike
+
+            /** ID of the gift to send */
+            gift: Long | StarGift
+
+            /**
+             * Whether to send the gift anonymously
+             * (i.e. if the recipient chooses to display the gift
+             * on their profile, your name won't be visible)
+             */
+            anonymous?: boolean
+
+            /** Message to send along with the gift */
+            message?: InputText
+
+            /**
+             * Whether to dispatch the new message event
+             * to the client's update handler.
+             */
+            shouldDispatch?: true
+        }): Promise<Message>
 
     /**
      * Set current user's business introduction.
@@ -4801,13 +4928,6 @@ export interface TelegramClient extends ITelegramClient {
              */
             type?: StickerType
 
-            /**
-             * File source type for the stickers in this set.
-             *
-             * @default  `static`, i.e. regular WEBP stickers.
-             */
-            sourceType?: StickerSourceType
-
             /**
              * Whether to create "adaptive" emoji set.
              *
@@ -5297,27 +5417,6 @@ export interface TelegramClient extends ITelegramClient {
      * @returns  IDs of the stores that were marked as read
      */
     readStories(peerId: InputPeerLike, maxId: number): Promise<number[]>
-    /**
-     * Report a story (or multiple stories) to the moderation team
-     * **Available**: 👤 users only
-     *
-     */
-    reportStory(
-        peerId: InputPeerLike,
-        storyIds: MaybeArray<number>,
-        params?: {
-        /**
-         * Reason for reporting
-         *
-         * @default  inputReportReasonSpam
-         */
-            reason?: tl.TypeReportReason
-
-            /**
-             * Additional comment to the report
-             */
-            message?: string
-        }): Promise<void>
     /**
      * Send (or remove) a reaction to a story
      * **Available**: 👤 users only
@@ -6375,6 +6474,9 @@ TelegramClient.prototype.cancelPasswordEmail = function (...args) {
 TelegramClient.prototype.removeCloudPassword = function (...args) {
     return removeCloudPassword(this._client, ...args)
 }
+TelegramClient.prototype.acceptStarGift = function (...args) {
+    return acceptStarGift(this._client, ...args)
+}
 TelegramClient.prototype.applyBoost = function (...args) {
     return applyBoost(this._client, ...args)
 }
@@ -6405,15 +6507,27 @@ TelegramClient.prototype.getBusinessConnection = function (...args) {
 TelegramClient.prototype.getMyBoostSlots = function (...args) {
     return getMyBoostSlots(this._client, ...args)
 }
+TelegramClient.prototype.getStarGiftOptions = function (...args) {
+    return getStarGiftOptions(this._client, ...args)
+}
+TelegramClient.prototype.getStarGifts = function (...args) {
+    return getStarGifts(this._client, ...args)
+}
 TelegramClient.prototype.getStarsTransactions = function (...args) {
     return getStarsTransactions(this._client, ...args)
 }
 TelegramClient.prototype.iterBoosters = function (...args) {
     return iterBoosters(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.sendStarGift = function (...args) {
+    return sendStarGift(this._client, ...args)
+}
 TelegramClient.prototype.setBusinessIntro = function (...args) {
     return setBusinessIntro(this._client, ...args)
 }
@@ -6504,9 +6618,6 @@ TelegramClient.prototype.iterStoryViewers = function (...args) {
 TelegramClient.prototype.readStories = function (...args) {
     return readStories(this._client, ...args)
 }
-TelegramClient.prototype.reportStory = function (...args) {
-    return reportStory(this._client, ...args)
-}
 TelegramClient.prototype.sendStoryReaction = function (...args) {
     return sendStoryReaction(this._client, ...args)
 }

packages/core/src/highlevel/methods.ts

@@ -202,6 +202,7 @@ export { verifyPasswordEmail } from './methods/password/password-email.js'
 export { resendPasswordEmail } from './methods/password/password-email.js'
 export { cancelPasswordEmail } from './methods/password/password-email.js'
 export { removeCloudPassword } from './methods/password/remove-cloud-password.js'
+export { acceptStarGift } from './methods/premium/accept-star-gift.js'
 export { applyBoost } from './methods/premium/apply-boost.js'
 export { canApplyBoost } from './methods/premium/can-apply-boost.js'
 export type { CanApplyBoostResult } from './methods/premium/can-apply-boost.js'
@@ -213,9 +214,13 @@ export { getBoosts } from './methods/premium/get-boosts.js'
 export { getBusinessChatLinks } from './methods/premium/get-business-chat-links.js'
 export { getBusinessConnection } from './methods/premium/get-business-connection.js'
 export { getMyBoostSlots } from './methods/premium/get-my-boost-slots.js'
+export { getStarGiftOptions } from './methods/premium/get-star-gift-options.js'
+export { getStarGifts } from './methods/premium/get-star-gifts.js'
 export { getStarsTransactions } from './methods/premium/get-stars-transactions.js'
 export { iterBoosters } from './methods/premium/iter-boosters.js'
+export { iterStarGifts } from './methods/premium/iter-star-gifts.js'
 export { iterStarsTransactions } from './methods/premium/iter-stars-transactions.js'
+export { sendStarGift } from './methods/premium/send-star-gift.js'
 export { setBusinessIntro } from './methods/premium/set-business-intro.js'
 export { setBusinessWorkHours } from './methods/premium/set-business-work-hours.js'
 export { addStickerToSet } from './methods/stickers/add-sticker-to-set.js'
@@ -247,7 +252,6 @@ export { iterAllStories } from './methods/stories/iter-all-stories.js'
 export { iterProfileStories } from './methods/stories/iter-profile-stories.js'
 export { iterStoryViewers } from './methods/stories/iter-story-viewers.js'
 export { readStories } from './methods/stories/read-stories.js'
-export { reportStory } from './methods/stories/report-story.js'
 export { sendStoryReaction } from './methods/stories/send-story-reaction.js'
 export { sendStory } from './methods/stories/send-story.js'
 export { togglePeerStoriesArchived } from './methods/stories/toggle-peer-stories-archived.js'

packages/core/src/highlevel/methods/_imports.ts

@@ -87,6 +87,7 @@ import {
     RawDocument,
     ReplyMarkup,
     SentCode,
+    StarGift,
     StarsStatus,
     StarsTransaction,
     Sticker,
@@ -105,6 +106,7 @@ import {
     UploadFileLike,
     UploadedFile,
     User,
+    UserStarGift,
     UserStatusUpdate,
     UserTypingUpdate,
 } from '../types/index.js'

packages/core/src/highlevel/methods/premium/accept-star-gift.ts

@@ -0,0 +1,41 @@
+import type { ITelegramClient } from '../../client.types.js'
+import { type InputMessageId, normalizeInputMessageId } from '../../types/messages/input-message-id.js'
+import { resolveUser } from '../users/resolve-peer.js'
+
+// @available=user
+/**
+ * Accept, hide or convert a star gift.
+ *
+ * @returns  Whether the action was successful
+ */
+export async function acceptStarGift(
+    client: ITelegramClient,
+    params: InputMessageId & {
+        /**
+         * Action to perform on the gift.
+         *  - `save` - save the gift to your profile
+         *  - `hide` - hide the gift from your profile
+         *  - `convert` - convert the gift to stars (can't be undone)
+         */
+        action: 'save' | 'hide' | 'convert'
+    },
+): Promise<boolean> {
+    const { action } = params
+    const { chatId, message } = normalizeInputMessageId(params)
+    const userId = await resolveUser(client, chatId)
+
+    return client.call(
+        action === 'convert'
+            ? {
+                _: 'payments.convertStarGift',
+                userId,
+                msgId: message,
+            }
+            : {
+                _: 'payments.saveStarGift',
+                unsave: action === 'hide',
+                userId,
+                msgId: message,
+            },
+    )
+}

packages/core/src/highlevel/methods/premium/get-star-gift-options.ts

@@ -0,0 +1,18 @@
+import { assertTypeIsNot } from '../../../utils/type-assertions.js'
+import type { ITelegramClient } from '../../client.types.js'
+import { StarGift } from '../../types/premium/stars-gift.js'
+
+// @available=user
+/**
+ * Get the list of available star gifts.
+ */
+export async function getStarGiftOptions(client: ITelegramClient): Promise<StarGift[]> {
+    const res = await client.call({
+        _: 'payments.getStarGifts',
+        hash: 0,
+    })
+
+    assertTypeIsNot('payments.getStarGifts', res, 'payments.starGiftsNotModified')
+
+    return res.gifts.map(gift => new StarGift(gift))
+}

packages/core/src/highlevel/methods/premium/get-star-gifts.ts

@@ -0,0 +1,46 @@
+import type { ITelegramClient } from '../../client.types.js'
+import type { InputPeerLike } from '../../types/peers/peer.js'
+import { PeersIndex } from '../../types/peers/peers-index.js'
+import { UserStarGift } from '../../types/premium/stars-gift.js'
+import type { ArrayPaginated } from '../../types/utils.js'
+import { makeArrayPaginated } from '../../utils/misc-utils.js'
+import { resolveUser } from '../users/resolve-peer.js'
+
+// @available=user
+/**
+ * Get a list of gifts sent to a user.
+ *
+ * @param userId  User whose gifts to fetch
+ * @returns  Gifts sent to the user
+ */
+export async function getStarGifts(
+    client: ITelegramClient,
+    userId: InputPeerLike,
+    params?: {
+        /**
+         * Offset for pagination.
+         */
+        offset?: string
+
+        /**
+         * Maximum number of gifts to fetch.
+         *
+         * @default  100
+         */
+        limit?: number
+    },
+): Promise<ArrayPaginated<UserStarGift, string>> {
+    const { offset = '', limit = 100 } = params ?? {}
+
+    const res = await client.call({
+        _: 'payments.getUserStarGifts',
+        userId: await resolveUser(client, userId),
+        offset,
+        limit,
+    })
+
+    const peers = PeersIndex.from(res)
+    const gifts = res.gifts.map(gift => new UserStarGift(gift, peers))
+
+    return makeArrayPaginated(gifts, res.count, offset)
+}

packages/core/src/highlevel/methods/premium/iter-star-gifts.ts

@@ -0,0 +1,59 @@
+import type { ITelegramClient } from '../../client.types.js'
+import type { InputPeerLike, UserStarGift } from '../../types/index.js'
+import { resolvePeer } from '../users/resolve-peer.js'
+
+import { getStarGifts } from './get-star-gifts.js'
+
+// @available=user
+/**
+ * Iterate over gifts sent to a given user.
+ *
+ * Wrapper over {@link getStarGifts}
+ *
+ * @param peerId  Peer ID
+ * @param params  Additional parameters
+ */
+export async function* iterStarGifts(
+    client: ITelegramClient,
+    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> {
+    if (!params) params = {}
+    const { limit = Infinity, chunkSize = 100 } = params
+
+    let { offset } = params
+    let current = 0
+
+    const peer = await resolvePeer(client, peerId)
+
+    for (;;) {
+        const res = await getStarGifts(client, peer, {
+            offset,
+            limit: Math.min(limit - current, chunkSize),
+        })
+
+        for (const gift of res) {
+            yield gift
+
+            if (++current >= limit) return
+        }
+
+        if (!res.next) return
+        offset = res.next
+    }
+}

packages/core/src/highlevel/methods/premium/send-star-gift.ts

@@ -0,0 +1,73 @@
+import Long from 'long'
+import type { tl } from '@mtcute/tl'
+
+import type { InputPeerLike } from '../../types/peers/peer.js'
+import type { StarGift } from '../../types/premium/stars-gift.js'
+import { type InputText, inputTextToTl } from '../../types/misc/entities.js'
+import type { ITelegramClient } from '../../client.types.js'
+import { resolveUser } from '../users/resolve-peer.js'
+import { assertTypeIs } from '../../../utils/type-assertions.js'
+import { _findMessageInUpdate } from '../messages/find-in-update.js'
+import type { Message } from '../../types/messages/message.js'
+
+/**
+ * Send a star gift to a user.
+ *
+ * > **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.
+ *
+ * @returns  Service message about the sent gift
+ */
+export async function sendStarGift(
+    client: ITelegramClient,
+    params: {
+        /** ID of the user to send the gift to */
+        userId: InputPeerLike
+
+        /** ID of the gift to send */
+        gift: Long | StarGift
+
+        /**
+         * Whether to send the gift anonymously
+         * (i.e. if the recipient chooses to display the gift
+         * on their profile, your name won't be visible)
+         */
+        anonymous?: boolean
+
+        /** Message to send along with the gift */
+        message?: InputText
+
+        /**
+         * Whether to dispatch the new message event
+         * to the client's update handler.
+         */
+        shouldDispatch?: true
+    },
+): Promise<Message> {
+    const { userId, gift, anonymous, message, shouldDispatch } = params
+
+    const invoice: tl.TypeInputInvoice = {
+        _: 'inputInvoiceStarGift',
+        hideName: anonymous,
+        userId: await resolveUser(client, userId),
+        giftId: Long.isLong(gift) ? gift : gift.id,
+        message: message ? inputTextToTl(message) : undefined,
+    }
+
+    const form = await client.call({
+        _: 'payments.getPaymentForm',
+        invoice,
+    })
+
+    const res = await client.call({
+        _: 'payments.sendStarsForm',
+        invoice,
+        formId: form.formId,
+    })
+
+    assertTypeIs('payments.sendStarsForm', res, 'payments.paymentResult')
+
+    return _findMessageInUpdate(client, res.updates, false, !shouldDispatch)
+}

packages/core/src/highlevel/methods/stickers/create-sticker-set.ts

@@ -5,7 +5,6 @@ import type {
     InputFileLike,
     InputPeerLike,
     InputStickerSetItem,
-    StickerSourceType,
     StickerType,
 } from '../../types/index.js'
 import {
@@ -54,13 +53,6 @@ export async function createStickerSet(
          */
         type?: StickerType
 
-        /**
-         * File source type for the stickers in this set.
-         *
-         * @default  `static`, i.e. regular WEBP stickers.
-         */
-        sourceType?: StickerSourceType
-
         /**
          * Whether to create "adaptive" emoji set.
          *
@@ -113,8 +105,6 @@ export async function createStickerSet(
 
     const res = await client.call({
         _: 'stickers.createStickerSet',
-        animated: params.sourceType === 'animated',
-        videos: params.sourceType === 'video',
         masks: params.type === 'mask',
         emojis: params.type === 'emoji',
         textColor: params.adaptive,

packages/core/src/highlevel/methods/stories/report-story.ts

@@ -1,41 +0,0 @@
-import type { tl } from '@mtcute/tl'
-
-import type { MaybeArray } from '../../../types/utils.js'
-import { assertTrue } from '../../../utils/type-assertions.js'
-import type { ITelegramClient } from '../../client.types.js'
-import type { InputPeerLike } from '../../types/index.js'
-import { resolvePeer } from '../users/resolve-peer.js'
-
-/**
- * Report a story (or multiple stories) to the moderation team
- */
-export async function reportStory(
-    client: ITelegramClient,
-    peerId: InputPeerLike,
-    storyIds: MaybeArray<number>,
-    params?: {
-        /**
-         * Reason for reporting
-         *
-         * @default  inputReportReasonSpam
-         */
-        reason?: tl.TypeReportReason
-
-        /**
-         * Additional comment to the report
-         */
-        message?: string
-    },
-): Promise<void> {
-    const { reason = { _: 'inputReportReasonSpam' }, message = '' } = params ?? {}
-
-    const r = await client.call({
-        _: 'stories.report',
-        peer: await resolvePeer(client, peerId),
-        id: Array.isArray(storyIds) ? storyIds : [storyIds],
-        message,
-        reason,
-    })
-
-    assertTrue('stories.report', r)
-}

packages/core/src/highlevel/types/bots/keyboards/factories.ts

@@ -333,6 +333,20 @@ export function requestPeer(
     }
 }
 
+/**
+ * Button to copy text to the user's clipboard
+ */
+export function copy(params: {
+    text: string
+    copyText?: string
+}): tl.RawKeyboardButtonCopy {
+    return {
+        _: 'keyboardButtonCopy',
+        text: params.text,
+        copyText: params?.copyText ?? params.text,
+    }
+}
+
 /**
  * Find a button in the keyboard by its text or by predicate
  *

packages/core/src/highlevel/types/media/video.ts

@@ -90,6 +90,10 @@ export class Video extends RawDocument {
     get videoStartTs(): number | null {
         return this.attr._ === 'documentAttributeVideo' ? this.attr.videoStartTs ?? null : null
     }
+
+    get codec(): string | null {
+        return this.attr._ === 'documentAttributeVideo' ? this.attr.videoCodec ?? null : null
+    }
 }
 
 memoizeGetters(Video, ['fileName', 'thumbnails', 'fileId', 'uniqueFileId', 'isAnimation'])

packages/core/src/highlevel/types/messages/message-action.ts

@@ -6,6 +6,8 @@ import { _callDiscardReasonFromTl } from '../calls/index.js'
 import { Photo } from '../media/photo.js'
 import type { Peer } from '../peers/peer.js'
 import { parsePeer } from '../peers/peer.js'
+import { StarGift } from '../premium/stars-gift.js'
+import type { TextWithEntities } from '../misc/entities.js'
 
 import type { Message } from './message.js'
 
@@ -478,7 +480,7 @@ export interface ActionPaymentRefunded {
 }
 
 /** Telegram Stars were gifted by the other chat participant */
-export interface ActionStarsGifted {
+export interface ActionStarGifted {
     readonly type: 'stars_gifted'
 
     /** Whether `currency` is a cryptocurrency */
@@ -512,12 +514,30 @@ export interface ActionStarsPrize {
     /** Transaction ID */
     transactionId: string
 
+    // todo: what does this mean?
     boostPeer: Peer
 
     /** Message ID containing the giveaway */
     giveawayMessageId: number
 }
 
+export interface ActionStarGift {
+    readonly type: 'stars_gift'
+
+    /** Whether the sender chose to send the gift anonymously */
+    nameHidden: boolean
+    /** Whether this gift was saved to the recipient's profile */
+    saved: boolean
+    /** Whether this gift was converted to stars */
+    converted: boolean
+    /** Amount of stars the gift can be converted to by the recipient */
+    convertStars: tl.Long
+    /** The gift itself */
+    gift: StarGift
+    /** Message attached to the gift */
+    message: TextWithEntities | null
+}
+
 export type MessageAction =
   | ActionChatCreated
   | ActionChannelCreated
@@ -562,8 +582,9 @@ export type MessageAction =
   | ActionGiveawayEnded
   | ActionBoostApply
   | ActionPaymentRefunded
-  | ActionStarsGifted
+  | ActionStarGifted
   | ActionStarsPrize
+  | ActionStarGift
   | null
 
 /** @internal */
@@ -848,6 +869,16 @@ export function _messageActionFromTl(this: Message, act: tl.TypeMessageAction):
                 boostPeer: parsePeer(act.boostPeer, this._peers),
                 giveawayMessageId: act.giveawayMsgId,
             }
+        case 'messageActionStarGift':
+            return {
+                type: 'stars_gift',
+                nameHidden: act.nameHidden!,
+                saved: act.saved!,
+                converted: act.converted!,
+                convertStars: act.convertStars,
+                gift: new StarGift(act.gift),
+                message: act.message ?? null,
+            }
         default:
             return null
     }

packages/core/src/highlevel/types/misc/sticker-set.ts

@@ -7,7 +7,7 @@ import { memoizeGetters } from '../../utils/memoize.js'
 import { MtEmptyError } from '../errors.js'
 import type { InputFileLike } from '../files/index.js'
 import { parseSticker } from '../media/document-utils.js'
-import type { MaskPosition, Sticker, StickerSourceType, StickerType } from '../media/index.js'
+import type { MaskPosition, Sticker, StickerType } from '../media/index.js'
 import { Thumbnail } from '../media/index.js'
 
 /**
@@ -175,21 +175,6 @@ export class StickerSet {
         return 'sticker'
     }
 
-    /**
-     * Source file type of the stickers in this set
-     */
-    get sourceType(): StickerSourceType {
-        if (this.brief.animated) {
-            return 'animated'
-        }
-
-        if (this.brief.videos) {
-            return 'video'
-        }
-
-        return 'static'
-    }
-
     /**
      * Date when this sticker set was installed
      */

packages/core/src/highlevel/types/premium/index.ts

@@ -8,3 +8,4 @@ export * from './business-intro.js'
 export * from './business-work-hours.js'
 export * from './stars-transaction.js'
 export * from './stars-status.js'
+export * from './stars-gift.js'

packages/core/src/highlevel/types/premium/stars-gift.ts

@@ -0,0 +1,123 @@
+import type { tl } from '@mtcute/tl'
+
+import type { Sticker } from '../media/sticker.js'
+import { parseDocument } from '../media/document-utils.js'
+import { assertTypeIs } from '../../../utils/type-assertions.js'
+import { MtTypeAssertionError } from '../../../types/errors.js'
+import { makeInspectable } from '../../utils/inspectable.js'
+import { memoizeGetters } from '../../utils/memoize.js'
+import type { PeersIndex } from '../peers/peers-index.js'
+import { User } from '../peers/user.js'
+import type { TextWithEntities } from '../misc/entities.js'
+
+/**
+ * A gift with stars attached to it.
+ */
+export class StarGift {
+    constructor(
+        readonly raw: tl.TypeStarGift,
+    ) {}
+
+    /** ID of the gift */
+    get id(): tl.Long {
+        return this.raw.id
+    }
+
+    /** Sticker associated with the gift */
+    get sticker(): Sticker {
+        assertTypeIs('StarGift#sticker', this.raw.sticker, 'document')
+        const parsed = parseDocument(this.raw.sticker)
+
+        if (parsed.type !== 'sticker') {
+            throw new MtTypeAssertionError('StarGift#sticker', 'sticker', parsed.type)
+        }
+
+        return parsed
+    }
+
+    /** Amount of stars the gift was purchased for */
+    get purchaseStars(): tl.Long {
+        return this.raw.stars
+    }
+
+    /**
+     * Amount of stars the gift can be converted to by the recipient
+     */
+    get convertStars(): tl.Long {
+        return this.raw.convertStars
+    }
+
+    /**
+     * For limited availability gifts,
+     * the number of remaining and total gifts available
+     */
+    get availability(): { remains: number, total: number } | null {
+        if (!this.raw.availabilityRemains || !this.raw.availabilityTotal) {
+            return null
+        }
+
+        return {
+            remains: this.raw.availabilityRemains,
+            total: this.raw.availabilityTotal,
+        }
+    }
+}
+
+makeInspectable(StarGift)
+memoizeGetters(StarGift, ['sticker'])
+
+/**
+ * Information about a certain user's {@link StarGift}.
+ */
+export class UserStarGift {
+    constructor(
+        readonly raw: tl.RawUserStarGift,
+        readonly peers: PeersIndex,
+    ) {}
+
+    /** Whether the sender chose to appear anonymously */
+    get nameHidden(): boolean {
+        return this.raw.nameHidden!
+    }
+
+    /** Whether this gift is not visible on the recipient's profile */
+    get hidden(): boolean {
+        return this.raw.unsaved!
+    }
+
+    /** Sender of the gift, if available */
+    get sender(): User | null {
+        return this.raw.fromId ? new User(this.peers.user(this.raw.fromId)) : null
+    }
+
+    /** Message ID where the gift was sent, if available */
+    get messageId(): number | null {
+        return this.raw.msgId ?? null
+    }
+
+    /** Date the gift was sent */
+    get date(): Date {
+        return new Date(this.raw.date * 1000)
+    }
+
+    /** The gift itself */
+    get gift(): StarGift {
+        return new StarGift(this.raw.gift)
+    }
+
+    /** Text attached to the gift */
+    get text(): TextWithEntities | null {
+        return this.raw.message ?? null
+    }
+
+    /**
+     * If the gift was converted to stars, the amount of stars
+     * it was converted to
+     */
+    get convertStars(): tl.Long | null {
+        return this.raw.convertStars ?? null
+    }
+}
+
+makeInspectable(UserStarGift)
+memoizeGetters(UserStarGift, ['sender', 'gift'])

packages/core/src/highlevel/types/premium/stars-transaction.ts

@@ -9,6 +9,8 @@ import type { User } from '../peers/user.js'
 import { type MessageMedia, _messageMediaFromTl } from '../messages/message-media.js'
 import { WebDocument } from '../files/web-document.js'
 
+import { StarGift } from './stars-gift.js'
+
 // ref: https://github.com/tdlib/td/blob/master/td/telegram/StarManager.cpp#L223
 
 /**
@@ -23,6 +25,7 @@ import { WebDocument } from '../files/web-document.js'
  *  - `gift`: This transaction is a gift from a user
  *  - `bot_purchase`: This transaction is a purchase at a bot-operated store
  *  - `channel_subscription`: This transaction is a subscription to a channel
+ *  - `star_gift`: This transaction is either a star gift to a user (if outgoing), or converting a star gift to stars (if incoming)
  */
 export type StarsTransactionType =
   | { type: 'unsupported' }
@@ -113,6 +116,13 @@ export type StarsTransactionType =
       /** ID of the message containing the giveaway where the stars were given */
       messageId: number
   }
+  | {
+      type: 'star_gift'
+      /** Related peer */
+      peer: Peer
+      /** The gift */
+      gift: StarGift
+  }
 
 export class StarsTransaction {
     constructor(
@@ -201,6 +211,14 @@ export class StarsTransaction {
                     }
                 }
 
+                if (this.raw.stargift) {
+                    return {
+                        type: 'star_gift',
+                        peer,
+                        gift: new StarGift(this.raw.stargift),
+                    }
+                }
+
                 if (this.raw.msgId) {
                     if (this.raw.reaction) {
                         return {

packages/tl/README.md

@@ -2,7 +2,7 @@
 
 TL schema and related utils used for mtcute.
 
-Generated from TL layer **187** (last updated on 07.09.2024).
+Generated from TL layer **189** (last updated on 05.10.2024).
 
 ## About
 

packages/tl/data/int53-overrides.json

@@ -138,7 +138,6 @@
     "updateChatUserTyping": ["chat_id"],
     "updateDeleteChannelMessages": ["channel_id"],
     "updateGroupCall": ["chat_id"],
-    "updateGroupInvitePrivacyForbidden": ["user_id"],
     "updateInlineBotCallbackQuery": ["user_id"],
     "updatePinnedChannelMessages": ["channel_id"],
     "updateReadChannelDiscussionInbox": ["channel_id", "broadcast_id"],
@@ -157,6 +156,7 @@
     "user": ["id"],
     "userEmpty": ["id"],
     "userFull": ["id", "personal_channel_id"],
+    "userStarGift": ["from_id"],
     "userStories": ["user_id"],
     "webAuthorization": ["bot_id"],
     "_": "Dummy line teehee~"

packages/tl/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@mtcute/tl",
-    "version": "187.0.0",
+    "version": "189.0.0",
     "description": "TL schema used for mtcute",
     "author": "alina sireneva <alina@tei.su>",
     "license": "MIT",