Kotbot 1.4.0

IRus · IRus · commit 1004e2c939f1 · 2026-02-18T13:21:13.000+03:00
diff --git a/README.md b/README.md
@@ -5,12 +5,12 @@
 * [Tgkotbot](https://github.com/Heapy/kotbot/tree/main/tgkotbot#readme) – Bot implementation for needs
   of [Kotlin Community](https://t.me/kotlin_lang) in the telegram
 
-## Bot API 8.2
+## Bot API 8.3
 
 ### Install library
 
 ```kotlin
-implementation("io.heapy.kotbot:core:1.3.0")
+implementation("io.heapy.kotbot:core:1.4.0")
 ```
 
 ### Example
@@ -38,6 +38,6 @@ suspend fun main() {
 
     // Flow, which emits updates
     kotbot.receiveUpdates()
-        .onEach(::println)
+        .collect(::println)
 }
 ```
diff --git a/core-gen/src/main/kotlin/Generate.kt b/core-gen/src/main/kotlin/Generate.kt
@@ -18,7 +18,7 @@ import kotlinx.serialization.json.Json
 fun main() {
     // https://ark0f.github.io/tg-bot-api/custom.json
     val apiJson = {}::class.java
-        .getResource("api820.json")
+        .getResource("api830.json")
         ?.readText()
         ?: error("custom.json not found")
 
diff --git a/core-gen/src/main/kotlin/Parse.kt b/core-gen/src/main/kotlin/Parse.kt
@@ -27,6 +27,7 @@ fun main() {
         "api800",
         "api810",
         "api820",
+        "api830",
     ).forEach { v ->
         val input = rootPath.resolve(v).readText()
         val output = processVersion(input)
diff --git a/core-gen/src/main/resources/api830 b/core-gen/src/main/resources/api830
diff --git a/core-gen/src/main/resources/api830.json b/core-gen/src/main/resources/api830.json
diff --git a/core-gen/src/main/resources/api830.md b/core-gen/src/main/resources/api830.md
diff --git a/core-gen/src/main/resources/api830_v2.json b/core-gen/src/main/resources/api830_v2.json
diff --git a/core-gen/src/main/resources/api900 b/core-gen/src/main/resources/api900
diff --git a/core-gen/src/main/resources/latest.md b/core-gen/src/main/resources/latest.md
diff --git a/core/src/generated/kotlin/io/heapy/kotbot/bot/method/CopyMessage.kt b/core/src/generated/kotlin/io/heapy/kotbot/bot/method/CopyMessage.kt
@@ -35,6 +35,10 @@ public data class CopyMessage(
      * Message identifier in the chat specified in *from_chat_id*
      */
     public val message_id: Int,
+    /**
+     * New start timestamp for the copied video in the message
+     */
+    public val video_start_timestamp: Int? = null,
     /**
      * New caption for media, 0-1024 characters after entities parsing. If not specified, the original caption is kept
      */
diff --git a/core/src/generated/kotlin/io/heapy/kotbot/bot/method/ForwardMessage.kt b/core/src/generated/kotlin/io/heapy/kotbot/bot/method/ForwardMessage.kt
@@ -27,6 +27,10 @@ public data class ForwardMessage(
      * Unique identifier for the chat where the original message was sent (or channel username in the format `@channelusername`)
      */
     public val from_chat_id: ChatId,
+    /**
+     * New start timestamp for the forwarded video in the message
+     */
+    public val video_start_timestamp: Int? = null,
     /**
      * Sends the message [silently](https://telegram.org/blog/channels-2-0#silent-messages). Users will receive a notification with no sound.
      */
diff --git a/core/src/generated/kotlin/io/heapy/kotbot/bot/method/GetAvailableGifts.kt b/core/src/generated/kotlin/io/heapy/kotbot/bot/method/GetAvailableGifts.kt
@@ -8,7 +8,7 @@ import kotlinx.serialization.KSerializer
 import kotlinx.serialization.Serializable
 
 /**
- * Returns the list of gifts that can be sent by the bot to users. Requires no parameters. Returns a [Gifts](https://core.telegram.org/bots/api/#gifts) object.
+ * Returns the list of gifts that can be sent by the bot to users and channel chats. Requires no parameters. Returns a [Gifts](https://core.telegram.org/bots/api/#gifts) object.
  */
 @Serializable
 public class GetAvailableGifts : Method<GetAvailableGifts, Gifts> by Companion {
diff --git a/core/src/generated/kotlin/io/heapy/kotbot/bot/method/SendGift.kt b/core/src/generated/kotlin/io/heapy/kotbot/bot/method/SendGift.kt
@@ -2,6 +2,7 @@ package io.heapy.kotbot.bot.method
 
 import io.heapy.kotbot.bot.Method
 import io.heapy.kotbot.bot.Response
+import io.heapy.kotbot.bot.model.ChatId
 import io.heapy.kotbot.bot.model.MessageEntity
 import kotlin.Boolean
 import kotlin.Long
@@ -12,14 +13,18 @@ import kotlinx.serialization.Serializable
 import kotlinx.serialization.builtins.serializer
 
 /**
- * Sends a gift to the given user. The gift can't be converted to Telegram Stars by the user. Returns *True* on success.
+ * Sends a gift to the given user or channel chat. The gift can't be converted to Telegram Stars by the receiver. Returns *True* on success.
  */
 @Serializable
 public data class SendGift(
     /**
-     * Unique identifier of the target user that will receive the gift
+     * Required if *chat_id* is not specified. Unique identifier of the target user who will receive the gift.
      */
-    public val user_id: Long,
+    public val user_id: Long? = null,
+    /**
+     * Required if *user_id* is not specified. Unique identifier for the chat or username of the channel (in the format `@channelusername`) that will receive the gift.
+     */
+    public val chat_id: ChatId? = null,
     /**
      * Identifier of the gift
      */
@@ -29,7 +34,7 @@ public data class SendGift(
      */
     public val pay_for_upgrade: Boolean? = null,
     /**
-     * Text that will be shown along with the gift; 0-255 characters
+     * Text that will be shown along with the gift; 0-128 characters
      */
     public val text: String? = null,
     /**
diff --git a/core/src/generated/kotlin/io/heapy/kotbot/bot/method/SendVideo.kt b/core/src/generated/kotlin/io/heapy/kotbot/bot/method/SendVideo.kt
@@ -3,6 +3,7 @@ package io.heapy.kotbot.bot.method
 import io.heapy.kotbot.bot.Method
 import io.heapy.kotbot.bot.Response
 import io.heapy.kotbot.bot.model.ChatId
+import io.heapy.kotbot.bot.model.Cover
 import io.heapy.kotbot.bot.model.Message
 import io.heapy.kotbot.bot.model.MessageEntity
 import io.heapy.kotbot.bot.model.ReplyMarkup
@@ -53,6 +54,14 @@ public data class SendVideo(
      * Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass "attach://<file_attach_name>" if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. [More information on Sending Files &raquo;](https://core.telegram.org/bots/api/#sending-files)
      */
     public val thumbnail: Thumbnail? = null,
+    /**
+     * Cover for the video in the message. Pass a file_id to send a file that exists on the Telegram servers (recommended), pass an HTTP URL for Telegram to get a file from the Internet, or pass "attach://<file_attach_name>" to upload a new one using multipart/form-data under <file_attach_name> name. [More information on Sending Files &raquo;](https://core.telegram.org/bots/api/#sending-files)
+     */
+    public val cover: Cover? = null,
+    /**
+     * Start timestamp for the video in the message
+     */
+    public val start_timestamp: Int? = null,
     /**
      * Video caption (may also be used when resending videos by *file_id*), 0-1024 characters after entities parsing
      */
diff --git a/core/src/generated/kotlin/io/heapy/kotbot/bot/method/SetMessageReaction.kt b/core/src/generated/kotlin/io/heapy/kotbot/bot/method/SetMessageReaction.kt
@@ -13,7 +13,7 @@ import kotlinx.serialization.Serializable
 import kotlinx.serialization.builtins.serializer
 
 /**
- * Use this method to change the chosen reactions on a message. Service messages 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. Bots can't use paid reactions. Returns *True* on success.
+ * 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. Bots can't use paid reactions. Returns *True* on success.
  */
 @Serializable
 public data class SetMessageReaction(
diff --git a/core/src/generated/kotlin/io/heapy/kotbot/bot/model/ChatFullInfo.kt b/core/src/generated/kotlin/io/heapy/kotbot/bot/model/ChatFullInfo.kt
@@ -136,6 +136,10 @@ public data class ChatFullInfo(
      * *Optional*. Default chat member permissions, for groups and supergroups
      */
     public val permissions: ChatPermissions? = null,
+    /**
+     * *Optional*. *True*, if gifts can be sent to the chat
+     */
+    public val can_send_gift: Boolean? = null,
     /**
      * *Optional*. *True*, if paid media messages can be sent or forwarded to the channel chat. The field is available only for channel chats.
      */
diff --git a/core/src/generated/kotlin/io/heapy/kotbot/bot/model/Cover.kt b/core/src/generated/kotlin/io/heapy/kotbot/bot/model/Cover.kt
@@ -0,0 +1,24 @@
+package io.heapy.kotbot.bot.model
+
+import kotlinx.serialization.Serializable
+
+@Serializable
+public sealed interface Cover
+
+@JvmInline
+@Serializable
+public value class FileId(
+    public val value: String
+) : Cover
+
+@JvmInline
+@Serializable
+public value class FileUrl(
+    public val value: String
+) : Cover
+
+@JvmInline
+@Serializable
+public value class FileAttachment(
+    public val value: String
+) : Cover
diff --git a/core/src/generated/kotlin/io/heapy/kotbot/bot/model/InputMediaAnimation.kt b/core/src/generated/kotlin/io/heapy/kotbot/bot/model/InputMediaAnimation.kt
@@ -22,7 +22,7 @@ public data class InputMediaAnimation(
     /**
      * *Optional*. Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass "attach://<file_attach_name>" if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. [More information on Sending Files &raquo;](https://core.telegram.org/bots/api/#sending-files)
      */
-    public val thumbnail: Thumbnail? = null,
+    public val thumbnail: String? = null,
     /**
      * *Optional*. Caption of the animation to be sent, 0-1024 characters after entities parsing
      */
diff --git a/core/src/generated/kotlin/io/heapy/kotbot/bot/model/InputMediaAudio.kt b/core/src/generated/kotlin/io/heapy/kotbot/bot/model/InputMediaAudio.kt
@@ -21,7 +21,7 @@ public data class InputMediaAudio(
     /**
      * *Optional*. Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass "attach://<file_attach_name>" if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. [More information on Sending Files &raquo;](https://core.telegram.org/bots/api/#sending-files)
      */
-    public val thumbnail: Thumbnail? = null,
+    public val thumbnail: String? = null,
     /**
      * *Optional*. Caption of the audio to be sent, 0-1024 characters after entities parsing
      */
diff --git a/core/src/generated/kotlin/io/heapy/kotbot/bot/model/InputMediaDocument.kt b/core/src/generated/kotlin/io/heapy/kotbot/bot/model/InputMediaDocument.kt
@@ -21,7 +21,7 @@ public data class InputMediaDocument(
     /**
      * *Optional*. Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass "attach://<file_attach_name>" if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. [More information on Sending Files &raquo;](https://core.telegram.org/bots/api/#sending-files)
      */
-    public val thumbnail: Thumbnail? = null,
+    public val thumbnail: String? = null,
     /**
      * *Optional*. Caption of the document to be sent, 0-1024 characters after entities parsing
      */
diff --git a/core/src/generated/kotlin/io/heapy/kotbot/bot/model/InputMediaVideo.kt b/core/src/generated/kotlin/io/heapy/kotbot/bot/model/InputMediaVideo.kt
@@ -22,7 +22,15 @@ public data class InputMediaVideo(
     /**
      * *Optional*. Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass "attach://<file_attach_name>" if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. [More information on Sending Files &raquo;](https://core.telegram.org/bots/api/#sending-files)
      */
-    public val thumbnail: Thumbnail? = null,
+    public val thumbnail: String? = null,
+    /**
+     * *Optional*. Cover for the video in the message. Pass a file_id to send a file that exists on the Telegram servers (recommended), pass an HTTP URL for Telegram to get a file from the Internet, or pass "attach://<file_attach_name>" to upload a new one using multipart/form-data under <file_attach_name> name. [More information on Sending Files &raquo;](https://core.telegram.org/bots/api/#sending-files)
+     */
+    public val cover: String? = null,
+    /**
+     * *Optional*. Start timestamp for the video in the message
+     */
+    public val start_timestamp: Int? = null,
     /**
      * *Optional*. Caption of the video to be sent, 0-1024 characters after entities parsing
      */
diff --git a/core/src/generated/kotlin/io/heapy/kotbot/bot/model/InputPaidMediaVideo.kt b/core/src/generated/kotlin/io/heapy/kotbot/bot/model/InputPaidMediaVideo.kt
@@ -21,7 +21,15 @@ public data class InputPaidMediaVideo(
     /**
      * *Optional*. Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass "attach://<file_attach_name>" if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. [More information on Sending Files &raquo;](https://core.telegram.org/bots/api/#sending-files)
      */
-    public val thumbnail: Thumbnail? = null,
+    public val thumbnail: String? = null,
+    /**
+     * *Optional*. Cover for the video in the message. Pass a file_id to send a file that exists on the Telegram servers (recommended), pass an HTTP URL for Telegram to get a file from the Internet, or pass "attach://<file_attach_name>" to upload a new one using multipart/form-data under <file_attach_name> name. [More information on Sending Files &raquo;](https://core.telegram.org/bots/api/#sending-files)
+     */
+    public val cover: String? = null,
+    /**
+     * *Optional*. Start timestamp for the video in the message
+     */
+    public val start_timestamp: Int? = null,
     /**
      * *Optional*. Video width
      */
diff --git a/core/src/generated/kotlin/io/heapy/kotbot/bot/model/TransactionPartner.kt b/core/src/generated/kotlin/io/heapy/kotbot/bot/model/TransactionPartner.kt
@@ -7,6 +7,7 @@ import kotlinx.serialization.Serializable
  * This object describes the source of a transaction, or its recipient for outgoing transactions. Currently, it can be one of
  *
  * * [TransactionPartnerUser](https://core.telegram.org/bots/api/#transactionpartneruser)
+ * * [TransactionPartnerChat](https://core.telegram.org/bots/api/#transactionpartnerchat)
  * * [TransactionPartnerAffiliateProgram](https://core.telegram.org/bots/api/#transactionpartneraffiliateprogram)
  * * [TransactionPartnerFragment](https://core.telegram.org/bots/api/#transactionpartnerfragment)
  * * [TransactionPartnerTelegramAds](https://core.telegram.org/bots/api/#transactionpartnertelegramads)
diff --git a/core/src/generated/kotlin/io/heapy/kotbot/bot/model/TransactionPartnerChat.kt b/core/src/generated/kotlin/io/heapy/kotbot/bot/model/TransactionPartnerChat.kt
@@ -0,0 +1,23 @@
+package io.heapy.kotbot.bot.model
+
+import kotlin.String
+import kotlinx.serialization.Serializable
+
+/**
+ * Describes a transaction with a chat.
+ */
+@Serializable
+public data class TransactionPartnerChat(
+    /**
+     * Type of the transaction partner, always "chat"
+     */
+    public val type: String,
+    /**
+     * Information about the chat
+     */
+    public val chat: Chat,
+    /**
+     * *Optional*. The gift sent to the chat by the bot
+     */
+    public val gift: Gift? = null,
+) : TransactionPartner
diff --git a/core/src/generated/kotlin/io/heapy/kotbot/bot/model/Video.kt b/core/src/generated/kotlin/io/heapy/kotbot/bot/model/Video.kt
@@ -3,6 +3,7 @@ package io.heapy.kotbot.bot.model
 import kotlin.Int
 import kotlin.Long
 import kotlin.String
+import kotlin.collections.List
 import kotlinx.serialization.Serializable
 
 /**
@@ -34,6 +35,14 @@ public data class Video(
      * *Optional*. Video thumbnail
      */
     public val thumbnail: PhotoSize? = null,
+    /**
+     * *Optional*. Available sizes of the cover of the video in the message
+     */
+    public val cover: List<PhotoSize>? = null,
+    /**
+     * *Optional*. Timestamp in seconds from which the video will play in the message
+     */
+    public val start_timestamp: Int? = null,
     /**
      * *Optional*. Original filename as defined by the sender
      */
diff --git a/core/src/main/kotlin/io/heapy/kotbot/bot/Serializers.kt b/core/src/main/kotlin/io/heapy/kotbot/bot/Serializers.kt
@@ -198,6 +198,7 @@ public class TransactionPartnerSerializer : JsonContentPolymorphicSerializer<Tra
             "fragment" -> TransactionPartnerFragment.serializer()
             "telegram_ads" -> TransactionPartnerTelegramAds.serializer()
             "telegram_api" -> TransactionPartnerTelegramApi.serializer()
+            "chat" -> TransactionPartnerChat.serializer()
             "other" -> TransactionPartnerOther.serializer()
             else -> error("Unknown argument type: $type")
         }
diff --git a/core/src/test/kotlin/io/heapy/kotbot/bot/Playground.kt b/core/src/test/kotlin/io/heapy/kotbot/bot/Playground.kt
@@ -7,10 +7,11 @@ import io.heapy.kotbot.bot.method.GetMe
 import io.heapy.kotbot.bot.model.LongChatId
 
 suspend fun main() {
-    val dotenv = dotenv().properties
+    val dotenv = dotenv()
+    val env = dotenv.properties
 
     val kotbot = Kotbot(
-        token = dotenv.getValue("KOTBOT_TOKEN"),
+        token = env.getValue("KOTBOT_TOKEN"),
     )
 
     val me = kotbot.execute(GetMe())
diff --git a/gradle.properties b/gradle.properties
@@ -1,5 +1,5 @@
 group=io.heapy.kotbot
-version=1.3.0
+version=1.4.0
 kotlin.code.style=official
 kotlin.daemon.jvmargs=-XX:+UseParallelGC -Xmx2g
 org.gradle.parallel=true
