feat: update to bot api 9.0

Author: Eptagone

README.md

@@ -2,18 +2,18 @@
 | -------------------------------------------------- | -------------------------------- |
 
 [![NuGet version (Telegram.BotAPI)](https://img.shields.io/nuget/v/Telegram.BotAPI?style=flat-square&logo=nuget)](https://www.nuget.org/packages/Telegram.BotAPI/)
-[![Compatible with Bot API v8.3](https://img.shields.io/badge/Bot%20API%20version-v8.3-blue?style=flat-square)](https://core.telegram.org/bots/api#february-12-2025)
+[![Compatible with Bot API v9.0](https://img.shields.io/badge/Bot%20API%20version-v9.0-blue?style=flat-square)](https://core.telegram.org/bots/api#april-11-2025)
 
-**Telegram.BotAPI** is one of the most complete libraries available to interact with the Telegram Bot API in your .NET projects. It contains all the methods and types available in the Bot API 8.3 released on January 1, 2025.
+**Telegram.BotAPI** is one of the most complete libraries available to interact with the Telegram Bot API in your .NET projects. It contains all the methods and types available in the Bot API 9.0 released on April 11, 2025.
 
 [![Telegram Chat](https://img.shields.io/badge/Telegram.BotAPI%20--%20Chat-Join-blue?style=social&logo=telegram)](https://t.me/TBAPINET)
 
 ---
 
 ## Features
 
-- Contains pre-defined methods for all Bot API 8.3 methods.
-- Contains classes for each object type used in the Bot API 8.3.
+- Contains pre-defined methods for all Bot API 9.0 methods.
+- Contains classes for each object type used in the Bot API 9.0.
 - Sync and async methods.
 - Uses [System.Text.Json](https://www.nuget.org/packages/System.Text.Json/).
 

src/examples/readme.md

@@ -1,7 +1,7 @@
 # Telegram.BotAPI NET Examples
 
 [![NuGet version (Telegram.BotAPI)](https://img.shields.io/nuget/v/Telegram.BotAPI?style=flat-square&logo=nuget)](https://www.nuget.org/packages/Telegram.BotAPI/)
-[![Compatible with Bot API v8.3](https://img.shields.io/badge/Bot%20API%20version-v8.3-blue?style=flat-square)](https://core.telegram.org/bots/api#february-12-2025)
+[![Compatible with Bot API v9.0](https://img.shields.io/badge/Bot%20API%20version-v9.0-blue?style=flat-square)](https://core.telegram.org/bots/api#april-11-2025)
 
 ## Sample list
 

src/library/Telegram.BotAPI/AvailableMethods/Args/SendPaidMediaArgs.cs

@@ -15,7 +15,7 @@ public class SendPaidMediaArgs : AttachedFilesArgsBase
     /// Initializes a new instance of the <see cref="SendPaidMediaArgs"/> class.
     /// </summary>
     /// <param name="chatId">Unique identifier for the target chat or username of the target channel (in the format <em>@channelusername</em>). If the chat is a channel, all Telegram Star proceeds from this media will be credited to the chat's balance. Otherwise, they will be credited to the bot's balance.</param>
-    /// <param name="starCount">The number of Telegram Stars that must be paid to buy access to the media; 1-2500</param>
+    /// <param name="starCount">The number of Telegram Stars that must be paid to buy access to the media; 1-10000</param>
     /// <param name="media">A JSON-serialized array describing the media to be sent; up to 10 items</param>
     public SendPaidMediaArgs(long chatId, int starCount, IEnumerable<InputPaidMedia> media)
     {
@@ -28,7 +28,7 @@ public SendPaidMediaArgs(long chatId, int starCount, IEnumerable<InputPaidMedia>
     /// Initializes a new instance of the <see cref="SendPaidMediaArgs"/> class.
     /// </summary>
     /// <param name="chatId">Unique identifier for the target chat or username of the target channel (in the format <em>@channelusername</em>). If the chat is a channel, all Telegram Star proceeds from this media will be credited to the chat's balance. Otherwise, they will be credited to the bot's balance.</param>
-    /// <param name="starCount">The number of Telegram Stars that must be paid to buy access to the media; 1-2500</param>
+    /// <param name="starCount">The number of Telegram Stars that must be paid to buy access to the media; 1-10000</param>
     /// <param name="media">A JSON-serialized array describing the media to be sent; up to 10 items</param>
     public SendPaidMediaArgs(string chatId, int starCount, IEnumerable<InputPaidMedia> media)
     {
@@ -50,7 +50,7 @@ public SendPaidMediaArgs(string chatId, int starCount, IEnumerable<InputPaidMedi
     public object ChatId { get; set; }
 
     /// <summary>
-    /// The number of Telegram Stars that must be paid to buy access to the media; 1-2500
+    /// The number of Telegram Stars that must be paid to buy access to the media; 1-10000
     /// </summary>
     [JsonPropertyName(PropertyNames.StarCount)]
     public int StarCount { get; set; }

src/library/Telegram.BotAPI/AvailableMethods/createChatSubscriptionInviteLink.cs

@@ -17,7 +17,7 @@ public static partial class AvailableMethodsExtensions
     /// <param name="client">The <see cref="ITelegramBotClient"/> instance.</param>
     /// <param name="chatId">Unique identifier for the target channel chat or username of the target channel (in the format <em>@channelusername</em>)</param>
     /// <param name="subscriptionPeriod">The number of seconds the subscription will be active for before the next payment. Currently, it must always be 2592000 (30 days).</param>
-    /// <param name="subscriptionPrice">The amount of Telegram Stars a user must pay initially and after each subsequent subscription period to be a member of the chat; 1-2500</param>
+    /// <param name="subscriptionPrice">The amount of Telegram Stars a user must pay initially and after each subsequent subscription period to be a member of the chat; 1-10000</param>
     /// <param name="name">Invite link name; 0-32 characters</param>
     /// <exception cref="ArgumentNullException">Thrown if <paramref name="client"/> is <c>null</c>.</exception>
     /// <exception cref="BotRequestException">Thrown if the request to the Telegram Bot API fails.</exception>
@@ -31,7 +31,7 @@ public static ChatInviteLink CreateChatSubscriptionInviteLink(this ITelegramBotC
     /// <param name="client">The <see cref="ITelegramBotClient"/> instance.</param>
     /// <param name="chatId">Unique identifier for the target channel chat or username of the target channel (in the format <em>@channelusername</em>)</param>
     /// <param name="subscriptionPeriod">The number of seconds the subscription will be active for before the next payment. Currently, it must always be 2592000 (30 days).</param>
-    /// <param name="subscriptionPrice">The amount of Telegram Stars a user must pay initially and after each subsequent subscription period to be a member of the chat; 1-2500</param>
+    /// <param name="subscriptionPrice">The amount of Telegram Stars a user must pay initially and after each subsequent subscription period to be a member of the chat; 1-10000</param>
     /// <param name="name">Invite link name; 0-32 characters</param>
     /// <param name="cancellationToken">The cancellation token to cancel operation.</param>
     /// <exception cref="ArgumentNullException">Thrown if <paramref name="client"/> is <c>null</c>.</exception>
@@ -64,7 +64,7 @@ public static Task<ChatInviteLink> CreateChatSubscriptionInviteLinkAsync(this IT
     /// <param name="client">The <see cref="ITelegramBotClient"/> instance.</param>
     /// <param name="chatId">Unique identifier for the target channel chat or username of the target channel (in the format <em>@channelusername</em>)</param>
     /// <param name="subscriptionPeriod">The number of seconds the subscription will be active for before the next payment. Currently, it must always be 2592000 (30 days).</param>
-    /// <param name="subscriptionPrice">The amount of Telegram Stars a user must pay initially and after each subsequent subscription period to be a member of the chat; 1-2500</param>
+    /// <param name="subscriptionPrice">The amount of Telegram Stars a user must pay initially and after each subsequent subscription period to be a member of the chat; 1-10000</param>
     /// <param name="name">Invite link name; 0-32 characters</param>
     /// <exception cref="ArgumentNullException">Thrown if <paramref name="client"/> is <c>null</c>.</exception>
     /// <exception cref="BotRequestException">Thrown if the request to the Telegram Bot API fails.</exception>
@@ -78,7 +78,7 @@ public static ChatInviteLink CreateChatSubscriptionInviteLink(this ITelegramBotC
     /// <param name="client">The <see cref="ITelegramBotClient"/> instance.</param>
     /// <param name="chatId">Unique identifier for the target channel chat or username of the target channel (in the format <em>@channelusername</em>)</param>
     /// <param name="subscriptionPeriod">The number of seconds the subscription will be active for before the next payment. Currently, it must always be 2592000 (30 days).</param>
-    /// <param name="subscriptionPrice">The amount of Telegram Stars a user must pay initially and after each subsequent subscription period to be a member of the chat; 1-2500</param>
+    /// <param name="subscriptionPrice">The amount of Telegram Stars a user must pay initially and after each subsequent subscription period to be a member of the chat; 1-10000</param>
     /// <param name="name">Invite link name; 0-32 characters</param>
     /// <param name="cancellationToken">The cancellation token to cancel operation.</param>
     /// <exception cref="ArgumentNullException">Thrown if <paramref name="client"/> is <c>null</c>.</exception>

src/library/Telegram.BotAPI/AvailableMethods/sendPaidMedia.cs

@@ -46,7 +46,7 @@ public static Task<Message> SendPaidMediaAsync(this ITelegramBotClient client, S
     /// </summary>
     /// <param name="client">The <see cref="ITelegramBotClient"/> instance.</param>
     /// <param name="chatId">Unique identifier for the target chat or username of the target channel (in the format <em>@channelusername</em>). If the chat is a channel, all Telegram Star proceeds from this media will be credited to the chat's balance. Otherwise, they will be credited to the bot's balance.</param>
-    /// <param name="starCount">The number of Telegram Stars that must be paid to buy access to the media; 1-2500</param>
+    /// <param name="starCount">The number of Telegram Stars that must be paid to buy access to the media; 1-10000</param>
     /// <param name="media">A JSON-serialized array describing the media to be sent; up to 10 items</param>
     /// <param name="businessConnectionId">Unique identifier of the business connection on behalf of which the message will be sent</param>
     /// <param name="payload">Bot-defined paid media payload, 0-128 bytes. This will not be displayed to the user, use it for your internal processes.</param>
@@ -70,7 +70,7 @@ public static Message SendPaidMedia(this ITelegramBotClient client, long chatId,
     /// </summary>
     /// <param name="client">The <see cref="ITelegramBotClient"/> instance.</param>
     /// <param name="chatId">Unique identifier for the target chat or username of the target channel (in the format <em>@channelusername</em>). If the chat is a channel, all Telegram Star proceeds from this media will be credited to the chat's balance. Otherwise, they will be credited to the bot's balance.</param>
-    /// <param name="starCount">The number of Telegram Stars that must be paid to buy access to the media; 1-2500</param>
+    /// <param name="starCount">The number of Telegram Stars that must be paid to buy access to the media; 1-10000</param>
     /// <param name="media">A JSON-serialized array describing the media to be sent; up to 10 items</param>
     /// <param name="businessConnectionId">Unique identifier of the business connection on behalf of which the message will be sent</param>
     /// <param name="payload">Bot-defined paid media payload, 0-128 bytes. This will not be displayed to the user, use it for your internal processes.</param>
@@ -153,7 +153,7 @@ public static Task<Message> SendPaidMediaAsync(this ITelegramBotClient client, l
     /// </summary>
     /// <param name="client">The <see cref="ITelegramBotClient"/> instance.</param>
     /// <param name="chatId">Unique identifier for the target chat or username of the target channel (in the format <em>@channelusername</em>). If the chat is a channel, all Telegram Star proceeds from this media will be credited to the chat's balance. Otherwise, they will be credited to the bot's balance.</param>
-    /// <param name="starCount">The number of Telegram Stars that must be paid to buy access to the media; 1-2500</param>
+    /// <param name="starCount">The number of Telegram Stars that must be paid to buy access to the media; 1-10000</param>
     /// <param name="media">A JSON-serialized array describing the media to be sent; up to 10 items</param>
     /// <param name="businessConnectionId">Unique identifier of the business connection on behalf of which the message will be sent</param>
     /// <param name="payload">Bot-defined paid media payload, 0-128 bytes. This will not be displayed to the user, use it for your internal processes.</param>
@@ -177,7 +177,7 @@ public static Message SendPaidMedia(this ITelegramBotClient client, string chatI
     /// </summary>
     /// <param name="client">The <see cref="ITelegramBotClient"/> instance.</param>
     /// <param name="chatId">Unique identifier for the target chat or username of the target channel (in the format <em>@channelusername</em>). If the chat is a channel, all Telegram Star proceeds from this media will be credited to the chat's balance. Otherwise, they will be credited to the bot's balance.</param>
-    /// <param name="starCount">The number of Telegram Stars that must be paid to buy access to the media; 1-2500</param>
+    /// <param name="starCount">The number of Telegram Stars that must be paid to buy access to the media; 1-10000</param>
     /// <param name="media">A JSON-serialized array describing the media to be sent; up to 10 items</param>
     /// <param name="businessConnectionId">Unique identifier of the business connection on behalf of which the message will be sent</param>
     /// <param name="payload">Bot-defined paid media payload, 0-128 bytes. This will not be displayed to the user, use it for your internal processes.</param>

src/library/Telegram.BotAPI/AvailableTypes/AcceptedGiftTypes.cs

@@ -0,0 +1,35 @@
+// Copyright (c) 2025 Quetzal Rivera.
+// Licensed under the MIT License, See LICENCE in the project root for license information.
+//* This file is auto-generated. Don't edit it manually!
+
+namespace Telegram.BotAPI.AvailableTypes;
+
+/// <summary>
+/// This object describes the types of gifts that can be gifted to a user or a chat.
+/// </summary>
+public class AcceptedGiftTypes
+{
+    /// <summary>
+    /// True, if unlimited regular gifts are accepted
+    /// </summary>
+    [JsonPropertyName(PropertyNames.UnlimitedGifts)]
+    public bool UnlimitedGifts { get; set; }
+
+    /// <summary>
+    /// True, if limited regular gifts are accepted
+    /// </summary>
+    [JsonPropertyName(PropertyNames.LimitedGifts)]
+    public bool LimitedGifts { get; set; }
+
+    /// <summary>
+    /// True, if unique gifts or gifts that can be upgraded to unique for free are accepted
+    /// </summary>
+    [JsonPropertyName(PropertyNames.UniqueGifts)]
+    public bool UniqueGifts { get; set; }
+
+    /// <summary>
+    /// True, if a Telegram Premium subscription is accepted
+    /// </summary>
+    [JsonPropertyName(PropertyNames.PremiumSubscription)]
+    public bool PremiumSubscription { get; set; }
+}

src/library/Telegram.BotAPI/AvailableTypes/BusinessBotRights.cs

@@ -0,0 +1,95 @@
+// Copyright (c) 2025 Quetzal Rivera.
+// Licensed under the MIT License, See LICENCE in the project root for license information.
+//* This file is auto-generated. Don't edit it manually!
+
+namespace Telegram.BotAPI.AvailableTypes;
+
+/// <summary>
+/// Represents the rights of a business bot.
+/// </summary>
+public class BusinessBotRights
+{
+    /// <summary>
+    /// Optional. True, if the bot can send and edit messages in the private chats that had incoming messages in the last 24 hours
+    /// </summary>
+    [JsonPropertyName(PropertyNames.CanReply)]
+    public bool? CanReply { get; set; }
+
+    /// <summary>
+    /// Optional. True, if the bot can mark incoming private messages as read
+    /// </summary>
+    [JsonPropertyName(PropertyNames.CanReadMessages)]
+    public bool? CanReadMessages { get; set; }
+
+    /// <summary>
+    /// Optional. True, if the bot can delete messages sent by the bot
+    /// </summary>
+    [JsonPropertyName(PropertyNames.CanDeleteOutgoingMessages)]
+    public bool? CanDeleteOutgoingMessages { get; set; }
+
+    /// <summary>
+    /// Optional. True, if the bot can delete all private messages in managed chats
+    /// </summary>
+    [JsonPropertyName(PropertyNames.CanDeleteAllMessages)]
+    public bool? CanDeleteAllMessages { get; set; }
+
+    /// <summary>
+    /// Optional. True, if the bot can edit the first and last name of the business account
+    /// </summary>
+    [JsonPropertyName(PropertyNames.CanEditName)]
+    public bool? CanEditName { get; set; }
+
+    /// <summary>
+    /// Optional. True, if the bot can edit the bio of the business account
+    /// </summary>
+    [JsonPropertyName(PropertyNames.CanEditBio)]
+    public bool? CanEditBio { get; set; }
+
+    /// <summary>
+    /// Optional. True, if the bot can edit the profile photo of the business account
+    /// </summary>
+    [JsonPropertyName(PropertyNames.CanEditProfilePhoto)]
+    public bool? CanEditProfilePhoto { get; set; }
+
+    /// <summary>
+    /// Optional. True, if the bot can edit the username of the business account
+    /// </summary>
+    [JsonPropertyName(PropertyNames.CanEditUsername)]
+    public bool? CanEditUsername { get; set; }
+
+    /// <summary>
+    /// Optional. True, if the bot can change the privacy settings pertaining to gifts for the business account
+    /// </summary>
+    [JsonPropertyName(PropertyNames.CanChangeGiftSettings)]
+    public bool? CanChangeGiftSettings { get; set; }
+
+    /// <summary>
+    /// Optional. True, if the bot can view gifts and the amount of Telegram Stars owned by the business account
+    /// </summary>
+    [JsonPropertyName(PropertyNames.CanViewGiftsAndStars)]
+    public bool? CanViewGiftsAndStars { get; set; }
+
+    /// <summary>
+    /// Optional. True, if the bot can convert regular gifts owned by the business account to Telegram Stars
+    /// </summary>
+    [JsonPropertyName(PropertyNames.CanConvertGiftsToStars)]
+    public bool? CanConvertGiftsToStars { get; set; }
+
+    /// <summary>
+    /// Optional. True, if the bot can transfer and upgrade gifts owned by the business account
+    /// </summary>
+    [JsonPropertyName(PropertyNames.CanTransferAndUpgradeGifts)]
+    public bool? CanTransferAndUpgradeGifts { get; set; }
+
+    /// <summary>
+    /// Optional. 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
+    /// </summary>
+    [JsonPropertyName(PropertyNames.CanTransferStars)]
+    public bool? CanTransferStars { get; set; }
+
+    /// <summary>
+    /// Optional. True, if the bot can post, edit and delete stories on behalf of the business account
+    /// </summary>
+    [JsonPropertyName(PropertyNames.CanManageStories)]
+    public bool? CanManageStories { get; set; }
+}

src/library/Telegram.BotAPI/AvailableTypes/BusinessConnection.cs

@@ -34,10 +34,10 @@ public class BusinessConnection
     public int Date { get; set; }
 
     /// <summary>
-    /// True, if the bot can act on behalf of the business account in chats that were active in the last 24 hours
+    /// Optional. Rights of the business bot
     /// </summary>
-    [JsonPropertyName(PropertyNames.CanReply)]
-    public bool CanReply { get; set; }
+    [JsonPropertyName(PropertyNames.Rights)]
+    public BusinessBotRights? Rights { get; set; }
 
     /// <summary>
     /// True, if the connection is active

src/library/Telegram.BotAPI/AvailableTypes/Chat/ChatFullInfo.cs

@@ -154,10 +154,10 @@ public class ChatFullInfo : Chat
     public ChatPermissions? Permissions { get; set; }
 
     /// <summary>
-    /// Optional. <em>True</em>, if gifts can be sent to the chat
+    /// Information about types of gifts that are accepted by the chat or by the corresponding user for private chats
     /// </summary>
-    [JsonPropertyName(PropertyNames.CanSendGift)]
-    public bool? CanSendGift { get; set; }
+    [JsonPropertyName(PropertyNames.AcceptedGiftTypes)]
+    public AcceptedGiftTypes AcceptedGiftTypes { get; set; } = null!;
 
     /// <summary>
     /// Optional. <em>True</em>, if paid media messages can be sent or forwarded to the channel chat. The field is available only for channel chats.