Update Bot API to 9.0.

Implement new types and methods for API 9.0

Author: mys721tx

README.md

@@ -4,7 +4,7 @@
 [![npm](https://img.shields.io/npm/dt/typescript-telegram-bot-api)](https://www.npmjs.com/package/typescript-telegram-bot-api)
 [![codecov](https://codecov.io/github/Borodin/typescript-telegram-bot-api/graph/badge.svg?token=509N5AZDTV)](https://codecov.io/github/Borodin/typescript-telegram-bot-api)
 [![codesandbox](https://img.shields.io/badge/Open_in-sandbox-eaff96)](https://codesandbox.io/p/sandbox/interesting-wave-qgspfs)
-[![GitHub](https://img.shields.io/badge/Bot_API-v8.3-0088cc)](https://core.telegram.org/bots/api#february-12-2025)
+[![GitHub](https://img.shields.io/badge/Bot_API-v9.0-0088cc)](https://core.telegram.org/bots/api#april-11-2025)
 
 
 This is a TypeScript wrapper for the [Telegram Bot API](https://core.telegram.org/bots/api) Node.js and browsers. It allows you to easily interact with the Telegram Bot API using TypeScript.
@@ -76,15 +76,15 @@ await bot.sendPhoto({
   caption: 'stream',
 });
 
-// or 
+// or
 
 await bot.sendPhoto({
   chat_id: chat_id,
   photo: await readFile('photo.jpg'),
   caption: 'buffer',
 });
 
-// or 
+// or
 
 await bot.sendPhoto({
   chat_id: chat_id,

src/index.ts

@@ -26,6 +26,7 @@ import {
   InputMediaPhoto,
   InputMediaVideo,
   InputPollOption,
+  InputProfilePhoto,
   UserProfilePhotos,
   ChatPermissions,
   ChatInviteLink,
@@ -65,6 +66,12 @@ import {
   WebhookInfo,
   Currencies,
   Gifts,
+  AcceptedGiftTypes,
+  StarAmount,
+  OwnedGifts,
+  InputStoryContent,
+  Story,
+  StoryArea,
 } from './types/';
 import * as TelegramTypes from './types/';
 import { ExactlyOne } from './utils';
@@ -2663,6 +2670,315 @@ export class TelegramBot extends EventEmitter {
     return await this.callApi('removeChatVerification', options);
   }
 
+  /**
+   * ## readBusinessMessage
+   * Marks incoming message as read on behalf of a business account. Requires
+   * the can_read_messages business bot right.
+   * Returns True on success.
+   * @see https://core.telegram.org/bots/api#readbusinessmessage
+   */
+  async readBusinessMessage(options: {
+    business_connection_id: string;
+    chat_id: number | string;
+    message_id: number;
+  }): Promise<true> {
+    return await this.callApi('readBusinessMessage', options);
+  }
+
+  /**
+   * ## deleteBusinessMessages
+   * Delete messages on behalf of a business account. Requires
+   * the can_delete_sent_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.
+   * @see https://core.telegram.org/bots/api#deletebusinessmessages
+   */
+  async deleteBusinessMessages(options: {
+    business_connection_id: string;
+    message_ids: number[];
+  }): Promise<true> {
+    return await this.callApi('deleteBusinessMessages', options);
+  }
+
+  /**
+   * ## setBusinessAccountName
+   * Changes the first and last name of a managed business account. Requires the
+   * can_change_name business bot right.
+   * Returns True on success.
+   * @see https://core.telegram.org/bots/api#setbusinessaccountname
+   */
+  async setBusinessAccountName(options: {
+    business_connection_id: string;
+    first_name: string;
+    last_name?: string;
+  }): Promise<true> {
+    return await this.callApi('setBusinessAccountName', options);
+  }
+
+  /**
+   * ## setBusinessAccountUsername
+   * Changes the username of a managed business account. Requires the
+   * can_change_username business bot right.
+   * Returns True on success.
+   * @see https://core.telegram.org/bots/api#setbusinessaccountusername
+   */
+  async setBusinessAccountUsername(options: {
+    business_connection_id: string;
+    username: string;
+  }): Promise<true> {
+    return await this.callApi('setBusinessAccountUsername', options);
+  }
+
+  /**
+   * ## setBusinessAccountBio
+   * Changes the bio of a managed business account. Requires the
+   * can_change_bio business bot right.
+   * Returns True on success.
+   * @see https://core.telegram.org/bots/api#setbusinessaccountbio
+   */
+  async setBusinessAccountBio(options: {
+    business_connection_id: string;
+    bio: string;
+  }): Promise<true> {
+    return await this.callApi('setBusinessAccountBio', options);
+  }
+
+  /**
+   * ## setBusinessAccountProfilePhoto
+   * Changes the profile photo of a managed business account. Requires the
+   * can_edit_profile_photo business bot right.
+   * Returns True on success.
+   * @see https://core.telegram.org/bots/api#setbusinessaccountprofilephoto
+   */
+  async setBusinessAccountProfilePhoto(options: {
+    business_connection_id: string;
+    photo: InputProfilePhoto;
+    is_public?: boolean;
+  }): Promise<true> {
+    return await this.callApi('setBusinessAccountProfilePhoto', {
+      ...options,
+      photo: new JSONSerialized(options.photo),
+    });
+  }
+
+  /**
+   * ## removeBusinessAccountProfilePhoto
+   * Removes the current profile photo of a managed business account.
+   * Requires the can_edit_profile_photo business bot right.
+   * Returns True on success.
+   * @see https://core.telegram.org/bots/api#removebusinessaccountprofilephoto
+   */
+  async removeBusinessAccountProfilePhoto(options: {
+    business_connection_id: string;
+    is_public?: boolean;
+  }): Promise<true> {
+    return await this.callApi('removeBusinessAccountProfilePhoto', options);
+  }
+
+  /**
+   * ## setBusinessAccountGiftSettings
+   * 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.
+   * @see https://core.telegram.org/bots/api#setbusinessaccountgiftsettings
+   */
+  async setBusinessAccountGiftSettings(options: {
+    business_connection_id: string;
+    show_gift_button: boolean;
+    accepted_gift_types: AcceptedGiftTypes;
+  }): Promise<true> {
+    return await this.callApi('setBusinessAccountGiftSettings', {
+      ...options,
+      accepted_gift_types: new JSONSerialized(options.accepted_gift_types),
+    });
+  }
+
+  /**
+   * ## getBusinessAccountStarBalance
+   * 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.
+   * @see https://core.telegram.org/bots/api#getbusinessaccountstarbalance
+   */
+  async getBusinessAccountStarBalance(options: {
+    business_connection_id: string;
+  }): Promise<StarAmount> {
+    return await this.callApi('getBusinessAccountStarBalance', options);
+  }
+
+  /**
+   * ## transferBusinessAccountStars
+   * 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.
+   * @see https://core.telegram.org/bots/api#transferbusinessaccountstars
+   */
+  async transferBusinessAccountStars(options: {
+    business_connection_id: string;
+    star_count: number;
+  }): Promise<true> {
+    return await this.callApi('transferBusinessAccountStars', options);
+  }
+
+  /**
+   * ## getBusinessAccountGifts
+   * 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.
+   * @see https://core.telegram.org/bots/api#getbusinessaccountgifts
+   */
+  async getBusinessAccountGifts(options: {
+    business_connection_id: string;
+    exclude_unsaved?: boolean;
+    exclude_saved?: boolean;
+    exclude_unlimited?: boolean;
+    exclude_limited?: boolean;
+    exclude_unique?: boolean;
+    sort_by_price?: boolean;
+    offset?: string;
+    limit?: number;
+  }): Promise<OwnedGifts> {
+    return await this.callApi('getBusinessAccountGifts', {
+      ...options,
+    });
+  }
+
+  /**
+   * ## convertGiftToStars
+   * Converts a given regular gift to Telegram Stars. Requires the
+   * can_convert_gifts_to_stars business bot right.
+   * Returns True on success.
+   * @see https://core.telegram.org/bots/api#convertgifttostars
+   */
+  async convertGiftToStars(options: {
+    business_connection_id: string;
+    owned_gift_id: string;
+  }): Promise<true> {
+    return await this.callApi('convertGiftToStars', options);
+  }
+
+  /**
+   * ## upgradeGift
+   * 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.
+   * @see https://core.telegram.org/bots/api#upgradegift
+   */
+  async upgradeGift(options: {
+    business_connection_id: string;
+    owned_gift_id: string;
+    keep_original_details?: boolean;
+    star_count?: number;
+  }): Promise<true> {
+    return await this.callApi('upgradeGift', {
+      ...options,
+    });
+  }
+
+  /**
+   * ## transferGift
+   * 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.
+   * @see https://core.telegram.org/bots/api#transfertgift
+   */
+  async transferGift(options: {
+    business_connection_id: string;
+    owned_gift_id: string;
+    new_owner_chat_id: number;
+    star_count?: number;
+  }): Promise<true> {
+    return await this.callApi('transferGift', {
+      ...options,
+    });
+  }
+
+  /**
+   * ## postStory
+   * Posts a story on behalf of a managed business account. Requires the
+   * can_manage_stories business bot right.
+   * Returns Story on success.
+   * @see https://core.telegram.org/bots/api#poststory
+   */
+  async postStory(options: {
+    business_connection_id: string;
+    content: InputStoryContent;
+    active_period: number;
+    caption?: string;
+    parse_mode?: string;
+    caption_entities?: MessageEntity[];
+    areas?: StoryArea[];
+    post_to_chat_page?: boolean;
+    protect_content?: boolean;
+  }): Promise<Story> {
+    return await this.callApi('postStory', {
+      ...options,
+      caption_entities: new JSONSerialized(options.caption_entities),
+      content: new JSONSerialized(options.content),
+      areas: new JSONSerialized(options.areas),
+    });
+  }
+
+  /**
+   * ## editStory
+   * 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.
+   * @see https://core.telegram.org/bots/api#editstory
+   */
+  async editStory(options: {
+    business_connection_id: string;
+    story_id: string;
+    content?: InputStoryContent;
+    caption?: string;
+    parse_mode?: string;
+    caption_entities?: MessageEntity[];
+    areas?: StoryArea[];
+  }): Promise<Story> {
+    return await this.callApi('editStory', {
+      ...options,
+      caption_entities: new JSONSerialized(options.caption_entities),
+      content: options.content ? new JSONSerialized(options.content) : undefined,
+      areas: options.areas ? new JSONSerialized(options.areas) : undefined,
+    });
+  }
+
+  /**
+   * ## deleteStory
+   * 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.
+   * @see https://core.telegram.org/bots/api#deletestory
+   */
+  async deleteStory(options: {
+    business_connection_id: string;
+    story_id: string;
+  }): Promise<true> {
+    return await this.callApi('deleteStory', options);
+  }
+
+  /**
+   * ## giftPremiumSubscription
+   * Gifts a Telegram Premium subscription to the given user.
+   * Returns True on success.
+   * @see https://core.telegram.org/bots/api#giftpremiumsubscription
+   */
+  async giftPremiumSubscription(options: {
+    user_id: number;
+    month_count: number;
+    star_count: number;
+    text?: string;
+    text_parse_mode?: string;
+    text_entities?: MessageEntity[];
+  }): Promise<true> {
+    return await this.callApi('giftPremiumSubscription', {
+      ...options,
+      text_entities: new JSONSerialized(options.text_entities),
+    });
+  }
+
   on<U extends keyof allEmittedTypes>(event: U, listener: (eventData: NonNullable<allEmittedTypes[U]>) => void): this {
     return super.on(event, listener) as this;
   }

src/types/AcceptedGiftTypes.ts

@@ -0,0 +1,26 @@
+/**
+ * ## AcceptedGiftTypes
+ * This object describes the types of gifts that can be gifted to a user or a chat.
+ * @see https://core.telegram.org/bots/api#acceptedgifttypes
+ */
+export type 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;
+};