feat: updated to 196 layer

packages/core/src/highlevel/client.ts

@@ -230,6 +230,8 @@ import { iterStarsTransactions } from './methods/premium/iter-stars-transactions
 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 { transferStarGift } from './methods/premium/transfer-star-gift.js'
+import { upgradeStarGift } from './methods/premium/upgrade-star-gift.js'
 import { addStickerToSet } from './methods/stickers/add-sticker-to-set.js'
 import { createStickerSet } from './methods/stickers/create-sticker-set.js'
 import { deleteStickerFromSet } from './methods/stickers/delete-sticker-from-set.js'
@@ -1078,6 +1080,8 @@ export interface TelegramClient extends ITelegramClient {
     /**
      * Prepare an inline message result to be sent later via the
      * `shareMessage` [mini-app api method](https://core.telegram.org/bots/webapps#initializing-mini-apps).
+     * **Available**: 🤖 bots only
+     *
      */
     prepareInlineMessage(
         params: {
@@ -1245,6 +1249,8 @@ export interface TelegramClient extends ITelegramClient {
         }): Promise<void>
     /**
      * Give or revoke permission for a bot to update emoji status for your account
+     * **Available**: 👤 users only
+     *
      */
     toggleEmojiStatusPermission(
         params: {
@@ -4844,6 +4850,9 @@ export interface TelegramClient extends ITelegramClient {
             /** Message to send along with the gift */
             message?: InputText
 
+            /** Whether to automatically upgrade the gift to a unique star gift */
+            withUpgrade?: boolean
+
             /**
              * Whether to dispatch the new message event
              * to the client's update handler.
@@ -4899,6 +4908,61 @@ export interface TelegramClient extends ITelegramClient {
           }
           ))
           | null): Promise<void>
+    /**
+     * Transfer a unique star gift.
+     *
+     * > **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 transferred gift
+     */
+    transferStarGift(
+        params: {
+        /** ID of the message containing the gift */
+            message: number | Message
+
+            /** ID of the user to transfer the gift to */
+            recepient: InputPeerLike
+
+            /**
+             * Whether to dispatch the new message event
+             * to the client's update handler.
+             */
+            shouldDispatch?: true
+        }): Promise<Message>
+    /**
+     * Upgrades a star gift to a unique gift.
+     *
+     * > **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 upgraded gift
+     */
+    upgradeStarGift(
+        params: {
+        /** ID of the message containing the gift */
+            message: number | Message
+
+            /**
+             * Whether to retain the original details of the gift
+             * (like sender, recipient, date, message)
+             */
+            keepOriginalDetails?: boolean
+
+            /**
+             * Whether to dispatch the new message event
+             * to the client's update handler.
+             */
+            shouldDispatch?: true
+        }): Promise<Message>
     /**
      * Add a sticker to a sticker set.
      *
@@ -6731,6 +6795,12 @@ TelegramClient.prototype.setBusinessIntro = function (...args) {
 TelegramClient.prototype.setBusinessWorkHours = function (...args) {
     return setBusinessWorkHours(this._client, ...args)
 }
+TelegramClient.prototype.transferStarGift = function (...args) {
+    return transferStarGift(this._client, ...args)
+}
+TelegramClient.prototype.upgradeStarGift = function (...args) {
+    return upgradeStarGift(this._client, ...args)
+}
 TelegramClient.prototype.addStickerToSet = function (...args) {
     return addStickerToSet(this._client, ...args)
 }

packages/core/src/highlevel/methods.ts

@@ -230,6 +230,8 @@ export { iterStarsTransactions } from './methods/premium/iter-stars-transactions
 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 { transferStarGift } from './methods/premium/transfer-star-gift.js'
+export { upgradeStarGift } from './methods/premium/upgrade-star-gift.js'
 export { addStickerToSet } from './methods/stickers/add-sticker-to-set.js'
 export { createStickerSet } from './methods/stickers/create-sticker-set.js'
 export { deleteStickerFromSet } from './methods/stickers/delete-sticker-from-set.js'

packages/core/src/highlevel/methods/dialogs/edit-folder.ts

@@ -34,7 +34,7 @@ export async function editFolder(
     }
     if (typeof folder === 'number' || typeof folder === 'string') {
         const old = await getFolders(client)
-        const found = old.filters.find(it => it._ === 'dialogFilter' && (it.id === folder || it.title === folder))
+        const found = old.filters.find(it => it._ === 'dialogFilter' && (it.id === folder || it.title.text === folder))
 
         if (!found) {
             throw new MtArgumentError(`Could not find a folder ${folder}`)

packages/core/src/highlevel/methods/dialogs/find-folder.ts

@@ -35,7 +35,7 @@ export async function findFolder(
         (folders.filters.find((it) => {
             if (it._ === 'dialogFilterDefault') return false
             if (params.id && it.id !== params.id) return false
-            if (params.title && it.title !== params.title) return false
+            if (params.title && it.title.text !== params.title) return false
             if (params.emoji && it.emoticon !== params.emoji) return false
 
             return true

packages/core/src/highlevel/methods/dialogs/get-folders.ts

@@ -25,7 +25,7 @@ export async function _normalizeInputFolder(
                 return folder === 0
             }
 
-            return it.id === folder || it.title === folder
+            return it.id === folder || it.title.text === folder
         })
 
         if (!found) {

packages/core/src/highlevel/methods/dialogs/iter-dialogs.ts

@@ -144,7 +144,7 @@ export async function* iterDialogs(
             localFilters_ = {
                 _: 'dialogFilter',
                 id: 0,
-                title: '',
+                title: { _: 'textWithEntities', text: '', entities: [] },
                 pinnedPeers: [],
                 includePeers: [],
                 excludePeers: [],

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

@@ -1,6 +1,5 @@
 import type { ITelegramClient } from '../../client.types.js'
-import { type InputMessageId, normalizeInputMessageId } from '../../types/messages/input-message-id.js'
+import type { Message } from '../../types/messages/message.js'
-import { resolveUser } from '../users/resolve-peer.js'
 
 // @available=user
 /**
@@ -10,7 +9,9 @@ import { resolveUser } from '../users/resolve-peer.js'
  */
 export async function acceptStarGift(
     client: ITelegramClient,
-    params: InputMessageId & {
+    params: {
+        /** ID of the message containing the gift */
+        message: number | Message
         /**
          * Action to perform on the gift.
          *  - `save` - save the gift to your profile
@@ -21,20 +22,17 @@ export async function acceptStarGift(
     },
 ): Promise<boolean> {
     const { action } = params
-    const { chatId, message } = normalizeInputMessageId(params)
+    const message = typeof params.message === 'number' ? params.message : params.message.id
-    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

@@ -14,5 +14,12 @@ export async function getStarGiftOptions(client: ITelegramClient): Promise<StarG
 
     assertTypeIsNot('payments.getStarGifts', res, 'payments.starGiftsNotModified')
 
-    return res.gifts.map(gift => new StarGift(gift))
+    const ret: StarGift[] = []
+    for (const gift of res.gifts) {
+        if (gift._ === 'starGift') {
+            ret.push(new StarGift(gift))
+        }
+    }
+
+    return ret
 }

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

@@ -39,6 +39,9 @@ export async function sendStarGift(
         /** Message to send along with the gift */
         message?: InputText
 
+        /** Whether to automatically upgrade the gift to a unique star gift */
+        withUpgrade?: boolean
+
         /**
          * Whether to dispatch the new message event
          * to the client's update handler.
@@ -46,7 +49,14 @@ export async function sendStarGift(
         shouldDispatch?: true
     },
 ): Promise<Message> {
-    const { userId, gift, anonymous, message, shouldDispatch } = params
+    const {
+        userId,
+        gift,
+        anonymous,
+        message,
+        shouldDispatch,
+        withUpgrade,
+    } = params
 
     const invoice: tl.TypeInputInvoice = {
         _: 'inputInvoiceStarGift',
@@ -54,6 +64,7 @@ export async function sendStarGift(
         userId: await resolveUser(client, userId),
         giftId: Long.isLong(gift) ? gift : gift.id,
         message: message ? inputTextToTl(message) : undefined,
+        includeUpgrade: withUpgrade,
     }
 
     const form = await client.call({

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

@@ -0,0 +1,59 @@
+import type { tl } from '@mtcute/tl'
+import type { ITelegramClient } from '../../client.types.js'
+
+import type { InputPeerLike } from '../../types/index.js'
+import type { Message } from '../../types/messages/message.js'
+import { assertTypeIs } from '../../../utils/type-assertions.js'
+import { _findMessageInUpdate } from '../messages/find-in-update.js'
+import { resolveUser } from '../users/resolve-peer.js'
+
+/**
+ * Transfer a unique star gift.
+ *
+ * > **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 transferred gift
+ */
+export async function transferStarGift(
+    client: ITelegramClient,
+    params: {
+        /** ID of the message containing the gift */
+        message: number | Message
+
+        /** ID of the user to transfer the gift to */
+        recepient: InputPeerLike
+
+        /**
+         * Whether to dispatch the new message event
+         * to the client's update handler.
+         */
+        shouldDispatch?: true
+    },
+): Promise<Message> {
+    const { message, recepient, shouldDispatch } = params
+
+    const msgId = typeof message === 'number' ? message : message.id
+    const invoice: tl.TypeInputInvoice = {
+        _: 'inputInvoiceStarGiftTransfer',
+        msgId,
+        toId: await resolveUser(client, recepient),
+    }
+
+    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/premium/upgrade-star-gift.ts

@@ -0,0 +1,60 @@
+import type { tl } from '@mtcute/tl'
+import type { ITelegramClient } from '../../client.types.js'
+
+import type { Message } from '../../types/messages/message.js'
+import { assertTypeIs } from '../../../utils/type-assertions.js'
+import { _findMessageInUpdate } from '../messages/find-in-update.js'
+
+/**
+ * Upgrades a star gift to a unique gift.
+ *
+ * > **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 upgraded gift
+ */
+export async function upgradeStarGift(
+    client: ITelegramClient,
+    params: {
+        /** ID of the message containing the gift */
+        message: number | Message
+
+        /**
+         * Whether to retain the original details of the gift
+         * (like sender, recipient, date, message)
+         */
+        keepOriginalDetails?: boolean
+
+        /**
+         * Whether to dispatch the new message event
+         * to the client's update handler.
+         */
+        shouldDispatch?: true
+    },
+): Promise<Message> {
+    const { message, keepOriginalDetails, shouldDispatch } = params
+
+    const msgId = typeof message === 'number' ? message : message.id
+    const invoice: tl.TypeInputInvoice = {
+        _: 'inputInvoiceStarGiftUpgrade',
+        msgId,
+        keepOriginalDetails,
+    }
+
+    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/types/calls/discard-reason.ts

@@ -1,44 +0,0 @@
-import type { tl } from '@mtcute/tl'
-
-import { assertNever } from '../../../types/utils.js'
-
-/**
- * Phone call discard reason. Can be:
- *  - `missed`: The call was missed
- *  - `disconnect`: The connection has interrupted
- *  - `hangup`: The call was ended normally
- *  - `busy`: The call was discarded because the user is in another call
- */
-export type CallDiscardReason = 'missed' | 'disconnect' | 'hangup' | 'busy'
-
-/** @internal */
-export function _callDiscardReasonFromTl(raw: tl.TypePhoneCallDiscardReason): CallDiscardReason {
-    switch (raw._) {
-        case 'phoneCallDiscardReasonMissed':
-            return 'missed'
-        case 'phoneCallDiscardReasonDisconnect':
-            return 'disconnect'
-        case 'phoneCallDiscardReasonHangup':
-            return 'hangup'
-        case 'phoneCallDiscardReasonBusy':
-            return 'busy'
-        default:
-            assertNever(raw)
-    }
-}
-
-/** @internal */
-export function _callDiscardReasonToTl(r: CallDiscardReason): tl.TypePhoneCallDiscardReason {
-    switch (r) {
-        case 'missed':
-            return { _: 'phoneCallDiscardReasonMissed' }
-        case 'disconnect':
-            return { _: 'phoneCallDiscardReasonDisconnect' }
-        case 'hangup':
-            return { _: 'phoneCallDiscardReasonHangup' }
-        case 'busy':
-            return { _: 'phoneCallDiscardReasonBusy' }
-        default:
-            assertNever(r)
-    }
-}

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

@@ -1 +0,0 @@
-export * from './discard-reason.js'

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

@@ -1,6 +1,5 @@
 export * from './auth/index.js'
 export * from './bots/index.js'
-export * from './calls/index.js'
 export * from './conversation.js'
 export * from './errors.js'
 export * from './files/index.js'

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

@@ -1,15 +1,14 @@
 import type { tl } from '@mtcute/tl'
-import type { CallDiscardReason } from '../calls/index.js'
 
 import type { TextWithEntities } from '../misc/entities.js'
 import type { Peer } from '../peers/peer.js'
 import type { Message } from './message.js'
 import Long from 'long'
 import { getMarkedPeerId } from '../../../utils/peer-utils.js'
-import { _callDiscardReasonFromTl } from '../calls/index.js'
 import { Photo } from '../media/photo.js'
-import { parsePeer } from '../peers/peer.js'
 
+import { parsePeer } from '../peers/peer.js'
+import { StarGiftUnique } from '../premium/stars-gift-unique.js'
 import { StarGift } from '../premium/stars-gift.js'
 
 /** Group was created */
@@ -200,7 +199,7 @@ export interface ActionCall {
     readonly duration: number
 
     /** Call discard reason, if available */
-    readonly reason?: CallDiscardReason
+    readonly reason?: tl.TypePhoneCallDiscardReason
 }
 
 /** A screenshot was taken */
@@ -534,6 +533,7 @@ export interface ActionStarsPrize {
     giveawayMessageId: number
 }
 
+/** A star gift was sent */
 export interface ActionStarGift {
     readonly type: 'stars_gift'
 
@@ -541,6 +541,9 @@ export interface ActionStarGift {
     nameHidden: boolean
     /** Whether this gift was saved to the recipient's profile */
     saved: boolean
+    /** Whether this gift was refunded */
+    refunded: boolean
+
     /** Whether this gift was converted to stars */
     converted: boolean
     /**
@@ -548,8 +551,18 @@ export interface ActionStarGift {
      * (0 if the gift cannot be converted)
      */
     convertStars: tl.Long
+
+    /** Whether this gift can be upgraded to a unique gift */
+    canUpgrade: boolean
+    /** Whether this gift was upgraded to a unique gift */
+    upgraded: boolean
+    /** Number of stars to upgrade the gift to a unique gift (may be 0) */
+    upgradeStars: tl.Long
+    /** If the gift was upgraded, ID of the message where this happened */
+    upgradeMsgId: number | null
+
     /** The gift itself */
-    gift: StarGift
+    gift: StarGift | StarGiftUnique
     /** Message attached to the gift */
     message: TextWithEntities | null
 }
@@ -715,7 +728,7 @@ export function _messageActionFromTl(this: Message, act: tl.TypeMessageAction):
                 type: 'call',
                 id: act.callId,
                 isVideo: Boolean(act.video),
-                reason: act.reason ? _callDiscardReasonFromTl(act.reason) : undefined,
+                reason: act.reason,
                 duration: act.duration ?? 0,
             }
         case 'messageActionScreenshotTaken':
@@ -902,8 +915,15 @@ export function _messageActionFromTl(this: Message, act: tl.TypeMessageAction):
                 saved: act.saved!,
                 converted: act.converted!,
                 convertStars: act.convertStars ?? Long.ZERO,
-                gift: new StarGift(act.gift),
+                refunded: act.refunded!,
+                gift: act.gift._ === 'starGift'
+                    ? new StarGift(act.gift)
+                    : new StarGiftUnique(act.gift, this._peers),
                 message: act.message ?? null,
+                canUpgrade: act.canUpgrade!,
+                upgraded: act.upgraded!,
+                upgradeStars: act.upgradeStars ?? Long.ZERO,
+                upgradeMsgId: act.upgradeMsgId ?? null,
             }
         default:
             return null

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

@@ -469,11 +469,22 @@ export class Message {
         return this.raw._ === 'message' && !this.raw.noforwards
     }
 
+    /**
+     * Whether reactions are possible on this message
+     *
+     * > **Note**: for non-service message this is always `true`,
+     * > regardless if the message can actually be reacted to.
+     */
+    get canBeReacted(): boolean {
+        if (this.raw._ === 'message') return true
+        return this.raw.reactionsArePossible!
+    }
+
     /**
      * Reactions added to this message, if any
      */
     get reactions(): MessageReactions | null {
-        if (this.raw._ === 'messageService' || !this.raw.reactions) {
+        if (!this.raw.reactions) {
             return null
         }
 

packages/core/src/highlevel/types/peers/bot-info.ts

@@ -53,6 +53,10 @@ export class BotInfo {
     get privacyPolicyUrl(): string | null {
         return this.raw.privacyPolicyUrl ?? null
     }
+
+    get verifierSettings(): tl.TypeBotVerifierSettings | null {
+        return this.raw.verifierSettings ?? null
+    }
 }
 
 makeInspectable(BotInfo)

packages/core/src/highlevel/types/peers/bot-verification.ts

@@ -0,0 +1,24 @@
+import type { tl } from '@mtcute/tl'
+import { makeInspectable } from '../../utils/inspectable.js'
+
+/** Information about a bot-issued verification */
+export class BotVerification {
+    constructor(readonly raw: tl.RawBotVerification) {}
+
+    /** ID of the bot which has verified this user */
+    get botId(): number {
+        return this.raw.botId
+    }
+
+    /** ID of the custom emoji to display */
+    get emojiId(): tl.Long {
+        return this.raw.icon
+    }
+
+    /** Description of the verification */
+    get description(): string {
+        return this.raw.description
+    }
+}
+
+makeInspectable(BotVerification)

packages/core/src/highlevel/types/peers/chat-preview.ts

@@ -4,6 +4,7 @@ import { makeInspectable } from '../../utils/index.js'
 import { memoizeGetters } from '../../utils/memoize.js'
 import { Photo } from '../media/photo.js'
 
+import { BotVerification } from './bot-verification.js'
 import { User } from './user.js'
 
 /**
@@ -81,6 +82,14 @@ export class ChatPreview {
     get withApproval(): boolean {
         return this.invite.requestNeeded!
     }
+
+    /**
+     * If non-null, this user was verified by a bot, and this field contains
+     * the ID of the custom emoji to display as the verification icon.
+     */
+    get customVerification(): BotVerification | null {
+        return this.invite.botVerification ? new BotVerification(this.invite.botVerification) : null
+    }
 }
 
 memoizeGetters(ChatPreview, ['photo', 'someMembers'])

packages/core/src/highlevel/types/peers/chat.ts

@@ -409,6 +409,15 @@ export class Chat {
         return new EmojiStatus(this.raw.emojiStatus)
     }
 
+    /**
+     * If non-null, this user was verified by a bot, and this field contains
+     * the ID of the custom emoji to display as the verification icon.
+     */
+    get customVerificationEmojiId(): tl.Long | null {
+        if (this.raw._ !== 'channel') return null
+        return this.raw.botVerificationIcon ?? null
+    }
+
     /**
      * Color that should be used when rendering the header of
      * the user's profile

packages/core/src/highlevel/types/peers/chatlist-preview.ts

@@ -1,8 +1,9 @@
 import type { tl } from '@mtcute/tl'
 
+import type { TextWithEntities } from '../misc/entities.js'
 import type { Peer } from './peer.js'
-import { makeInspectable } from '../../utils/inspectable.js'
 
+import { makeInspectable } from '../../utils/inspectable.js'
 import { memoizeGetters } from '../../utils/memoize.js'
 import { parsePeer } from './peer.js'
 import { PeersIndex } from './peers-index.js'
@@ -27,8 +28,8 @@ export class ChatlistPreview {
     }
 
     /** Title of the chatlist (only available for non-joined chatlists) */
-    get title(): string {
+    get title(): TextWithEntities {
-        return this.raw._ === 'chatlists.chatlistInvite' ? this.raw.title : ''
+        return this.raw._ === 'chatlists.chatlistInvite' ? this.raw.title : { text: '', entities: [] }
     }
 
     /** Emoji representing an icon of the chatlist (may only be available for non-joined chatlists) */

packages/core/src/highlevel/types/peers/full-chat.ts

@@ -7,6 +7,7 @@ import { StickerSet } from '../misc/sticker-set.js'
 
 import { PeerStories } from '../stories/peer-stories.js'
 import { BotInfo } from './bot-info.js'
+import { BotVerification } from './bot-verification.js'
 import { ChatInviteLink } from './chat-invite-link.js'
 import { ChatLocation } from './chat-location.js'
 import { Chat } from './chat.js'
@@ -356,6 +357,13 @@ export class FullChat extends Chat {
 
         return new PeerStories(this.full.stories, this.peers)
     }
+
+    /** Information about a bot-issued verification (if any) */
+    get botVerification(): BotVerification | null {
+        if (this.full._ !== 'channelFull' || !this.full.botVerification) return null
+
+        return new BotVerification(this.full.botVerification)
+    }
 }
 
 memoizeGetters(FullChat, [
@@ -368,5 +376,6 @@ memoizeGetters(FullChat, [
     'linkedChat',
     'recentRequesters',
     'stories',
+    'botVerification',
 ])
 makeInspectable(FullChat)

packages/core/src/highlevel/types/peers/full-user.ts

@@ -6,6 +6,7 @@ import { Photo } from '../media/photo.js'
 
 import { BusinessAccount } from '../premium/business-account.js'
 
+import { BotVerification } from './bot-verification.js'
 import { Chat } from './chat.js'
 import { PeersIndex } from './peers-index.js'
 import { User } from './user.js'
@@ -251,6 +252,13 @@ export class FullUser extends User {
         }
         return null
     }
+
+    /** Information about a bot-issued verification (if any) */
+    get botVerification(): BotVerification | null {
+        if (!this.full.botVerification) return null
+
+        return new BotVerification(this.full.botVerification)
+    }
 }
 
 memoizeGetters(FullUser, [
@@ -260,5 +268,6 @@ memoizeGetters(FullUser, [
     'publicPhoto',
     'personalChannel',
     'business',
+    'botVerification',
 ])
 makeInspectable(FullUser)

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

@@ -1,4 +1,5 @@
 export * from './bot-info.js'
+export * from './bot-verification.js'
 export * from './chat-colors.js'
 export * from './chat-event/index.js'
 export * from './chat-invite-link-member.js'

packages/core/src/highlevel/types/peers/user.ts

@@ -148,6 +148,14 @@ export class User {
         return this.raw.verified!
     }
 
+    /**
+     * If non-null, this user was verified by a bot, and this field contains
+     * the ID of the custom emoji to display as the verification icon.
+     */
+    get customVerificationEmojiId(): tl.Long | null {
+        return this.raw.botVerificationIcon ?? null
+    }
+
     /**
      * Whether this user has been restricted. Bots only.
      * See {@link restrictionReason} for details

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

@@ -7,6 +7,7 @@ export * from './business-connection.js'
 export * from './business-intro.js'
 export * from './business-location.js'
 export * from './business-work-hours.js'
+export * from './stars-gift-unique.js'
 export * from './stars-gift.js'
 export * from './stars-status.js'
 export * from './stars-transaction.js'

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

@@ -0,0 +1,178 @@
+import type { tl } from '@mtcute/tl'
+import type { Sticker } from '../media/sticker.js'
+import type { TextWithEntities } from '../misc/entities.js'
+import type { PeersIndex } from '../peers/peers-index.js'
+import { assert } from '@fuman/utils'
+import { makeInspectable } from '../../utils/inspectable.js'
+import { memoizeGetters } from '../../utils/memoize.js'
+import { parseDocument } from '../media/document-utils.js'
+import { User } from '../peers/user.js'
+
+/** An attribute of a unique star gift containing a sticker */
+export class StarGiftUniqueAttribute {
+    constructor(
+        readonly raw: tl.RawStarGiftAttributeModel | tl.RawStarGiftAttributePattern,
+    ) {}
+
+    /** Rarity permille of the attribute */
+    get permille(): number {
+        return this.raw.rarityPermille
+    }
+
+    /** Display name of the attribute */
+    get name(): string {
+        return this.raw.name
+    }
+
+    get sticker(): Sticker {
+        assert(this.raw.document._ === 'document')
+        const parsed = parseDocument(this.raw.document)
+        assert(parsed.type === 'sticker')
+
+        return parsed
+    }
+}
+
+makeInspectable(StarGiftUniqueAttribute)
+memoizeGetters(StarGiftUniqueAttribute, ['sticker'])
+
+/** Information about a unique star gift's backdrop */
+export class StarGiftUniqueBackdrop {
+    constructor(
+        readonly raw: tl.RawStarGiftAttributeBackdrop,
+    ) {}
+
+    /** Rarity permille of the attribute */
+    get permille(): number {
+        return this.raw.rarityPermille
+    }
+
+    /** Display name of the attribute */
+    get name(): string {
+        return this.raw.name
+    }
+
+    get centerColor(): number {
+        return this.raw.centerColor
+    }
+
+    get edgeColor(): number {
+        return this.raw.edgeColor
+    }
+
+    get patternColor(): number {
+        return this.raw.patternColor
+    }
+
+    get textColor(): number {
+        return this.raw.textColor
+    }
+}
+makeInspectable(StarGiftUniqueBackdrop)
+
+/** Details about the original star gift */
+export class StarGiftUniqueOriginalDetails {
+    constructor(
+        readonly raw: tl.RawStarGiftAttributeOriginalDetails,
+        readonly _peers: PeersIndex,
+    ) {}
+
+    /** ID of the user who sent the original star gift */
+    get sender(): User | null {
+        return this.raw.senderId ? new User(this._peers.user(this.raw.senderId)) : null
+    }
+
+    /** ID of the user who received the original star gift */
+    get recipient(): User {
+        return new User(this._peers.user(this.raw.recipientId))
+    }
+
+    /** Date when the original star gift was sent */
+    get date(): Date {
+        return new Date(this.raw.date * 1000)
+    }
+
+    /** Message attached to the original star gift */
+    get message(): TextWithEntities | null {
+        return this.raw.message ?? null
+    }
+}
+
+/** A unique star gift */
+export class StarGiftUnique {
+    readonly _model!: tl.RawStarGiftAttributeModel
+    readonly _pattern!: tl.RawStarGiftAttributePattern
+    readonly _backdrop!: tl.RawStarGiftAttributeBackdrop
+    readonly _originalDetails: tl.RawStarGiftAttributeOriginalDetails | undefined
+
+    /** Whether this gift is a unique gift */
+    readonly isUnique = true as const
+
+    constructor(
+        readonly raw: tl.RawStarGiftUnique,
+        readonly _peers: PeersIndex,
+    ) {
+        for (const attr of this.raw.attributes) {
+            if (attr._ === 'starGiftAttributeModel') {
+                this._model = attr
+            } else if (attr._ === 'starGiftAttributePattern') {
+                this._pattern = attr
+            } else if (attr._ === 'starGiftAttributeBackdrop') {
+                this._backdrop = attr
+            } else if (attr._ === 'starGiftAttributeOriginalDetails') {
+                this._originalDetails = attr
+            }
+        }
+
+        assert(this._model !== undefined)
+        assert(this._pattern !== undefined)
+        assert(this._backdrop !== undefined)
+    }
+
+    /** Number of the NFT */
+    get num(): number {
+        return this.raw.num
+    }
+
+    /** Title of the NFT */
+    get title(): string {
+        return this.raw.title
+    }
+
+    /** ID of the user who owns this gift */
+    get owner(): User {
+        return new User(this._peers.user(this.raw.ownerId))
+    }
+
+    get availabilityIssued(): number {
+        return this.raw.availabilityIssued
+    }
+
+    get availabilityTotal(): number {
+        return this.raw.availabilityTotal
+    }
+
+    /** Model (i.e. the gift itself) of the unique star gift */
+    get model(): StarGiftUniqueAttribute {
+        return new StarGiftUniqueAttribute(this._model)
+    }
+
+    /** Pattern of the unique star gift */
+    get pattern(): StarGiftUniqueAttribute {
+        return new StarGiftUniqueAttribute(this._pattern)
+    }
+
+    /** Backdrop of the unique star gift */
+    get backdrop(): StarGiftUniqueBackdrop {
+        return new StarGiftUniqueBackdrop(this._backdrop)
+    }
+
+    /** Details about the original star gift (if they were retained when minting) */
+    get originalDetails(): StarGiftUniqueOriginalDetails | null {
+        if (!this._originalDetails) return null
+        return new StarGiftUniqueOriginalDetails(this._originalDetails, this._peers)
+    }
+}
+
+makeInspectable(StarGiftUnique)
+memoizeGetters(StarGiftUnique, ['model', 'pattern', 'backdrop', 'originalDetails'])

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

@@ -3,20 +3,20 @@ import type { tl } from '@mtcute/tl'
 import type { Sticker } from '../media/sticker.js'
 import type { TextWithEntities } from '../misc/entities.js'
 import type { PeersIndex } from '../peers/peers-index.js'
+import Long from 'long'
 import { MtTypeAssertionError } from '../../../types/errors.js'
 import { assertTypeIs } from '../../../utils/type-assertions.js'
 import { makeInspectable } from '../../utils/inspectable.js'
 import { memoizeGetters } from '../../utils/memoize.js'
 import { parseDocument } from '../media/document-utils.js'
 import { User } from '../peers/user.js'
+import { StarGiftUnique } from './stars-gift-unique.js'
 
 /**
  * A gift with stars attached to it.
  */
 export class StarGift {
-    constructor(
+    constructor(readonly raw: tl.RawStarGift) {}
-        readonly raw: tl.TypeStarGift,
-    ) {}
 
     /** ID of the gift */
     get id(): tl.Long {
@@ -33,6 +33,9 @@ export class StarGift {
         return this.raw.limited!
     }
 
+    /** Whether this gift is a unique gift */
+    readonly isUnique = true as const
+
     /** Additional information for sold-out gifts */
     get soldOutInfo(): {
         /** Date when the first gift was bought */
@@ -74,6 +77,13 @@ export class StarGift {
         return this.raw.convertStars
     }
 
+    /**
+     * Amount of stars the gift can be upgraded for
+     */
+    get upgradeStars(): tl.Long | null {
+        return this.raw.upgradeStars ?? null
+    }
+
     /**
      * For limited availability gifts,
      * the number of remaining and total gifts available
@@ -112,6 +122,10 @@ export class UserStarGift {
         return this.raw.unsaved!
     }
 
+    get isRefunded(): boolean {
+        return this.raw.refunded!
+    }
+
     /** Sender of the gift, if available */
     get sender(): User | null {
         return this.raw.fromId ? new User(this.peers.user(this.raw.fromId)) : null
@@ -122,14 +136,27 @@ export class UserStarGift {
         return this.raw.msgId ?? null
     }
 
-    /** Date the gift was sent */
+    /** Date the gift was sent or minted */
     get date(): Date {
         return new Date(this.raw.date * 1000)
     }
 
+    /** Whether the gift can be upgraded to a unique gift */
+    get canUpgrade(): boolean {
+        return this.raw.canUpgrade!
+    }
+
+    /** Number of stars to upgrade the gift to a unique gift (may be 0) */
+    get upgradeStars(): tl.Long | null {
+        if (!this.raw.canUpgrade) return null
+        return this.raw.upgradeStars ?? Long.ZERO
+    }
+
     /** The gift itself */
-    get gift(): StarGift {
+    get gift(): StarGift | StarGiftUnique {
-        return new StarGift(this.raw.gift)
+        return this.raw.gift._ === 'starGift'
+            ? new StarGift(this.raw.gift)
+            : new StarGiftUnique(this.raw.gift, this.peers)
     }
 
     /** Text attached to the gift */
@@ -144,6 +171,15 @@ export class UserStarGift {
     get convertStars(): tl.Long | null {
         return this.raw.convertStars ?? null
     }
+
+    get canExportAt(): Date | null {
+        return this.raw.canExportAt ? new Date(this.raw.canExportAt * 1000) : null
+    }
+
+    /** Number of stars this gift can be transferred for */
+    get transferStars(): tl.Long | null {
+        return this.raw.transferStars ?? null
+    }
 }
 
 makeInspectable(UserStarGift)

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

@@ -9,6 +9,7 @@ import { WebDocument } from '../files/web-document.js'
 import { _messageMediaFromTl, type MessageMedia } from '../messages/message-media.js'
 import { parsePeer } from '../peers/peer.js'
 
+import { StarGiftUnique } from './stars-gift-unique.js'
 import { StarGift } from './stars-gift.js'
 
 // ref: https://github.com/tdlib/td/blob/master/td/telegram/StarManager.cpp#L223
@@ -26,6 +27,8 @@ import { StarGift } from './stars-gift.js'
  *  - `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)
+ *  - `star_gift_upgrade`: This transaction is for a star gift upgrade
+ *  - `star_gift_transfer`: This transaction is for a star gift transfer
  *  - `api_*`: This transaction is a payment for paid API features
  *     - `api_floodskip`: This transaction is a payment for a paid bot broadcast
  */
@@ -125,6 +128,20 @@ export type StarsTransactionType =
       /** The gift */
       gift: StarGift
   }
+  | {
+      type: 'star_gift_upgrade'
+      /** Related peer */
+      peer: Peer
+      /** The upgraded gift */
+      gift: StarGiftUnique
+  }
+  | {
+      type: 'star_gift_transfer'
+      /** Recepient peer */
+      recepient: Peer
+      /** The upgraded gift */
+      gift: StarGiftUnique
+  }
   | {
       type: 'api_floodskip'
       /** The number of billed API calls */
@@ -232,30 +249,46 @@ export class StarsTransaction {
                 }
 
                 if (this.raw.stargift) {
-                    return {
+                    if (this.raw.stargift._ === 'starGift') {
-                        type: 'star_gift',
+                        return {
-                        peer,
+                            type: 'star_gift',
-                        gift: new StarGift(this.raw.stargift),
+                            peer,
+                            gift: new StarGift(this.raw.stargift),
+                        }
+                    } else if (this.raw.stargiftUpgrade) {
+                        return {
+                            type: 'star_gift_upgrade',
+                            peer,
+                            gift: new StarGiftUnique(this.raw.stargift, this.peers),
+                        }
+                    } else {
+                        return {
+                            type: 'star_gift_transfer',
+                            recepient: peer,
+                            gift: new StarGiftUnique(this.raw.stargift, this.peers),
+                        }
                     }
                 }
 
-                if (this.raw.msgId) {
+                if (this.raw.stargiftUpgrade) {
-                    if (this.raw.reaction) {
+                    if (this.raw.msgId) {
+                        if (this.raw.reaction) {
+                            return {
+                                type: 'reaction',
+                                peer,
+                                messageId: this.raw.msgId,
+                            }
+                        }
+
                         return {
-                            type: 'reaction',
+                            type: 'media_purchase',
                             peer,
                             messageId: this.raw.msgId,
+                            media: this.raw.extendedMedia
+                                ? this.raw.extendedMedia.map(it => _messageMediaFromTl(this.peers, it))
+                                : undefined,
                         }
                     }
-
-                    return {
-                        type: 'media_purchase',
-                        peer,
-                        messageId: this.raw.msgId,
-                        media: this.raw.extendedMedia
-                            ? this.raw.extendedMedia.map(it => _messageMediaFromTl(this.peers, it))
-                            : undefined,
-                    }
                 }
 
                 if (this.raw.subscriptionPeriod) {

packages/tl/README.md

@@ -2,7 +2,7 @@
 
 TL schema and related utils used for mtcute.
 
-Generated from TL layer **195** (last updated on 30.12.2024).
+Generated from TL layer **196** (last updated on 01.01.2025).
 
 ## About
 

packages/tl/data/int53-overrides.json

@@ -10,6 +10,7 @@
     "attachMenuBot": ["bot_id"],
     "autoDownloadSettings": ["video_size_max", "file_size_max"],
     "botInfo": ["user_id"],
+    "botVerification": ["bot_id"],
     "boost": ["user_id"],
     "botBusinessConnection": ["user_id"],
     "businessRecipients": ["users"],
@@ -102,6 +103,8 @@
     "requestedPeerChat": ["chat_id"],
     "requestedPeerUser": ["user_id"],
     "starRefProgram": ["bot_id"],
+    "starGiftUnique": ["owner_id"],
+    "starGiftAttributeOriginalDetails": ["sender_id", "recipient_id"],
     "secureFile": ["size"],
     "statsGroupTopAdmin": ["user_id"],
     "statsGroupTopInviter": ["user_id"],

packages/tl/package.json

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