preview version of inputs for tasks

tgbotapi.core/src/commonMain/kotlin/dev/inmo/tgbotapi/abstracts/Texted.kt

@@ -27,3 +27,12 @@ interface TextedOutput : ParsableOutput, EntitiesOutput
 interface TextedInput : TextedWithTextSources {
     override val textSources: List<TextSource>
 }
+
+interface TitledInput : TextedInput {
+    val title: String
+    val titleTextSources: List<TextSource>
+    override val text: String
+        get() = title
+    override val textSources: List<TextSource>
+        get() = titleTextSources
+}

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

@@ -311,6 +311,7 @@ const val emojiListField = "emoji_list"
 const val completedByUserField = "completed_by_user"
 const val completionDateField = "completion_date"
 const val titleEntitiesField = "title_entities"
+const val tasksField = "tasks"
 const val othersCanAddTasksField = "others_can_add_tasks"
 const val othersCanMarkTasksAsDoneField = "others_can_mark_tasks_as_done"
 

tgbotapi.core/src/commonMain/kotlin/dev/inmo/tgbotapi/types/checklists/Checklist.kt

@@ -1,62 +1,132 @@
 package dev.inmo.tgbotapi.types.checklists
 
+import dev.inmo.micro_utils.common.Warning
+import dev.inmo.tgbotapi.abstracts.TitledInput
+import dev.inmo.tgbotapi.types.message.ParseMode
 import dev.inmo.tgbotapi.types.message.RawMessageEntity
 import dev.inmo.tgbotapi.types.message.asTextSources
+import dev.inmo.tgbotapi.types.message.parseModeField
 import dev.inmo.tgbotapi.types.message.textsources.TextSource
 import dev.inmo.tgbotapi.types.message.toRawMessageEntities
+import dev.inmo.tgbotapi.types.tasksField
+import dev.inmo.tgbotapi.types.titleEntitiesField
+import dev.inmo.tgbotapi.types.titleField
 import dev.inmo.tgbotapi.utils.extensions.makeSourceString
 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
 
-@Serializable(Checklist.Companion::class)
-data class Checklist(
-    val titleTextSources: List<TextSource>,
-    val tasks: List<ChecklistTask>,
-    val othersCanAddTasks: Boolean = false,
-    val othersCanCompleteTasks: Boolean = false,
-) {
-    val title: String by lazy {
-        titleTextSources.makeSourceString()
+@Serializable
+sealed interface Checklist : TitledInput {
+    val tasks: List<ChecklistTask>
+    val othersCanAddTasks: Boolean
+    val othersCanCompleteTasks: Boolean
+    @Serializable
+    data class Input @Warning("It is low level API. Do not use it without need") constructor(
+        @SerialName(titleField)
+        override val title: String,
+        @SerialName(tasksField)
+        override val tasks: List<ChecklistTask.Input>,
+        @SerialName(parseModeField)
+        val parseMode: ParseMode? = null,
+        @SerialName(titleEntitiesField)
+        override val titleTextSources: List<TextSource> = emptyList(),
+        override val othersCanAddTasks: Boolean = false,
+        override val othersCanCompleteTasks: Boolean = false,
+    ) : Checklist {
+        companion object : KSerializer<Input> {
+            @Serializable
+            private class RawChecklist(
+                val title: String,
+                val parseMode: ParseMode? = null,
+                val title_entities: List<RawMessageEntity> = emptyList(),
+                val tasks: List<ChecklistTask.Input>,
+                val others_can_add_tasks: Boolean = false,
+                val others_can_mark_tasks_as_done: Boolean = false,
+            )
+            override val descriptor: SerialDescriptor = RawChecklist.serializer().descriptor
+
+            override fun serialize(
+                encoder: Encoder,
+                value: Input
+            ) {
+                RawChecklist.serializer().serialize(
+                    encoder,
+                    RawChecklist(
+                        title = value.title,
+                        title_entities = value.titleTextSources.toRawMessageEntities(),
+                        tasks = value.tasks,
+                        parseMode = value.parseMode,
+                        others_can_add_tasks = value.othersCanAddTasks,
+                        others_can_mark_tasks_as_done = value.othersCanCompleteTasks,
+                    )
+                )
+            }
+
+            override fun deserialize(decoder: Decoder): Input {
+                val raw = RawChecklist.serializer().deserialize(decoder)
+                return Input(
+                    title = raw.title,
+                    titleTextSources = raw.title_entities.asTextSources(raw.title),
+                    tasks = raw.tasks,
+                    parseMode = raw.parseMode,
+                    othersCanAddTasks = raw.others_can_add_tasks,
+                    othersCanCompleteTasks = raw.others_can_mark_tasks_as_done
+                )
+            }
+        }
     }
 
-    companion object : KSerializer<Checklist> {
-        @Serializable
-        private class RawChecklist(
-            val title: String,
-            val title_entities: List<RawMessageEntity> = emptyList(),
-            val tasks: List<ChecklistTask>,
-            val others_can_add_tasks: Boolean = false,
-            val others_can_mark_tasks_as_done: Boolean = false,
-        )
-        override val descriptor: SerialDescriptor = RawChecklist.serializer().descriptor
-
-        override fun serialize(
-            encoder: Encoder,
-            value: Checklist
-        ) {
-            RawChecklist.serializer().serialize(
-                encoder,
-                RawChecklist(
-                    title = value.title,
-                    title_entities = value.titleTextSources.toRawMessageEntities(),
-                    tasks = value.tasks,
-                    others_can_add_tasks = value.othersCanAddTasks,
-                    others_can_mark_tasks_as_done = value.othersCanCompleteTasks,
-                )
-            )
+    @Serializable(Created.Companion::class)
+    data class Created(
+        override val titleTextSources: List<TextSource>,
+        override val tasks: List<ChecklistTask.Created>,
+        override val othersCanAddTasks: Boolean = false,
+        override val othersCanCompleteTasks: Boolean = false,
+    ): Checklist {
+        override val title: String by lazy {
+            titleTextSources.makeSourceString()
         }
 
-        override fun deserialize(decoder: Decoder): Checklist {
-            val raw = RawChecklist.serializer().deserialize(decoder)
-            return Checklist(
-                titleTextSources = raw.title_entities.asTextSources(raw.title),
-                tasks = raw.tasks,
-                othersCanAddTasks = raw.others_can_add_tasks,
-                othersCanCompleteTasks = raw.others_can_mark_tasks_as_done
+        companion object : KSerializer<Created> {
+            @Serializable
+            private class RawChecklist(
+                val title: String,
+                val title_entities: List<RawMessageEntity> = emptyList(),
+                val tasks: List<ChecklistTask.Created>,
+                val others_can_add_tasks: Boolean = false,
+                val others_can_mark_tasks_as_done: Boolean = false,
             )
+            override val descriptor: SerialDescriptor = RawChecklist.serializer().descriptor
+
+            override fun serialize(
+                encoder: Encoder,
+                value: Created
+            ) {
+                RawChecklist.serializer().serialize(
+                    encoder,
+                    RawChecklist(
+                        title = value.title,
+                        title_entities = value.titleTextSources.toRawMessageEntities(),
+                        tasks = value.tasks,
+                        others_can_add_tasks = value.othersCanAddTasks,
+                        others_can_mark_tasks_as_done = value.othersCanCompleteTasks,
+                    )
+                )
+            }
+
+            override fun deserialize(decoder: Decoder): Created {
+                val raw = RawChecklist.serializer().deserialize(decoder)
+                return Created(
+                    titleTextSources = raw.title_entities.asTextSources(raw.title),
+                    tasks = raw.tasks,
+                    othersCanAddTasks = raw.others_can_add_tasks,
+                    othersCanCompleteTasks = raw.others_can_mark_tasks_as_done
+                )
+            }
         }
     }
 }

tgbotapi.core/src/commonMain/kotlin/dev/inmo/tgbotapi/types/checklists/ChecklistTask.kt

@@ -1,19 +1,28 @@
 package dev.inmo.tgbotapi.types.checklists
 
+import dev.inmo.micro_utils.common.Warning
 import dev.inmo.tgbotapi.abstracts.TextedInput
+import dev.inmo.tgbotapi.abstracts.TitledInput
 import dev.inmo.tgbotapi.types.TelegramDate
 import dev.inmo.tgbotapi.types.chat.PreviewUser
 import dev.inmo.tgbotapi.types.completedByUserField
 import dev.inmo.tgbotapi.types.completionDateField
 import dev.inmo.tgbotapi.types.idField
+import dev.inmo.tgbotapi.types.message.ParseMode
 import dev.inmo.tgbotapi.types.message.RawMessageEntity
 import dev.inmo.tgbotapi.types.message.asTextSources
+import dev.inmo.tgbotapi.types.message.parseModeField
 import dev.inmo.tgbotapi.types.message.textsources.RegularTextSource
 import dev.inmo.tgbotapi.types.message.textsources.TextSource
-import dev.inmo.tgbotapi.types.message.textsources.TextSourcesList
 import dev.inmo.tgbotapi.types.message.toRawMessageEntities
+import dev.inmo.tgbotapi.types.tasksField
 import dev.inmo.tgbotapi.types.textEntitiesField
 import dev.inmo.tgbotapi.types.textField
+import dev.inmo.tgbotapi.types.textParseModeField
+import dev.inmo.tgbotapi.types.titleEntitiesField
+import dev.inmo.tgbotapi.types.titleField
+import dev.inmo.tgbotapi.utils.EntitiesBuilder
+import dev.inmo.tgbotapi.utils.EntitiesBuilderBody
 import dev.inmo.tgbotapi.utils.RiskFeature
 import dev.inmo.tgbotapi.utils.extensions.makeSourceString
 import kotlinx.serialization.EncodeDefault
@@ -29,18 +38,93 @@ import kotlinx.serialization.encoding.Encoder
 sealed interface ChecklistTask : TextedInput {
     val id: ChecklistTaskId
     override val text: String
-    val completedByUser: PreviewUser?
-        get() = null
-    val completionDate: TelegramDate?
-        get() = null
-
     @Serializable
+    data class InputChecklist @Warning("It is low level API. Do not use it without need") constructor(
+        @SerialName(titleField)
+        override val title: String,
+        @SerialName(tasksField)
+        val tasks: List<InputChecklistTask>,
+        @SerialName(parseModeField)
+        val parseMode: ParseMode? = null,
+        @SerialName(titleEntitiesField)
+        override val titleTextSources: List<TextSource> = emptyList(),
+
+        ) : TitledInput
+
+    @Serializable(Input.Companion::class)
+    data class Input @Warning("It is low level API. Do not use it without need") constructor(
+        @SerialName(idField)
+        override val id: ChecklistTaskId,
+        @SerialName(textField)
+        override val text: String,
+        @SerialName(textParseModeField)
+        val parseMode: ParseMode? = null,
+        @SerialName(textEntitiesField)
+        override val textSources: List<TextSource> = emptyList(),
+    ) : ChecklistTask {
+        constructor(id: ChecklistTaskId, text: String, parseMode: ParseMode? = null) : this(
+            id = id,
+            text = text,
+            parseMode = parseMode,
+            textSources = emptyList()
+        )
+        constructor(id: ChecklistTaskId, textSources: List<TextSource>) : this(
+            id = id,
+            text = textSources.makeSourceString(),
+            parseMode = null,
+            textSources = textSources
+        )
+        constructor(id: ChecklistTaskId, builderBody: EntitiesBuilderBody) : this(
+            id = id,
+            textSources = EntitiesBuilder().apply(builderBody).build()
+        )
+
+        companion object : KSerializer<Input> {
+            @Serializable
+            private data class RawInput(
+                @SerialName(idField)
+                val id: ChecklistTaskId,
+                @SerialName(textField)
+                val text: String,
+                @SerialName(textParseModeField)
+                val parseMode: ParseMode? = null,
+                @SerialName(textEntitiesField)
+                val textSources: List<RawMessageEntity> = emptyList(),
+            )
+            override val descriptor: SerialDescriptor
+                get() = RawInput.serializer().descriptor
+
+            override fun deserialize(decoder: Decoder): Input {
+                val raw = RawInput.serializer().deserialize(decoder)
+                return Input(
+                    raw.id,
+                    raw.text,
+                    raw.parseMode,
+                    raw.textSources.asTextSources(raw.text)
+                )
+            }
+
+            override fun serialize(encoder: Encoder, value: Input) {
+                RawInput.serializer().serialize(
+                    encoder,
+                    RawInput(
+                        value.id,
+                        value.text,
+                        value.parseMode,
+                        value.textSources.toRawMessageEntities()
+                    )
+                )
+            }
+        }
+    }
+
+    @Serializable(Created.Serializer::class)
     data class Undone(
         @SerialName(idField)
         override val id: ChecklistTaskId,
         @SerialName(textEntitiesField)
         override val textSources: List<TextSource> = emptyList(),
-    ) : ChecklistTask {
+    ) : ChecklistTask.Created {
         @OptIn(ExperimentalSerializationApi::class)
         @EncodeDefault
         @Serializable
@@ -55,7 +139,7 @@ sealed interface ChecklistTask : TextedInput {
         )
     }
 
-    @Serializable
+    @Serializable(Created.Serializer::class)
     data class Done(
         @SerialName(idField)
         override val id: ChecklistTaskId,
@@ -65,7 +149,7 @@ sealed interface ChecklistTask : TextedInput {
         override val completionDate: TelegramDate,
         @SerialName(textEntitiesField)
         override val textSources: List<TextSource> = emptyList()
-    ) : ChecklistTask {
+    ) : ChecklistTask.Created {
         @OptIn(ExperimentalSerializationApi::class)
         @EncodeDefault
         @Serializable
@@ -86,55 +170,62 @@ sealed interface ChecklistTask : TextedInput {
             )
         )
     }
-    
-    
-    @RiskFeature
-    object Serializer : KSerializer<ChecklistTask> {
-        @Serializable
-        private data class RawChecklistTask(
-            @SerialName(idField)
-            val id: ChecklistTaskId,
-            @SerialName(textField)
-            val text: String,
-            @SerialName(textEntitiesField)
-            val textSources: List<RawMessageEntity> = emptyList(),
-            @SerialName(completedByUserField)
-            val completedByUser: PreviewUser? = null,
-            @SerialName(completionDateField)
-            val completionDate: TelegramDate = TelegramDate(0), // TelegramDate(0) is the default according to https://core.telegram.org/bots/api#checklisttask
-        )
-        override val descriptor: SerialDescriptor = RawChecklistTask.serializer().descriptor
 
-        override fun deserialize(decoder: Decoder): ChecklistTask {
-            val raw = RawChecklistTask.serializer().deserialize(
-                decoder
+    @Serializable(Created.Serializer::class)
+    sealed interface Created : ChecklistTask {
+        val completedByUser: PreviewUser?
+            get() = null
+        val completionDate: TelegramDate?
+            get() = null
+
+        @RiskFeature
+        object Serializer : KSerializer<Created> {
+            @Serializable
+            private data class RawCreatedChecklistTask(
+                @SerialName(idField)
+                val id: ChecklistTaskId,
+                @SerialName(textField)
+                val text: String,
+                @SerialName(textEntitiesField)
+                val textSources: List<RawMessageEntity> = emptyList(),
+                @SerialName(completedByUserField)
+                val completedByUser: PreviewUser? = null,
+                @SerialName(completionDateField)
+                val completionDate: TelegramDate = TelegramDate(0), // TelegramDate(0) is the default according to https://core.telegram.org/bots/api#checklisttask
             )
+            override val descriptor: SerialDescriptor = RawCreatedChecklistTask.serializer().descriptor
 
-            return when {
-                raw.completedByUser != null -> Done(
-                    id = raw.id,
-                    completedByUser = raw.completedByUser,
-                    completionDate = raw.completionDate,
-                    textSources = raw.textSources.asTextSources(raw.text),
+            override fun deserialize(decoder: Decoder): Created {
+                val raw = RawCreatedChecklistTask.serializer().deserialize(
+                    decoder
                 )
-                else -> Undone(
-                    id = raw.id,
-                    textSources = raw.textSources.asTextSources(raw.text),
+
+                return when {
+                    raw.completedByUser != null -> Done(
+                        id = raw.id,
+                        completedByUser = raw.completedByUser,
+                        completionDate = raw.completionDate,
+                        textSources = raw.textSources.asTextSources(raw.text),
+                    )
+                    else -> Undone(
+                        id = raw.id,
+                        textSources = raw.textSources.asTextSources(raw.text),
+                    )
+                }
+            }
+
+            override fun serialize(encoder: Encoder, value: Created) {
+                RawCreatedChecklistTask.serializer().serialize(
+                    encoder,
+                    RawCreatedChecklistTask(
+                        id = value.id,
+                        text = value.text,
+                        completedByUser = value.completedByUser,
+                        completionDate = value.completionDate ?: TelegramDate(0),
+                        textSources = value.textSources.toRawMessageEntities()
+                    )
                 )
             }
         }
-
-        override fun serialize(encoder: Encoder, value: ChecklistTask) {
-            RawChecklistTask.serializer().serialize(
-                encoder,
-                RawChecklistTask(
-                    id = value.id,
-                    text = value.text,
-                    completedByUser = value.completedByUser,
-                    completionDate = value.completionDate ?: TelegramDate(0),
-                    textSources = value.textSources.toRawMessageEntities()
-                )
-            )
-        }
     }
 }

tgbotapi.core/src/commonMain/kotlin/dev/inmo/tgbotapi/types/checklists/ChecklistTaskId.kt

@@ -6,5 +6,5 @@ import kotlin.jvm.JvmInline
 @Serializable
 @JvmInline
 value class ChecklistTaskId(
-    val int: Int
+    val int: UInt
 )

tgbotapi.core/src/commonMain/kotlin/dev/inmo/tgbotapi/types/checklists/InputChecklist.kt

@@ -0,0 +1,15 @@
+package dev.inmo.tgbotapi.types.checklists
+
+import dev.inmo.micro_utils.common.Warning
+import dev.inmo.tgbotapi.abstracts.TextedInput
+import dev.inmo.tgbotapi.abstracts.TitledInput
+import dev.inmo.tgbotapi.types.message.ParseMode
+import dev.inmo.tgbotapi.types.message.parseModeField
+import dev.inmo.tgbotapi.types.message.textsources.TextSource
+import dev.inmo.tgbotapi.types.tasksField
+import dev.inmo.tgbotapi.types.titleEntitiesField
+import dev.inmo.tgbotapi.types.titleField
+import kotlinx.serialization.SerialName
+import kotlinx.serialization.Serializable
+
+