fill changelog and add Telegram Bots API support note

fix passing of effectId in a lot of functions
fix in SendPhoto
2025-12-31 02:19:20 +00:00 · 2024-06-01 13:35:29 +06:00 · 2024-06-01 13:17:40 +06:00 · 2024-06-01 13:13:10 +06:00
11 changed files with 26 additions and 11 deletions
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -2,8 +2,14 @@

 ## 14.0.0

+**Add support of [Telegram Bots API 7.4](https://core.telegram.org/bots/api-changelog#may-28-2024)**
+
+**THIS UPDATE CONTAINS BREAKING CHANGES**
+
 * `Core`:
    * `TelegramPaymentChargeId` has been added as value class and replaced raw strings in `SuccessfulPayment` type of `telegramPaymentChargeId`
+* All the methods/classes related to sending of messages got `effectId` parameter
+* All the methods/classes related to sending of photos/animations/videos got `showCaptionAboveMedia` parameter

 ## 13.0.0

--- a/README.md
+++ b/README.md
@@ -1,4 +1,4 @@
-# TelegramBotAPI [![Maven Central](https://maven-badges.herokuapp.com/maven-central/dev.inmo/tgbotapi/badge.svg)](https://maven-badges.herokuapp.com/maven-central/dev.inmo/tgbotapi) [![Supported version](https://img.shields.io/badge/Telegram%20Bot%20API-7.3-blue)](https://core.telegram.org/bots/api-changelog#may-6-2024)
+# TelegramBotAPI [![Maven Central](https://maven-badges.herokuapp.com/maven-central/dev.inmo/tgbotapi/badge.svg)](https://maven-badges.herokuapp.com/maven-central/dev.inmo/tgbotapi) [![Supported version](https://img.shields.io/badge/Telegram%20Bot%20API-7.4-blue)](https://core.telegram.org/bots/api-changelog#may-28-2024)

 |          Docs          |                                   [![KDocs](https://img.shields.io/static/v1?label=Dokka&message=KDocs&color=blue&logo=kotlin)](https://tgbotapi.inmo.dev/index.html) [![Mini tutorial](https://img.shields.io/static/v1?label=Mk&message=Docs&color=blue&logo=mkdocs)](https://docs.inmo.dev/tgbotapi/index.html)                                    |
 |:----------------------:|:-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------:|
--- a/tgbotapi.api/src/commonMain/kotlin/dev/inmo/tgbotapi/extensions/api/send/ResendMessage.kt
+++ b/tgbotapi.api/src/commonMain/kotlin/dev/inmo/tgbotapi/extensions/api/send/ResendMessage.kt
@@ -32,7 +32,7 @@ suspend inline fun <T : MessageContent> TelegramBot.resend(
 ) as ContentMessage<T>

 /**
- * This method will send [content] to the [chatId] as is
+ * This method will send [content] to the [chat] as is
 */
 suspend inline fun <T : MessageContent> TelegramBot.resend(
    chat: Chat,
--- a/tgbotapi.api/src/commonMain/kotlin/dev/inmo/tgbotapi/extensions/api/send/SendMessage.kt
+++ b/tgbotapi.api/src/commonMain/kotlin/dev/inmo/tgbotapi/extensions/api/send/SendMessage.kt
@@ -121,7 +121,7 @@ suspend fun TelegramBot.sendMessage(
 )

 /**
- * @param replyMarkup Some [InlineKeyboardMarkup]. See [dev.inmo.tgbotapi.extensions.utils.types.buttons.inlineKeyboard]
+ * @param replyMarkup Some [dev.inmo.tgbotapi.types.buttons.InlineKeyboardMarkup]. See [dev.inmo.tgbotapi.extensions.utils.types.buttons.inlineKeyboard]
 * as a builder for that
 */
 suspend fun TelegramBot.sendMessage(
@@ -140,7 +140,7 @@ suspend fun TelegramBot.sendMessage(


 /**
- * @param replyMarkup Some [InlineKeyboardMarkup]. See [dev.inmo.tgbotapi.extensions.utils.types.buttons.inlineKeyboard]
+ * @param replyMarkup Some [dev.inmo.tgbotapi.types.buttons.InlineKeyboardMarkup]. See [dev.inmo.tgbotapi.extensions.utils.types.buttons.inlineKeyboard]
 * as a builder for that
 */
 suspend fun TelegramBot.sendMessage(
@@ -177,7 +177,7 @@ suspend fun TelegramBot.sendTextMessage(
 )

 /**
- * @param replyMarkup Some [InlineKeyboardMarkup]. See [dev.inmo.tgbotapi.extensions.utils.types.buttons.inlineKeyboard]
+ * @param replyMarkup Some [dev.inmo.tgbotapi.types.buttons.InlineKeyboardMarkup]. See [dev.inmo.tgbotapi.extensions.utils.types.buttons.inlineKeyboard]
 * as a builder for that
 */
 suspend fun TelegramBot.sendTextMessage(
@@ -196,7 +196,7 @@ suspend fun TelegramBot.sendTextMessage(


 /**
- * @param replyMarkup Some [InlineKeyboardMarkup]. See [dev.inmo.tgbotapi.extensions.utils.types.buttons.inlineKeyboard]
+ * @param replyMarkup Some [dev.inmo.tgbotapi.types.buttons.InlineKeyboardMarkup]. See [dev.inmo.tgbotapi.extensions.utils.types.buttons.inlineKeyboard]
 * as a builder for that
 */
 suspend fun TelegramBot.sendTextMessage(
@@ -231,7 +231,7 @@ suspend fun TelegramBot.sendMessage(
 ) = sendMessage(chat.id, entities, linkPreviewOptions, threadId, businessConnectionId, disableNotification, protectContent, effectId, replyParameters, replyMarkup)

 /**
- * @param replyMarkup Some [InlineKeyboardMarkup]. See [dev.inmo.tgbotapi.extensions.utils.types.buttons.inlineKeyboard]
+ * @param replyMarkup Some [dev.inmo.tgbotapi.types.buttons.InlineKeyboardMarkup]. See [dev.inmo.tgbotapi.extensions.utils.types.buttons.inlineKeyboard]
 * as a builder for that
 */
 suspend fun TelegramBot.sendMessage(
@@ -250,7 +250,7 @@ suspend fun TelegramBot.sendMessage(


 /**
- * @param replyMarkup Some [InlineKeyboardMarkup]. See [dev.inmo.tgbotapi.extensions.utils.types.buttons.inlineKeyboard]
+ * @param replyMarkup Some [dev.inmo.tgbotapi.types.buttons.InlineKeyboardMarkup]. See [dev.inmo.tgbotapi.extensions.utils.types.buttons.inlineKeyboard]
 * as a builder for that
 */
 suspend fun TelegramBot.sendMessage(
@@ -286,7 +286,7 @@ suspend fun TelegramBot.sendTextMessage(
 ) = sendTextMessage(chat.id, entities, linkPreviewOptions, threadId, businessConnectionId, disableNotification, protectContent, effectId, replyParameters, replyMarkup)

 /**
- * @param replyMarkup Some [InlineKeyboardMarkup]. See [dev.inmo.tgbotapi.extensions.utils.types.buttons.inlineKeyboard]
+ * @param replyMarkup Some [dev.inmo.tgbotapi.types.buttons.InlineKeyboardMarkup]. See [dev.inmo.tgbotapi.extensions.utils.types.buttons.inlineKeyboard]
 * as a builder for that
 */
 suspend fun TelegramBot.sendTextMessage(
@@ -305,7 +305,7 @@ suspend fun TelegramBot.sendTextMessage(


 /**
- * @param replyMarkup Some [InlineKeyboardMarkup]. See [dev.inmo.tgbotapi.extensions.utils.types.buttons.inlineKeyboard]
+ * @param replyMarkup Some [dev.inmo.tgbotapi.types.buttons.InlineKeyboardMarkup]. See [dev.inmo.tgbotapi.extensions.utils.types.buttons.inlineKeyboard]
 * as a builder for that
 */
 suspend fun TelegramBot.sendTextMessage(
--- a/tgbotapi.api/src/commonMain/kotlin/dev/inmo/tgbotapi/extensions/api/send/SendVenue.kt
+++ b/tgbotapi.api/src/commonMain/kotlin/dev/inmo/tgbotapi/extensions/api/send/SendVenue.kt
@@ -45,6 +45,7 @@ suspend fun TelegramBot.sendVenue(
        businessConnectionId = businessConnectionId,
        disableNotification = disableNotification,
        protectContent = protectContent,
+        effectId = effectId,
        replyParameters = replyParameters,
        replyMarkup = replyMarkup
    )
@@ -190,6 +191,7 @@ suspend fun TelegramBot.sendVenue(
        businessConnectionId = businessConnectionId,
        disableNotification = disableNotification,
        protectContent = protectContent,
+        effectId = effectId,
        replyParameters = replyParameters,
        replyMarkup = replyMarkup
    )
--- a/tgbotapi.api/src/commonMain/kotlin/dev/inmo/tgbotapi/extensions/api/send/Sends.kt
+++ b/tgbotapi.api/src/commonMain/kotlin/dev/inmo/tgbotapi/extensions/api/send/Sends.kt
@@ -1514,6 +1514,7 @@ suspend fun TelegramBot.send(
    businessConnectionId = businessConnectionId,
    disableNotification = disableNotification,
    protectContent = protectContent,
+    effectId = effectId,
    replyParameters = replyParameters,
    replyMarkup = replyMarkup
 )
--- a/tgbotapi.api/src/commonMain/kotlin/dev/inmo/tgbotapi/extensions/api/send/SetMessageReactions.kt
+++ b/tgbotapi.api/src/commonMain/kotlin/dev/inmo/tgbotapi/extensions/api/send/SetMessageReactions.kt
@@ -8,7 +8,6 @@ import dev.inmo.tgbotapi.types.chat.Chat
 import dev.inmo.tgbotapi.types.message.abstracts.AccessibleMessage
 import dev.inmo.tgbotapi.types.message.abstracts.Message
 import dev.inmo.tgbotapi.types.reactions.Reaction
-import kotlin.js.JsName
 import kotlin.jvm.JvmName

 suspend fun TelegramBot.setMessageReactions(
--- a/tgbotapi.api/src/commonMain/kotlin/dev/inmo/tgbotapi/extensions/api/send/media/SendAnimation.kt
+++ b/tgbotapi.api/src/commonMain/kotlin/dev/inmo/tgbotapi/extensions/api/send/media/SendAnimation.kt
@@ -49,6 +49,7 @@ suspend fun TelegramBot.sendAnimation(
        businessConnectionId = businessConnectionId,
        disableNotification = disableNotification,
        protectContent = protectContent,
+        effectId = effectId,
        replyParameters = replyParameters,
        replyMarkup = replyMarkup
    )
@@ -214,6 +215,7 @@ suspend fun TelegramBot.sendAnimation(
        businessConnectionId = businessConnectionId,
        disableNotification = disableNotification,
        protectContent = protectContent,
+        effectId = effectId,
        replyParameters = replyParameters,
        replyMarkup = replyMarkup
    )
--- a/tgbotapi.api/src/commonMain/kotlin/dev/inmo/tgbotapi/extensions/api/send/media/SendPhoto.kt
+++ b/tgbotapi.api/src/commonMain/kotlin/dev/inmo/tgbotapi/extensions/api/send/media/SendPhoto.kt
@@ -41,6 +41,7 @@ suspend fun TelegramBot.sendPhoto(
        businessConnectionId = businessConnectionId,
        disableNotification = disableNotification,
        protectContent = protectContent,
+        effectId = effectId,
        replyParameters = replyParameters,
        replyMarkup = replyMarkup
    )
@@ -245,6 +246,7 @@ suspend inline fun TelegramBot.sendPhoto(
        businessConnectionId = businessConnectionId,
        disableNotification = disableNotification,
        protectContent = protectContent,
+        effectId = effectId,
        replyParameters = replyParameters,
        replyMarkup = replyMarkup
    )
--- a/tgbotapi.api/src/commonMain/kotlin/dev/inmo/tgbotapi/extensions/api/send/media/SendVideo.kt
+++ b/tgbotapi.api/src/commonMain/kotlin/dev/inmo/tgbotapi/extensions/api/send/media/SendVideo.kt
@@ -50,6 +50,7 @@ suspend fun TelegramBot.sendVideo(
        businessConnectionId = businessConnectionId,
        disableNotification = disableNotification,
        protectContent = protectContent,
+        effectId = effectId,
        replyParameters = replyParameters,
        replyMarkup = replyMarkup
    )
@@ -207,6 +208,7 @@ suspend inline fun TelegramBot.sendVideo(
        businessConnectionId = businessConnectionId,
        disableNotification = disableNotification,
        protectContent = protectContent,
+        effectId = effectId,
        replyParameters = replyParameters,
        replyMarkup = replyMarkup
    )
--- a/tgbotapi.api/src/commonMain/kotlin/dev/inmo/tgbotapi/extensions/api/send/media/SendVoice.kt
+++ b/tgbotapi.api/src/commonMain/kotlin/dev/inmo/tgbotapi/extensions/api/send/media/SendVoice.kt
@@ -129,6 +129,7 @@ suspend inline fun TelegramBot.sendVoice(
        duration = duration,
        disableNotification = disableNotification,
        protectContent = protectContent,
+        effectId = effectId,
        replyParameters = replyParameters,
        replyMarkup = replyMarkup
    )
Author	SHA1	Message	Date
InsanusMokrassar	96a7a2acab	fill changelog and add Telegram Bots API support note	2024-06-01 13:35:29 +06:00
InsanusMokrassar	71c830fc2e	fix passing of effectId in a lot of functions	2024-06-01 13:17:40 +06:00
InsanusMokrassar	271e7d2157	fix in SendPhoto	2024-06-01 13:13:10 +06:00