fill changelog

com.github.ben-manes.versions: 0.52.0 -> 0.53.0

.github/FUNDING.yml

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

.github/workflows/packages_publishing.yml

@@ -17,18 +17,20 @@ jobs:
           rm gradle.properties
           mv gradle.properties.tmp gradle.properties
       - name: KotlinSymbolProcessing execution
-        run: ./gradlew ksp
+        run: ./gradlew kspCommonMainKotlinMetadata
       - name: Build
         run: ./gradlew build
-      - name: Publish to Gitea
+      - name: API compatibility check
+        run: ./gradlew apiCheck
+      - name: Publish to GithubPackages
+        continue-on-error: true
+        run: ./gradlew publishAllPublicationsToGithubPackagesRepository --no-parallel
+        env:
+          GITHUB_USER: ${{ github.actor }}
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+      - name: Publish to InmoNexus
         continue-on-error: true
         run: ./gradlew publishAllPublicationsToInmoNexusRepository
         env:
           INMONEXUS_USER: ${{ secrets.INMONEXUS_USER }}
           INMONEXUS_PASSWORD: ${{ secrets.INMONEXUS_PASSWORD }}
-      - name: Publish to GithubPackages
-        continue-on-error: true
-        run: ./gradlew publishAllPublicationsToGithubPackagesRepository --no-parallel
-        env:
-          GITHUBPACKAGES_USER: ${{ github.actor }}
-          GITHUBPACKAGES_PASSWORD: ${{ secrets.GITHUB_TOKEN }}

.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*

CHANGELOG.md

@@ -1,5 +1,558 @@
 # TelegramBotAPI changelog
 
+## 30.0.0
+
+**THIS UPDATE MAY CONTAINS BREAKING CHANGES**
+
+* `Version`:
+    * `Kotlin`: `2.2.10` -> `2.2.20`
+    * `Ktor`: `3.2.3` -> `3.3.1`
+    * `MicroUtils`: `0.26.3` -> `0.26.6`
+    * `KSLog`: `1.5.0` -> `1.5.1`
+* `BehaviourBuilder`:
+    * `DefaultCustomBehaviourContextAndTypeReceiver` now extends `suspend (BC, U) -> R` instead of `CustomBehaviourContextAndTypeReceiver<BC, R, U>` (no changes in api in fact)
+
+## 29.0.1
+
+* `Core`:
+  * Fix of [#917](https://github.com/InsanusMokrassar/ktgbotapi/issues/917): all `OrderInfo` fields now have defaults nulls
+
+## 29.0.0
+
+**THIS UPDATE CONTAINS ADDING SUPPORT OF [Telegram Bots API 9.2](https://core.telegram.org/bots/api-changelog#august-15-2025)**
+
+**THIS UPDATE CONTAINS BREAKING CHANGES**
+
+* `Core`:
+  * Add function `firstOfOrNull(vararg suspend () -> T): T?`
+  * Change logic of `firstOf` - now it works based on merged flows and __do not require__ `CoroutineScope` as receiver
+
+## 28.0.3
+
+* `Core`:
+  * Add passing of default engines in `HttpClient` constructors
+
+## 28.0.2
+
+* `Core`:
+  * [#1001](https://github.com/InsanusMokrassar/ktgbotapi/issues/1001) - `[Bug] Invalid detection of isCausedByCancellation()`
+  * [#1002](https://github.com/InsanusMokrassar/ktgbotapi/issues/1002) - `Unable to handle UnauthorizedException with buildBehaviourWithLongPolling`
+
+## 28.0.1
+
+* `Version`:
+    * `Kotlin`: `2.2.0` -> `2.2.10`
+    * `MicroUtils`: `0.26.2` -> `0.26.3`
+    * `Ktor`: `3.2.2` -> `3.2.3`
+* `Core`:
+    * Let all `OptionallyMessageThreadRequest` inheritors to use `@EncodeDefault` annotation to fix default value passing
+
+## 28.0.0
+
+**THIS UPDATE CONTAINS BREAKING CHANGES**
+
+* `Core`:
+  * Add `firstOf` extension
+* `BehaviourBuilder`:
+  * All builders for behaviours got boolean `useDefaultSubcontextInitialAction`
+  * Add opportunity to pass `BehaviourContextData` in `DefaultBehaviourContext` constructor and `copy` method
+  * By default, commands to other bots will be ignored in triggers and waiters
+
+## 27.1.2
+
+* `Core`:
+  * Try to fix cancelling on timeout for long polling
+  * Since this update phrase `Something web wrong` will not happen from this library 😭
+
+## 27.1.1
+
+* `Version`:
+  * `MicroUtils`: `0.26.1` -> `0.26.2`
+* `Core`:
+  * Make `BusinessLocation#location` optional (fix of [#990](https://github.com/InsanusMokrassar/ktgbotapi/issues/990))
+
+## 27.1.0
+
+* `Core`:
+  * Improve support of local bot api servers files. Next call factories will try to resolve file locally before real call:
+    * [DownloadFileRequestCallFactory.kt](tgbotapi.core/src/commonMain/kotlin/dev/inmo/tgbotapi/bot/ktor/base/DownloadFileRequestCallFactory.kt) (for [DownloadFile.kt](tgbotapi.core/src/commonMain/kotlin/dev/inmo/tgbotapi/requests/DownloadFile.kt) as well)
+    * [DownloadFileChannelRequestCallFactory.kt](tgbotapi.core/src/commonMain/kotlin/dev/inmo/tgbotapi/bot/ktor/base/DownloadFileChannelRequestCallFactory.kt) (for [DownloadFileStream.kt](tgbotapi.core/src/commonMain/kotlin/dev/inmo/tgbotapi/requests/DownloadFileStream.kt) as well)
+
+## 27.0.0
+
+**THIS UPDATE MAY CONTAIN BREAKING CHANGES. IN CASE OF ANY MIGRATION PROBLEMS FEEL FREE TO ASK IN [OUR CHAT](https://t.me/ktgbotapi_chat)**
+
+* `Version`:
+  * `Kotlin`: `2.1.20` -> `2.2.0`
+  * `Serialization`: `1.8.1` -> `1.9.0`
+  * `Ktor`: `3.1.3` -> `3.2.2`
+  * `MicroUtils`: `0.25.7` -> `0.26.1`
+  * `KSLog`: `1.4.1` -> `1.5.0`
+* `Common`:
+  * In most `data` classes with non-public constructors has been added `ConsistentCopyVisibility` annotation, preventing
+  public nature in difference with constructor
+  * Absence of several API methods for requests has been fixed
+
+## 26.1.0
+
+**THIS UPDATE CONTAINS ADDING SUPPORT OF [Telegram Bots API 9.1](https://core.telegram.org/bots/api-changelog#july-3-2025)**
+
+**THIS UPDATE _MAY_ CONTAINS BREAKING CHANGES**
+
+## 26.0.0
+
+**THIS UPDATE CONTAINS BREAKING CHANGES IN BEHAVIOUR BUILDER AND CORE. BE CAREFUL ON UPDATE**
+
+* `Version`:
+  * `Serialization`: `1.8.0` -> `1.8.1`
+  * `Coroutines`: `1.10.1` -> `1.10.2`
+  * `Ktor`: `3.1.1` -> `3.1.3`
+  * `MicroUtils`: `0.25.3` -> `0.25.7`
+* `Core`:
+  * **POTENTIALLY BREAKING CHANGE** Long polling has been reworked a bit
+  * **BREAKING CHANGE** `RequestsExecutor` got property `RequestsExecutor.Log: KSLog`
+* `BehaviourContext`:
+  * **BREAKING CHANGE** All triggers and waiters become non-suspend functions
+  * **BREAKING CHANGE** Behaviour of counted extensions (commands, data callback queries, etc.) has been changed a bit: now each one will
+  create subcontext and work in it
+  * New extension `BehaviourContext.launchInNewSubContext` which will launch some job in subcontext of receiver
+
+## 25.0.1
+
+**THIS UPDATE CONTAINS ADDING SUPPORT OF [Telegram Bots API 9.0](https://core.telegram.org/bots/api-changelog#april-11-2025)**
+
+* `Core`:
+  * Previously named `Gift` now presented by `Gift.Regular`
+  * Fixes in `MultipartRequestCallFactory` for correct handling of all `MultipartRequest.Common` inheritors
+  * `Username` now can be safely created with `Username.prepare`
+  * Add extensions `String.splitFor(Text|Caption|StoryCaption)` for preparing several texts for several
+    messages/captions/story captions
+
+## 24.0.2
+
+* `Version`:
+  * `Kotlin`: `2.1.10` -> `2.1.20`
+  * `Ktor`: `3.1.0` -> `3.1.1`
+  * `MicroUtils`: `0.24.7` -> `0.25.3`
+* `DefaultKTgBotAPIKSLog` will drop `CancellationException`s by default
+* You may configure `DefaultKTgBotAPIKSLog` in simple way with `SetDefaultKTgBotAPIKSLog`
+* `BehaviourBuilder`:
+  * `FSM`:
+    * Fix chains cancelling on their ends
+
+## 24.0.1
+
+* `Core`:
+  * Now you may upload photos with `EditChatMessageMedia`
+
+## 24.0.0
+
+**THIS UPDATE CONTAINS BREAKING CHANGES IN `subcontextUpdatesFilter` WORK. TAKE CARE IN MIGRATION**
+
+* `Version`:
+  * `MicroUtils`: `0.24.6` -> `0.24.7`
+* `Core`:
+  * `ForumContentMessage` got property `threadCreatingInfo` which represents information about topic where message has been sent
+* `BehaviourBuilder`:
+  * Fix of overall `subcontextUpdatesFilter` behaviour. In fact, this update will fix its affection on scenaries
+
+## 23.2.1
+
+* `Core`:
+  * Fix of `year` field in `Birthdate`
+
+## 23.2.0
+
+**THIS UPDATE CONTAINS ADDING SUPPORT OF [Telegram Bots API 8.3](https://core.telegram.org/bots/api-changelog#february-12-2025)**
+
+* `Version`:
+  * `MicroUtils`: `0.24.5` -> `0.24.6`
+  * `Ktor`: `3.0.3` -> `3.1.0`
+
+## 23.1.2
+
+* `Version`:
+  * `Kotlin`: `2.1.0` -> `2.1.10`
+  * `Serialization`: `1.7.3` -> `1.8.0`
+  * `MicroUtils`: `0.24.4` -> `0.24.5`
+  * `KSLog`: `1.4.0` -> `1.4.1`
+
+## 23.1.1
+
+* `Version`:
+  * `MicroUtils`: `0.24.0` -> `0.24.4`
+* `Core`:
+  * Replace `removeFirst` with `removeAt(0)` in `createTextSources`
+
+## 23.1.0
+
+**THIS UPDATE CONTAINS ADDING SUPPORT OF [Telegram Bots API 8.2](https://core.telegram.org/bots/api-changelog#january-1-2025)**
+
+## 23.0.0
+
+* `Version`:
+  * `Coroutines`: `1.9.0` -> `1.10.1`
+  * `MicroUtils`: `0.23.2` -> `0.24.0`
+  * `KSLog`: `1.3.6` -> `1.4.0`
+  * `Ktor`: `3.0.2` -> `3.0.3`
+* `Core`:
+  * All old factory methods for `TextSource`s took suffix `TextSource`. For example: `regular` -> `regularTextSource`.
+  That has been for excluding names resolution ambiguity with extensions for `EntitiesBuilder`
+
+## 22.0.0
+
+**THIS UPDATE CONTAINS BREAKING CHANGES**
+
+**IN THIS UPDATE HAS BEEN REWORKED EVENTS API IN WEBAPPS**
+
+**THIS UPDATE ADDING SUPPORT OF [BOT API 8.0](https://core.telegram.org/bots/api-changelog#november-17-2024) AND [BOT API 8.1](https://core.telegram.org/bots/api-changelog#december-4-2024)**
+
+* `Version`:
+  * `MicroUtils`: `0.23.1` -> `0.23.2`
+  * `Ktor`: `3.0.1` -> `3.0.2`
+
+## 21.0.1
+
+* `Core`:
+  * Improvements in `Update.sourceUser` extension
+  * Add extension `PrivateChat.toUser`
+  * Builder methods of `TextSource`s (like `pre` which returns `PreTextSource`) lost suppression of `redundant inline`
+due to its redundancy
+  * Add `mention` builders for `EntitiesBuilder` with `UserId` as variant instead of `User`
+* `BehaviourBuilder`:
+  * Add support of several rounds for `CombinedSubcontextInitialAction`. Now it will try hard to execute all its
+`SubAction` while all actions will not be completed successfully OR all left actions will not complete with errors
+
+## 21.0.0
+
+* `Version`:
+  * `Kotlin`: `2.0.21` -> `2.1.0`
+  * `MicroUtils`: `0.23.0` -> `0.23.1`
+* `BehaviourBuilder`:
+  * Add special `val data: BehaviourContextData` into all realizations of `BehaviourContext`
+  * Add `CombinedSubcontextInitialAction` and functions
+    `buildSubcontextInitialAction`/`buildSubcontextInitialActionWithSubActions`
+  * Add `subcontextInitialAction` for all the functions-builders of `BehaviourContext` and
+    `additionalSubcontextInitialAction` to all triggers
+
+## 20.0.1
+
+* `Core`:
+  * Fix of logger propagation (fix of [#860](https://github.com/InsanusMokrassar/ktgbotapi/issues/860))
+  * Add opportunity to modify keyboards (fix of [#761](https://github.com/InsanusMokrassar/ktgbotapi/issues/761))
+  * Fields of `OrderInfo` became nullable (fix of [#917](https://github.com/InsanusMokrassar/ktgbotapi/issues/917))
+  * Add default `toString` to `ChatType` (fix of [#919](https://github.com/InsanusMokrassar/ktgbotapi/issues/919))
+  * Fix of method in `CreateInvoiceLink` (merging of [#920](https://github.com/InsanusMokrassar/ktgbotapi/issues/920), made by [byteduck-exploit](https://github.com/byteduck-exploit))
+
+## 20.0.0
+
+**THIS UPDATE CONTAINS SUPPORT OF [BOTS API 7.11](https://core.telegram.org/bots/api-changelog#october-31-2024)**
+
+* `All`:
+  * **ALL SEND METHODS GOT PARAMETER `allowPaidBroadcast` WHICH POTENTIALLY MAY SPEND MONEYS FROM BOT BALANCE**
+
+## 19.0.0
+
+**THIS UPDATE CONTAINS BREAKING CHANGES**
+
+**THIS UPDATE CONTAINS UPGRADE UP TO KTOR 3.0 (thanks to [@d1snin](https://github.com/d1snin))**
+
+* `Version`:
+  * `Ktor`: `2.3.12` -> `3.0.1`
+  * `MicroUtils`: `0.22.7` -> `0.23.0`
+
+## 18.2.3
+
+* `Core`:
+  * Add default middleware `ExceptionsThrottlerTelegramBotMiddleware`
+  * Make `TelegramBotMiddlewaresPipelinesHandler` to be default `TelegramBotPipelinesHandler`
+  * Make `DefaultKtorRequestsExecutor` now uses `runCatching` instead of `runCatchingSafely`
+  * `onRequestResultPresented` lambda now accepts non-nullable `result`
+
+## 18.2.2
+
+* `Version`:
+  * `Kotlin`: `2.0.20` -> `2.0.21`
+  * `MicroUtils`: `0.22.4` -> `0.22.7`
+* `Core`:
+  * Fixes in blockquotes serializations
+  * Now `RawMessageEntity` is public. It is still under `Warning` annotation and is subject of changes
+* `BehaviourBuilder`:
+  * Add `CommonMessageFilterExcludeCommand` to filter commands in messages
+  * Add `minus` operation for `SimpleFilter`s
+
+## 18.2.1
+
+* `Version`:
+  * `Serialization`: `1.7.2` -> `1.7.3`
+  * `Coroutines`: `1.8.1` -> `1.9.0`
+  * `MicroUtils`: `0.22.2` -> `0.22.4`
+
+## 18.2.0
+
+**THIS UPDATE CONTAINS SUPPORT OF [BOTS API 7.10](https://core.telegram.org/bots/api-changelog#september-6-2024)**
+
+* `Core`:
+  * Customize `GiveawayCreated` to use stars in some cases
+  * `GiveawayInfo` lost parameter `premiumMonths` because of it is no included by default
+  * `GiveawayPublicResults` lost parameter `publicWinners` because of its abcence in Telegram Bot API
+  * Fix `GiveawayPublicResults` to be correctly deserializable
+  * Fix `GiveawayPrivateResults` to be correctly deserializable
+  * Fixes in deserialization of updates with giveaways
+* `BehaviourBuilder`:
+  * Extension `buildBehaviourWithLongPolling` will not report absence of `/privacy` handling
+* `WebApp`:
+  * `MainButton` has been deprecated in favor to `BottomButton`. Their functionality is equal
+
+## 18.1.0
+
+* `BehaviourBuilder`:
+  * Add `createSubContextAndDoSynchronouslyWithUpdatesFilter` as old logic of `createSubContextAndDoWithUpdatesFilter`
+  * `createSubContextAndDoWithUpdatesFilter` has been renamed to `createSubContextAndDoAsynchronouslyWithUpdatesFilter`
+
+## 18.0.0
+
+**THIS UPDATE CONTAINS BREAKING CHANGES**
+
+This update contains solution for [issue #888](https://github.com/InsanusMokrassar/ktgbotapi/issues/888), made by
+[@Nik-mmzd](https://github.com/Nik-mmzd)
+
+---
+
+**Migration (step-by-step)**
+
+Replace in a whole project:
+
+1. `RestrictedChatMember` -> `RestrictedMemberChatMember`
+2. `BannedChatMember` -> `RestrictedChatMember`
+
+---
+
+**Changes:**
+
+* `Version`:
+  * `Kotlin`: `2.0.10` -> `2.0.20`
+  * `Serialization`: `1.7.1` -> `1.7.2`
+  * `MicroUtils`: `0.22.0` -> `0.22.2`
+  * `KSLog`: `1.3.5` -> `1.3.6`
+  * `Ktor`: `2.3.11` -> `2.3.12`
+* `Core`:
+  * `RestrictedChatMember` has been renamed to `RestrictedMemberChatMember`
+  * `BannedChatMember` has been renamed to `RestrictedChatMember`
+  * `KickedChatMember` now implements `RestrictedChatMember` (due to rename)
+  * All `ChatMember`s now use `PreviewUser`s instead of `User`s
+* `Utils`:
+  * Add a lot of extensions like `ChatMember.isMember`
+  * Add a lot of extensions like `ChatMemberUpdated.joinedChat`
+
+## 17.0.0
+
+**THIS UPDATE CONTAINS SUPPORT OF BOTS API 7.9**
+
+* Add support of subscriptions links handling
+* Add support of info about sender chat. **It is important, that for channels will be actual `senderChat` instead of
+`from` field due to `User` type of the last one**. You also may use extensions `Message.sender_chat` or `Any.withSenderChatMessageOrNull`
+to access sender chat
+* Add `Reaction.Paid`
+
+Additional changes:
+
+* `Core`:
+    * Add top level interfaces `OptionallyWithUser` and `OptionallyFromUser`. Old `WithUser` and `FromUser` interfaces
+    extending them with following overrides of `user` and `from` fields
+* `API`:
+    * Change order of delay and sending action in [SendActionDSL](tgbotapi.api/src/commonMain/kotlin/dev/inmo/tgbotapi/extensions/api/send/SendActionDSL.kt)
+    (thanks to [DRSchlaubi](https://github.com/DRSchlaubi), [PR #833](https://github.com/InsanusMokrassar/ktgbotapi/pull/883)).
+    Besides, there has been changed way to create parallel sending of action and it must not lead to memory leaks anymore
+
+## 16.0.0
+
+**THIS UPDATE CONTAINS KOTLIN UPDATE UP TO 2.0**
+
+* `Version`:
+  * `Kotlin`: `1.9.23` -> `2.0.10`
+  * `Serialization`: `1.6.3` -> `1.7.1`
+  * `MicroUtils`: `0.21.2` -> `0.22.0`
+  * `KSLog`: `1.3.4` -> `1.3.5`
+
+## 15.3.0
+
+**THIS UPDATE CONTAINS ADDING OF SUPPORT FOR BOTS API 7.8**
+
+* `Core`:
+  * `OptionallyBusinessConnectionRequest` now extends `WithOptionalBusinessConnectionId`
+  * Add `hasMainWebApp` in `ExtendedBot`
+* `API`:
+  * Add `BusinessConnectionId` to pin/unpin methods
+* `WebApp`:
+  * Add `shareToStory` in `WebApp`
+
+## 15.2.0
+
+* `API`:
+  * Enabled an `explicit mode` for `API` module ([PR #876](https://github.com/InsanusMokrassar/ktgbotapi/pull/876))
+* `WebApps`:
+  * Built-in `onClick` and `offClick` of `MainButton` become public ([PR #875](https://github.com/InsanusMokrassar/ktgbotapi/pull/875))
+  * Old `MainButton.onClick` extension **has been removed** to avoid collisions of types
+
+## 15.1.0
+
+**THIS UPDATE CONTAINS BREAKING CHANGES**
+
+**THIS UPDATE CONTAINS ADDING OF SUPPORT FOR BOTS API 7.7** (thanks to [bpavuk](https://threads.net/b_pavuchok))
+
+**THIS UPDATE CONTAINS ADDING OF SUPPORT FOR BOTS API 7.6** (with participation and help of [bpavuk](https://threads.net/b_pavuchok))
+
+* Add support of paid media
+* Update web apps
+* `Version`:
+  * `MicroUtils`: `0.21.1` -> `0.21.2`
+* `Core`:
+  * `TelegramMedia` has been separated onto two interfaces: `TelegramFreeMedia` and `TelegramPaidMedia`
+    * `TelegramFreeMedia` has replaced `TelegramMedia` on all old places where it have been used
+  * `Photo` has been renamed to `PhotoFile`
+* `BehaviourBuilder`:
+  * Add notification when handling of `/privacy` command is absence
+  * Add several extensions to simplify setting up `/privacy` reaction
+
+## 15.0.0
+
+**THIS UPDATE CONTAINS BREAKING CHANGES**
+
+**THIS UPDATE CONTAINS ADDING OF SUPPORT FOR BOTS API 7.5**
+
+* `Version`:
+    * `MicroUtils`: `0.21.0` -> `0.21.1`
+* A lot of `edit` methods and classes has been changed to support business connection id
+
+## 14.1.0
+
+* `Version`:
+    * `Coroutines`: `1.8.0` -> `1.8.1`
+    * `Ktor`: `2.3.10` -> `2.3.11`
+    * `MicroUtils`: `0.20.45` -> `0.21.0`
+    * `KSLog`: `1.3.3` -> `1.3.4`
+* `BehaviourBuilder`:
+    * `BehaviourContext` updates listening job will be weakly subscribed. It means that `BehaviourContext` scope will
+    not be prevented from cancelling by this job anymore
+    * `BehaviourContext.doInContext` will not stop automatically current `BehaviourContext` job anymore
+    * `BehaviourContext.createSubContextAndDoWithUpdatesFilter` will use `supervisorScope` instead of
+    `LinkedSupervisorScope`. That will prevent scope leaking in runtime
+
+## 14.0.1
+
+* In `core` and `api` modules related to invoices changed their APIs to suite current API
+
+## 14.0.0
+
+**Add support of [Telegram Bots API 7.4](https://core.telegram.org/bots/api-changelog#may-28-2024)**
+
+**THIS UPDATE CONTAINS BREAKING CHANGES**
+
+* `Core`:
+    * `TelegramPaymentChargeId` has been added as value class and replaced raw strings in `SuccessfulPayment` type of `telegramPaymentChargeId`
+* All the methods/classes related to sending of messages got `effectId` parameter
+* All the methods/classes related to sending of photos/animations/videos got `showCaptionAboveMedia` parameter
+
+## 13.0.0
+
+**Add support of [Telegram Bots API 7.3](https://core.telegram.org/bots/api-changelog#may-6-2024)**
+
+**THIS UPDATE CONTAINS BREAKING CHANGES**
+
+* `Core`:
+  * For polls, `textSources` now means `question` text sources. For `QuizPoll` there are `explanation` and `explanationTextSources`
+  for hinting
+* `API`:
+  * A lot of API related to `Poll`s has been changed to include opportunity to pass `ParseMode` and `TextSource`s list
+
+## 12.0.1
+
+* `Version`:
+  * `Ktor`: `2.3.9` -> `2.3.10`
+  * `MicroUtils`: `0.20.39` -> `0.20.45`
+  * `UUID`: `0.8.2` -> `0.8.4`
+
+## 12.0.0
+
+**Add support of [Telegram Bots API 7.2](https://core.telegram.org/bots/api-changelog#march-31-2024)**
+
+**THIS UPDATE CONTAINS A LOT OF BREAKING CHANGES**
+
+## 11.0.0
+
+**THIS UPDATE CONTAINS REMOVES OF DEPRECATED THINGS**
+
+**THIS UPDATE CONTAINS A LOT OF BREAKING CHANGES**
+
+* `Core`:
+  * `MessageId` now is `value class`. `MessageIdentifier` become deprecated
+  * `MessageThreadId` now is `value class`
+  * `InlineQueryIdentifier` now is `value class`
+  * `MediaGroupIdentifier` has been renamed to `MediaGroupId` and now is `value class`
+  * `CallbackQueryIdentifier` has been renamed to `CallbackQueryId` and now is `value class`
+  * `WebAppQueryId` now is `value class`
+  * `PreCheckoutQueryId` now is `value class`
+  * `FileUniqueId` has been renamed to `TgFileUniqueId` and now is `value class`
+  * `UpdateIdentifier` has been renamed to `UpdateId` and now is `value class`
+  * `InlineMessageIdentifier` has been renamed to `InlineMessageId` and now is `value class`
+  * `ShippingQueryIdentifier` has been renamed to `ShippingQueryId` and now is `value class`
+  * `Identifier` has been renamed to `RawChatId` and now is `value class`
+  * `ShippingOptionIdentifier` has been renamed to `ShippingOptionId` and now is `value class`
+  * `PollIdentifier` has been renamed to `PollId` and now is `value class`
+  * `StickerSetName` now is `value class`
+
+## 10.1.2
+
+* `Version`:
+  * `Kotlin`: `1.9.22` -> `1.9.23`
+  * `Korlibs`: `5.3.2` -> `5.4.0`
+  * `Ktor`: `2.3.8` -> `2.3.9`
+  * `MicroUtils`: `0.20.37` -> `0.20.39`
+  * `KSLog`: `1.3.2` -> `1.3.3`
+
+## 10.1.1
+
+* `Version`:
+  * `Serialization`: `1.6.2` -> `1.6.3`
+  * `MicroUtils`: `0.20.34` -> `0.20.37`
+  * `Korlibs`: `5.3.1` -> `5.3.2`
+
+## 10.1.0
+
+**Add support of [Telegram Bots API 7.1](https://core.telegram.org/bots/api-changelog#february-16-2024)**
+
+* `Version`:
+  * `Coroutines`: `1.7.3` -> `1.8.0`
+  * `MicroUtils`: `0.20.32` -> `0.20.34`
+
+## 10.0.1
+
+* `Version`:
+  * `Ktor`: `2.3.7` -> `2.3.8`
+  * `MicroUtils`: `0.20.26` -> `0.20.32`
+  * `Korlibs`: `5.3.0` -> `5.3.1`
+  * `KSLog`: `1.3.1` -> `1.3.2`
+
+## 10.0.0
+
+**Add support of [Telegram Bots API 7.0](https://core.telegram.org/bots/api-changelog#december-29-2023)**
+
+**IN THIS UPDATE KLOCK DEPENDENCY CHANGED TO `com.soywiz.korge:korlibs-time` UP TO 5.3.0 VERSION**
+
+**IN THIS UPDATE KRYPTO DEPENDENCY CHANGED TO `com.soywiz.korge:korlibs-crypto` UP TO 5.3.0 VERSION**
+
+* `Version`:
+  * `MicroUtils`: `0.20.23` -> `0.20.26`
+  * `Korlibs`: `4.0.10` -> `5.3.0`
+* `Core`:
+  * `Message` now inherited by two variants: `AccessibleMessage` and `InaccessibleMessage`
+* `Common`:
+  * In most places `disableWebPagePreview` has been replaced by new `LinkPreviewOptions`
+  * In most places arguments `replyToMessageId` and `allowSendingWithoutReply` has been replaced with
+    `ReplyParameters`
+    * In `reply` extension two parameters have been added: `replyInChatId` and `replyInThreadId`
+
 ## 9.4.3
 
 **IetfLanguageCode has been renamed to IetfLang in MicroUtils**

README.md

@@ -1,4 +1,4 @@
-# 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.9-blue)](https://core.telegram.org/bots/api-changelog#september-22-2023)
+# 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=Mk&message=Docs&color=blue&logo=mkdocs)](https://docs.inmo.dev/tgbotapi/index.html)                                    |
 |:----------------------:|:-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------:|
@@ -118,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 [bookstack](https://bookstack.inmo.dev/books/telegrambotapi) 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 {
@@ -17,15 +17,31 @@ 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 ->
@@ -47,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 {
@@ -55,7 +55,7 @@ Object callback = {
 
             sourceLink {
                 localDirectory.set(file("../"))
-                remoteUrl.set(new URL("https://github.com/InsanusMokrassar/ktgbotapi/tree/master"))
+                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=9.4.3
+library_version=30.0.0

gradle/libs.versions.toml

@@ -1,25 +1,28 @@
 [versions]
 
-kotlin = "1.9.22"
-kotlin-serialization = "1.6.2"
-kotlin-coroutines = "1.7.3"
+kotlin = "2.2.20"
+kotlin-serialization = "1.9.0"
+kotlin-coroutines = "1.10.2"
 
 javax-activation = "1.1.1"
 
-korlibs = "4.0.10"
-uuid = "0.8.2"
-ktor = "2.3.7"
+korlibs = "5.4.0"
+uuid = "0.8.4"
+ktor = "3.3.1"
 
-ksp = "1.9.21-1.0.16"
-kotlin-poet = "1.15.3"
+ksp = "2.2.20-2.0.4"
+kotlin-poet = "2.2.0"
 
-microutils = "0.20.23"
-kslog = "1.3.1"
+microutils = "0.26.6"
+kslog = "1.5.1"
 
-versions = "0.50.0"
+versions = "0.53.0"
 
-github-release-plugin = "2.4.1"
-dokka = "1.9.10"
+github-release-plugin = "2.5.2"
+dokka = "2.0.0"
+
+validator = "0.18.1"
+nmcp = "1.2.0"
 
 [libraries]
 
@@ -34,6 +37,8 @@ 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" }
@@ -41,11 +46,12 @@ ktor-server-host-common = { module = "io.ktor:ktor-server-host-common", version.
 
 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" }
@@ -54,6 +60,11 @@ microutils-serialization-mapper = { module = "dev.inmo:micro_utils.serialization
 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" }
 
@@ -77,3 +88,5 @@ kotlin-multiplatform = { id = "org.jetbrains.kotlin.multiplatform", version.ref
 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,6 +2,9 @@ project.version = "$library_version"
 project.group = "$library_group"
 
 kotlin {
+    compilerOptions {
+        freeCompilerArgs.add("-Xcontext-parameters")
+    }
     jvm {
         compilations.main {
             kotlinOptions {
@@ -38,7 +41,6 @@ kotlin {
         jsTest {
             dependencies {
                 implementation libs.kotlin.test.js
-                implementation libs.kotlin.test.junit
             }
         }
         all {

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-8.5-bin.zip
+distributionUrl=https\://services.gradle.org/distributions/gradle-8.13-bin.zip

publish.gradle

@@ -1,118 +0,0 @@
-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('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('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://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)
-        }
-    }
-
-    // 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)
-        }
-    }
-}

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":"InmoNexus","url":"https://nexus.inmo.dev/repository/maven-releases/"},{"name":"sonatype","url":"https://oss.sonatype.org/service/local/staging/deploy/maven2/"}],"gpgSigning":{"type":"dev.inmo.kmppscriptbuilder.core.models.GpgSigning.Optional"}}}

tgbotapi.api/build.gradle

@@ -2,20 +2,30 @@ 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

@@ -6,24 +6,23 @@ import dev.inmo.tgbotapi.types.ChatIdentifier
 import dev.inmo.tgbotapi.types.MessageId
 import dev.inmo.tgbotapi.types.chat.Chat
 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.MediaGroupCollectionContent
-import dev.inmo.tgbotapi.types.message.content.MediaGroupContent
 
-suspend fun TelegramBot.deleteMessage(
+public suspend fun TelegramBot.deleteMessage(
     chatId: ChatIdentifier,
     messageId: MessageId
-) = execute(
+): Boolean = execute(
     DeleteMessage(chatId, messageId)
 )
 
-suspend fun TelegramBot.deleteMessage(
+public suspend fun TelegramBot.deleteMessage(
     chat: Chat,
     messageId: MessageId
-) = deleteMessage(chat.id, messageId)
+): Boolean = deleteMessage(chat.id, messageId)
 
-suspend fun TelegramBot.deleteMessage(
-    message: Message
+public suspend fun TelegramBot.deleteMessage(
+    message: AccessibleMessage
 ): Boolean {
     val mediaGroupContent = ((message as? ContentMessage<*>) ?.content as? MediaGroupCollectionContent<*>)
     if (mediaGroupContent == null) {
@@ -35,20 +34,20 @@ suspend fun TelegramBot.deleteMessage(
     }
 }
 
-suspend fun TelegramBot.delete(
+public suspend fun TelegramBot.delete(
     chatId: ChatIdentifier,
     messageId: MessageId
-) = deleteMessage(chatId, messageId)
+): Boolean = deleteMessage(chatId, messageId)
 
-suspend fun TelegramBot.delete(
+public suspend fun TelegramBot.delete(
     chat: Chat,
     messageId: MessageId
-) = deleteMessage(chat, 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,62 +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.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: MessageId,
     threadId: MessageThreadId? = toChatId.threadId,
+    directMessageThreadId: DirectMessageThreadId? = toChatId.directMessageThreadId,
+    startTimestamp: Seconds? = null,
     disableNotification: Boolean = false,
     protectContent: Boolean = false
-) = execute(
-    ForwardMessage(fromChatId, toChatId, messageId, threadId, 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: MessageId,
     threadId: MessageThreadId? = toChatId.threadId,
+    directMessageThreadId: DirectMessageThreadId? = toChatId.directMessageThreadId,
+    startTimestamp: Seconds? = null,
     disableNotification: Boolean = false,
     protectContent: Boolean = false
-) = forwardMessage(fromChat.id, toChatId, messageId, threadId, 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: 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, threadId, 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: 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, threadId, 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, threadId, 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, threadId, 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

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

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

@@ -1,6 +1,6 @@
 package dev.inmo.tgbotapi.extensions.api.InternalUtils
 
-import dev.inmo.tgbotapi.types.MediaGroupIdentifier
+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.*
@@ -12,11 +12,12 @@ import dev.inmo.tgbotapi.utils.extensions.asMediaGroupMessage
  */
 internal fun List<Update>.convertWithMediaGroupUpdates(): List<Update> {
     val resultUpdates = mutableListOf<Update>()
-    val mediaGroups = mutableMapOf<MediaGroupIdentifier, MutableList<Pair<BaseSentMessageUpdate, PossiblySentViaBotCommonMessage<MediaGroupPartContent>>>>()
+    val mediaGroups = mutableMapOf<MediaGroupId, MutableList<Pair<BaseSentMessageUpdate, PossiblySentViaBotCommonMessage<MediaGroupPartContent>>>>()
 
     for (update in this) {
         val message = (update.data as? PossiblySentViaBotCommonMessage<*>) ?.let {
             if (it.content is MediaGroupPartContent) {
+                @Suppress("UNCHECKED_CAST")
                 it as PossiblySentViaBotCommonMessage<MediaGroupPartContent>
             } else {
                 null
@@ -48,10 +49,4 @@ internal fun List<Update>.convertWithMediaGroupUpdates(): List<Update> {
     return resultUpdates
 }
 
-/**
- * @return [EditMessageMediaGroupUpdate] in case if [this] is [EditMessageUpdate]. When [this] object is
- * [EditChannelPostUpdate] instance - will return [EditChannelPostMediaGroupUpdate]
- *
- * @throws IllegalStateException
- */
-internal fun BaseEditMessageUpdate.toEditMediaGroupUpdate() = this
+internal fun BaseEditMessageUpdate.toEditMediaGroupUpdate(): BaseEditMessageUpdate = this

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

@@ -1,30 +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.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,
@@ -37,55 +46,72 @@ 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: MessageId? = null,
-    allowSendingWithoutReply: Boolean? = null,
-    sentMessageFlow: FlowCollector<ContentMessage<LocationContent>>? = 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()
+            updateMessageJob ?.start()
             currentLiveLocationMessage = send(
-                chatId,
-                it.latitude,
-                it.longitude,
-                ceil(liveTimeMillis.toDouble() / 1000).toInt(),
-                it.horizontalAccuracy,
-                it.heading,
-                it.proximityAlertRadius,
-                threadId,
-                disableNotification,
-                protectContent,
-                replyToMessageId,
-                allowSendingWithoutReply,
-                it.replyMarkup
+                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 {
             edit(
-                capturedLiveLocationMessage,
-                it.latitude,
-                it.longitude,
-                it.horizontalAccuracy,
-                it.heading,
-                it.proximityAlertRadius,
-                it.replyMarkup
+                message = capturedLiveLocationMessage,
+                latitude = it.latitude,
+                longitude = it.longitude,
+                horizontalAccuracy = it.horizontalAccuracy,
+                heading = it.heading,
+                proximityAlertRadius = it.proximityAlertRadius,
+                replyMarkup = it.replyMarkup
             ).also {
                 sentMessageFlow ?.emit(it)
             }
@@ -99,20 +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: MessageId? = null,
-    allowSendingWithoutReply: Boolean? = null,
-    sentMessageFlow: FlowCollector<ContentMessage<LocationContent>>? = 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,
@@ -122,13 +152,17 @@ suspend fun TelegramBot.handleLiveLocation(
                 (it as? WithReplyMarkup) ?.replyMarkup as? InlineKeyboardMarkup
             )
         },
-        liveTimeMillis,
-        threadId,
-        disableNotification,
-        protectContent,
-        replyToMessageId,
-        allowSendingWithoutReply,
-        sentMessageFlow
+        liveTimeMillis = liveTimeMillis,
+        threadId = threadId,
+        directMessageThreadId = directMessageThreadId,
+        businessConnectionId = businessConnectionId,
+        disableNotification = disableNotification,
+        protectContent = protectContent,
+        allowPaidBroadcast = allowPaidBroadcast,
+        effectId = effectId,
+        suggestedPostParameters = suggestedPostParameters,
+        replyParameters = replyParameters,
+        sentMessageFlow = sentMessageFlow
     )
 }
 
@@ -138,31 +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: MessageId? = null,
-    allowSendingWithoutReply: Boolean? = null,
-    sentMessageFlow: FlowCollector<ContentMessage<LocationContent>>? = 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,
-        threadId,
-        disableNotification,
-        protectContent,
-        replyToMessageId,
-        allowSendingWithoutReply,
-        sentMessageFlow
+        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,47 +1,39 @@
+@file:Suppress("KDocUnresolvedReference")
+
 package dev.inmo.tgbotapi.extensions.api
 
 import korlibs.time.DateTime
 import korlibs.time.TimeSpan
-import dev.inmo.micro_utils.coroutines.LinkedSupervisorJob
-import dev.inmo.micro_utils.coroutines.launchSafelyWithoutExceptions
-import dev.inmo.tgbotapi.abstracts.types.WithReplyMarkup
 import dev.inmo.tgbotapi.bot.TelegramBot
-import dev.inmo.tgbotapi.extensions.api.edit.edit
 import dev.inmo.tgbotapi.extensions.api.edit.location.live.editLiveLocation
 import dev.inmo.tgbotapi.extensions.api.edit.location.live.stopLiveLocation
-import dev.inmo.tgbotapi.extensions.api.send.send
-import dev.inmo.tgbotapi.extensions.api.send.sendLiveLocation
 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.Location
 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.CoroutineStart
-import kotlinx.coroutines.currentCoroutineContext
-import kotlinx.coroutines.delay
-import kotlinx.coroutines.flow.Flow
-import kotlinx.coroutines.flow.map
-import kotlinx.coroutines.isActive
 import kotlinx.coroutines.launch
-import kotlin.js.JsName
-import kotlin.jvm.JvmName
 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,
@@ -53,23 +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
 
-    var message: ContentMessage<LocationContent> = initMessage
+    public var message: ContentMessage<LocationContent> = initMessage
         private set
-    val lastLocation: LiveLocation
+    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 {
@@ -77,7 +69,7 @@ class LiveLocationProvider internal constructor(
             message = requestsExecutor.editLiveLocation(
                 message,
                 location,
-                replyMarkup
+                replyMarkup = replyMarkup
             )
             return lastLocation
         } else {
@@ -98,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,
@@ -108,28 +100,36 @@ suspend fun TelegramBot.startLiveLocation(
     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: MessageId? = 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,
-            threadId,
-            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
         )
     )
 
@@ -145,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,
@@ -155,33 +155,41 @@ suspend fun TelegramBot.startLiveLocation(
     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: MessageId? = 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,
-    threadId,
-    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: IdChatIdentifier,
     location: StaticLocation,
@@ -190,33 +198,41 @@ suspend fun TelegramBot.startLiveLocation(
     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: MessageId? = 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,
-    threadId,
-    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,
@@ -225,34 +241,42 @@ suspend fun TelegramBot.startLiveLocation(
     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: MessageId? = 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,
-    threadId,
-    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,
@@ -261,33 +285,42 @@ suspend inline fun TelegramBot.replyWithLiveLocation(
     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,
-    threadId,
-    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,
@@ -295,22 +328,31 @@ suspend inline fun TelegramBot.replyWithLiveLocation(
     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,
-    threadId,
-    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: 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: 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(
+public suspend fun TelegramBot.stopPoll(
     chatId: IdChatIdentifier,
-    message: Message,
+    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

@@ -5,50 +5,50 @@ 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,
     button: InlineQueryResultsButton? = null
-) = execute(
+): Boolean = execute(
     AnswerInlineQuery(inlineQueryID, results, cachedTime, isPersonal, nextOffset, button)
 )
 
-suspend fun TelegramBot.answerInlineQuery(
+public suspend fun TelegramBot.answerInlineQuery(
     inlineQuery: InlineQuery,
     results: List<InlineQueryResult> = emptyList(),
     cachedTime: Int? = null,
     isPersonal: Boolean? = null,
     nextOffset: String? = null,
     button: InlineQueryResultsButton? = null
-) = answerInlineQuery(inlineQuery.id, results, cachedTime, isPersonal, nextOffset, button)
+): Boolean = answerInlineQuery(inlineQuery.id, results, cachedTime, isPersonal, nextOffset, button)
 
-suspend fun TelegramBot.answer(
+public suspend fun TelegramBot.answer(
     inlineQuery: InlineQuery,
     results: List<InlineQueryResult> = emptyList(),
     cachedTime: Int? = null,
     isPersonal: Boolean? = null,
     nextOffset: String? = null,
     button: InlineQueryResultsButton? = null
-) = answerInlineQuery(inlineQuery.id, results, cachedTime, isPersonal, nextOffset, button)
+): Boolean = answerInlineQuery(inlineQuery.id, results, cachedTime, isPersonal, nextOffset, button)
 
-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?,
     switchPmParameter: String?
-) = execute(
+): 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,
@@ -56,9 +56,9 @@ suspend fun TelegramBot.answerInlineQuery(
     nextOffset: String? = null,
     switchPmText: String?,
     switchPmParameter: String?
-) = answerInlineQuery(inlineQuery.id, results, cachedTime, isPersonal, nextOffset, switchPmText, switchPmParameter)
+): 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,
@@ -66,4 +66,4 @@ suspend fun TelegramBot.answer(
     nextOffset: String? = null,
     switchPmText: String?,
     switchPmParameter: String?
-) = answerInlineQuery(inlineQuery.id, results, cachedTime, isPersonal, nextOffset, switchPmText, switchPmParameter)
+): 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

@@ -6,12 +6,12 @@ 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: IetfLang?
-) = execute(DeleteMyCommands(scope, languageCode))
+): Boolean = execute(DeleteMyCommands(scope, languageCode))
 
-suspend fun TelegramBot.deleteMyCommands(
+public suspend fun TelegramBot.deleteMyCommands(
     scope: BotCommandScope = BotCommandScopeDefault,
     languageCode: String? = null
-) = deleteMyCommands(scope, languageCode ?.let(::IetfLang))
+): 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

@@ -3,15 +3,16 @@ 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.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: IetfLang? = null
-) = execute(GetMyCommands(scope, languageCode))
+): List<BotCommand> = execute(GetMyCommands(scope, languageCode))
 
-suspend fun TelegramBot.getMyCommands(
+public suspend fun TelegramBot.getMyCommands(
     scope: BotCommandScope = BotCommandScopeDefault,
     languageCode: String?
-) = getMyCommands(scope, languageCode ?.let(::IetfLang))
+): 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

@@ -3,11 +3,12 @@ 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
 
-suspend fun TelegramBot.getMyDescription(
+public suspend fun TelegramBot.getMyDescription(
     languageCode: IetfLang? = null
-) = execute(GetMyDescription(languageCode))
+): BotDescription = execute(GetMyDescription(languageCode))
 
-suspend fun TelegramBot.getMyDescription(
+public suspend fun TelegramBot.getMyDescription(
     languageCode: String?
-) = getMyDescription(languageCode ?.let(::IetfLang))
+): BotDescription = getMyDescription(languageCode ?.let(::IetfLang))

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

@@ -3,11 +3,12 @@ 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
 
-suspend fun TelegramBot.getMyName(
+public suspend fun TelegramBot.getMyName(
     languageCode: IetfLang? = null
-) = execute(GetMyName(languageCode))
+): BotName = execute(GetMyName(languageCode))
 
-suspend fun TelegramBot.getMyName(
+public suspend fun TelegramBot.getMyName(
     languageCode: String?
-) = getMyName(languageCode ?.let(::IetfLang))
+): BotName = getMyName(languageCode ?.let(::IetfLang))

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

@@ -4,13 +4,14 @@ 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
 
-suspend fun TelegramBot.getMyShortDescription(
+public suspend fun TelegramBot.getMyShortDescription(
     languageCode: IetfLang? = null
-) = execute(GetMyShortDescription(languageCode))
+): BotShortDescription = execute(GetMyShortDescription(languageCode))
 
-suspend fun TelegramBot.getMyShortDescription(
+public suspend fun TelegramBot.getMyShortDescription(
     languageCode: String?
-) = getMyShortDescription(languageCode ?.let(::IetfLang))
+): 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

@@ -7,26 +7,26 @@ 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: IetfLang?
-) = execute(SetMyCommands(commands, scope, languageCode))
+): Boolean = execute(SetMyCommands(commands, scope, languageCode))
 
-suspend fun TelegramBot.setMyCommands(
+public suspend fun TelegramBot.setMyCommands(
     vararg commands: BotCommand,
     scope: BotCommandScope = BotCommandScopeDefault,
     languageCode: IetfLang?
-) = setMyCommands(commands.toList(), scope, languageCode)
+): 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(::IetfLang))
+): 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

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

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

@@ -8,12 +8,12 @@ import dev.inmo.tgbotapi.requests.bot.SetMyDescription
 import dev.inmo.tgbotapi.types.commands.BotCommandScope
 import dev.inmo.tgbotapi.types.commands.BotCommandScopeDefault
 
-suspend fun TelegramBot.setMyDescription(
+public suspend fun TelegramBot.setMyDescription(
     description: String? = null,
     languageCode: IetfLang? = null
-) = execute(SetMyDescription(description, languageCode))
+): Boolean = execute(SetMyDescription(description, languageCode))
 
-suspend fun TelegramBot.setMyDescription(
+public suspend fun TelegramBot.setMyDescription(
     description: String?,
     languageCode: String?
-) = setMyDescription(description, languageCode ?.let(::IetfLang))
+): Boolean = setMyDescription(description, languageCode ?.let(::IetfLang))

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

@@ -8,12 +8,12 @@ import dev.inmo.tgbotapi.requests.bot.SetMyName
 import dev.inmo.tgbotapi.types.commands.BotCommandScope
 import dev.inmo.tgbotapi.types.commands.BotCommandScopeDefault
 
-suspend fun TelegramBot.setMyName(
+public suspend fun TelegramBot.setMyName(
     name: String? = null,
     languageCode: IetfLang? = null
-) = execute(SetMyName(name, languageCode))
+): Boolean = execute(SetMyName(name, languageCode))
 
-suspend fun TelegramBot.setMyName(
+public suspend fun TelegramBot.setMyName(
     name: String?,
     languageCode: String?
-) = setMyName(name, languageCode ?.let(::IetfLang))
+): Boolean = setMyName(name, languageCode ?.let(::IetfLang))

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

@@ -4,12 +4,12 @@ import dev.inmo.micro_utils.language_codes.IetfLang
 import dev.inmo.tgbotapi.bot.TelegramBot
 import dev.inmo.tgbotapi.requests.bot.SetMyShortDescription
 
-suspend fun TelegramBot.setMyShortDescription(
+public suspend fun TelegramBot.setMyShortDescription(
     shortDescription: String? = null,
     languageCode: IetfLang? = null
-) = execute(SetMyShortDescription(shortDescription, languageCode))
+): Boolean = execute(SetMyShortDescription(shortDescription, languageCode))
 
-suspend fun TelegramBot.setMyShortDescription(
+public suspend fun TelegramBot.setMyShortDescription(
     shortDescription: String?,
     languageCode: String?
-) = setMyShortDescription(shortDescription, languageCode ?.let(::IetfLang))
+): 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

@@ -7,22 +7,22 @@ import dev.inmo.tgbotapi.types.ForumTopic
 import dev.inmo.tgbotapi.types.MessageThreadId
 import dev.inmo.tgbotapi.types.chat.Chat
 
-suspend fun TelegramBot.closeForumTopic(
+public suspend fun TelegramBot.closeForumTopic(
     chatId: ChatIdentifier,
     messageThreadId: MessageThreadId
-) = execute(
+): Boolean = execute(
     CloseForumTopic(
         chatId,
         messageThreadId
     )
 )
 
-suspend fun TelegramBot.closeForumTopic(
+public suspend fun TelegramBot.closeForumTopic(
     chat: Chat,
     messageThreadId: MessageThreadId
-) = closeForumTopic(chat.id, messageThreadId)
+): Boolean = closeForumTopic(chat.id, messageThreadId)
 
-suspend fun TelegramBot.closeForumTopic(
+public suspend fun TelegramBot.closeForumTopic(
     chat: Chat,
     forumTopic: ForumTopic
-) = closeForumTopic(chat.id, forumTopic.messageThreadId)
+): Boolean = closeForumTopic(chat.id, forumTopic.messageThreadId)

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

@@ -8,12 +8,12 @@ import dev.inmo.tgbotapi.types.ForumTopic
 import dev.inmo.tgbotapi.types.MessageThreadId
 import dev.inmo.tgbotapi.types.chat.Chat
 
-suspend fun TelegramBot.closeGeneralForumTopic(
+public suspend fun TelegramBot.closeGeneralForumTopic(
     chatId: ChatIdentifier
-) = execute(
+): Boolean = execute(
     CloseGeneralForumTopic(chatId)
 )
 
-suspend fun TelegramBot.closeGeneralForumTopic(
+public suspend fun TelegramBot.closeGeneralForumTopic(
     chat: Chat
-) = closeGeneralForumTopic(chat.id)
+): Boolean = closeGeneralForumTopic(chat.id)

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

@@ -4,15 +4,16 @@ 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
 
-suspend fun TelegramBot.createForumTopic(
+public suspend fun TelegramBot.createForumTopic(
     chatId: ChatIdentifier,
     name: String,
     color: RGBColor,
     iconEmojiId: CustomEmojiId? = null
-) = execute(
+): ForumTopic = execute(
     CreateForumTopic(
         chatId,
         name,
@@ -21,9 +22,9 @@ suspend fun TelegramBot.createForumTopic(
     )
 )
 
-suspend fun TelegramBot.createForumTopic(
+public suspend fun TelegramBot.createForumTopic(
     chat: Chat,
     name: String,
     color: RGBColor,
     iconEmojiId: CustomEmojiId? = null
-) = createForumTopic(chat.id, name, color, iconEmojiId)
+): ForumTopic = createForumTopic(chat.id, name, color, iconEmojiId)

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

@@ -7,27 +7,27 @@ import dev.inmo.tgbotapi.types.ForumTopic
 import dev.inmo.tgbotapi.types.MessageThreadId
 import dev.inmo.tgbotapi.types.chat.Chat
 
-suspend fun TelegramBot.deleteForumTopic(
+public suspend fun TelegramBot.deleteForumTopic(
     chatId: ChatIdentifier,
     messageThreadId: MessageThreadId
-) = execute(
+): Boolean = execute(
     DeleteForumTopic(
         chatId,
         messageThreadId
     )
 )
 
-suspend fun TelegramBot.deleteForumTopic(
+public suspend fun TelegramBot.deleteForumTopic(
     chatId: ChatIdentifier,
     forumTopic: ForumTopic
-) = deleteForumTopic(chatId, forumTopic.messageThreadId)
+): Boolean = deleteForumTopic(chatId, forumTopic.messageThreadId)
 
-suspend fun TelegramBot.deleteForumTopic(
+public suspend fun TelegramBot.deleteForumTopic(
     chat: Chat,
     messageThreadId: MessageThreadId
-) = deleteForumTopic(chat.id, messageThreadId)
+): Boolean = deleteForumTopic(chat.id, messageThreadId)
 
-suspend fun TelegramBot.deleteForumTopic(
+public suspend fun TelegramBot.deleteForumTopic(
     chat: Chat,
     forumTopic: ForumTopic
-) = deleteForumTopic(chat.id, forumTopic.messageThreadId)
+): Boolean = deleteForumTopic(chat.id, forumTopic.messageThreadId)

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

@@ -8,12 +8,12 @@ import dev.inmo.tgbotapi.types.ForumTopic
 import dev.inmo.tgbotapi.types.MessageThreadId
 import dev.inmo.tgbotapi.types.chat.Chat
 
-suspend fun TelegramBot.editForumTopic(
+public suspend fun TelegramBot.editForumTopic(
     chatId: ChatIdentifier,
     messageThreadId: MessageThreadId,
     name: String? = null,
     iconEmojiId: CustomEmojiId? = null
-) = execute(
+): Boolean = execute(
     EditForumTopic(
         chatId,
         messageThreadId,
@@ -22,15 +22,15 @@ suspend fun TelegramBot.editForumTopic(
     )
 )
 
-suspend fun TelegramBot.editForumTopic(
+public suspend fun TelegramBot.editForumTopic(
     chat: Chat,
     messageThreadId: MessageThreadId,
     name: String? = null,
     iconEmojiId: CustomEmojiId? = null
-) = editForumTopic(chat.id, messageThreadId, name, iconEmojiId)
+): Boolean = editForumTopic(chat.id, messageThreadId, name, iconEmojiId)
 
-suspend fun TelegramBot.editForumTopic(
+public suspend fun TelegramBot.editForumTopic(
     chatIdentifier: ChatIdentifier,
     forumTopic: ForumTopic,
     iconEmojiId: CustomEmojiId? = forumTopic.iconEmojiId
-) = editForumTopic(chatIdentifier, forumTopic.messageThreadId, forumTopic.name, iconEmojiId)
+): Boolean = editForumTopic(chatIdentifier, forumTopic.messageThreadId, forumTopic.name, iconEmojiId)

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

@@ -9,22 +9,22 @@ import dev.inmo.tgbotapi.types.ForumTopic
 import dev.inmo.tgbotapi.types.MessageThreadId
 import dev.inmo.tgbotapi.types.chat.Chat
 
-suspend fun TelegramBot.editGeneralForumTopic(
+public suspend fun TelegramBot.editGeneralForumTopic(
     chatId: ChatIdentifier,
     name: String
-) = execute(
+): Boolean = execute(
     EditGeneralForumTopic(
         chatId,
         name
     )
 )
 
-suspend fun TelegramBot.editGeneralForumTopic(
+public suspend fun TelegramBot.editGeneralForumTopic(
     chat: Chat,
     name: String
-) = editGeneralForumTopic(chat.id, name)
+): Boolean = editGeneralForumTopic(chat.id, name)
 
-suspend fun TelegramBot.editGeneralForumTopic(
+public suspend fun TelegramBot.editGeneralForumTopic(
     chatIdentifier: ChatIdentifier,
     forumTopic: ForumTopic,
-) = editGeneralForumTopic(chatIdentifier, forumTopic.name)
+): Boolean = editGeneralForumTopic(chatIdentifier, forumTopic.name)

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

@@ -9,12 +9,12 @@ import dev.inmo.tgbotapi.types.ForumTopic
 import dev.inmo.tgbotapi.types.MessageThreadId
 import dev.inmo.tgbotapi.types.chat.Chat
 
-suspend fun TelegramBot.hideGeneralForumTopic(
+public suspend fun TelegramBot.hideGeneralForumTopic(
     chatId: ChatIdentifier
-) = execute(
+): Boolean = execute(
     HideGeneralForumTopic(chatId)
 )
 
-suspend fun TelegramBot.hideGeneralForumTopic(
+public suspend fun TelegramBot.hideGeneralForumTopic(
     chat: Chat
-) = hideGeneralForumTopic(chat.id)
+): Boolean = hideGeneralForumTopic(chat.id)

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

@@ -7,22 +7,22 @@ import dev.inmo.tgbotapi.types.ForumTopic
 import dev.inmo.tgbotapi.types.MessageThreadId
 import dev.inmo.tgbotapi.types.chat.Chat
 
-suspend fun TelegramBot.reopenForumTopic(
+public suspend fun TelegramBot.reopenForumTopic(
     chatId: ChatIdentifier,
     messageThreadId: MessageThreadId
-) = execute(
+): Boolean = execute(
     ReopenForumTopic(
         chatId,
         messageThreadId
     )
 )
 
-suspend fun TelegramBot.reopenForumTopic(
+public suspend fun TelegramBot.reopenForumTopic(
     chat: Chat,
     messageThreadId: MessageThreadId
-) = reopenForumTopic(chat.id, messageThreadId)
+): Boolean = reopenForumTopic(chat.id, messageThreadId)
 
-suspend fun TelegramBot.reopenForumTopic(
+public suspend fun TelegramBot.reopenForumTopic(
     chat: Chat,
     forumTopic: ForumTopic
-) = reopenForumTopic(chat.id, forumTopic.messageThreadId)
+): Boolean = reopenForumTopic(chat.id, forumTopic.messageThreadId)

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

@@ -8,12 +8,12 @@ import dev.inmo.tgbotapi.types.ForumTopic
 import dev.inmo.tgbotapi.types.MessageThreadId
 import dev.inmo.tgbotapi.types.chat.Chat
 
-suspend fun TelegramBot.reopenGeneralForumTopic(
+public suspend fun TelegramBot.reopenGeneralForumTopic(
     chatId: ChatIdentifier
-) = execute(
+): Boolean = execute(
     ReopenGeneralForumTopic(chatId)
 )
 
-suspend fun TelegramBot.reopenGeneralForumTopic(
+public suspend fun TelegramBot.reopenGeneralForumTopic(
     chat: Chat
-) = reopenGeneralForumTopic(chat.id)
+): Boolean = reopenGeneralForumTopic(chat.id)

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

@@ -10,12 +10,12 @@ import dev.inmo.tgbotapi.types.ForumTopic
 import dev.inmo.tgbotapi.types.MessageThreadId
 import dev.inmo.tgbotapi.types.chat.Chat
 
-suspend fun TelegramBot.unhideGeneralForumTopic(
+public suspend fun TelegramBot.unhideGeneralForumTopic(
     chatId: ChatIdentifier
-) = execute(
+): Boolean = execute(
     UnhideGeneralForumTopic(chatId)
 )
 
-suspend fun TelegramBot.unhideGeneralForumTopic(
+public suspend fun TelegramBot.unhideGeneralForumTopic(
     chat: Chat
-) = unhideGeneralForumTopic(chat.id)
+): Boolean = unhideGeneralForumTopic(chat.id)

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

@@ -7,22 +7,22 @@ import dev.inmo.tgbotapi.types.ForumTopic
 import dev.inmo.tgbotapi.types.MessageThreadId
 import dev.inmo.tgbotapi.types.chat.Chat
 
-suspend fun TelegramBot.unpinAllForumTopicMessages(
+public suspend fun TelegramBot.unpinAllForumTopicMessages(
     chatId: ChatIdentifier,
     messageThreadId: MessageThreadId
-) = execute(
+): Boolean = execute(
     UnpinAllForumTopicMessages(
         chatId,
         messageThreadId
     )
 )
 
-suspend fun TelegramBot.unpinAllForumTopicMessages(
+public suspend fun TelegramBot.unpinAllForumTopicMessages(
     chat: Chat,
     messageThreadId: MessageThreadId
-) = unpinAllForumTopicMessages(chat.id, messageThreadId)
+): Boolean = unpinAllForumTopicMessages(chat.id, messageThreadId)
 
-suspend fun TelegramBot.unpinAllForumTopicMessages(
+public suspend fun TelegramBot.unpinAllForumTopicMessages(
     chat: Chat,
     forumTopic: ForumTopic
-) = unpinAllForumTopicMessages(chat.id, forumTopic.messageThreadId)
+): Boolean = unpinAllForumTopicMessages(chat.id, forumTopic.messageThreadId)

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

@@ -8,14 +8,14 @@ import dev.inmo.tgbotapi.types.ForumTopic
 import dev.inmo.tgbotapi.types.MessageThreadId
 import dev.inmo.tgbotapi.types.chat.Chat
 
-suspend fun TelegramBot.unpinAllGeneralForumTopicMessages(
+public suspend fun TelegramBot.unpinAllGeneralForumTopicMessages(
     chatId: ChatIdentifier
-) = execute(
+): Boolean = execute(
     UnpinAllGeneralForumTopicMessages(
         chatId
     )
 )
 
-suspend fun TelegramBot.unpinAllGeneralForumTopicMessages(
+public suspend fun TelegramBot.unpinAllGeneralForumTopicMessages(
     chat: Chat
-) = unpinAllGeneralForumTopicMessages(chat.id)
+): Boolean = unpinAllGeneralForumTopicMessages(chat.id)

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

@@ -3,36 +3,16 @@ package dev.inmo.tgbotapi.extensions.api.chat.get
 import dev.inmo.tgbotapi.bot.TelegramBot
 import dev.inmo.tgbotapi.requests.chat.get.GetChat
 import dev.inmo.tgbotapi.types.ChatIdentifier
-import dev.inmo.tgbotapi.types.chat.ChannelChat
-import dev.inmo.tgbotapi.types.chat.ChannelChatImpl
-import dev.inmo.tgbotapi.types.chat.Chat
-import dev.inmo.tgbotapi.types.chat.CommonUser
-import dev.inmo.tgbotapi.types.chat.ExtendedChannelChat
-import dev.inmo.tgbotapi.types.chat.ExtendedChannelChatImpl
-import dev.inmo.tgbotapi.types.chat.ExtendedGroupChat
-import dev.inmo.tgbotapi.types.chat.ExtendedGroupChatImpl
-import dev.inmo.tgbotapi.types.chat.ExtendedPrivateChat
-import dev.inmo.tgbotapi.types.chat.ExtendedPrivateChatImpl
-import dev.inmo.tgbotapi.types.chat.ExtendedPublicChat
-import dev.inmo.tgbotapi.types.chat.ExtendedSupergroupChat
-import dev.inmo.tgbotapi.types.chat.ExtendedSupergroupChatImpl
-import dev.inmo.tgbotapi.types.chat.ExtendedUser
-import dev.inmo.tgbotapi.types.chat.GroupChat
-import dev.inmo.tgbotapi.types.chat.GroupChatImpl
-import dev.inmo.tgbotapi.types.chat.PrivateChat
-import dev.inmo.tgbotapi.types.chat.PrivateChatImpl
-import dev.inmo.tgbotapi.types.chat.PublicChat
-import dev.inmo.tgbotapi.types.chat.SupergroupChat
-import dev.inmo.tgbotapi.types.chat.SupergroupChatImpl
+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
@@ -41,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
 
 
 /**
@@ -53,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
@@ -64,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
 
 
 /**
@@ -76,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
@@ -87,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
 
 
 /**
@@ -99,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
@@ -110,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
 
 
 /**
@@ -122,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
@@ -133,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
@@ -144,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

@@ -3,12 +3,13 @@ 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.IdChatIdentifier
+import dev.inmo.tgbotapi.types.MenuButton
 import dev.inmo.tgbotapi.types.chat.PrivateChat
 
-suspend fun TelegramBot.getChatMenuButton(
+public suspend fun TelegramBot.getChatMenuButton(
     chatId: IdChatIdentifier
-) = execute(GetChatMenuButton(chatId))
+): 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,5 +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.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

@@ -2,5 +2,6 @@ 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
 
-suspend fun TelegramBot.getForumTopicIconStickers() = execute(GetForumTopicIconStickers)
+public suspend fun TelegramBot.getForumTopicIconStickers(): List<Sticker> = execute(GetForumTopicIconStickers)

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

@@ -9,34 +9,34 @@ 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

@@ -3,84 +3,151 @@ package dev.inmo.tgbotapi.extensions.api.chat.invite_links
 import korlibs.time.DateTime
 import dev.inmo.tgbotapi.bot.TelegramBot
 import dev.inmo.tgbotapi.requests.chat.invite_links.CreateChatInviteLink
-import dev.inmo.tgbotapi.types.ChatIdentifier
-import dev.inmo.tgbotapi.types.MembersLimit
-import dev.inmo.tgbotapi.types.TelegramDate
+import dev.inmo.tgbotapi.types.*
 import dev.inmo.tgbotapi.types.chat.PublicChat
-import dev.inmo.tgbotapi.types.toTelegramDate
+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

@@ -9,34 +9,34 @@ 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

@@ -3,185 +3,208 @@ package dev.inmo.tgbotapi.extensions.api.chat.invite_links
 import korlibs.time.DateTime
 import dev.inmo.tgbotapi.bot.TelegramBot
 import dev.inmo.tgbotapi.requests.chat.invite_links.EditChatInviteLink
-import dev.inmo.tgbotapi.types.ChatIdentifier
-import dev.inmo.tgbotapi.types.ChatInviteLink
-import dev.inmo.tgbotapi.types.MembersLimit
-import dev.inmo.tgbotapi.types.TelegramDate
+import dev.inmo.tgbotapi.types.*
 import dev.inmo.tgbotapi.types.chat.PublicChat
-import dev.inmo.tgbotapi.types.toTelegramDate
 
-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

@@ -9,30 +9,30 @@ 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(
+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

@@ -6,22 +6,22 @@ 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: IdChatIdentifier
-) = execute(BanChatSenderChat(chatId, senderChatId))
+): Boolean = execute(BanChatSenderChat(chatId, senderChatId))
 
-suspend fun TelegramBot.banChatSenderChat(
+public suspend fun TelegramBot.banChatSenderChat(
     chat: PublicChat,
     senderChatId: IdChatIdentifier
-) = banChatSenderChat(chat.id, senderChatId)
+): Boolean = banChatSenderChat(chat.id, senderChatId)
 
-suspend fun TelegramBot.banChatSenderChat(
+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)

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

@@ -7,23 +7,24 @@ import dev.inmo.tgbotapi.types.ChatIdentifier
 import dev.inmo.tgbotapi.types.UserId
 import dev.inmo.tgbotapi.types.chat.PublicChat
 import dev.inmo.tgbotapi.types.chat.User
+import dev.inmo.tgbotapi.types.chat.member.ChatMember
 
-suspend fun TelegramBot.getChatMember(
+public suspend fun TelegramBot.getChatMember(
     chatId: ChatIdentifier,
     userId: UserId
-) = execute(GetChatMember(chatId, userId))
+): ChatMember = execute(GetChatMember(chatId, userId))
 
-suspend fun TelegramBot.getChatMember(
+public suspend fun TelegramBot.getChatMember(
     chat: PublicChat,
     userId: UserId
-) = getChatMember(chat.id, userId)
+): ChatMember = getChatMember(chat.id, userId)
 
-suspend fun TelegramBot.getChatMember(
+public suspend fun TelegramBot.getChatMember(
     chatId: IdChatIdentifier,
     user: User
-) = getChatMember(chatId, user.id)
+): ChatMember = getChatMember(chatId, user.id)
 
-suspend fun TelegramBot.getChatMember(
+public suspend fun TelegramBot.getChatMember(
     chat: PublicChat,
     user: User
-) = getChatMember(chat.id, user.id)
+): ChatMember = getChatMember(chat.id, user.id)

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

@@ -2,7 +2,6 @@ package dev.inmo.tgbotapi.extensions.api.chat.members
 
 import dev.inmo.tgbotapi.bot.TelegramBot
 import dev.inmo.tgbotapi.requests.chat.members.PromoteChannelAdministrator
-import dev.inmo.tgbotapi.requests.chat.members.PromoteChatMember
 import dev.inmo.tgbotapi.types.IdChatIdentifier
 import dev.inmo.tgbotapi.types.ChatIdentifier
 import dev.inmo.tgbotapi.types.TelegramDate
@@ -10,7 +9,7 @@ import dev.inmo.tgbotapi.types.UserId
 import dev.inmo.tgbotapi.types.chat.PublicChat
 import dev.inmo.tgbotapi.types.chat.User
 
-suspend fun TelegramBot.promoteChannelAdministrator(
+public suspend fun TelegramBot.promoteChannelAdministrator(
     chatId: ChatIdentifier,
     userId: UserId,
     untilDate: TelegramDate? = null,
@@ -26,8 +25,9 @@ suspend fun TelegramBot.promoteChannelAdministrator(
     canManageChat: Boolean? = null,
     canPostStories: Boolean? = null,
     canEditStories: Boolean? = null,
-    canDeleteStories: Boolean? = null
-) = execute(
+    canDeleteStories: Boolean? = null,
+    canManageDirectMessages: Boolean? = null,
+): Boolean = execute(
     PromoteChannelAdministrator(
         chatId = chatId,
         userId = userId,
@@ -44,11 +44,12 @@ suspend fun TelegramBot.promoteChannelAdministrator(
         canManageChat = canManageChat,
         canPostStories = canPostStories,
         canEditStories = canEditStories,
-        canDeleteStories = canDeleteStories
+        canDeleteStories = canDeleteStories,
+        canManageDirectMessages = canManageDirectMessages,
     )
 )
 
-suspend fun TelegramBot.promoteChannelAdministrator(
+public suspend fun TelegramBot.promoteChannelAdministrator(
     chat: PublicChat,
     userId: UserId,
     untilDate: TelegramDate? = null,
@@ -64,8 +65,9 @@ suspend fun TelegramBot.promoteChannelAdministrator(
     canManageChat: Boolean? = null,
     canPostStories: Boolean? = null,
     canEditStories: Boolean? = null,
-    canDeleteStories: Boolean? = null
-) = promoteChannelAdministrator(
+    canDeleteStories: Boolean? = null,
+    canManageDirectMessages: Boolean? = null,
+): Boolean = promoteChannelAdministrator(
     chat.id,
     userId,
     untilDate = untilDate,
@@ -81,10 +83,11 @@ suspend fun TelegramBot.promoteChannelAdministrator(
     canManageChat = canManageChat,
     canPostStories = canPostStories,
     canEditStories = canEditStories,
-    canDeleteStories = canDeleteStories
+    canDeleteStories = canDeleteStories,
+    canManageDirectMessages = canManageDirectMessages,
 )
 
-suspend fun TelegramBot.promoteChannelAdministrator(
+public suspend fun TelegramBot.promoteChannelAdministrator(
     chatId: IdChatIdentifier,
     user: User,
     untilDate: TelegramDate? = null,
@@ -100,8 +103,9 @@ suspend fun TelegramBot.promoteChannelAdministrator(
     canManageChat: Boolean? = null,
     canPostStories: Boolean? = null,
     canEditStories: Boolean? = null,
-    canDeleteStories: Boolean? = null
-) = promoteChannelAdministrator(
+    canDeleteStories: Boolean? = null,
+    canManageDirectMessages: Boolean? = null,
+): Boolean = promoteChannelAdministrator(
     chatId,
     user.id,
     untilDate = untilDate,
@@ -117,10 +121,11 @@ suspend fun TelegramBot.promoteChannelAdministrator(
     canManageChat = canManageChat,
     canPostStories = canPostStories,
     canEditStories = canEditStories,
-    canDeleteStories = canDeleteStories
+    canDeleteStories = canDeleteStories,
+    canManageDirectMessages = canManageDirectMessages,
 )
 
-suspend fun TelegramBot.promoteChannelAdministrator(
+public suspend fun TelegramBot.promoteChannelAdministrator(
     chat: PublicChat,
     user: User,
     untilDate: TelegramDate? = null,
@@ -136,8 +141,9 @@ suspend fun TelegramBot.promoteChannelAdministrator(
     canManageChat: Boolean? = null,
     canPostStories: Boolean? = null,
     canEditStories: Boolean? = null,
-    canDeleteStories: Boolean? = null
-) = promoteChannelAdministrator(
+    canDeleteStories: Boolean? = null,
+    canManageDirectMessages: Boolean? = null,
+): Boolean = promoteChannelAdministrator(
     chat.id,
     user.id,
     untilDate = untilDate,
@@ -153,5 +159,6 @@ suspend fun TelegramBot.promoteChannelAdministrator(
     canManageChat = canManageChat,
     canPostStories = canPostStories,
     canEditStories = canEditStories,
-    canDeleteStories = canDeleteStories
+    canDeleteStories = canDeleteStories,
+    canManageDirectMessages = canManageDirectMessages,
 )

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

@@ -9,7 +9,7 @@ import dev.inmo.tgbotapi.types.UserId
 import dev.inmo.tgbotapi.types.chat.PublicChat
 import dev.inmo.tgbotapi.types.chat.User
 
-suspend fun TelegramBot.promoteChatAdministrator(
+public suspend fun TelegramBot.promoteChatAdministrator(
     chatId: ChatIdentifier,
     userId: UserId,
     untilDate: TelegramDate? = null,
@@ -21,7 +21,7 @@ suspend fun TelegramBot.promoteChatAdministrator(
     canPromoteMembers: Boolean? = null,
     canManageVideoChats: Boolean? = null,
     canManageChat: Boolean? = null,
-) = execute(
+): Boolean = execute(
     PromoteChatMember(
         chatId,
         userId,
@@ -37,7 +37,7 @@ suspend fun TelegramBot.promoteChatAdministrator(
     )
 )
 
-suspend fun TelegramBot.promoteChatAdministrator(
+public suspend fun TelegramBot.promoteChatAdministrator(
     chat: PublicChat,
     userId: UserId,
     untilDate: TelegramDate? = null,
@@ -49,7 +49,7 @@ suspend fun TelegramBot.promoteChatAdministrator(
     canPromoteMembers: Boolean? = null,
     canManageVideoChats: Boolean? = null,
     canManageChat: Boolean? = null,
-) = promoteChatAdministrator(
+): Boolean = promoteChatAdministrator(
     chat.id,
     userId,
     untilDate,
@@ -63,7 +63,7 @@ suspend fun TelegramBot.promoteChatAdministrator(
     canManageChat
 )
 
-suspend fun TelegramBot.promoteChatAdministrator(
+public suspend fun TelegramBot.promoteChatAdministrator(
     chatId: IdChatIdentifier,
     user: User,
     untilDate: TelegramDate? = null,
@@ -75,7 +75,7 @@ suspend fun TelegramBot.promoteChatAdministrator(
     canPromoteMembers: Boolean? = null,
     canManageVideoChats: Boolean? = null,
     canManageChat: Boolean? = null,
-) = promoteChatAdministrator(
+): Boolean = promoteChatAdministrator(
     chatId,
     user.id,
     untilDate,
@@ -89,7 +89,7 @@ suspend fun TelegramBot.promoteChatAdministrator(
     canManageChat
 )
 
-suspend fun TelegramBot.promoteChatAdministrator(
+public suspend fun TelegramBot.promoteChatAdministrator(
     chat: PublicChat,
     user: User,
     untilDate: TelegramDate? = null,
@@ -101,7 +101,7 @@ suspend fun TelegramBot.promoteChatAdministrator(
     canPromoteMembers: Boolean? = null,
     canManageVideoChats: Boolean? = null,
     canManageChat: Boolean? = null,
-) = promoteChatAdministrator(
+): Boolean = promoteChatAdministrator(
     chat.id,
     user.id,
     untilDate,

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

@@ -8,7 +8,7 @@ import dev.inmo.tgbotapi.types.chat.PublicChat
 import dev.inmo.tgbotapi.types.chat.User
 
 @Warning("This method is too common. Use it with caution")
-suspend fun TelegramBot.promoteChatMember(
+public suspend fun TelegramBot.promoteChatMember(
     chatId: ChatIdentifier,
     userId: UserId,
     untilDate: TelegramDate? = null,
@@ -26,8 +26,9 @@ suspend fun TelegramBot.promoteChatMember(
     canManageTopics: Boolean? = null,
     canPostStories: Boolean? = null,
     canEditStories: Boolean? = null,
-    canDeleteStories: Boolean? = null
-) = execute(
+    canDeleteStories: Boolean? = null,
+    canManageDirectMessages: Boolean? = null
+): Boolean = execute(
     PromoteChatMember(
         chatId = chatId,
         userId = userId,
@@ -46,12 +47,13 @@ suspend fun TelegramBot.promoteChatMember(
         canManageTopics = canManageTopics,
         canPostStories = canPostStories,
         canEditStories = canEditStories,
-        canDeleteStories = canDeleteStories
+        canDeleteStories = canDeleteStories,
+        canManageDirectMessages = canManageDirectMessages,
     )
 )
 
 @Warning("This method is too common. Use it with caution")
-suspend fun TelegramBot.promoteChatMember(
+public suspend fun TelegramBot.promoteChatMember(
     chat: PublicChat,
     userId: UserId,
     untilDate: TelegramDate? = null,
@@ -69,8 +71,9 @@ suspend fun TelegramBot.promoteChatMember(
     canManageTopics: Boolean? = null,
     canPostStories: Boolean? = null,
     canEditStories: Boolean? = null,
-    canDeleteStories: Boolean? = null
-) = promoteChatMember(
+    canDeleteStories: Boolean? = null,
+    canManageDirectMessages: Boolean? = null
+): Boolean = promoteChatMember(
     chat.id,
     userId,
     untilDate = untilDate,
@@ -88,11 +91,12 @@ suspend fun TelegramBot.promoteChatMember(
     canManageTopics = canManageTopics,
     canPostStories = canPostStories,
     canEditStories = canEditStories,
-    canDeleteStories = canDeleteStories
+    canDeleteStories = canDeleteStories,
+    canManageDirectMessages = canManageDirectMessages,
 )
 
 @Warning("This method is too common. Use it with caution")
-suspend fun TelegramBot.promoteChatMember(
+public suspend fun TelegramBot.promoteChatMember(
     chatId: IdChatIdentifier,
     user: User,
     untilDate: TelegramDate? = null,
@@ -110,8 +114,9 @@ suspend fun TelegramBot.promoteChatMember(
     canManageTopics: Boolean? = null,
     canPostStories: Boolean? = null,
     canEditStories: Boolean? = null,
-    canDeleteStories: Boolean? = null
-) = promoteChatMember(
+    canDeleteStories: Boolean? = null,
+    canManageDirectMessages: Boolean? = null
+): Boolean = promoteChatMember(
     chatId,
     user.id,
     untilDate = untilDate,
@@ -129,11 +134,12 @@ suspend fun TelegramBot.promoteChatMember(
     canManageTopics = canManageTopics,
     canPostStories = canPostStories,
     canEditStories = canEditStories,
-    canDeleteStories = canDeleteStories
+    canDeleteStories = canDeleteStories,
+    canManageDirectMessages = canManageDirectMessages,
 )
 
 @Warning("This method is too common. Use it with caution")
-suspend fun TelegramBot.promoteChatMember(
+public suspend fun TelegramBot.promoteChatMember(
     chat: PublicChat,
     user: User,
     untilDate: TelegramDate? = null,
@@ -151,8 +157,9 @@ suspend fun TelegramBot.promoteChatMember(
     canManageTopics: Boolean? = null,
     canPostStories: Boolean? = null,
     canEditStories: Boolean? = null,
-    canDeleteStories: Boolean? = null
-) = promoteChatMember(
+    canDeleteStories: Boolean? = null,
+    canManageDirectMessages: Boolean? = null
+): Boolean = promoteChatMember(
     chat.id,
     user.id,
     untilDate = untilDate,
@@ -170,5 +177,6 @@ suspend fun TelegramBot.promoteChatMember(
     canManageTopics = canManageTopics,
     canPostStories = canPostStories,
     canEditStories = canEditStories,
-    canDeleteStories = canDeleteStories
+    canDeleteStories = canDeleteStories,
+    canManageDirectMessages = canManageDirectMessages,
 )