progress on addinf of paid media

15.0.0

CHANGELOG.md

@@ -1,5 +1,10 @@
 # TelegramBotAPI changelog
 
+## 15.1.0
+
+* `Version`:
+  * `MicroUtils`: `0.21.1` -> `0.21.2`
+
 ## 15.0.0
 
 **THIS UPDATE CONTAINS BREAKING CHANGES**

build.gradle

@@ -24,9 +24,9 @@ plugins {
 allprojects {
     repositories {
         mavenLocal()
+        maven { url "https://nexus.inmo.dev/repository/maven-releases/" }
         mavenCentral()
         google()
-        maven { url "https://nexus.inmo.dev/repository/maven-releases/" }
     }
     if (it != rootProject.findProject("docs")) {
         tasks.whenTaskAdded { task ->

gradle.properties

@@ -6,4 +6,4 @@ kotlin.incremental=true
 kotlin.incremental.js=true
 
 library_group=dev.inmo
-library_version=15.0.0
+library_version=15.1.0

gradle/libs.versions.toml

@@ -13,7 +13,7 @@ ktor = "2.3.11"
 ksp = "1.9.23-1.0.20"
 kotlin-poet = "1.16.0"
 
-microutils = "0.21.1"
+microutils = "0.21.2"
 kslog = "1.3.4"
 
 versions = "0.51.0"

tgbotapi.api/src/commonMain/kotlin/dev/inmo/tgbotapi/extensions/api/edit/Edits.kt

@@ -12,7 +12,7 @@ import dev.inmo.tgbotapi.types.business_connection.BusinessConnectionId
 import dev.inmo.tgbotapi.types.buttons.InlineKeyboardMarkup
 import dev.inmo.tgbotapi.types.chat.Chat
 import dev.inmo.tgbotapi.types.location.LiveLocation
-import dev.inmo.tgbotapi.types.media.TelegramMedia
+import dev.inmo.tgbotapi.types.media.TelegramFreeMedia
 import dev.inmo.tgbotapi.types.message.ParseMode
 import dev.inmo.tgbotapi.types.message.abstracts.ContentMessage
 import dev.inmo.tgbotapi.types.message.abstracts.AccessibleMessage
@@ -145,7 +145,7 @@ suspend fun TelegramBot.edit(
 suspend fun TelegramBot.edit(
     chatId: ChatIdentifier,
     messageId: MessageId,
-    media: TelegramMedia,
+    media: TelegramFreeMedia,
     businessConnectionId: BusinessConnectionId? = chatId.businessConnectionId,
     replyMarkup: InlineKeyboardMarkup? = null
 ) = editMessageMedia(chatId, messageId, media, businessConnectionId, replyMarkup)
@@ -157,7 +157,7 @@ suspend fun TelegramBot.edit(
 suspend fun TelegramBot.edit(
     chat: Chat,
     messageId: MessageId,
-    media: TelegramMedia,
+    media: TelegramFreeMedia,
     businessConnectionId: BusinessConnectionId? = chat.id.businessConnectionId,
     replyMarkup: InlineKeyboardMarkup? = null
 ) = editMessageMedia(chat, messageId, media, businessConnectionId, replyMarkup)
@@ -168,7 +168,7 @@ suspend fun TelegramBot.edit(
  */
 suspend fun TelegramBot.edit(
     message: ContentMessage<MediaContent>,
-    media: TelegramMedia,
+    media: TelegramFreeMedia,
     businessConnectionId: BusinessConnectionId? = message.chat.id.businessConnectionId,
     replyMarkup: InlineKeyboardMarkup? = null
 ) = editMessageMedia(message, media, businessConnectionId, replyMarkup)

tgbotapi.api/src/commonMain/kotlin/dev/inmo/tgbotapi/extensions/api/edit/InlineEdits.kt

@@ -8,7 +8,7 @@ import dev.inmo.tgbotapi.extensions.api.edit.text.editMessageText
 import dev.inmo.tgbotapi.types.*
 import dev.inmo.tgbotapi.types.buttons.InlineKeyboardMarkup
 import dev.inmo.tgbotapi.types.location.LiveLocation
-import dev.inmo.tgbotapi.types.media.TelegramMedia
+import dev.inmo.tgbotapi.types.media.TelegramFreeMedia
 import dev.inmo.tgbotapi.types.message.ParseMode
 import dev.inmo.tgbotapi.types.message.textsources.TextSource
 import dev.inmo.tgbotapi.types.message.textsources.TextSourcesList
@@ -47,7 +47,7 @@ suspend fun TelegramBot.edit(
  */
 suspend fun TelegramBot.edit(
     messageId: InlineMessageId,
-    media: TelegramMedia,
+    media: TelegramFreeMedia,
     replyMarkup: InlineKeyboardMarkup? = null
 ) = editMessageMedia(messageId, media, replyMarkup)
 

tgbotapi.api/src/commonMain/kotlin/dev/inmo/tgbotapi/extensions/api/edit/media/EditChatMessageMedia.kt

@@ -3,7 +3,7 @@ package dev.inmo.tgbotapi.extensions.api.edit.media
 import dev.inmo.tgbotapi.bot.TelegramBot
 import dev.inmo.tgbotapi.requests.edit.media.EditChatMessageMedia
 import dev.inmo.tgbotapi.types.ChatIdentifier
-import dev.inmo.tgbotapi.types.media.TelegramMedia
+import dev.inmo.tgbotapi.types.media.TelegramFreeMedia
 import dev.inmo.tgbotapi.types.MessageId
 import dev.inmo.tgbotapi.types.businessConnectionId
 import dev.inmo.tgbotapi.types.business_connection.BusinessConnectionId
@@ -19,7 +19,7 @@ import dev.inmo.tgbotapi.types.message.content.MediaContent
 suspend fun TelegramBot.editMessageMedia(
     chatId: ChatIdentifier,
     messageId: MessageId,
-    media: TelegramMedia,
+    media: TelegramFreeMedia,
     businessConnectionId: BusinessConnectionId? = chatId.businessConnectionId,
     replyMarkup: InlineKeyboardMarkup? = null
 ) = execute(
@@ -33,7 +33,7 @@ suspend fun TelegramBot.editMessageMedia(
 suspend fun TelegramBot.editMessageMedia(
     chat: Chat,
     messageId: MessageId,
-    media: TelegramMedia,
+    media: TelegramFreeMedia,
     businessConnectionId: BusinessConnectionId? = chat.id.businessConnectionId,
     replyMarkup: InlineKeyboardMarkup? = null
 ) = editMessageMedia(chat.id, messageId, media, businessConnectionId, replyMarkup)
@@ -44,7 +44,7 @@ suspend fun TelegramBot.editMessageMedia(
  */
 suspend fun TelegramBot.editMessageMedia(
     message: ContentMessage<out MediaContent>,
-    media: TelegramMedia,
+    media: TelegramFreeMedia,
     businessConnectionId: BusinessConnectionId? = message.chat.id.businessConnectionId,
     replyMarkup: InlineKeyboardMarkup? = null
 ) = editMessageMedia(message.chat.id, message.messageId, media, businessConnectionId, replyMarkup)

tgbotapi.api/src/commonMain/kotlin/dev/inmo/tgbotapi/extensions/api/edit/media/EditInlineMessageMedia.kt

@@ -3,7 +3,7 @@ package dev.inmo.tgbotapi.extensions.api.edit.media
 import dev.inmo.tgbotapi.bot.TelegramBot
 import dev.inmo.tgbotapi.requests.edit.media.EditInlineMessageMedia
 import dev.inmo.tgbotapi.types.InlineMessageId
-import dev.inmo.tgbotapi.types.media.TelegramMedia
+import dev.inmo.tgbotapi.types.media.TelegramFreeMedia
 import dev.inmo.tgbotapi.types.buttons.InlineKeyboardMarkup
 
 /**
@@ -12,6 +12,6 @@ import dev.inmo.tgbotapi.types.buttons.InlineKeyboardMarkup
  */
 suspend fun TelegramBot.editMessageMedia(
     inlineMessageId: InlineMessageId,
-    media: TelegramMedia,
+    media: TelegramFreeMedia,
     replyMarkup: InlineKeyboardMarkup? = null
 ) = execute(EditInlineMessageMedia(inlineMessageId, media, replyMarkup))

tgbotapi.api/src/commonMain/kotlin/dev/inmo/tgbotapi/extensions/api/send/Replies.kt

@@ -855,7 +855,7 @@ suspend inline fun TelegramBot.replyWithPhoto(
 
 suspend inline fun TelegramBot.reply(
     to: AccessibleMessage,
-    photo: Photo,
+    photo: PhotoFile,
     text: String? = null,
     parseMode: ParseMode? = null,
     showCaptionAboveMedia: Boolean = false,
@@ -947,7 +947,7 @@ suspend inline fun TelegramBot.replyWithPhoto(
 
 suspend inline fun TelegramBot.reply(
     to: AccessibleMessage,
-    photo: Photo,
+    photo: PhotoFile,
     entities: TextSourcesList,
     showCaptionAboveMedia: Boolean = false,
     spoilered: Boolean = false,

tgbotapi.api/src/commonMain/kotlin/dev/inmo/tgbotapi/extensions/api/send/RepliesWithChatsAndMessages.kt

@@ -806,7 +806,7 @@ suspend inline fun TelegramBot.replyWithPhoto(
 suspend inline fun TelegramBot.reply(
     toChatId: IdChatIdentifier,
     toMessageId: MessageId,
-    photo: Photo,
+    photo: PhotoFile,
     text: String? = null,
     parseMode: ParseMode? = null,
     showCaptionAboveMedia: Boolean = false,
@@ -860,7 +860,7 @@ suspend inline fun TelegramBot.replyWithPhoto(
 suspend inline fun TelegramBot.reply(
     toChatId: IdChatIdentifier,
     toMessageId: MessageId,
-    photo: Photo,
+    photo: PhotoFile,
     entities: TextSourcesList,
     showCaptionAboveMedia: Boolean = false,
     spoilered: Boolean = false,

tgbotapi.api/src/commonMain/kotlin/dev/inmo/tgbotapi/extensions/api/send/Sends.kt

@@ -726,7 +726,7 @@ suspend fun TelegramBot.send(
  */
 suspend fun TelegramBot.send(
     chatId: ChatIdentifier,
-    photo: Photo,
+    photo: PhotoFile,
     text: String? = null,
     parseMode: ParseMode? = null,
     showCaptionAboveMedia: Boolean = false,
@@ -747,7 +747,7 @@ suspend fun TelegramBot.send(
  */
 suspend fun TelegramBot.send(
     chat: Chat,
-    photo: Photo,
+    photo: PhotoFile,
     text: String? = null,
     parseMode: ParseMode? = null,
     showCaptionAboveMedia: Boolean = false,
@@ -810,7 +810,7 @@ suspend fun TelegramBot.send(
  */
 suspend inline fun TelegramBot.send(
     chatId: ChatIdentifier,
-    photo: Photo,
+    photo: PhotoFile,
     entities: TextSourcesList,
     showCaptionAboveMedia: Boolean = false,
     spoilered: Boolean = false,
@@ -830,7 +830,7 @@ suspend inline fun TelegramBot.send(
  */
 suspend inline fun TelegramBot.send(
     chat: Chat,
-    photo: Photo,
+    photo: PhotoFile,
     entities: TextSourcesList,
     showCaptionAboveMedia: Boolean = false,
     spoilered: Boolean = false,

tgbotapi.api/src/commonMain/kotlin/dev/inmo/tgbotapi/extensions/api/send/media/SendPhoto.kt

@@ -87,7 +87,7 @@ suspend fun TelegramBot.sendPhoto(
  */
 suspend fun TelegramBot.sendPhoto(
     chatId: ChatIdentifier,
-    photo: Photo,
+    photo: PhotoFile,
     text: String? = null,
     parseMode: ParseMode? = null,
     showCaptionAboveMedia: Boolean = false,
@@ -121,7 +121,7 @@ suspend fun TelegramBot.sendPhoto(
  */
 suspend fun TelegramBot.sendPhoto(
     chat: Chat,
-    photo: Photo,
+    photo: PhotoFile,
     text: String? = null,
     parseMode: ParseMode? = null,
     showCaptionAboveMedia: Boolean = false,
@@ -290,7 +290,7 @@ suspend inline fun TelegramBot.sendPhoto(
  */
 suspend inline fun TelegramBot.sendPhoto(
     chatId: ChatIdentifier,
-    photo: Photo,
+    photo: PhotoFile,
     entities: TextSourcesList,
     showCaptionAboveMedia: Boolean = false,
     spoilered: Boolean = false,
@@ -322,7 +322,7 @@ suspend inline fun TelegramBot.sendPhoto(
  */
 suspend inline fun TelegramBot.sendPhoto(
     chat: Chat,
-    photo: Photo,
+    photo: PhotoFile,
     entities: TextSourcesList,
     showCaptionAboveMedia: Boolean = false,
     spoilered: Boolean = false,

tgbotapi.core/src/commonMain/kotlin/dev/inmo/tgbotapi/requests/edit/abstracts/EditMediaMessage.kt

@@ -1,7 +1,7 @@
 package dev.inmo.tgbotapi.requests.edit.abstracts
 
-import dev.inmo.tgbotapi.types.media.TelegramMedia
+import dev.inmo.tgbotapi.types.media.TelegramFreeMedia
 
 interface EditMediaMessage {
-    val media: TelegramMedia
+    val media: TelegramFreeMedia
 }

tgbotapi.core/src/commonMain/kotlin/dev/inmo/tgbotapi/requests/edit/media/EditChatMessageMedia.kt

@@ -4,7 +4,7 @@ import dev.inmo.tgbotapi.requests.abstracts.MultipartFile
 import dev.inmo.tgbotapi.requests.edit.abstracts.*
 import dev.inmo.tgbotapi.types.*
 import dev.inmo.tgbotapi.types.business_connection.BusinessConnectionId
-import dev.inmo.tgbotapi.types.media.TelegramMedia
+import dev.inmo.tgbotapi.types.media.TelegramFreeMedia
 import dev.inmo.tgbotapi.types.buttons.InlineKeyboardMarkup
 import dev.inmo.tgbotapi.types.message.abstracts.ContentMessage
 import dev.inmo.tgbotapi.types.message.abstracts.TelegramBotAPIMessageDeserializationStrategyClass
@@ -22,7 +22,7 @@ data class EditChatMessageMedia(
     @SerialName(messageIdField)
     override val messageId: MessageId,
     @SerialName(mediaField)
-    override val media: TelegramMedia,
+    override val media: TelegramFreeMedia,
     @SerialName(businessConnectionIdField)
     override val businessConnectionId: BusinessConnectionId? = chatId.businessConnectionId,
     @SerialName(replyMarkupField)

tgbotapi.core/src/commonMain/kotlin/dev/inmo/tgbotapi/requests/edit/media/EditInlineMessageMedia.kt

@@ -3,7 +3,7 @@ package dev.inmo.tgbotapi.requests.edit.media
 import dev.inmo.tgbotapi.requests.abstracts.MultipartFile
 import dev.inmo.tgbotapi.requests.edit.abstracts.*
 import dev.inmo.tgbotapi.types.*
-import dev.inmo.tgbotapi.types.media.TelegramMedia
+import dev.inmo.tgbotapi.types.media.TelegramFreeMedia
 import dev.inmo.tgbotapi.types.buttons.InlineKeyboardMarkup
 import kotlinx.serialization.*
 
@@ -12,7 +12,7 @@ data class EditInlineMessageMedia(
     @SerialName(inlineMessageIdField)
     override val inlineMessageId: InlineMessageId,
     @SerialName(mediaField)
-    override val media: TelegramMedia,
+    override val media: TelegramFreeMedia,
     @SerialName(replyMarkupField)
     override val replyMarkup: InlineKeyboardMarkup? = null
 ) : EditInlineMessage, EditReplyMessage, EditMediaMessage {

tgbotapi.core/src/commonMain/kotlin/dev/inmo/tgbotapi/requests/send/media/SendMediaGroup.kt

@@ -4,7 +4,6 @@ import dev.inmo.tgbotapi.requests.abstracts.MultipartFile
 import dev.inmo.tgbotapi.requests.abstracts.Request
 import dev.inmo.tgbotapi.requests.common.CommonMultipartFileRequest
 import dev.inmo.tgbotapi.requests.send.abstracts.SendContentMessageRequest
-import dev.inmo.tgbotapi.requests.send.abstracts.SendMessageRequest
 import dev.inmo.tgbotapi.requests.send.media.base.*
 import dev.inmo.tgbotapi.types.*
 import dev.inmo.tgbotapi.types.business_connection.BusinessConnectionId
@@ -193,7 +192,7 @@ data class SendMediaGroupData internal constructor(
     private val convertedMedia: String
         get() = buildJsonArray {
             media.forEach {
-                add(it.toJsonWithoutNulls(MediaGroupMemberTelegramMediaSerializer))
+                add(it.toJsonWithoutNulls(MediaGroupMemberTelegramFreeMediaSerializer))
             }
         }.toString()
 

tgbotapi.core/src/commonMain/kotlin/dev/inmo/tgbotapi/requests/send/media/SendPaidMediaGroup.kt

@@ -0,0 +1,209 @@
+package dev.inmo.tgbotapi.requests.send.media
+
+import dev.inmo.tgbotapi.requests.abstracts.MultipartFile
+import dev.inmo.tgbotapi.requests.abstracts.Request
+import dev.inmo.tgbotapi.requests.common.CommonMultipartFileRequest
+import dev.inmo.tgbotapi.requests.send.abstracts.SendContentMessageRequest
+import dev.inmo.tgbotapi.requests.send.media.base.*
+import dev.inmo.tgbotapi.types.*
+import dev.inmo.tgbotapi.types.business_connection.BusinessConnectionId
+import dev.inmo.tgbotapi.types.media.*
+import dev.inmo.tgbotapi.types.message.abstracts.ContentMessage
+import dev.inmo.tgbotapi.types.message.abstracts.PossiblySentViaBotCommonMessage
+import dev.inmo.tgbotapi.types.message.abstracts.TelegramBotAPIMessageDeserializeOnlySerializerClass
+import dev.inmo.tgbotapi.types.message.content.MediaGroupPartContent
+import dev.inmo.tgbotapi.types.message.content.VisualMediaGroupPartContent
+import dev.inmo.tgbotapi.types.message.content.AudioContent
+import dev.inmo.tgbotapi.types.message.content.DocumentContent
+import dev.inmo.tgbotapi.types.message.content.MediaGroupContent
+import dev.inmo.tgbotapi.utils.*
+import dev.inmo.tgbotapi.utils.extensions.asMediaGroupMessage
+import kotlinx.serialization.*
+import kotlinx.serialization.builtins.ListSerializer
+import kotlinx.serialization.descriptors.SerialDescriptor
+import kotlinx.serialization.encoding.Decoder
+import kotlinx.serialization.encoding.Encoder
+import kotlinx.serialization.json.buildJsonArray
+
+const val rawSendingMediaGroupsWarning = "Media groups contains restrictions related to combinations of media" +
+    " types. Currently it is possible to combine photo + video OR audio OR documents"
+
+@RiskFeature(rawSendingMediaGroupsWarning)
+fun <T : MediaGroupPartContent> SendMediaGroup(
+    chatId: ChatIdentifier,
+    media: List<MediaGroupMemberTelegramMedia>,
+    threadId: MessageThreadId? = chatId.threadId,
+    businessConnectionId: BusinessConnectionId? = chatId.businessConnectionId,
+    disableNotification: Boolean = false,
+    protectContent: Boolean = false,
+    effectId: EffectId? = null,
+    replyParameters: ReplyParameters? = null
+): Request<ContentMessage<MediaGroupContent<T>>> {
+    if (media.size !in mediaCountInMediaGroup) {
+        throwRangeError("Count of members in media group", mediaCountInMediaGroup, media.size)
+    }
+
+    val files: List<MultipartFile> = media.flatMap {
+        listOfNotNull(
+            it.file as? MultipartFile,
+            if (it is ThumbedTelegramMedia) {
+                it.thumb as? MultipartFile
+            } else {
+                null
+            }
+        )
+    }
+
+    val data = SendMediaGroupData(
+        chatId = chatId,
+        media = media,
+        threadId = threadId,
+        businessConnectionId = businessConnectionId,
+        disableNotification = disableNotification,
+        protectContent = protectContent,
+        effectId = effectId,
+        replyParameters = replyParameters
+    )
+
+    return (if (files.isEmpty()) {
+        data
+    } else {
+        CommonMultipartFileRequest(
+            data,
+            files.associateBy { it.fileId }
+        )
+    }) as Request<ContentMessage<MediaGroupContent<T>>>
+}
+
+/**
+ * Use this method to be sure that you are correctly sending playlist with audios
+ *
+ * @see TelegramMediaAudio
+ */
+@Suppress("NOTHING_TO_INLINE")
+inline fun SendPlaylist(
+    chatId: ChatIdentifier,
+    media: List<AudioMediaGroupMemberTelegramMedia>,
+    threadId: MessageThreadId? = chatId.threadId,
+    businessConnectionId: BusinessConnectionId? = chatId.businessConnectionId,
+    disableNotification: Boolean = false,
+    protectContent: Boolean = false,
+    effectId: EffectId? = null,
+    replyParameters: ReplyParameters? = null
+) = SendMediaGroup<AudioContent>(
+    chatId = chatId,
+    media = media,
+    threadId = threadId,
+    businessConnectionId = businessConnectionId,
+    disableNotification = disableNotification,
+    protectContent = protectContent,
+    effectId = effectId,
+    replyParameters = replyParameters
+)
+
+/**
+ * Use this method to be sure that you are correctly sending documents media group
+ *
+ * @see TelegramMediaDocument
+ */
+@Suppress("NOTHING_TO_INLINE")
+inline fun SendDocumentsGroup(
+    chatId: ChatIdentifier,
+    media: List<DocumentMediaGroupMemberTelegramMedia>,
+    threadId: MessageThreadId? = chatId.threadId,
+    businessConnectionId: BusinessConnectionId? = chatId.businessConnectionId,
+    disableNotification: Boolean = false,
+    protectContent: Boolean = false,
+    effectId: EffectId? = null,
+    replyParameters: ReplyParameters? = null
+) = SendMediaGroup<DocumentContent>(
+    chatId = chatId,
+    media = media,
+    threadId = threadId,
+    businessConnectionId = businessConnectionId,
+    disableNotification = disableNotification,
+    protectContent = protectContent,
+    effectId = effectId,
+    replyParameters = replyParameters
+)
+
+/**
+ * Use this method to be sure that you are correctly sending visual media group
+ *
+ * @see TelegramMediaPhoto
+ * @see TelegramMediaVideo
+ */
+@Suppress("NOTHING_TO_INLINE")
+inline fun SendVisualMediaGroup(
+    chatId: ChatIdentifier,
+    media: List<VisualMediaGroupMemberTelegramMedia>,
+    threadId: MessageThreadId? = chatId.threadId,
+    businessConnectionId: BusinessConnectionId? = chatId.businessConnectionId,
+    disableNotification: Boolean = false,
+    protectContent: Boolean = false,
+    effectId: EffectId? = null,
+    replyParameters: ReplyParameters? = null,
+) = SendMediaGroup<VisualMediaGroupPartContent>(
+    chatId = chatId,
+    media = media,
+    threadId = threadId,
+    businessConnectionId = businessConnectionId,
+    disableNotification = disableNotification,
+    protectContent = protectContent,
+    effectId = effectId,
+    replyParameters = replyParameters
+)
+
+private object MessagesListSerializer: KSerializer<PossiblySentViaBotCommonMessage<MediaGroupContent<MediaGroupPartContent>>> {
+    private val serializer = ListSerializer(TelegramBotAPIMessageDeserializeOnlySerializerClass<PossiblySentViaBotCommonMessage<MediaGroupPartContent>>())
+    override val descriptor: SerialDescriptor = serializer.descriptor
+
+    override fun deserialize(decoder: Decoder): PossiblySentViaBotCommonMessage<MediaGroupContent<MediaGroupPartContent>> {
+        val messages = serializer.deserialize(decoder)
+        return messages.asMediaGroupMessage()
+    }
+
+    override fun serialize(encoder: Encoder, value: PossiblySentViaBotCommonMessage<MediaGroupContent<MediaGroupPartContent>>) {
+        serializer.serialize(encoder, value.content.group.map { it.sourceMessage })
+    }
+
+}
+
+@Serializable
+data class SendMediaGroupData internal constructor(
+    @SerialName(chatIdField)
+    override val chatId: ChatIdentifier,
+    val media: List<MediaGroupMemberTelegramPaidMedia> = emptyList(),
+    @SerialName(messageThreadIdField)
+    override val threadId: MessageThreadId? = chatId.threadId,
+    @SerialName(businessConnectionIdField)
+    override val businessConnectionId: BusinessConnectionId? = chatId.businessConnectionId,
+    @SerialName(disableNotificationField)
+    override val disableNotification: Boolean = false,
+    @SerialName(protectContentField)
+    override val protectContent: Boolean = false,
+    @SerialName(messageEffectIdField)
+    override val effectId: EffectId? = null,
+    @SerialName(replyParametersField)
+    override val replyParameters: ReplyParameters? = null,
+) : DataRequest<PossiblySentViaBotCommonMessage<MediaGroupContent<MediaGroupPartContent>>>,
+    SendContentMessageRequest<PossiblySentViaBotCommonMessage<MediaGroupContent<MediaGroupPartContent>>> {
+    @SerialName(mediaField)
+    private val convertedMedia: String
+        get() = buildJsonArray {
+            media.forEach {
+                add(it.toJsonWithoutNulls(MediaGroupMemberTelegramFreeMediaSerializer))
+            }
+        }.toString()
+
+
+    override fun method(): String = "sendMediaGroup"
+    override val requestSerializer: SerializationStrategy<*>
+        get() = serializer()
+    override val resultDeserializer: DeserializationStrategy<PossiblySentViaBotCommonMessage<MediaGroupContent<MediaGroupPartContent>>>
+        get() = MessagesListSerializer
+}
+
+data class SendMediaGroupFiles internal constructor(
+    val files: List<MultipartFile>
+) : Files by (files.map { it.fileId to it }.toMap())

tgbotapi.core/src/commonMain/kotlin/dev/inmo/tgbotapi/types/Common.kt

@@ -229,6 +229,7 @@ const val canDeleteStoriesField = "can_delete_stories"
 const val captionEntitiesField = "caption_entities"
 const val hasSpoilerField = "has_spoiler"
 const val showCaptionAboveMediaField = "show_caption_above_media"
+const val supportsStreamingField = "supports_streaming"
 const val loginUrlField = "login_url"
 const val forwardTextField = "forward_text"
 const val botUsernameField = "bot_username"
@@ -605,6 +606,8 @@ const val additionalChatCountField = "additional_chat_count"
 const val unclaimedPrizeCountField = "unclaimed_prize_count"
 const val wasRefundedField = "was_refunded"
 const val isManualField = "is_manual"
+const val starCountField = "star_count"
+const val paidMediaField = "paid_media"
 
 const val businessConnectionIdField = "business_connection_id"
 const val businessIntroField = "business_intro"

tgbotapi.core/src/commonMain/kotlin/dev/inmo/tgbotapi/types/ReplyInfo.kt

@@ -92,7 +92,7 @@ sealed interface ReplyInfo {
             private val animation: AnimationFile? = null,
             private val game: RawGame? = null,
             @Serializable(PhotoSerializer::class)
-            private val photo: Photo? = null,
+            private val photo: PhotoFile? = null,
             private val sticker: Sticker? = null,
             private val video: VideoFile? = null,
             private val voice: VoiceFile? = null,

tgbotapi.core/src/commonMain/kotlin/dev/inmo/tgbotapi/types/UserProfilePhotos.kt

@@ -1,6 +1,6 @@
 package dev.inmo.tgbotapi.types
 
-import dev.inmo.tgbotapi.types.files.Photo
+import dev.inmo.tgbotapi.types.files.PhotoFile
 import dev.inmo.tgbotapi.types.files.PhotoSerializer
 import dev.inmo.tgbotapi.utils.RiskFeature
 import kotlinx.serialization.*
@@ -11,10 +11,10 @@ data class UserProfilePhotos (
     @SerialName("total_count")
     val count: Int,
     @Serializable(UserProfilePhotosPhotosSerializer::class)
-    val photos: List<Photo>
+    val photos: List<PhotoFile>
 )
 
 @RiskFeature
-object UserProfilePhotosPhotosSerializer : KSerializer<List<Photo>> by ListSerializer(
+object UserProfilePhotosPhotosSerializer : KSerializer<List<PhotoFile>> by ListSerializer(
     PhotoSerializer
 )

tgbotapi.core/src/commonMain/kotlin/dev/inmo/tgbotapi/types/files/PaidMediaInfo.kt

@@ -0,0 +1,15 @@
+package dev.inmo.tgbotapi.types.files
+
+import dev.inmo.tgbotapi.types.message.payments.PaidMedia
+import dev.inmo.tgbotapi.types.paidMediaField
+import dev.inmo.tgbotapi.types.starCountField
+import kotlinx.serialization.SerialName
+import kotlinx.serialization.Serializable
+
+@Serializable
+data class PaidMediaInfo(
+    @SerialName(starCountField)
+    val stars: Int,
+    @SerialName(paidMediaField)
+    val media: List<PaidMedia>
+)

tgbotapi.core/src/commonMain/kotlin/dev/inmo/tgbotapi/types/files/PhotoSize.kt

@@ -8,9 +8,9 @@ import kotlin.jvm.JvmInline
 
 @Serializable
 @JvmInline
-value class Photo(
+value class PhotoFile(
     val photos: List<PhotoSize>
-) : List<PhotoSize> by photos, MediaContentVariant {
+) : List<PhotoSize> by photos, MediaContentVariant, UsefulAsPaidMediaFile {
     val biggest: PhotoSize
         get() = biggest()!!
     override val fileId: FileId
@@ -27,12 +27,14 @@ value class Photo(
     }
 }
 
-fun Photo.biggest(): PhotoSize? = maxByOrNull {
+typealias Photo = PhotoFile
+
+fun PhotoFile.biggest(): PhotoSize? = maxByOrNull {
     it.resolution
 }
 
 @RiskFeature
-object PhotoSerializer : KSerializer<Photo> by Photo.serializer()
+object PhotoSerializer : KSerializer<PhotoFile> by PhotoFile.serializer()
 
 @Serializable
 data class PhotoSize(

tgbotapi.core/src/commonMain/kotlin/dev/inmo/tgbotapi/types/files/UsefulAsPaidMediaFile.kt

@@ -0,0 +1,3 @@
+package dev.inmo.tgbotapi.types.files
+
+sealed interface UsefulAsPaidMediaFile : MediaContentVariant

tgbotapi.core/src/commonMain/kotlin/dev/inmo/tgbotapi/types/files/VideoFile.kt

@@ -3,6 +3,7 @@ package dev.inmo.tgbotapi.types.files
 import dev.inmo.tgbotapi.requests.abstracts.FileId
 import dev.inmo.tgbotapi.types.*
 import dev.inmo.tgbotapi.types.media.TelegramMediaVideo
+import dev.inmo.tgbotapi.types.media.TelegramPaidMediaVideo
 import dev.inmo.tgbotapi.types.message.textsources.TextSourcesList
 import dev.inmo.tgbotapi.types.message.ParseMode
 import dev.inmo.tgbotapi.utils.MimeType
@@ -30,7 +31,7 @@ data class VideoFile(
     @SerialName(fileSizeField)
     override val fileSize: Long? = null
 ) : TelegramMediaFile, CustomNamedMediaFile, MimedMediaFile, ThumbedMediaFile, PlayableMediaFile, SizedMediaFile,
-    MediaContentVariant
+    MediaContentVariant, UsefulAsPaidMediaFile
 
 @Suppress("NOTHING_TO_INLINE")
 inline fun VideoFile.toTelegramMediaVideo(
@@ -65,3 +66,11 @@ inline fun VideoFile.toTelegramMediaVideo(
     duration = duration,
     thumb = thumbnail ?.fileId
 )
+@Suppress("NOTHING_TO_INLINE")
+inline fun VideoFile.toTelegramPaidMediaVideo() = TelegramPaidMediaVideo(
+    file = fileId,
+    width = width,
+    height = height,
+    duration = duration,
+    thumb = thumbnail ?.fileId
+)

tgbotapi.core/src/commonMain/kotlin/dev/inmo/tgbotapi/types/games/Game.kt

@@ -5,14 +5,14 @@ import dev.inmo.tgbotapi.abstracts.Titled
 import dev.inmo.tgbotapi.types.ReplyInfo
 import dev.inmo.tgbotapi.types.message.textsources.TextSourcesList
 import dev.inmo.tgbotapi.types.files.AnimationFile
-import dev.inmo.tgbotapi.types.files.Photo
+import dev.inmo.tgbotapi.types.files.PhotoFile
 import kotlinx.serialization.Serializable
 
 @Serializable
 data class Game(
     override val title: String,
     val description: String,
-    val photo: Photo,
+    val photo: PhotoFile,
     override val text: String? = null,
     override val textSources: TextSourcesList = emptyList(),
     val animation: AnimationFile? = null

tgbotapi.core/src/commonMain/kotlin/dev/inmo/tgbotapi/types/games/RawGame.kt

@@ -14,7 +14,7 @@ internal data class RawGame(
     private val description: String,
     @Serializable(PhotoSerializer::class)
     @SerialName(photoField)
-    private val photo: Photo,
+    private val photo: PhotoFile,
     @SerialName(textField)
     private val text: String? = null,
     @SerialName(textEntitiesField)

tgbotapi.core/src/commonMain/kotlin/dev/inmo/tgbotapi/types/media/MediaGroupMemberTelegramFreeMediaSerializer.kt

@@ -11,10 +11,10 @@ import kotlinx.serialization.encoding.Encoder
 import kotlinx.serialization.json.*
 
 @RiskFeature
-object MediaGroupMemberTelegramMediaSerializer : KSerializer<MediaGroupMemberTelegramMedia> {
+object MediaGroupMemberTelegramFreeMediaSerializer : KSerializer<MediaGroupMemberTelegramFreeMedia> {
     @OptIn(InternalSerializationApi::class)
     override val descriptor: SerialDescriptor = buildSerialDescriptor(MediaGroupMemberTelegramMedia::class.toString(), PolymorphicKind.OPEN)
-    override fun serialize(encoder: Encoder, value: MediaGroupMemberTelegramMedia) {
+    override fun serialize(encoder: Encoder, value: MediaGroupMemberTelegramFreeMedia) {
         when (value) {
             is TelegramMediaPhoto -> TelegramMediaPhoto.serializer().serialize(encoder, value)
             is TelegramMediaVideo -> TelegramMediaVideo.serializer().serialize(encoder, value)
@@ -23,7 +23,7 @@ object MediaGroupMemberTelegramMediaSerializer : KSerializer<MediaGroupMemberTel
         }
     }
 
-    override fun deserialize(decoder: Decoder): MediaGroupMemberTelegramMedia {
+    override fun deserialize(decoder: Decoder): MediaGroupMemberTelegramFreeMedia {
         val json = JsonObject.serializer().deserialize(decoder)
 
         return when (json[typeField] ?.jsonPrimitive ?.contentOrNull) {
@@ -35,3 +35,5 @@ object MediaGroupMemberTelegramMediaSerializer : KSerializer<MediaGroupMemberTel
         }
     }
 }
+
+typealias MediaGroupMemberTelegramMediaSerializer = MediaGroupMemberTelegramFreeMediaSerializer

tgbotapi.core/src/commonMain/kotlin/dev/inmo/tgbotapi/types/media/MediaGroupMemberTelegramMedia.kt

@@ -3,21 +3,25 @@ package dev.inmo.tgbotapi.types.media
 import dev.inmo.tgbotapi.abstracts.TextedOutput
 import kotlinx.serialization.Serializable
 import kotlinx.serialization.StringFormat
-import kotlinx.serialization.json.Json
 
-internal val argumentsFormatter by lazy {
-    Json {
-        encodeDefaults = true
-    }
-}
-
-@Serializable(MediaGroupMemberTelegramMediaSerializer::class)
-sealed interface MediaGroupMemberTelegramMedia : TelegramMedia, TextedOutput {
+@Serializable(MediaGroupMemberTelegramFreeMediaSerializer::class)
+sealed interface MediaGroupMemberTelegramMedia : TelegramMedia {
     fun serialize(format: StringFormat): String
 }
 
-sealed interface AudioMediaGroupMemberTelegramMedia: MediaGroupMemberTelegramMedia
-sealed interface DocumentMediaGroupMemberTelegramMedia: MediaGroupMemberTelegramMedia
+@Serializable(MediaGroupMemberTelegramFreeMediaSerializer::class)
+sealed interface MediaGroupMemberTelegramFreeMedia : MediaGroupMemberTelegramMedia, TextedOutput
+@Serializable(MediaGroupMemberTelegramFreeMediaSerializer::class)
+sealed interface MediaGroupMemberTelegramPaidMedia : MediaGroupMemberTelegramMedia
 
-@Serializable(MediaGroupMemberTelegramMediaSerializer::class)
-sealed interface VisualMediaGroupMemberTelegramMedia : MediaGroupMemberTelegramMedia, SpoilerableTelegramMedia, WithCustomizableCaptionTelegramMedia
+sealed interface AudioMediaGroupMemberTelegramMedia: MediaGroupMemberTelegramFreeMedia
+sealed interface DocumentMediaGroupMemberTelegramMedia: MediaGroupMemberTelegramFreeMedia
+
+@Serializable(MediaGroupMemberTelegramFreeMediaSerializer::class)
+sealed interface VisualMediaGroupMemberTelegramMedia : MediaGroupMemberTelegramMedia
+
+@Serializable(MediaGroupMemberTelegramFreeMediaSerializer::class)
+sealed interface VisualMediaGroupMemberTelegramFreeMedia : MediaGroupMemberTelegramFreeMedia, VisualMediaGroupMemberTelegramMedia, SpoilerableTelegramMedia, WithCustomizableCaptionTelegramMedia
+
+@Serializable(MediaGroupMemberTelegramPaidMediaSerializer::class)
+sealed interface VisualMediaGroupMemberTelegramPaidMedia : MediaGroupMemberTelegramPaidMedia, VisualMediaGroupMemberTelegramMedia

tgbotapi.core/src/commonMain/kotlin/dev/inmo/tgbotapi/types/media/MediaGroupMemberTelegramPaidMediaSerializer.kt

@@ -0,0 +1,38 @@
+package dev.inmo.tgbotapi.types.media
+
+import dev.inmo.tgbotapi.types.typeField
+import dev.inmo.tgbotapi.utils.RiskFeature
+import dev.inmo.tgbotapi.utils.nonstrictJsonFormat
+import kotlinx.serialization.InternalSerializationApi
+import kotlinx.serialization.KSerializer
+import kotlinx.serialization.descriptors.PolymorphicKind
+import kotlinx.serialization.descriptors.SerialDescriptor
+import kotlinx.serialization.descriptors.buildSerialDescriptor
+import kotlinx.serialization.encoding.Decoder
+import kotlinx.serialization.encoding.Encoder
+import kotlinx.serialization.json.JsonObject
+import kotlinx.serialization.json.contentOrNull
+import kotlinx.serialization.json.jsonPrimitive
+
+@RiskFeature
+object MediaGroupMemberTelegramPaidMediaSerializer : KSerializer<MediaGroupMemberTelegramPaidMedia> {
+    @OptIn(InternalSerializationApi::class)
+    override val descriptor: SerialDescriptor =
+        buildSerialDescriptor(MediaGroupMemberTelegramMedia::class.toString(), PolymorphicKind.OPEN)
+    override fun serialize(encoder: Encoder, value: MediaGroupMemberTelegramPaidMedia) {
+        when (value) {
+            is TelegramPaidMediaPhoto -> TelegramPaidMediaPhoto.serializer().serialize(encoder, value)
+            is TelegramPaidMediaVideo -> TelegramPaidMediaVideo.serializer().serialize(encoder, value)
+        }
+    }
+
+    override fun deserialize(decoder: Decoder): MediaGroupMemberTelegramPaidMedia {
+        val json = JsonObject.serializer().deserialize(decoder)
+
+        return when (json[typeField] ?.jsonPrimitive ?.contentOrNull) {
+            photoTelegramPaidMediaType -> nonstrictJsonFormat.decodeFromJsonElement(TelegramPaidMediaPhoto.serializer(), json)
+            videoTelegramPaidMediaType -> nonstrictJsonFormat.decodeFromJsonElement(TelegramPaidMediaVideo.serializer(), json)
+            else -> error("Illegal type of incoming MediaGroupMemberTelegramMedia")
+        }
+    }
+}

tgbotapi.core/src/commonMain/kotlin/dev/inmo/tgbotapi/types/media/TelegramFreeMedia.kt

@@ -0,0 +1,9 @@
+package dev.inmo.tgbotapi.types.media
+
+import dev.inmo.tgbotapi.utils.internal.ClassCastsIncluded
+import dev.inmo.tgbotapi.requests.abstracts.InputFile
+import kotlinx.serialization.Serializable
+
+@Serializable(TelegramMediaSerializer::class)
+@ClassCastsIncluded
+sealed interface TelegramFreeMedia : TelegramMedia

tgbotapi.core/src/commonMain/kotlin/dev/inmo/tgbotapi/types/media/TelegramMediaAnimation.kt

@@ -65,7 +65,7 @@ data class TelegramMediaAnimation internal constructor(
     override val height: Int? = null,
     override val duration: Long? = null,
     override val thumb: InputFile? = null
-) : TelegramMedia, SizedTelegramMedia, DuratedTelegramMedia, ThumbedTelegramMedia, TextedOutput, SpoilerableTelegramMedia, WithCustomizableCaptionTelegramMedia {
+) : TelegramFreeMedia, SizedTelegramMedia, DuratedTelegramMedia, ThumbedTelegramMedia, TextedOutput, SpoilerableTelegramMedia, WithCustomizableCaptionTelegramMedia {
     override val type: String = "animation"
     override val textSources: TextSourcesList? by lazy {
         rawEntities ?.asTextSources(text ?: return@lazy null)

tgbotapi.core/src/commonMain/kotlin/dev/inmo/tgbotapi/types/media/TelegramMediaAudio.kt

@@ -52,7 +52,7 @@ data class TelegramMediaAudio internal constructor(
     override val performer: String? = null,
     override val title: String? = null,
     override val thumb: InputFile? = null
-) : TelegramMedia, AudioMediaGroupMemberTelegramMedia, DuratedTelegramMedia, ThumbedTelegramMedia, TitledTelegramMedia,
+) : TelegramFreeMedia, AudioMediaGroupMemberTelegramMedia, DuratedTelegramMedia, ThumbedTelegramMedia, TitledTelegramMedia,
     Performerable {
     override val type: String = audioTelegramMediaType
     override val textSources: TextSourcesList? by lazy {

tgbotapi.core/src/commonMain/kotlin/dev/inmo/tgbotapi/types/media/TelegramMediaDocument.kt

@@ -58,7 +58,7 @@ data class TelegramMediaDocument internal constructor(
     override val thumb: InputFile? = null,
     @SerialName(disableContentTypeDetectionField)
     val disableContentTypeDetection: Boolean? = null
-) : TelegramMedia, DocumentMediaGroupMemberTelegramMedia, ThumbedTelegramMedia {
+) : TelegramFreeMedia, DocumentMediaGroupMemberTelegramMedia, ThumbedTelegramMedia {
     override val type: String = documentTelegramMediaType
     override val textSources: TextSourcesList? by lazy {
         rawEntities ?.asTextSources(text ?: return@lazy null)

tgbotapi.core/src/commonMain/kotlin/dev/inmo/tgbotapi/types/media/TelegramMediaPhoto.kt

@@ -43,7 +43,7 @@ data class TelegramMediaPhoto internal constructor(
     override val spoilered: Boolean = false,
     @SerialName(showCaptionAboveMediaField)
     override val showCaptionAboveMedia: Boolean = false,
-) : TelegramMedia, VisualMediaGroupMemberTelegramMedia {
+) : TelegramFreeMedia, VisualMediaGroupMemberTelegramFreeMedia {
     override val type: String = photoTelegramMediaType
     override val textSources: TextSourcesList? by lazy {
         rawEntities ?.asTextSources(text ?: return@lazy null)

tgbotapi.core/src/commonMain/kotlin/dev/inmo/tgbotapi/types/media/TelegramMediaSerializer.kt

@@ -18,6 +18,8 @@ object TelegramMediaSerializer : KSerializer<TelegramMedia> {
             is TelegramMediaPhoto -> TelegramMediaPhoto.serializer().serialize(encoder, value)
             is TelegramMediaAnimation -> TelegramMediaAnimation.serializer().serialize(encoder, value)
             is TelegramMediaDocument -> TelegramMediaDocument.serializer().serialize(encoder, value)
+            is TelegramPaidMediaVideo -> TelegramPaidMediaVideo.serializer().serialize(encoder, value)
+            is TelegramPaidMediaPhoto -> TelegramPaidMediaPhoto.serializer().serialize(encoder, value)
         }
     }
 

tgbotapi.core/src/commonMain/kotlin/dev/inmo/tgbotapi/types/media/TelegramMediaVideo.kt

@@ -76,7 +76,7 @@ data class TelegramMediaVideo internal constructor (
     override val height: Int? = null,
     override val duration: Long? = null,
     override val thumb: InputFile? = null
-) : TelegramMedia, SizedTelegramMedia, DuratedTelegramMedia, ThumbedTelegramMedia, VisualMediaGroupMemberTelegramMedia {
+) : TelegramFreeMedia, SizedTelegramMedia, DuratedTelegramMedia, ThumbedTelegramMedia, VisualMediaGroupMemberTelegramFreeMedia {
     override val type: String = videoTelegramMediaType
     override val textSources: TextSourcesList? by lazy {
         rawEntities ?.asTextSources(text ?: return@lazy null)

tgbotapi.core/src/commonMain/kotlin/dev/inmo/tgbotapi/types/media/TelegramPaidMedia.kt

@@ -0,0 +1,9 @@
+package dev.inmo.tgbotapi.types.media
+
+import dev.inmo.tgbotapi.utils.internal.ClassCastsIncluded
+import dev.inmo.tgbotapi.requests.abstracts.InputFile
+import kotlinx.serialization.Serializable
+
+@Serializable(TelegramMediaSerializer::class)
+@ClassCastsIncluded
+sealed interface TelegramPaidMedia : TelegramMedia

tgbotapi.core/src/commonMain/kotlin/dev/inmo/tgbotapi/types/media/TelegramPaidMediaPhoto.kt

@@ -0,0 +1,33 @@
+package dev.inmo.tgbotapi.types.media
+
+import dev.inmo.tgbotapi.requests.abstracts.InputFile
+import dev.inmo.tgbotapi.requests.abstracts.fileIdToSend
+import dev.inmo.tgbotapi.types.*
+import dev.inmo.tgbotapi.types.message.textsources.TextSourcesList
+import dev.inmo.tgbotapi.types.message.ParseMode
+import dev.inmo.tgbotapi.types.message.parseModeField
+import dev.inmo.tgbotapi.types.files.PhotoSize
+import dev.inmo.tgbotapi.types.message.*
+import dev.inmo.tgbotapi.types.message.RawMessageEntity
+import dev.inmo.tgbotapi.types.message.toRawMessageEntities
+import dev.inmo.tgbotapi.utils.extensions.makeString
+import kotlinx.serialization.*
+
+internal const val photoTelegramPaidMediaType = "photo"
+
+@Serializable
+data class TelegramPaidMediaPhoto internal constructor(
+    override val file: InputFile,
+) : TelegramPaidMedia, VisualMediaGroupMemberTelegramPaidMedia {
+    override val type: String = photoTelegramPaidMediaType
+
+    override fun serialize(format: StringFormat): String = format.encodeToString(serializer(), this)
+
+    @SerialName(mediaField)
+    override val media: String
+    init { media = file.fileIdToSend } // crutch until js compiling will be fixed
+}
+
+fun PhotoSize.toTelegramPaidMediaPhoto(): TelegramPaidMediaPhoto = TelegramPaidMediaPhoto(
+    file = fileId,
+)

tgbotapi.core/src/commonMain/kotlin/dev/inmo/tgbotapi/types/media/TelegramPaidMediaVideo.kt

@@ -0,0 +1,39 @@
+package dev.inmo.tgbotapi.types.media
+
+import dev.inmo.tgbotapi.requests.abstracts.InputFile
+import dev.inmo.tgbotapi.requests.abstracts.fileIdToSend
+import dev.inmo.tgbotapi.types.*
+import dev.inmo.tgbotapi.types.files.VideoFile
+import dev.inmo.tgbotapi.types.message.payments.PaidMedia
+import kotlinx.serialization.*
+
+internal const val videoTelegramPaidMediaType = "video"
+
+@Serializable
+data class TelegramPaidMediaVideo (
+    override val file: InputFile,
+    override val thumb: InputFile? = null,
+    override val width: Int? = null,
+    override val height: Int? = null,
+    override val duration: Long? = null,
+    @SerialName(supportsStreamingField)
+    val supportsStreaming: Boolean = false,
+) : TelegramPaidMedia, SizedTelegramMedia, DuratedTelegramMedia, ThumbedTelegramMedia, VisualMediaGroupMemberTelegramPaidMedia {
+    override val type: String = videoTelegramPaidMediaType
+
+    override fun serialize(format: StringFormat): String = format.encodeToString(serializer(), this)
+
+    @SerialName(mediaField)
+    override val media: String
+    init { media = file.fileIdToSend } // crutch until js compiling will be fixed
+}
+
+fun VideoFile.toTelegramPaidMediaVideo(): TelegramPaidMediaVideo = TelegramPaidMediaVideo(
+    file = fileId,
+    thumb = thumbnail ?.fileId,
+    width = width,
+    height = height,
+    duration = duration
+)
+
+fun PaidMedia.Video.toTelegramPaidMediaVideo(): TelegramPaidMediaVideo = video.toTelegramPaidMediaVideo()

tgbotapi.core/src/commonMain/kotlin/dev/inmo/tgbotapi/types/message/ChatEvents/NewChatPhoto.kt

@@ -1,8 +1,8 @@
 package dev.inmo.tgbotapi.types.message.ChatEvents
 
-import dev.inmo.tgbotapi.types.files.Photo
+import dev.inmo.tgbotapi.types.files.PhotoFile
 import dev.inmo.tgbotapi.types.message.ChatEvents.abstracts.PublicChatEvent
 
 data class NewChatPhoto(
-    val photo: Photo
+    val photo: PhotoFile
 ): PublicChatEvent

tgbotapi.core/src/commonMain/kotlin/dev/inmo/tgbotapi/types/message/RawMessage.kt

@@ -71,10 +71,11 @@ internal data class RawMessage(
     private val story: Story? = null,
     private val audio: AudioFile? = null,
     private val document: DocumentFile? = null,
+    private val paid_media: PaidMediaInfoContent? = null,
     private val animation: AnimationFile? = null,
     private val game: RawGame? = null,
     @Serializable(PhotoSerializer::class)
-    private val photo: Photo? = null,
+    private val photo: PhotoFile? = null,
     private val sticker: Sticker? = null,
     private val video: VideoFile? = null,
     private val voice: VoiceFile? = null,
@@ -87,7 +88,7 @@ internal data class RawMessage(
     private val left_chat_member: User? = null,
     private val new_chat_title: String? = null,
     @Serializable(PhotoSerializer::class)
-    private val new_chat_photo: Photo? = null,
+    private val new_chat_photo: PhotoFile? = null,
     private val delete_chat_photo: Boolean = false,
     private val group_chat_created: Boolean = false,
     private val supergroup_chat_created: Boolean = false,
@@ -198,6 +199,12 @@ internal data class RawMessage(
                 adaptedCaptionEntities,
                 quote
             )
+            paid_media != null -> PaidMediaInfoContent(
+                document,
+                caption,
+                adaptedCaptionEntities,
+                quote
+            )
             voice != null -> VoiceContent(
                 voice,
                 caption,

tgbotapi.core/src/commonMain/kotlin/dev/inmo/tgbotapi/types/message/content/Abstracts.kt

@@ -9,6 +9,7 @@ import dev.inmo.tgbotapi.types.*
 import dev.inmo.tgbotapi.types.business_connection.BusinessConnectionId
 import dev.inmo.tgbotapi.types.buttons.KeyboardMarkup
 import dev.inmo.tgbotapi.types.files.TelegramMediaFile
+import dev.inmo.tgbotapi.types.media.TelegramFreeMedia
 import dev.inmo.tgbotapi.types.media.TelegramMedia
 import dev.inmo.tgbotapi.types.message.abstracts.*
 import dev.inmo.tgbotapi.utils.RiskFeature

tgbotapi.core/src/commonMain/kotlin/dev/inmo/tgbotapi/types/message/content/MediaGroupContent.kt

@@ -7,7 +7,7 @@ import dev.inmo.tgbotapi.types.abstracts.WithOptionalQuoteInfo
 import dev.inmo.tgbotapi.types.business_connection.BusinessConnectionId
 import dev.inmo.tgbotapi.types.buttons.KeyboardMarkup
 import dev.inmo.tgbotapi.types.files.TelegramMediaFile
-import dev.inmo.tgbotapi.types.media.TelegramMedia
+import dev.inmo.tgbotapi.types.media.TelegramFreeMedia
 import dev.inmo.tgbotapi.types.message.abstracts.ContentMessage
 import dev.inmo.tgbotapi.types.message.textsources.TextSource
 import kotlinx.serialization.Serializable
@@ -29,7 +29,7 @@ data class MediaGroupContent<T : MediaGroupPartContent>(
     override val text: String?
         get() = mainContent.text
 
-    override fun asTelegramMedia(): TelegramMedia = mainContent.asTelegramMedia()
+    override fun asTelegramMedia(): TelegramFreeMedia = mainContent.asTelegramMedia()
 
     override fun createResend(
         chatId: ChatIdentifier,

tgbotapi.core/src/commonMain/kotlin/dev/inmo/tgbotapi/types/message/content/PaidMediaInfoContent.kt

@@ -0,0 +1,42 @@
+package dev.inmo.tgbotapi.types.message.content
+
+import dev.inmo.tgbotapi.requests.abstracts.Request
+import dev.inmo.tgbotapi.types.*
+import dev.inmo.tgbotapi.types.business_connection.BusinessConnectionId
+import dev.inmo.tgbotapi.types.message.textsources.TextSourcesList
+import dev.inmo.tgbotapi.types.buttons.KeyboardMarkup
+import dev.inmo.tgbotapi.types.files.*
+import dev.inmo.tgbotapi.types.files.toTelegramPaidMediaVideo
+import dev.inmo.tgbotapi.types.media.*
+import dev.inmo.tgbotapi.types.message.abstracts.ContentMessage
+import dev.inmo.tgbotapi.types.message.payments.PaidMedia
+import kotlinx.serialization.Serializable
+
+@Serializable
+data class PaidMediaInfoContent(
+    val paidMediaInfo: PaidMediaInfo,
+    override val text: String? = null,
+    override val textSources: TextSourcesList = emptyList(),
+    override val quote: TextQuote? = null,
+    override val showCaptionAboveMedia: Boolean = false
+) : TextedMediaContent, WithCustomizedCaptionMediaContent {
+    override val media: TelegramMediaFile
+        get() = paidMediaInfo.media.fir
+    override fun asTelegramMedia(): TelegramMediaFile = when (val media = media) {
+        is PaidMedia.Photo -> media.photo.biggest.toTelegramPaidMediaPhoto()
+        is PaidMedia.Preview,
+        is PaidMedia.Unknown -> error("Unable to create telegram media out of $media")
+        is PaidMedia.Video -> media.video.toTelegramPaidMediaVideo()
+    }
+
+    override fun createResend(
+        chatId: ChatIdentifier,
+        messageThreadId: MessageThreadId?,
+        businessConnectionId: BusinessConnectionId?,
+        disableNotification: Boolean,
+        protectContent: Boolean,
+        effectId: EffectId?,
+        replyParameters: ReplyParameters?,
+        replyMarkup: KeyboardMarkup?
+    ): Request<ContentMessage<PaidMediaInfoContent>> = TODO()
+}

tgbotapi.core/src/commonMain/kotlin/dev/inmo/tgbotapi/types/message/content/PhotoContent.kt

@@ -15,7 +15,7 @@ import kotlinx.serialization.Serializable
 
 @Serializable
 data class PhotoContent(
-    override val mediaCollection: Photo,
+    override val mediaCollection: PhotoFile,
     override val text: String? = null,
     override val textSources: TextSourcesList = emptyList(),
     override val spoilered: Boolean = false,

tgbotapi.core/src/commonMain/kotlin/dev/inmo/tgbotapi/types/message/payments/PaidMedia.kt

@@ -0,0 +1,132 @@
+package dev.inmo.tgbotapi.types.message.payments
+
+import dev.inmo.tgbotapi.types.*
+import dev.inmo.tgbotapi.types.files.PhotoFile
+import dev.inmo.tgbotapi.types.files.TelegramMediaFile
+import dev.inmo.tgbotapi.types.files.VideoFile
+import dev.inmo.tgbotapi.utils.decodeDataAndJson
+import kotlinx.serialization.EncodeDefault
+import kotlinx.serialization.KSerializer
+import kotlinx.serialization.SerialName
+import kotlinx.serialization.Serializable
+import kotlinx.serialization.descriptors.SerialDescriptor
+import kotlinx.serialization.encoding.Decoder
+import kotlinx.serialization.encoding.Encoder
+import kotlinx.serialization.json.JsonElement
+
+@Serializable(PaidMedia.Companion::class)
+sealed interface PaidMedia {
+    val type: String
+
+    @Serializable
+    data class Preview(
+        @SerialName(widthField)
+        val width: Int? = null,
+        @SerialName(heightField)
+        val height: Int? = null,
+        @SerialName(durationField)
+        val duration: Int? = null
+    ) : PaidMedia {
+        @EncodeDefault
+        @SerialName(typeField)
+        override val type: String = Companion.type
+
+        companion object {
+            val type: String = "preview"
+        }
+    }
+
+    @Serializable
+    data class Photo(
+        @SerialName(photoField)
+        val photo: PhotoFile
+    ) : PaidMedia {
+        @EncodeDefault
+        @SerialName(typeField)
+        override val type: String = Companion.type
+
+        companion object {
+            val type: String = "photo"
+        }
+    }
+
+    @Serializable
+    data class Video(
+        @SerialName(videoField)
+        val video: VideoFile
+    ) : PaidMedia {
+        @EncodeDefault
+        @SerialName(typeField)
+        override val type: String = Companion.type
+
+        companion object {
+            val type: String = "video"
+        }
+    }
+
+    @Serializable(Companion::class)
+    data class Unknown(
+        @SerialName(typeField)
+        override val type: String,
+        val raw: JsonElement?
+    ) : PaidMedia
+
+    companion object : KSerializer<PaidMedia> {
+        @Serializable
+        private class Surrogate(
+            @SerialName(typeField)
+            val type: String,
+            @SerialName(widthField)
+            val width: Int? = null,
+            @SerialName(heightField)
+            val height: Int? = null,
+            @SerialName(durationField)
+            val duration: Int? = null,
+            @SerialName(photoField)
+            val photo: PhotoFile? = null,
+            @SerialName(videoField)
+            val video: VideoFile? = null
+        )
+
+        override val descriptor: SerialDescriptor
+            get() = Surrogate.serializer().descriptor
+
+        override fun deserialize(decoder: Decoder): PaidMedia {
+            val (data, json) = decoder.decodeDataAndJson(Surrogate.serializer())
+            val unknown by lazy {
+                Unknown(data.type, json)
+            }
+            return when (data.type) {
+                Preview.type -> Preview(
+                    data.width,
+                    data.height,
+                    data.duration
+                )
+                Photo.type -> Photo(
+                    data.photo ?: return unknown
+                )
+                Video.type -> Video(
+                    data.video ?: return unknown
+                )
+                else -> unknown
+            }
+        }
+
+        override fun serialize(encoder: Encoder, value: PaidMedia) {
+            if (value is Unknown && value.raw != null) {
+                JsonElement.serializer().serialize(encoder, value.raw)
+            } else {
+                val surrogate = Surrogate(
+                    value.type,
+                    (value as? Preview) ?.width,
+                    (value as? Preview) ?.height,
+                    (value as? Preview) ?.duration,
+                    (value as? Photo) ?.photo,
+                    (value as? Video) ?.video,
+                )
+                Surrogate.serializer().serialize(encoder, surrogate)
+            }
+        }
+
+    }
+}

tgbotapi.core/src/commonMain/kotlin/dev/inmo/tgbotapi/types/request/ChatShared.kt

@@ -1,7 +1,7 @@
 package dev.inmo.tgbotapi.types.request
 
 import dev.inmo.tgbotapi.types.*
-import dev.inmo.tgbotapi.types.files.Photo
+import dev.inmo.tgbotapi.types.files.PhotoFile
 import kotlinx.serialization.SerialName
 import kotlinx.serialization.Serializable
 
@@ -16,5 +16,5 @@ data class ChatShared(
     @SerialName(usernameField)
     val username: Username? = null,
     @SerialName(photoField)
-    val photo: Photo? = null
+    val photo: PhotoFile? = null
 ) : ChatSharedRequest

tgbotapi.core/src/commonMain/kotlin/dev/inmo/tgbotapi/types/request/SharedUser.kt

@@ -1,7 +1,7 @@
 package dev.inmo.tgbotapi.types.request
 
 import dev.inmo.tgbotapi.types.*
-import dev.inmo.tgbotapi.types.files.Photo
+import dev.inmo.tgbotapi.types.files.PhotoFile
 import kotlinx.serialization.SerialName
 import kotlinx.serialization.Serializable
 
@@ -16,5 +16,5 @@ data class SharedUser(
     @SerialName(usernameField)
     val username: Username? = null,
     @SerialName(photoField)
-    val photo: Photo? = null,
+    val photo: PhotoFile? = null,
 )

tgbotapi.core/src/commonTest/kotlin/dev/inmo/tgbotapi/SimpleInputFilesTest.kt

@@ -2,8 +2,8 @@ package dev.inmo.tgbotapi
 
 import dev.inmo.tgbotapi.requests.abstracts.toInputFile
 import dev.inmo.tgbotapi.types.TgFileUniqueId
-import dev.inmo.tgbotapi.types.files.Photo
-import dev.inmo.tgbotapi.types.media.MediaGroupMemberTelegramMediaSerializer
+import dev.inmo.tgbotapi.types.files.PhotoFile
+import dev.inmo.tgbotapi.types.media.MediaGroupMemberTelegramFreeMediaSerializer
 import dev.inmo.tgbotapi.types.files.PhotoSize
 import dev.inmo.tgbotapi.types.message.content.PhotoContent
 import kotlinx.serialization.json.Json
@@ -22,7 +22,7 @@ class SimpleInputFilesTest {
     @Test
     fun test_that_creating_of_photo_and_converting_to_input_media_working_correctly() {
         val photoContent = PhotoContent(
-            Photo(
+            PhotoFile(
                 listOf(
                     PhotoSize("example_file_id".toInputFile(), TgFileUniqueId("example_unique_file_id"), 100, 100, 100)
                 )
@@ -31,13 +31,13 @@ class SimpleInputFilesTest {
         val inputMedia = photoContent.toMediaGroupMemberTelegramMedia()
         assertEquals(photoContent.media.fileId, inputMedia.file)
         val encoded = nonstrictJsonFormat.encodeToString(
-            MediaGroupMemberTelegramMediaSerializer,
+            MediaGroupMemberTelegramFreeMediaSerializer,
             inputMedia
         )
         assertEquals(
             inputMedia,
             nonstrictJsonFormat.decodeFromString(
-                MediaGroupMemberTelegramMediaSerializer,
+                MediaGroupMemberTelegramFreeMediaSerializer,
                 encoded
             )
         )

tgbotapi.utils/src/commonMain/kotlin/dev/inmo/tgbotapi/extensions/utils/ClassCasts.kt

@@ -1999,141 +1999,141 @@ inline fun ChatMember.asSpecialRightsChatMember(): SpecialRightsChatMember? = th
 inline fun ChatMember.requireSpecialRightsChatMember(): SpecialRightsChatMember = this as SpecialRightsChatMember
 
 @PreviewFeature
-inline fun <T> TelegramMedia.whenAudioMediaGroupMemberTelegramMedia(block: (AudioMediaGroupMemberTelegramMedia) -> T) =
+inline fun <T> TelegramFreeMedia.whenAudioMediaGroupMemberTelegramMedia(block: (AudioMediaGroupMemberTelegramMedia) -> T) =
     asAudioMediaGroupMemberTelegramMedia()?.let(block)
 
 @PreviewFeature
-inline fun TelegramMedia.asAudioMediaGroupMemberTelegramMedia(): AudioMediaGroupMemberTelegramMedia? =
+inline fun TelegramFreeMedia.asAudioMediaGroupMemberTelegramMedia(): AudioMediaGroupMemberTelegramMedia? =
     this as? AudioMediaGroupMemberTelegramMedia
 
 @PreviewFeature
-inline fun TelegramMedia.requireAudioMediaGroupMemberTelegramMedia(): AudioMediaGroupMemberTelegramMedia =
+inline fun TelegramFreeMedia.requireAudioMediaGroupMemberTelegramMedia(): AudioMediaGroupMemberTelegramMedia =
     this as AudioMediaGroupMemberTelegramMedia
 
 @PreviewFeature
-inline fun <T> TelegramMedia.whenDocumentMediaGroupMemberTelegramMedia(block: (DocumentMediaGroupMemberTelegramMedia) -> T) =
+inline fun <T> TelegramFreeMedia.whenDocumentMediaGroupMemberTelegramMedia(block: (DocumentMediaGroupMemberTelegramMedia) -> T) =
     asDocumentMediaGroupMemberTelegramMedia()?.let(block)
 
 @PreviewFeature
-inline fun TelegramMedia.asDocumentMediaGroupMemberTelegramMedia(): DocumentMediaGroupMemberTelegramMedia? =
+inline fun TelegramFreeMedia.asDocumentMediaGroupMemberTelegramMedia(): DocumentMediaGroupMemberTelegramMedia? =
     this as? DocumentMediaGroupMemberTelegramMedia
 
 @PreviewFeature
-inline fun TelegramMedia.requireDocumentMediaGroupMemberTelegramMedia(): DocumentMediaGroupMemberTelegramMedia =
+inline fun TelegramFreeMedia.requireDocumentMediaGroupMemberTelegramMedia(): DocumentMediaGroupMemberTelegramMedia =
     this as DocumentMediaGroupMemberTelegramMedia
 
 @PreviewFeature
-inline fun <T> TelegramMedia.whenDuratedTelegramMedia(block: (DuratedTelegramMedia) -> T) =
+inline fun <T> TelegramFreeMedia.whenDuratedTelegramMedia(block: (DuratedTelegramMedia) -> T) =
     asDuratedTelegramMedia()?.let(block)
 
 @PreviewFeature
-inline fun TelegramMedia.asDuratedTelegramMedia(): DuratedTelegramMedia? = this as? DuratedTelegramMedia
+inline fun TelegramFreeMedia.asDuratedTelegramMedia(): DuratedTelegramMedia? = this as? DuratedTelegramMedia
 
 @PreviewFeature
-inline fun TelegramMedia.requireDuratedTelegramMedia(): DuratedTelegramMedia = this as DuratedTelegramMedia
+inline fun TelegramFreeMedia.requireDuratedTelegramMedia(): DuratedTelegramMedia = this as DuratedTelegramMedia
 
 @PreviewFeature
-inline fun <T> TelegramMedia.whenTelegramMediaAnimation(block: (TelegramMediaAnimation) -> T) =
+inline fun <T> TelegramFreeMedia.whenTelegramMediaAnimation(block: (TelegramMediaAnimation) -> T) =
     asTelegramMediaAnimation()?.let(block)
 
 @PreviewFeature
-inline fun TelegramMedia.asTelegramMediaAnimation(): TelegramMediaAnimation? = this as? TelegramMediaAnimation
+inline fun TelegramFreeMedia.asTelegramMediaAnimation(): TelegramMediaAnimation? = this as? TelegramMediaAnimation
 
 @PreviewFeature
-inline fun TelegramMedia.requireTelegramMediaAnimation(): TelegramMediaAnimation = this as TelegramMediaAnimation
+inline fun TelegramFreeMedia.requireTelegramMediaAnimation(): TelegramMediaAnimation = this as TelegramMediaAnimation
 
 @PreviewFeature
-inline fun <T> TelegramMedia.whenTelegramMediaAudio(block: (TelegramMediaAudio) -> T) =
+inline fun <T> TelegramFreeMedia.whenTelegramMediaAudio(block: (TelegramMediaAudio) -> T) =
     asTelegramMediaAudio()?.let(block)
 
 @PreviewFeature
-inline fun TelegramMedia.asTelegramMediaAudio(): TelegramMediaAudio? = this as? TelegramMediaAudio
+inline fun TelegramFreeMedia.asTelegramMediaAudio(): TelegramMediaAudio? = this as? TelegramMediaAudio
 
 @PreviewFeature
-inline fun TelegramMedia.requireTelegramMediaAudio(): TelegramMediaAudio = this as TelegramMediaAudio
+inline fun TelegramFreeMedia.requireTelegramMediaAudio(): TelegramMediaAudio = this as TelegramMediaAudio
 
 @PreviewFeature
-inline fun <T> TelegramMedia.whenTelegramMediaDocument(block: (TelegramMediaDocument) -> T) =
+inline fun <T> TelegramFreeMedia.whenTelegramMediaDocument(block: (TelegramMediaDocument) -> T) =
     asTelegramMediaDocument()?.let(block)
 
 @PreviewFeature
-inline fun TelegramMedia.asTelegramMediaDocument(): TelegramMediaDocument? = this as? TelegramMediaDocument
+inline fun TelegramFreeMedia.asTelegramMediaDocument(): TelegramMediaDocument? = this as? TelegramMediaDocument
 
 @PreviewFeature
-inline fun TelegramMedia.requireTelegramMediaDocument(): TelegramMediaDocument = this as TelegramMediaDocument
+inline fun TelegramFreeMedia.requireTelegramMediaDocument(): TelegramMediaDocument = this as TelegramMediaDocument
 
 @PreviewFeature
-inline fun <T> TelegramMedia.whenTelegramMediaPhoto(block: (TelegramMediaPhoto) -> T) =
+inline fun <T> TelegramFreeMedia.whenTelegramMediaPhoto(block: (TelegramMediaPhoto) -> T) =
     asTelegramMediaPhoto()?.let(block)
 
 @PreviewFeature
-inline fun TelegramMedia.asTelegramMediaPhoto(): TelegramMediaPhoto? = this as? TelegramMediaPhoto
+inline fun TelegramFreeMedia.asTelegramMediaPhoto(): TelegramMediaPhoto? = this as? TelegramMediaPhoto
 
 @PreviewFeature
-inline fun TelegramMedia.requireTelegramMediaPhoto(): TelegramMediaPhoto = this as TelegramMediaPhoto
+inline fun TelegramFreeMedia.requireTelegramMediaPhoto(): TelegramMediaPhoto = this as TelegramMediaPhoto
 
 @PreviewFeature
-inline fun <T> TelegramMedia.whenTelegramMediaVideo(block: (TelegramMediaVideo) -> T) =
+inline fun <T> TelegramFreeMedia.whenTelegramMediaVideo(block: (TelegramMediaVideo) -> T) =
     asTelegramMediaVideo()?.let(block)
 
 @PreviewFeature
-inline fun TelegramMedia.asTelegramMediaVideo(): TelegramMediaVideo? = this as? TelegramMediaVideo
+inline fun TelegramFreeMedia.asTelegramMediaVideo(): TelegramMediaVideo? = this as? TelegramMediaVideo
 
 @PreviewFeature
-inline fun TelegramMedia.requireTelegramMediaVideo(): TelegramMediaVideo = this as TelegramMediaVideo
+inline fun TelegramFreeMedia.requireTelegramMediaVideo(): TelegramMediaVideo = this as TelegramMediaVideo
 
 @PreviewFeature
-inline fun <T> TelegramMedia.whenMediaGroupMemberTelegramMedia(block: (MediaGroupMemberTelegramMedia) -> T) =
+inline fun <T> TelegramFreeMedia.whenMediaGroupMemberTelegramMedia(block: (MediaGroupMemberTelegramMedia) -> T) =
     asMediaGroupMemberTelegramMedia()?.let(block)
 
 @PreviewFeature
-inline fun TelegramMedia.asMediaGroupMemberTelegramMedia(): MediaGroupMemberTelegramMedia? =
+inline fun TelegramFreeMedia.asMediaGroupMemberTelegramMedia(): MediaGroupMemberTelegramMedia? =
     this as? MediaGroupMemberTelegramMedia
 
 @PreviewFeature
-inline fun TelegramMedia.requireMediaGroupMemberTelegramMedia(): MediaGroupMemberTelegramMedia =
+inline fun TelegramFreeMedia.requireMediaGroupMemberTelegramMedia(): MediaGroupMemberTelegramMedia =
     this as MediaGroupMemberTelegramMedia
 
 @PreviewFeature
-inline fun <T> TelegramMedia.whenSizedTelegramMedia(block: (SizedTelegramMedia) -> T) =
+inline fun <T> TelegramFreeMedia.whenSizedTelegramMedia(block: (SizedTelegramMedia) -> T) =
     asSizedTelegramMedia()?.let(block)
 
 @PreviewFeature
-inline fun TelegramMedia.asSizedTelegramMedia(): SizedTelegramMedia? = this as? SizedTelegramMedia
+inline fun TelegramFreeMedia.asSizedTelegramMedia(): SizedTelegramMedia? = this as? SizedTelegramMedia
 
 @PreviewFeature
-inline fun TelegramMedia.requireSizedTelegramMedia(): SizedTelegramMedia = this as SizedTelegramMedia
+inline fun TelegramFreeMedia.requireSizedTelegramMedia(): SizedTelegramMedia = this as SizedTelegramMedia
 
 @PreviewFeature
-inline fun <T> TelegramMedia.whenThumbedTelegramMedia(block: (ThumbedTelegramMedia) -> T) =
+inline fun <T> TelegramFreeMedia.whenThumbedTelegramMedia(block: (ThumbedTelegramMedia) -> T) =
     asThumbedTelegramMedia()?.let(block)
 
 @PreviewFeature
-inline fun TelegramMedia.asThumbedTelegramMedia(): ThumbedTelegramMedia? = this as? ThumbedTelegramMedia
+inline fun TelegramFreeMedia.asThumbedTelegramMedia(): ThumbedTelegramMedia? = this as? ThumbedTelegramMedia
 
 @PreviewFeature
-inline fun TelegramMedia.requireThumbedTelegramMedia(): ThumbedTelegramMedia = this as ThumbedTelegramMedia
+inline fun TelegramFreeMedia.requireThumbedTelegramMedia(): ThumbedTelegramMedia = this as ThumbedTelegramMedia
 
 @PreviewFeature
-inline fun <T> TelegramMedia.whenTitledTelegramMedia(block: (TitledTelegramMedia) -> T) =
+inline fun <T> TelegramFreeMedia.whenTitledTelegramMedia(block: (TitledTelegramMedia) -> T) =
     asTitledTelegramMedia()?.let(block)
 
 @PreviewFeature
-inline fun TelegramMedia.asTitledTelegramMedia(): TitledTelegramMedia? = this as? TitledTelegramMedia
+inline fun TelegramFreeMedia.asTitledTelegramMedia(): TitledTelegramMedia? = this as? TitledTelegramMedia
 
 @PreviewFeature
-inline fun TelegramMedia.requireTitledTelegramMedia(): TitledTelegramMedia = this as TitledTelegramMedia
+inline fun TelegramFreeMedia.requireTitledTelegramMedia(): TitledTelegramMedia = this as TitledTelegramMedia
 
 @PreviewFeature
-inline fun <T> TelegramMedia.whenVisualMediaGroupMemberTelegramMedia(block: (VisualMediaGroupMemberTelegramMedia) -> T) =
+inline fun <T> TelegramFreeMedia.whenVisualMediaGroupMemberTelegramMedia(block: (VisualMediaGroupMemberTelegramMedia) -> T) =
     asVisualMediaGroupMemberTelegramMedia()?.let(block)
 
 @PreviewFeature
-inline fun TelegramMedia.asVisualMediaGroupMemberTelegramMedia(): VisualMediaGroupMemberTelegramMedia? =
+inline fun TelegramFreeMedia.asVisualMediaGroupMemberTelegramMedia(): VisualMediaGroupMemberTelegramMedia? =
     this as? VisualMediaGroupMemberTelegramMedia
 
 @PreviewFeature
-inline fun TelegramMedia.requireVisualMediaGroupMemberTelegramMedia(): VisualMediaGroupMemberTelegramMedia =
+inline fun TelegramFreeMedia.requireVisualMediaGroupMemberTelegramMedia(): VisualMediaGroupMemberTelegramMedia =
     this as VisualMediaGroupMemberTelegramMedia
 
 @PreviewFeature

tgbotapi.utils/src/commonMain/kotlin/dev/inmo/tgbotapi/extensions/utils/ClassCastsNew.kt

@@ -193,7 +193,7 @@ import dev.inmo.tgbotapi.types.files.MediaContentVariant
 import dev.inmo.tgbotapi.types.files.MimedMediaFile
 import dev.inmo.tgbotapi.types.files.PassportFile
 import dev.inmo.tgbotapi.types.files.PathedFile
-import dev.inmo.tgbotapi.types.files.Photo
+import dev.inmo.tgbotapi.types.files.PhotoFile
 import dev.inmo.tgbotapi.types.files.PhotoSize
 import dev.inmo.tgbotapi.types.files.PlayableMediaFile
 import dev.inmo.tgbotapi.types.files.RegularAnimatedSticker
@@ -220,7 +220,7 @@ import dev.inmo.tgbotapi.types.media.DuratedTelegramMedia
 import dev.inmo.tgbotapi.types.media.MediaGroupMemberTelegramMedia
 import dev.inmo.tgbotapi.types.media.SizedTelegramMedia
 import dev.inmo.tgbotapi.types.media.SpoilerableTelegramMedia
-import dev.inmo.tgbotapi.types.media.TelegramMedia
+import dev.inmo.tgbotapi.types.media.TelegramFreeMedia
 import dev.inmo.tgbotapi.types.media.TelegramMediaAnimation
 import dev.inmo.tgbotapi.types.media.TelegramMediaAudio
 import dev.inmo.tgbotapi.types.media.TelegramMediaDocument
@@ -2707,13 +2707,13 @@ public inline fun TelegramMediaFile.pathedFileOrThrow(): PathedFile = this as
 public inline fun <T> TelegramMediaFile.ifPathedFile(block: (PathedFile) -> T): T? =
     pathedFileOrNull() ?.let(block)
 
-public inline fun TelegramMediaFile.photoOrNull(): Photo? = this as?
-    dev.inmo.tgbotapi.types.files.Photo
+public inline fun TelegramMediaFile.photoOrNull(): PhotoFile? = this as?
+    dev.inmo.tgbotapi.types.files.PhotoFile
 
-public inline fun TelegramMediaFile.photoOrThrow(): Photo = this as
-    dev.inmo.tgbotapi.types.files.Photo
+public inline fun TelegramMediaFile.photoOrThrow(): PhotoFile = this as
+    dev.inmo.tgbotapi.types.files.PhotoFile
 
-public inline fun <T> TelegramMediaFile.ifPhoto(block: (Photo) -> T): T? = photoOrNull()
+public inline fun <T> TelegramMediaFile.ifPhoto(block: (PhotoFile) -> T): T? = photoOrNull()
     ?.let(block)
 
 public inline fun TelegramMediaFile.photoSizeOrNull(): PhotoSize? = this as?
@@ -2945,155 +2945,155 @@ public inline fun Location.liveLocationOrThrow(): LiveLocation = this as
 public inline fun <T> Location.ifLiveLocation(block: (LiveLocation) -> T): T? = liveLocationOrNull()
     ?.let(block)
 
-public inline fun TelegramMedia.duratedTelegramMediaOrNull(): DuratedTelegramMedia? = this as?
+public inline fun TelegramFreeMedia.duratedTelegramMediaOrNull(): DuratedTelegramMedia? = this as?
     dev.inmo.tgbotapi.types.media.DuratedTelegramMedia
 
-public inline fun TelegramMedia.duratedTelegramMediaOrThrow(): DuratedTelegramMedia = this as
+public inline fun TelegramFreeMedia.duratedTelegramMediaOrThrow(): DuratedTelegramMedia = this as
     dev.inmo.tgbotapi.types.media.DuratedTelegramMedia
 
-public inline fun <T> TelegramMedia.ifDuratedTelegramMedia(block: (DuratedTelegramMedia) -> T): T? =
+public inline fun <T> TelegramFreeMedia.ifDuratedTelegramMedia(block: (DuratedTelegramMedia) -> T): T? =
     duratedTelegramMediaOrNull() ?.let(block)
 
-public inline fun TelegramMedia.mediaGroupMemberTelegramMediaOrNull():
+public inline fun TelegramFreeMedia.mediaGroupMemberTelegramMediaOrNull():
     MediaGroupMemberTelegramMedia? = this as?
     dev.inmo.tgbotapi.types.media.MediaGroupMemberTelegramMedia
 
-public inline fun TelegramMedia.mediaGroupMemberTelegramMediaOrThrow():
+public inline fun TelegramFreeMedia.mediaGroupMemberTelegramMediaOrThrow():
     MediaGroupMemberTelegramMedia = this as
     dev.inmo.tgbotapi.types.media.MediaGroupMemberTelegramMedia
 
 public inline fun <T>
-    TelegramMedia.ifMediaGroupMemberTelegramMedia(block: (MediaGroupMemberTelegramMedia) -> T): T? =
+    TelegramFreeMedia.ifMediaGroupMemberTelegramMedia(block: (MediaGroupMemberTelegramMedia) -> T): T? =
     mediaGroupMemberTelegramMediaOrNull() ?.let(block)
 
-public inline fun TelegramMedia.audioMediaGroupMemberTelegramMediaOrNull():
+public inline fun TelegramFreeMedia.audioMediaGroupMemberTelegramMediaOrNull():
     AudioMediaGroupMemberTelegramMedia? = this as?
     dev.inmo.tgbotapi.types.media.AudioMediaGroupMemberTelegramMedia
 
-public inline fun TelegramMedia.audioMediaGroupMemberTelegramMediaOrThrow():
+public inline fun TelegramFreeMedia.audioMediaGroupMemberTelegramMediaOrThrow():
     AudioMediaGroupMemberTelegramMedia = this as
     dev.inmo.tgbotapi.types.media.AudioMediaGroupMemberTelegramMedia
 
 public inline fun <T>
-    TelegramMedia.ifAudioMediaGroupMemberTelegramMedia(block: (AudioMediaGroupMemberTelegramMedia) -> T):
+    TelegramFreeMedia.ifAudioMediaGroupMemberTelegramMedia(block: (AudioMediaGroupMemberTelegramMedia) -> T):
     T? = audioMediaGroupMemberTelegramMediaOrNull() ?.let(block)
 
-public inline fun TelegramMedia.documentMediaGroupMemberTelegramMediaOrNull():
+public inline fun TelegramFreeMedia.documentMediaGroupMemberTelegramMediaOrNull():
     DocumentMediaGroupMemberTelegramMedia? = this as?
     dev.inmo.tgbotapi.types.media.DocumentMediaGroupMemberTelegramMedia
 
-public inline fun TelegramMedia.documentMediaGroupMemberTelegramMediaOrThrow():
+public inline fun TelegramFreeMedia.documentMediaGroupMemberTelegramMediaOrThrow():
     DocumentMediaGroupMemberTelegramMedia = this as
     dev.inmo.tgbotapi.types.media.DocumentMediaGroupMemberTelegramMedia
 
 public inline fun <T>
-    TelegramMedia.ifDocumentMediaGroupMemberTelegramMedia(block: (DocumentMediaGroupMemberTelegramMedia) -> T):
+    TelegramFreeMedia.ifDocumentMediaGroupMemberTelegramMedia(block: (DocumentMediaGroupMemberTelegramMedia) -> T):
     T? = documentMediaGroupMemberTelegramMediaOrNull() ?.let(block)
 
-public inline fun TelegramMedia.visualMediaGroupMemberTelegramMediaOrNull():
+public inline fun TelegramFreeMedia.visualMediaGroupMemberTelegramMediaOrNull():
     VisualMediaGroupMemberTelegramMedia? = this as?
     dev.inmo.tgbotapi.types.media.VisualMediaGroupMemberTelegramMedia
 
-public inline fun TelegramMedia.visualMediaGroupMemberTelegramMediaOrThrow():
+public inline fun TelegramFreeMedia.visualMediaGroupMemberTelegramMediaOrThrow():
     VisualMediaGroupMemberTelegramMedia = this as
     dev.inmo.tgbotapi.types.media.VisualMediaGroupMemberTelegramMedia
 
 public inline fun <T>
-    TelegramMedia.ifVisualMediaGroupMemberTelegramMedia(block: (VisualMediaGroupMemberTelegramMedia) -> T):
+    TelegramFreeMedia.ifVisualMediaGroupMemberTelegramMedia(block: (VisualMediaGroupMemberTelegramMedia) -> T):
     T? = visualMediaGroupMemberTelegramMediaOrNull() ?.let(block)
 
-public inline fun TelegramMedia.sizedTelegramMediaOrNull(): SizedTelegramMedia? = this as?
+public inline fun TelegramFreeMedia.sizedTelegramMediaOrNull(): SizedTelegramMedia? = this as?
     dev.inmo.tgbotapi.types.media.SizedTelegramMedia
 
-public inline fun TelegramMedia.sizedTelegramMediaOrThrow(): SizedTelegramMedia = this as
+public inline fun TelegramFreeMedia.sizedTelegramMediaOrThrow(): SizedTelegramMedia = this as
     dev.inmo.tgbotapi.types.media.SizedTelegramMedia
 
-public inline fun <T> TelegramMedia.ifSizedTelegramMedia(block: (SizedTelegramMedia) -> T): T? =
+public inline fun <T> TelegramFreeMedia.ifSizedTelegramMedia(block: (SizedTelegramMedia) -> T): T? =
     sizedTelegramMediaOrNull() ?.let(block)
 
-public inline fun TelegramMedia.spoilerableTelegramMediaOrNull(): SpoilerableTelegramMedia? = this
+public inline fun TelegramFreeMedia.spoilerableTelegramMediaOrNull(): SpoilerableTelegramMedia? = this
     as? dev.inmo.tgbotapi.types.media.SpoilerableTelegramMedia
 
-public inline fun TelegramMedia.spoilerableTelegramMediaOrThrow(): SpoilerableTelegramMedia = this
+public inline fun TelegramFreeMedia.spoilerableTelegramMediaOrThrow(): SpoilerableTelegramMedia = this
     as dev.inmo.tgbotapi.types.media.SpoilerableTelegramMedia
 
 public inline fun <T>
-    TelegramMedia.ifSpoilerableTelegramMedia(block: (SpoilerableTelegramMedia) -> T): T? =
+    TelegramFreeMedia.ifSpoilerableTelegramMedia(block: (SpoilerableTelegramMedia) -> T): T? =
     spoilerableTelegramMediaOrNull() ?.let(block)
 
-public inline fun TelegramMedia.telegramMediaAnimationOrNull(): TelegramMediaAnimation? = this as?
+public inline fun TelegramFreeMedia.telegramMediaAnimationOrNull(): TelegramMediaAnimation? = this as?
     dev.inmo.tgbotapi.types.media.TelegramMediaAnimation
 
-public inline fun TelegramMedia.telegramMediaAnimationOrThrow(): TelegramMediaAnimation = this as
+public inline fun TelegramFreeMedia.telegramMediaAnimationOrThrow(): TelegramMediaAnimation = this as
     dev.inmo.tgbotapi.types.media.TelegramMediaAnimation
 
-public inline fun <T> TelegramMedia.ifTelegramMediaAnimation(block: (TelegramMediaAnimation) -> T):
+public inline fun <T> TelegramFreeMedia.ifTelegramMediaAnimation(block: (TelegramMediaAnimation) -> T):
     T? = telegramMediaAnimationOrNull() ?.let(block)
 
-public inline fun TelegramMedia.telegramMediaAudioOrNull(): TelegramMediaAudio? = this as?
+public inline fun TelegramFreeMedia.telegramMediaAudioOrNull(): TelegramMediaAudio? = this as?
     dev.inmo.tgbotapi.types.media.TelegramMediaAudio
 
-public inline fun TelegramMedia.telegramMediaAudioOrThrow(): TelegramMediaAudio = this as
+public inline fun TelegramFreeMedia.telegramMediaAudioOrThrow(): TelegramMediaAudio = this as
     dev.inmo.tgbotapi.types.media.TelegramMediaAudio
 
-public inline fun <T> TelegramMedia.ifTelegramMediaAudio(block: (TelegramMediaAudio) -> T): T? =
+public inline fun <T> TelegramFreeMedia.ifTelegramMediaAudio(block: (TelegramMediaAudio) -> T): T? =
     telegramMediaAudioOrNull() ?.let(block)
 
-public inline fun TelegramMedia.telegramMediaDocumentOrNull(): TelegramMediaDocument? = this as?
+public inline fun TelegramFreeMedia.telegramMediaDocumentOrNull(): TelegramMediaDocument? = this as?
     dev.inmo.tgbotapi.types.media.TelegramMediaDocument
 
-public inline fun TelegramMedia.telegramMediaDocumentOrThrow(): TelegramMediaDocument = this as
+public inline fun TelegramFreeMedia.telegramMediaDocumentOrThrow(): TelegramMediaDocument = this as
     dev.inmo.tgbotapi.types.media.TelegramMediaDocument
 
-public inline fun <T> TelegramMedia.ifTelegramMediaDocument(block: (TelegramMediaDocument) -> T): T?
+public inline fun <T> TelegramFreeMedia.ifTelegramMediaDocument(block: (TelegramMediaDocument) -> T): T?
     = telegramMediaDocumentOrNull() ?.let(block)
 
-public inline fun TelegramMedia.telegramMediaPhotoOrNull(): TelegramMediaPhoto? = this as?
+public inline fun TelegramFreeMedia.telegramMediaPhotoOrNull(): TelegramMediaPhoto? = this as?
     dev.inmo.tgbotapi.types.media.TelegramMediaPhoto
 
-public inline fun TelegramMedia.telegramMediaPhotoOrThrow(): TelegramMediaPhoto = this as
+public inline fun TelegramFreeMedia.telegramMediaPhotoOrThrow(): TelegramMediaPhoto = this as
     dev.inmo.tgbotapi.types.media.TelegramMediaPhoto
 
-public inline fun <T> TelegramMedia.ifTelegramMediaPhoto(block: (TelegramMediaPhoto) -> T): T? =
+public inline fun <T> TelegramFreeMedia.ifTelegramMediaPhoto(block: (TelegramMediaPhoto) -> T): T? =
     telegramMediaPhotoOrNull() ?.let(block)
 
-public inline fun TelegramMedia.telegramMediaVideoOrNull(): TelegramMediaVideo? = this as?
+public inline fun TelegramFreeMedia.telegramMediaVideoOrNull(): TelegramMediaVideo? = this as?
     dev.inmo.tgbotapi.types.media.TelegramMediaVideo
 
-public inline fun TelegramMedia.telegramMediaVideoOrThrow(): TelegramMediaVideo = this as
+public inline fun TelegramFreeMedia.telegramMediaVideoOrThrow(): TelegramMediaVideo = this as
     dev.inmo.tgbotapi.types.media.TelegramMediaVideo
 
-public inline fun <T> TelegramMedia.ifTelegramMediaVideo(block: (TelegramMediaVideo) -> T): T? =
+public inline fun <T> TelegramFreeMedia.ifTelegramMediaVideo(block: (TelegramMediaVideo) -> T): T? =
     telegramMediaVideoOrNull() ?.let(block)
 
-public inline fun TelegramMedia.thumbedTelegramMediaOrNull(): ThumbedTelegramMedia? = this as?
+public inline fun TelegramFreeMedia.thumbedTelegramMediaOrNull(): ThumbedTelegramMedia? = this as?
     dev.inmo.tgbotapi.types.media.ThumbedTelegramMedia
 
-public inline fun TelegramMedia.thumbedTelegramMediaOrThrow(): ThumbedTelegramMedia = this as
+public inline fun TelegramFreeMedia.thumbedTelegramMediaOrThrow(): ThumbedTelegramMedia = this as
     dev.inmo.tgbotapi.types.media.ThumbedTelegramMedia
 
-public inline fun <T> TelegramMedia.ifThumbedTelegramMedia(block: (ThumbedTelegramMedia) -> T): T? =
+public inline fun <T> TelegramFreeMedia.ifThumbedTelegramMedia(block: (ThumbedTelegramMedia) -> T): T? =
     thumbedTelegramMediaOrNull() ?.let(block)
 
-public inline fun TelegramMedia.titledTelegramMediaOrNull(): TitledTelegramMedia? = this as?
+public inline fun TelegramFreeMedia.titledTelegramMediaOrNull(): TitledTelegramMedia? = this as?
     dev.inmo.tgbotapi.types.media.TitledTelegramMedia
 
-public inline fun TelegramMedia.titledTelegramMediaOrThrow(): TitledTelegramMedia = this as
+public inline fun TelegramFreeMedia.titledTelegramMediaOrThrow(): TitledTelegramMedia = this as
     dev.inmo.tgbotapi.types.media.TitledTelegramMedia
 
-public inline fun <T> TelegramMedia.ifTitledTelegramMedia(block: (TitledTelegramMedia) -> T): T? =
+public inline fun <T> TelegramFreeMedia.ifTitledTelegramMedia(block: (TitledTelegramMedia) -> T): T? =
     titledTelegramMediaOrNull() ?.let(block)
 
-public inline fun TelegramMedia.withCustomizableCaptionTelegramMediaOrNull():
+public inline fun TelegramFreeMedia.withCustomizableCaptionTelegramMediaOrNull():
     WithCustomizableCaptionTelegramMedia? = this as?
     dev.inmo.tgbotapi.types.media.WithCustomizableCaptionTelegramMedia
 
-public inline fun TelegramMedia.withCustomizableCaptionTelegramMediaOrThrow():
+public inline fun TelegramFreeMedia.withCustomizableCaptionTelegramMediaOrThrow():
     WithCustomizableCaptionTelegramMedia = this as
     dev.inmo.tgbotapi.types.media.WithCustomizableCaptionTelegramMedia
 
 public inline fun <T>
-    TelegramMedia.ifWithCustomizableCaptionTelegramMedia(block: (WithCustomizableCaptionTelegramMedia) -> T):
+    TelegramFreeMedia.ifWithCustomizableCaptionTelegramMedia(block: (WithCustomizableCaptionTelegramMedia) -> T):
     T? = withCustomizableCaptionTelegramMediaOrNull() ?.let(block)
 
 public inline fun ChatEvent.chatBackgroundOrNull(): ChatBackground? = this as?

tgbotapi.utils/src/commonMain/kotlin/dev/inmo/tgbotapi/extensions/utils/extensions/raw/Message.kt

@@ -103,7 +103,7 @@ inline val Message.animation: AnimationFile?
 inline val Message.game: Game?
     get() = asContentMessage() ?.content ?.asGameContent() ?.game
 @RiskFeature(RawFieldsUsageWarning)
-inline val Message.photo: Photo?
+inline val Message.photo: PhotoFile?
     get() = asContentMessage() ?.content ?.asPhotoContent() ?.mediaCollection
 @RiskFeature(RawFieldsUsageWarning)
 inline val Message.sticker: Sticker?
@@ -145,7 +145,7 @@ inline val Message.left_chat_member: User?
 inline val Message.new_chat_title: String?
     get() = asChatEventMessage() ?.chatEvent ?.asNewChatTitle() ?.title
 @RiskFeature(RawFieldsUsageWarning)
-inline val Message.new_chat_photo: Photo?
+inline val Message.new_chat_photo: PhotoFile?
     get() = asChatEventMessage() ?.chatEvent ?.asNewChatPhoto() ?.photo
 @RiskFeature(RawFieldsUsageWarning)
 inline val Message.delete_chat_photo: Boolean