fill changelog and readme

28.0.3

.github/FUNDING.yml

@@ -1,3 +1,3 @@
 # These are supported funding model platforms
 
-custom: ['https://www.tinkoff.ru/rm/ovsyannikov.aleksey113/ObMJ712472']
+custom: ['https://tonscan.org/address/UQAtuSLJ76Zehc3qP-eRYMR98fPIu_oOp_atcpVX55zxHwTU']

.github/workflows/greetings.yml

@@ -5,6 +5,9 @@ on: [pull_request, issues]
 jobs:
   greeting:
     runs-on: ubuntu-latest
+    permissions:
+      issues: write
+      pull-requests: write
     steps:
     - uses: actions/first-interaction@v1
       with:

.github/workflows/kdocs.yml

@@ -10,12 +10,12 @@ jobs:
       - uses: actions/checkout@v2
       - uses: actions/setup-java@v1
         with:
-          java-version: 11
+          java-version: 17
       - name: Build
-        run: ./gradlew dokkaHtml
+        run: ./gradlew dokkaHtmlMultiModule
       - name: Publish KDocs
         uses: peaceiris/actions-gh-pages@v3
         with:
           github_token: ${{ secrets.GITHUB_TOKEN }}
-          publish_dir: ./docs/build/dokka/html
+          publish_dir: ./build/dokka/htmlMultiModule
           publish_branch: kdocs

.github/workflows/packages_publishing.yml

@@ -7,18 +7,30 @@ jobs:
       - uses: actions/checkout@v2
       - uses: actions/setup-java@v1
         with:
-          java-version: 11
+          java-version: 17
+      - name: Setup LibCurl
+        run: sudo apt update && sudo apt install -y libcurl4-openssl-dev
       - name: Rewrite version
         run: |
           branch="`echo "${{ github.ref }}" | grep -o "[^/]*$"`"
           cat gradle.properties | sed -e "s/^library_version=\([0-9\.]*\)/library_version=\1-branch_$branch-build${{ github.run_number }}/" > gradle.properties.tmp
           rm gradle.properties
           mv gradle.properties.tmp gradle.properties
+      - name: KotlinSymbolProcessing execution
+        run: ./gradlew kspCommonMainKotlinMetadata
       - name: Build
         run: ./gradlew build
-      - name: Publish
+      - name: API compatibility check
+        run: ./gradlew apiCheck
+      - name: Publish to GithubPackages
         continue-on-error: true
         run: ./gradlew publishAllPublicationsToGithubPackagesRepository --no-parallel
         env:
-          GITHUBPACKAGES_USER: ${{ github.actor }}
-          GITHUBPACKAGES_PASSWORD: ${{ secrets.GITHUB_TOKEN }}
+          GITHUB_USER: ${{ github.actor }}
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+      - name: Publish to Gitea
+        continue-on-error: true
+        run: ./gradlew publishAllPublicationsToInmoNexusRepository
+        env:
+          INMONEXUS_USER: ${{ secrets.INMONEXUS_USER }}
+          INMONEXUS_PASSWORD: ${{ secrets.INMONEXUS_PASSWORD }}

.gitignore

@@ -1,4 +1,5 @@
 .idea
+.kotlin
 out/*
 *.iml
 target
@@ -8,7 +9,9 @@ settings.xml
 .gradle/
 build/
 out/
+bin/
 
 local.properties
 kotlin-js-store/
 secret.gradle
+.aider*

README.md

@@ -1,14 +1,16 @@
-# TelegramBotAPI [![Maven Central](https://maven-badges.herokuapp.com/maven-central/dev.inmo/tgbotapi/badge.svg)](https://maven-badges.herokuapp.com/maven-central/dev.inmo/tgbotapi) [![Supported version](https://img.shields.io/badge/Telegram%20Bot%20API-6.2-blue)](https://core.telegram.org/bots/api-changelog#august-12-2022)
+# TelegramBotAPI [![Maven Central Version](https://img.shields.io/maven-central/v/dev.inmo/tgbotapi)](https://central.sonatype.com/artifact/dev.inmo/tgbotapi) [![Supported version](https://img.shields.io/badge/Telegram%20Bot%20API-9.2-blue)](https://core.telegram.org/bots/api-changelog#august-15-2025)
 
-| Docs | [![KDocs](https://img.shields.io/static/v1?label=Dokka&message=KDocs&color=blue&logo=kotlin)](https://tgbotapi.inmo.dev/index.html) [![Mini tutorial](https://img.shields.io/static/v1?label=Bookstack&message=Tutorial&color=blue&logo=bookstack)](https://bookstack.inmo.dev/books/telegrambotapi/chapter/introduction-tutorial) |
-|:---:|:---:|
-| Useful repos | [![Create bot](https://img.shields.io/static/v1?label=Github&message=Template&color=blue&logo=github)](https://github.com/InsanusMokrassar/TelegramBotAPI-bot_template/generate) [![Examples](https://img.shields.io/static/v1?label=Github&message=Examples&color=blue&logo=github)](https://github.com/InsanusMokrassar/TelegramBotAPI-examples/) |
-| Misc | [![Awesome Kotlin Badge](https://kotlin.link/awesome-kotlin.svg)](https://github.com/KotlinBy/awesome-kotlin) [![Small survey](https://img.shields.io/static/v1?label=Google&message=Survey&color=blue&logo=google-sheets)](https://docs.google.com/forms/d/e/1FAIpQLSctdJHT_aEniyYT0-IUAEfo1hsIlezX2owlkEAYX4KPl2V2_A/viewform?usp=sf_link) |
+|          Docs          |                                   [![KDocs](https://img.shields.io/static/v1?label=Dokka&message=KDocs&color=blue&logo=kotlin)](https://tgbotapi.inmo.dev/index.html) [![Mini tutorial](https://img.shields.io/static/v1?label=Mk&message=Docs&color=blue&logo=mkdocs)](https://docs.inmo.dev/tgbotapi/index.html)                                    |
+|:----------------------:|:-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------:|
+|      Useful repos      |                           [![Create bot](https://img.shields.io/static/v1?label=Github&message=Template&color=blue&logo=github)](https://github.com/InsanusMokrassar/TelegramBotAPI-bot_template/generate) [![Examples](https://img.shields.io/static/v1?label=Github&message=Examples&color=blue&logo=github)](https://github.com/InsanusMokrassar/TelegramBotAPI-examples/)                           |
+|          Misc          |                              [![Awesome Kotlin Badge](https://kotlin.link/awesome-kotlin.svg)](https://github.com/KotlinBy/awesome-kotlin) [![Small survey](https://img.shields.io/static/v1?label=Google&message=Survey&color=blue&logo=google-sheets)](https://docs.google.com/forms/d/e/1FAIpQLSctdJHT_aEniyYT0-IUAEfo1hsIlezX2owlkEAYX4KPl2V2_A/viewform?usp=sf_link)                               |
+|       Platforms        |                                                                                                      ![JVM](https://img.shields.io/badge/JVM-red?style=plastic&logo=openjdk&logoColor=white) ![Js](https://img.shields.io/badge/JavaScript-323330?style=plastic&logo=javascript&logoColor=F7DF1E)                                                                                                       |
+| Experimental Platforms |                                                                                                [![Linux x64](https://img.shields.io/badge/LinuxX64-FCC624?style=plastic&logo=linux&logoColor=black)](https://kotlinlang.org/docs/native-target-support.html#tier-1) [![MinGW x64](https://img.shields.io/badge/MinGWX64-black?style=plastic&logo=windows&logoColor=green)](https://kotlinlang.org/docs/native-target-support.html#tier-1)                                                                                                 |
 
-<!--- [![Telegram Channel](./resources/tg_channel_qr.jpg)](https://t.me/InMoTelegramBotAPI) --->
+<!--- [![Telegram Channel](./resources/tg_channel_qr.jpg)](https://t.me/ktgbotapi) --->
 
 <p align="center">
-  <a href="https://t.me/InMoTelegramBotAPI">
+  <a href="https://t.me/ktgbotapi">
     <img src="./resources/tg_channel_qr.jpg">
   </a>
 </p>
@@ -116,5 +118,22 @@ suspend fun main() {
 ### More examples
 
 You may find examples in [this project](https://github.com/InsanusMokrassar/TelegramBotAPI-examples). Besides, you are
-always welcome in our [wiki](https://github.com/InsanusMokrassar/TelegramBotAPI/wiki/About-this-project) and
+always welcome in our [docs](https://docs.inmo.dev/tgbotapi/index.html) and
 [chat](https://t.me/InMoTelegramBotAPIChat).
+
+### Bot API Server Notice
+
+Under the hood, default bots realizations will try to use links
+([PathedFile](tgbotapi.core/src/commonMain/kotlin/dev/inmo/tgbotapi/types/files/PathedFile.kt)#filePath) as files each
+time you are trying to download file from telegram in any way - via saving to file, use stream or download as byte array.
+To let bot correctly download files from bot api server, you must:
+
+* Run bot api server locally
+to proxy requests for files to the server where bot api server has been hosted
+  * In case of local bot api server (shared one host machine) you must ensure that access to bot api server has been
+  granted for your bot. For example, [aiogram/telegram-bot-api](https://hub.docker.com/r/aiogram/telegram-bot-api) image
+  use `101` UID/GID in linux for user and group as owners. So, your bot must run under user included in `101` group
+  (like `systemd-journal`) or be `101` UID user (like `systemd-resolve`)
+* **OR** Use some reverse proxy (like nginx). It will allow you to broadcast your bots files without linux rights problems
+  * Set [TelegramAPIUrlsKeeper](tgbotapi.core/src/commonMain/kotlin/dev/inmo/tgbotapi/utils/TelegramAPIUrlsKeeper.kt)#fileLinkUrlMapper
+  to map urls to let bot execute requests to your nginx proxy

build.gradle

@@ -1,8 +1,8 @@
 buildscript {
     repositories {
-        mavenLocal()
         mavenCentral()
         maven { url "https://plugins.gradle.org/m2/" }
+        mavenLocal()
     }
 
     dependencies {
@@ -14,12 +14,34 @@ buildscript {
     }
 }
 
+plugins {
+    alias(libs.plugins.kotlin.dokka)
+    alias(libs.plugins.versions)
+    alias(libs.plugins.validator)
+    alias(libs.plugins.nmcp.aggregation)
+}
+
+
+if ((project.hasProperty('SONATYPE_USER') || System.getenv('SONATYPE_USER') != null) && (project.hasProperty('SONATYPE_PASSWORD') || System.getenv('SONATYPE_PASSWORD') != null)) {
+    nmcpAggregation {
+        centralPortal {
+            username = project.hasProperty('SONATYPE_USER') ? project.property('SONATYPE_USER') : System.getenv('SONATYPE_USER')
+            password = project.hasProperty('SONATYPE_PASSWORD') ? project.property('SONATYPE_PASSWORD') : System.getenv('SONATYPE_PASSWORD')
+            validationTimeout = Duration.ofSeconds(0)
+            publishingType = System.getenv('PUBLISHING_TYPE') != "" ? System.getenv('PUBLISHING_TYPE') : "USER_MANAGED"
+        }
+
+        publishAllProjectsProbablyBreakingProjectIsolation()
+    }
+}
+
 // temporal crutch until legacy tests will be stabled or legacy target will be removed
 allprojects {
     repositories {
-        mavenLocal()
         mavenCentral()
         google()
+        maven { url "https://nexus.inmo.dev/repository/maven-releases/" }
+        mavenLocal()
     }
     if (it != rootProject.findProject("docs")) {
         tasks.whenTaskAdded { task ->
@@ -41,20 +63,28 @@ private String getCurrentVersionChangelog() {
     return changelogDataOS.toString().trim()
 }
 
-if (new File(projectDir, "secret.gradle").exists()) {
-    apply from: './secret.gradle'
+
+def githubTokenVariableName = "GITHUB_RELEASE_TOKEN"
+def githubTokenVariableFromEnv = System.getenv(githubTokenVariableName)
+
+def secretFile = new File(projectDir, "secret.gradle")
+if (secretFile.exists() || project.hasProperty(githubTokenVariableName) || (githubTokenVariableFromEnv != "" && githubTokenVariableFromEnv != null)) {
+    if (secretFile.exists()) {
+        apply from: './secret.gradle'
+    }
     apply plugin: "com.github.breadmoirai.github-release"
+    def githubReleaseToken = project.hasProperty(githubTokenVariableName) ? project.property(githubTokenVariableName).toString() : githubTokenVariableFromEnv
 
     githubRelease {
-        token "${project.property('GITHUB_RELEASE_TOKEN')}"
+        token githubReleaseToken
 
-        owner "InsanusMokrassar"
-        repo "TelegramBotAPI"
+        owner = "InsanusMokrassar"
+        repo = "TelegramBotAPI"
 
-        tagName "v$library_version"
-        releaseName "$library_version"
-        targetCommitish "$library_version"
+        tagName = "v$library_version"
+        releaseName = "$library_version"
+        targetCommitish = "$library_version"
 
-        body getCurrentVersionChangelog()
+        body = getCurrentVersionChangelog()
     }
 }

docs/build.gradle

@@ -6,7 +6,7 @@ plugins {
 
 project.description = "Full collection of all built-in tgbotapi tools"
 
-apply from: "$mppProjectWithSerializationPresetPath"
+apply from: "$mppProjectWithSerialization"
 
 kotlin {
     sourceSets {
@@ -54,8 +54,8 @@ Object callback = {
             skipDeprecated.set(true)
 
             sourceLink {
-                localDirectory.set(file("./"))
-                remoteUrl.set(new URL("https://github.com/InsanusMokrassar/TelegramBotAPI/blob/master/"))
+                localDirectory.set(file("../"))
+                remoteUrl.set(new URL("https://github.com/InsanusMokrassar/ktgbotapi"))
                 remoteLineSuffix.set("#L")
             }
         }

extensions.gradle

@@ -1,8 +1,27 @@
-allprojects {
-    ext {
-        mppProjectWithSerializationPresetPath = "${rootProject.projectDir.absolutePath}/mppProjectWithSerialization.gradle"
-        mppJsProjectPresetPath = "${rootProject.projectDir.absolutePath}/mppJsProject.gradle"
+File templatesFolder = new File("$rootProject.projectDir.absolutePath${File.separatorChar}gradle${File.separatorChar}templates")
 
-        publishGradlePath = "${rootProject.projectDir.absolutePath}/publish.gradle"
+Map properties = new HashMap<String, String>()
+
+if (templatesFolder.exists() && templatesFolder.isDirectory()) {
+    templatesFolder.listFiles().each {
+        properties[it.name - ".gradle"] = it.absolutePath
+    }
+}
+
+allprojects {
+    ext {
+        properties.forEach { k, v ->
+            it[k] = v
+        }
+    }
+}
+
+tasks.register("getPublishableModules") {
+    doLast {
+        rootProject.subprojects.each { project ->
+            if (project.plugins.hasPlugin('maven-publish')) {
+                println(":${project.name}")
+            }
+        }
     }
 }

gradle.properties

@@ -5,5 +5,8 @@ kotlin.js.generate.externals=true
 kotlin.incremental=true
 kotlin.incremental.js=true
 
+# https://github.com/google/ksp/issues/2491
+ksp.useKSP2=false
+
 library_group=dev.inmo
-library_version=3.2.0
+library_version=29.0.0

gradle/libs.versions.toml

@@ -1,21 +1,28 @@
 [versions]
 
-kotlin = "1.7.10"
-kotlin-serialization = "1.4.0"
-kotlin-coroutines = "1.6.4"
+kotlin = "2.2.10"
+kotlin-serialization = "1.9.0"
+kotlin-coroutines = "1.10.2"
 
 javax-activation = "1.1.1"
 
-korlibs = "3.0.0"
-uuid = "0.5.0"
-ktor = "2.1.0"
+korlibs = "5.4.0"
+uuid = "0.8.4"
+ktor = "3.2.3"
 
-ksp = "1.7.10-1.0.6"
-kotlin-poet = "1.12.0"
+ksp = "2.2.10-2.0.2"
+kotlin-poet = "2.2.0"
 
-microutils = "0.12.4"
+microutils = "0.26.3"
+kslog = "1.5.0"
 
-github-release-plugin = "2.4.1"
+versions = "0.52.0"
+
+github-release-plugin = "2.5.2"
+dokka = "2.0.0"
+
+validator = "0.18.1"
+nmcp = "1.1.0"
 
 [libraries]
 
@@ -30,23 +37,36 @@ kotlin-test-js = { module = "org.jetbrains.kotlin:kotlin-test-js", version.ref =
 
 ktor-client-core = { module = "io.ktor:ktor-client-core", version.ref = "ktor" }
 ktor-client-cio = { module = "io.ktor:ktor-client-cio", version.ref = "ktor" }
+ktor-client-java = { module = "io.ktor:ktor-client-java", version.ref = "ktor" }
+ktor-client-js = { module = "io.ktor:ktor-client-js", version.ref = "ktor" }
+ktor-client-curl = { module = "io.ktor:ktor-client-curl", version.ref = "ktor" }
+ktor-client-winhttp = { module = "io.ktor:ktor-client-winhttp", version.ref = "ktor" }
 ktor-server = { module = "io.ktor:ktor-server", version.ref = "ktor" }
 ktor-server-host-common = { module = "io.ktor:ktor-server-host-common", version.ref = "ktor" }
 
 javax-activation = { module = "javax.activation:activation", version.ref = "javax-activation" }
 
-korlibs-klock =  { module = "com.soywiz.korlibs.klock:klock", version.ref = "korlibs" }
-korlibs-krypto =  { module = "com.soywiz.korlibs.krypto:krypto", version.ref = "korlibs" }
+korlibs-klock =  { module = "com.soywiz.korge:korlibs-time", version.ref = "korlibs" }
+korlibs-krypto =  { module = "com.soywiz.korge:korlibs-crypto", version.ref = "korlibs" }
 
 uuid = { module = "com.benasher44:uuid", version.ref = "uuid" }
 
+microutils-colors-common = { module = "dev.inmo:micro_utils.colors.common", version.ref = "microutils" }
 microutils-coroutines = { module = "dev.inmo:micro_utils.coroutines", version.ref = "microutils" }
 microutils-serialization-base64 = { module = "dev.inmo:micro_utils.serialization.base64", version.ref = "microutils" }
 microutils-serialization-encapsulator = { module = "dev.inmo:micro_utils.serialization.encapsulator", version.ref = "microutils" }
 microutils-serialization-typedSerializer = { module = "dev.inmo:micro_utils.serialization.typed_serializer", version.ref = "microutils" }
+microutils-serialization-mapper = { module = "dev.inmo:micro_utils.serialization.mapper", version.ref = "microutils" }
 microutils-languageCodes = { module = "dev.inmo:micro_utils.language_codes", version.ref = "microutils" }
 microutils-ktor-common = { module = "dev.inmo:micro_utils.ktor.common", version.ref = "microutils" }
 microutils-fsm-common = { module = "dev.inmo:micro_utils.fsm.common", version.ref = "microutils" }
+microutils-ksp-generator = { module = "dev.inmo:micro_utils.ksp.generator", version.ref = "microutils" }
+microutils-ksp-sealed = { module = "dev.inmo:micro_utils.ksp.sealed", version.ref = "microutils" }
+microutils-ksp-sealed-generator = { module = "dev.inmo:micro_utils.ksp.sealed.generator", version.ref = "microutils" }
+microutils-ksp-variations = { module = "dev.inmo:micro_utils.ksp.variations", version.ref = "microutils" }
+microutils-ksp-variations-generator = { module = "dev.inmo:micro_utils.ksp.variations.generator", version.ref = "microutils" }
+
+kslog = { module = "dev.inmo:kslog", version.ref = "kslog" }
 
 # ksp dependencies
 
@@ -58,7 +78,7 @@ ksp = { module = "com.google.devtools.ksp:symbol-processing-api", version.ref =
 kotlin-gradle-plugin = { module = "org.jetbrains.kotlin:kotlin-gradle-plugin", version.ref = "kotlin" }
 kotlin-ksp-plugin = { module = "com.google.devtools.ksp:symbol-processing-gradle-plugin", version.ref = "ksp" }
 kotlin-serialization-plugin = { module = "org.jetbrains.kotlin:kotlin-serialization", version.ref = "kotlin" }
-kotlin-dokka-plugin = { module = "org.jetbrains.dokka:dokka-gradle-plugin", version.ref = "kotlin" }
+kotlin-dokka-plugin = { module = "org.jetbrains.dokka:dokka-gradle-plugin", version.ref = "dokka" }
 github-release-plugin = { module = "com.github.breadmoirai:github-release", version.ref = "github-release-plugin" }
 
 [plugins]
@@ -66,3 +86,7 @@ github-release-plugin = { module = "com.github.breadmoirai:github-release", vers
 kotlin-jvm = { id = "org.jetbrains.kotlin.jvm", version.ref = "kotlin" }
 kotlin-multiplatform = { id = "org.jetbrains.kotlin.multiplatform", version.ref = "kotlin" }
 kotlin-serialization = { id = "org.jetbrains.kotlin.plugin.serialization", version.ref = "kotlin" }
+kotlin-dokka = { id = "org.jetbrains.dokka", version.ref = "dokka" }
+versions = { id = "com.github.ben-manes.versions", version.ref = "versions" }
+validator = { id = "org.jetbrains.kotlinx.binary-compatibility-validator", version.ref = "validator" }
+nmcp-aggregation = { id = "com.gradleup.nmcp.aggregation", version.ref = "nmcp" }

gradle/templates/mppJsProject.gradle

@@ -1,9 +1,12 @@
 project.version = "$version"
 project.group = "$group"
 
-apply from: "$publishGradlePath"
+apply from: "$mpp_publish"
 
 kotlin {
+    compilerOptions {
+        freeCompilerArgs.add("-Xcontext-parameters")
+    }
     js (IR) {
         browser()
         nodejs()
@@ -25,7 +28,6 @@ kotlin {
         jsTest {
             dependencies {
                 implementation libs.kotlin.test.js
-                implementation libs.kotlin.test.junit
             }
         }
     }

gradle/templates/mppProjectWithSerialization.gradle

@@ -2,10 +2,13 @@ project.version = "$library_version"
 project.group = "$library_group"
 
 kotlin {
+    compilerOptions {
+        freeCompilerArgs.add("-Xcontext-parameters")
+    }
     jvm {
         compilations.main {
             kotlinOptions {
-                jvmTarget = "1.8"
+                jvmTarget = "17"
             }
         }
     }
@@ -13,6 +16,9 @@ kotlin {
         browser()
         nodejs()
     }
+    linuxX64()
+    mingwX64()
+    linuxArm64()
 
     sourceSets {
         commonMain {
@@ -35,13 +41,20 @@ kotlin {
         jsTest {
             dependencies {
                 implementation libs.kotlin.test.js
-                implementation libs.kotlin.test.junit
+            }
+        }
+        all {
+            languageSettings {
+                optIn('dev.inmo.tgbotapi.utils.RiskFeature')
+                optIn('dev.inmo.tgbotapi.utils.PreviewFeature')
+                optIn('dev.inmo.micro_utils.common.Warning')
+                optIn('dev.inmo.micro_utils.common.PreviewFeature')
             }
         }
     }
 }
 
 java {
-    sourceCompatibility = JavaVersion.VERSION_1_8
-    targetCompatibility = JavaVersion.VERSION_1_8
+    sourceCompatibility = JavaVersion.VERSION_17
+    targetCompatibility = JavaVersion.VERSION_17
 }

gradle/templates/mpp_publish.gradle

@@ -0,0 +1,111 @@
+apply plugin: 'maven-publish'
+
+task javadocsJar(type: Jar) {
+    archiveClassifier = 'javadoc'
+}
+
+publishing {
+    publications.all {
+        artifact javadocsJar
+
+        pom {
+            description = "${project.description}"
+            name = "${project.name}"
+            url = "https://insanusmokrassar.github.io/TelegramBotAPI/TelegramBotAPI"
+
+            scm {
+                developerConnection = "scm:git:[fetch=]https://github.com/insanusmokrassar/TelegramBotAPI.git[push=]https://github.com/insanusmokrassar/TelegramBotAPI.git"
+                url = "https://github.com/insanusmokrassar/TelegramBotAPI.git"
+            }
+
+            developers {
+                developer {
+                    id = "InsanusMokrassar"
+                    name = "Ovsiannikov Aleksei"
+                    email = "ovsyannikov.alexey95@gmail.com"
+                }
+            }
+
+            licenses {
+                license {
+                    name = "Apache Software License 2.0"
+                    url = "https://github.com/InsanusMokrassar/TelegramBotAPI/blob/master/LICENSE"
+                }
+            }
+        }
+    }
+    repositories {
+        if ((project.hasProperty('GITHUB_USER') || System.getenv('GITHUB_USER') != null) && (project.hasProperty('GITHUB_TOKEN') || System.getenv('GITHUB_TOKEN') != null)) {
+            maven {
+                name = "GithubPackages"
+                url = uri("https://maven.pkg.github.com/InsanusMokrassar/ktgbotapi")
+        
+                credentials {
+                    username = project.hasProperty('GITHUB_USER') ? project.property('GITHUB_USER') : System.getenv('GITHUB_USER')
+                    password = project.hasProperty('GITHUB_TOKEN') ? project.property('GITHUB_TOKEN') : System.getenv('GITHUB_TOKEN')
+                }
+            }
+        }
+        if ((project.hasProperty('INMONEXUS_USER') || System.getenv('INMONEXUS_USER') != null) && (project.hasProperty('INMONEXUS_PASSWORD') || System.getenv('INMONEXUS_PASSWORD') != null)) {
+            maven {
+                name = "InmoNexus"
+                url = uri("https://nexus.inmo.dev/repository/maven-releases/")
+        
+                credentials {
+                    username = project.hasProperty('INMONEXUS_USER') ? project.property('INMONEXUS_USER') : System.getenv('INMONEXUS_USER')
+                    password = project.hasProperty('INMONEXUS_PASSWORD') ? project.property('INMONEXUS_PASSWORD') : System.getenv('INMONEXUS_PASSWORD')
+                }
+            }
+        }
+        if ((project.hasProperty('SONATYPE_USER') || System.getenv('SONATYPE_USER') != null) && (project.hasProperty('SONATYPE_PASSWORD') || System.getenv('SONATYPE_PASSWORD') != null)) {
+            maven {
+                name = "sonatype"
+                url = uri("https://ossrh-staging-api.central.sonatype.com/service/local/staging/deploy/maven2/")
+        
+                credentials {
+                    username = project.hasProperty('SONATYPE_USER') ? project.property('SONATYPE_USER') : System.getenv('SONATYPE_USER')
+                    password = project.hasProperty('SONATYPE_PASSWORD') ? project.property('SONATYPE_PASSWORD') : System.getenv('SONATYPE_PASSWORD')
+                }
+            }
+        }
+    }
+}
+    
+if (project.hasProperty("signing.gnupg.keyName")) {
+    apply plugin: 'signing'
+
+    signing {
+        useGpgCmd()
+
+        sign publishing.publications
+    }
+
+    task signAll {
+        tasks.withType(Sign).forEach {
+            dependsOn(it)
+        }
+    }
+
+    // Workaround to make android sign operations depend on signing tasks
+    project.getTasks().withType(AbstractPublishToMaven.class).configureEach {
+        def signingTasks = project.getTasks().withType(Sign.class)
+        mustRunAfter(signingTasks)
+    }
+    // Workaround to make test tasks use sign
+    project.getTasks().withType(Sign.class).configureEach { signTask ->
+        def withoutSign = (signTask.name.startsWith("sign") ? signTask.name.minus("sign") : signTask.name)
+        def pubName = withoutSign.endsWith("Publication") ? withoutSign.substring(0, withoutSign.length() - "Publication".length()) : withoutSign
+        // These tasks only exist for native targets, hence findByName() to avoid trying to find them for other targets
+
+        // Task ':linkDebugTest<platform>' uses this output of task ':sign<platform>Publication' without declaring an explicit or implicit dependency
+        def debugTestTask = tasks.findByName("linkDebugTest$pubName")
+        if (debugTestTask != null) {
+            signTask.mustRunAfter(debugTestTask)
+        }
+        // Task ':compileTestKotlin<platform>' uses this output of task ':sign<platform>Publication' without declaring an explicit or implicit dependency
+        def testTask = tasks.findByName("compileTestKotlin$pubName")
+        if (testTask != null) {
+            signTask.mustRunAfter(testTask)
+        }
+    }
+}

gradle/templates/mpp_publish.kpsb

@@ -0,0 +1 @@
+{"licenses":[{"id":"Apache-2.0","title":"Apache Software License 2.0","url":"https://github.com/InsanusMokrassar/TelegramBotAPI/blob/master/LICENSE"}],"mavenConfig":{"name":"${project.name}","description":"${project.description}","url":"https://insanusmokrassar.github.io/TelegramBotAPI/TelegramBotAPI","vcsUrl":"https://github.com/insanusmokrassar/TelegramBotAPI.git","developers":[{"id":"InsanusMokrassar","name":"Ovsiannikov Aleksei","eMail":"ovsyannikov.alexey95@gmail.com"}],"repositories":[{"name":"GithubPackages","url":"https://maven.pkg.github.com/InsanusMokrassar/ktgbotapi","credsType":{"type":"dev.inmo.kmppscriptbuilder.core.models.MavenPublishingRepository.CredentialsType.UsernameAndPassword","usernameProperty":"GITHUB_USER","passwordProperty":"GITHUB_TOKEN"}},{"name":"InmoNexus","url":"https://nexus.inmo.dev/repository/maven-releases/"},{"name":"sonatype","url":"https://ossrh-staging-api.central.sonatype.com/service/local/staging/deploy/maven2/"}],"gpgSigning":{"type":"dev.inmo.kmppscriptbuilder.core.models.GpgSigning.Optional"},"includeCentralSonatypeUploadingScript":false}}

gradle/wrapper/gradle-wrapper.properties

@@ -2,4 +2,4 @@ distributionBase=GRADLE_USER_HOME
 distributionPath=wrapper/dists
 zipStoreBase=GRADLE_USER_HOME
 zipStorePath=wrapper/dists
-distributionUrl=https\://services.gradle.org/distributions/gradle-7.5.1-bin.zip
+distributionUrl=https\://services.gradle.org/distributions/gradle-8.13-bin.zip

publish.gradle

@@ -1,79 +0,0 @@
-apply plugin: 'maven-publish'
-
-task javadocsJar(type: Jar) {
-    classifier = 'javadoc'
-}
-
-publishing {
-    publications.all {
-        artifact javadocsJar
-
-        pom {
-            description = "${project.description}"
-            name = "${project.name}"
-            url = "https://insanusmokrassar.github.io/TelegramBotAPI/TelegramBotAPI"
-
-            scm {
-                developerConnection = "scm:git:[fetch=]https://github.com/insanusmokrassar/TelegramBotAPI.git[push=]https://github.com/insanusmokrassar/TelegramBotAPI.git"
-                url = "https://github.com/insanusmokrassar/TelegramBotAPI.git"
-            }
-
-            developers {
-                
-                    developer {
-                        id = "InsanusMokrassar"
-                        name = "Ovsiannikov Aleksei"
-                        email = "ovsyannikov.alexey95@gmail.com"
-                    }
-                
-            }
-
-            licenses {
-                
-                    license {
-                        name = "Apache Software License 2.0"
-                        url = "https://github.com/InsanusMokrassar/TelegramBotAPI/blob/master/LICENSE"
-                    }
-                
-            }
-        }
-        repositories {
-            if ((project.hasProperty('GITHUBPACKAGES_USER') || System.getenv('GITHUBPACKAGES_USER') != null) && (project.hasProperty('GITHUBPACKAGES_PASSWORD') || System.getenv('GITHUBPACKAGES_PASSWORD') != null)) {
-                maven {
-                    name = "GithubPackages"
-                    url = uri("https://maven.pkg.github.com/InsanusMokrassar/TelegramBotAPI")
-                    credentials {
-                        username = project.hasProperty('GITHUBPACKAGES_USER') ? project.property('GITHUBPACKAGES_USER') : System.getenv('GITHUBPACKAGES_USER')
-                        password = project.hasProperty('GITHUBPACKAGES_PASSWORD') ? project.property('GITHUBPACKAGES_PASSWORD') : System.getenv('GITHUBPACKAGES_PASSWORD')
-                    }
-                }
-            }
-            if ((project.hasProperty('SONATYPE_USER') || System.getenv('SONATYPE_USER') != null) && (project.hasProperty('SONATYPE_PASSWORD') || System.getenv('SONATYPE_PASSWORD') != null)) {
-                maven {
-                    name = "sonatype"
-                    url = uri("https://oss.sonatype.org/service/local/staging/deploy/maven2/")
-                    credentials {
-                        username = project.hasProperty('SONATYPE_USER') ? project.property('SONATYPE_USER') : System.getenv('SONATYPE_USER')
-                        password = project.hasProperty('SONATYPE_PASSWORD') ? project.property('SONATYPE_PASSWORD') : System.getenv('SONATYPE_PASSWORD')
-                    }
-                }
-            }
-        }
-    }
-}
-    
-if (project.hasProperty("signing.gnupg.keyName")) {
-    apply plugin: 'signing'
-    
-    signing {
-        useGpgCmd()
-    
-        sign publishing.publications
-    }
-    
-    task signAll {
-        tasks.withType(Sign).forEach {
-            dependsOn(it)
-        }
-    }
-}

publish.kpsb

@@ -1 +0,0 @@
-{"licenses":[{"id":"Apache-2.0","title":"Apache Software License 2.0","url":"https://github.com/InsanusMokrassar/TelegramBotAPI/blob/master/LICENSE"}],"mavenConfig":{"name":"${project.name}","description":"${project.description}","url":"https://insanusmokrassar.github.io/TelegramBotAPI/TelegramBotAPI","vcsUrl":"https://github.com/insanusmokrassar/TelegramBotAPI.git","developers":[{"id":"InsanusMokrassar","name":"Ovsiannikov Aleksei","eMail":"ovsyannikov.alexey95@gmail.com"}],"repositories":[{"name":"GithubPackages","url":"https://maven.pkg.github.com/InsanusMokrassar/TelegramBotAPI"},{"name":"sonatype","url":"https://oss.sonatype.org/service/local/staging/deploy/maven2/"}],"gpgSigning":{"type":"dev.inmo.kmppscriptbuilder.core.models.GpgSigning.Optional"}}}

settings.gradle

@@ -19,4 +19,3 @@ include ":tgbotapi.behaviour_builder"
 include ":tgbotapi.behaviour_builder.fsm"
 include ":tgbotapi"
 include ":tgbotapi.webapps"
-include ":docs"

tgbotapi.api/build.gradle

@@ -1,20 +1,31 @@
 plugins {
     id "org.jetbrains.kotlin.multiplatform"
     id "org.jetbrains.kotlin.plugin.serialization"
+    id "org.jetbrains.dokka"
+    id "com.google.devtools.ksp"
 }
 
 project.description = "API extensions with \"Telegram Bot API\"-like extensions for TelegramBot and RequestsExecutor"
 
-apply from: "$mppProjectWithSerializationPresetPath"
-apply from: "$publishGradlePath"
+apply from: "$mppProjectWithSerialization"
+apply from: "$mpp_publish"
 
 kotlin {
     sourceSets {
         commonMain {
             dependencies {
                 api project(":tgbotapi.core")
+                api libs.microutils.ksp.variations
             }
         }
+        configureEach {
+            languageSettings.optIn("kotlinx.serialization.ExperimentalSerializationApi")
+        }
     }
+    explicitApi()
+}
+
+dependencies {
+    add("kspCommonMainMetadata", libs.microutils.ksp.variations.generator)
 }
 

tgbotapi.api/src/commonMain/kotlin/dev/inmo/tgbotapi/extensions/api/BotBuilder.kt

@@ -12,10 +12,11 @@ import io.ktor.client.engine.*
  * @param ktorClientEngine Engine like [io.ktor.client.engine.cio.CIO]
  * @param ktorClientConfig Config block for preconfiguring of bot [HttpClient]
  */
-data class BotBuilder internal constructor(
+@ConsistentCopyVisibility
+public data class BotBuilder internal constructor(
     var proxy: ProxyConfig? = null,
     var ktorClientEngineFactory: HttpClientEngineFactory<HttpClientEngineConfig>? = null,
-    var ktorClientConfig: (HttpClientConfig<*>.() -> Unit) ? = null
+    var ktorClientConfig: (HttpClientConfig<*>.() -> Unit) ? = null,
 ) {
     internal fun createHttpClient(): HttpClient = ktorClientEngineFactory ?.let {
         HttpClient(
@@ -37,12 +38,18 @@ data class BotBuilder internal constructor(
  * @return Created by [telegramBotWithCustomClientConfig] function [TelegramBot]. This executor will be preconfigured using [token] and
  * [block]
  */
-fun buildBot(
+public fun buildBot(
     token: String,
     apiUrl: String = telegramBotAPIDefaultUrl,
     testServer: Boolean = false,
+    fileLinkUrlMapper: TelegramAPIUrlsKeeper.(String) -> String = { "${fileBaseUrl}/$it" },
     block: BotBuilder.() -> Unit
-) = telegramBot(
-    TelegramAPIUrlsKeeper(token, testServer, apiUrl),
-    BotBuilder().apply(block).createHttpClient()
+): TelegramBot = telegramBot(
+    urlsKeeper = TelegramAPIUrlsKeeper(
+        token = token,
+        testServer = testServer,
+        hostUrl = apiUrl,
+        fileLinkUrlMapper = fileLinkUrlMapper
+    ),
+    client = BotBuilder().apply(block).createHttpClient()
 )

tgbotapi.api/src/commonMain/kotlin/dev/inmo/tgbotapi/extensions/api/BotExtensions.kt

@@ -3,6 +3,7 @@ package dev.inmo.tgbotapi.extensions.api
 import dev.inmo.tgbotapi.bot.ktor.telegramBot
 import dev.inmo.tgbotapi.bot.TelegramBot
 import dev.inmo.tgbotapi.utils.TelegramAPIUrlsKeeper
+import dev.inmo.tgbotapi.utils.defaultKtorEngine
 import dev.inmo.tgbotapi.utils.telegramBotAPIDefaultUrl
 import io.ktor.client.HttpClient
 import io.ktor.client.HttpClientConfig
@@ -11,9 +12,9 @@ import io.ktor.client.engine.*
 /**
  * Allows to create bot using bot [urlsKeeper] and already prepared [client]
  */
-fun telegramBot(
+public fun telegramBot(
     urlsKeeper: TelegramAPIUrlsKeeper,
-    client: HttpClient = HttpClient()
+    client: HttpClient = HttpClient(defaultKtorEngine)
 ): TelegramBot = telegramBot(urlsKeeper) {
     this.client = client
 }
@@ -23,11 +24,11 @@ fun telegramBot(
  * configure it with [clientConfig]
  */
 @Suppress("NOTHING_TO_INLINE")
-inline fun <T: HttpClientEngineConfig> telegramBot(
+public inline fun <T: HttpClientEngineConfig> telegramBot(
     urlsKeeper: TelegramAPIUrlsKeeper,
     clientFactory: HttpClientEngineFactory<T>,
     noinline clientConfig: HttpClientConfig<T>.() -> Unit = {}
-) = telegramBot(
+): TelegramBot = telegramBot(
     urlsKeeper,
     HttpClient(clientFactory, clientConfig)
 )
@@ -37,11 +38,11 @@ inline fun <T: HttpClientEngineConfig> telegramBot(
  * configure [HttpClient] using [clientConfig]
  */
 @Suppress("NOTHING_TO_INLINE")
-inline fun telegramBot(
+public inline fun telegramBot(
     urlsKeeper: TelegramAPIUrlsKeeper,
     clientEngine: HttpClientEngine,
     noinline clientConfig: HttpClientConfig<*>.() -> Unit = {}
-) = telegramBot(
+): TelegramBot = telegramBot(
     urlsKeeper,
     HttpClient(clientEngine, clientConfig)
 )
@@ -51,10 +52,10 @@ inline fun telegramBot(
  * [clientConfig]
  */
 @Suppress("NOTHING_TO_INLINE")
-inline fun telegramBot(
+public inline fun telegramBot(
     urlsKeeper: TelegramAPIUrlsKeeper,
     noinline clientConfig: HttpClientConfig<*>.() -> Unit
-) = telegramBot(
+): TelegramBot = telegramBot(
     urlsKeeper,
     HttpClient(clientConfig)
 )
@@ -63,22 +64,24 @@ inline fun telegramBot(
  * Allows to create bot using bot [token], [apiUrl] (for custom api servers) and already prepared [client]
  */
 @Suppress("NOTHING_TO_INLINE")
-inline fun telegramBot(
+public fun telegramBot(
     token: String,
     apiUrl: String = telegramBotAPIDefaultUrl,
     testServer: Boolean = false,
-    client: HttpClient = HttpClient()
-): TelegramBot = telegramBot(TelegramAPIUrlsKeeper(token, testServer, apiUrl), client)
+    fileLinkUrlMapper: TelegramAPIUrlsKeeper.(String) -> String = { "${fileBaseUrl}/$it" },
+    client: HttpClient = HttpClient(defaultKtorEngine)
+): TelegramBot = telegramBot(TelegramAPIUrlsKeeper(token, testServer, apiUrl, fileLinkUrlMapper), client)
 
 @Suppress("NOTHING_TO_INLINE")
-inline fun <T: HttpClientEngineConfig> telegramBot(
+public fun <T: HttpClientEngineConfig> telegramBot(
     token: String,
     clientFactory: HttpClientEngineFactory<T>,
     apiUrl: String = telegramBotAPIDefaultUrl,
     testServer: Boolean = false,
-    noinline clientConfig: HttpClientConfig<T>.() -> Unit = {}
-) = telegramBot(
-    TelegramAPIUrlsKeeper(token, testServer, apiUrl),
+    fileLinkUrlMapper: TelegramAPIUrlsKeeper.(String) -> String = { "${fileBaseUrl}/$it" },
+    clientConfig: HttpClientConfig<T>.() -> Unit = {}
+): TelegramBot = telegramBot(
+    TelegramAPIUrlsKeeper(token, testServer, apiUrl, fileLinkUrlMapper),
     clientFactory,
     clientConfig
 )
@@ -87,15 +90,15 @@ inline fun <T: HttpClientEngineConfig> telegramBot(
  * Allows to create bot using bot [token] and specify [HttpClientEngine] by passing [clientEngine] param and optionally
  * configure [HttpClient] using [clientConfig]
  */
-@Suppress("NOTHING_TO_INLINE")
-inline fun telegramBot(
+public fun telegramBot(
     token: String,
     clientEngine: HttpClientEngine,
     apiUrl: String = telegramBotAPIDefaultUrl,
     testServer: Boolean = false,
-    noinline clientConfig: HttpClientConfig<*>.() -> Unit = {}
-) = telegramBot(
-    TelegramAPIUrlsKeeper(token, testServer, apiUrl),
+    fileLinkUrlMapper: TelegramAPIUrlsKeeper.(String) -> String = { "${fileBaseUrl}/$it" },
+    clientConfig: HttpClientConfig<*>.() -> Unit = {}
+): TelegramBot = telegramBot(
+    TelegramAPIUrlsKeeper(token, testServer, apiUrl, fileLinkUrlMapper),
     clientEngine,
     clientConfig
 )
@@ -104,13 +107,13 @@ inline fun telegramBot(
  * Allows to create bot using bot [token] and [apiUrl] and specify [HttpClientEngine] by configuring [HttpClient] using
  * [clientConfig]
  */
-@Suppress("NOTHING_TO_INLINE")
-inline fun telegramBot(
+public fun telegramBot(
     token: String,
     apiUrl: String = telegramBotAPIDefaultUrl,
     testServer: Boolean = false,
-    noinline clientConfig: HttpClientConfig<*>.() -> Unit
-) = telegramBot(
-    TelegramAPIUrlsKeeper(token, testServer, apiUrl),
+    fileLinkUrlMapper: TelegramAPIUrlsKeeper.(String) -> String = { "${fileBaseUrl}/$it" },
+    clientConfig: HttpClientConfig<*>.() -> Unit
+): TelegramBot = telegramBot(
+    TelegramAPIUrlsKeeper(token, testServer, apiUrl, fileLinkUrlMapper),
     clientConfig
 )

tgbotapi.api/src/commonMain/kotlin/dev/inmo/tgbotapi/extensions/api/Close.kt

@@ -3,5 +3,4 @@ package dev.inmo.tgbotapi.extensions.api
 import dev.inmo.tgbotapi.bot.TelegramBot
 import dev.inmo.tgbotapi.requests.local.Close
 
-@Suppress("unused")
-suspend inline fun TelegramBot.close() = execute(Close)
+public suspend inline fun TelegramBot.executeClose(): Boolean = execute(Close)

tgbotapi.api/src/commonMain/kotlin/dev/inmo/tgbotapi/extensions/api/DeleteMessage.kt

@@ -3,40 +3,51 @@ package dev.inmo.tgbotapi.extensions.api
 import dev.inmo.tgbotapi.bot.TelegramBot
 import dev.inmo.tgbotapi.requests.DeleteMessage
 import dev.inmo.tgbotapi.types.ChatIdentifier
-import dev.inmo.tgbotapi.types.MessageIdentifier
+import dev.inmo.tgbotapi.types.MessageId
 import dev.inmo.tgbotapi.types.chat.Chat
-import dev.inmo.tgbotapi.types.message.abstracts.Message
+import dev.inmo.tgbotapi.types.message.abstracts.ContentMessage
+import dev.inmo.tgbotapi.types.message.abstracts.AccessibleMessage
+import dev.inmo.tgbotapi.types.message.content.MediaGroupCollectionContent
 
-suspend fun TelegramBot.deleteMessage(
+public suspend fun TelegramBot.deleteMessage(
     chatId: ChatIdentifier,
-    messageId: MessageIdentifier
-) = execute(
+    messageId: MessageId
+): Boolean = execute(
     DeleteMessage(chatId, messageId)
 )
 
-suspend fun TelegramBot.deleteMessage(
+public suspend fun TelegramBot.deleteMessage(
     chat: Chat,
-    messageId: MessageIdentifier
-) = deleteMessage(chat.id, messageId)
+    messageId: MessageId
+): Boolean = deleteMessage(chat.id, messageId)
 
-suspend fun TelegramBot.deleteMessage(
-    message: Message
-) = deleteMessage(message.chat, message.messageId)
+public suspend fun TelegramBot.deleteMessage(
+    message: AccessibleMessage
+): Boolean {
+    val mediaGroupContent = ((message as? ContentMessage<*>) ?.content as? MediaGroupCollectionContent<*>)
+    if (mediaGroupContent == null) {
+        return deleteMessage(message.chat, message.messageId)
+    } else {
+        return mediaGroupContent.group.map {
+            deleteMessage(it.sourceMessage)
+        }.all { it }
+    }
+}
 
-suspend fun TelegramBot.delete(
+public suspend fun TelegramBot.delete(
     chatId: ChatIdentifier,
-    messageId: MessageIdentifier
-) = deleteMessage(chatId, messageId)
+    messageId: MessageId
+): Boolean = deleteMessage(chatId, messageId)
 
-suspend fun TelegramBot.delete(
+public suspend fun TelegramBot.delete(
     chat: Chat,
-    messageId: MessageIdentifier
-) = deleteMessage(chat, messageId)
+    messageId: MessageId
+): Boolean = deleteMessage(chat, messageId)
 
-suspend fun TelegramBot.delete(
-    message: Message
-) = deleteMessage(message)
+public suspend fun TelegramBot.delete(
+    message: AccessibleMessage
+): Boolean = deleteMessage(message)
 
-suspend fun Message.delete(
+public suspend fun AccessibleMessage.delete(
     requestsExecutor: TelegramBot
-) = requestsExecutor.deleteMessage(this)
+): Boolean = requestsExecutor.deleteMessage(this)

tgbotapi.api/src/commonMain/kotlin/dev/inmo/tgbotapi/extensions/api/DeleteMessages.kt

@@ -0,0 +1,61 @@
+package dev.inmo.tgbotapi.extensions.api
+
+import dev.inmo.tgbotapi.bot.TelegramBot
+import dev.inmo.tgbotapi.requests.DeleteMessages
+import dev.inmo.tgbotapi.types.*
+import dev.inmo.tgbotapi.types.message.abstracts.AccessibleMessage
+import dev.inmo.tgbotapi.types.message.abstracts.Message
+import kotlin.jvm.JvmName
+
+public suspend fun TelegramBot.deleteMessages(
+    chatId: ChatIdentifier,
+    messageIds: List<MessageId>
+): Boolean = messageIds.chunked(deleteMessagesLimit.last).map {
+    execute(
+        DeleteMessages(
+            chatId = chatId,
+            messageIds = it
+        )
+    )
+}.all { it }
+
+public suspend fun TelegramBot.deleteMessages(
+    chatId: ChatIdentifier,
+    messageIds: Array<MessageId>
+): Boolean = deleteMessages(
+    chatId = chatId,
+    messageIds = messageIds.toList()
+)
+
+public suspend fun TelegramBot.deleteMessages(
+    messagesMetas: List<Message.MetaInfo>
+): Boolean = messagesMetas.groupBy { it.chatId }.map { (chatId, messages) ->
+    deleteMessages(
+        chatId = chatId,
+        messageIds = messages.map { it.messageId }
+    )
+}.all { it }
+
+@JvmName("deleteMessagesWithMessages")
+public suspend fun TelegramBot.deleteMessages(
+    messages: List<AccessibleMessage>
+): Boolean = deleteMessages(messages.map { it.metaInfo })
+
+public suspend fun TelegramBot.delete(
+    chatId: ChatIdentifier,
+    messageIds: List<MessageId>
+): Boolean = deleteMessages(chatId = chatId, messageIds = messageIds)
+
+public suspend fun TelegramBot.delete(
+    chatId: ChatIdentifier,
+    messageIds: Array<MessageId>
+): Boolean = deleteMessages(chatId = chatId, messageIds = messageIds)
+
+public suspend fun TelegramBot.delete(
+    messagesMetas: List<Message.MetaInfo>
+): Boolean = deleteMessages(messagesMetas)
+
+@JvmName("deleteWithMessages")
+public suspend fun TelegramBot.delete(
+    messages: List<AccessibleMessage>
+): Boolean = deleteMessages(messages)

tgbotapi.api/src/commonMain/kotlin/dev/inmo/tgbotapi/extensions/api/ForwardMessage.kt

@@ -3,54 +3,78 @@ package dev.inmo.tgbotapi.extensions.api
 import dev.inmo.tgbotapi.bot.TelegramBot
 import dev.inmo.tgbotapi.requests.ForwardMessage
 import dev.inmo.tgbotapi.types.ChatIdentifier
-import dev.inmo.tgbotapi.types.MessageIdentifier
+import dev.inmo.tgbotapi.types.DirectMessageThreadId
+import dev.inmo.tgbotapi.types.MessageId
+import dev.inmo.tgbotapi.types.MessageThreadId
+import dev.inmo.tgbotapi.types.Seconds
 import dev.inmo.tgbotapi.types.chat.Chat
-import dev.inmo.tgbotapi.types.message.abstracts.Message
+import dev.inmo.tgbotapi.types.message.abstracts.AccessibleMessage
+import dev.inmo.tgbotapi.types.message.abstracts.PossiblyForwardedMessage
+import dev.inmo.tgbotapi.types.directMessageThreadId
+import dev.inmo.tgbotapi.types.threadId
 
-suspend fun TelegramBot.forwardMessage(
+public suspend fun TelegramBot.forwardMessage(
     fromChatId: ChatIdentifier,
     toChatId: ChatIdentifier,
-    messageId: MessageIdentifier,
+    messageId: MessageId,
+    threadId: MessageThreadId? = toChatId.threadId,
+    directMessageThreadId: DirectMessageThreadId? = toChatId.directMessageThreadId,
+    startTimestamp: Seconds? = null,
     disableNotification: Boolean = false,
     protectContent: Boolean = false
-) = execute(
-    ForwardMessage(fromChatId, toChatId, messageId, disableNotification, protectContent)
+): PossiblyForwardedMessage = execute(
+    ForwardMessage(fromChatId, toChatId, messageId, threadId, directMessageThreadId, startTimestamp, disableNotification, protectContent)
 )
 
-suspend fun TelegramBot.forwardMessage(
+public suspend fun TelegramBot.forwardMessage(
     fromChat: Chat,
     toChatId: ChatIdentifier,
-    messageId: MessageIdentifier,
+    messageId: MessageId,
+    threadId: MessageThreadId? = toChatId.threadId,
+    directMessageThreadId: DirectMessageThreadId? = toChatId.directMessageThreadId,
+    startTimestamp: Seconds? = null,
     disableNotification: Boolean = false,
     protectContent: Boolean = false
-) = forwardMessage(fromChat.id, toChatId, messageId, disableNotification, protectContent)
+): PossiblyForwardedMessage = forwardMessage(fromChat.id, toChatId, messageId, threadId, directMessageThreadId, startTimestamp, disableNotification, protectContent)
 
-suspend fun TelegramBot.forwardMessage(
+public suspend fun TelegramBot.forwardMessage(
     fromChatId: ChatIdentifier,
     toChat: Chat,
-    messageId: MessageIdentifier,
+    messageId: MessageId,
+    threadId: MessageThreadId? = toChat.id.threadId,
+    directMessageThreadId: DirectMessageThreadId? = toChat.id.directMessageThreadId,
+    startTimestamp: Seconds? = null,
     disableNotification: Boolean = false,
     protectContent: Boolean = false
-) = forwardMessage(fromChatId, toChat.id, messageId, disableNotification, protectContent)
+): PossiblyForwardedMessage = forwardMessage(fromChatId, toChat.id, messageId, threadId, directMessageThreadId, startTimestamp, disableNotification, protectContent)
 
-suspend fun TelegramBot.forwardMessage(
+public suspend fun TelegramBot.forwardMessage(
     fromChat: Chat,
     toChat: Chat,
-    messageId: MessageIdentifier,
+    messageId: MessageId,
+    threadId: MessageThreadId? = toChat.id.threadId,
+    directMessageThreadId: DirectMessageThreadId? = toChat.id.directMessageThreadId,
+    startTimestamp: Seconds? = null,
     disableNotification: Boolean = false,
     protectContent: Boolean = false
-) = forwardMessage(fromChat.id, toChat.id, messageId, disableNotification, protectContent)
+): PossiblyForwardedMessage = forwardMessage(fromChat.id, toChat.id, messageId, threadId, directMessageThreadId, startTimestamp, disableNotification, protectContent)
 
-suspend fun TelegramBot.forwardMessage(
+public suspend fun TelegramBot.forwardMessage(
     toChatId: ChatIdentifier,
-    message: Message,
+    message: AccessibleMessage,
+    threadId: MessageThreadId? = toChatId.threadId,
+    directMessageThreadId: DirectMessageThreadId? = toChatId.directMessageThreadId,
+    startTimestamp: Seconds? = null,
     disableNotification: Boolean = false,
     protectContent: Boolean = false
-) = forwardMessage(message.chat, toChatId, message.messageId, disableNotification, protectContent)
+): PossiblyForwardedMessage = forwardMessage(message.chat, toChatId, message.messageId, threadId, directMessageThreadId, startTimestamp, disableNotification, protectContent)
 
-suspend fun TelegramBot.forwardMessage(
+public suspend fun TelegramBot.forwardMessage(
     toChat: Chat,
-    message: Message,
+    message: AccessibleMessage,
+    threadId: MessageThreadId? = toChat.id.threadId,
+    directMessageThreadId: DirectMessageThreadId? = toChat.id.directMessageThreadId,
+    startTimestamp: Seconds? = null,
     disableNotification: Boolean = false,
     protectContent: Boolean = false
-) = forwardMessage(message.chat, toChat, message.messageId, disableNotification, protectContent)
+): PossiblyForwardedMessage = forwardMessage(message.chat, toChat, message.messageId, threadId, directMessageThreadId, startTimestamp, disableNotification, protectContent)

tgbotapi.api/src/commonMain/kotlin/dev/inmo/tgbotapi/extensions/api/ForwardMessages.kt

@@ -0,0 +1,170 @@
+package dev.inmo.tgbotapi.extensions.api
+
+import dev.inmo.tgbotapi.bot.TelegramBot
+import dev.inmo.tgbotapi.extensions.api.send.copyMessages
+import dev.inmo.tgbotapi.requests.ForwardMessages
+import dev.inmo.tgbotapi.types.*
+import dev.inmo.tgbotapi.types.message.abstracts.AccessibleMessage
+import dev.inmo.tgbotapi.types.message.abstracts.Message
+import kotlin.jvm.JvmName
+
+public suspend fun TelegramBot.forwardMessages(
+    toChatId: ChatIdentifier,
+    fromChatId: ChatIdentifier,
+    messageIds: List<MessageId>,
+    threadId: MessageThreadId? = toChatId.threadId,
+    directMessageThreadId: DirectMessageThreadId? = toChatId.directMessageThreadId,
+    disableNotification: Boolean = false,
+    protectContent: Boolean = false,
+    removeCaption: Boolean = false
+): List<MessageId> = messageIds.chunked(forwardMessagesLimit.last).flatMap {
+    execute(
+        ForwardMessages(
+            toChatId = toChatId,
+            fromChatId = fromChatId,
+            messageIds = it,
+            threadId = threadId,
+            directMessageThreadId = directMessageThreadId,
+            disableNotification = disableNotification,
+            protectContent = protectContent,
+            removeCaption = removeCaption
+        )
+    )
+}
+
+public suspend fun TelegramBot.forwardMessages(
+    toChatId: ChatIdentifier,
+    fromChatId: ChatIdentifier,
+    messageIds: Array<MessageId>,
+    threadId: MessageThreadId? = toChatId.threadId,
+    directMessageThreadId: DirectMessageThreadId? = toChatId.directMessageThreadId,
+    disableNotification: Boolean = false,
+    protectContent: Boolean = false,
+    removeCaption: Boolean = false
+): List<MessageId> = forwardMessages(
+    toChatId = toChatId,
+    fromChatId = fromChatId,
+    messageIds = messageIds.toList(),
+    threadId = threadId,
+    directMessageThreadId = directMessageThreadId,
+    disableNotification = disableNotification,
+    protectContent = protectContent,
+    removeCaption = removeCaption
+)
+
+public suspend fun TelegramBot.forwardMessages(
+    toChatId: ChatIdentifier,
+    messagesMetas: List<Message.MetaInfo>,
+    threadId: MessageThreadId? = toChatId.threadId,
+    directMessageThreadId: DirectMessageThreadId? = toChatId.directMessageThreadId,
+    disableNotification: Boolean = false,
+    protectContent: Boolean = false,
+    removeCaption: Boolean = false
+): List<MessageId> = messagesMetas.groupBy { it.chatId }.flatMap { (chatId, messages) ->
+    forwardMessages(
+        toChatId = toChatId,
+        fromChatId = chatId,
+        messageIds = messages.map { it.messageId },
+        threadId = threadId,
+        directMessageThreadId = directMessageThreadId,
+        disableNotification = disableNotification,
+        protectContent = protectContent,
+        removeCaption = removeCaption
+    )
+}
+
+@JvmName("forwardMessagesWithMessages")
+public suspend fun TelegramBot.forwardMessages(
+    toChatId: ChatIdentifier,
+    messages: List<AccessibleMessage>,
+    threadId: MessageThreadId? = toChatId.threadId,
+    directMessageThreadId: DirectMessageThreadId? = toChatId.directMessageThreadId,
+    disableNotification: Boolean = false,
+    protectContent: Boolean = false,
+    removeCaption: Boolean = false
+): List<MessageId> = forwardMessages(
+    toChatId = toChatId,
+    messagesMetas = messages.map { it.metaInfo },
+    threadId = threadId,
+    directMessageThreadId = directMessageThreadId,
+    disableNotification = disableNotification,
+    protectContent = protectContent,
+    removeCaption = removeCaption
+)
+
+public suspend fun TelegramBot.forward(
+    toChatId: ChatIdentifier,
+    fromChatId: ChatIdentifier,
+    messageIds: List<MessageId>,
+    threadId: MessageThreadId? = toChatId.threadId,
+    directMessageThreadId: DirectMessageThreadId? = toChatId.directMessageThreadId,
+    disableNotification: Boolean = false,
+    protectContent: Boolean = false,
+    removeCaption: Boolean = false
+): List<MessageId> = forwardMessages(
+    toChatId = toChatId,
+    fromChatId = fromChatId,
+    messageIds = messageIds,
+    threadId = threadId,
+    directMessageThreadId = directMessageThreadId,
+    disableNotification = disableNotification,
+    protectContent = protectContent,
+    removeCaption = removeCaption
+)
+
+public suspend fun TelegramBot.forward(
+    toChatId: ChatIdentifier,
+    fromChatId: ChatIdentifier,
+    messageIds: Array<MessageId>,
+    threadId: MessageThreadId? = toChatId.threadId,
+    directMessageThreadId: DirectMessageThreadId? = toChatId.directMessageThreadId,
+    disableNotification: Boolean = false,
+    protectContent: Boolean = false,
+    removeCaption: Boolean = false
+): List<MessageId> = forwardMessages(
+    toChatId = toChatId,
+    fromChatId = fromChatId,
+    messageIds = messageIds,
+    threadId = threadId,
+    directMessageThreadId = directMessageThreadId,
+    disableNotification = disableNotification,
+    protectContent = protectContent,
+    removeCaption = removeCaption
+)
+
+public suspend fun TelegramBot.forward(
+    toChatId: ChatIdentifier,
+    messagesMetas: List<Message.MetaInfo>,
+    threadId: MessageThreadId? = toChatId.threadId,
+    directMessageThreadId: DirectMessageThreadId? = toChatId.directMessageThreadId,
+    disableNotification: Boolean = false,
+    protectContent: Boolean = false,
+    removeCaption: Boolean = false
+): List<MessageId> = forwardMessages(
+    toChatId = toChatId,
+    messagesMetas = messagesMetas,
+    threadId = threadId,
+    directMessageThreadId = directMessageThreadId,
+    disableNotification = disableNotification,
+    protectContent = protectContent,
+    removeCaption = removeCaption
+)
+
+@JvmName("forwardWithMessages")
+public suspend fun TelegramBot.forward(
+    toChatId: ChatIdentifier,
+    messages: List<AccessibleMessage>,
+    threadId: MessageThreadId? = toChatId.threadId,
+    directMessageThreadId: DirectMessageThreadId? = toChatId.directMessageThreadId,
+    disableNotification: Boolean = false,
+    protectContent: Boolean = false,
+    removeCaption: Boolean = false
+): List<MessageId> = forwardMessages(
+    toChatId = toChatId,
+    messages = messages,
+    threadId = threadId,
+    directMessageThreadId = directMessageThreadId,
+    disableNotification = disableNotification,
+    protectContent = protectContent,
+    removeCaption = removeCaption
+)

tgbotapi.api/src/commonMain/kotlin/dev/inmo/tgbotapi/extensions/api/GetUpdates.kt

@@ -5,22 +5,22 @@ import dev.inmo.tgbotapi.requests.GetUpdates
 import dev.inmo.tgbotapi.types.*
 import dev.inmo.tgbotapi.types.update.abstracts.Update
 
-suspend fun TelegramBot.getUpdates(
-    offset: UpdateIdentifier? = null,
+public suspend fun TelegramBot.getUpdates(
+    offset: UpdateId? = null,
     limit: Int = getUpdatesLimit.last,
     timeout: Seconds? = null,
     allowed_updates: List<String>? = ALL_UPDATES_LIST
-) = execute(
+): List<Update> = execute(
     GetUpdates(
         offset, limit, timeout, allowed_updates
     )
 )
 
-suspend fun TelegramBot.getUpdates(
+public suspend fun TelegramBot.getUpdates(
     lastUpdate: Update,
     limit: Int = getUpdatesLimit.last,
     timeout: Seconds? = null,
     allowed_updates: List<String>? = ALL_UPDATES_LIST
-) = getUpdates(
+): List<Update> = getUpdates(
     lastUpdate.updateId + 1, limit, timeout, allowed_updates
 )

tgbotapi.api/src/commonMain/kotlin/dev/inmo/tgbotapi/extensions/api/GetUpdatesRaw.kt

@@ -0,0 +1,27 @@
+package dev.inmo.tgbotapi.extensions.api
+
+import dev.inmo.tgbotapi.bot.TelegramBot
+import dev.inmo.tgbotapi.requests.GetUpdatesRaw
+import dev.inmo.tgbotapi.types.*
+import dev.inmo.tgbotapi.types.update.abstracts.Update
+import kotlinx.serialization.json.JsonArray
+
+public suspend fun TelegramBot.getRawUpdates(
+    offset: UpdateId? = null,
+    limit: Int = getUpdatesLimit.last,
+    timeout: Seconds? = null,
+    allowed_updates: List<String>? = ALL_UPDATES_LIST
+): JsonArray = execute(
+    GetUpdatesRaw(
+        offset, limit, timeout, allowed_updates
+    )
+)
+
+public suspend fun TelegramBot.getRawUpdates(
+    lastUpdate: Update,
+    limit: Int = getUpdatesLimit.last,
+    timeout: Seconds? = null,
+    allowed_updates: List<String>? = ALL_UPDATES_LIST
+): JsonArray = getRawUpdates(
+    lastUpdate.updateId + 1, limit, timeout, allowed_updates
+)

tgbotapi.api/src/commonMain/kotlin/dev/inmo/tgbotapi/extensions/api/InternalUtils/UpdatesUtils.kt

@@ -1,70 +1,52 @@
 package dev.inmo.tgbotapi.extensions.api.InternalUtils
 
-import dev.inmo.tgbotapi.types.MediaGroupIdentifier
-import dev.inmo.tgbotapi.types.UpdateIdentifier
-import dev.inmo.tgbotapi.types.message.abstracts.MediaGroupMessage
+import dev.inmo.tgbotapi.types.MediaGroupId
+import dev.inmo.tgbotapi.types.message.abstracts.PossiblySentViaBotCommonMessage
+import dev.inmo.tgbotapi.types.message.content.MediaGroupPartContent
 import dev.inmo.tgbotapi.types.update.*
 import dev.inmo.tgbotapi.types.update.abstracts.*
-import dev.inmo.tgbotapi.types.update.media_group.*
-
-internal fun Update.lastUpdateIdentifier(): UpdateIdentifier {
-    return if (this is SentMediaGroupUpdate) {
-        origins.last().updateId
-    } else {
-        updateId
-    }
-}
-
-internal fun List<Update>.lastUpdateIdentifier(): UpdateIdentifier? {
-    return maxByOrNull { it.updateId } ?.lastUpdateIdentifier()
-}
+import dev.inmo.tgbotapi.utils.extensions.asMediaGroupMessage
 
+/**
+ * Will convert incoming list of updates to list with [MediaGroupUpdate]s
+ */
 internal fun List<Update>.convertWithMediaGroupUpdates(): List<Update> {
     val resultUpdates = mutableListOf<Update>()
-    val mediaGroups = mutableMapOf<MediaGroupIdentifier, MutableList<BaseSentMessageUpdate>>()
+    val mediaGroups = mutableMapOf<MediaGroupId, MutableList<Pair<BaseSentMessageUpdate, PossiblySentViaBotCommonMessage<MediaGroupPartContent>>>>()
+
     for (update in this) {
-        val data = (update.data as? MediaGroupMessage<*>)
-        if (data == null) {
+        val message = (update.data as? PossiblySentViaBotCommonMessage<*>) ?.let {
+            if (it.content is MediaGroupPartContent) {
+                @Suppress("UNCHECKED_CAST")
+                it as PossiblySentViaBotCommonMessage<MediaGroupPartContent>
+            } else {
+                null
+            }
+        }
+        val mediaGroupId = message ?.mediaGroupId
+        if (message == null || mediaGroupId == null) {
             resultUpdates.add(update)
             continue
         }
         when (update) {
-            is BaseEditMessageUpdate -> resultUpdates.add(
-                update.toEditMediaGroupUpdate()
-            )
             is BaseSentMessageUpdate -> {
-                mediaGroups.getOrPut(data.mediaGroupId) {
+                mediaGroups.getOrPut(mediaGroupId) {
                     mutableListOf()
-                }.add(update)
+                }.add(update to message)
             }
             else -> resultUpdates.add(update)
         }
     }
-    mediaGroups.values.map {
-        it.toSentMediaGroupUpdate() ?.let { mediaGroupUpdate ->
-            resultUpdates.add(mediaGroupUpdate)
-        }
+
+    mediaGroups.map { (_, updatesWithMessages) ->
+        val update = updatesWithMessages.maxBy { it.first.updateId }.first
+        resultUpdates.add(
+            update.copy(updatesWithMessages.map { it.second }.asMediaGroupMessage())
+        )
     }
+
     resultUpdates.sortBy { it.updateId }
     return resultUpdates
 }
 
-internal fun List<BaseSentMessageUpdate>.toSentMediaGroupUpdate(): SentMediaGroupUpdate? = (this as? SentMediaGroupUpdate) ?: let {
-    if (isEmpty()) {
-        return@let null
-    }
-    val resultList = sortedBy { it.updateId }
-    when (first()) {
-        is MessageUpdate -> MessageMediaGroupUpdate(resultList)
-        is ChannelPostUpdate -> ChannelPostMediaGroupUpdate(resultList)
-        else -> null
-    }
-}
-
-internal fun BaseEditMessageUpdate.toEditMediaGroupUpdate(): EditMediaGroupUpdate = (this as? EditMediaGroupUpdate) ?: let {
-    when (this) {
-        is EditMessageUpdate -> EditMessageMediaGroupUpdate(this)
-        is EditChannelPostUpdate -> EditChannelPostMediaGroupUpdate(this)
-        else -> error("Unsupported type of ${BaseEditMessageUpdate::class.simpleName}")
-    }
-}
+internal fun BaseEditMessageUpdate.toEditMediaGroupUpdate(): BaseEditMessageUpdate = this

tgbotapi.api/src/commonMain/kotlin/dev/inmo/tgbotapi/extensions/api/LiveFlowLocation.kt

@@ -1,28 +1,39 @@
 package dev.inmo.tgbotapi.extensions.api
 
-import dev.inmo.micro_utils.coroutines.LinkedSupervisorJob
-import dev.inmo.micro_utils.coroutines.launchSafelyWithoutExceptions
-import dev.inmo.tgbotapi.abstracts.*
+import dev.inmo.micro_utils.coroutines.LinkedSupervisorScope
+import dev.inmo.tgbotapi.abstracts.Headed
+import dev.inmo.tgbotapi.abstracts.HorizontallyAccured
+import dev.inmo.tgbotapi.abstracts.Locationed
+import dev.inmo.tgbotapi.abstracts.ProximityAlertable
 import dev.inmo.tgbotapi.abstracts.types.WithReplyMarkup
 import dev.inmo.tgbotapi.bot.TelegramBot
-import dev.inmo.tgbotapi.extensions.api.edit.location.live.editLiveLocation
+import dev.inmo.tgbotapi.extensions.api.edit.edit
+import dev.inmo.tgbotapi.extensions.api.send.send
 import dev.inmo.tgbotapi.extensions.api.send.sendLiveLocation
 import dev.inmo.tgbotapi.types.*
+import dev.inmo.tgbotapi.types.business_connection.BusinessConnectionId
 import dev.inmo.tgbotapi.types.buttons.InlineKeyboardMarkup
 import dev.inmo.tgbotapi.types.location.LiveLocation
 import dev.inmo.tgbotapi.types.location.Location
+import dev.inmo.tgbotapi.types.message.SuggestedPostParameters
 import dev.inmo.tgbotapi.types.message.abstracts.ContentMessage
+import dev.inmo.tgbotapi.types.message.content.LiveLocationContent
 import dev.inmo.tgbotapi.types.message.content.LocationContent
-import kotlinx.coroutines.*
+import dev.inmo.tgbotapi.utils.launchWithBotLogger
+import kotlinx.coroutines.CoroutineStart
+import kotlinx.coroutines.currentCoroutineContext
+import kotlinx.coroutines.delay
 import kotlinx.coroutines.flow.Flow
+import kotlinx.coroutines.flow.FlowCollector
 import kotlinx.coroutines.flow.map
+import kotlinx.coroutines.isActive
 import kotlinx.serialization.Serializable
 import kotlin.js.JsName
 import kotlin.jvm.JvmName
 import kotlin.math.ceil
 
 @Serializable
-data class EditLiveLocationInfo(
+public data class EditLiveLocationInfo(
     override val latitude: Double,
     override val longitude: Double,
     override val horizontalAccuracy: Meters? = null,
@@ -35,51 +46,75 @@ data class EditLiveLocationInfo(
  * Will [sendLiveLocation] with the first [EditLiveLocationInfo] data and update than. Each [liveTimeMillis] passing,
  * the message will be sent again and new edits will be applied to the new message
  */
-suspend fun TelegramBot.handleLiveLocation(
+public suspend fun TelegramBot.handleLiveLocation(
     chatId: ChatIdentifier,
     locationsFlow: Flow<EditLiveLocationInfo>,
     liveTimeMillis: Long = defaultLivePeriodDelayMillis,
+    threadId: MessageThreadId? = chatId.threadId,
+    directMessageThreadId: DirectMessageThreadId? = chatId.directMessageThreadId,
+    businessConnectionId: BusinessConnectionId? = chatId.businessConnectionId,
     disableNotification: Boolean = false,
     protectContent: Boolean = false,
-    replyToMessageId: MessageIdentifier? = null,
-    allowSendingWithoutReply: Boolean? = null
+    allowPaidBroadcast: Boolean = false,
+    effectId: EffectId? = null,
+    suggestedPostParameters: SuggestedPostParameters? = null,
+    replyParameters: ReplyParameters? = null,
+    sentMessageFlow: FlowCollector<ContentMessage<LiveLocationContent>>? = null
 ) {
-    var currentLiveLocationMessage: ContentMessage<LocationContent>? = null
-    val updateMessageJob = CoroutineScope(currentCoroutineContext().LinkedSupervisorJob()).launchSafelyWithoutExceptions(start = CoroutineStart.LAZY) {
-        while (isActive) {
-            delay(liveTimeMillis)
-            // Remove previous location message info to resend live location message
-            currentLiveLocationMessage = null
+    var currentLiveLocationMessage: ContentMessage<LiveLocationContent>? = null
+    val updateMessageJob = if (liveTimeMillis == indefiniteLivePeriodDelayMillis) { // do not launch refreshing of message for indefinite live locations
+        null
+    } else {
+        val scope = currentCoroutineContext().LinkedSupervisorScope()
+        scope.launchWithBotLogger(start = CoroutineStart.LAZY) {
+            while (scope.isActive) {
+                delay(liveTimeMillis)
+                // Remove previous location message info to resend live location message
+                currentLiveLocationMessage = null
+            }
         }
     }
     locationsFlow.collect {
         val capturedLiveLocationMessage = currentLiveLocationMessage
         if (capturedLiveLocationMessage == null) {
-            updateMessageJob.start()
-            currentLiveLocationMessage = sendLiveLocation(
-                chatId,
-                it.latitude,
-                it.longitude,
-                ceil(liveTimeMillis.toDouble() / 1000).toInt(),
-                it.horizontalAccuracy,
-                it.heading,
-                it.proximityAlertRadius,
-                disableNotification,
-                protectContent,
-                replyToMessageId,
-                allowSendingWithoutReply,
-                it.replyMarkup
-            )
+            updateMessageJob ?.start()
+            currentLiveLocationMessage = send(
+                chatId = chatId,
+                latitude = it.latitude,
+                longitude = it.longitude,
+                livePeriod = if (liveTimeMillis == indefiniteLivePeriodDelayMillis) {
+                    LiveLocation.INDEFINITE_LIVE_PERIOD
+                } else {
+                    ceil(liveTimeMillis.toDouble() / 1000).toInt()
+                },
+                horizontalAccuracy = it.horizontalAccuracy,
+                heading = it.heading,
+                proximityAlertRadius = it.proximityAlertRadius,
+                threadId = threadId,
+                directMessageThreadId = directMessageThreadId,
+                businessConnectionId = businessConnectionId,
+                disableNotification = disableNotification,
+                protectContent = protectContent,
+                allowPaidBroadcast = allowPaidBroadcast,
+                effectId = effectId,
+                suggestedPostParameters = suggestedPostParameters,
+                replyParameters = replyParameters,
+                replyMarkup = it.replyMarkup
+            ).also {
+                sentMessageFlow ?.emit(it)
+            }
         } else {
-            editLiveLocation(
-                capturedLiveLocationMessage,
-                it.latitude,
-                it.longitude,
-                it.horizontalAccuracy,
-                it.heading,
-                it.proximityAlertRadius,
-                it.replyMarkup
-            )
+            edit(
+                message = capturedLiveLocationMessage,
+                latitude = it.latitude,
+                longitude = it.longitude,
+                horizontalAccuracy = it.horizontalAccuracy,
+                heading = it.heading,
+                proximityAlertRadius = it.proximityAlertRadius,
+                replyMarkup = it.replyMarkup
+            ).also {
+                sentMessageFlow ?.emit(it)
+            }
         }
     }
 }
@@ -90,18 +125,24 @@ suspend fun TelegramBot.handleLiveLocation(
  */
 @JvmName("handleLiveLocationWithLocation")
 @JsName("handleLiveLocationWithLocation")
-suspend fun TelegramBot.handleLiveLocation(
+public suspend fun TelegramBot.handleLiveLocation(
     chatId: ChatIdentifier,
     locationsFlow: Flow<Location>,
     liveTimeMillis: Long = defaultLivePeriodDelayMillis,
+    threadId: MessageThreadId? = chatId.threadId,
+    directMessageThreadId: DirectMessageThreadId? = chatId.directMessageThreadId,
+    businessConnectionId: BusinessConnectionId? = chatId.businessConnectionId,
     disableNotification: Boolean = false,
     protectContent: Boolean = false,
-    replyToMessageId: MessageIdentifier? = null,
-    allowSendingWithoutReply: Boolean? = null
+    allowPaidBroadcast: Boolean = false,
+    effectId: EffectId? = null,
+    suggestedPostParameters: SuggestedPostParameters? = null,
+    replyParameters: ReplyParameters? = null,
+    sentMessageFlow: FlowCollector<ContentMessage<LiveLocationContent>>? = null
 ) {
     handleLiveLocation(
-        chatId,
-        locationsFlow.map {
+        chatId = chatId,
+        locationsFlow = locationsFlow.map {
             EditLiveLocationInfo(
                 it.latitude,
                 it.longitude,
@@ -111,11 +152,17 @@ suspend fun TelegramBot.handleLiveLocation(
                 (it as? WithReplyMarkup) ?.replyMarkup as? InlineKeyboardMarkup
             )
         },
-        liveTimeMillis,
-        disableNotification,
-        protectContent,
-        replyToMessageId,
-        allowSendingWithoutReply
+        liveTimeMillis = liveTimeMillis,
+        threadId = threadId,
+        directMessageThreadId = directMessageThreadId,
+        businessConnectionId = businessConnectionId,
+        disableNotification = disableNotification,
+        protectContent = protectContent,
+        allowPaidBroadcast = allowPaidBroadcast,
+        effectId = effectId,
+        suggestedPostParameters = suggestedPostParameters,
+        replyParameters = replyParameters,
+        sentMessageFlow = sentMessageFlow
     )
 }
 
@@ -125,27 +172,39 @@ suspend fun TelegramBot.handleLiveLocation(
  */
 @JvmName("handleLiveLocationWithLatLong")
 @JsName("handleLiveLocationWithLatLong")
-suspend fun TelegramBot.handleLiveLocation(
+public suspend fun TelegramBot.handleLiveLocation(
     chatId: ChatIdentifier,
     locationsFlow: Flow<Pair<Double, Double>>,
     liveTimeMillis: Long = defaultLivePeriodDelayMillis,
+    threadId: MessageThreadId? = chatId.threadId,
+    directMessageThreadId: DirectMessageThreadId? = chatId.directMessageThreadId,
+    businessConnectionId: BusinessConnectionId? = chatId.businessConnectionId,
     disableNotification: Boolean = false,
     protectContent: Boolean = false,
-    replyToMessageId: MessageIdentifier? = null,
-    allowSendingWithoutReply: Boolean? = null
+    allowPaidBroadcast: Boolean = false,
+    effectId: EffectId? = null,
+    suggestedPostParameters: SuggestedPostParameters? = null,
+    replyParameters: ReplyParameters? = null,
+    sentMessageFlow: FlowCollector<ContentMessage<LiveLocationContent>>? = null
 ) {
     handleLiveLocation(
-        chatId,
-        locationsFlow.map { (lat, long) ->
+        chatId = chatId,
+        locationsFlow = locationsFlow.map { (lat, long) ->
             EditLiveLocationInfo(
                 lat,
                 long
             )
         },
-        liveTimeMillis,
-        disableNotification,
-        protectContent,
-        replyToMessageId,
-        allowSendingWithoutReply
+        liveTimeMillis = liveTimeMillis,
+        threadId = threadId,
+        directMessageThreadId = directMessageThreadId,
+        businessConnectionId = businessConnectionId,
+        disableNotification = disableNotification,
+        protectContent = protectContent,
+        allowPaidBroadcast = allowPaidBroadcast,
+        effectId = effectId,
+        suggestedPostParameters = suggestedPostParameters,
+        replyParameters = replyParameters,
+        sentMessageFlow = sentMessageFlow
     )
 }

tgbotapi.api/src/commonMain/kotlin/dev/inmo/tgbotapi/extensions/api/LiveLocationProvider.kt

@@ -1,31 +1,39 @@
+@file:Suppress("KDocUnresolvedReference")
+
 package dev.inmo.tgbotapi.extensions.api
 
-import com.soywiz.klock.DateTime
-import com.soywiz.klock.TimeSpan
+import korlibs.time.DateTime
+import korlibs.time.TimeSpan
 import dev.inmo.tgbotapi.bot.TelegramBot
 import dev.inmo.tgbotapi.extensions.api.edit.location.live.editLiveLocation
 import dev.inmo.tgbotapi.extensions.api.edit.location.live.stopLiveLocation
 import dev.inmo.tgbotapi.requests.send.SendLiveLocation
 import dev.inmo.tgbotapi.types.*
+import dev.inmo.tgbotapi.types.business_connection.BusinessConnectionId
 import dev.inmo.tgbotapi.types.buttons.InlineKeyboardMarkup
 import dev.inmo.tgbotapi.types.buttons.KeyboardMarkup
 import dev.inmo.tgbotapi.types.chat.Chat
+import dev.inmo.tgbotapi.types.message.SuggestedPostParameters
 import dev.inmo.tgbotapi.types.location.LiveLocation
 import dev.inmo.tgbotapi.types.location.StaticLocation
 import dev.inmo.tgbotapi.types.message.abstracts.ContentMessage
-import dev.inmo.tgbotapi.types.message.abstracts.Message
+import dev.inmo.tgbotapi.types.message.abstracts.AccessibleMessage
 import dev.inmo.tgbotapi.types.message.content.LocationContent
+import dev.inmo.tgbotapi.utils.extensions.directMessageThreadIdOrNull
+import dev.inmo.tgbotapi.utils.extensions.threadIdOrNull
 import io.ktor.utils.io.core.Closeable
+import korlibs.time.millisecondsLong
 import kotlinx.coroutines.CoroutineScope
 import kotlinx.coroutines.launch
 import kotlin.math.ceil
 
-val defaultLivePeriodDelayMillis = (livePeriodLimit.last - 60L) * 1000L
+public const val indefiniteLivePeriodDelayMillis: Long = LiveLocation.INDEFINITE_LIVE_PERIOD * 1000L
+public const val defaultLivePeriodDelayMillis: Long = indefiniteLivePeriodDelayMillis
 
 /**
  * @see startLiveLocation
  */
-class LiveLocationProvider internal constructor(
+public class LiveLocationProvider internal constructor(
     private val requestsExecutor: TelegramBot,
     scope: CoroutineScope,
     autoCloseTimeDelay: Double,
@@ -37,22 +45,23 @@ class LiveLocationProvider internal constructor(
         }
     }
     private val autoCloseTime = DateTime.now() + TimeSpan(autoCloseTimeDelay)
-    val leftUntilCloseMillis: TimeSpan
+    public val leftUntilCloseMillis: TimeSpan
         get() = autoCloseTime - DateTime.now()
 
-    var isClosed: Boolean = false
+    public var isClosed: Boolean = false
         private set
         get() = field || leftUntilCloseMillis.millisecondsLong < 0L
 
-    private var message: ContentMessage<LocationContent> = initMessage
-    val lastLocation: LiveLocation
+    public var message: ContentMessage<LocationContent> = initMessage
+        private set
+    public val lastLocation: LiveLocation
         get() = message.content.location as LiveLocation
 
     /**
      * @param replyMarkup Some [InlineKeyboardMarkup]. See [dev.inmo.tgbotapi.extensions.utils.types.buttons.inlineKeyboard]
      * as a builder for that
      */
-    suspend fun updateLocation(
+    public suspend fun updateLocation(
         location: LiveLocation,
         replyMarkup: InlineKeyboardMarkup? = null
     ): LiveLocation {
@@ -60,7 +69,7 @@ class LiveLocationProvider internal constructor(
             message = requestsExecutor.editLiveLocation(
                 message,
                 location,
-                replyMarkup
+                replyMarkup = replyMarkup
             )
             return lastLocation
         } else {
@@ -81,7 +90,7 @@ class LiveLocationProvider internal constructor(
  * @param replyMarkup Some of [KeyboardMarkup]. See [dev.inmo.tgbotapi.extensions.utils.types.buttons.replyKeyboard] or
  * [dev.inmo.tgbotapi.extensions.utils.types.buttons.inlineKeyboard] as a builders for that param
  */
-suspend fun TelegramBot.startLiveLocation(
+public suspend fun TelegramBot.startLiveLocation(
     scope: CoroutineScope,
     chatId: ChatIdentifier,
     latitude: Double,
@@ -90,27 +99,37 @@ suspend fun TelegramBot.startLiveLocation(
     initHorizontalAccuracy: Meters? = null,
     initHeading: Degrees? = null,
     initProximityAlertRadius: Meters? = null,
+    threadId: MessageThreadId? = chatId.threadId,
+    directMessageThreadId: DirectMessageThreadId? = chatId.directMessageThreadId,
+    businessConnectionId: BusinessConnectionId? = chatId.businessConnectionId,
     disableNotification: Boolean = false,
     protectContent: Boolean = false,
-    replyToMessageId: MessageIdentifier? = null,
-    allowSendingWithoutReply: Boolean? = null,
+    allowPaidBroadcast: Boolean = false,
+    effectId: EffectId? = null,
+    suggestedPostParameters: SuggestedPostParameters? = null,
+    replyParameters: ReplyParameters? = null,
     replyMarkup: KeyboardMarkup? = null
 ): LiveLocationProvider {
     val liveTimeAsDouble = liveTimeMillis.toDouble()
     val locationMessage = execute(
         SendLiveLocation(
-            chatId,
-            latitude,
-            longitude,
-            ceil(liveTimeAsDouble / 1000).toInt(),
-            initHorizontalAccuracy,
-            initHeading,
-            initProximityAlertRadius,
-            disableNotification,
-            protectContent,
-            replyToMessageId,
-            allowSendingWithoutReply,
-            replyMarkup
+            chatId = chatId,
+            latitude = latitude,
+            longitude = longitude,
+            livePeriod = ceil(liveTimeAsDouble / 1000).toInt(),
+            horizontalAccuracy = initHorizontalAccuracy,
+            heading = initHeading,
+            proximityAlertRadius = initProximityAlertRadius,
+            threadId = threadId,
+            directMessageThreadId = directMessageThreadId,
+            businessConnectionId = businessConnectionId,
+            disableNotification = disableNotification,
+            protectContent = protectContent,
+            allowPaidBroadcast = allowPaidBroadcast,
+            effectId = effectId,
+            suggestedPostParameters = suggestedPostParameters,
+            replyParameters = replyParameters,
+            replyMarkup = replyMarkup
         )
     )
 
@@ -126,7 +145,7 @@ suspend fun TelegramBot.startLiveLocation(
  * @param replyMarkup Some of [KeyboardMarkup]. See [dev.inmo.tgbotapi.extensions.utils.types.buttons.replyKeyboard] or
  * [dev.inmo.tgbotapi.extensions.utils.types.buttons.inlineKeyboard] as a builders for that param
  */
-suspend fun TelegramBot.startLiveLocation(
+public suspend fun TelegramBot.startLiveLocation(
     scope: CoroutineScope,
     chat: Chat,
     latitude: Double,
@@ -135,65 +154,85 @@ suspend fun TelegramBot.startLiveLocation(
     initHorizontalAccuracy: Meters? = null,
     initHeading: Degrees? = null,
     initProximityAlertRadius: Meters? = null,
+    threadId: MessageThreadId? = chat.id.threadId,
+    directMessageThreadId: DirectMessageThreadId? = chat.id.directMessageThreadId,
+    businessConnectionId: BusinessConnectionId? = chat.id.businessConnectionId,
     disableNotification: Boolean = false,
     protectContent: Boolean = false,
-    replyToMessageId: MessageIdentifier? = null,
-    allowSendingWithoutReply: Boolean? = null,
+    allowPaidBroadcast: Boolean = false,
+    effectId: EffectId? = null,
+    suggestedPostParameters: SuggestedPostParameters? = null,
+    replyParameters: ReplyParameters? = null,
     replyMarkup: KeyboardMarkup? = null
 ): LiveLocationProvider = startLiveLocation(
-    scope,
-    chat.id,
-    latitude,
-    longitude,
-    liveTimeMillis,
-    initHorizontalAccuracy,
-    initHeading,
-    initProximityAlertRadius,
-    disableNotification,
-    protectContent,
-    replyToMessageId,
-    allowSendingWithoutReply,
-    replyMarkup
+    scope = scope,
+    chatId = chat.id,
+    latitude = latitude,
+    longitude = longitude,
+    liveTimeMillis = liveTimeMillis,
+    initHorizontalAccuracy = initHorizontalAccuracy,
+    initHeading = initHeading,
+    initProximityAlertRadius = initProximityAlertRadius,
+    threadId = threadId,
+    directMessageThreadId = directMessageThreadId,
+    businessConnectionId = businessConnectionId,
+    disableNotification = disableNotification,
+    protectContent = protectContent,
+    allowPaidBroadcast = allowPaidBroadcast,
+    effectId = effectId,
+    suggestedPostParameters = suggestedPostParameters,
+    replyParameters = replyParameters,
+    replyMarkup = replyMarkup
 )
 
 /**
  * @param replyMarkup Some of [KeyboardMarkup]. See [dev.inmo.tgbotapi.extensions.utils.types.buttons.replyKeyboard] or
  * [dev.inmo.tgbotapi.extensions.utils.types.buttons.inlineKeyboard] as a builders for that param
  */
-suspend fun TelegramBot.startLiveLocation(
+public suspend fun TelegramBot.startLiveLocation(
     scope: CoroutineScope,
-    chatId: ChatId,
+    chatId: IdChatIdentifier,
     location: StaticLocation,
     liveTimeMillis: Long = defaultLivePeriodDelayMillis,
     initHorizontalAccuracy: Meters? = null,
     initHeading: Degrees? = null,
     initProximityAlertRadius: Meters? = null,
+    threadId: MessageThreadId? = chatId.threadId,
+    directMessageThreadId: DirectMessageThreadId? = chatId.directMessageThreadId,
+    businessConnectionId: BusinessConnectionId? = chatId.businessConnectionId,
     disableNotification: Boolean = false,
     protectContent: Boolean = false,
-    replyToMessageId: MessageIdentifier? = null,
-    allowSendingWithoutReply: Boolean? = null,
+    allowPaidBroadcast: Boolean = false,
+    effectId: EffectId? = null,
+    suggestedPostParameters: SuggestedPostParameters? = null,
+    replyParameters: ReplyParameters? = null,
     replyMarkup: KeyboardMarkup? = null
 ): LiveLocationProvider = startLiveLocation(
-    scope,
-    chatId,
-    location.latitude,
-    location.longitude,
-    liveTimeMillis,
-    initHorizontalAccuracy,
-    initHeading,
-    initProximityAlertRadius,
-    disableNotification,
-    protectContent,
-    replyToMessageId,
-    allowSendingWithoutReply,
-    replyMarkup
+    scope = scope,
+    chatId = chatId,
+    latitude = location.latitude,
+    longitude = location.longitude,
+    liveTimeMillis = liveTimeMillis,
+    initHorizontalAccuracy = initHorizontalAccuracy,
+    initHeading = initHeading,
+    initProximityAlertRadius = initProximityAlertRadius,
+    threadId = threadId,
+    directMessageThreadId = directMessageThreadId,
+    businessConnectionId = businessConnectionId,
+    disableNotification = disableNotification,
+    protectContent = protectContent,
+    allowPaidBroadcast = allowPaidBroadcast,
+    effectId = effectId,
+    suggestedPostParameters = suggestedPostParameters,
+    replyParameters = replyParameters,
+    replyMarkup = replyMarkup
 )
 
 /**
  * @param replyMarkup Some of [KeyboardMarkup]. See [dev.inmo.tgbotapi.extensions.utils.types.buttons.replyKeyboard] or
  * [dev.inmo.tgbotapi.extensions.utils.types.buttons.inlineKeyboard] as a builders for that param
  */
-suspend fun TelegramBot.startLiveLocation(
+public suspend fun TelegramBot.startLiveLocation(
     scope: CoroutineScope,
     chat: Chat,
     location: StaticLocation,
@@ -201,33 +240,43 @@ suspend fun TelegramBot.startLiveLocation(
     initHorizontalAccuracy: Meters? = null,
     initHeading: Degrees? = null,
     initProximityAlertRadius: Meters? = null,
+    threadId: MessageThreadId? = chat.id.threadId,
+    directMessageThreadId: DirectMessageThreadId? = chat.id.directMessageThreadId,
+    businessConnectionId: BusinessConnectionId? = chat.id.businessConnectionId,
     disableNotification: Boolean = false,
     protectContent: Boolean = false,
-    replyToMessageId: MessageIdentifier? = null,
-    allowSendingWithoutReply: Boolean? = null,
+    allowPaidBroadcast: Boolean = false,
+    effectId: EffectId? = null,
+    suggestedPostParameters: SuggestedPostParameters? = null,
+    replyParameters: ReplyParameters? = null,
     replyMarkup: KeyboardMarkup? = null
 ): LiveLocationProvider = startLiveLocation(
-    scope,
-    chat.id,
-    location.latitude,
-    location.longitude,
-    liveTimeMillis,
-    initHorizontalAccuracy,
-    initHeading,
-    initProximityAlertRadius,
-    disableNotification,
-    protectContent,
-    replyToMessageId,
-    allowSendingWithoutReply,
-    replyMarkup
+    scope = scope,
+    chatId = chat.id,
+    latitude = location.latitude,
+    longitude = location.longitude,
+    liveTimeMillis = liveTimeMillis,
+    initHorizontalAccuracy = initHorizontalAccuracy,
+    initHeading = initHeading,
+    initProximityAlertRadius = initProximityAlertRadius,
+    threadId = threadId,
+    directMessageThreadId = directMessageThreadId,
+    businessConnectionId = businessConnectionId,
+    disableNotification = disableNotification,
+    protectContent = protectContent,
+    allowPaidBroadcast = allowPaidBroadcast,
+    effectId = effectId,
+    suggestedPostParameters = suggestedPostParameters,
+    replyParameters = replyParameters,
+    replyMarkup = replyMarkup
 )
 
 /**
  * @param replyMarkup Some of [KeyboardMarkup]. See [dev.inmo.tgbotapi.extensions.utils.types.buttons.replyKeyboard] or
  * [dev.inmo.tgbotapi.extensions.utils.types.buttons.inlineKeyboard] as a builders for that param
  */
-suspend inline fun TelegramBot.replyWithLiveLocation(
-    to: Message,
+public suspend inline fun TelegramBot.replyWithLiveLocation(
+    to: AccessibleMessage,
     scope: CoroutineScope,
     latitude: Double,
     longitude: Double,
@@ -235,53 +284,75 @@ suspend inline fun TelegramBot.replyWithLiveLocation(
     initHorizontalAccuracy: Meters? = null,
     initHeading: Degrees? = null,
     initProximityAlertRadius: Meters? = null,
+    threadId: MessageThreadId? = to.threadIdOrNull,
+    directMessageThreadId: DirectMessageThreadId? = to.directMessageThreadIdOrNull,
+    businessConnectionId: BusinessConnectionId? = to.businessConnectionId,
     disableNotification: Boolean = false,
     protectContent: Boolean = false,
+    allowPaidBroadcast: Boolean = false,
+    effectId: EffectId? = null,
+    suggestedPostParameters: SuggestedPostParameters? = null,
     allowSendingWithoutReply: Boolean? = null,
     replyMarkup: KeyboardMarkup? = null
-) = startLiveLocation(
-    scope,
-    to.chat,
-    latitude,
-    longitude,
-    liveTimeMillis,
-    initHorizontalAccuracy,
-    initHeading,
-    initProximityAlertRadius,
-    disableNotification,
-    protectContent,
-    to.messageId,
-    allowSendingWithoutReply,
-    replyMarkup
+): LiveLocationProvider = startLiveLocation(
+    scope = scope,
+    chat = to.chat,
+    latitude = latitude,
+    longitude = longitude,
+    liveTimeMillis = liveTimeMillis,
+    initHorizontalAccuracy = initHorizontalAccuracy,
+    initHeading = initHeading,
+    initProximityAlertRadius = initProximityAlertRadius,
+    threadId = threadId,
+    directMessageThreadId = directMessageThreadId,
+    businessConnectionId = businessConnectionId,
+    disableNotification = disableNotification,
+    protectContent = protectContent,
+    allowPaidBroadcast = allowPaidBroadcast,
+    effectId = effectId,
+    suggestedPostParameters = suggestedPostParameters,
+    replyParameters = ReplyParameters(to.metaInfo, allowSendingWithoutReply = allowSendingWithoutReply),
+    replyMarkup = replyMarkup
 )
 
 /**
  * @param replyMarkup Some of [KeyboardMarkup]. See [dev.inmo.tgbotapi.extensions.utils.types.buttons.replyKeyboard] or
  * [dev.inmo.tgbotapi.extensions.utils.types.buttons.inlineKeyboard] as a builders for that param
  */
-suspend inline fun TelegramBot.replyWithLiveLocation(
-    to: Message,
+public suspend inline fun TelegramBot.replyWithLiveLocation(
+    to: AccessibleMessage,
     scope: CoroutineScope,
     location: StaticLocation,
     liveTimeMillis: Long = defaultLivePeriodDelayMillis,
     initHorizontalAccuracy: Meters? = null,
     initHeading: Degrees? = null,
     initProximityAlertRadius: Meters? = null,
+    threadId: MessageThreadId? = to.threadIdOrNull,
+    directMessageThreadId: DirectMessageThreadId? = to.directMessageThreadIdOrNull,
+    businessConnectionId: BusinessConnectionId? = to.businessConnectionId,
     disableNotification: Boolean = false,
     protectContent: Boolean = false,
+    allowPaidBroadcast: Boolean = false,
+    effectId: EffectId? = null,
+    suggestedPostParameters: SuggestedPostParameters? = null,
     allowSendingWithoutReply: Boolean? = null,
     replyMarkup: KeyboardMarkup? = null
-) = startLiveLocation(
-    scope,
-    to.chat,
-    location,
-    liveTimeMillis,
-    initHorizontalAccuracy,
-    initHeading,
-    initProximityAlertRadius,
-    disableNotification,
-    protectContent,
-    to.messageId,
-    allowSendingWithoutReply,
-    replyMarkup
+): LiveLocationProvider = startLiveLocation(
+    scope = scope,
+    chat = to.chat,
+    location = location,
+    liveTimeMillis = liveTimeMillis,
+    initHorizontalAccuracy = initHorizontalAccuracy,
+    initHeading = initHeading,
+    initProximityAlertRadius = initProximityAlertRadius,
+    threadId = threadId,
+    directMessageThreadId = directMessageThreadId,
+    businessConnectionId = businessConnectionId,
+    disableNotification = disableNotification,
+    protectContent = protectContent,
+    allowPaidBroadcast = allowPaidBroadcast,
+    effectId = effectId,
+    suggestedPostParameters = suggestedPostParameters,
+    replyParameters = ReplyParameters(to.metaInfo, allowSendingWithoutReply = allowSendingWithoutReply),
+    replyMarkup = replyMarkup
 )

tgbotapi.api/src/commonMain/kotlin/dev/inmo/tgbotapi/extensions/api/LogOut.kt

@@ -3,4 +3,4 @@ package dev.inmo.tgbotapi.extensions.api
 import dev.inmo.tgbotapi.bot.TelegramBot
 import dev.inmo.tgbotapi.requests.local.LogOut
 
-suspend inline fun TelegramBot.logOut() = execute(LogOut)
+public suspend inline fun TelegramBot.logOut(): Boolean = execute(LogOut)

tgbotapi.api/src/commonMain/kotlin/dev/inmo/tgbotapi/extensions/api/StopPoll.kt

@@ -3,48 +3,54 @@ package dev.inmo.tgbotapi.extensions.api
 import dev.inmo.tgbotapi.bot.TelegramBot
 import dev.inmo.tgbotapi.requests.StopPoll
 import dev.inmo.tgbotapi.types.*
+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.message.abstracts.Message
+import dev.inmo.tgbotapi.types.message.abstracts.AccessibleMessage
+import dev.inmo.tgbotapi.types.polls.Poll
 
 /**
  * @param replyMarkup Some [InlineKeyboardMarkup]. See [dev.inmo.tgbotapi.extensions.utils.types.buttons.inlineKeyboard]
  * as a builder for that
  */
-suspend fun TelegramBot.stopPoll(
+public suspend fun TelegramBot.stopPoll(
     chatId: ChatIdentifier,
-    messageId: MessageIdentifier,
+    messageId: MessageId,
+    businessConnectionId: BusinessConnectionId? = chatId.businessConnectionId,
     replyMarkup: InlineKeyboardMarkup? = null
-) = execute(
-    StopPoll(chatId, messageId, replyMarkup)
+): Poll = execute(
+    StopPoll(chatId, messageId, businessConnectionId, replyMarkup)
 )
 
 /**
  * @param replyMarkup Some [InlineKeyboardMarkup]. See [dev.inmo.tgbotapi.extensions.utils.types.buttons.inlineKeyboard]
  * as a builder for that
  */
-suspend fun TelegramBot.stopPoll(
+public suspend fun TelegramBot.stopPoll(
     chat: Chat,
-    messageId: MessageIdentifier,
+    messageId: MessageId,
+    businessConnectionId: BusinessConnectionId? = chat.id.businessConnectionId,
     replyMarkup: InlineKeyboardMarkup? = null
-) = stopPoll(chat.id, messageId, replyMarkup)
+): Poll = stopPoll(chat.id, messageId, businessConnectionId, replyMarkup)
 
 /**
  * @param replyMarkup Some [InlineKeyboardMarkup]. See [dev.inmo.tgbotapi.extensions.utils.types.buttons.inlineKeyboard]
  * as a builder for that
  */
-suspend fun TelegramBot.stopPoll(
-    chatId: ChatId,
-    message: Message,
+public suspend fun TelegramBot.stopPoll(
+    chatId: IdChatIdentifier,
+    message: AccessibleMessage,
+    businessConnectionId: BusinessConnectionId? = chatId.businessConnectionId,
     replyMarkup: InlineKeyboardMarkup? = null
-) = stopPoll(chatId, message.messageId, replyMarkup)
+): Poll = stopPoll(chatId, message.messageId, businessConnectionId, replyMarkup)
 
 /**
  * @param replyMarkup Some [InlineKeyboardMarkup]. See [dev.inmo.tgbotapi.extensions.utils.types.buttons.inlineKeyboard]
  * as a builder for that
  */
-suspend fun TelegramBot.stopPoll(
+public suspend fun TelegramBot.stopPoll(
     chat: Chat,
-    message: Message,
+    message: AccessibleMessage,
+    businessConnectionId: BusinessConnectionId? = chat.id.businessConnectionId,
     replyMarkup: InlineKeyboardMarkup? = null
-) = stopPoll(chat.id, message.messageId, replyMarkup)
+): Poll = stopPoll(chat.id, message.messageId, businessConnectionId, replyMarkup)

tgbotapi.api/src/commonMain/kotlin/dev/inmo/tgbotapi/extensions/api/answers/AnswerCallbackQuery.kt

@@ -3,28 +3,28 @@ package dev.inmo.tgbotapi.extensions.api.answers
 import dev.inmo.tgbotapi.bot.TelegramBot
 import dev.inmo.tgbotapi.requests.answers.AnswerCallbackQuery
 import dev.inmo.tgbotapi.types.queries.callback.CallbackQuery
-import dev.inmo.tgbotapi.types.CallbackQueryIdentifier
+import dev.inmo.tgbotapi.types.CallbackQueryId
 
-suspend fun TelegramBot.answerCallbackQuery(
-    callbackQueryId: CallbackQueryIdentifier,
+public suspend fun TelegramBot.answerCallbackQuery(
+    callbackQueryId: CallbackQueryId,
     text: String? = null,
     showAlert: Boolean? = null,
     url: String? = null,
     cachedTimeSeconds: Int? = null
-) = execute(AnswerCallbackQuery(callbackQueryId, text, showAlert, url, cachedTimeSeconds))
+): Boolean = execute(AnswerCallbackQuery(callbackQueryId, text, showAlert, url, cachedTimeSeconds))
 
-suspend fun TelegramBot.answerCallbackQuery(
+public suspend fun TelegramBot.answerCallbackQuery(
     callbackQuery: CallbackQuery,
     text: String? = null,
     showAlert: Boolean? = null,
     url: String? = null,
     cachedTimeSeconds: Int? = null
-) = answerCallbackQuery(callbackQuery.id, text, showAlert, url, cachedTimeSeconds)
+): Boolean = answerCallbackQuery(callbackQuery.id, text, showAlert, url, cachedTimeSeconds)
 
-suspend fun TelegramBot.answer(
+public suspend fun TelegramBot.answer(
     callbackQuery: CallbackQuery,
     text: String? = null,
     showAlert: Boolean? = null,
     url: String? = null,
     cachedTimeSeconds: Int? = null
-) = answerCallbackQuery(callbackQuery.id, text, showAlert, url, cachedTimeSeconds)
+): Boolean = answerCallbackQuery(callbackQuery.id, text, showAlert, url, cachedTimeSeconds)

tgbotapi.api/src/commonMain/kotlin/dev/inmo/tgbotapi/extensions/api/answers/AnswerInlineQuery.kt

@@ -2,38 +2,68 @@ package dev.inmo.tgbotapi.extensions.api.answers
 
 import dev.inmo.tgbotapi.bot.TelegramBot
 import dev.inmo.tgbotapi.requests.answers.AnswerInlineQuery
+import dev.inmo.tgbotapi.requests.answers.InlineQueryResultsButton
 import dev.inmo.tgbotapi.types.InlineQueries.InlineQueryResult.abstracts.InlineQueryResult
 import dev.inmo.tgbotapi.types.InlineQueries.query.InlineQuery
-import dev.inmo.tgbotapi.types.InlineQueryIdentifier
+import dev.inmo.tgbotapi.types.InlineQueryId
 
-suspend fun TelegramBot.answerInlineQuery(
-    inlineQueryID: InlineQueryIdentifier,
+public suspend fun TelegramBot.answerInlineQuery(
+    inlineQueryID: InlineQueryId,
     results: List<InlineQueryResult> = emptyList(),
     cachedTime: Int? = null,
     isPersonal: Boolean? = null,
     nextOffset: String? = null,
-    switchPmText: String? = null,
-    switchPmParameter: String? = null
-) = execute(
+    button: InlineQueryResultsButton? = null
+): Boolean = execute(
+    AnswerInlineQuery(inlineQueryID, results, cachedTime, isPersonal, nextOffset, button)
+)
+
+public suspend fun TelegramBot.answerInlineQuery(
+    inlineQuery: InlineQuery,
+    results: List<InlineQueryResult> = emptyList(),
+    cachedTime: Int? = null,
+    isPersonal: Boolean? = null,
+    nextOffset: String? = null,
+    button: InlineQueryResultsButton? = null
+): Boolean = answerInlineQuery(inlineQuery.id, results, cachedTime, isPersonal, nextOffset, button)
+
+public suspend fun TelegramBot.answer(
+    inlineQuery: InlineQuery,
+    results: List<InlineQueryResult> = emptyList(),
+    cachedTime: Int? = null,
+    isPersonal: Boolean? = null,
+    nextOffset: String? = null,
+    button: InlineQueryResultsButton? = null
+): Boolean = answerInlineQuery(inlineQuery.id, results, cachedTime, isPersonal, nextOffset, button)
+
+public suspend fun TelegramBot.answerInlineQuery(
+    inlineQueryID: InlineQueryId,
+    results: List<InlineQueryResult> = emptyList(),
+    cachedTime: Int? = null,
+    isPersonal: Boolean? = null,
+    nextOffset: String? = null,
+    switchPmText: String?,
+    switchPmParameter: String?
+): Boolean = execute(
     AnswerInlineQuery(inlineQueryID, results, cachedTime, isPersonal, nextOffset, switchPmText, switchPmParameter)
 )
 
-suspend fun TelegramBot.answerInlineQuery(
+public suspend fun TelegramBot.answerInlineQuery(
     inlineQuery: InlineQuery,
     results: List<InlineQueryResult> = emptyList(),
     cachedTime: Int? = null,
     isPersonal: Boolean? = null,
     nextOffset: String? = null,
-    switchPmText: String? = null,
-    switchPmParameter: String? = null
-) = answerInlineQuery(inlineQuery.id, results, cachedTime, isPersonal, nextOffset, switchPmText, switchPmParameter)
+    switchPmText: String?,
+    switchPmParameter: String?
+): Boolean = answerInlineQuery(inlineQuery.id, results, cachedTime, isPersonal, nextOffset, switchPmText, switchPmParameter)
 
-suspend fun TelegramBot.answer(
+public suspend fun TelegramBot.answer(
     inlineQuery: InlineQuery,
     results: List<InlineQueryResult> = emptyList(),
     cachedTime: Int? = null,
     isPersonal: Boolean? = null,
     nextOffset: String? = null,
-    switchPmText: String? = null,
-    switchPmParameter: String? = null
-) = answerInlineQuery(inlineQuery.id, results, cachedTime, isPersonal, nextOffset, switchPmText, switchPmParameter)
+    switchPmText: String?,
+    switchPmParameter: String?
+): Boolean = answerInlineQuery(inlineQuery.id, results, cachedTime, isPersonal, nextOffset, switchPmText, switchPmParameter)

tgbotapi.api/src/commonMain/kotlin/dev/inmo/tgbotapi/extensions/api/answers/AnswerWebAppQuery.kt

@@ -4,13 +4,14 @@ import dev.inmo.tgbotapi.bot.TelegramBot
 import dev.inmo.tgbotapi.requests.answers.AnswerWebAppQuery
 import dev.inmo.tgbotapi.types.InlineQueries.InlineQueryResult.abstracts.InlineQueryResult
 import dev.inmo.tgbotapi.types.WebAppQueryId
+import dev.inmo.tgbotapi.types.webapps.query.SentWebAppMessage
 
-suspend fun TelegramBot.answerWebAppQuery(
+public suspend fun TelegramBot.answerWebAppQuery(
     webAppQueryId: WebAppQueryId,
     result: InlineQueryResult
-) = execute(AnswerWebAppQuery(webAppQueryId, result))
+): SentWebAppMessage = execute(AnswerWebAppQuery(webAppQueryId, result))
 
-suspend fun TelegramBot.answer(
+public suspend fun TelegramBot.answer(
     webAppQueryId: WebAppQueryId,
     result: InlineQueryResult
-) = execute(AnswerWebAppQuery(webAppQueryId, result))
+): SentWebAppMessage = execute(AnswerWebAppQuery(webAppQueryId, result))

tgbotapi.api/src/commonMain/kotlin/dev/inmo/tgbotapi/extensions/api/answers/payments/AnswerPreCheckoutQuery.kt

@@ -6,18 +6,18 @@ import dev.inmo.tgbotapi.requests.answers.payments.AnswerPreCheckoutQueryOk
 import dev.inmo.tgbotapi.types.PreCheckoutQueryId
 import dev.inmo.tgbotapi.types.payments.PreCheckoutQuery
 
-suspend fun TelegramBot.answerPreCheckoutQueryOk(
+public suspend fun TelegramBot.answerPreCheckoutQueryOk(
     id: PreCheckoutQueryId
-) = execute(AnswerPreCheckoutQueryOk(id))
-suspend fun TelegramBot.answerPreCheckoutQueryOk(
+): Boolean = execute(AnswerPreCheckoutQueryOk(id))
+public suspend fun TelegramBot.answerPreCheckoutQueryOk(
     preCheckoutQuery: PreCheckoutQuery
-) = answerPreCheckoutQueryOk(preCheckoutQuery.id)
+): Boolean = answerPreCheckoutQueryOk(preCheckoutQuery.id)
 
-suspend fun TelegramBot.answerPreCheckoutQueryError(
+public suspend fun TelegramBot.answerPreCheckoutQueryError(
     id: PreCheckoutQueryId,
     error: String
-) = execute(AnswerPreCheckoutQueryError(id, error))
-suspend fun TelegramBot.answerPreCheckoutQueryError(
+): Boolean = execute(AnswerPreCheckoutQueryError(id, error))
+public suspend fun TelegramBot.answerPreCheckoutQueryError(
     preCheckoutQuery: PreCheckoutQuery,
     error: String
-) = answerPreCheckoutQueryError(preCheckoutQuery.id, error)
+): Boolean = answerPreCheckoutQueryError(preCheckoutQuery.id, error)

tgbotapi.api/src/commonMain/kotlin/dev/inmo/tgbotapi/extensions/api/answers/payments/AnswerShippingQuery.kt

@@ -3,26 +3,26 @@ package dev.inmo.tgbotapi.extensions.api.answers.payments
 import dev.inmo.tgbotapi.bot.TelegramBot
 import dev.inmo.tgbotapi.requests.answers.payments.AnswerShippingQueryError
 import dev.inmo.tgbotapi.requests.answers.payments.AnswerShippingQueryOk
-import dev.inmo.tgbotapi.types.ShippingQueryIdentifier
+import dev.inmo.tgbotapi.types.ShippingQueryId
 import dev.inmo.tgbotapi.types.payments.ShippingOption
 import dev.inmo.tgbotapi.types.payments.ShippingQuery
 
-suspend fun TelegramBot.answerShippingQueryOk(
-    id: ShippingQueryIdentifier,
+public suspend fun TelegramBot.answerShippingQueryOk(
+    id: ShippingQueryId,
     shippingOptions: List<ShippingOption>
-) = execute(AnswerShippingQueryOk(id, shippingOptions))
-suspend fun TelegramBot.answerShippingQueryOk(
+): Boolean = execute(AnswerShippingQueryOk(id, shippingOptions))
+public suspend fun TelegramBot.answerShippingQueryOk(
     shippingQuery: ShippingQuery,
     shippingOptions: List<ShippingOption>
-) = answerShippingQueryOk(shippingQuery.id, shippingOptions)
+): Boolean = answerShippingQueryOk(shippingQuery.id, shippingOptions)
 
-suspend fun TelegramBot.answerShippingQueryError(
-    id: ShippingQueryIdentifier,
+public suspend fun TelegramBot.answerShippingQueryError(
+    id: ShippingQueryId,
     error: String
-) = execute(AnswerShippingQueryError(id, error))
-suspend fun TelegramBot.answerShippingQueryError(
+): Boolean = execute(AnswerShippingQueryError(id, error))
+public suspend fun TelegramBot.answerShippingQueryError(
     shippingQuery: ShippingQuery,
     error: String
-) = answerShippingQueryError(shippingQuery.id, error)
+): Boolean = answerShippingQueryError(shippingQuery.id, error)
 
 

tgbotapi.api/src/commonMain/kotlin/dev/inmo/tgbotapi/extensions/api/bot/ClearMyDefaultAdministratorRights.kt

@@ -3,10 +3,10 @@ package dev.inmo.tgbotapi.extensions.api.bot
 import dev.inmo.tgbotapi.bot.TelegramBot
 import dev.inmo.tgbotapi.requests.bot.ClearMyDefaultAdministratorRights
 
-suspend fun TelegramBot.clearMyDefaultAdministratorRights(
+public suspend fun TelegramBot.clearMyDefaultAdministratorRights(
     forChannels: Boolean? = null
-) = execute(ClearMyDefaultAdministratorRights(forChannels))
+): Boolean = execute(ClearMyDefaultAdministratorRights(forChannels))
 
-suspend fun TelegramBot.clearMyDefaultAdministratorRightsForChannels() = clearMyDefaultAdministratorRights(forChannels = true)
+public suspend fun TelegramBot.clearMyDefaultAdministratorRightsForChannels(): Boolean = clearMyDefaultAdministratorRights(forChannels = true)
 
-suspend fun TelegramBot.clearMyDefaultAdministratorRightsForGroupsAndSupergroups() = clearMyDefaultAdministratorRights(forChannels = false)
+public suspend fun TelegramBot.clearMyDefaultAdministratorRightsForGroupsAndSupergroups(): Boolean = clearMyDefaultAdministratorRights(forChannels = false)

tgbotapi.api/src/commonMain/kotlin/dev/inmo/tgbotapi/extensions/api/bot/DeleteMyCommands.kt

@@ -1,17 +1,17 @@
 package dev.inmo.tgbotapi.extensions.api.bot
 
-import dev.inmo.micro_utils.language_codes.IetfLanguageCode
+import dev.inmo.micro_utils.language_codes.IetfLang
 import dev.inmo.tgbotapi.bot.TelegramBot
 import dev.inmo.tgbotapi.requests.bot.DeleteMyCommands
 import dev.inmo.tgbotapi.types.commands.BotCommandScope
 import dev.inmo.tgbotapi.types.commands.BotCommandScopeDefault
 
-suspend fun TelegramBot.deleteMyCommands(
+public suspend fun TelegramBot.deleteMyCommands(
     scope: BotCommandScope = BotCommandScopeDefault,
-    languageCode: IetfLanguageCode?
-) = execute(DeleteMyCommands(scope, languageCode))
+    languageCode: IetfLang?
+): Boolean = execute(DeleteMyCommands(scope, languageCode))
 
-suspend fun TelegramBot.deleteMyCommands(
+public suspend fun TelegramBot.deleteMyCommands(
     scope: BotCommandScope = BotCommandScopeDefault,
     languageCode: String? = null
-) = deleteMyCommands(scope, languageCode ?.let(::IetfLanguageCode))
+): Boolean = deleteMyCommands(scope, languageCode ?.let(::IetfLang))

tgbotapi.api/src/commonMain/kotlin/dev/inmo/tgbotapi/extensions/api/bot/GetMe.kt

@@ -2,5 +2,6 @@ package dev.inmo.tgbotapi.extensions.api.bot
 
 import dev.inmo.tgbotapi.bot.TelegramBot
 import dev.inmo.tgbotapi.requests.bot.GetMe
+import dev.inmo.tgbotapi.types.chat.ExtendedBot
 
-suspend fun TelegramBot.getMe() = execute(GetMe)
+public suspend fun TelegramBot.getMe(): ExtendedBot = execute(GetMe)

tgbotapi.api/src/commonMain/kotlin/dev/inmo/tgbotapi/extensions/api/bot/GetMyCommands.kt

@@ -1,17 +1,18 @@
 package dev.inmo.tgbotapi.extensions.api.bot
 
-import dev.inmo.micro_utils.language_codes.IetfLanguageCode
+import dev.inmo.micro_utils.language_codes.IetfLang
 import dev.inmo.tgbotapi.bot.TelegramBot
 import dev.inmo.tgbotapi.requests.bot.GetMyCommands
+import dev.inmo.tgbotapi.types.BotCommand
 import dev.inmo.tgbotapi.types.commands.BotCommandScope
 import dev.inmo.tgbotapi.types.commands.BotCommandScopeDefault
 
-suspend fun TelegramBot.getMyCommands(
+public suspend fun TelegramBot.getMyCommands(
     scope: BotCommandScope = BotCommandScopeDefault,
-    languageCode: IetfLanguageCode? = null
-) = execute(GetMyCommands(scope, languageCode))
+    languageCode: IetfLang? = null
+): List<BotCommand> = execute(GetMyCommands(scope, languageCode))
 
-suspend fun TelegramBot.getMyCommands(
+public suspend fun TelegramBot.getMyCommands(
     scope: BotCommandScope = BotCommandScopeDefault,
     languageCode: String?
-) = getMyCommands(scope, languageCode ?.let(::IetfLanguageCode))
+): List<BotCommand> = getMyCommands(scope, languageCode ?.let(::IetfLang))

tgbotapi.api/src/commonMain/kotlin/dev/inmo/tgbotapi/extensions/api/bot/GetMyDefaultAdministratorRights.kt

@@ -2,11 +2,12 @@ package dev.inmo.tgbotapi.extensions.api.bot
 
 import dev.inmo.tgbotapi.bot.TelegramBot
 import dev.inmo.tgbotapi.requests.bot.GetMyDefaultAdministratorRights
+import dev.inmo.tgbotapi.types.chat.member.AdministratorChatMember
 
-suspend fun TelegramBot.getMyDefaultAdministratorRights(
+public suspend fun TelegramBot.getMyDefaultAdministratorRights(
     forChannels: Boolean? = null
-) = execute(GetMyDefaultAdministratorRights(forChannels))
+): AdministratorChatMember = execute(GetMyDefaultAdministratorRights(forChannels))
 
-suspend fun TelegramBot.getMyDefaultAdministratorRightsForChannels() = getMyDefaultAdministratorRights(forChannels = true)
+public suspend fun TelegramBot.getMyDefaultAdministratorRightsForChannels(): AdministratorChatMember = getMyDefaultAdministratorRights(forChannels = true)
 
-suspend fun TelegramBot.getMyDefaultAdministratorRightsForGroupsAndSupergroups() = getMyDefaultAdministratorRights(forChannels = false)
+public suspend fun TelegramBot.getMyDefaultAdministratorRightsForGroupsAndSupergroups(): AdministratorChatMember = getMyDefaultAdministratorRights(forChannels = false)

tgbotapi.api/src/commonMain/kotlin/dev/inmo/tgbotapi/extensions/api/bot/GetMyDescription.kt

@@ -0,0 +1,14 @@
+package dev.inmo.tgbotapi.extensions.api.bot
+
+import dev.inmo.micro_utils.language_codes.IetfLang
+import dev.inmo.tgbotapi.bot.TelegramBot
+import dev.inmo.tgbotapi.requests.bot.GetMyDescription
+import dev.inmo.tgbotapi.types.BotDescription
+
+public suspend fun TelegramBot.getMyDescription(
+    languageCode: IetfLang? = null
+): BotDescription = execute(GetMyDescription(languageCode))
+
+public suspend fun TelegramBot.getMyDescription(
+    languageCode: String?
+): BotDescription = getMyDescription(languageCode ?.let(::IetfLang))

tgbotapi.api/src/commonMain/kotlin/dev/inmo/tgbotapi/extensions/api/bot/GetMyName.kt

@@ -0,0 +1,14 @@
+package dev.inmo.tgbotapi.extensions.api.bot
+
+import dev.inmo.micro_utils.language_codes.IetfLang
+import dev.inmo.tgbotapi.bot.TelegramBot
+import dev.inmo.tgbotapi.requests.bot.GetMyName
+import dev.inmo.tgbotapi.types.BotName
+
+public suspend fun TelegramBot.getMyName(
+    languageCode: IetfLang? = null
+): BotName = execute(GetMyName(languageCode))
+
+public suspend fun TelegramBot.getMyName(
+    languageCode: String?
+): BotName = getMyName(languageCode ?.let(::IetfLang))

tgbotapi.api/src/commonMain/kotlin/dev/inmo/tgbotapi/extensions/api/bot/GetMyShortDescription.kt

@@ -0,0 +1,17 @@
+package dev.inmo.tgbotapi.extensions.api.bot
+
+import dev.inmo.micro_utils.language_codes.IetfLang
+import dev.inmo.tgbotapi.bot.TelegramBot
+import dev.inmo.tgbotapi.requests.bot.GetMyCommands
+import dev.inmo.tgbotapi.requests.bot.GetMyShortDescription
+import dev.inmo.tgbotapi.types.BotShortDescription
+import dev.inmo.tgbotapi.types.commands.BotCommandScope
+import dev.inmo.tgbotapi.types.commands.BotCommandScopeDefault
+
+public suspend fun TelegramBot.getMyShortDescription(
+    languageCode: IetfLang? = null
+): BotShortDescription = execute(GetMyShortDescription(languageCode))
+
+public suspend fun TelegramBot.getMyShortDescription(
+    languageCode: String?
+): BotShortDescription = getMyShortDescription(languageCode ?.let(::IetfLang))

tgbotapi.api/src/commonMain/kotlin/dev/inmo/tgbotapi/extensions/api/bot/GetMyStarBalance.kt

@@ -0,0 +1,9 @@
+package dev.inmo.tgbotapi.extensions.api.bot
+
+import dev.inmo.tgbotapi.bot.TelegramBot
+import dev.inmo.tgbotapi.requests.bot.GetMe
+import dev.inmo.tgbotapi.requests.bot.GetMyStarBalance
+import dev.inmo.tgbotapi.types.chat.ExtendedBot
+import dev.inmo.tgbotapi.types.payments.stars.StarAmount
+
+public suspend fun TelegramBot.getMyStarBalance(): StarAmount = execute(GetMyStarBalance)

tgbotapi.api/src/commonMain/kotlin/dev/inmo/tgbotapi/extensions/api/bot/SetMyCommands.kt

@@ -1,32 +1,32 @@
 package dev.inmo.tgbotapi.extensions.api.bot
 
-import dev.inmo.micro_utils.language_codes.IetfLanguageCode
+import dev.inmo.micro_utils.language_codes.IetfLang
 import dev.inmo.tgbotapi.bot.TelegramBot
 import dev.inmo.tgbotapi.requests.bot.SetMyCommands
 import dev.inmo.tgbotapi.types.BotCommand
 import dev.inmo.tgbotapi.types.commands.BotCommandScope
 import dev.inmo.tgbotapi.types.commands.BotCommandScopeDefault
 
-suspend fun TelegramBot.setMyCommands(
+public suspend fun TelegramBot.setMyCommands(
     commands: List<BotCommand>,
     scope: BotCommandScope = BotCommandScopeDefault,
-    languageCode: IetfLanguageCode?
-) = execute(SetMyCommands(commands, scope, languageCode))
+    languageCode: IetfLang?
+): Boolean = execute(SetMyCommands(commands, scope, languageCode))
 
-suspend fun TelegramBot.setMyCommands(
+public suspend fun TelegramBot.setMyCommands(
     vararg commands: BotCommand,
     scope: BotCommandScope = BotCommandScopeDefault,
-    languageCode: IetfLanguageCode?
-) = setMyCommands(commands.toList(), scope, languageCode)
+    languageCode: IetfLang?
+): Boolean = setMyCommands(commands.toList(), scope, languageCode)
 
-suspend fun TelegramBot.setMyCommands(
+public suspend fun TelegramBot.setMyCommands(
     commands: List<BotCommand>,
     scope: BotCommandScope = BotCommandScopeDefault,
     languageCode: String? = null
-) = setMyCommands(commands, scope, languageCode ?.let(::IetfLanguageCode))
+): Boolean = setMyCommands(commands, scope, languageCode ?.let(::IetfLang))
 
-suspend fun TelegramBot.setMyCommands(
+public suspend fun TelegramBot.setMyCommands(
     vararg commands: BotCommand,
     scope: BotCommandScope = BotCommandScopeDefault,
     languageCode: String? = null
-) = setMyCommands(commands.toList(), scope, languageCode)
+): Boolean = setMyCommands(commands.toList(), scope, languageCode)

tgbotapi.api/src/commonMain/kotlin/dev/inmo/tgbotapi/extensions/api/bot/SetMyDefaultAdministratorRights.kt

@@ -2,17 +2,17 @@ package dev.inmo.tgbotapi.extensions.api.bot
 
 import dev.inmo.tgbotapi.bot.TelegramBot
 import dev.inmo.tgbotapi.requests.bot.SetMyDefaultAdministratorRights
-import dev.inmo.tgbotapi.types.chat.member.ChatAdministratorRightsImpl
+import dev.inmo.tgbotapi.types.chat.member.ChatCommonAdministratorRights
 
-suspend fun TelegramBot.setMyDefaultAdministratorRights(
-    rights: ChatAdministratorRightsImpl,
+public suspend fun TelegramBot.setMyDefaultAdministratorRights(
+    rights: ChatCommonAdministratorRights,
     forChannels: Boolean? = null
-) = execute(SetMyDefaultAdministratorRights(rights, forChannels))
+): Boolean = execute(SetMyDefaultAdministratorRights(rights, forChannels))
 
-suspend fun TelegramBot.setMyDefaultAdministratorRightsForChannels(
-    rights: ChatAdministratorRightsImpl
-) = setMyDefaultAdministratorRights(rights, forChannels = true)
+public suspend fun TelegramBot.setMyDefaultAdministratorRightsForChannels(
+    rights: ChatCommonAdministratorRights
+): Boolean = setMyDefaultAdministratorRights(rights, forChannels = true)
 
-suspend fun TelegramBot.setMyDefaultAdministratorRightsForGroupsAndSupergroups(
-    rights: ChatAdministratorRightsImpl
-) = setMyDefaultAdministratorRights(rights, forChannels = false)
+public suspend fun TelegramBot.setMyDefaultAdministratorRightsForGroupsAndSupergroups(
+    rights: ChatCommonAdministratorRights
+): Boolean = setMyDefaultAdministratorRights(rights, forChannels = false)

tgbotapi.api/src/commonMain/kotlin/dev/inmo/tgbotapi/extensions/api/bot/SetMyDescription.kt

@@ -0,0 +1,19 @@
+package dev.inmo.tgbotapi.extensions.api.bot
+
+import dev.inmo.micro_utils.language_codes.IetfLang
+import dev.inmo.tgbotapi.bot.TelegramBot
+import dev.inmo.tgbotapi.requests.bot.GetMyCommands
+import dev.inmo.tgbotapi.requests.bot.GetMyDescription
+import dev.inmo.tgbotapi.requests.bot.SetMyDescription
+import dev.inmo.tgbotapi.types.commands.BotCommandScope
+import dev.inmo.tgbotapi.types.commands.BotCommandScopeDefault
+
+public suspend fun TelegramBot.setMyDescription(
+    description: String? = null,
+    languageCode: IetfLang? = null
+): Boolean = execute(SetMyDescription(description, languageCode))
+
+public suspend fun TelegramBot.setMyDescription(
+    description: String?,
+    languageCode: String?
+): Boolean = setMyDescription(description, languageCode ?.let(::IetfLang))

tgbotapi.api/src/commonMain/kotlin/dev/inmo/tgbotapi/extensions/api/bot/SetMyName.kt

@@ -0,0 +1,19 @@
+package dev.inmo.tgbotapi.extensions.api.bot
+
+import dev.inmo.micro_utils.language_codes.IetfLang
+import dev.inmo.tgbotapi.bot.TelegramBot
+import dev.inmo.tgbotapi.requests.bot.GetMyCommands
+import dev.inmo.tgbotapi.requests.bot.GetMyName
+import dev.inmo.tgbotapi.requests.bot.SetMyName
+import dev.inmo.tgbotapi.types.commands.BotCommandScope
+import dev.inmo.tgbotapi.types.commands.BotCommandScopeDefault
+
+public suspend fun TelegramBot.setMyName(
+    name: String? = null,
+    languageCode: IetfLang? = null
+): Boolean = execute(SetMyName(name, languageCode))
+
+public suspend fun TelegramBot.setMyName(
+    name: String?,
+    languageCode: String?
+): Boolean = setMyName(name, languageCode ?.let(::IetfLang))

tgbotapi.api/src/commonMain/kotlin/dev/inmo/tgbotapi/extensions/api/bot/SetMyShortDescription.kt

@@ -0,0 +1,15 @@
+package dev.inmo.tgbotapi.extensions.api.bot
+
+import dev.inmo.micro_utils.language_codes.IetfLang
+import dev.inmo.tgbotapi.bot.TelegramBot
+import dev.inmo.tgbotapi.requests.bot.SetMyShortDescription
+
+public suspend fun TelegramBot.setMyShortDescription(
+    shortDescription: String? = null,
+    languageCode: IetfLang? = null
+): Boolean = execute(SetMyShortDescription(shortDescription, languageCode))
+
+public suspend fun TelegramBot.setMyShortDescription(
+    shortDescription: String?,
+    languageCode: String?
+): Boolean = setMyShortDescription(shortDescription, languageCode ?.let(::IetfLang))

tgbotapi.api/src/commonMain/kotlin/dev/inmo/tgbotapi/extensions/api/business/ConvertGiftToStars.kt

@@ -0,0 +1,25 @@
+package dev.inmo.tgbotapi.extensions.api.business
+
+import dev.inmo.micro_utils.ksp.variations.GenerateVariations
+import dev.inmo.micro_utils.ksp.variations.GenerationVariant
+import dev.inmo.tgbotapi.bot.TelegramBot
+import dev.inmo.tgbotapi.requests.business_connection.ConvertGiftToStars
+import dev.inmo.tgbotapi.types.business_connection.BusinessConnectionId
+import dev.inmo.tgbotapi.types.GiftId
+import dev.inmo.tgbotapi.types.gifts.Gift
+
+public suspend fun TelegramBot.convertGiftToStars(
+    businessConnectionId: BusinessConnectionId,
+    ownedGiftId: GiftId
+): Boolean = execute(
+    ConvertGiftToStars(businessConnectionId, ownedGiftId)
+)
+
+public suspend fun TelegramBot.convertGiftToStars(
+    businessConnectionId: BusinessConnectionId,
+    gift: Gift.Regular
+): Boolean = convertGiftToStars(
+    businessConnectionId = businessConnectionId,
+    ownedGiftId = with(gift) {id}
+)
+

tgbotapi.api/src/commonMain/kotlin/dev/inmo/tgbotapi/extensions/api/business/DeleteBusinessMessages.kt

@@ -0,0 +1,20 @@
+package dev.inmo.tgbotapi.extensions.api.business
+
+import dev.inmo.micro_utils.ksp.variations.GenerateVariations
+import dev.inmo.micro_utils.ksp.variations.GenerationVariant
+import dev.inmo.tgbotapi.bot.TelegramBot
+import dev.inmo.tgbotapi.requests.business_connection.DeleteBusinessMessages
+import dev.inmo.tgbotapi.types.business_connection.BusinessConnectionId
+import dev.inmo.tgbotapi.types.ChatId
+import dev.inmo.tgbotapi.types.MessageId
+import dev.inmo.tgbotapi.types.chat.Chat
+import dev.inmo.tgbotapi.types.message.abstracts.AccessibleMessage
+
+@GenerateVariations
+public suspend fun TelegramBot.deleteBusinessMessages(
+    businessConnectionId: BusinessConnectionId,
+    @GenerationVariant(List::class, "messages.map { it.messageId }", "messages", AccessibleMessage::class)
+    messageIds: List<MessageId>
+): Boolean = execute(
+    DeleteBusinessMessages(businessConnectionId, messageIds)
+)

tgbotapi.api/src/commonMain/kotlin/dev/inmo/tgbotapi/extensions/api/business/DeleteBusinessMessagesGeneratedVariation.kt

@@ -0,0 +1,16 @@
+// THIS CODE HAVE BEEN GENERATED AUTOMATICALLY
+// TO REGENERATE IT JUST DELETE FILE
+// ORIGINAL FILE: DeleteBusinessMessages.kt
+package dev.inmo.tgbotapi.extensions.api.business
+
+import dev.inmo.tgbotapi.bot.TelegramBot
+import dev.inmo.tgbotapi.types.business_connection.BusinessConnectionId
+import dev.inmo.tgbotapi.types.message.abstracts.AccessibleMessage
+import kotlin.Boolean
+import kotlin.collections.List
+
+public suspend fun TelegramBot.deleteBusinessMessages(businessConnectionId: BusinessConnectionId,
+    messages: List<AccessibleMessage>): Boolean = deleteBusinessMessages(
+    businessConnectionId = businessConnectionId, messageIds = with(messages) {messages.map {
+    it.messageId }}
+)

tgbotapi.api/src/commonMain/kotlin/dev/inmo/tgbotapi/extensions/api/business/GetBusinessAccountGifts.kt

@@ -0,0 +1,94 @@
+package dev.inmo.tgbotapi.extensions.api.business
+
+import dev.inmo.tgbotapi.bot.TelegramBot
+import dev.inmo.tgbotapi.requests.business_connection.GetBusinessAccountGifts
+import dev.inmo.tgbotapi.types.business_connection.BusinessConnectionId
+import dev.inmo.tgbotapi.types.OwnedGifts
+import dev.inmo.tgbotapi.types.gifts.GiftSentOrReceived
+import kotlinx.coroutines.flow.Flow
+import kotlinx.coroutines.flow.flow
+import kotlin.runCatching
+
+public suspend fun TelegramBot.getBusinessAccountGifts(
+    businessConnectionId: BusinessConnectionId,
+    excludeUnsaved: Boolean = false,
+    excludeSaved: Boolean = false,
+    excludeUnlimited: Boolean = false,
+    excludeLimited: Boolean = false,
+    excludeUnique: Boolean = false,
+    sortByPrice: Boolean = false,
+    offset: String? = null,
+    limit: Int? = null
+): OwnedGifts<GiftSentOrReceived.ReceivedInBusinessAccount> = execute(
+    GetBusinessAccountGifts(
+        businessConnectionId,
+        excludeUnsaved,
+        excludeSaved,
+        excludeUnlimited,
+        excludeLimited,
+        excludeUnique,
+        sortByPrice,
+        offset,
+        limit
+    )
+)
+
+/**
+ * Creates a flow that emits business account gifts in a paginated manner.
+ *
+ * This function will automatically handle pagination by using the `nextOffset` from each response
+ * to fetch the next page of gifts until there are no more gifts to fetch.
+ *
+ * @param businessConnectionId The ID of the business connection
+ * @param excludeUnsaved Whether to exclude unsaved gifts
+ * @param excludeSaved Whether to exclude saved gifts
+ * @param excludeUnlimited Whether to exclude unlimited gifts
+ * @param excludeLimited Whether to exclude limited gifts
+ * @param excludeUnique Whether to exclude unique gifts
+ * @param sortByPrice Whether to sort gifts by price
+ * @param initialOffset The initial offset to start fetching from. If null, starts from the beginning
+ * @param limit The maximum number of gifts to fetch per request
+ * @param onErrorContinueChecker A function that determines whether to continue fetching on error.
+ *                              Returns true to continue, false to stop. Default is to stop on any error.
+ * @return A flow that emits [OwnedGifts] containing the fetched gifts
+ */
+public fun TelegramBot.getBusinessAccountGiftsFlow(
+    businessConnectionId: BusinessConnectionId,
+    excludeUnsaved: Boolean = false,
+    excludeSaved: Boolean = false,
+    excludeUnlimited: Boolean = false,
+    excludeLimited: Boolean = false,
+    excludeUnique: Boolean = false,
+    sortByPrice: Boolean = false,
+    initialOffset: String? = null,
+    limit: Int? = null,
+    onErrorContinueChecker: suspend (Throwable?) -> Boolean = { false }
+): Flow<OwnedGifts<GiftSentOrReceived.ReceivedInBusinessAccount>> = flow {
+    var currentOffset = initialOffset
+    do {
+        val response = runCatching {
+            getBusinessAccountGifts(
+                businessConnectionId,
+                excludeUnsaved,
+                excludeSaved,
+                excludeUnlimited,
+                excludeLimited,
+                excludeUnique,
+                sortByPrice,
+                currentOffset,
+                limit
+            )
+        }
+        if (response.isSuccess) {
+            val result = response.getOrThrow()
+            emit(result)
+            currentOffset = result.nextOffset
+        } else {
+            if (onErrorContinueChecker(response.exceptionOrNull())) {
+                continue
+            } else {
+                break
+            }
+        }
+    } while (currentOffset != null)
+}

tgbotapi.api/src/commonMain/kotlin/dev/inmo/tgbotapi/extensions/api/business/GetBusinessAccountStarBalance.kt

@@ -0,0 +1,12 @@
+package dev.inmo.tgbotapi.extensions.api.business
+
+import dev.inmo.tgbotapi.bot.TelegramBot
+import dev.inmo.tgbotapi.requests.business_connection.GetBusinessAccountStarBalance
+import dev.inmo.tgbotapi.types.business_connection.BusinessConnectionId
+import dev.inmo.tgbotapi.types.payments.stars.StarAmount
+
+public suspend fun TelegramBot.getBusinessAccountStarBalance(
+    businessConnectionId: BusinessConnectionId
+): StarAmount = execute(
+    GetBusinessAccountStarBalance(businessConnectionId)
+) 

tgbotapi.api/src/commonMain/kotlin/dev/inmo/tgbotapi/extensions/api/business/ReadBusinessMessage.kt

@@ -0,0 +1,27 @@
+package dev.inmo.tgbotapi.extensions.api.business
+
+import dev.inmo.micro_utils.ksp.variations.GenerateVariations
+import dev.inmo.micro_utils.ksp.variations.GenerationVariant
+import dev.inmo.tgbotapi.bot.TelegramBot
+import dev.inmo.tgbotapi.requests.business_connection.ReadBusinessMessage
+import dev.inmo.tgbotapi.types.business_connection.BusinessConnectionId
+import dev.inmo.tgbotapi.types.ChatId
+import dev.inmo.tgbotapi.types.MessageId
+import dev.inmo.tgbotapi.types.chat.Chat
+import dev.inmo.tgbotapi.types.message.abstracts.AccessibleMessage
+import dev.inmo.tgbotapi.types.toChatId
+
+@GenerateVariations
+public suspend fun TelegramBot.readBusinessMessage(
+    businessConnectionId: BusinessConnectionId,
+    @GenerationVariant(Chat::class, "chat.id.toChatId()", "chat")
+    chatId: ChatId,
+    messageId: MessageId
+): Boolean = execute(
+    ReadBusinessMessage(businessConnectionId, chatId, messageId)
+)
+
+public suspend fun TelegramBot.readBusinessMessage(
+    businessConnectionId: BusinessConnectionId,
+    message: AccessibleMessage
+): Boolean = readBusinessMessage(businessConnectionId, message.chat.id.toChatId(), message.messageId)

tgbotapi.api/src/commonMain/kotlin/dev/inmo/tgbotapi/extensions/api/business/ReadBusinessMessageGeneratedVariation.kt

@@ -0,0 +1,20 @@
+// THIS CODE HAVE BEEN GENERATED AUTOMATICALLY
+// TO REGENERATE IT JUST DELETE FILE
+// ORIGINAL FILE: ReadBusinessMessage.kt
+package dev.inmo.tgbotapi.extensions.api.business
+
+import dev.inmo.tgbotapi.bot.TelegramBot
+import dev.inmo.tgbotapi.types.MessageId
+import dev.inmo.tgbotapi.types.business_connection.BusinessConnectionId
+import dev.inmo.tgbotapi.types.chat.Chat
+import dev.inmo.tgbotapi.types.toChatId
+import kotlin.Boolean
+
+public suspend fun TelegramBot.readBusinessMessage(
+  businessConnectionId: BusinessConnectionId,
+  chat: Chat,
+  messageId: MessageId,
+): Boolean = readBusinessMessage(
+    businessConnectionId = businessConnectionId, chatId = with(chat) {chat.id.toChatId()}, messageId
+    = messageId
+)

tgbotapi.api/src/commonMain/kotlin/dev/inmo/tgbotapi/extensions/api/business/RemoveBusinessAccountProfilePhoto.kt

@@ -0,0 +1,12 @@
+package dev.inmo.tgbotapi.extensions.api.business
+
+import dev.inmo.tgbotapi.bot.TelegramBot
+import dev.inmo.tgbotapi.requests.business_connection.RemoveBusinessAccountProfilePhoto
+import dev.inmo.tgbotapi.types.business_connection.BusinessConnectionId
+
+public suspend fun TelegramBot.removeBusinessAccountProfilePhoto(
+    businessConnectionId: BusinessConnectionId,
+    isPublic: Boolean = false
+): Boolean = execute(
+    RemoveBusinessAccountProfilePhoto(businessConnectionId = businessConnectionId, isPublic = isPublic)
+) 

tgbotapi.api/src/commonMain/kotlin/dev/inmo/tgbotapi/extensions/api/business/SetBusinessAccountBio.kt

@@ -0,0 +1,12 @@
+package dev.inmo.tgbotapi.extensions.api.business
+
+import dev.inmo.tgbotapi.bot.TelegramBot
+import dev.inmo.tgbotapi.requests.business_connection.SetBusinessAccountBio
+import dev.inmo.tgbotapi.types.business_connection.BusinessConnectionId
+
+public suspend fun TelegramBot.setBusinessAccountBio(
+    businessConnectionId: BusinessConnectionId,
+    bio: String
+): Boolean = execute(
+    SetBusinessAccountBio(businessConnectionId, bio)
+) 

tgbotapi.api/src/commonMain/kotlin/dev/inmo/tgbotapi/extensions/api/business/SetBusinessAccountGiftSettings.kt

@@ -0,0 +1,35 @@
+package dev.inmo.tgbotapi.extensions.api.business
+
+import dev.inmo.tgbotapi.bot.TelegramBot
+import dev.inmo.tgbotapi.requests.business_connection.SetBusinessAccountGiftSettings
+import dev.inmo.tgbotapi.types.business_connection.BusinessConnectionId
+import dev.inmo.tgbotapi.types.gifts.AcceptedGiftTypes
+import dev.inmo.tgbotapi.types.message.abstracts.BusinessContentMessage
+
+/**
+ * Sets the gift settings for a business account
+ */
+public suspend fun TelegramBot.setBusinessAccountGiftSettings(
+    businessConnectionId: BusinessConnectionId,
+    showGiftButton: Boolean,
+    acceptedGiftTypes: AcceptedGiftTypes
+): Boolean = execute(
+    SetBusinessAccountGiftSettings(
+        businessConnectionId = businessConnectionId,
+        showGiftButton = showGiftButton,
+        acceptedGiftTypes = acceptedGiftTypes
+    )
+)
+
+/**
+ * Sets the gift settings for a business account using business message context
+ */
+public suspend fun TelegramBot.setBusinessAccountGiftSettings(
+    message: BusinessContentMessage<*>,
+    showGiftButton: Boolean,
+    acceptedGiftTypes: AcceptedGiftTypes
+): Boolean = setBusinessAccountGiftSettings(
+    businessConnectionId = message.businessConnectionId,
+    showGiftButton = showGiftButton,
+    acceptedGiftTypes = acceptedGiftTypes
+) 

tgbotapi.api/src/commonMain/kotlin/dev/inmo/tgbotapi/extensions/api/business/SetBusinessAccountName.kt

@@ -0,0 +1,13 @@
+package dev.inmo.tgbotapi.extensions.api.business
+
+import dev.inmo.tgbotapi.bot.TelegramBot
+import dev.inmo.tgbotapi.requests.business_connection.SetBusinessAccountName
+import dev.inmo.tgbotapi.types.business_connection.BusinessConnectionId
+
+public suspend fun TelegramBot.setBusinessAccountName(
+    businessConnectionId: BusinessConnectionId,
+    firstName: String,
+    lastName: String? = null
+): Boolean = execute(
+    SetBusinessAccountName(businessConnectionId, firstName, lastName)
+) 

tgbotapi.api/src/commonMain/kotlin/dev/inmo/tgbotapi/extensions/api/business/SetBusinessAccountProfilePhoto.kt

@@ -0,0 +1,14 @@
+package dev.inmo.tgbotapi.extensions.api.business
+
+import dev.inmo.tgbotapi.bot.TelegramBot
+import dev.inmo.tgbotapi.requests.business_connection.InputProfilePhoto
+import dev.inmo.tgbotapi.requests.business_connection.SetBusinessAccountProfilePhoto
+import dev.inmo.tgbotapi.types.business_connection.BusinessConnectionId
+
+public suspend fun TelegramBot.setBusinessAccountProfilePhoto(
+    businessConnectionId: BusinessConnectionId,
+    photo: InputProfilePhoto,
+    isPublic: Boolean = false
+): Boolean = execute(
+    SetBusinessAccountProfilePhoto(businessConnectionId, photo, isPublic)
+) 

tgbotapi.api/src/commonMain/kotlin/dev/inmo/tgbotapi/extensions/api/business/SetBusinessAccountUsername.kt

@@ -0,0 +1,17 @@
+package dev.inmo.tgbotapi.extensions.api.business
+
+import dev.inmo.micro_utils.ksp.variations.GenerateVariations
+import dev.inmo.micro_utils.ksp.variations.GenerationVariant
+import dev.inmo.tgbotapi.bot.TelegramBot
+import dev.inmo.tgbotapi.requests.business_connection.SetBusinessAccountUsername
+import dev.inmo.tgbotapi.types.business_connection.BusinessConnectionId
+import dev.inmo.tgbotapi.types.Username
+
+@GenerateVariations
+public suspend fun TelegramBot.setBusinessAccountUsername(
+    businessConnectionId: BusinessConnectionId,
+    @GenerationVariant(String::class, "Username(username)", "username")
+    username: Username
+): Boolean = execute(
+    SetBusinessAccountUsername(businessConnectionId, username)
+) 

tgbotapi.api/src/commonMain/kotlin/dev/inmo/tgbotapi/extensions/api/business/SetBusinessAccountUsernameGeneratedVariation.kt

@@ -0,0 +1,16 @@
+// THIS CODE HAVE BEEN GENERATED AUTOMATICALLY
+// TO REGENERATE IT JUST DELETE FILE
+// ORIGINAL FILE: SetBusinessAccountUsername.kt
+package dev.inmo.tgbotapi.extensions.api.business
+
+import dev.inmo.tgbotapi.bot.TelegramBot
+import dev.inmo.tgbotapi.types.Username
+import dev.inmo.tgbotapi.types.business_connection.BusinessConnectionId
+import kotlin.Boolean
+import kotlin.String
+
+public suspend
+    fun TelegramBot.setBusinessAccountUsername(businessConnectionId: BusinessConnectionId,
+    username: String): Boolean = setBusinessAccountUsername(
+    businessConnectionId = businessConnectionId, username = with(username) { Username.prepare(username) }
+)

tgbotapi.api/src/commonMain/kotlin/dev/inmo/tgbotapi/extensions/api/business/TransferBusinessAccountStarBalance.kt

@@ -0,0 +1,12 @@
+package dev.inmo.tgbotapi.extensions.api.business
+
+import dev.inmo.tgbotapi.bot.TelegramBot
+import dev.inmo.tgbotapi.requests.business_connection.TransferBusinessAccountStars
+import dev.inmo.tgbotapi.types.business_connection.BusinessConnectionId
+
+public suspend fun TelegramBot.transferBusinessAccountStars(
+    businessConnectionId: BusinessConnectionId,
+    amount: Int
+): Boolean = execute(
+    TransferBusinessAccountStars(businessConnectionId, amount)
+) 

tgbotapi.api/src/commonMain/kotlin/dev/inmo/tgbotapi/extensions/api/business/TransferGift.kt

@@ -0,0 +1,43 @@
+package dev.inmo.tgbotapi.extensions.api.business
+
+import dev.inmo.micro_utils.ksp.variations.GenerateVariations
+import dev.inmo.micro_utils.ksp.variations.GenerationVariant
+import dev.inmo.tgbotapi.bot.TelegramBot
+import dev.inmo.tgbotapi.requests.business_connection.ConvertGiftToStars
+import dev.inmo.tgbotapi.requests.business_connection.TransferGift
+import dev.inmo.tgbotapi.requests.business_connection.UpgradeGift
+import dev.inmo.tgbotapi.types.ChatId
+import dev.inmo.tgbotapi.types.business_connection.BusinessConnectionId
+import dev.inmo.tgbotapi.types.GiftId
+import dev.inmo.tgbotapi.types.businessConnectionIdField
+import dev.inmo.tgbotapi.types.gifts.Gift
+import dev.inmo.tgbotapi.types.keepOriginalDetailsField
+import dev.inmo.tgbotapi.types.ownedGiftIdField
+import dev.inmo.tgbotapi.types.starCountField
+import kotlinx.serialization.SerialName
+
+public suspend fun TelegramBot.transferGift(
+    businessConnectionId: BusinessConnectionId,
+    ownedGiftId: GiftId,
+    newOwnerChatId: ChatId,
+    transferPaymentStarCount: Int? = null,
+): Boolean = execute(
+    TransferGift(
+        businessConnectionId = businessConnectionId,
+        ownedGiftId = ownedGiftId,
+        newOwnerChatId = newOwnerChatId,
+        transferPaymentStarCount = transferPaymentStarCount
+    )
+)
+
+public suspend fun TelegramBot.transferGift(
+    businessConnectionId: BusinessConnectionId,
+    gift: Gift.Regular,
+    newOwnerChatId: ChatId,
+    transferPaymentStarCount: Int? = null,
+): Boolean = transferGift(
+    businessConnectionId = businessConnectionId,
+    ownedGiftId = gift.id,
+    newOwnerChatId = newOwnerChatId,
+    transferPaymentStarCount = transferPaymentStarCount
+)

tgbotapi.api/src/commonMain/kotlin/dev/inmo/tgbotapi/extensions/api/business/UpgradeGift.kt

@@ -0,0 +1,42 @@
+package dev.inmo.tgbotapi.extensions.api.business
+
+import dev.inmo.micro_utils.ksp.variations.GenerateVariations
+import dev.inmo.micro_utils.ksp.variations.GenerationVariant
+import dev.inmo.tgbotapi.bot.TelegramBot
+import dev.inmo.tgbotapi.requests.business_connection.ConvertGiftToStars
+import dev.inmo.tgbotapi.requests.business_connection.UpgradeGift
+import dev.inmo.tgbotapi.types.business_connection.BusinessConnectionId
+import dev.inmo.tgbotapi.types.GiftId
+import dev.inmo.tgbotapi.types.businessConnectionIdField
+import dev.inmo.tgbotapi.types.gifts.Gift
+import dev.inmo.tgbotapi.types.keepOriginalDetailsField
+import dev.inmo.tgbotapi.types.ownedGiftIdField
+import dev.inmo.tgbotapi.types.starCountField
+import kotlinx.serialization.SerialName
+
+public suspend fun TelegramBot.convertGiftToStars(
+    businessConnectionId: BusinessConnectionId,
+    ownedGiftId: GiftId,
+    keepOriginalDetails: Boolean = false,
+    starCount: Int? = null
+): Boolean = execute(
+    UpgradeGift(
+        businessConnectionId = businessConnectionId,
+        ownedGiftId = ownedGiftId,
+        keepOriginalDetails = keepOriginalDetails,
+        starCount = starCount
+    )
+)
+
+public suspend fun TelegramBot.convertGiftToStars(
+    businessConnectionId: BusinessConnectionId,
+    gift: Gift.Regular,
+    keepOriginalDetails: Boolean = false,
+): Boolean = execute(
+    UpgradeGift(
+        businessConnectionId = businessConnectionId,
+        ownedGiftId = gift.id,
+        keepOriginalDetails = keepOriginalDetails,
+        starCount = gift.upgradeStarCount
+    )
+)

tgbotapi.api/src/commonMain/kotlin/dev/inmo/tgbotapi/extensions/api/chat/ExportChatInviteLink.kt

@@ -5,10 +5,10 @@ import dev.inmo.tgbotapi.requests.chat.ExportChatInviteLink
 import dev.inmo.tgbotapi.types.ChatIdentifier
 import dev.inmo.tgbotapi.types.chat.PublicChat
 
-suspend fun TelegramBot.exportChatInviteLink(
+public suspend fun TelegramBot.exportChatInviteLink(
     chatId: ChatIdentifier
-) = execute(ExportChatInviteLink(chatId))
+): String = execute(ExportChatInviteLink(chatId))
 
-suspend fun TelegramBot.exportChatInviteLink(
+public suspend fun TelegramBot.exportChatInviteLink(
     chat: PublicChat
-) = exportChatInviteLink(chat.id)
+): String = exportChatInviteLink(chat.id)

tgbotapi.api/src/commonMain/kotlin/dev/inmo/tgbotapi/extensions/api/chat/LeaveChat.kt

@@ -5,10 +5,10 @@ import dev.inmo.tgbotapi.requests.chat.LeaveChat
 import dev.inmo.tgbotapi.types.ChatIdentifier
 import dev.inmo.tgbotapi.types.chat.PublicChat
 
-suspend fun TelegramBot.leaveChat(
+public suspend fun TelegramBot.leaveChat(
     chatId: ChatIdentifier
-) = execute(LeaveChat(chatId))
+): Boolean = execute(LeaveChat(chatId))
 
-suspend fun TelegramBot.leaveChat(
+public suspend fun TelegramBot.leaveChat(
     chat: PublicChat
-) = leaveChat(chat.id)
+): Boolean = leaveChat(chat.id)

tgbotapi.api/src/commonMain/kotlin/dev/inmo/tgbotapi/extensions/api/chat/forum/CloseForumTopic.kt

@@ -0,0 +1,28 @@
+package dev.inmo.tgbotapi.extensions.api.chat.forum
+
+import dev.inmo.tgbotapi.bot.TelegramBot
+import dev.inmo.tgbotapi.requests.chat.forum.CloseForumTopic
+import dev.inmo.tgbotapi.types.ChatIdentifier
+import dev.inmo.tgbotapi.types.ForumTopic
+import dev.inmo.tgbotapi.types.MessageThreadId
+import dev.inmo.tgbotapi.types.chat.Chat
+
+public suspend fun TelegramBot.closeForumTopic(
+    chatId: ChatIdentifier,
+    messageThreadId: MessageThreadId
+): Boolean = execute(
+    CloseForumTopic(
+        chatId,
+        messageThreadId
+    )
+)
+
+public suspend fun TelegramBot.closeForumTopic(
+    chat: Chat,
+    messageThreadId: MessageThreadId
+): Boolean = closeForumTopic(chat.id, messageThreadId)
+
+public suspend fun TelegramBot.closeForumTopic(
+    chat: Chat,
+    forumTopic: ForumTopic
+): Boolean = closeForumTopic(chat.id, forumTopic.messageThreadId)

tgbotapi.api/src/commonMain/kotlin/dev/inmo/tgbotapi/extensions/api/chat/forum/CloseGeneralForumTopic.kt

@@ -0,0 +1,19 @@
+package dev.inmo.tgbotapi.extensions.api.chat.forum
+
+import dev.inmo.tgbotapi.bot.TelegramBot
+import dev.inmo.tgbotapi.requests.chat.forum.CloseForumTopic
+import dev.inmo.tgbotapi.requests.chat.forum.CloseGeneralForumTopic
+import dev.inmo.tgbotapi.types.ChatIdentifier
+import dev.inmo.tgbotapi.types.ForumTopic
+import dev.inmo.tgbotapi.types.MessageThreadId
+import dev.inmo.tgbotapi.types.chat.Chat
+
+public suspend fun TelegramBot.closeGeneralForumTopic(
+    chatId: ChatIdentifier
+): Boolean = execute(
+    CloseGeneralForumTopic(chatId)
+)
+
+public suspend fun TelegramBot.closeGeneralForumTopic(
+    chat: Chat
+): Boolean = closeGeneralForumTopic(chat.id)

tgbotapi.api/src/commonMain/kotlin/dev/inmo/tgbotapi/extensions/api/chat/forum/CreateForumTopic.kt

@@ -0,0 +1,30 @@
+package dev.inmo.tgbotapi.extensions.api.chat.forum
+
+import dev.inmo.tgbotapi.bot.TelegramBot
+import dev.inmo.tgbotapi.requests.chat.forum.CreateForumTopic
+import dev.inmo.tgbotapi.types.ChatIdentifier
+import dev.inmo.tgbotapi.types.CustomEmojiId
+import dev.inmo.tgbotapi.types.ForumTopic
+import dev.inmo.tgbotapi.types.chat.Chat
+import dev.inmo.tgbotapi.utils.RGBColor
+
+public suspend fun TelegramBot.createForumTopic(
+    chatId: ChatIdentifier,
+    name: String,
+    color: RGBColor,
+    iconEmojiId: CustomEmojiId? = null
+): ForumTopic = execute(
+    CreateForumTopic(
+        chatId,
+        name,
+        color,
+        iconEmojiId
+    )
+)
+
+public suspend fun TelegramBot.createForumTopic(
+    chat: Chat,
+    name: String,
+    color: RGBColor,
+    iconEmojiId: CustomEmojiId? = null
+): ForumTopic = createForumTopic(chat.id, name, color, iconEmojiId)

tgbotapi.api/src/commonMain/kotlin/dev/inmo/tgbotapi/extensions/api/chat/forum/DeleteForumTopic.kt

@@ -0,0 +1,33 @@
+package dev.inmo.tgbotapi.extensions.api.chat.forum
+
+import dev.inmo.tgbotapi.bot.TelegramBot
+import dev.inmo.tgbotapi.requests.chat.forum.DeleteForumTopic
+import dev.inmo.tgbotapi.types.ChatIdentifier
+import dev.inmo.tgbotapi.types.ForumTopic
+import dev.inmo.tgbotapi.types.MessageThreadId
+import dev.inmo.tgbotapi.types.chat.Chat
+
+public suspend fun TelegramBot.deleteForumTopic(
+    chatId: ChatIdentifier,
+    messageThreadId: MessageThreadId
+): Boolean = execute(
+    DeleteForumTopic(
+        chatId,
+        messageThreadId
+    )
+)
+
+public suspend fun TelegramBot.deleteForumTopic(
+    chatId: ChatIdentifier,
+    forumTopic: ForumTopic
+): Boolean = deleteForumTopic(chatId, forumTopic.messageThreadId)
+
+public suspend fun TelegramBot.deleteForumTopic(
+    chat: Chat,
+    messageThreadId: MessageThreadId
+): Boolean = deleteForumTopic(chat.id, messageThreadId)
+
+public suspend fun TelegramBot.deleteForumTopic(
+    chat: Chat,
+    forumTopic: ForumTopic
+): Boolean = deleteForumTopic(chat.id, forumTopic.messageThreadId)

tgbotapi.api/src/commonMain/kotlin/dev/inmo/tgbotapi/extensions/api/chat/forum/EditForumTopic.kt

@@ -0,0 +1,36 @@
+package dev.inmo.tgbotapi.extensions.api.chat.forum
+
+import dev.inmo.tgbotapi.bot.TelegramBot
+import dev.inmo.tgbotapi.requests.chat.forum.EditForumTopic
+import dev.inmo.tgbotapi.types.ChatIdentifier
+import dev.inmo.tgbotapi.types.CustomEmojiId
+import dev.inmo.tgbotapi.types.ForumTopic
+import dev.inmo.tgbotapi.types.MessageThreadId
+import dev.inmo.tgbotapi.types.chat.Chat
+
+public suspend fun TelegramBot.editForumTopic(
+    chatId: ChatIdentifier,
+    messageThreadId: MessageThreadId,
+    name: String? = null,
+    iconEmojiId: CustomEmojiId? = null
+): Boolean = execute(
+    EditForumTopic(
+        chatId,
+        messageThreadId,
+        name,
+        iconEmojiId
+    )
+)
+
+public suspend fun TelegramBot.editForumTopic(
+    chat: Chat,
+    messageThreadId: MessageThreadId,
+    name: String? = null,
+    iconEmojiId: CustomEmojiId? = null
+): Boolean = editForumTopic(chat.id, messageThreadId, name, iconEmojiId)
+
+public suspend fun TelegramBot.editForumTopic(
+    chatIdentifier: ChatIdentifier,
+    forumTopic: ForumTopic,
+    iconEmojiId: CustomEmojiId? = forumTopic.iconEmojiId
+): Boolean = editForumTopic(chatIdentifier, forumTopic.messageThreadId, forumTopic.name, iconEmojiId)

tgbotapi.api/src/commonMain/kotlin/dev/inmo/tgbotapi/extensions/api/chat/forum/EditGeneralForumTopic.kt

@@ -0,0 +1,30 @@
+package dev.inmo.tgbotapi.extensions.api.chat.forum
+
+import dev.inmo.tgbotapi.bot.TelegramBot
+import dev.inmo.tgbotapi.requests.chat.forum.EditForumTopic
+import dev.inmo.tgbotapi.requests.chat.forum.EditGeneralForumTopic
+import dev.inmo.tgbotapi.types.ChatIdentifier
+import dev.inmo.tgbotapi.types.CustomEmojiId
+import dev.inmo.tgbotapi.types.ForumTopic
+import dev.inmo.tgbotapi.types.MessageThreadId
+import dev.inmo.tgbotapi.types.chat.Chat
+
+public suspend fun TelegramBot.editGeneralForumTopic(
+    chatId: ChatIdentifier,
+    name: String
+): Boolean = execute(
+    EditGeneralForumTopic(
+        chatId,
+        name
+    )
+)
+
+public suspend fun TelegramBot.editGeneralForumTopic(
+    chat: Chat,
+    name: String
+): Boolean = editGeneralForumTopic(chat.id, name)
+
+public suspend fun TelegramBot.editGeneralForumTopic(
+    chatIdentifier: ChatIdentifier,
+    forumTopic: ForumTopic,
+): Boolean = editGeneralForumTopic(chatIdentifier, forumTopic.name)

tgbotapi.api/src/commonMain/kotlin/dev/inmo/tgbotapi/extensions/api/chat/forum/HideGeneralForumTopic.kt

@@ -0,0 +1,20 @@
+package dev.inmo.tgbotapi.extensions.api.chat.forum
+
+import dev.inmo.tgbotapi.bot.TelegramBot
+import dev.inmo.tgbotapi.requests.chat.forum.CloseForumTopic
+import dev.inmo.tgbotapi.requests.chat.forum.CloseGeneralForumTopic
+import dev.inmo.tgbotapi.requests.chat.forum.HideGeneralForumTopic
+import dev.inmo.tgbotapi.types.ChatIdentifier
+import dev.inmo.tgbotapi.types.ForumTopic
+import dev.inmo.tgbotapi.types.MessageThreadId
+import dev.inmo.tgbotapi.types.chat.Chat
+
+public suspend fun TelegramBot.hideGeneralForumTopic(
+    chatId: ChatIdentifier
+): Boolean = execute(
+    HideGeneralForumTopic(chatId)
+)
+
+public suspend fun TelegramBot.hideGeneralForumTopic(
+    chat: Chat
+): Boolean = hideGeneralForumTopic(chat.id)

tgbotapi.api/src/commonMain/kotlin/dev/inmo/tgbotapi/extensions/api/chat/forum/ReopenForumTopic.kt

@@ -0,0 +1,28 @@
+package dev.inmo.tgbotapi.extensions.api.chat.forum
+
+import dev.inmo.tgbotapi.bot.TelegramBot
+import dev.inmo.tgbotapi.requests.chat.forum.ReopenForumTopic
+import dev.inmo.tgbotapi.types.ChatIdentifier
+import dev.inmo.tgbotapi.types.ForumTopic
+import dev.inmo.tgbotapi.types.MessageThreadId
+import dev.inmo.tgbotapi.types.chat.Chat
+
+public suspend fun TelegramBot.reopenForumTopic(
+    chatId: ChatIdentifier,
+    messageThreadId: MessageThreadId
+): Boolean = execute(
+    ReopenForumTopic(
+        chatId,
+        messageThreadId
+    )
+)
+
+public suspend fun TelegramBot.reopenForumTopic(
+    chat: Chat,
+    messageThreadId: MessageThreadId
+): Boolean = reopenForumTopic(chat.id, messageThreadId)
+
+public suspend fun TelegramBot.reopenForumTopic(
+    chat: Chat,
+    forumTopic: ForumTopic
+): Boolean = reopenForumTopic(chat.id, forumTopic.messageThreadId)

tgbotapi.api/src/commonMain/kotlin/dev/inmo/tgbotapi/extensions/api/chat/forum/ReopenGeneralForumTopic.kt

@@ -0,0 +1,19 @@
+package dev.inmo.tgbotapi.extensions.api.chat.forum
+
+import dev.inmo.tgbotapi.bot.TelegramBot
+import dev.inmo.tgbotapi.requests.chat.forum.ReopenForumTopic
+import dev.inmo.tgbotapi.requests.chat.forum.ReopenGeneralForumTopic
+import dev.inmo.tgbotapi.types.ChatIdentifier
+import dev.inmo.tgbotapi.types.ForumTopic
+import dev.inmo.tgbotapi.types.MessageThreadId
+import dev.inmo.tgbotapi.types.chat.Chat
+
+public suspend fun TelegramBot.reopenGeneralForumTopic(
+    chatId: ChatIdentifier
+): Boolean = execute(
+    ReopenGeneralForumTopic(chatId)
+)
+
+public suspend fun TelegramBot.reopenGeneralForumTopic(
+    chat: Chat
+): Boolean = reopenGeneralForumTopic(chat.id)

tgbotapi.api/src/commonMain/kotlin/dev/inmo/tgbotapi/extensions/api/chat/forum/UnhideGeneralForumTopic.kt

@@ -0,0 +1,21 @@
+package dev.inmo.tgbotapi.extensions.api.chat.forum
+
+import dev.inmo.tgbotapi.bot.TelegramBot
+import dev.inmo.tgbotapi.requests.chat.forum.CloseForumTopic
+import dev.inmo.tgbotapi.requests.chat.forum.CloseGeneralForumTopic
+import dev.inmo.tgbotapi.requests.chat.forum.HideGeneralForumTopic
+import dev.inmo.tgbotapi.requests.chat.forum.UnhideGeneralForumTopic
+import dev.inmo.tgbotapi.types.ChatIdentifier
+import dev.inmo.tgbotapi.types.ForumTopic
+import dev.inmo.tgbotapi.types.MessageThreadId
+import dev.inmo.tgbotapi.types.chat.Chat
+
+public suspend fun TelegramBot.unhideGeneralForumTopic(
+    chatId: ChatIdentifier
+): Boolean = execute(
+    UnhideGeneralForumTopic(chatId)
+)
+
+public suspend fun TelegramBot.unhideGeneralForumTopic(
+    chat: Chat
+): Boolean = unhideGeneralForumTopic(chat.id)

tgbotapi.api/src/commonMain/kotlin/dev/inmo/tgbotapi/extensions/api/chat/forum/UnpinAllForumTopicMessages.kt

@@ -0,0 +1,28 @@
+package dev.inmo.tgbotapi.extensions.api.chat.forum
+
+import dev.inmo.tgbotapi.bot.TelegramBot
+import dev.inmo.tgbotapi.requests.chat.forum.UnpinAllForumTopicMessages
+import dev.inmo.tgbotapi.types.ChatIdentifier
+import dev.inmo.tgbotapi.types.ForumTopic
+import dev.inmo.tgbotapi.types.MessageThreadId
+import dev.inmo.tgbotapi.types.chat.Chat
+
+public suspend fun TelegramBot.unpinAllForumTopicMessages(
+    chatId: ChatIdentifier,
+    messageThreadId: MessageThreadId
+): Boolean = execute(
+    UnpinAllForumTopicMessages(
+        chatId,
+        messageThreadId
+    )
+)
+
+public suspend fun TelegramBot.unpinAllForumTopicMessages(
+    chat: Chat,
+    messageThreadId: MessageThreadId
+): Boolean = unpinAllForumTopicMessages(chat.id, messageThreadId)
+
+public suspend fun TelegramBot.unpinAllForumTopicMessages(
+    chat: Chat,
+    forumTopic: ForumTopic
+): Boolean = unpinAllForumTopicMessages(chat.id, forumTopic.messageThreadId)

tgbotapi.api/src/commonMain/kotlin/dev/inmo/tgbotapi/extensions/api/chat/forum/UnpinAllGeneralForumTopicMessages.kt

@@ -0,0 +1,21 @@
+package dev.inmo.tgbotapi.extensions.api.chat.forum
+
+import dev.inmo.tgbotapi.bot.TelegramBot
+import dev.inmo.tgbotapi.requests.chat.forum.UnpinAllForumTopicMessages
+import dev.inmo.tgbotapi.requests.chat.forum.UnpinAllGeneralForumTopicMessages
+import dev.inmo.tgbotapi.types.ChatIdentifier
+import dev.inmo.tgbotapi.types.ForumTopic
+import dev.inmo.tgbotapi.types.MessageThreadId
+import dev.inmo.tgbotapi.types.chat.Chat
+
+public suspend fun TelegramBot.unpinAllGeneralForumTopicMessages(
+    chatId: ChatIdentifier
+): Boolean = execute(
+    UnpinAllGeneralForumTopicMessages(
+        chatId
+    )
+)
+
+public suspend fun TelegramBot.unpinAllGeneralForumTopicMessages(
+    chat: Chat
+): Boolean = unpinAllGeneralForumTopicMessages(chat.id)

tgbotapi.api/src/commonMain/kotlin/dev/inmo/tgbotapi/extensions/api/chat/get/GetChat.kt

@@ -6,13 +6,13 @@ import dev.inmo.tgbotapi.types.ChatIdentifier
 import dev.inmo.tgbotapi.types.chat.*
 import dev.inmo.tgbotapi.utils.PreviewFeature
 
-suspend fun TelegramBot.getChat(
+public suspend fun TelegramBot.getChat(
     chatId: ChatIdentifier
-) = execute(GetChat(chatId))
+): ExtendedChat = execute(GetChat(chatId))
 
-suspend fun TelegramBot.getChat(
+public suspend fun TelegramBot.getChat(
     chat: Chat
-) = getChat(chat.id)
+): ExtendedChat = getChat(chat.id)
 
 /**
  * Will cast incoming [dev.inmo.tgbotapi.types.chat.ExtendedChat] to a
@@ -21,9 +21,9 @@ suspend fun TelegramBot.getChat(
  * @throws ClassCastException
  */
 @PreviewFeature
-suspend fun TelegramBot.getChat(
+public suspend fun TelegramBot.getChat(
     chat: PublicChat
-) = getChat(chat.id) as ExtendedPublicChat
+): ExtendedPublicChat = getChat(chat.id) as ExtendedPublicChat
 
 
 /**
@@ -33,9 +33,9 @@ suspend fun TelegramBot.getChat(
  * @throws ClassCastException
  */
 @PreviewFeature
-suspend fun TelegramBot.getChat(
+public suspend fun TelegramBot.getChat(
     chat: ChannelChat
-) = getChat(chat.id) as ExtendedChannelChat
+): ExtendedChannelChat = getChat(chat.id) as ExtendedChannelChat
 
 /**
  * Will cast incoming [dev.inmo.tgbotapi.types.chat.ExtendedChat] to a
@@ -44,9 +44,9 @@ suspend fun TelegramBot.getChat(
  * @throws ClassCastException
  */
 @PreviewFeature
-suspend fun TelegramBot.getChat(
+public suspend fun TelegramBot.getChat(
     chat: ChannelChatImpl
-) = getChat(chat.id) as ExtendedChannelChatImpl
+): ExtendedChannelChatImpl = getChat(chat.id) as ExtendedChannelChatImpl
 
 
 /**
@@ -56,9 +56,9 @@ suspend fun TelegramBot.getChat(
  * @throws ClassCastException
  */
 @PreviewFeature
-suspend fun TelegramBot.getChat(
+public suspend fun TelegramBot.getChat(
     chat: GroupChat
-) = getChat(chat.id) as ExtendedGroupChat
+): ExtendedGroupChat = getChat(chat.id) as ExtendedGroupChat
 
 /**
  * Will cast incoming [dev.inmo.tgbotapi.types.chat.ExtendedChat] to a
@@ -67,9 +67,9 @@ suspend fun TelegramBot.getChat(
  * @throws ClassCastException
  */
 @PreviewFeature
-suspend fun TelegramBot.getChat(
+public suspend fun TelegramBot.getChat(
     chat: GroupChatImpl
-) = getChat(chat.id) as ExtendedGroupChatImpl
+): ExtendedGroupChatImpl = getChat(chat.id) as ExtendedGroupChatImpl
 
 
 /**
@@ -79,9 +79,9 @@ suspend fun TelegramBot.getChat(
  * @throws ClassCastException
  */
 @PreviewFeature
-suspend fun TelegramBot.getChat(
+public suspend fun TelegramBot.getChat(
     chat: SupergroupChat
-) = getChat(chat.id) as ExtendedSupergroupChat
+): ExtendedSupergroupChat = getChat(chat.id) as ExtendedSupergroupChat
 
 /**
  * Will cast incoming [dev.inmo.tgbotapi.types.chat.ExtendedChat] to a
@@ -90,9 +90,9 @@ suspend fun TelegramBot.getChat(
  * @throws ClassCastException
  */
 @PreviewFeature
-suspend fun TelegramBot.getChat(
+public suspend fun TelegramBot.getChat(
     chat: SupergroupChatImpl
-) = getChat(chat.id) as ExtendedSupergroupChatImpl
+): ExtendedSupergroupChatImpl = getChat(chat.id) as ExtendedSupergroupChatImpl
 
 
 /**
@@ -102,9 +102,9 @@ suspend fun TelegramBot.getChat(
  * @throws ClassCastException
  */
 @PreviewFeature
-suspend fun TelegramBot.getChat(
+public suspend fun TelegramBot.getChat(
     chat: PrivateChat
-) = getChat(chat.id) as ExtendedPrivateChat
+): ExtendedPrivateChat = getChat(chat.id) as ExtendedPrivateChat
 
 /**
  * Will cast incoming [dev.inmo.tgbotapi.types.chat.ExtendedChat] to a
@@ -113,9 +113,9 @@ suspend fun TelegramBot.getChat(
  * @throws ClassCastException
  */
 @PreviewFeature
-suspend fun TelegramBot.getChat(
+public suspend fun TelegramBot.getChat(
     chat: PrivateChatImpl
-) = getChat(chat.id) as ExtendedPrivateChatImpl
+): ExtendedPrivateChatImpl = getChat(chat.id) as ExtendedPrivateChatImpl
 
 /**
  * Will cast incoming [dev.inmo.tgbotapi.types.chat.ExtendedChat] to a
@@ -124,6 +124,6 @@ suspend fun TelegramBot.getChat(
  * @throws ClassCastException
  */
 @PreviewFeature
-suspend fun TelegramBot.getChat(
+public suspend fun TelegramBot.getChat(
     chat: CommonUser
-) = getChat(chat.id) as ExtendedUser
+): ExtendedUser = getChat(chat.id) as ExtendedUser

tgbotapi.api/src/commonMain/kotlin/dev/inmo/tgbotapi/extensions/api/chat/get/GetChatAdministrators.kt

@@ -4,11 +4,12 @@ import dev.inmo.tgbotapi.bot.TelegramBot
 import dev.inmo.tgbotapi.requests.chat.get.GetChatAdministrators
 import dev.inmo.tgbotapi.types.ChatIdentifier
 import dev.inmo.tgbotapi.types.chat.PublicChat
+import dev.inmo.tgbotapi.types.chat.member.AdministratorChatMember
 
-suspend fun TelegramBot.getChatAdministrators(
+public suspend fun TelegramBot.getChatAdministrators(
     chatId: ChatIdentifier
-) = execute(GetChatAdministrators(chatId))
+): List<AdministratorChatMember> = execute(GetChatAdministrators(chatId))
 
-suspend fun TelegramBot.getChatAdministrators(
+public suspend fun TelegramBot.getChatAdministrators(
     chat: PublicChat
-) = getChatAdministrators(chat.id)
+): List<AdministratorChatMember> = getChatAdministrators(chat.id)

tgbotapi.api/src/commonMain/kotlin/dev/inmo/tgbotapi/extensions/api/chat/get/GetChatMemberCount.kt

@@ -5,10 +5,10 @@ import dev.inmo.tgbotapi.requests.chat.get.GetChatMemberCount
 import dev.inmo.tgbotapi.types.ChatIdentifier
 import dev.inmo.tgbotapi.types.chat.PublicChat
 
-suspend fun TelegramBot.getChatMemberCount(
+public suspend fun TelegramBot.getChatMemberCount(
     chatId: ChatIdentifier
-) = execute(GetChatMemberCount(chatId))
+): Int = execute(GetChatMemberCount(chatId))
 
-suspend fun TelegramBot.getChatMemberCount(
+public suspend fun TelegramBot.getChatMemberCount(
     chat: PublicChat
-) = getChatMemberCount(chat.id)
+): Int = getChatMemberCount(chat.id)

tgbotapi.api/src/commonMain/kotlin/dev/inmo/tgbotapi/extensions/api/chat/get/GetChatMenuButton.kt

@@ -2,13 +2,14 @@ package dev.inmo.tgbotapi.extensions.api.chat.get
 
 import dev.inmo.tgbotapi.bot.TelegramBot
 import dev.inmo.tgbotapi.requests.chat.get.GetChatMenuButton
-import dev.inmo.tgbotapi.types.*
+import dev.inmo.tgbotapi.types.IdChatIdentifier
+import dev.inmo.tgbotapi.types.MenuButton
 import dev.inmo.tgbotapi.types.chat.PrivateChat
 
-suspend fun TelegramBot.getChatMenuButton(
-    chatId: ChatId
-) = execute(GetChatMenuButton(chatId))
+public suspend fun TelegramBot.getChatMenuButton(
+    chatId: IdChatIdentifier
+): MenuButton = execute(GetChatMenuButton(chatId))
 
-suspend fun TelegramBot.getChatMenuButton(
+public suspend fun TelegramBot.getChatMenuButton(
     chat: PrivateChat
-) = getChatMenuButton(chat.id)
+): MenuButton = getChatMenuButton(chat.id)

tgbotapi.api/src/commonMain/kotlin/dev/inmo/tgbotapi/extensions/api/chat/get/GetDefaultChatMenuButton.kt

@@ -2,7 +2,6 @@ package dev.inmo.tgbotapi.extensions.api.chat.get
 
 import dev.inmo.tgbotapi.bot.TelegramBot
 import dev.inmo.tgbotapi.requests.chat.get.GetDefaultChatMenuButton
-import dev.inmo.tgbotapi.requests.chat.modify.SetDefaultChatMenuButton
 import dev.inmo.tgbotapi.types.MenuButton
 
-suspend fun TelegramBot.getDefaultChatMenuButton() = execute(GetDefaultChatMenuButton)
+public suspend fun TelegramBot.getDefaultChatMenuButton(): MenuButton = execute(GetDefaultChatMenuButton)

tgbotapi.api/src/commonMain/kotlin/dev/inmo/tgbotapi/extensions/api/chat/get/GetForumTopicIconStickers.kt

@@ -0,0 +1,7 @@
+package dev.inmo.tgbotapi.extensions.api.chat.get
+
+import dev.inmo.tgbotapi.bot.TelegramBot
+import dev.inmo.tgbotapi.requests.chat.get.GetForumTopicIconStickers
+import dev.inmo.tgbotapi.types.files.Sticker
+
+public suspend fun TelegramBot.getForumTopicIconStickers(): List<Sticker> = execute(GetForumTopicIconStickers)

tgbotapi.api/src/commonMain/kotlin/dev/inmo/tgbotapi/extensions/api/chat/invite_links/ApproveChatJoinRequest.kt

@@ -2,39 +2,41 @@ package dev.inmo.tgbotapi.extensions.api.chat.invite_links
 
 import dev.inmo.tgbotapi.bot.TelegramBot
 import dev.inmo.tgbotapi.requests.chat.invite_links.ApproveChatJoinRequest
-import dev.inmo.tgbotapi.types.*
-import dev.inmo.tgbotapi.types.chat.*
+import dev.inmo.tgbotapi.types.ChatIdentifier
+import dev.inmo.tgbotapi.types.UserId
+import dev.inmo.tgbotapi.types.chat.ChatJoinRequest
+import dev.inmo.tgbotapi.types.chat.PublicChat
 import dev.inmo.tgbotapi.types.chat.User
 import dev.inmo.tgbotapi.types.update.ChatJoinRequestUpdate
 
-suspend fun TelegramBot.approveChatJoinRequest(
+public suspend fun TelegramBot.approveChatJoinRequest(
     chatId: ChatIdentifier,
     userId: UserId
-) = execute(ApproveChatJoinRequest(chatId, userId))
+): Boolean = execute(ApproveChatJoinRequest(chatId, userId))
 
-suspend fun TelegramBot.approveChatJoinRequest(
+public suspend fun TelegramBot.approveChatJoinRequest(
     chat: PublicChat,
     userId: UserId
-) = approveChatJoinRequest(chat.id, userId)
+): Boolean = approveChatJoinRequest(chat.id, userId)
 
-suspend fun TelegramBot.approveChatJoinRequest(
+public suspend fun TelegramBot.approveChatJoinRequest(
     chatId: ChatIdentifier,
     user: User
-) = approveChatJoinRequest(chatId, user.id)
+): Boolean = approveChatJoinRequest(chatId, user.id)
 
-suspend fun TelegramBot.approveChatJoinRequest(
+public suspend fun TelegramBot.approveChatJoinRequest(
     chat: PublicChat,
     user: User
-) = approveChatJoinRequest(chat.id, user.id)
+): Boolean = approveChatJoinRequest(chat.id, user.id)
 
-suspend fun TelegramBot.approveChatJoinRequest(
+public suspend fun TelegramBot.approveChatJoinRequest(
     chatJoinRequest: ChatJoinRequest
-) = approveChatJoinRequest(chatJoinRequest.chat, chatJoinRequest.user)
+): Boolean = approveChatJoinRequest(chatJoinRequest.chat, chatJoinRequest.user)
 
-suspend fun TelegramBot.approve(
+public suspend fun TelegramBot.approve(
     chatJoinRequest: ChatJoinRequest
-) = approveChatJoinRequest(chatJoinRequest)
+): Boolean = approveChatJoinRequest(chatJoinRequest)
 
-suspend fun TelegramBot.approveChatJoinRequest(
+public suspend fun TelegramBot.approveChatJoinRequest(
     chatJoinRequestUpdate: ChatJoinRequestUpdate
-) = approveChatJoinRequest(chatJoinRequestUpdate.data)
+): Boolean = approveChatJoinRequest(chatJoinRequestUpdate.data)

tgbotapi.api/src/commonMain/kotlin/dev/inmo/tgbotapi/extensions/api/chat/invite_links/CreateChatInviteLink.kt

@@ -1,83 +1,153 @@
 package dev.inmo.tgbotapi.extensions.api.chat.invite_links
 
-import com.soywiz.klock.DateTime
+import korlibs.time.DateTime
 import dev.inmo.tgbotapi.bot.TelegramBot
 import dev.inmo.tgbotapi.requests.chat.invite_links.CreateChatInviteLink
 import dev.inmo.tgbotapi.types.*
 import dev.inmo.tgbotapi.types.chat.PublicChat
+import korlibs.time.TimeSpan
+import korlibs.time.days
 
-suspend fun TelegramBot.createChatInviteLinkUnlimited(
+public suspend fun TelegramBot.createChatInviteLinkUnlimited(
     chatId: ChatIdentifier,
     name: String? = null,
     expiration: TelegramDate? = null
-) = execute(CreateChatInviteLink.unlimited(chatId, name, expiration))
+): ChatInviteLinkUnlimited = execute(CreateChatInviteLink.unlimited(chatId, name, expiration))
 
-suspend fun TelegramBot.createChatInviteLinkUnlimited(
+public suspend fun TelegramBot.createChatInviteLinkUnlimited(
     chat: PublicChat,
     name: String? = null,
     expiration: TelegramDate? = null,
-) = createChatInviteLinkUnlimited(chat.id, name, expiration)
+): ChatInviteLinkUnlimited = createChatInviteLinkUnlimited(chat.id, name, expiration)
 
-suspend fun TelegramBot.createChatInviteLinkUnlimited(
+public suspend fun TelegramBot.createChatInviteLinkUnlimited(
     chatId: ChatIdentifier,
     expiration: DateTime,
     name: String? = null,
-) = createChatInviteLinkUnlimited(chatId, name, expiration.toTelegramDate())
+): ChatInviteLinkUnlimited = createChatInviteLinkUnlimited(chatId, name, expiration.toTelegramDate())
 
-suspend fun TelegramBot.createChatInviteLinkUnlimited(
+public suspend fun TelegramBot.createChatInviteLinkUnlimited(
     chat: PublicChat,
     expiration: DateTime,
     name: String? = null
-) = createChatInviteLinkUnlimited(chat.id, name, expiration.toTelegramDate())
+): ChatInviteLinkUnlimited = createChatInviteLinkUnlimited(chat.id, name, expiration.toTelegramDate())
 
-suspend fun TelegramBot.createChatInviteLinkWithLimitedMembers(
+public suspend fun TelegramBot.createChatInviteLinkWithLimitedMembers(
     chatId: ChatIdentifier,
     membersLimit: MembersLimit,
     name: String? = null,
     expiration: TelegramDate? = null
-) = execute(CreateChatInviteLink.withLimitedMembers(chatId, membersLimit, name, expiration))
+): ChatInviteLinkWithLimitedMembers = execute(CreateChatInviteLink.withLimitedMembers(chatId, membersLimit, name, expiration))
 
-suspend fun TelegramBot.createChatInviteLinkWithLimitedMembers(
+public suspend fun TelegramBot.createChatInviteLinkWithLimitedMembers(
     chat: PublicChat,
     membersLimit: MembersLimit,
     name: String? = null,
     expiration: TelegramDate? = null,
-) = createChatInviteLinkWithLimitedMembers(chat.id, membersLimit, name, expiration)
+): ChatInviteLinkWithLimitedMembers = createChatInviteLinkWithLimitedMembers(chat.id, membersLimit, name, expiration)
 
-suspend fun TelegramBot.createChatInviteLinkWithLimitedMembers(
+public suspend fun TelegramBot.createChatInviteLinkWithLimitedMembers(
     chatId: ChatIdentifier,
     membersLimit: MembersLimit,
     expiration: DateTime,
     name: String? = null,
-) = createChatInviteLinkWithLimitedMembers(chatId, membersLimit, name, expiration.toTelegramDate())
+): ChatInviteLinkWithLimitedMembers = createChatInviteLinkWithLimitedMembers(chatId, membersLimit, name, expiration.toTelegramDate())
 
-suspend fun TelegramBot.createChatInviteLinkWithLimitedMembers(
+public suspend fun TelegramBot.createChatInviteLinkWithLimitedMembers(
     chat: PublicChat,
     membersLimit: MembersLimit,
     expiration: DateTime,
     name: String? = null,
-) = createChatInviteLinkWithLimitedMembers(chat.id, membersLimit, name, expiration.toTelegramDate())
+): ChatInviteLinkWithLimitedMembers = createChatInviteLinkWithLimitedMembers(chat.id, membersLimit, name, expiration.toTelegramDate())
 
-suspend fun TelegramBot.createChatInviteLinkWithJoinRequest(
+public suspend fun TelegramBot.createChatInviteLinkWithJoinRequest(
     chatId: ChatIdentifier,
     name: String? = null,
     expiration: TelegramDate? = null
-) = execute(CreateChatInviteLink.withJoinRequest(chatId, name, expiration))
+): ChatInviteLinkWithJoinRequest = execute(CreateChatInviteLink.withJoinRequest(chatId, name, expiration))
 
-suspend fun TelegramBot.createChatInviteLinkWithJoinRequest(
+public suspend fun TelegramBot.createChatInviteLinkWithJoinRequest(
     chat: PublicChat,
     name: String? = null,
     expiration: TelegramDate? = null,
-) = createChatInviteLinkWithJoinRequest(chat.id, name, expiration)
+): ChatInviteLinkWithJoinRequest = createChatInviteLinkWithJoinRequest(chat.id, name, expiration)
 
-suspend fun TelegramBot.createChatInviteLinkWithJoinRequest(
+public suspend fun TelegramBot.createChatInviteLinkWithJoinRequest(
     chatId: ChatIdentifier,
     expiration: DateTime,
     name: String? = null,
-) = createChatInviteLinkWithJoinRequest(chatId, name, expiration.toTelegramDate())
+): ChatInviteLinkWithJoinRequest = createChatInviteLinkWithJoinRequest(chatId, name, expiration.toTelegramDate())
 
-suspend fun TelegramBot.createChatInviteLinkWithJoinRequest(
+public suspend fun TelegramBot.createChatInviteLinkWithJoinRequest(
     chat: PublicChat,
     expiration: DateTime,
     name: String? = null,
-) = createChatInviteLinkWithJoinRequest(chat.id, name, expiration.toTelegramDate())
+): ChatInviteLinkWithJoinRequest = createChatInviteLinkWithJoinRequest(chat.id, name, expiration.toTelegramDate())
+
+
+// Subscriptions
+
+public suspend fun TelegramBot.createChatSubscriptionInviteLink(
+    chatId: ChatIdentifier,
+    subscriptionPrice: UInt,
+    subscriptionPeriod: TimeSpan = 30.days,
+    name: String? = null,
+    expirationUnixTimeStamp: TelegramDate? = null,
+): ChatInviteLinkUnlimited = execute(CreateChatInviteLink.subscription(chatId, subscriptionPrice, subscriptionPeriod, name, expirationUnixTimeStamp))
+
+public suspend fun TelegramBot.createChatSubscriptionInviteLink(
+    chat: PublicChat,
+    subscriptionPrice: UInt,
+    subscriptionPeriod: TimeSpan = 30.days,
+    name: String? = null,
+    expirationUnixTimeStamp: TelegramDate? = null,
+): ChatInviteLinkUnlimited = createChatSubscriptionInviteLink(chat.id, subscriptionPrice, subscriptionPeriod, name, expirationUnixTimeStamp)
+
+public suspend fun TelegramBot.createChatSubscriptionInviteLink(
+    chatId: ChatIdentifier,
+    subscriptionPrice: UInt,
+    subscriptionPeriod: TimeSpan = 30.days,
+    name: String? = null,
+    expirationUnixTimeStamp: DateTime,
+): ChatInviteLinkUnlimited = createChatSubscriptionInviteLink(chatId, subscriptionPrice, subscriptionPeriod, name, expirationUnixTimeStamp.toTelegramDate())
+
+public suspend fun TelegramBot.createChatSubscriptionInviteLink(
+    chat: PublicChat,
+    subscriptionPrice: UInt,
+    subscriptionPeriod: TimeSpan = 30.days,
+    name: String? = null,
+    expirationUnixTimeStamp: DateTime,
+): ChatInviteLinkUnlimited = createChatSubscriptionInviteLink(chat.id, subscriptionPrice, subscriptionPeriod, name, expirationUnixTimeStamp)
+
+
+public suspend fun TelegramBot.createChatSubscriptionInviteLink(
+    chatId: ChatIdentifier,
+    subscriptionPrice: Int,
+    subscriptionPeriod: TimeSpan = 30.days,
+    name: String? = null,
+    expirationUnixTimeStamp: TelegramDate? = null,
+): ChatInviteLinkUnlimited = createChatSubscriptionInviteLink(chatId, subscriptionPrice.toUInt(), subscriptionPeriod, name, expirationUnixTimeStamp)
+
+public suspend fun TelegramBot.createChatSubscriptionInviteLink(
+    chat: PublicChat,
+    subscriptionPrice: Int,
+    subscriptionPeriod: TimeSpan = 30.days,
+    name: String? = null,
+    expirationUnixTimeStamp: TelegramDate? = null,
+): ChatInviteLinkUnlimited = createChatSubscriptionInviteLink(chat, subscriptionPrice.toUInt(), subscriptionPeriod, name, expirationUnixTimeStamp)
+
+public suspend fun TelegramBot.createChatSubscriptionInviteLink(
+    chatId: ChatIdentifier,
+    subscriptionPrice: Int,
+    subscriptionPeriod: TimeSpan = 30.days,
+    name: String? = null,
+    expirationUnixTimeStamp: DateTime,
+): ChatInviteLinkUnlimited = createChatSubscriptionInviteLink(chatId, subscriptionPrice.toUInt(), subscriptionPeriod, name, expirationUnixTimeStamp)
+
+public suspend fun TelegramBot.createChatSubscriptionInviteLink(
+    chat: PublicChat,
+    subscriptionPrice: Int,
+    subscriptionPeriod: TimeSpan = 30.days,
+    name: String? = null,
+    expirationUnixTimeStamp: DateTime,
+): ChatInviteLinkUnlimited = createChatSubscriptionInviteLink(chat, subscriptionPrice.toUInt(), subscriptionPeriod, name, expirationUnixTimeStamp)

tgbotapi.api/src/commonMain/kotlin/dev/inmo/tgbotapi/extensions/api/chat/invite_links/DeclineChatJoinRequest.kt

@@ -2,39 +2,41 @@ package dev.inmo.tgbotapi.extensions.api.chat.invite_links
 
 import dev.inmo.tgbotapi.bot.TelegramBot
 import dev.inmo.tgbotapi.requests.chat.invite_links.DeclineChatJoinRequest
-import dev.inmo.tgbotapi.types.*
-import dev.inmo.tgbotapi.types.chat.*
+import dev.inmo.tgbotapi.types.ChatIdentifier
+import dev.inmo.tgbotapi.types.UserId
+import dev.inmo.tgbotapi.types.chat.ChatJoinRequest
+import dev.inmo.tgbotapi.types.chat.PublicChat
 import dev.inmo.tgbotapi.types.chat.User
 import dev.inmo.tgbotapi.types.update.ChatJoinRequestUpdate
 
-suspend fun TelegramBot.declineChatJoinRequest(
+public suspend fun TelegramBot.declineChatJoinRequest(
     chatId: ChatIdentifier,
     userId: UserId
-) = execute(DeclineChatJoinRequest(chatId, userId))
+): Boolean = execute(DeclineChatJoinRequest(chatId, userId))
 
-suspend fun TelegramBot.declineChatJoinRequest(
+public suspend fun TelegramBot.declineChatJoinRequest(
     chat: PublicChat,
     userId: UserId
-) = declineChatJoinRequest(chat.id, userId)
+): Boolean = declineChatJoinRequest(chat.id, userId)
 
-suspend fun TelegramBot.declineChatJoinRequest(
+public suspend fun TelegramBot.declineChatJoinRequest(
     chatId: ChatIdentifier,
     user: User
-) = declineChatJoinRequest(chatId, user.id)
+): Boolean = declineChatJoinRequest(chatId, user.id)
 
-suspend fun TelegramBot.declineChatJoinRequest(
+public suspend fun TelegramBot.declineChatJoinRequest(
     chat: PublicChat,
     user: User
-) = declineChatJoinRequest(chat.id, user.id)
+): Boolean = declineChatJoinRequest(chat.id, user.id)
 
-suspend fun TelegramBot.declineChatJoinRequest(
+public suspend fun TelegramBot.declineChatJoinRequest(
     chatJoinRequest: ChatJoinRequest
-) = declineChatJoinRequest(chatJoinRequest.chat, chatJoinRequest.user)
+): Boolean = declineChatJoinRequest(chatJoinRequest.chat, chatJoinRequest.user)
 
-suspend fun TelegramBot.decline(
+public suspend fun TelegramBot.decline(
     chatJoinRequest: ChatJoinRequest
-) = declineChatJoinRequest(chatJoinRequest)
+): Boolean = declineChatJoinRequest(chatJoinRequest)
 
-suspend fun TelegramBot.declineChatJoinRequest(
+public suspend fun TelegramBot.declineChatJoinRequest(
     chatJoinRequestUpdate: ChatJoinRequestUpdate
-) = declineChatJoinRequest(chatJoinRequestUpdate.data)
+): Boolean = declineChatJoinRequest(chatJoinRequestUpdate.data)

tgbotapi.api/src/commonMain/kotlin/dev/inmo/tgbotapi/extensions/api/chat/invite_links/EditChatInviteLink.kt

@@ -1,183 +1,210 @@
 package dev.inmo.tgbotapi.extensions.api.chat.invite_links
 
-import com.soywiz.klock.DateTime
+import korlibs.time.DateTime
 import dev.inmo.tgbotapi.bot.TelegramBot
 import dev.inmo.tgbotapi.requests.chat.invite_links.EditChatInviteLink
 import dev.inmo.tgbotapi.types.*
 import dev.inmo.tgbotapi.types.chat.PublicChat
 
-suspend fun TelegramBot.editChatInviteLinkUnlimited(
+public suspend fun TelegramBot.editChatInviteLinkUnlimited(
     chatId: ChatIdentifier,
     previousLink: String,
     name: String? = null,
     expiration: TelegramDate? = null
-) = execute(EditChatInviteLink.unlimited(chatId, previousLink, name, expiration))
+): ChatInviteLinkUnlimited = execute(EditChatInviteLink.unlimited(chatId, previousLink, name, expiration))
 
-suspend fun TelegramBot.editChatInviteLinkUnlimited(
+public suspend fun TelegramBot.editChatInviteLinkUnlimited(
     chat: PublicChat,
     previousLink: String,
     name: String? = null,
     expiration: TelegramDate? = null,
-) = editChatInviteLinkUnlimited(chat.id, previousLink, name, expiration)
+): ChatInviteLinkUnlimited = editChatInviteLinkUnlimited(chat.id, previousLink, name, expiration)
 
-suspend fun TelegramBot.editChatInviteLinkUnlimited(
+public suspend fun TelegramBot.editChatInviteLinkUnlimited(
     chatId: ChatIdentifier,
     previousLink: String,
     expiration: DateTime,
     name: String? = null,
-) = editChatInviteLinkUnlimited(chatId, previousLink, name , expiration.toTelegramDate())
+): ChatInviteLinkUnlimited = editChatInviteLinkUnlimited(chatId, previousLink, name , expiration.toTelegramDate())
 
-suspend fun TelegramBot.editChatInviteLinkUnlimited(
+public suspend fun TelegramBot.editChatInviteLinkUnlimited(
     chat: PublicChat,
     previousLink: String,
     expiration: DateTime,
     name: String? = null,
-) = editChatInviteLinkUnlimited(chat.id, previousLink, name , expiration.toTelegramDate())
+): ChatInviteLinkUnlimited = editChatInviteLinkUnlimited(chat.id, previousLink, name , expiration.toTelegramDate())
 
-suspend fun TelegramBot.editChatInviteLinkWithLimitedMembers(
+public suspend fun TelegramBot.editChatInviteLinkWithLimitedMembers(
     chatId: ChatIdentifier,
     previousLink: String,
     membersLimit: MembersLimit,
     name: String? = null,
     expiration: TelegramDate? = null
-) = execute(EditChatInviteLink.withLimitedMembers(chatId, previousLink, membersLimit, name, expiration))
+): ChatInviteLinkWithLimitedMembers = execute(EditChatInviteLink.withLimitedMembers(chatId, previousLink, membersLimit, name, expiration))
 
-suspend fun TelegramBot.editChatInviteLinkWithLimitedMembers(
+public suspend fun TelegramBot.editChatInviteLinkWithLimitedMembers(
     chat: PublicChat,
     previousLink: String,
     membersLimit: MembersLimit,
     name: String? = null,
     expiration: TelegramDate? = null,
-) = editChatInviteLinkWithLimitedMembers(chat.id, previousLink, membersLimit, name, expiration)
+): ChatInviteLinkWithLimitedMembers = editChatInviteLinkWithLimitedMembers(chat.id, previousLink, membersLimit, name, expiration)
 
-suspend fun TelegramBot.editChatInviteLinkWithLimitedMembers(
+public suspend fun TelegramBot.editChatInviteLinkWithLimitedMembers(
     chatId: ChatIdentifier,
     previousLink: String,
     membersLimit: MembersLimit,
     expiration: DateTime,
     name: String? = null,
-) = editChatInviteLinkWithLimitedMembers(chatId, previousLink, membersLimit, name , expiration.toTelegramDate())
+): ChatInviteLinkWithLimitedMembers = editChatInviteLinkWithLimitedMembers(chatId, previousLink, membersLimit, name , expiration.toTelegramDate())
 
-suspend fun TelegramBot.editChatInviteLinkWithLimitedMembers(
+public suspend fun TelegramBot.editChatInviteLinkWithLimitedMembers(
     chat: PublicChat,
     previousLink: String,
     membersLimit: MembersLimit,
     expiration: DateTime,
     name: String? = null,
-) = editChatInviteLinkWithLimitedMembers(chat.id, previousLink, membersLimit, name , expiration.toTelegramDate())
+): ChatInviteLinkWithLimitedMembers = editChatInviteLinkWithLimitedMembers(chat.id, previousLink, membersLimit, name , expiration.toTelegramDate())
 
-suspend fun TelegramBot.editChatInviteLinkWithJoinRequest(
+public suspend fun TelegramBot.editChatInviteLinkWithJoinRequest(
     chatId: ChatIdentifier,
     previousLink: String,
     name: String? = null,
     expiration: TelegramDate? = null
-) = execute(EditChatInviteLink.withJoinRequest(chatId, previousLink, name, expiration))
+): ChatInviteLinkWithJoinRequest = execute(EditChatInviteLink.withJoinRequest(chatId, previousLink, name, expiration))
 
-suspend fun TelegramBot.editChatInviteLinkWithJoinRequest(
+public suspend fun TelegramBot.editChatInviteLinkWithJoinRequest(
     chat: PublicChat,
     previousLink: String,
     name: String? = null,
     expiration: TelegramDate? = null,
-) = editChatInviteLinkWithJoinRequest(chat.id, previousLink, name, expiration)
+): ChatInviteLinkWithJoinRequest = editChatInviteLinkWithJoinRequest(chat.id, previousLink, name, expiration)
 
-suspend fun TelegramBot.editChatInviteLinkWithJoinRequest(
+public suspend fun TelegramBot.editChatInviteLinkWithJoinRequest(
     chatId: ChatIdentifier,
     previousLink: String,
     expiration: DateTime,
     name: String? = null,
-) = editChatInviteLinkWithJoinRequest(chatId, previousLink, name , expiration.toTelegramDate())
+): ChatInviteLinkWithJoinRequest = editChatInviteLinkWithJoinRequest(chatId, previousLink, name , expiration.toTelegramDate())
 
-suspend fun TelegramBot.editChatInviteLinkWithJoinRequest(
+public suspend fun TelegramBot.editChatInviteLinkWithJoinRequest(
     chat: PublicChat,
     previousLink: String,
     expiration: DateTime,
     name: String? = null,
-) = editChatInviteLinkWithJoinRequest(chat.id, previousLink, name , expiration.toTelegramDate())
+): ChatInviteLinkWithJoinRequest = editChatInviteLinkWithJoinRequest(chat.id, previousLink, name , expiration.toTelegramDate())
 
-suspend fun TelegramBot.editChatInviteLinkUnlimited(
+public suspend fun TelegramBot.editChatInviteLinkUnlimited(
     chatId: ChatIdentifier,
     previousLink: ChatInviteLink,
     name: String? = null,
     expiration: TelegramDate? = null
-) = editChatInviteLinkUnlimited(chatId, previousLink.inviteLink, name, expiration)
+): ChatInviteLinkUnlimited = editChatInviteLinkUnlimited(chatId, previousLink.inviteLink, name, expiration)
 
-suspend fun TelegramBot.editChatInviteLinkUnlimited(
+public suspend fun TelegramBot.editChatInviteLinkUnlimited(
     chat: PublicChat,
     previousLink: ChatInviteLink,
     name: String? = null,
     expiration: TelegramDate? = null,
-) = editChatInviteLinkUnlimited(chat.id, previousLink, name, expiration)
+): ChatInviteLinkUnlimited = editChatInviteLinkUnlimited(chat.id, previousLink, name, expiration)
 
-suspend fun TelegramBot.editChatInviteLinkUnlimited(
+public suspend fun TelegramBot.editChatInviteLinkUnlimited(
     chatId: ChatIdentifier,
     previousLink: ChatInviteLink,
     expiration: DateTime,
     name: String? = null,
-) = editChatInviteLinkUnlimited(chatId, previousLink, name, expiration.toTelegramDate())
+): ChatInviteLinkUnlimited = editChatInviteLinkUnlimited(chatId, previousLink, name, expiration.toTelegramDate())
 
-suspend fun TelegramBot.editChatInviteLinkUnlimited(
+public suspend fun TelegramBot.editChatInviteLinkUnlimited(
     chat: PublicChat,
     previousLink: ChatInviteLink,
     expiration: DateTime,
     name: String? = null,
-) = editChatInviteLinkUnlimited(chat.id, previousLink, name , expiration.toTelegramDate())
+): ChatInviteLinkUnlimited = editChatInviteLinkUnlimited(chat.id, previousLink, name , expiration.toTelegramDate())
 
-suspend fun TelegramBot.editChatInviteLinkWithLimitedMembers(
+public suspend fun TelegramBot.editChatInviteLinkWithLimitedMembers(
     chatId: ChatIdentifier,
     previousLink: ChatInviteLink,
     membersLimit: MembersLimit,
     name: String? = null,
     expiration: TelegramDate? = null
-) = editChatInviteLinkWithLimitedMembers(chatId, previousLink.inviteLink, membersLimit, name, expiration)
+): ChatInviteLinkWithLimitedMembers = editChatInviteLinkWithLimitedMembers(chatId, previousLink.inviteLink, membersLimit, name, expiration)
 
-suspend fun TelegramBot.editChatInviteLinkWithLimitedMembers(
+public suspend fun TelegramBot.editChatInviteLinkWithLimitedMembers(
     chat: PublicChat,
     previousLink: ChatInviteLink,
     membersLimit: MembersLimit,
     name: String? = null,
     expiration: TelegramDate? = null,
-) = editChatInviteLinkWithLimitedMembers(chat.id, previousLink, membersLimit, name, expiration)
+): ChatInviteLinkWithLimitedMembers = editChatInviteLinkWithLimitedMembers(chat.id, previousLink, membersLimit, name, expiration)
 
-suspend fun TelegramBot.editChatInviteLinkWithLimitedMembers(
+public suspend fun TelegramBot.editChatInviteLinkWithLimitedMembers(
     chatId: ChatIdentifier,
     previousLink: ChatInviteLink,
     membersLimit: MembersLimit,
     expiration: DateTime,
     name: String? = null,
-) = editChatInviteLinkWithLimitedMembers(chatId, previousLink, membersLimit, name , expiration.toTelegramDate())
+): ChatInviteLinkWithLimitedMembers = editChatInviteLinkWithLimitedMembers(chatId, previousLink, membersLimit, name , expiration.toTelegramDate())
 
-suspend fun TelegramBot.editChatInviteLinkWithLimitedMembers(
+public suspend fun TelegramBot.editChatInviteLinkWithLimitedMembers(
     chat: PublicChat,
     previousLink: ChatInviteLink,
     membersLimit: MembersLimit,
     expiration: DateTime,
     name: String? = null,
-) = editChatInviteLinkWithLimitedMembers(chat.id, previousLink, membersLimit, name , expiration.toTelegramDate())
+): ChatInviteLinkWithLimitedMembers = editChatInviteLinkWithLimitedMembers(chat.id, previousLink, membersLimit, name , expiration.toTelegramDate())
 
-suspend fun TelegramBot.editChatInviteLinkWithJoinRequest(
+public suspend fun TelegramBot.editChatInviteLinkWithJoinRequest(
     chatId: ChatIdentifier,
     previousLink: ChatInviteLink,
     name: String? = null,
     expiration: TelegramDate? = null
-) = editChatInviteLinkWithJoinRequest(chatId, previousLink.inviteLink, name, expiration)
+): ChatInviteLinkWithJoinRequest = editChatInviteLinkWithJoinRequest(chatId, previousLink.inviteLink, name, expiration)
 
-suspend fun TelegramBot.editChatInviteLinkWithJoinRequest(
+public suspend fun TelegramBot.editChatInviteLinkWithJoinRequest(
     chat: PublicChat,
     previousLink: ChatInviteLink,
     name: String? = null,
     expiration: TelegramDate? = null,
-) = editChatInviteLinkWithJoinRequest(chat.id, previousLink, name, expiration)
+): ChatInviteLinkWithJoinRequest = editChatInviteLinkWithJoinRequest(chat.id, previousLink, name, expiration)
 
-suspend fun TelegramBot.editChatInviteLinkWithJoinRequest(
+public suspend fun TelegramBot.editChatInviteLinkWithJoinRequest(
     chatId: ChatIdentifier,
     previousLink: ChatInviteLink,
     expiration: DateTime,
     name: String? = null,
-) = editChatInviteLinkWithJoinRequest(chatId, previousLink, name , expiration.toTelegramDate())
+): ChatInviteLinkWithJoinRequest = editChatInviteLinkWithJoinRequest(chatId, previousLink, name , expiration.toTelegramDate())
 
-suspend fun TelegramBot.editChatInviteLinkWithJoinRequest(
+public suspend fun TelegramBot.editChatInviteLinkWithJoinRequest(
     chat: PublicChat,
     previousLink: ChatInviteLink,
     expiration: DateTime,
     name: String? = null,
-) = editChatInviteLinkWithJoinRequest(chat.id, previousLink, name , expiration.toTelegramDate())
+): ChatInviteLinkWithJoinRequest = editChatInviteLinkWithJoinRequest(chat.id, previousLink, name , expiration.toTelegramDate())
+
+
+// Subscriptions
+
+public suspend fun TelegramBot.editChatSubscriptionInviteLink(
+    chatId: ChatIdentifier,
+    previousLink: String,
+    name: String,
+): ChatInviteLinkUnlimited = execute(EditChatInviteLink.subscription(chatId, previousLink, name))
+
+public suspend fun TelegramBot.editChatSubscriptionInviteLink(
+    chatId: ChatIdentifier,
+    previousLink: ChatInviteLink,
+    name: String,
+): ChatInviteLinkUnlimited = editChatSubscriptionInviteLink(chatId, previousLink.inviteLink, name)
+
+public suspend fun TelegramBot.editChatSubscriptionInviteLink(
+    chat: PublicChat,
+    previousLink: String,
+    name: String,
+): ChatInviteLinkUnlimited = editChatSubscriptionInviteLink(chat.id, previousLink, name)
+
+public suspend fun TelegramBot.editChatSubscriptionInviteLink(
+    chat: PublicChat,
+    previousLink: ChatInviteLink,
+    name: String,
+): ChatInviteLinkUnlimited = editChatSubscriptionInviteLink(chat.id, previousLink, name)

tgbotapi.api/src/commonMain/kotlin/dev/inmo/tgbotapi/extensions/api/chat/invite_links/RevokeChatInviteLink.kt

@@ -4,24 +4,25 @@ import dev.inmo.tgbotapi.bot.TelegramBot
 import dev.inmo.tgbotapi.requests.chat.invite_links.RevokeChatInviteLink
 import dev.inmo.tgbotapi.types.ChatIdentifier
 import dev.inmo.tgbotapi.types.ChatInviteLink
+import dev.inmo.tgbotapi.types.SecondaryChatInviteLink
 import dev.inmo.tgbotapi.types.chat.PublicChat
 
-suspend fun TelegramBot.revokeChatInviteLink(
+public suspend fun TelegramBot.revokeChatInviteLink(
     chatId: ChatIdentifier,
     previousLink: String
-) = execute(RevokeChatInviteLink(chatId, previousLink))
+): SecondaryChatInviteLink = execute(RevokeChatInviteLink(chatId, previousLink))
 
-suspend fun TelegramBot.revokeChatInviteLink(
+public suspend fun TelegramBot.revokeChatInviteLink(
     chat: PublicChat,
     previousLink: String
-) = revokeChatInviteLink(chat.id, previousLink)
+): SecondaryChatInviteLink = revokeChatInviteLink(chat.id, previousLink)
 
-suspend fun TelegramBot.revokeChatInviteLink(
+public suspend fun TelegramBot.revokeChatInviteLink(
     chatId: ChatIdentifier,
     previousLink: ChatInviteLink
-) = revokeChatInviteLink(chatId, previousLink.inviteLink)
+): SecondaryChatInviteLink = revokeChatInviteLink(chatId, previousLink.inviteLink)
 
-suspend fun TelegramBot.revokeChatInviteLink(
+public suspend fun TelegramBot.revokeChatInviteLink(
     chat: PublicChat,
     previousLink: ChatInviteLink
-) = revokeChatInviteLink(chat, previousLink.inviteLink)
+): SecondaryChatInviteLink = revokeChatInviteLink(chat, previousLink.inviteLink)

tgbotapi.api/src/commonMain/kotlin/dev/inmo/tgbotapi/extensions/api/chat/members/BanChatMember.kt

@@ -2,34 +2,37 @@ package dev.inmo.tgbotapi.extensions.api.chat.members
 
 import dev.inmo.tgbotapi.bot.TelegramBot
 import dev.inmo.tgbotapi.requests.chat.members.BanChatMember
-import dev.inmo.tgbotapi.types.*
+import dev.inmo.tgbotapi.types.IdChatIdentifier
+import dev.inmo.tgbotapi.types.ChatIdentifier
+import dev.inmo.tgbotapi.types.TelegramDate
+import dev.inmo.tgbotapi.types.UserId
 import dev.inmo.tgbotapi.types.chat.PublicChat
 import dev.inmo.tgbotapi.types.chat.User
 
-suspend fun TelegramBot.banChatMember(
+public suspend fun TelegramBot.banChatMember(
     chatId: ChatIdentifier,
     userId: UserId,
     untilDate: TelegramDate? = null,
     revokeMessages: Boolean? = null
-) = execute(BanChatMember(chatId, userId, untilDate, revokeMessages))
+): Boolean = execute(BanChatMember(chatId, userId, untilDate, revokeMessages))
 
-suspend fun TelegramBot.banChatMember(
+public suspend fun TelegramBot.banChatMember(
     chat: PublicChat,
     userId: UserId,
     untilDate: TelegramDate? = null,
     revokeMessages: Boolean? = null
-) = banChatMember(chat.id, userId, untilDate, revokeMessages)
+): Boolean = banChatMember(chat.id, userId, untilDate, revokeMessages)
 
-suspend fun TelegramBot.banChatMember(
-    chatId: ChatId,
+public suspend fun TelegramBot.banChatMember(
+    chatId: IdChatIdentifier,
     user: User,
     untilDate: TelegramDate? = null,
     revokeMessages: Boolean? = null
-) = banChatMember(chatId, user.id, untilDate, revokeMessages)
+): Boolean = banChatMember(chatId, user.id, untilDate, revokeMessages)
 
-suspend fun TelegramBot.banChatMember(
+public suspend fun TelegramBot.banChatMember(
     chat: PublicChat,
     user: User,
     untilDate: TelegramDate? = null,
     revokeMessages: Boolean? = null
-) = banChatMember(chat.id, user.id, untilDate, revokeMessages)
+): Boolean = banChatMember(chat.id, user.id, untilDate, revokeMessages)

tgbotapi.api/src/commonMain/kotlin/dev/inmo/tgbotapi/extensions/api/chat/members/BanChatSenderChat.kt

@@ -2,25 +2,26 @@ package dev.inmo.tgbotapi.extensions.api.chat.members
 
 import dev.inmo.tgbotapi.bot.TelegramBot
 import dev.inmo.tgbotapi.requests.chat.members.BanChatSenderChat
-import dev.inmo.tgbotapi.types.*
+import dev.inmo.tgbotapi.types.IdChatIdentifier
+import dev.inmo.tgbotapi.types.ChatIdentifier
 import dev.inmo.tgbotapi.types.chat.PublicChat
 
-suspend fun TelegramBot.banChatSenderChat(
+public suspend fun TelegramBot.banChatSenderChat(
     chatId: ChatIdentifier,
-    senderChatId: ChatId
-) = execute(BanChatSenderChat(chatId, senderChatId))
+    senderChatId: IdChatIdentifier
+): Boolean = execute(BanChatSenderChat(chatId, senderChatId))
 
-suspend fun TelegramBot.banChatSenderChat(
+public suspend fun TelegramBot.banChatSenderChat(
     chat: PublicChat,
-    senderChatId: ChatId
-) = banChatSenderChat(chat.id, senderChatId)
+    senderChatId: IdChatIdentifier
+): Boolean = banChatSenderChat(chat.id, senderChatId)
 
-suspend fun TelegramBot.banChatSenderChat(
-    chatId: ChatId,
+public suspend fun TelegramBot.banChatSenderChat(
+    chatId: IdChatIdentifier,
     senderChat: PublicChat
-) = banChatSenderChat(chatId, senderChat.id)
+): Boolean = banChatSenderChat(chatId, senderChat.id)
 
-suspend fun TelegramBot.banChatSenderChat(
+public suspend fun TelegramBot.banChatSenderChat(
     chat: PublicChat,
     senderChat: PublicChat,
-) = banChatSenderChat(chat.id, senderChat)
+): Boolean = banChatSenderChat(chat.id, senderChat)