@telegram.ts/types 1.21.1 → 1.22.0

package/README.md

@@ -1,3 +1,7 @@
+[![Bot API](https://img.shields.io/badge/Bot%20API-v.9.0-00aced.svg?style=flat-square&logo=telegram)](https://core.telegram.org/bots/api)
+[![NPM Version](https://img.shields.io/npm/v/@telegram.ts/types.svg?maxAge=3600)](https://www.npmjs.com/package/@telegram.ts/types)
+[![NPM Downloads](https://img.shields.io/npm/dt/@telegram.ts/types.svg?maxAge=3600)](https://www.npmjs.com/package/@telegram.ts/types)
+
 # @telegram.ts/types: Type Declarations for Telegram Bot API
 
 The `@telegram.ts/types` package provides comprehensive type declarations for the Telegram Bot API, specifically tailored for use with `telegramsjs`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@telegram.ts/types",
-  "version": "1.21.1",
+  "version": "1.22.0",
   "description": "Comprehensive Type Declarations for Telegram Bot API with telegramsjs",
   "main": "./src/index.js",
   "types": "./src/index.d.ts",

package/src/apiMethodsTypes.d.ts

@@ -6,6 +6,7 @@ import type {
   InlineQueryResultsButton,
 } from "./inlineTypes";
 import type {
+  AcceptedGiftTypes,
   BotCommand,
   BusinessConnection,
   ChatAdministratorRights,
@@ -44,12 +45,15 @@ import type {
   SentWebAppMessage,
   Sticker,
   StickerSet,
+  Story,
 } from "./messageTypes";
 import type { PassportElementError } from "./passportTypes";
 import type {
   Gifts,
   LabeledPrice,
+  OwnedGifts,
   ShippingOption,
+  StarAmount,
   StarTransactions,
 } from "./invoiceTypes";
 import type {
@@ -59,6 +63,7 @@ import type {
   BotShortDescription,
   MenuButton,
 } from "./botCommandTypes";
+import { StoryArea } from "./storyTypes.ts";
 import type { Update } from "./updateTypes";
 
 /** Wrapper type to bundle all methods of the Telegram Bot API */
@@ -867,8 +872,18 @@ export type ApiMethods = {
     message_thread_id?: number;
   }): true;
 
+  /** Marks incoming message as read on behalf of a business account. Requires the can_read_messages business bot right. Returns True on success. */
+  readBusinessMessage(args: {
+    /** Unique identifier of the business connection on behalf of which to read the message */
+    business_connection_id: string;
+    /** Unique identifier of the chat in which the message was received. The chat must have been active in the last 24 hours. */
+    chat_id: number;
+    /** Unique identifier of the message to mark as read */
+    message_id: number;
+  }): true;
+
   /** Use this method to change the chosen reactions on a message. Service messages of some types can't be reacted to. Automatically forwarded messages from a channel to its discussion group have the same available reactions as messages in the channel. In albums, bots must react to the first message. Returns True on success. */
-  setMessageReaction(args: {
+  (args: {
     /** Unique identifier for the target chat or username of the target channel (in the format @channelusername) */
     chat_id: number | string;
     /** Identifier of the target message */
@@ -1438,6 +1453,120 @@ export type ApiMethods = {
     for_channels?: boolean;
   }): ChatAdministratorRights;
 
+  /** Changes the first and last name of a managed business account. Requires the can_change_name business bot right. Returns True on success. */
+  setBusinessAccountName(args: {
+    /** Unique identifier of the business connection */
+    business_connection_id: string;
+    /** The new value of the first name for the business account; 1-64 characters */
+    first_name: string;
+    /** The new value of the last name for the business account; 0-64 characters */
+    last_name?: string;
+  }): true;
+
+  /** Changes the username of a managed business account. Requires the can_change_username business bot right. Returns True on success. */
+  setBusinessAccountUsername(args: {
+    /** Unique identifier of the business connection */
+    business_connection_id: string;
+    /** The new value of the username for the business account; 0-32 characters */
+    username?: string;
+  }): true;
+
+  /** Changes the bio of a managed business account. Requires the can_change_bio business bot right. Returns True on success. */
+  setBusinessAccountBio(args: {
+    /** Unique identifier of the business connection */
+    business_connection_id: string;
+    /** The new value of the bio for the business account; 0-140 characters */
+    bio?: string;
+  }): true;
+
+  /** Changes the profile photo of a managed business account. Requires the can_edit_profile_photo business bot right. Returns True on success. */
+  setBusinessAccountProfilePhoto(args: {
+    /** Unique identifier of the business connection */
+    business_connection_id: string;
+    /** The new profile photo to set */
+    photo: InputProfilePhoto<F>;
+    /** Pass True to set the public photo, which will be visible even if the main photo is hidden by the business account's privacy settings. An account can have only one public photo. */
+    is_public?: boolean;
+  }): true;
+
+  /** Removes the current profile photo of a managed business account. Requires the can_edit_profile_photo business bot right. Returns True on success. */
+  removeBusinessAccountProfilePhoto(args: {
+    /** Unique identifier of the business connection */
+    business_connection_id: string;
+    /** Pass True to remove the public photo, which is visible even if the main photo is hidden by the business account's privacy settings. After the main photo is removed, the previous profile photo (if present) becomes the main photo. */
+    is_public?: boolean;
+  }): true;
+
+  /** Changes the privacy settings pertaining to incoming gifts in a managed business account. Requires the can_change_gift_settings business bot right. Returns True on success. */
+  setBusinessAccountGiftSettings(args: {
+    /** Unique identifier of the business connection */
+    business_connection_id: string;
+    /** Pass True, if a button for sending a gift to the user or by the business account must always be shown in the input field */
+    show_gift_button: boolean;
+    /** Types of gifts accepted by the business account */
+    accepted_gift_types: AcceptedGiftTypes;
+  }): true;
+
+  /** Returns the amount of Telegram Stars owned by a managed business account. Requires the can_view_gifts_and_stars business bot right. Returns StarAmount on success. */
+  getBusinessAccountStarBalance(args: {
+    /** Unique identifier of the business connection */
+    business_connection_id: string;
+  }): StarAmount;
+
+  /** Returns the gifts received and owned by a managed business account. Requires the can_view_gifts_and_stars business bot right. Returns OwnedGifts on success. */
+  getBusinessAccountGifts(args: {
+    /** Unique identifier of the business connection */
+    business_connection_id: string;
+    /** Pass True to exclude gifts that aren't saved to the account's profile page */
+    exclude_unsaved?: boolean;
+    /** Pass True to exclude gifts that are saved to the account's profile page */
+    exclude_saved?: boolean;
+    /** Pass True to exclude gifts that can be purchased an unlimited number of times */
+    exclude_unlimited?: boolean;
+    /** Pass True to exclude gifts that can be purchased a limited number of times */
+    exclude_limited?: boolean;
+    /** Pass True to exclude unique gifts */
+    exclude_unique?: boolean;
+    /** Pass True to sort results by gift price instead of send date. Sorting is applied before pagination. */
+    sort_by_price?: boolean;
+    /** Offset of the first entry to return as received from the previous request; use empty string to get the first chunk of results */
+    offset?: string;
+    /** The maximum number of gifts to be returned; 1-100. Defaults to 100 */
+    limit?: number;
+  }): OwnedGifts;
+
+  /** Converts a given regular gift to Telegram Stars. Requires the can_convert_gifts_to_stars business bot right. Returns True on success. */
+  convertGiftToStars(args: {
+    /** Unique identifier of the business connection */
+    business_connection_id: string;
+    /** Unique identifier of the regular gift that should be converted to Telegram Stars */
+    owned_gift_id: string;
+  }): true;
+
+  /** Upgrades a given regular gift to a unique gift. Requires the can_transfer_and_upgrade_gifts business bot right. Additionally requires the can_transfer_stars business bot right if the upgrade is paid. Returns True on success. */
+  upgradeGift(args: {
+    /** Unique identifier of the business connection */
+    business_connection_id: string;
+    /** Unique identifier of the regular gift that should be upgraded to a unique one */
+    owned_gift_id: string;
+    /** Pass True to keep the original gift text, sender and receiver in the upgraded gift */
+    keep_original_details?: boolean;
+    /** The amount of Telegram Stars that will be paid for the upgrade from the business account balance. If gift.prepaid_upgrade_star_count > 0, then pass 0, otherwise, the can_transfer_stars business bot right is required and gift.upgrade_star_count must be passed. */
+    star_count?: number;
+  }): true;
+
+  /** Transfers an owned unique gift to another user. Requires the can_transfer_and_upgrade_gifts business bot right. Requires can_transfer_stars business bot right if the transfer is paid. Returns True on success. */
+  transferGift(args: {
+    /** Unique identifier of the business connection */
+    business_connection_id: string;
+    /** Unique identifier of the regular gift that should be transferred */
+    owned_gift_id: string;
+    /** Unique identifier of the chat which will own the gift. The chat must be active in the last 24 hours. */
+    new_owner_chat_id: number;
+    /** The amount of Telegram Stars that will be paid for the transfer from the business account balance. If positive, then the can_transfer_stars business bot right is required. */
+    star_count: number;
+  }): true;
+
   /** Use this method to edit text and game messages. On success, if the edited message is not an inline message, the edited Message is returned, otherwise True is returned. Note that business messages that were not sent by the bot and do not contain an inline keyboard can only be edited within 48 hours from the time they were sent. */
   editMessageText(args: {
     /** Unique identifier of the business connection on behalf of which the message to be edited was sent */
@@ -1549,6 +1678,14 @@ export type ApiMethods = {
     message_ids: number[];
   }): true;
 
+  /** Delete messages on behalf of a business account. Requires the can_delete_outgoing_messages business bot right to delete messages sent by the bot itself, or the can_delete_all_messages business bot right to delete any message. Returns True on success. */
+  deleteBusinessMessages(args: {
+    /** Unique identifier of the business connection on behalf of which to delete the messages */
+    business_connection_id: string;
+    /** A list of 1-100 identifiers of messages to delete. All messages must be from the same chat. See deleteMessage for limitations on which messages can be deleted */
+    message_ids: number[];
+  }): true;
+
   /** Use this method to send static .WEBP, animated .TGS, or video .WEBM stickers. On success, the sent Message is returned. */
   sendSticker(args: {
     /** Unique identifier of the business connection on behalf of which the message will be sent */
@@ -1711,6 +1848,54 @@ export type ApiMethods = {
     custom_emoji_id?: string;
   }): true;
 
+  /** Posts a story on behalf of a managed business account. Requires the can_manage_stories business bot right. Returns Story on success. */
+  postStory(args: {
+    /** Unique identifier of the business connection */
+    business_connection_id: string;
+    /** Content of the story */
+    content: InputStoryContent<F>;
+    /** Period after which the story is moved to the archive, in seconds; must be one of 6 * 3600, 12 * 3600, 86400, or 2 * 86400 */
+    active_period: number;
+    /** Caption of the story, 0-2048 characters after entities parsing */
+    caption?: string;
+    /** Mode for parsing entities in the story caption. See formatting options for more details. */
+    parse_mode?: string;
+    /** A list of special entities that appear in the caption, which can be specified instead of parse_mode */
+    caption_entities?: MessageEntity[];
+    /** A list of clickable areas to be shown on the story */
+    areas?: StoryArea[];
+    /** Pass True to keep the story accessible after it expires */
+    post_to_chat_page?: boolean;
+    /** Pass True if the content of the story must be protected from forwarding and screenshotting */
+    protect_content?: boolean;
+  }): Story;
+
+  /** Edits a story previously posted by the bot on behalf of a managed business account. Requires the can_manage_stories business bot right. Returns Story on success. */
+  editStory(args: {
+    /** Unique identifier of the business connection */
+    business_connection_id: string;
+    /** Unique identifier of the story to edit */
+    story_id: number;
+    /** Content of the story */
+    content: InputStoryContent<F>;
+    /** Caption of the story, 0-2048 characters after entities parsing */
+    caption?: string;
+    /** Mode for parsing entities in the story caption. See formatting options for more details. */
+    parse_mode?: string;
+    /** A list of special entities that appear in the caption, which can be specified instead of parse_mode */
+    caption_entities?: MessageEntity[];
+    /** A list of clickable areas to be shown on the story */
+    areas?: StoryArea;
+  }): Story;
+
+  /** Deletes a story previously posted by the bot on behalf of a managed business account. Requires the can_manage_stories business bot right. Returns True on success. */
+  deleteStory(args: {
+    /** Unique identifier of the business connection */
+    business_connection_id: string;
+    /** Unique identifier of the story to delete */
+    story_id: number;
+  }): true;
+
   /** Returns the list of gifts that can be sent by the bot to users and chennel chats. Requires no parameters. Returns a Gifts object. */
   getAvailableGifts(): Gifts;
 
@@ -1732,6 +1917,30 @@ export type ApiMethods = {
     text_entities?: MessageEntity[];
   }): true;
 
+  /** Gifts a Telegram Premium subscription to the given user. Returns True on success. */
+  giftPremiumSubscription(args: {
+    /** Unique identifier of the target user who will receive a Telegram Premium subscription */
+    user_id: number;
+    /** Number of months the Telegram Premium subscription will be active for the user; must be one of 3, 6, or 12 */
+    month_count: 3 | 6 | 12;
+    /** Number of Telegram Stars to pay for the Telegram Premium subscription; must be 1000 for 3 months, 1500 for 6 months, and 2500 for 12 months */
+    star_count: 1000 | 1500 | 2500;
+    /** Text that will be shown along with the service message about the subscription; 0-128 characters */
+    text?: string;
+    /** Mode for parsing entities in the text. See formatting options for more details. Entities other than “bold”, “italic”, “underline”, “strikethrough”, “spoiler”, and “custom_emoji” are ignored. */
+    text_parse_mode?: string;
+    /** A list of special entities that appear in the gift text. It can be specified instead of text_parse_mode. Entities other than “bold”, “italic”, “underline”, “strikethrough”, “spoiler”, and “custom_emoji” are ignored. */
+    text_entities?: MessageEntity[];
+  }): true;
+
+  /** Transfers Telegram Stars from the business account balance to the bot's balance. Requires the can_transfer_stars business bot right. Returns True on success. */
+  transferBusinessAccountStars(args: {
+    /** Unique identifier of the business connection */
+    business_connection_id: string;
+    /** Number of Telegram Stars to transfer; 1-10000 */
+    star_count: number;
+  }): true;
+
   /** Use this method to send answers to an inline query. On success, True is returned.
   No more than 50 results per query are allowed.
 
@@ -2205,3 +2414,55 @@ export interface InputPaidMediaVideo {
   /** Pass True if the uploaded video is suitable for streaming */
   supports_streaming?: boolean;
 }
+
+/** This object describes a profile photo to set. Currently, it can be one of
+- InputProfilePhotoStatic
+- InputProfilePhotoAnimated */
+export type InputProfilePhoto =
+  | InputProfilePhotoStatic
+  | InputProfilePhotoAnimated;
+
+/** A static profile photo in the .JPG format. */
+export interface InputProfilePhotoStatic {
+  /** Type of the profile photo, must be “static” */
+  type: "static";
+  /** The static profile photo. Profile photos can't be reused and can only be uploaded as a new file, so you can pass “attach://<file_attach_name>” if the photo was uploaded using multipart/form-data under <file_attach_name>. More information on Sending Files » */
+  photo: Buffer | ReadStream | string;
+}
+
+/** An animated profile photo in the MPEG4 format. */
+export interface InputProfilePhotoAnimated {
+  /** Type of the profile photo, must be “animated” */
+  type: "animated";
+  /** The animated profile photo. Profile photos can't be reused and can only be uploaded as a new file, so you can pass “attach://<file_attach_name>” if the photo was uploaded using multipart/form-data under <file_attach_name>. More information on Sending Files » */
+  animation: F;
+  /** Timestamp in seconds of the frame that will be used as the static profile photo. Defaults to 0.0. */
+  main_frame_timestamp?: number;
+}
+
+/** This object describes the content of a story to post. Currently, it can be one of
+- InputStoryContentPhoto
+- InputStoryContentVideo */
+export type InputStoryContent = InputStoryContentPhoto | InputStoryContentVideo;
+
+/** Describes a photo to post as a story. */
+export interface InputStoryContentPhoto {
+  /** Type of the content, must be “photo” */
+  type: "photo";
+  /** The photo to post as a story. The photo must be of the size 1080x1920 and must not exceed 10 MB. The photo can't be reused and can only be uploaded as a new file, so you can pass “attach://<file_attach_name>” if the photo was uploaded using multipart/form-data under <file_attach_name>. More information on Sending Files » */
+  photo: Buffer | ReadStream | string;
+}
+
+/** Describes a video to post as a story. */
+export interface InputStoryContentVideo {
+  /** Type of the content, must be “video” */
+  type: "video";
+  /** The video to post as a story. The video must be of the size 720x1280, streamable, encoded with H.265 codec, with key frames added each second in the MPEG4 format, and must not exceed 30 MB. The video can't be reused and can only be uploaded as a new file, so you can pass “attach://<file_attach_name>” if the video was uploaded using multipart/form-data under <file_attach_name>. More information on Sending Files » */
+  video: Buffer | ReadStream | string;
+  /** Precise duration of the video in seconds; 0-60 */
+  duration?: number;
+  /** Timestamp in seconds of the frame that will be used as the static cover for the story. Defaults to 0.0. */
+  cover_frame_timestamp?: number;
+  /** Pass True if the video has no sound */
+  is_animation?: boolean;
+}

package/src/index.d.ts

@@ -8,4 +8,5 @@ export * from "./passportTypes";
 export * from "./invoiceTypes";
 export * from "./languageTypes";
 export * from "./botCommandTypes";
+export * from "./storyTypes";
 export * from "./updateTypes";

package/src/invoiceTypes.d.ts

@@ -1,5 +1,5 @@
 import type { Chat, User } from "./manageTypes";
-import type { PaidMedia, Sticker } from "./messageTypes";
+import type { MessageEntity, PaidMedia, Sticker } from "./messageTypes";
 
 /** This object represents a portion of the price for goods or services. */
 export interface LabeledPrice {
@@ -197,20 +197,29 @@ export type TransactionPartner =
 export interface TransactionPartnerUser {
   /** Type of the transaction partner, always “user” */
   type: "user";
+  /** Type of the transaction, currently one of “invoice_payment” for payments via invoices, “paid_media_payment” for payments for paid media, “gift_purchase” for gifts sent by the bot, “premium_purchase” for Telegram Premium subscriptions gifted by the bot, “business_account_transfer” for direct transfers from managed business accounts */
+  transaction_type:
+    | "invoice_payment"
+    | "paid_media_payment"
+    | "gift_purchase"
+    | "premium_purchase"
+    | "business_account_transfer";
   /** Information about the user */
   user: User;
-  /** Information about the affiliate that received a commission via this transaction */
+  /** Information about the affiliate that received a commission via this transaction. Can be available only for “invoice_payment” and “paid_media_payment” transactions. */
   affiliate?: AffiliateInfo;
-  /** The duration of the paid subscription */
+  /** The duration of the paid subscription. Can be available only for “invoice_payment” transactions. */
   subscription_period?: number;
-  /** Bot-specified invoice payload */
+  /** Bot-specified invoice payload. Can be available only for “invoice_payment” transactions. */
   invoice_payload?: string;
-  /** Information about the paid media bought by the user */
+  /** Information about the paid media bought by the user. Can be available only for “invoice_payment” transactions. */
   paid_media?: PaidMedia[];
-  /** Bot-specified paid media payload */
+  /** Bot-specified paid media payload. Can be available only for “invoice_payment” transactions. */
   paid_media_payload?: string;
-  /** The gift sent to the user by the bot */
+  /** The gift sent to the user by the bot; for “gift_purchase” transactions only */
   gift?: Gift;
+  /** Number of months the gifted Telegram Premium subscription will be active for; for “premium_purchase” transactions only */
+  premium_subscription_duration?: number;
 }
 
 /** Describes a transaction with a chat. */
@@ -312,3 +321,172 @@ export interface Gifts {
   /** The list of gifts */
   gifts: Gift[];
 }
+
+/** This object describes the model of a unique gift. */
+export interface UniqueGiftModel {
+  /** Name of the model */
+  name: string;
+  /** The sticker that represents the unique gift */
+  sticker: Sticker;
+  /** The number of unique gifts that receive this model for every 1000 gifts upgraded */
+  rarity_per_mille: number;
+}
+
+/** This object describes the symbol shown on the pattern of a unique gift. */
+export interface UniqueGiftSymbol {
+  /** Name of the symbol */
+  name: string;
+  /** The sticker that represents the unique gift */
+  sticker: Sticker;
+  /** The number of unique gifts that receive this model for every 1000 gifts upgraded */
+  rarity_per_mille: number;
+}
+
+/** This object describes the colors of the backdrop of a unique gift. */
+export interface UniqueGiftBackdropColors {
+  /** The color in the center of the backdrop in RGB format */
+  center_color: number;
+  /** The color on the edges of the backdrop in RGB format */
+  edge_color: number;
+  /** The color to be applied to the symbol in RGB format */
+  symbol_color: number;
+  /** The color for the text on the backdrop in RGB format */
+  text_color: number;
+}
+
+/** This object describes the backdrop of a unique gift. */
+export interface UniqueGiftBackdrop {
+  /** Name of the backdrop */
+  name: string;
+  /** Colors of the backdrop */
+  colors: UniqueGiftBackdropColors;
+  /** The number of unique gifts that receive this backdrop for every 1000 gifts upgraded */
+  rarity_per_mille: number;
+}
+
+/** This object describes a unique gift that was upgraded from a regular gift. */
+export interface UniqueGift {
+  /** Human-readable name of the regular gift from which this unique gift was upgraded */
+  base_name: string;
+  /** Unique name of the gift. This name can be used in https://t.me/nft/... links and story areas */
+  name: string;
+  /** Unique number of the upgraded gift among gifts upgraded from the same regular gift */
+  number: number;
+  /** Model of the gift */
+  model: UniqueGiftModel;
+  /** Symbol of the gift */
+  symbol: UniqueGiftSymbol;
+  /** Backdrop of the gift */
+  backdrop: UniqueGiftBackdrop;
+}
+
+/** Describes a service message about a regular gift that was sent or received. */
+export interface GiftInfo {
+  /** Information about the gift */
+  gift: Gift;
+  /** Unique identifier of the received gift for the bot; only present for gifts received on behalf of business accounts */
+  owned_gift_id?: string;
+  /** Number of Telegram Stars that can be claimed by the receiver by converting the gift; omitted if conversion to Telegram Stars is impossible */
+  convert_star_count?: number;
+  /** Number of Telegram Stars that were prepaid by the sender for the ability to upgrade the gift */
+  prepaid_upgrade_star_count?: number;
+  /** True, if the gift can be upgraded to a unique gift */
+  can_be_upgraded?: true;
+  /** Text of the message that was added to the gift */
+  text?: string;
+  /** Special entities that appear in the text */
+  entities?: MessageEntity[];
+  /** True, if the sender and gift text are shown only to the gift receiver; otherwise, everyone will be able to see them */
+  is_private?: true;
+}
+
+/** Describes a service message about a unique gift that was sent or received. */
+export interface UniqueGiftInfo {
+  /** Information about the gift */
+  gift: UniqueGift;
+  /** Origin of the gift. Currently, either “upgrade” or “transfer” */
+  origin: "upgrade" | "transfer";
+  /** Unique identifier of the received gift for the bot; only present for gifts received on behalf of business accounts */
+  owned_gift_id?: string;
+  /** Number of Telegram Stars that must be paid to transfer the gift; omitted if the bot cannot transfer the gift */
+  transfer_star_count?: number;
+}
+
+/** Describes a service message about a change in the price of paid messages within a chat. */
+export interface PaidMessagePriceChanged {
+  /** The new number of Telegram Stars that must be paid by non-administrator users of the supergroup chat for each sent message */
+  paid_message_star_count: number;
+}
+
+/** Describes an amount of Telegram Stars. */
+export interface StarAmount {
+  /** Integer amount of Telegram Stars, rounded to 0; can be negative */
+  amount: number;
+  /** The number of 1/1000000000 shares of Telegram Stars; from -999999999 to 999999999; can be negative if amount is negative */
+  nanostar_amount?: number;
+}
+
+/** This object describes a gift received and owned by a user or a chat. Currently, it can be one of
+- OwnedGiftRegular
+- OwnedGiftUnique */
+export type OwnedGift = OwnedGiftRegular | OwnedGiftUnique;
+
+/** Describes a regular gift owned by a user or a chat. */
+export interface OwnedGiftRegular {
+  /** Type of the gift, always “regular” */
+  type: "regular";
+  /** Information about the regular gift */
+  gift: Gift;
+  /** Unique identifier of the gift for the bot; for gifts received on behalf of business accounts only */
+  owned_gift_id?: string;
+  /** Sender of the gift if it is a known user */
+  sender_user?: User;
+  /** Date the gift was sent in Unix time */
+  send_date: number;
+  /** Text of the message that was added to the gift */
+  text?: string;
+  /** Special entities that appear in the text */
+  entities?: MessageEntity[];
+  /** True, if the sender and gift text are shown only to the gift receiver; otherwise, everyone will be able to see them */
+  is_private?: true;
+  /** True, if the gift is displayed on the account's profile page; for gifts received on behalf of business accounts only */
+  is_saved?: true;
+  /** True, if the gift can be upgraded to a unique gift; for gifts received on behalf of business accounts only */
+  can_be_upgraded?: true;
+  /** True, if the gift was refunded and isn't available anymore */
+  was_refunded?: true;
+  /** Number of Telegram Stars that can be claimed by the receiver instead of the gift; omitted if the gift cannot be converted to Telegram Stars */
+  convert_star_count?: number;
+  /** Number of Telegram Stars that were paid by the sender for the ability to upgrade the gift */
+  prepaid_upgrade_star_count?: number;
+}
+
+/** Describes a unique gift received and owned by a user or a chat. */
+export interface OwnedGiftUnique {
+  /** Type of the gift, always “unique” */
+  type: "unique";
+  /** Information about the unique gift */
+  gift: UniqueGift;
+  /** Unique identifier of the received gift for the bot; for gifts received on behalf of business accounts only */
+  owned_gift_id?: string;
+  /** Sender of the gift if it is a known user */
+  sender_user?: User;
+  /** Date the gift was sent in Unix time */
+  send_date: number;
+  /** True, if the gift is displayed on the account's profile page; for gifts received on behalf of business accounts only */
+  is_saved?: true;
+  /** True, if the gift can be transferred to another owner; for gifts received on behalf of business accounts only */
+  can_be_transferred?: true;
+  /** Number of Telegram Stars that must be paid to transfer the gift; omitted if the bot cannot transfer the gift */
+  transfer_star_count?: number;
+}
+
+/** Contains the list of gifts received and owned by a user or a chat. */
+export interface OwnedGifts {
+  /** The total number of gifts owned by the user or the chat */
+  total_count: number;
+  /** The list of gifts */
+  gifts: OwnedGift[];
+  /** Offset for the next request. If empty, then there are no more results */
+  next_offset?: string;
+}

package/src/manageTypes.d.ts

@@ -30,6 +30,18 @@ export interface WebhookInfo {
   allowed_updates?: Array<Exclude<keyof Update, "update_id">>;
 }
 
+/** This object describes the types of gifts that can be gifted to a user or a chat. */
+export interface AcceptedGiftTypes {
+  /** True, if unlimited regular gifts are accepted */
+  unlimited_gifts: boolean;
+  /** True, if limited regular gifts are accepted */
+  limited_gifts: boolean;
+  /** True, if unique gifts or gifts that can be upgraded to unique for free are accepted */
+  unique_gifts: boolean;
+  /** True, if a Telegram Premium subscription is accepted */
+  premium_subscription: boolean;
+}
+
 /** This object represents a Telegram user or bot. */
 export interface User {
   /** Unique identifier for this user or bot. */
@@ -209,6 +221,8 @@ export declare namespace ChatFullInfo {
     pinned_message?: Message;
     /** Default chat member permissions, for groups and supergroups */
     permissions?: undefined;
+    /** Information about types of gifts that are accepted by the chat or by the corresponding user for private chats */
+    accepted_gift_types: AcceptedGiftTypes;
     /** For supergroups, the minimum allowed delay between consecutive messages sent by each unprivileged user; in seconds */
     slow_mode_delay?: undefined;
     /**  For supergroups, the minimum number of boosts that a non-administrator user needs to add in order to ignore slow mode and chat permissions */
@@ -300,6 +314,8 @@ export declare namespace ChatFullInfo {
     pinned_message?: Message;
     /** Default chat member permissions, for groups and supergroups */
     permissions?: ChatPermissions;
+    /** True, if gifts can be sent to the chat */
+    can_send_gift?: true;
     /** For supergroups, the minimum allowed delay between consecutive messages sent by each unprivileged user; in seconds */
     slow_mode_delay?: undefined;
     /**  For supergroups, the minimum number of boosts that a non-administrator user needs to add in order to ignore slow mode and chat permissions */
@@ -391,6 +407,8 @@ export declare namespace ChatFullInfo {
     pinned_message?: Message;
     /** Default chat member permissions, for groups and supergroups */
     permissions?: ChatPermissions;
+    /** True, if gifts can be sent to the chat */
+    can_send_gift?: true;
     /** For supergroups, the minimum allowed delay between consecutive messages sent by each unprivileged user; in seconds */
     slow_mode_delay?: number;
     /**  For supergroups, the minimum number of boosts that a non-administrator user needs to add in order to ignore slow mode and chat permissions */
@@ -482,6 +500,8 @@ export declare namespace ChatFullInfo {
     pinned_message?: Message;
     /** Default chat member permissions, for groups and supergroups */
     permissions?: undefined;
+    /** True, if gifts can be sent to the chat */
+    can_send_gift?: true;
     /** For supergroups, the minimum allowed delay between consecutive messages sent by each unprivileged user; in seconds */
     slow_mode_delay?: undefined;
     /**  For supergroups, the minimum number of boosts that a non-administrator user needs to add in order to ignore slow mode and chat permissions */
@@ -955,6 +975,37 @@ export interface UserChatBoosts {
   boosts: ChatBoost[];
 }
 
+export interface BusinessBotRights {
+  /** True, if the bot can send and edit messages in the private chats that had incoming messages in the last 24 hours */
+  can_reply?: true;
+  /** True, if the bot can mark incoming private messages as read */
+  can_read_messages?: true;
+  /** True, if the bot can delete messages sent by the bot */
+  can_delete_outgoing_messages?: true;
+  /** True, if the bot can delete all private messages in managed chats */
+  can_delete_all_messages?: true;
+  /** True, if the bot can edit the first and last name of the business account */
+  can_edit_name?: true;
+  /** True, if the bot can edit the bio of the business account */
+  can_edit_bio?: true;
+  /** True, if the bot can edit the profile photo of the business account */
+  can_edit_profile_photo?: true;
+  /** True, if the bot can edit the username of the business account */
+  can_edit_username?: true;
+  /** True, if the bot can change the privacy settings pertaining to gifts for the business account */
+  can_change_gift_settings?: true;
+  /** True, if the bot can view gifts and the amount of Telegram Stars owned by the business account */
+  can_view_gifts_and_stars?: true;
+  /** True, if the bot can convert regular gifts owned by the business account to Telegram Stars */
+  can_convert_gifts_to_stars?: true;
+  /** True, if the bot can transfer and upgrade gifts owned by the business account */
+  can_transfer_and_upgrade_gifts?: true;
+  /** True, if the bot can transfer Telegram Stars received by the business account to its own account, or use them to upgrade and transfer gifts */
+  can_transfer_stars?: true;
+  /** True, if the bot can send, edit and delete stories on behalf of the business account */
+  can_manage_stories?: true;
+}
+
 /** Describes the connection of the bot with a business account. */
 export interface BusinessConnection {
   /** Unique identifier of the business connection */
@@ -965,8 +1016,8 @@ export interface BusinessConnection {
   user_chat_id: number;
   /** Date the connection was established in Unix time */
   date: number;
-  /** True, if the bot can act on behalf of the business account in chats that were active in the last 24 hours */
-  can_reply: boolean;
+  /** Rights of the business bot */
+  rights?: BusinessBotRights;
   /** True, if the connection is active */
   is_enabled: boolean;
 }

package/src/messageTypes.d.ts

@@ -2,9 +2,12 @@ import type { Chat, User } from "./manageTypes";
 import type { InlineKeyboardMarkup } from "./markupTypes";
 import type { PassportData } from "./passportTypes";
 import type {
+  GiftInfo,
   Invoice,
+  PaidMessagePriceChanged,
   RefundedPayment,
   SuccessfulPayment,
+  UniqueGiftInfo,
 } from "./invoiceTypes";
 
 type MsgWith<P extends keyof Message> = Record<P, NonNullable<Message[P]>>;
@@ -61,6 +64,8 @@ export declare namespace Message {
     link_preview_options?: LinkPreviewOptions;
     /** Unique identifier of the message effect added to the message */
     effect_id?: string;
+    /** The number of Telegram Stars that were paid by the sender of the message to send it */
+    paid_star_count?: number;
     /** Inline keyboard attached to the message. login_url buttons are represented as ordinary url buttons. */
     reply_markup?: InlineKeyboardMarkup;
   }
@@ -267,6 +272,12 @@ export interface Message extends Message.MediaMessage {
   giveaway_winners?: GiveawayWinners;
   /** Service message: a giveaway without public winners was completed */
   giveaway_completed?: GiveawayCompleted;
+  /** Service message: a regular gift was sent or received */
+  gift?: GiftInfo;
+  /** Service message: a unique gift was sent or received */
+  unique_gift?: UniqueGiftInfo;
+  /** Service message: the price for paid messages has changed in the chat */
+  paid_message_price_changed?: PaidMessagePriceChanged;
   /** Service message: video chat scheduled */
   video_chat_scheduled?: VideoChatScheduled;
   /** Service message: video chat started */

package/src/storyTypes.d.ts

@@ -0,0 +1,103 @@
+import type { ReactionType } from "./message.ts";
+
+/** Describes the position of a clickable area within a story. */
+export interface StoryAreaPosition {
+  /** The abscissa of the area's center, as a percentage of the media width */
+  x_percentage: number;
+  /** The ordinate of the area's center, as a percentage of the media height */
+  y_percentage: number;
+  /** The width of the area's rectangle, as a percentage of the media width */
+  width_percentage: number;
+  /** The height of the area's rectangle, as a percentage of the media height */
+  height_percentage: number;
+  /** The clockwise rotation angle of the rectangle, in degrees; 0-360 */
+  rotation_angle: number;
+  /** The radius of the rectangle corner rounding, as a percentage of the media width */
+  corner_radius_percentage: number;
+}
+
+/** Describes the physical address of a location. */
+export interface LocationAddress {
+  /** The two-letter ISO 3166-1 alpha-2 country code of the country where the location is located */
+  country_code: string;
+  /** State of the location */
+  state?: string;
+  /** City of the location */
+  city?: string;
+  /** Street address of the location */
+  street?: string;
+}
+
+/** Describes the type of a clickable area on a story. Currently, it can be one of
+
+- StoryAreaTypeLocation
+- StoryAreaTypeSuggestedReaction
+- StoryAreaTypeLink
+- StoryAreaTypeWeather
+- StoryAreaTypeUniqueGift */
+export type StoryAreaType =
+  | StoryAreaTypeLocation
+  | StoryAreaTypeSuggestedReaction
+  | StoryAreaTypeLink
+  | StoryAreaTypeWeather
+  | StoryAreaTypeUniqueGift;
+
+/** Describes a story area pointing to a location. Currently, a story can have up to 10 location areas. */
+export interface StoryAreaTypeLocation {
+  /** Type of the area, always “location” */
+  type: "location";
+  /** Location latitude in degrees */
+  latitude: number;
+  /** Location longitude in degrees */
+  longitude: number;
+  /** Address of the location */
+  address?: LocationAddress;
+}
+
+/** Describes a story area pointing to a suggested reaction. Currently, a story can have up to 5 suggested reaction areas. */
+export interface StoryAreaTypeSuggestedReaction {
+  /** Type of the area, always “suggested_reaction” */
+  type: "suggested_reaction";
+  /** Type of the reaction */
+  reaction_type: ReactionType;
+  /** Pass True if the reaction area has a dark background */
+  is_dark?: boolean;
+  /** Pass True if reaction area corner is flipped */
+  is_flipped?: boolean;
+}
+
+/** Describes a story area pointing to an HTTP or tg:// link. Currently, a story can have up to 3 link areas. */
+export interface StoryAreaTypeLink {
+  /** Type of the area, always “link” */
+  type: "link";
+  /** HTTP or tg:// URL to be opened when the area is clicked */
+  url: string;
+}
+
+/** Describes a story area containing weather information. Currently, a story can have up to 3 weather areas. */
+export interface StoryAreaTypeWeather {
+  /** Type of the area, always “weather” */
+  type: "weather";
+  /** Temperature, in degree Celsius */
+  temperature: number;
+  /** Emoji representing the weather */
+  emoji: string;
+  /** A color of the area background in the ARGB format */
+  background_color: number;
+}
+
+/** Describes a story area pointing to a unique gift. Currently, a story can have at most 1 unique gift area. */
+export interface StoryAreaTypeUniqueGift {
+  /** Type of the area, always “unique_gift” */
+  type: "unique_gift";
+  /** Unique name of the gift */
+  name: string;
+}
+
+/** Describes a clickable area on a story media. */
+export interface StoryArea {
+  /** Position of the area */
+  position: StoryAreaPosition;
+  /** Type of the area */
+  type: StoryAreaType;
+}