Merge pull request #48 from RxTelegram/v7.5

Add support for v7.5

Author: niklasweimann

README.md

@@ -5,7 +5,7 @@
 [![Quality Gate Status](https://sonarcloud.io/api/project_badges/measure?project=RxTelegram_RxTelegram.Bot&metric=alert_status)](https://sonarcloud.io/summary/new_code?id=RxTelegram_RxTelegram.Bot)
 [![Coverage](https://sonarcloud.io/api/project_badges/measure?project=RxTelegram_RxTelegram.Bot&metric=coverage)](https://sonarcloud.io/summary/new_code?id=RxTelegram_RxTelegram.Bot)
 
-RxTelegram.Bot supports Telegram Bot API 7.4 (as at May 28, 2024).
+RxTelegram.Bot supports Telegram Bot API 7.5 (as at June 18, 2024).
 
 This is a reactive designed .NET Library for the Telegram Bot API. It works with the official [Reactive Extentions](https://github.com/dotnet/reactive).
 

src/RxTelegram.Bot/Interface/BaseTypes/Enums/RevenueWithdrawalStateType.cs

@@ -0,0 +1,16 @@
+using RxTelegram.Bot.Interface.Payments;
+using RxTelegram.Bot.Utils.MultiType;
+
+namespace RxTelegram.Bot.Interface.BaseTypes.Enums;
+
+public enum RevenueWithdrawalStateType
+{
+    [ImplementationType(typeof(RevenueWithdrawalStatePending))]
+    Pending,
+
+    [ImplementationType(typeof(RevenueWithdrawalStateSucceeded))]
+    Succeeded,
+
+    [ImplementationType(typeof(RevenueWithdrawalStateFailed))]
+    Failed
+}

src/RxTelegram.Bot/Interface/BaseTypes/Enums/TransactionPartnerType.cs

@@ -0,0 +1,21 @@
+using RxTelegram.Bot.Interface.Payments;
+using RxTelegram.Bot.Utils.MultiType;
+
+namespace RxTelegram.Bot.Interface.BaseTypes.Enums;
+
+public enum TransactionPartnerType
+{
+    [ImplementationType(typeof(TransactionPartnerUser))]
+    User,
+
+    [ImplementationType(typeof(TransactionPartnerFragment))]
+    Fragment,
+
+
+    [ImplementationType(typeof(TransactionPartnerTelegramAds))]
+    TelegramAds,
+
+
+    [ImplementationType(typeof(TransactionPartnerOther))]
+    Other
+}

src/RxTelegram.Bot/Interface/BaseTypes/InlineKeyboardButton.cs

@@ -68,4 +68,4 @@ public class InlineKeyboardButton
     /// NOTE: This type of button must always be the first button in the first row.
     /// </summary>
     public bool Pay { get; set; }
-}
+}

src/RxTelegram.Bot/Interface/BaseTypes/Requests/Attachments/EditMessageLiveLocation.cs

@@ -10,6 +10,11 @@ namespace RxTelegram.Bot.Interface.BaseTypes.Requests.Attachments;
 /// </summary>
 public class EditMessageLiveLocation : BaseRequest
 {
+    /// <summary>
+    /// Unique identifier of the business connection on behalf of which the message to be edited was sent
+    /// </summary>
+    public string BusinessConnectionId { get; set; }
+
     /// <summary>
     /// Required if inline_message_id is not specified. Identifier of the message to edit
     /// </summary>

src/RxTelegram.Bot/Interface/BaseTypes/Requests/Attachments/StopMessageLiveLocation.cs

@@ -9,6 +9,11 @@ namespace RxTelegram.Bot.Interface.BaseTypes.Requests.Attachments;
 /// </summary>
 public class StopMessageLiveLocation : BaseRequest
 {
+    /// <summary>
+    /// Unique identifier of the business connection on behalf of which the message to be edited was sent
+    /// </summary>
+    public string BusinessConnectionId { get; set; }
+
     /// <summary>
     /// Required if inline_message_id is not specified. Identifier of the message with live location to stop
     /// </summary>
@@ -25,4 +30,4 @@ public class StopMessageLiveLocation : BaseRequest
     public InlineKeyboardMarkup ReplyMarkup { get; set; }
 
     protected override IValidationResult Validate() => this.CreateValidation();
-}
+}

src/RxTelegram.Bot/Interface/BaseTypes/Requests/Messages/EditMessageCaption.cs

@@ -10,6 +10,11 @@ namespace RxTelegram.Bot.Interface.BaseTypes.Requests.Messages;
 /// </summary>
 public class EditMessageCaption : BaseTextRequest
 {
+    /// <summary>
+    /// Unique identifier of the business connection on behalf of which the message to be edited was sent
+    /// </summary>
+    public string BusinessConnectionId { get; set; }
+
     /// <summary>
     /// Required if inline_message_id is not specified. Identifier of the message to edit
     /// </summary>

src/RxTelegram.Bot/Interface/BaseTypes/Requests/Messages/EditMessageMedia.cs

@@ -12,6 +12,11 @@ namespace RxTelegram.Bot.Interface.BaseTypes.Requests.Messages;
 /// </summary>
 public class EditMessageMedia : BaseRequest
 {
+    /// <summary>
+    /// Unique identifier of the business connection on behalf of which the message to be edited was sent
+    /// </summary>
+    public string BusinessConnectionId { get; set; }
+
     /// <summary>
     /// Required if inline_message_id is not specified. Identifier of the message to edit
     /// </summary>
@@ -33,4 +38,4 @@ public class EditMessageMedia : BaseRequest
     public InlineKeyboardMarkup ReplyMarkup { get; set; }
 
     protected override IValidationResult Validate() => this.CreateValidation();
-}
+}

src/RxTelegram.Bot/Interface/BaseTypes/Requests/Messages/EditMessageReplyMarkup.cs

@@ -9,6 +9,11 @@ namespace RxTelegram.Bot.Interface.BaseTypes.Requests.Messages;
 /// </summary>
 public class EditMessageReplyMarkup : BaseRequest
 {
+    /// <summary>
+    /// Unique identifier of the business connection on behalf of which the message to be edited was sent
+    /// </summary>
+    public string BusinessConnectionId { get; set; }
+
     /// <summary>
     /// Required if inline_message_id is not specified. Identifier of the message to edit
     /// </summary>
@@ -25,4 +30,4 @@ public class EditMessageReplyMarkup : BaseRequest
     public InlineKeyboardMarkup ReplyMarkup { get; set; }
 
     protected override IValidationResult Validate() => this.CreateValidation();
-}
+}

src/RxTelegram.Bot/Interface/BaseTypes/Requests/Messages/EditMessageText.cs

@@ -10,6 +10,11 @@ namespace RxTelegram.Bot.Interface.BaseTypes.Requests.Messages;
 /// </summary>
 public class EditMessageText : BaseTextRequest
 {
+    /// <summary>
+    /// Unique identifier of the business connection on behalf of which the message to be edited was sent
+    /// </summary>
+    public string BusinessConnectionId { get; set; }
+
     /// <summary>
     /// Optional
     /// Required if inline_message_id is not specified. Identifier of the message to edit

src/RxTelegram.Bot/Interface/BaseTypes/Requests/Messages/StopPoll.cs

@@ -8,6 +8,11 @@ namespace RxTelegram.Bot.Interface.BaseTypes.Requests.Messages;
 /// </summary>
 public class StopPoll : BaseRequest
 {
+    /// <summary>
+    /// Unique identifier of the business connection on behalf of which the message to be edited was sent
+    /// </summary>
+    public string BusinessConnectionId { get; set; }
+
     /// <summary>
     /// Required
     /// Identifier of the original message with the poll

src/RxTelegram.Bot/Interface/Payments/Requests/GetStarTransactions.cs

@@ -0,0 +1,18 @@
+namespace RxTelegram.Bot.Interface.Payments.Requests;
+
+/// <summary>
+/// Returns the bot's Telegram Star transactions in chronological order.
+/// On success, returns a <see cref="StarTransactions"/> StarTransactions object.
+/// </summary>
+public class GetStarTransactions
+{
+    /// <summary>
+    /// Number of transactions to skip in the response
+    /// </summary>
+    public int? Offset { get; set; }
+
+    /// <summary>
+    /// The maximum number of transactions to be retrieved. Values between 1-100 are accepted. Defaults to 100.
+    /// </summary>
+    public int? Limit { get; set; }
+}

src/RxTelegram.Bot/Interface/Payments/RevenueWithdrawalState.cs

@@ -0,0 +1,10 @@
+using RxTelegram.Bot.Interface.BaseTypes.Enums;
+using RxTelegram.Bot.Utils.MultiType;
+
+namespace RxTelegram.Bot.Interface.Payments;
+
+
+public abstract class RevenueWithdrawalState : IMultiTypeClassByType<RevenueWithdrawalStateType>
+{
+    public abstract RevenueWithdrawalStateType Type { get; set; }
+}

src/RxTelegram.Bot/Interface/Payments/RevenueWithdrawalStateFailed.cs

@@ -0,0 +1,14 @@
+using RxTelegram.Bot.Interface.BaseTypes.Enums;
+
+namespace RxTelegram.Bot.Interface.Payments;
+
+/// <summary>
+/// The withdrawal failed and the transaction was refunded.
+/// </summary>
+public class RevenueWithdrawalStateFailed: RevenueWithdrawalState
+{
+    /// <summary>
+    /// Type of the state, always “failed”
+    /// </summary>
+    public override RevenueWithdrawalStateType Type { get; set; } = RevenueWithdrawalStateType.Failed;
+}

src/RxTelegram.Bot/Interface/Payments/RevenueWithdrawalStatePending.cs

@@ -0,0 +1,14 @@
+using RxTelegram.Bot.Interface.BaseTypes.Enums;
+
+namespace RxTelegram.Bot.Interface.Payments;
+
+/// <summary>
+/// The withdrawal is in progress.
+/// </summary>
+public class RevenueWithdrawalStatePending : RevenueWithdrawalState
+{
+    /// <summary>
+    /// Type of the state, always “pending”
+    /// </summary>
+    public override RevenueWithdrawalStateType Type { get; set; } = RevenueWithdrawalStateType.Pending;
+}

src/RxTelegram.Bot/Interface/Payments/RevenueWithdrawalStateSucceeded.cs

@@ -0,0 +1,26 @@
+using System;
+using RxTelegram.Bot.Interface.BaseTypes.Enums;
+
+namespace RxTelegram.Bot.Interface.Payments;
+
+/// <summary>
+/// The withdrawal succeeded.
+/// </summary>
+public class RevenueWithdrawalStateSucceeded: RevenueWithdrawalState
+{
+    /// <summary>
+    /// Type of the state, always “succeeded”
+    /// </summary>
+    public override RevenueWithdrawalStateType Type { get; set; } = RevenueWithdrawalStateType.Succeeded;
+
+    /// <summary>
+    /// Date the withdrawal was completed in Unix time
+    /// </summary>
+    public DateTime Date { get; set; }
+
+    /// <summary>
+    /// An HTTPS URL that can be used to see transaction details
+    /// </summary>
+    public string Url { get; set; }
+
+}

src/RxTelegram.Bot/Interface/Payments/StarTransaction.cs

@@ -0,0 +1,35 @@
+namespace RxTelegram.Bot.Interface.Payments;
+
+/// <summary>
+/// Describes a Telegram Star transaction.
+/// </summary>
+public class StarTransaction
+{
+    /// <summary>
+    /// Unique identifier of the transaction. Coincides with the identifer of the original transaction for refund transactions.
+    /// Coincides with SuccessfulPayment.telegram_payment_charge_id for successful incoming payments from users.
+    /// </summary>
+    public string Id { get; set; }
+
+    /// <summary>
+    /// Number of Telegram Stars transferred by the transaction
+    /// </summary>
+    public int Amount { get; set; }
+
+    /// <summary>
+    /// Date the transaction was created in Unix time
+    /// </summary>
+    public int Date { get; set; }
+
+    /// <summary>
+    /// Optional. Source of an incoming transaction (e.g., a user purchasing goods or services, Fragment refunding a failed withdrawal).
+    /// Only for incoming transactions
+    /// </summary>
+    public TransactionPartner Source { get; set; }
+
+    /// <summary>
+    /// Optional. Receiver of an outgoing transaction (e.g., a user for a purchase refund, Fragment for a withdrawal).
+    /// Only for outgoing transactions
+    /// </summary>
+    public TransactionPartner Receiver { get; set; }
+}

src/RxTelegram.Bot/Interface/Payments/StarTransactions.cs

@@ -0,0 +1,14 @@
+using System.Collections.Generic;
+
+namespace RxTelegram.Bot.Interface.Payments;
+
+/// <summary>
+/// Contains a list of Telegram Star transactions.
+/// </summary>
+public class StarTransactions
+{
+    /// <summary>
+    /// The list of transactions
+    /// </summary>
+    public List<StarTransaction> Transactions { get; set; }
+}

src/RxTelegram.Bot/Interface/Payments/TransactionPartner.cs

@@ -0,0 +1,9 @@
+using RxTelegram.Bot.Interface.BaseTypes.Enums;
+using RxTelegram.Bot.Utils.MultiType;
+
+namespace RxTelegram.Bot.Interface.Payments;
+
+public abstract class TransactionPartner: IMultiTypeClassByType<TransactionPartnerType>
+{
+    public abstract TransactionPartnerType Type { get; set; }
+}

src/RxTelegram.Bot/Interface/Payments/TransactionPartnerFragment.cs

@@ -0,0 +1,19 @@
+using RxTelegram.Bot.Interface.BaseTypes.Enums;
+
+namespace RxTelegram.Bot.Interface.Payments;
+
+/// <summary>
+/// Describes a withdrawal transaction with Fragment.
+/// </summary>
+public class TransactionPartnerFragment : TransactionPartner
+{
+    /// <summary>
+    /// Type of the transaction partner, always “fragment”
+    /// </summary>
+    public override TransactionPartnerType Type { get; set; } = TransactionPartnerType.Fragment;
+
+    /// <summary>
+    /// Optional. State of the transaction if the transaction is outgoing
+    /// </summary>
+    public RevenueWithdrawalState WithdrawalState { get; set; }
+}

src/RxTelegram.Bot/Interface/Payments/TransactionPartnerOther.cs

@@ -0,0 +1,14 @@
+using RxTelegram.Bot.Interface.BaseTypes.Enums;
+
+namespace RxTelegram.Bot.Interface.Payments;
+
+/// <summary>
+/// Describes a transaction with an unknown source or recipient.
+/// </summary>
+public class TransactionPartnerOther : TransactionPartner
+{
+    /// <summary>
+    /// Type of the transaction partner, always “other”
+    /// </summary>
+    public override TransactionPartnerType Type { get; set; }
+}

src/RxTelegram.Bot/Interface/Payments/TransactionPartnerTelegramAds.cs

@@ -0,0 +1,14 @@
+using RxTelegram.Bot.Interface.BaseTypes.Enums;
+
+namespace RxTelegram.Bot.Interface.Payments;
+
+/// <summary>
+/// Describes a withdrawal transaction to the Telegram Ads platform.
+/// </summary>
+public class TransactionPartnerTelegramAds : TransactionPartner
+{
+    /// <summary>
+    /// Type of the transaction partner, always “telegram_ads”
+    /// </summary>
+    public override TransactionPartnerType Type { get; set; }
+}

src/RxTelegram.Bot/Interface/Payments/TransactionPartnerUser.cs

@@ -0,0 +1,25 @@
+using RxTelegram.Bot.Interface.BaseTypes;
+using RxTelegram.Bot.Interface.BaseTypes.Enums;
+
+namespace RxTelegram.Bot.Interface.Payments;
+
+/// <summary>
+/// Describes a transaction with a user.
+/// </summary>
+public class TransactionPartnerUser : TransactionPartner
+{
+    /// <summary>
+    /// Type of the transaction partner, always “user”
+    /// </summary>
+    public override TransactionPartnerType Type { get; set; } = TransactionPartnerType.User;
+
+    /// <summary>
+    /// Information about the user
+    /// </summary>
+    public User User { get; set; }
+
+    /// <summary>
+    /// Optional. Bot-specified invoice payload
+    /// </summary>
+    public string InvoicePayload { get; set; }
+}

src/RxTelegram.Bot/RxTelegram.Bot.csproj

@@ -10,7 +10,7 @@
         <RepositoryUrl>https://github.com/RxTelegram/RxTelegram.Bot</RepositoryUrl>
         <RepositoryType>git</RepositoryType>
         <PackageTags>Telegram;Bot;Api;Rx;Reactive;Observable;RxTelegram;RxTelegram.Bot</PackageTags>
-        <PackageVersion>7.4.0</PackageVersion>
+        <PackageVersion>7.5.0</PackageVersion>
         <PackageIcon>icon.png</PackageIcon>
         <GenerateDocumentationFile>true</GenerateDocumentationFile>
         <DocumentationFile>bin\$(Configuration)\$(TargetFramework)\$(AssemblyName).xml</DocumentationFile>