temporal progress on adding support of paid media

2025-09-14 21:00:15 +00:00 · 2024-07-08 00:18:54 +06:00
parent 0d4452d0f5
commit 1eef5bb239
33 changed files with 535 additions and 140 deletions
--- a/tgbotapi.core/src/commonMain/kotlin/dev/inmo/tgbotapi/requests/edit/abstracts/EditMediaMessage.kt
+++ b/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
 }
--- a/tgbotapi.core/src/commonMain/kotlin/dev/inmo/tgbotapi/requests/edit/media/EditChatMessageMedia.kt
+++ b/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)
--- a/tgbotapi.core/src/commonMain/kotlin/dev/inmo/tgbotapi/requests/edit/media/EditInlineMessageMedia.kt
+++ b/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 {
--- a/tgbotapi.core/src/commonMain/kotlin/dev/inmo/tgbotapi/requests/send/media/SendMediaGroup.kt
+++ b/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()

--- a/tgbotapi.core/src/commonMain/kotlin/dev/inmo/tgbotapi/requests/send/media/SendPaidMediaGroup.kt
+++ b/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())
--- a/tgbotapi.core/src/commonMain/kotlin/dev/inmo/tgbotapi/types/Common.kt
+++ b/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"
--- a/tgbotapi.core/src/commonMain/kotlin/dev/inmo/tgbotapi/types/files/PhotoSize.kt
+++ b/tgbotapi.core/src/commonMain/kotlin/dev/inmo/tgbotapi/types/files/PhotoSize.kt
@@ -10,7 +10,7 @@ import kotlin.jvm.JvmInline
@JvmInline
 value class Photo(
    val photos: List<PhotoSize>
-) : List<PhotoSize> by photos, MediaContentVariant {
+) : List<PhotoSize> by photos, MediaContentVariant, UsefulAsPaidMediaFile {
    val biggest: PhotoSize
        get() = biggest()!!
    override val fileId: FileId
--- a/tgbotapi.core/src/commonMain/kotlin/dev/inmo/tgbotapi/types/files/UsefulAsPaidMediaFile.kt
+++ b/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
--- a/tgbotapi.core/src/commonMain/kotlin/dev/inmo/tgbotapi/types/files/VideoFile.kt
+++ b/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
+)
--- a/tgbotapi.core/src/commonMain/kotlin/dev/inmo/tgbotapi/types/media/MediaGroupMemberTelegramFreeMediaSerializer.kt
+++ b/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
--- a/tgbotapi.core/src/commonMain/kotlin/dev/inmo/tgbotapi/types/media/MediaGroupMemberTelegramMedia.kt
+++ b/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
--- a/tgbotapi.core/src/commonMain/kotlin/dev/inmo/tgbotapi/types/media/MediaGroupMemberTelegramPaidMediaSerializer.kt
+++ b/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")
+        }
+    }
+}
--- a/tgbotapi.core/src/commonMain/kotlin/dev/inmo/tgbotapi/types/payments/stars/PaidMedia.kt
+++ b/tgbotapi.core/src/commonMain/kotlin/dev/inmo/tgbotapi/types/payments/stars/PaidMedia.kt
@@ -1,7 +1,7 @@
-package dev.inmo.tgbotapi.types.payments.stars
+package dev.inmo.tgbotapi.types.media

 import dev.inmo.tgbotapi.types.*
-import dev.inmo.tgbotapi.types.files.PhotoSize
+import dev.inmo.tgbotapi.types.files.VideoFile
 import dev.inmo.tgbotapi.utils.decodeDataAndJson
 import kotlinx.serialization.EncodeDefault
 import kotlinx.serialization.KSerializer
@@ -13,9 +13,7 @@ import kotlinx.serialization.encoding.Encoder
 import kotlinx.serialization.json.JsonElement

@Serializable(PaidMedia.Companion::class)
-sealed interface PaidMedia {
-    val type: String
-
+sealed interface PaidMedia : TelegramMedia {
    @Serializable
    data class Preview(
        @SerialName(widthField)
@@ -51,7 +49,7 @@ sealed interface PaidMedia {
    @Serializable
    data class Video(
        @SerialName(videoField)
-        val video: Video
+        val video: VideoFile
    ) : PaidMedia {
        @EncodeDefault
        @SerialName(typeField)
@@ -62,7 +60,7 @@ sealed interface PaidMedia {
        }
    }

-    @Serializable(PaidMedia.Companion::class)
+    @Serializable(Companion::class)
    data class Unknown(
        @SerialName(typeField)
        override val type: String,
--- a/tgbotapi.core/src/commonMain/kotlin/dev/inmo/tgbotapi/types/media/TelegramFreeMedia.kt
+++ b/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
--- a/tgbotapi.core/src/commonMain/kotlin/dev/inmo/tgbotapi/types/media/TelegramMediaAnimation.kt
+++ b/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)
--- a/tgbotapi.core/src/commonMain/kotlin/dev/inmo/tgbotapi/types/media/TelegramMediaAudio.kt
+++ b/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 {
--- a/tgbotapi.core/src/commonMain/kotlin/dev/inmo/tgbotapi/types/media/TelegramMediaDocument.kt
+++ b/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)
--- a/tgbotapi.core/src/commonMain/kotlin/dev/inmo/tgbotapi/types/media/TelegramMediaPhoto.kt
+++ b/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)
--- a/tgbotapi.core/src/commonMain/kotlin/dev/inmo/tgbotapi/types/media/TelegramMediaSerializer.kt
+++ b/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)
        }
    }

--- a/tgbotapi.core/src/commonMain/kotlin/dev/inmo/tgbotapi/types/media/TelegramMediaVideo.kt
+++ b/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)
--- a/tgbotapi.core/src/commonMain/kotlin/dev/inmo/tgbotapi/types/media/TelegramPaidMedia.kt
+++ b/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
--- a/tgbotapi.core/src/commonMain/kotlin/dev/inmo/tgbotapi/types/media/TelegramPaidMediaPhoto.kt
+++ b/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,
+)
--- a/tgbotapi.core/src/commonMain/kotlin/dev/inmo/tgbotapi/types/media/TelegramPaidMediaVideo.kt
+++ b/tgbotapi.core/src/commonMain/kotlin/dev/inmo/tgbotapi/types/media/TelegramPaidMediaVideo.kt
@@ -0,0 +1,38 @@
+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 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()
--- a/tgbotapi.core/src/commonMain/kotlin/dev/inmo/tgbotapi/types/message/content/Abstracts.kt
+++ b/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
--- a/tgbotapi.core/src/commonMain/kotlin/dev/inmo/tgbotapi/types/message/content/MediaGroupContent.kt
+++ b/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,
--- a/tgbotapi.core/src/commonMain/kotlin/dev/inmo/tgbotapi/types/message/content/PaidMediaInfoContent.kt
+++ b/tgbotapi.core/src/commonMain/kotlin/dev/inmo/tgbotapi/types/message/content/PaidMediaInfoContent.kt
@@ -0,0 +1,40 @@
+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.media.PaidMedia
+import dev.inmo.tgbotapi.types.media.TelegramPaidMedia
+import dev.inmo.tgbotapi.types.media.toTelegramMediaPhoto
+import dev.inmo.tgbotapi.types.message.abstracts.ContentMessage
+import kotlinx.serialization.Serializable
+
+@Serializable
+data class PaidMediaInfoContent(
+    override val mediaCollection: List<PaidMedia>,
+    override val text: String? = null,
+    override val textSources: TextSourcesList = emptyList(),
+    override val quote: TextQuote? = null,
+    override val showCaptionAboveMedia: Boolean = false
+) : MediaCollectionContent<UsefulAsPaidMediaFile>, TextedMediaContent, WithCustomizedCaptionMediaContent {
+    override val media: UsefulAsPaidMediaFile
+        get() = mediaCollection.first()
+    override fun asTelegramMedia(): TelegramPaidMedia = when (val media = media) {
+        is VideoFile -> media.toTelegramPaidMediaVideo()
+        is Photo -> media.biggest.toTelegramMediaPhoto()
+    }
+
+    override fun createResend(
+        chatId: ChatIdentifier,
+        messageThreadId: MessageThreadId?,
+        businessConnectionId: BusinessConnectionId?,
+        disableNotification: Boolean,
+        protectContent: Boolean,
+        effectId: EffectId?,
+        replyParameters: ReplyParameters?,
+        replyMarkup: KeyboardMarkup?
+    ): Request<ContentMessage<PaidMediaInfoContent>> = TODO()
+}
--- a/tgbotapi.core/src/commonTest/kotlin/dev/inmo/tgbotapi/SimpleInputFilesTest.kt
+++ b/tgbotapi.core/src/commonTest/kotlin/dev/inmo/tgbotapi/SimpleInputFilesTest.kt
@@ -3,7 +3,7 @@ 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.media.MediaGroupMemberTelegramFreeMediaSerializer
 import dev.inmo.tgbotapi.types.files.PhotoSize
 import dev.inmo.tgbotapi.types.message.content.PhotoContent
 import kotlinx.serialization.json.Json
@@ -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
            )
        )