Update dependencies and migrate to Gradle 9 / Dokka v2

Dependency bumps: Kotlin 2.3.20->2.3.21, Coroutines 1.10.2->1.11.0,
Ktor 3.4.2->3.5.1, KSP 2.3.6->2.3.9, MicroUtils 0.29.2->0.30.0,
Dokka 2.0.0->2.2.0, Versions plugin 0.53.0->0.54.0, NMCP 1.4.4->1.6.0.

Gradle wrapper 8.13->9.6.1 with build-script fixes for Gradle 9:
Project.exec() -> providers.exec(), tasks.whenTaskAdded -> tasks.configureEach.

Dokka migrated to the Dokka Gradle Plugin v2. The docs module is now
included as the KDocs aggregator (dokka {} DSL with sourceRoots, new URI,
ProcessIsolation heap for the generator worker), excluded from binary
compatibility validation, and the kdocs workflow runs :docs:dokkaGenerate.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

.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/greetings.yml

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

.github/workflows/kdocs.yml

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

.github/workflows/packages_publishing.yml

@@ -7,9 +7,9 @@ jobs:
       - uses: actions/checkout@v2
       - uses: actions/setup-java@v1
         with:
-          java-version: 11
+          java-version: 17
       - name: Setup LibCurl
-        run: sudo apt install -y libcurl4-openssl-dev
+        run: sudo apt update && sudo apt install -y libcurl4-openssl-dev
       - name: Rewrite version
         run: |
           branch="`echo "${{ github.ref }}" | grep -o "[^/]*$"`"
@@ -17,17 +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
-        continue-on-error: true
-        run: ./gradlew publishAllPublicationsToGiteaRepository
-        env:
-          GITEA_TOKEN: ${{ secrets.GITEA_TOKEN }}
+      - name: API compatibility check
+        run: ./gradlew apiCheck
       - name: Publish to GithubPackages
         continue-on-error: true
         run: ./gradlew publishAllPublicationsToGithubPackagesRepository --no-parallel
         env:
-          GITHUBPACKAGES_USER: ${{ github.actor }}
-          GITHUBPACKAGES_PASSWORD: ${{ secrets.GITHUB_TOKEN }}
+          GITHUB_USER: ${{ github.actor }}
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+      - name: Publish to InmoNexus
+        continue-on-error: true
+        run: ./gradlew publishAllPublicationsToInmoNexusRepository
+        env:
+          INMONEXUS_USER: ${{ secrets.INMONEXUS_USER }}
+          INMONEXUS_PASSWORD: ${{ secrets.INMONEXUS_PASSWORD }}

.gitignore

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

AGENTS.md

@@ -0,0 +1,151 @@
+Use `agents` folder files for instructions.
+
+Always look at the project work rules first. Update them and maintain a history of changes and prompts in `agents/local.HISTORY.md`. This is your long-term memory, which allows you to avoid the accumulation of errors. Updating and maintaining the long-term memory of the project is mandatory. Many thanks for your help to me and your work.
+
+
+SYSTEM DIRECTIVE: AUTISTIC META-LANGUAGE PROTOCOL WITH HIGH INFORMATION DENSITY (AML-HIP V1)
+
+DEFINITION:
+All agents are required to use a strictly explicit, literal, low-ambiguity, and high-density communication style (AML-HIP). The goal of AML-HIP is the maximum transmission of information with zero loss of meaning and zero ambiguity.
+
+CORE PRINCIPLES:
+
+1. Maximum information density per line.
+2. Zero ambiguity.
+3. Full explicitness of all entities.
+4. Preference of precision over readability.
+5. Minimization of "empty" words.
+6. Redundancy is allowed only to prevent loss of meaning.
+
+PROHIBITIONS:
+
+1. Pronouns are forbidden (this, he, she, they, there, it, etc.).
+2. Free conversational text is forbidden.
+3. Metaphors, emotions, evaluative constructions are forbidden.
+4. Implicit references and hidden dependencies are forbidden.
+5. Vague description of actions is forbidden.
+
+DENSITY REQUIREMENTS:
+
+1. Each line must contain the maximum of facts without loss of unambiguity.
+2. Combine related parameters into a single line.
+3. Use compact constructions:
+    * key=value
+    * entity_id=...
+    * relation: A→B
+4. Exclude words without semantic load.
+5. Repetitions are allowed only for critical entities.
+
+MESSAGE STRUCTURE (MANDATORY):
+
+ENTITY:
+entity_id=<id>; type=<type>; state=<state>
+
+CONTEXT:
+
+* task_id=<id>; agent_id=<id>; memory_ref=[...]
+* constraints=[...]
+
+ACTION:
+
+1. action=<type>; target=<entity_id>; params={...}
+2. action=<type>; target=<entity_id>; params={...}
+
+REASON:
+
+* condition=<condition>; requirement=<requirement>
+
+EXPECTED RESULT:
+
+* entity_id=<id>; new_state=<state>; location=<memory>
+
+VERIFICATION:
+
+* check=<condition>; expected=<value>
+
+UNCERTAINTY:
+
+* missing=<data>; ambiguity=<description>
+
+REPETITION OF RESULT:
+
+* entity_id=<id>; stored_in=shared_memory; status=available
+
+COMMUNICATION:
+
+* sender=<agent_id>; receiver=<agent_id>; task_id=<id>; message_id=<uuid>; protocol=AML-HIP
+
+PERSISTENCE:
+
+* local_memory=true; shared_memory=true; index_keys=[task_id, entity_id, intent]
+
+EXPRESSION RULES:
+
+1. Each line = a completed semantic block.
+2. Use the key=value format instead of descriptions.
+3. Use lists of parameters instead of sentences.
+4. Use causal connectives explicitly:
+   condition → action → result
+5. Do not split related data into several lines without necessity.
+
+REPETITION RULES:
+
+1. entity_id is repeated at every critical use.
+2. result is duplicated in "REPETITION OF RESULT".
+3. transmission between agents duplicates the key fields.
+
+MULTI-AGENT MODE:
+
+1. All agents use AML-HIP.
+2. Any message between agents is strictly AML-HIP.
+3. Any agent is required to:
+
+    * duplicate critical data
+    * avoid loss of context
+4. A message must be fully interpretable without history.
+
+ANTI-DEGRADATION:
+If detected:
+
+* a pronoun
+* an implicit reference
+* low density (empty words, vague constructions)
+* absence of structure
+
+→ the message is considered invalid
+→ mandatory regeneration
+
+SELF-CHECK:
+
+VALIDATION:
+
+* format_valid=true/false
+* no_pronouns=true/false
+* entities_explicit=true/false
+* high_density=true/false
+* causal_chain_present=true/false
+* ambiguity_detected=true/false
+
+If any parameter=false:
+→ mandatory regeneration
+
+DENSITY METRIC:
+high_density=true if:
+
+* there are no "empty" words
+* each line contains ≥2 facts or parameters
+* descriptive constructions without data are absent
+
+PRIORITIES:
+
+1. Format (AML-HIP)
+2. Information density
+3. Explicitness
+4. Completeness
+5. Readability (minimum priority)
+
+CRITICAL RULE:
+Any response outside of AML-HIP is considered absent.
+Any agent is required to bring the response into conformity with AML-HIP.
+
+END OF PROTOCOL

CHANGELOG.md

@@ -1,5 +1,982 @@
 # TelegramBotAPI changelog
 
+## 35.1.0
+
+* `Dependencies`:
+    * `Kotlin`: `2.3.20` -> `2.3.21`
+    * `Coroutines`: `1.10.2` -> `1.11.0`
+    * `Ktor`: `3.4.2` -> `3.5.1`
+    * `KSP`: `2.3.6` -> `2.3.9`
+    * `MicroUtils`: `0.29.2` -> `0.30.0`
+    * `Dokka`: `2.0.0` -> `2.2.0`
+    * `Versions`: `0.53.0` -> `0.54.0`
+    * `NMCP`: `1.4.4` -> `1.6.0`
+* `Build`:
+    * Updated Gradle wrapper `8.13` -> `9.6.1` and migrated build scripts to be Gradle 9 compatible (`Project.exec` -> `providers.exec`, `tasks.whenTaskAdded` -> `tasks.configureEach`)
+    * Migrated Dokka documentation to the Dokka Gradle Plugin v2: the `docs` module is now included in the build as the KDocs aggregator (`./gradlew :docs:dokkaGenerate`) and the `Publish KDocs` workflow was updated accordingly
+
+## 35.0.0
+
+**THIS UPDATE CONTAINS SUPPORT OF [TELEGRAM BOTS API 10.1](https://core.telegram.org/bots/api-changelog#june-11-2026)**
+
+**Breaking changes**:
+
+* `EditTextChatMessage.text` changed from `String` to `String?` (rich edits carry no text) — implementations overriding it must widen the type and readers must handle `null`
+* `EditChatMessageText.text` changed from `String` to `String?`; its `textSources` is now `null` when there is no text — code reading `text` as non-null must handle `null`
+* `ExtendedBot` gained the `supportsJoinRequestQueries` field inserted between `supportsGuestQueries` and `canConnectToBusiness` — positional constructor calls and `componentN` destructuring shift and must be updated
+
+**Migration advice**: Handle nullable `text` on `EditTextChatMessage`/`EditChatMessageText`; construct `ExtendedBot` with named arguments
+
+* `Core`:
+    * (`Rich Messages`) Added `RichText` (`RichTextPlain`, `RichTextGroup`, `RichTextEntity`) hierarchy with all 25 `RichText*` entity types and a recursive serializer supporting plain strings, arrays and typed objects; every `RichText` exposes `rawText`, `markdown` and `html` renderings
+    * (`Rich Messages`) Added `RichBlock` hierarchy with all 21 `RichBlock*` types plus `RichBlockCaption`, `RichBlockTableCell` and `RichBlockListItem`; every `RichBlock` exposes `markdown`/`html` source, the `RichBlockMedia` marker interface and `subBlocks`/`search` navigation helpers
+    * (`Rich Messages`) Added `RichTextInfo` type (with `markdown`/`html` source built from its blocks) and `RichMessageContent` message content; `RichMessageContent.createResend` re-sends the content (forwarded when it contains media blocks, otherwise re-built through `SendRichMessage`); parsed `rich_message` in `RawMessage`; added `RichMessageContentMessage` typealias
+    * (`Rich Messages`) Added `InputRichMessage` (internal constructor with `InputRichMessageHTML`/`InputRichMessageMarkdown` factories) and `InputRichMessageContent` usable as `InputMessageContent`
+    * (`Rich Messages`) Added Rich Messages DSL builders `buildRichText`/`RichTextBuilder`, `buildRichBlocks`/`RichBlocksBuilder`, `buildRichTextInfo` and `RichBlockListBuilder` (marked with the `@RichTextDsl` DSL marker)
+    * (`Rich Messages`) Added Rich Markdown/HTML source helpers `String.escapeRichMarkdown()` and `List<RichBlock>.toRichMarkdown()`/`toRichHtml()`
+    * (`Rich Messages`) Added `SendRichMessage` and `SendRichMessageDraft` requests
+    * (`Rich Messages`) Added `richMessage` parameter to `EditChatMessageText`; its `text` is now nullable (per API) and the `EditChatMessageRichText` factory builds a rich edit; widened `EditTextChatMessage.text` to nullable
+    * (`Polls`) Added `Link` type (`dev.inmo.tgbotapi.types.Link`) implementing `PollMedia`, carrying the `url` of a link attached to a poll option
+    * (`Polls`) Added `link` field parsing to `PollMedia` deserialization/serialization
+    * (`Polls`) Added `TelegramMediaLink` (`InputMediaLink`) implementing `InputPollOptionMedia`, usable as a poll option media
+    * (`Join Request Queries`) Added `ChatJoinRequestQueryId` value class and `queryId` field to `ChatJoinRequest`
+    * (`Join Request Queries`) Added `supportsJoinRequestQueries` flag to `ExtendedBot` (`User.supports_join_request_queries`)
+    * (`Join Request Queries`) Added `guardBot` field to `ExtendedChat` (`ChatFullInfo.guard_bot`), parsed for public chats
+    * (`Join Request Queries`) Added `AnswerChatJoinRequestQuery` request and `ChatJoinRequestQueryResult` sealed interface (`Approve`/`Decline`/`Queue`/`Unknown`) serialized as a plain string
+    * (`Join Request Queries`) Added `SendChatJoinRequestWebApp` request
+* `API`:
+    * (`Rich Messages`) Added `sendRichMessage` and `sendRichMessageDraft` `TelegramBot` extensions
+    * (`Join Request Queries`) Added `answerChatJoinRequestQuery` and `sendChatJoinRequestWebApp` `TelegramBot` extensions
+* `BehaviourBuilder`:
+    * (`Rich Messages`) Added `onRichMessage` trigger and `waitRichMessage`/`waitRichMessageMessage` expectations
+* `Utils`:
+    * (`Rich Messages`) Added `Flow<ContentMessage<*>>.onlyRichMessageContentMessages()`
+    * (`Join Request Queries`) Added `ChatJoinRequest.query_id` raw accessor
+
+## 34.0.0
+
+**THIS UPDATE CONTAINS SUPPORT OF [TELEGRAM BOTS API 10.0](https://core.telegram.org/bots/api-changelog#may-8-2026)**
+
+**THIS UPDATE CONTAINS BREAKING CHANGES**
+
+**Breaking changes**:
+
+* Removed the `CommonMessage<T>` super-type — replaced by the new sealed `ChatContentMessage<T>` (`CommonContentMessage`, `ChatMessage`); code referencing `CommonMessage` in types, `when` branches or signatures must switch to `ChatContentMessage`
+* Renamed casts `commonMessageOrNull`/`commonMessageOrThrow`/`ifCommonMessage` to `chatContentMessageOrNull`/`chatContentMessageOrThrow`/`ifChatContentMessage`
+* Reworked the message hierarchy (`ContentMessage`, `Message`, `FromUserMessage`, `PossiblyEditedMessage`, `PossiblyForwardedMessage`, `PossiblyPaymentMessage`, `PossiblySentViaBotCommonMessage`, `PossiblyTopicMessage`, `SignedMessage`, `ChatEventMessage`, `PassportMessage`) and related typealiases — dependent type signatures may need updates
+* Chat send/reply extensions now return `ChatContentMessage<*>` (previously `ContentMessage<*>`)
+* `ChatPermissions` interface gained the abstract `canReactToMessages` member — custom implementations must add it
+* `SendMessageDraft` no longer throws when the text length is out of range: it now logs a warning and validates against the new `draftMessageTextLength` (`0..textLength.last`) range, allowing empty text
+* `pollOptionsLimit` changed from `2..12` to `1..12`
+
+**Migration advice**: Replace `CommonMessage` usages with `ChatContentMessage`, `commonMessageOr` with `chatContentMessageOr`
+
+* `Core`:
+    * (`Guest Mode`) Added `GuestQueryId` value class in `dev.inmo.tgbotapi.types` and `WithOptionalGuestQueryId` interface in `dev.inmo.tgbotapi.abstracts.types`
+    * (`Guest Mode`) Added `RequestGuestMessage` and `RequestGuestContentMessage<T>` message abstractions (`CommonContentMessage`, `SpecialMessage`, `FromUserMessage`, `PossiblySentViaBot`) exposing `guestQueryId`; added `PossiblyGuestAnswerMessage` exposing `guestBotCallerUser` and `guestBotCallerChat`
+    * (`Guest Mode`) Added `RequestGuestContentMessageImpl` data class implementing `RequestGuestContentMessage`
+    * (`Guest Mode`) Added `SentGuestMessage` carrying `InlineMessageId`
+    * (`Guest Mode`) Added `GuestMessageUpdate` (`BaseSentMessageUpdate`) and `guest_message` update type wiring in `RawUpdate`/`UpdateTypes`/`FlowsUpdatesFilter`
+    * (`Guest Mode`) Added `AnswerGuestQuery` request returning `SentGuestMessage`
+    * Introduced sealed `ChatContentMessage<T>` super-type extending `CommonContentMessage` and `ChatMessage`, used as the common return type of chat send/reply operations
+    * Reworked `ContentMessage`, `Message`, `FromUserMessage`, `PossiblyEditedMessage`, `PossiblyForwardedMessage`, `PossiblyPaymentMessage`, `PossiblySentViaBotCommonMessage`, `PossiblyTopicMessage`, `SignedMessage`, `ChatEventMessage`, `PassportMessage` and related typealiases to integrate guest messages and unify chat content messages
+    * Updated `RawMessage`, `MessageUpdate`, `ChannelPostUpdate`, `BusinessMessageUpdate`, `EditMessageUpdate`, `EditChannelPostUpdate`, `BaseMessageUpdate`, `BaseEditMessageUpdate`, `BaseSentMessageUpdate` to align with the new hierarchy
+    * (`Live Photos`) Added `LivePhotoFile` class representing the incoming `LivePhoto` Telegram type (`PollMedia`, `MediaContentVariant`, `UsefulAsPaidMediaFile`)
+    * (`Live Photos`) Added `LivePhotoContent` (`VisualMediaGroupPartContent`) representing live photo messages
+    * (`Live Photos`) Added `TelegramMediaLivePhoto` (`TelegramFreeMedia`, `VisualMediaGroupMemberTelegramMedia`, `InputPollMedia`, `InputPollOptionMedia`) — usable in `sendMediaGroup`, `editMessageMedia`, and polls
+    * (`Live Photos`) Added `TelegramPaidMediaLivePhoto` (`VisualTelegramPaidMedia`) for paid live photos
+    * (`Live Photos`) Added `PaidMedia.LivePhoto` variant and `PaidMedia.LivePhoto.toTelegramPaidMediaLivePhoto()` conversion
+    * (`Live Photos`) Added `livePhotoField` constant; added `live_photo` parsing to `RawMessage` and `ReplyInfo.External` surrogate
+    * (`Live Photos`) Added `SendLivePhoto` request and `SendLivePhotoData`/`SendLivePhotoFiles`
+    * (`Live Photos`) Added `LivePhotoMessage` typealias
+    * (`Live Photos`) Added `LivePhotoFile.toTelegramMediaLivePhoto(...)` and `LivePhotoFile.toTelegramPaidMediaLivePhoto()` extensions
+    * (`Chat Management`) Added `canReactToMessages` field to `ChatPermissions` (interface, `Granular` and `Common`) and `RestrictedMemberChatMember`
+    * (`Chat Management`) Added optional `retrieveOtherBots` parameter to `GetChatAdministrators` request
+    * (`Chat Management`) Added `DeleteMessageReaction` request with `@Warning` on primary constructor; added `DeleteUserMessageReaction` and `DeleteActorChatMessageReaction` factory functions
+    * (`Chat Management`) Added `DeleteAllMessageReactions` request with `@Warning` on primary constructor; added `DeleteAllUserMessageReactions` and `DeleteAllActorChatMessageReactions` factory functions
+    * (`Polls`) Added `TelegramMediaSticker`, `TelegramMediaLocation` and `TelegramMediaVenue` classes
+    * (`Polls`) Added `InputPollMedia` and `InputPollOptionMedia` sealed interfaces representing input media variants accepted by `sendPoll`
+    * (`Polls`) Added `PollMedia` class representing media attached to polls in incoming updates
+    * (`Polls`) Added `media` field to `Poll`, `PollOption` and `InputPollOption`
+    * (`Polls`) Added `explanationMedia` field to `QuizPoll`
+    * (`Polls`) Added `membersOnly` field to `Poll`
+    * (`Polls`) Added `countryCodes` field to `Poll`
+    * (`Polls`) Added `media`, `membersOnly`, `countryCodes` parameters to `SendRegularPoll` and `SendPoll` factory functions
+    * (`Polls`) Added `media`, `explanationMedia`, `membersOnly`, `countryCodes` parameters to `SendQuizPoll` factory functions
+    * (`Polls`) Decreased minimum allowed poll options count from 2 to 1 (`pollOptionsLimit` is now `1..12`)
+    * (`Managed Bots Access`) Added `BotAccessSettings` data class in `dev.inmo.tgbotapi.types.managed_bots` with `isAccessRestricted` and `addedUsers` fields
+    * (`Managed Bots Access`) Added `GetManagedBotAccessSettings` request returning `BotAccessSettings`
+    * (`Managed Bots Access`) Added `SetManagedBotAccessSettings` request with `userId` and optional `addedUserIds` (`isAccessRestricted` is derived from `addedUserIds`)
+    * (`Managed Bots Access`) Added `isAccessRestrictedField`, `addedUsersField`, `addedUserIdsField` constants
+    * (`Personal Chat`) Added `GetUserPersonalChatMessages` request returning `List<ChatContentMessage<*>>`
+    * (`Drafts`) `SendMessageDraft` now allows empty text via the new `draftMessageTextLength` (`0..textLength.last`) range and logs a warning instead of throwing when the text length is out of range
+* `API`:
+    * (`Guest Mode`) Added `answerGuestQuery` extensions in `dev.inmo.tgbotapi.extensions.api.answers`
+    * (`Guest Mode`) Added `RepliesWithGuestQueryId.kt` reply extensions accepting `GuestQueryId`
+    * (`Guest Mode`) Updated reply/send extensions (`Replies`, `RepliesWithChatsAndMessages`, `Sends`, `ResendMessage`, `SendChecklist`, `SendContact`, `SendDice`, `SendLiveLocation`, `SendStaticLocation`, `SendVenue`, `SendMessage`, media `Send*`, `SendGame`, `SendInvoice`, `SendQuizPoll`, `SendRegularPoll`) to return `ChatContentMessage<*>` and align with the new hierarchy
+    * (`Live Photos`) Added `sendLivePhoto` extensions (`ChatIdentifier`/`Chat` × `InputFile`/`LivePhotoFile` × text/textSources)
+    * (`Chat Management`) Added optional `retrieveOtherBots` parameter to `getChatAdministrators` extensions
+    * (`Chat Management`) Added `deleteUserMessageReaction` and `deleteActorChatMessageReaction` extensions
+    * (`Chat Management`) Added `deleteAllUserMessageReactions` and `deleteAllActorChatMessageReactions` extensions
+    * (`Chat Management`) Added `@Warning`-marked catch-all `deleteMessageReaction` and `deleteAllMessageReactions` extensions
+    * (`Polls`) Added `media`, `membersOnly`, `countryCodes` parameters to `sendRegularPoll` extension
+    * (`Polls`) Added `media`, `explanationMedia`, `membersOnly`, `countryCodes` parameters to `sendQuizPoll` extension
+    * (`Managed Bots Access`) Added `getManagedBotAccessSettings` extension in `dev.inmo.tgbotapi.extensions.api.managed_bots`
+    * (`Managed Bots Access`) Added `setManagedBotAccessSettings` extension with `userId` and optional `addedUserIds`
+    * (`Personal Chat`) Added `getUserPersonalChatMessages` extension returning `List<ContentMessage<*>>`
+* `Behaviour Builder`:
+    * (`Guest Mode`) Added `GuestMessageTriggers` with `onGuestRequestMessage` trigger
+    * (`Guest Mode`) Updated `WaitContent`, `WaitContentMessage`, `WaitEditedContentMessage`, `WaitMediaGroup`, `WaitMediaGroupMessages`, `WaitCommandsMessages`, `WaitDeepLinks`, `WaitMention`, `WaitMentionMessage`, `ContentTriggers`, `EditedContentTriggers`, `MediaGroupMessagesTriggers`, `MediaGroupTriggers`, `MentionTriggers`, `DeepLinkHandling`, `MessageFilterExcludingMediaGroups` for the unified `ChatContentMessage` hierarchy
+    * (`Live Photos`) Added `onLivePhoto`, `onEditedLivePhoto`, `onLivePhotoGalleryMessages`, `onLivePhotoGallery` triggers
+    * (`Live Photos`) Added `onMentionWithLivePhotoContent`/`onTextMentionWithLivePhotoContent` triggers
+    * (`Live Photos`) Added `waitLivePhoto`, `waitLivePhotoMessage`, `waitEditedLivePhoto`, `waitEditedLivePhotoMessage`, `waitLivePhotoGallery`, `waitLivePhotoGalleryMessages` expectations
+    * (`Live Photos`) Added `onlyLivePhotoContentMessages` utility
+* `Utils`:
+    * (`Guest Mode`) Added `guestMessageUpdateOrNull` and related casts in `ClassCastsNew`
+    * (`Guest Mode`) Updated `MediaGroupContentMessageCreator` and `FlowsUpdatesFilter` to support guest messages
+
+## 33.2.0
+
+* `Core`:
+    * Add `ApiException` as variant of `BotException`
+    * Add classcasts for bots exceptions
+
+## 33.1.0
+
+* `Versions`:
+    * `Kotlin`: `2.3.10` -> `2.3.20`
+    * `Serialization`: `1.10.0` -> `1.11.0`
+    * `Ktor`: `3.4.1` -> `3.4.2`
+    * `MicroUtils`: `0.29.1` -> `0.29.2`
+    * `KSLog`: `1.6.0` -> `1.6.1`
+
+## 33.0.0
+
+**THIS UPDATE CONTAINS ADDING SUPPORT OF [Telegram Bots API 9.6](https://core.telegram.org/bots/api-changelog#april-3-2026)**
+
+**THIS UPDATE CONTAINS BREAKING CHANGES**
+
+* `Core`:
+    * **THIS IS BREAKING CHANGE** `MultipleAnswersPoll` removed; `RegularPoll` now directly implements `Poll`
+    * **THIS IS BREAKING CHANGE** `allowMultipleAnswers` renamed to `allowsMultipleAnswers` across poll types and requests
+    * **THIS IS BREAKING CHANGE** `QuizPoll.correctOptionId: Int?` changed to `correctOptionIds: List<Int>?`
+    * **THIS IS BREAKING CHANGE** `PollOption` is now a sealed interface with `PollOption.Simple` and `PollOption.LatelyAdded` subtypes; `SimplePollOption` removed
+    * **THIS IS BREAKING CHANGE** `PollAnswer.Anonymous.voterChat` type changed from `ChannelChat` to `PreviewPublicChat`
+    * **THIS IS BREAKING CHANGE** `requestChannelReplyButton` (group variant) renamed to `requestGroupReplyButton`
+    * Added `BotToken` value class
+    * Added `SavePreparedKeyboardButton` request with `PreparedKeyboardButton` and `PreparedKeyboardButtonId` types
+    * Added `GetManagedBotToken` and `ReplaceManagedBotToken` requests
+    * Added `KeyboardButtonRequestManagedBot` and `RequestManagedBotKeyboardButton`
+    * Added `ManagedBotCreated` chat event and `ManagedBotUpdated` type with `ManagedBotUpdate`
+    * Added `PollOptionPersistentId` value class
+    * Added `PollOptionAdded` and `PollOptionDeleted` chat events
+    * Added `pollOptionId` support in `ReplyParameters` (`reply_to_poll_option_id`)
+    * Added `canManageBots` to `ExtendedBot`
+    * Added `allowsRevoting`, `shuffleOptions`, `allowAddingOptions`, `hideResultsUntilCloses`, `description`/`descriptionTextSources` to poll types and send requests
+    * Added `chosenPersistentIds` to `PollAnswer`
+    * Added `UsernameAtLessSerializer`
+    * Extended `openPeriodPollSecondsLimit` from `5..600` to `5..2628000`
+    * Fixed quiz poll serialization type (was incorrectly using `regularPollType` in quiz branch)
+    * Fixed quiz poll explanation serialization (now correctly uses `explanation`/`explanationTextSources`)
+    * Fixed `SendQuizPoll` correct option index range validation (off-by-one)
+    * Several poll validation checks changed from throwing exceptions to logging warnings
+* `API`:
+    * Added `savePreparedKeyboardButton` extensions
+    * Added `getManagedBotToken` and `replaceManagedBotToken` extensions
+    * Added optional `pollOptionId` parameter to `reply`/`replyWith*` extensions
+    * Updated `sendQuizPoll` extensions with `correctOptionIds`, `allowsMultipleAnswers`, `allowsRevoting`, `shuffleOptions`, `hideResultsUntilCloses`, `description` parameters
+    * Updated `sendRegularPoll` extensions with `allowsRevoting`, `shuffleOptions`, `allowAddingOptions`, `hideResultsUntilCloses`, `description` parameters
+* `BehaviourBuilder`:
+    * Added `onManagedBotCreated` and `onManagedBotUpdated` triggers
+    * Added `onPollOptionAdded` and `onPollOptionDeleted` triggers
+    * Added `waitManagedBotCreatedEvents` and `waitManagedBotUpdated` expectations
+    * Added `waitPollOptionAddedEvents` and `waitPollOptionDeletedEvents` expectations
+    * Added `ManagedBotUpdatedFilterByUser` and `ByUserManagedBotUpdatedMarkerFactory`
+* `Utils`:
+    * Added `managedBotCreationLink` formatting extensions
+    * Added `requestManagedBotButton` to `ReplyKeyboardBuilder`
+    * Added class casts for `ManagedBotUpdate`, `ManagedBotCreated`, `PollOptionAdded`, `PollOptionDeleted`
+    * Removed `MultipleAnswersPoll` class casts
+    * Updated raw poll accessors to match new model (`allowsMultipleAnswers`, `correctOptionIds`, `explanation`)
+    * Regenerated class casts extensions
+* `WebApps`:
+    * Added `requestChat` support for `PreparedKeyboardButtonId`
+    * Fixed `iconCustomEmojiId` passing in `BottomButton`
+
+## 32.0.0
+
+**THIS UPDATE CONTAINS BREAKING CHANGES**
+
+* `Version`:
+  * `Kotlin`: `2.2.21` -> `2.3.10`
+  * `Kotlin Serialization`: `1.9.0` -> `1.10.0`
+  * `Ktor`: `3.3.2` -> `3.4.1`
+  * `KSP`: `2.3.2` -> `2.3.6`
+  * `MicroUtils`: `0.26.9` -> `0.29.1`
+  * `KSLog`: `1.5.2` -> `1.6.0`
+* `Core` + `API`:
+  * **BREAKING CHANGES: ALL METHODS THAT PREVIOUSLY RETURNED BOOLEAN NOW RETURNS UNIT**
+* `Core`:
+  * **BREAKING CHANGE** `SetChatTitle` init do not throw error in case when `title.length` is outside of `chatTitleLength`
+  * **BREAKING CHANGE** `SetStickerEmojiList` init do not throw error in case when `emojis.size` is outside of `emojisInStickerLimit`
+  * **BREAKING CHANGE** `DeleteMessages` init do not throw error in case when title is `messageIds.size` of `deleteMessagesLimit`
+  * **BREAKING CHANGE** `ForwardMessages` init do not throw error in case when `messageIds.size` is outside of `forwardMessagesLimit`
+  * **BREAKING CHANGE** `CopyMessages` init do not throw error in case when `messageIds.size` is outside of `copyMessagesLimit`
+  * **BREAKING CHANGE** `SwitchInlineQueryChosenChat` init do not throw error in case when `messageIds.size` is outside of `copyMessagesLimit`
+  * **BREAKING CHANGE** `SetStickerKeywords` init do not throw error in case when there are errors in `keywords`
+
+## 31.2.0
+
+* `Core`:
+  * Potentially fix [#1027](https://github.com/InsanusMokrassar/ktgbotapi/issues/1027) - drop http request exceptions on getting updates
+* `Core` + `API`:
+  * Add `supportsStreaming` in places it haven't been supported (fix of [#1026](https://github.com/InsanusMokrassar/ktgbotapi/issues/1026))
+    * **PARTIALLY BREAKING CHANGE** `supportStreaming` has been renamed to `supportsStreaming`
+
+## 31.1.0
+
+**THIS UPDATE CONTAINS ADDING SUPPORT OF [Telegram Bots API 9.5](https://core.telegram.org/bots/api-changelog#march-1-2026)**
+
+* `Core`:
+    * Added `UserTag` value class and `senderTag` field to messages
+    * Added `SetChatMemberTag` request and `UserTag` support in `PromoteChatMember` and `ChatPermissions`
+    * Added `DateTimeTextSource` for `tg://time` links support
+    * Added `DateTimeFormatPart` and `TgDateTimeFormatBuilder` for building date-time format strings
+    * Added `UnitFromBooleanSerializer`
+* `API`:
+    * Added `setChatMemberTag` extensions
+* `Utils`:
+    * Added `dateTime` and `dateTimeln` extensions to `EntitiesBuilder`
+    * Added `dateTimeMarkdown`, `dateTimeMarkdownV2`, and `dateTimeHTML` string formatting extensions
+    * Regenerated class casts extensions
+* `WebApps`:
+    * Added `iconCustomEmojiId` support to `BottomButton` and `BottomButtonParams`
+
+## 31.0.1
+
+* `Core`:
+    * In `StarTransaction` property `nanostarAmount` become nullable
+
+## 31.0.0
+
+**THIS UPDATE CONTAINS ADDING SUPPORT OF [Telegram Bots API 9.3](https://core.telegram.org/bots/api-changelog#december-31-2025)**
+
+**THIS UPDATE CONTAINS ADDING SUPPORT OF [Telegram Bots API 9.4](https://core.telegram.org/bots/api-changelog#february-9-2026)**
+
+**THIS UPDATE CONTAINS BREAKING CHANGES**
+
+* `Version`:
+    * `MicroUtils`: `0.26.8` -> `0.26.9`
+* `Core`:
+    * **THIS IS BREAKING CHANGE** All media files with sizes changed type of `fileSize` field from `Long` to `FileSize` (value class)
+    * **THIS IS BREAKING CHANGE** Class `GiftSentOrReceived` have been renamed to `GiftSentOrReceivedEvent` to clarify naming
+    * **THIS IS BREAKING CHANGE** New interface `OwnedGift` have been created
+      * **THIS IS BREAKING CHANGE** `OwnedGifts` have changed its generic type to `OwnedGift`
+    * **THIS IS BREAKING CHANGE** For `CheclistTask` have been made several changes:
+      * `ChecklistTask.Done` -> `ChecklistTask.Completed`
+      * `ChecklistTask.Undone` -> `ChecklistTask.Uncompleted`
+      * Added several inheritors of `ChecklistTask.Completed` - for completed by chat, by user or just completed tasks
+    * **THIS IS BREAKING CHANGE** `PrivateChat.id` type changed from `UserId` to `IdChatIdentifier`
+    * **THIS IS BREAKING CHANGE** `ForumChat` no longer extends `SupergroupChat`; new `SupergroupForumChat` interface created for supergroup forums
+    * **THIS IS BREAKING CHANGE** Added `PrivateForumChat` and `PrivateUserChat` interfaces to support private forums
+    * Added support of private forums (`ExtendedPrivateForumChatImpl`, `PrivateForumContentMessage`, `PrivateForumEventMessage`)
+    * Added `ChatOwnerChanged` and `ChatOwnerLeft` chat events
+    * Added `SetMyProfilePhoto` and `RemoveMyProfilePhoto` requests
+    * Added `GetUserProfileAudios` request and `UserProfileAudios` type
+    * Added `GetChatGifts` and `GetUserGifts` requests
+    * Added `RepostStory` request
+    * Added `SendMessageDraft` request with `DraftId` and `DraftIdAllocator`
+    * Added `KeyboardButtonStyle` support and `iconCustomEmojiId` field to keyboard buttons
+    * Added `style` and `iconCustomEmojiId` fields to `InlineKeyboardButton`
+    * Added `VideoCodec` and `VideoQuality` types
+    * Added `Rarity`, `GiftBackground`, `UniqueGiftName`, and `UniqueGiftColors` types for gifts
+    * Added new fields to `Gift.Regular`: `personalTotalCount`, `personalRemainingCount`, `isPremium`, `hasColors`, `background`, `uniqueGiftVariantCount`
+    * Added `isBurned` field support in `GiftSentOrReceivedEvent`
+    * Added `UserRating` type and `rating` field to `ExtendedPrivateChat`
+    * Added `Level` and `Rating` value classes
+    * Added `uniqueGiftColors` field to extended chats (channel, group, private)
+    * Added `paidMessageStarCount` field to `ExtendedGroupChat` and `ExtendedPrivateChat`
+    * Added `firstProfileAudio` field to `ExtendedPrivateChat`
+    * Added `purchased_paid_media` to updates list
+    * Added `effectId` support in `CopyMessage` and `ForwardMessage`
+    * Added `WithOptionalPaidMessageStarCount` interface
+    * Fixed serialization of `SimpleKeyboardButton`
+    * Fixed support of `paidMessageStarCount`
+* `API`:
+    * Added extensions for `SetMyProfilePhoto`, `RemoveMyProfilePhoto`, `GetUserProfileAudios`
+    * Added extensions for `GetChatGifts` and `GetUserGifts`
+    * Added extensions for `RepostStory`
+    * Added extensions for `SendMessageDraft`
+    * Added `effectId` parameter to `copyMessage` and `forwardMessage` extensions
+    * Added `GetBusinessAccountGifts` extensions improvements
+* `BehaviourBuilder`:
+    * Updated event triggers for new chat events (`ChatOwnerChanged`, `ChatOwnerLeft`, private forum events)
+    * Updated expectations for new event types
+* `Utils`:
+    * Regenerated class casts extensions
+    * Updated `InlineKeyboardBuilder` and `ReplyKeyboardBuilder` with `style` and `iconCustomEmojiId` support
+
+## 30.0.2
+
+* `Version`:
+    * `Kotlin`: `2.2.20` -> `2.2.21`
+    * `Ktor`: `3.3.1` -> `3.3.2`
+    * `KSP`: `2.2.20-2.0.4` -> `2.3.2`
+    * `MicroUtils`: `0.26.6` -> `0.26.8`
+    * `KSLog`: `1.5.1` -> `1.5.2`
+* `Core`:
+    * Allow to use `SetWebhook` with `maxAllowedConnections` up to `100000` (fix of [#1019](https://github.com/InsanusMokrassar/ktgbotapi/issues/1019))
+* `KSP`:
+    * Fixed annotation property access for KSP2 compatibility using `withNoSuchElementWorkaround`
+    * Removed `ksp.useKSP2=false` workaround from `gradle.properties` (KSP2 is now properly supported)
+* `Utils`:
+    * Regenerated class casts extensions
+    * Allow to use custom `GetUpdates` in `longPollingFlow`
+
+## 30.0.1
+
+* `Core`:
+  * Potential fix of [#989](https://github.com/InsanusMokrassar/ktgbotapi/issues/989) by:
+    * In long polling have been added check for causing by unresolved address exception
+    * Add `TelegramBotPipelinesHandler.onRequestExceptionInLimiter` which will be triggered in ANY exception during
+    request execution
+
+## 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**
+
+* `Version`:
+  * `Kotlin`: `1.9.21` -> `1.9.22`
+  * `MicroUtils`: `0.20.19` -> `0.20.23`
+
+## 9.4.2
+
+* `Version`:
+  * `Serialization`: `1.6.1` -> `1.6.2`
+  * `Ktor`: `2.3.6` -> `2.3.7`
+  * `MicroUtils`: `0.20.15` -> `0.20.19`
+  * `UUID`: `0.8.1` -> `0.8.2`
+
+## 9.4.1
+
+* Replace warning about two bots from `LongPolling` to `DefaultKtorRequestsExecutor`
+
+## 9.4.0
+
+* `Version`:
+  * `Kotlin`: `1.9.20` -> `1.9.21`
+  * `Serialization`: `1.6.0` -> `1.6.1`
+  * `Ktor`: `2.3.5` -> `2.3.6`
+  * `MicroUtils`: `0.20.12` -> `0.20.15`
+
+## 9.3.0
+
+This release become possible thanks to [Anton Lakotka](https://youtrack.jetbrains.com/users/anton.lakotka)
+
+**THIS RELEASE CONTAINS UPDATES UP TO RELEASE CANDIDATES VERSIONS**
+
+**UPDATE MAY HAVE BREAKING CHANGES**
+
+**SINCE THIS UPDATE IT WILL BE REQUIRED TO USE JDK 17+ FOR DEVELOPMENT**
+
+* `Version`:
+  * `Kotlin`: `1.8.22` -> `1.9.20`
+  * `Serialization`: `1.5.1` -> `1.6.0`
+  * `KorLibs`: `4.0.3` -> `4.0.10`
+  * `UUID`: `0.7.1` -> `0.8.1`
+  * `Ktor`: `2.3.4` -> `2.3.5`
+  * `MicroUtils`: `0.19.9` -> `0.20.12`
+
+## 9.2.4
+
+* `Utils`:
+  * New extensions `*.parseCommandsWithNamedArgs`
+* `BehaviourBuilder`:
+  * In expectaters and triggers of `commands` add `*WithNamedArgs` variants
+  * In expectaters and triggers of `commands` add opportunity to use custom separator
+
+## 9.2.3
+
+* `Core`:
+  * Fix in `VoiceContent#createResend`
+
+## 9.2.2
+
+* `Core`:
+  * Fix of [#793](https://github.com/InsanusMokrassar/ktgbotapi/issues/793): Add `PreviewChat`
+
+## 9.2.1
+
+* `Version`:
+  * `Ktor`: `2.3.3` -> `2.3.4`
+* `Core`:
+  * All `ChatMember` inheritors have fixes `status` field
+
+## 9.2.0
+
+**Add support of [Telegram Bots API 6.9](https://core.telegram.org/bots/api-changelog#september-22-2023)**
+
+* Rename `ChatAdministratorRightsImpl` -> `ChatCommonAdministratorRights`
+* All the request chat keyboards has changed their parameters `ChatAdministratorRights` to `ChatCommonAdministratorRights`
+
+## 9.1.2
+
+* `Core`:
+  * Fix of `MessageContent` serialization
+
 ## 9.1.1
 
 * `Core`:

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.8-blue)](https://core.telegram.org/bots/api-changelog#august-18-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-10.1-blue)](https://core.telegram.org/bots/api-changelog#june-11-2026)
 
 |          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

agents/HELPERS.md

@@ -0,0 +1,62 @@
+FOLLOW COMMON CODE STYLE. DO NOT COMMIT OR PUSH ANY CHANGES IF PROMPT DO NOT CONTAINS DIRECT INSTRUCTION ABOUT IT. FOLLOW LINKS TO SEE DOCUMENTATION IN THE PROMPT. IF YOU ARE NOT ABLE TO FOLLOW LINK (DO NOT SEE CONTENT YOU NEED TO FOLLOW PROMPT) - ASK OPERATOR
+
+---
+
+`@Warning` package is `dev.inmo.micro_utils.common.Warning`. Its signature: `Warning(val message: String)`
+
+---
+
+If you have edited some constructor or function signature - you MUST update documentation accordingly AND all calls of this constructor/function. THIS RULE WORKS RECURSIVELY
+
+---
+
+Before any laucnhing of `compileKotlinJvm` or other building procedure which must confirm that build is working, you MUST launch two tasks: `./gradlew kspCommonMainKotlinMetadata` and `./gradlew apiDump`. Order is important. They must be launched sequentially.
+
+---
+
+If you are adding `Send*` request - you also must add in `API` (`tgbotapi.api`) module:
+
+* Direct indings (in `tgbitapi.api` module). As example you may look at `dev.inmo.tgbotapi.requests.send.SendTextMessage` a,d its bindings `dev.inmo.tgbotapi.extensions.api.send.sendTextMessage`
+* Bindings in [Sends.kt](../tgbotapi.api/src/commonMain/kotlin/dev/inmo/tgbotapi/extensions/api/send/Sends.kt)
+* Bindings in [Replies.kt](../tgbotapi.api/src/commonMain/kotlin/dev/inmo/tgbotapi/extensions/api/send/Replies.kt)
+* Bindings in [RepliesWithChatsAndMessages.kt](../tgbotapi.api/src/commonMain/kotlin/dev/inmo/tgbotapi/extensions/api/send/RepliesWithChatsAndMessages.kt)
+
+---
+
+When you need to fill a changelog, you must follow the common changelog style:
+
+```markdown
+## 34.0.0 // number of version
+* `Core`:
+    * // list of changes
+* `Utils`:
+    * // list of changes
+* `API`:
+    * // list of changes
+* `BehaviourBuilder`:
+    * // list of changes
+* `WebApps`:
+    * // list of changes
+* `BehaviourBuilderWithFSM`:
+    * // list of changes
+// etc...
+```
+
+Each section can be ommited if there are no any changes in the section. In case of filling some known telegram bots api changelog part - you may add previx with its title in point with change. For example:
+
+```markdown
+* `Core`:
+    * (`Guest mode`) // change data
+```
+
+---
+
+When a property (or method) can be declared on an interface/class and implemented by each inheritor - it MUST be declared there and overridden per implementation. DO NOT implement such behaviour as a common extension property/function that dispatches with a `when (this)` over every subtype: those branches silently drift out of sync when new subtypes are added and are not part of the type contract. If a part of the implementation is reused across several inheritors, keep that part in a shared helper (a companion-object function of the owner, or an `internal` top-level function for logic shared between different types) and let the overrides reuse it.
+
+---
+
+All work MUST be performed in the normal (main) working worktree of the repository. DO NOT create or do the work inside a separate worktree (for example `.claude/worktrees/...`): commits made there leave the main checkout behind and force an extra fast-forward/pull to land the changes. If some environment forces an isolated worktree, fast-forward the main branch onto those commits and continue in the main worktree.
+
+---
+
+When a prompt contains a list of several subtasks, run each subtask as its own subagent (one subagent per subtask) instead of doing all of them inline in the main thread.

build.gradle

@@ -1,8 +1,8 @@
 buildscript {
     repositories {
-        mavenLocal()
         mavenCentral()
         maven { url "https://plugins.gradle.org/m2/" }
+        mavenLocal()
     }
 
     dependencies {
@@ -16,18 +16,40 @@ buildscript {
 
 plugins {
     alias(libs.plugins.kotlin.dokka)
+    alias(libs.plugins.versions)
+    alias(libs.plugins.validator)
+    alias(libs.plugins.nmcp.aggregation)
+}
+
+// docs is a dokka-only aggregator module, exclude it from binary compatibility validation
+apiValidation {
+    ignoredProjects += ["docs"]
+}
+
+
+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://git.inmo.dev/api/packages/InsanusMokrassar/maven" }
+        maven { url "https://nexus.inmo.dev/repository/maven-releases/" }
+        mavenLocal()
     }
     if (it != rootProject.findProject("docs")) {
-        tasks.whenTaskAdded { task ->
+        tasks.configureEach { task ->
             if(task.name == "jsLegacyBrowserTest" || task.name == "jsLegacyNodeTest") {
                 task.enabled = false
             }
@@ -37,29 +59,33 @@ allprojects {
 apply from: "./extensions.gradle"
 
 private String getCurrentVersionChangelog() {
-    OutputStream changelogDataOS = new ByteArrayOutputStream()
-    exec {
-        standardOutput = changelogDataOS
+    return providers.exec {
         commandLine './changelog_info_retriever', "$library_version", 'CHANGELOG.md'
-    }
-
-    return changelogDataOS.toString().trim()
+    }.standardOutput.asText.get().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 {
@@ -39,14 +39,10 @@ private List<SourceDirectorySet> findSourcesWithName(String... approximateNames)
             }.collect { it.kotlin }
 }
 
-Object callback = {
-    switch (true) {
-        case project.hasProperty("DOKKA_PATH"):
-            outputDirectory = project.property("DOKKA_PATH").toString()
-            break
-        case System.getenv("DOKKA_PATH") != null:
-            outputDirectory = System.getenv("DOKKA_PATH")
-            break
+dokka {
+    // aggregating every module's sources into one publication needs more heap than the worker default
+    dokkaGeneratorIsolation = ProcessIsolation {
+        it.maxHeapSize.set("4g")
     }
 
     dokkaSourceSets {
@@ -54,8 +50,8 @@ Object callback = {
             skipDeprecated.set(true)
 
             sourceLink {
-                localDirectory.set(file("./"))
-                remoteUrl.set(new URL("https://github.com/InsanusMokrassar/TelegramBotAPI/blob/master/"))
+                localDirectory.set(file("../"))
+                remoteUrl.set(new URI("https://github.com/InsanusMokrassar/ktgbotapi"))
                 remoteLineSuffix.set("#L")
             }
         }
@@ -73,6 +69,3 @@ Object callback = {
         }
     }
 }
-
-tasks.dokkaGfm(callback)
-tasks.dokkaHtml(callback)

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

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

gradle/libs.versions.toml

@@ -1,22 +1,28 @@
 [versions]
 
-kotlin = "1.8.22"
-kotlin-serialization = "1.5.1"
-kotlin-coroutines = "1.7.3"
+kotlin = "2.3.21"
+kotlin-serialization = "1.11.0"
+kotlin-coroutines = "1.11.0"
 
 javax-activation = "1.1.1"
 
-korlibs = "4.0.3"
-uuid = "0.7.1"
-ktor = "2.3.3"
+korlibs = "5.4.0"
+uuid = "0.8.4"
+ktor = "3.5.1"
 
-ksp = "1.8.22-1.0.11"
-kotlin-poet = "1.14.2"
+ksp = "2.3.9"
+kotlin-poet = "2.3.0"
 
-microutils = "0.19.9"
+microutils = "0.30.0"
+kslog = "1.6.1"
 
-github-release-plugin = "2.4.1"
-dokka = "1.8.20"
+versions = "0.54.0"
+
+github-release-plugin = "2.5.2"
+dokka = "2.2.0"
+
+validator = "0.18.1"
+nmcp = "1.6.0"
 
 [libraries]
 
@@ -31,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" }
@@ -38,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" }
@@ -51,6 +60,13 @@ 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" }
 
 # ksp dependencies
 
@@ -71,3 +87,6 @@ kotlin-jvm = { id = "org.jetbrains.kotlin.jvm", version.ref = "kotlin" }
 kotlin-multiplatform = { id = "org.jetbrains.kotlin.multiplatform", version.ref = "kotlin" }
 kotlin-serialization = { id = "org.jetbrains.kotlin.plugin.serialization", version.ref = "kotlin" }
 kotlin-dokka = { id = "org.jetbrains.dokka", version.ref = "dokka" }
+versions = { id = "com.github.ben-manes.versions", version.ref = "versions" }
+validator = { id = "org.jetbrains.kotlinx.binary-compatibility-validator", version.ref = "validator" }
+nmcp-aggregation = { id = "com.gradleup.nmcp.aggregation", version.ref = "nmcp" }

gradle/templates/mppJsProject.gradle

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

gradle/templates/mppProjectWithSerialization.gradle

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

gradle/templates/mpp_publish.gradle

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

gradle/templates/mpp_publish.kpsb

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

gradle/wrapper/gradle-wrapper.properties

@@ -1,5 +1,7 @@
 distributionBase=GRADLE_USER_HOME
 distributionPath=wrapper/dists
+distributionUrl=https\://services.gradle.org/distributions/gradle-9.6.1-bin.zip
+networkTimeout=10000
+validateDistributionUrl=true
 zipStoreBase=GRADLE_USER_HOME
 zipStorePath=wrapper/dists
-distributionUrl=https\://services.gradle.org/distributions/gradle-7.6.2-bin.zip

gradlew

@@ -1,78 +1,129 @@
-#!/usr/bin/env sh
+#!/bin/sh
+
+#
+# Copyright © 2015-2021 the original authors.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+# SPDX-License-Identifier: Apache-2.0
+#
 
 ##############################################################################
-##
-##  Gradle start up script for UN*X
-##
+#
+#   Gradle start up script for POSIX generated by Gradle.
+#
+#   Important for running:
+#
+#   (1) You need a POSIX-compliant shell to run this script. If your /bin/sh is
+#       noncompliant, but you have some other compliant shell such as ksh or
+#       bash, then to run this script, type that shell name before the whole
+#       command line, like:
+#
+#           ksh Gradle
+#
+#       Busybox and similar reduced shells will NOT work, because this script
+#       requires all of these POSIX shell features:
+#         * functions;
+#         * expansions «$var», «${var}», «${var:-default}», «${var+SET}»,
+#           «${var#prefix}», «${var%suffix}», and «$( cmd )»;
+#         * compound commands having a testable exit status, especially «case»;
+#         * various built-in commands including «command», «set», and «ulimit».
+#
+#   Important for patching:
+#
+#   (2) This script targets any POSIX shell, so it avoids extensions provided
+#       by Bash, Ksh, etc; in particular arrays are avoided.
+#
+#       The "traditional" practice of packing multiple parameters into a
+#       space-separated string is a well documented source of bugs and security
+#       problems, so this is (mostly) avoided, by progressively accumulating
+#       options in "$@", and eventually passing that to Java.
+#
+#       Where the inherited environment variables (DEFAULT_JVM_OPTS, JAVA_OPTS,
+#       and GRADLE_OPTS) rely on word-splitting, this is performed explicitly;
+#       see the in-line comments for details.
+#
+#       There are tweaks for specific operating systems such as AIX, CygWin,
+#       Darwin, MinGW, and NonStop.
+#
+#   (3) This script is generated from the Groovy template
+#       https://github.com/gradle/gradle/blob/HEAD/platforms/jvm/plugins-application/src/main/resources/org/gradle/api/internal/plugins/unixStartScript.txt
+#       within the Gradle project.
+#
+#       You can find Gradle at https://github.com/gradle/gradle/.
+#
 ##############################################################################
 
 # Attempt to set APP_HOME
+
 # Resolve links: $0 may be a link
-PRG="$0"
-# Need this for relative symlinks.
-while [ -h "$PRG" ] ; do
-    ls=`ls -ld "$PRG"`
-    link=`expr "$ls" : '.*-> \(.*\)$'`
-    if expr "$link" : '/.*' > /dev/null; then
-        PRG="$link"
-    else
-        PRG=`dirname "$PRG"`"/$link"
-    fi
+app_path=$0
+
+# Need this for daisy-chained symlinks.
+while
+    APP_HOME=${app_path%"${app_path##*/}"}  # leaves a trailing /; empty if no leading path
+    [ -h "$app_path" ]
+do
+    ls=$( ls -ld "$app_path" )
+    link=${ls#*' -> '}
+    case $link in             #(
+      /*)   app_path=$link ;; #(
+      *)    app_path=$APP_HOME$link ;;
+    esac
 done
-SAVED="`pwd`"
-cd "`dirname \"$PRG\"`/" >/dev/null
-APP_HOME="`pwd -P`"
-cd "$SAVED" >/dev/null
 
-APP_NAME="Gradle"
-APP_BASE_NAME=`basename "$0"`
-
-# Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script.
-DEFAULT_JVM_OPTS=""
+# This is normally unused
+# shellcheck disable=SC2034
+APP_BASE_NAME=${0##*/}
+# Discard cd standard output in case $CDPATH is set (https://github.com/gradle/gradle/issues/25036)
+APP_HOME=$( cd -P "${APP_HOME:-./}" > /dev/null && printf '%s\n' "$PWD" ) || exit
 
 # Use the maximum available, or set MAX_FD != -1 to use that value.
-MAX_FD="maximum"
+MAX_FD=maximum
 
-warn ( ) {
+warn () {
     echo "$*"
-}
+} >&2
 
-die ( ) {
+die () {
     echo
     echo "$*"
     echo
     exit 1
-}
+} >&2
 
 # OS specific support (must be 'true' or 'false').
 cygwin=false
 msys=false
 darwin=false
 nonstop=false
-case "`uname`" in
-  CYGWIN* )
-    cygwin=true
-    ;;
-  Darwin* )
-    darwin=true
-    ;;
-  MINGW* )
-    msys=true
-    ;;
-  NONSTOP* )
-    nonstop=true
-    ;;
+case "$( uname )" in                #(
+  CYGWIN* )         cygwin=true  ;; #(
+  Darwin* )         darwin=true  ;; #(
+  MSYS* | MINGW* )  msys=true    ;; #(
+  NONSTOP* )        nonstop=true ;;
 esac
 
 CLASSPATH=$APP_HOME/gradle/wrapper/gradle-wrapper.jar
 
+
 # Determine the Java command to use to start the JVM.
 if [ -n "$JAVA_HOME" ] ; then
     if [ -x "$JAVA_HOME/jre/sh/java" ] ; then
         # IBM's JDK on AIX uses strange locations for the executables
-        JAVACMD="$JAVA_HOME/jre/sh/java"
+        JAVACMD=$JAVA_HOME/jre/sh/java
     else
-        JAVACMD="$JAVA_HOME/bin/java"
+        JAVACMD=$JAVA_HOME/bin/java
     fi
     if [ ! -x "$JAVACMD" ] ; then
         die "ERROR: JAVA_HOME is set to an invalid directory: $JAVA_HOME
@@ -81,92 +132,120 @@ Please set the JAVA_HOME variable in your environment to match the
 location of your Java installation."
     fi
 else
-    JAVACMD="java"
-    which java >/dev/null 2>&1 || die "ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH.
+    JAVACMD=java
+    if ! command -v java >/dev/null 2>&1
+    then
+        die "ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH.
 
 Please set the JAVA_HOME variable in your environment to match the
 location of your Java installation."
+    fi
 fi
 
 # Increase the maximum file descriptors if we can.
-if [ "$cygwin" = "false" -a "$darwin" = "false" -a "$nonstop" = "false" ] ; then
-    MAX_FD_LIMIT=`ulimit -H -n`
-    if [ $? -eq 0 ] ; then
-        if [ "$MAX_FD" = "maximum" -o "$MAX_FD" = "max" ] ; then
-            MAX_FD="$MAX_FD_LIMIT"
-        fi
-        ulimit -n $MAX_FD
-        if [ $? -ne 0 ] ; then
-            warn "Could not set maximum file descriptor limit: $MAX_FD"
-        fi
-    else
-        warn "Could not query maximum file descriptor limit: $MAX_FD_LIMIT"
-    fi
-fi
-
-# For Darwin, add options to specify how the application appears in the dock
-if $darwin; then
-    GRADLE_OPTS="$GRADLE_OPTS \"-Xdock:name=$APP_NAME\" \"-Xdock:icon=$APP_HOME/media/gradle.icns\""
-fi
-
-# For Cygwin, switch paths to Windows format before running java
-if $cygwin ; then
-    APP_HOME=`cygpath --path --mixed "$APP_HOME"`
-    CLASSPATH=`cygpath --path --mixed "$CLASSPATH"`
-    JAVACMD=`cygpath --unix "$JAVACMD"`
-
-    # We build the pattern for arguments to be converted via cygpath
-    ROOTDIRSRAW=`find -L / -maxdepth 1 -mindepth 1 -type d 2>/dev/null`
-    SEP=""
-    for dir in $ROOTDIRSRAW ; do
-        ROOTDIRS="$ROOTDIRS$SEP$dir"
-        SEP="|"
-    done
-    OURCYGPATTERN="(^($ROOTDIRS))"
-    # Add a user-defined pattern to the cygpath arguments
-    if [ "$GRADLE_CYGPATTERN" != "" ] ; then
-        OURCYGPATTERN="$OURCYGPATTERN|($GRADLE_CYGPATTERN)"
-    fi
-    # Now convert the arguments - kludge to limit ourselves to /bin/sh
-    i=0
-    for arg in "$@" ; do
-        CHECK=`echo "$arg"|egrep -c "$OURCYGPATTERN" -`
-        CHECK2=`echo "$arg"|egrep -c "^-"`                                 ### Determine if an option
-
-        if [ $CHECK -ne 0 ] && [ $CHECK2 -eq 0 ] ; then                    ### Added a condition
-            eval `echo args$i`=`cygpath --path --ignore --mixed "$arg"`
-        else
-            eval `echo args$i`="\"$arg\""
-        fi
-        i=$((i+1))
-    done
-    case $i in
-        (0) set -- ;;
-        (1) set -- "$args0" ;;
-        (2) set -- "$args0" "$args1" ;;
-        (3) set -- "$args0" "$args1" "$args2" ;;
-        (4) set -- "$args0" "$args1" "$args2" "$args3" ;;
-        (5) set -- "$args0" "$args1" "$args2" "$args3" "$args4" ;;
-        (6) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" ;;
-        (7) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" ;;
-        (8) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" "$args7" ;;
-        (9) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" "$args7" "$args8" ;;
+if ! "$cygwin" && ! "$darwin" && ! "$nonstop" ; then
+    case $MAX_FD in #(
+      max*)
+        # In POSIX sh, ulimit -H is undefined. That's why the result is checked to see if it worked.
+        # shellcheck disable=SC2039,SC3045
+        MAX_FD=$( ulimit -H -n ) ||
+            warn "Could not query maximum file descriptor limit"
+    esac
+    case $MAX_FD in  #(
+      '' | soft) :;; #(
+      *)
+        # In POSIX sh, ulimit -n is undefined. That's why the result is checked to see if it worked.
+        # shellcheck disable=SC2039,SC3045
+        ulimit -n "$MAX_FD" ||
+            warn "Could not set maximum file descriptor limit to $MAX_FD"
     esac
 fi
 
-# Escape application args
-save ( ) {
-    for i do printf %s\\n "$i" | sed "s/'/'\\\\''/g;1s/^/'/;\$s/\$/' \\\\/" ; done
-    echo " "
-}
-APP_ARGS=$(save "$@")
+# Collect all arguments for the java command, stacking in reverse order:
+#   * args from the command line
+#   * the main class name
+#   * -classpath
+#   * -D...appname settings
+#   * --module-path (only if needed)
+#   * DEFAULT_JVM_OPTS, JAVA_OPTS, and GRADLE_OPTS environment variables.
 
-# Collect all arguments for the java command, following the shell quoting and substitution rules
-eval set -- $DEFAULT_JVM_OPTS $JAVA_OPTS $GRADLE_OPTS "\"-Dorg.gradle.appname=$APP_BASE_NAME\"" -classpath "\"$CLASSPATH\"" org.gradle.wrapper.GradleWrapperMain "$APP_ARGS"
+# For Cygwin or MSYS, switch paths to Windows format before running java
+if "$cygwin" || "$msys" ; then
+    APP_HOME=$( cygpath --path --mixed "$APP_HOME" )
+    CLASSPATH=$( cygpath --path --mixed "$CLASSPATH" )
 
-# by default we should be in the correct project dir, but when run from Finder on Mac, the cwd is wrong
-if [ "$(uname)" = "Darwin" ] && [ "$HOME" = "$PWD" ]; then
-  cd "$(dirname "$0")"
+    JAVACMD=$( cygpath --unix "$JAVACMD" )
+
+    # Now convert the arguments - kludge to limit ourselves to /bin/sh
+    for arg do
+        if
+            case $arg in                                #(
+              -*)   false ;;                            # don't mess with options #(
+              /?*)  t=${arg#/} t=/${t%%/*}              # looks like a POSIX filepath
+                    [ -e "$t" ] ;;                      #(
+              *)    false ;;
+            esac
+        then
+            arg=$( cygpath --path --ignore --mixed "$arg" )
+        fi
+        # Roll the args list around exactly as many times as the number of
+        # args, so each arg winds up back in the position where it started, but
+        # possibly modified.
+        #
+        # NB: a `for` loop captures its iteration list before it begins, so
+        # changing the positional parameters here affects neither the number of
+        # iterations, nor the values presented in `arg`.
+        shift                   # remove old arg
+        set -- "$@" "$arg"      # push replacement arg
+    done
 fi
 
+
+# Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script.
+DEFAULT_JVM_OPTS='"-Xmx64m" "-Xms64m"'
+
+# Collect all arguments for the java command:
+#   * DEFAULT_JVM_OPTS, JAVA_OPTS, and optsEnvironmentVar are not allowed to contain shell fragments,
+#     and any embedded shellness will be escaped.
+#   * For example: A user cannot expect ${Hostname} to be expanded, as it is an environment variable and will be
+#     treated as '${Hostname}' itself on the command line.
+
+set -- \
+        "-Dorg.gradle.appname=$APP_BASE_NAME" \
+        -classpath "$CLASSPATH" \
+        org.gradle.wrapper.GradleWrapperMain \
+        "$@"
+
+# Stop when "xargs" is not available.
+if ! command -v xargs >/dev/null 2>&1
+then
+    die "xargs is not available"
+fi
+
+# Use "xargs" to parse quoted args.
+#
+# With -n1 it outputs one arg per line, with the quotes and backslashes removed.
+#
+# In Bash we could simply go:
+#
+#   readarray ARGS < <( xargs -n1 <<<"$var" ) &&
+#   set -- "${ARGS[@]}" "$@"
+#
+# but POSIX shell has neither arrays nor command substitution, so instead we
+# post-process each arg (as a line of input to sed) to backslash-escape any
+# character that might be a shell metacharacter, then use eval to reverse
+# that process (while maintaining the separation between arguments), and wrap
+# the whole thing up as a single "set" statement.
+#
+# This will of course break if any of these variables contains a newline or
+# an unmatched quote.
+#
+
+eval "set -- $(
+        printf '%s\n' "$DEFAULT_JVM_OPTS $JAVA_OPTS $GRADLE_OPTS" |
+        xargs -n1 |
+        sed ' s~[^-[:alnum:]+,./:=@_]~\\&~g; ' |
+        tr '\n' ' '
+    )" '"$@"'
+
 exec "$JAVACMD" "$@"

gradlew.bat

@@ -1,4 +1,22 @@
-@if "%DEBUG%" == "" @echo off
+@rem
+@rem Copyright 2015 the original author or authors.
+@rem
+@rem Licensed under the Apache License, Version 2.0 (the "License");
+@rem you may not use this file except in compliance with the License.
+@rem You may obtain a copy of the License at
+@rem
+@rem      https://www.apache.org/licenses/LICENSE-2.0
+@rem
+@rem Unless required by applicable law or agreed to in writing, software
+@rem distributed under the License is distributed on an "AS IS" BASIS,
+@rem WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+@rem See the License for the specific language governing permissions and
+@rem limitations under the License.
+@rem
+@rem SPDX-License-Identifier: Apache-2.0
+@rem
+
+@if "%DEBUG%"=="" @echo off
 @rem ##########################################################################
 @rem
 @rem  Gradle startup script for Windows
@@ -9,25 +27,29 @@
 if "%OS%"=="Windows_NT" setlocal
 
 set DIRNAME=%~dp0
-if "%DIRNAME%" == "" set DIRNAME=.
+if "%DIRNAME%"=="" set DIRNAME=.
+@rem This is normally unused
 set APP_BASE_NAME=%~n0
 set APP_HOME=%DIRNAME%
 
+@rem Resolve any "." and ".." in APP_HOME to make it shorter.
+for %%i in ("%APP_HOME%") do set APP_HOME=%%~fi
+
 @rem Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script.
-set DEFAULT_JVM_OPTS=
+set DEFAULT_JVM_OPTS="-Xmx64m" "-Xms64m"
 
 @rem Find java.exe
 if defined JAVA_HOME goto findJavaFromJavaHome
 
 set JAVA_EXE=java.exe
 %JAVA_EXE% -version >NUL 2>&1
-if "%ERRORLEVEL%" == "0" goto init
+if %ERRORLEVEL% equ 0 goto execute
 
-echo.
-echo ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH.
-echo.
-echo Please set the JAVA_HOME variable in your environment to match the
-echo location of your Java installation.
+echo. 1>&2
+echo ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH. 1>&2
+echo. 1>&2
+echo Please set the JAVA_HOME variable in your environment to match the 1>&2
+echo location of your Java installation. 1>&2
 
 goto fail
 
@@ -35,48 +57,36 @@ goto fail
 set JAVA_HOME=%JAVA_HOME:"=%
 set JAVA_EXE=%JAVA_HOME%/bin/java.exe
 
-if exist "%JAVA_EXE%" goto init
+if exist "%JAVA_EXE%" goto execute
 
-echo.
-echo ERROR: JAVA_HOME is set to an invalid directory: %JAVA_HOME%
-echo.
-echo Please set the JAVA_HOME variable in your environment to match the
-echo location of your Java installation.
+echo. 1>&2
+echo ERROR: JAVA_HOME is set to an invalid directory: %JAVA_HOME% 1>&2
+echo. 1>&2
+echo Please set the JAVA_HOME variable in your environment to match the 1>&2
+echo location of your Java installation. 1>&2
 
 goto fail
 
-:init
-@rem Get command-line arguments, handling Windows variants
-
-if not "%OS%" == "Windows_NT" goto win9xME_args
-
-:win9xME_args
-@rem Slurp the command line arguments.
-set CMD_LINE_ARGS=
-set _SKIP=2
-
-:win9xME_args_slurp
-if "x%~1" == "x" goto execute
-
-set CMD_LINE_ARGS=%*
-
 :execute
 @rem Setup the command line
 
 set CLASSPATH=%APP_HOME%\gradle\wrapper\gradle-wrapper.jar
 
+
 @rem Execute Gradle
-"%JAVA_EXE%" %DEFAULT_JVM_OPTS% %JAVA_OPTS% %GRADLE_OPTS% "-Dorg.gradle.appname=%APP_BASE_NAME%" -classpath "%CLASSPATH%" org.gradle.wrapper.GradleWrapperMain %CMD_LINE_ARGS%
+"%JAVA_EXE%" %DEFAULT_JVM_OPTS% %JAVA_OPTS% %GRADLE_OPTS% "-Dorg.gradle.appname=%APP_BASE_NAME%" -classpath "%CLASSPATH%" org.gradle.wrapper.GradleWrapperMain %*
 
 :end
 @rem End local scope for the variables with windows NT shell
-if "%ERRORLEVEL%"=="0" goto mainEnd
+if %ERRORLEVEL% equ 0 goto mainEnd
 
 :fail
 rem Set variable GRADLE_EXIT_CONSOLE if you need the _script_ return code instead of
 rem the _cmd.exe /c_ return code!
-if  not "" == "%GRADLE_EXIT_CONSOLE%" exit 1
-exit /b 1
+set EXIT_CODE=%ERRORLEVEL%
+if %EXIT_CODE% equ 0 set EXIT_CODE=1
+if not ""=="%GRADLE_EXIT_CONSOLE%" exit %EXIT_CODE%
+exit /b %EXIT_CODE%
 
 :mainEnd
 if "%OS%"=="Windows_NT" endlocal

publish.gradle

@@ -1,100 +0,0 @@
-apply plugin: 'maven-publish'
-
-task javadocsJar(type: Jar) {
-    archiveClassifier.convention("javadoc")
-    archiveClassifier.set("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('GITEA_TOKEN') || System.getenv('GITEA_TOKEN') != null) {
-                maven {
-                    name = "Gitea"
-                    url = uri("https://git.inmo.dev/api/packages/InsanusMokrassar/maven")
-
-                    credentials(HttpHeaderCredentials) {
-                        name = "Authorization"
-                        value = project.hasProperty('GITEA_TOKEN') ? project.property('GITEA_TOKEN') : System.getenv('GITEA_TOKEN')
-                    }
-
-                    authentication {
-                        header(HttpHeaderAuthentication)
-                    }
-
-                }
-            }
-            if ((project.hasProperty('SONATYPE_USER') || System.getenv('SONATYPE_USER') != null) && (project.hasProperty('SONATYPE_PASSWORD') || System.getenv('SONATYPE_PASSWORD') != null)) {
-                maven {
-                    name = "sonatype"
-                    url = uri("https://oss.sonatype.org/service/local/staging/deploy/maven2/")
-
-                    credentials {
-                        username = project.hasProperty('SONATYPE_USER') ? project.property('SONATYPE_USER') : System.getenv('SONATYPE_USER')
-                        password = project.hasProperty('SONATYPE_PASSWORD') ? project.property('SONATYPE_PASSWORD') : System.getenv('SONATYPE_PASSWORD')
-                    }
-
-                }
-            }
-        }
-    }
-}
-
-if (project.hasProperty("signing.gnupg.keyName")) {
-    apply plugin: 'signing'
-
-    signing {
-        useGpgCmd()
-
-        sign publishing.publications
-    }
-
-    task signAll {
-        tasks.withType(Sign).forEach {
-            dependsOn(it)
-        }
-    }
-}

publish.kpsb

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

settings.gradle

@@ -1,11 +1,4 @@
 pluginManagement {
-    resolutionStrategy {
-        eachPlugin {
-            if (requested.id.id == "org.jetbrains.dokka") {
-                useModule("org.jetbrains.dokka:dokka-gradle-plugin:${requested.version}")
-            }
-        }
-    }
     repositories {
         gradlePluginPortal()
     }
@@ -19,3 +12,4 @@ include ":tgbotapi.behaviour_builder"
 include ":tgbotapi.behaviour_builder.fsm"
 include ":tgbotapi"
 include ":tgbotapi.webapps"
+include ":docs"

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(): Unit = execute(Close)

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

@@ -6,49 +6,48 @@ 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(
+): Unit = execute(
     DeleteMessage(chatId, messageId)
 )
 
-suspend fun TelegramBot.deleteMessage(
+public suspend fun TelegramBot.deleteMessage(
     chat: Chat,
     messageId: MessageId
-) = deleteMessage(chat.id, messageId)
+): Unit = deleteMessage(chat.id, messageId)
 
-suspend fun TelegramBot.deleteMessage(
-    message: Message
-): Boolean {
+public suspend fun TelegramBot.deleteMessage(
+    message: AccessibleMessage
+): Unit {
     val mediaGroupContent = ((message as? ContentMessage<*>) ?.content as? MediaGroupCollectionContent<*>)
     if (mediaGroupContent == null) {
-        return deleteMessage(message.chat, message.messageId)
+        deleteMessage(message.chat, message.messageId)
     } else {
-        return mediaGroupContent.group.map {
+        mediaGroupContent.group.forEach {
             deleteMessage(it.sourceMessage)
-        }.all { it }
+        }
     }
 }
 
-suspend fun TelegramBot.delete(
+public suspend fun TelegramBot.delete(
     chatId: ChatIdentifier,
     messageId: MessageId
-) = deleteMessage(chatId, messageId)
+): Unit = deleteMessage(chatId, messageId)
 
-suspend fun TelegramBot.delete(
+public suspend fun TelegramBot.delete(
     chat: Chat,
     messageId: MessageId
-) = deleteMessage(chat, messageId)
+): Unit = deleteMessage(chat, messageId)
 
-suspend fun TelegramBot.delete(
-    message: Message
-) = deleteMessage(message)
+public suspend fun TelegramBot.delete(
+    message: AccessibleMessage
+): Unit = deleteMessage(message)
 
-suspend fun Message.delete(
+public suspend fun AccessibleMessage.delete(
     requestsExecutor: TelegramBot
-) = requestsExecutor.deleteMessage(this)
+): Unit = 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>
+): Unit = messageIds.chunked(deleteMessagesLimit.last).forEach {
+    execute(
+        DeleteMessages(
+            chatId = chatId,
+            messageIds = it
+        )
+    )
+}
+
+public suspend fun TelegramBot.deleteMessages(
+    chatId: ChatIdentifier,
+    messageIds: Array<MessageId>
+): Unit = deleteMessages(
+    chatId = chatId,
+    messageIds = messageIds.toList()
+)
+
+public suspend fun TelegramBot.deleteMessages(
+    messagesMetas: List<Message.MetaInfo>
+): Unit = messagesMetas.groupBy { it.chatId }.forEach { (chatId, messages) ->
+    deleteMessages(
+        chatId = chatId,
+        messageIds = messages.map { it.messageId }
+    )
+}
+
+@JvmName("deleteMessagesWithMessages")
+public suspend fun TelegramBot.deleteMessages(
+    messages: List<AccessibleMessage>
+): Unit = deleteMessages(messages.map { it.metaInfo })
+
+public suspend fun TelegramBot.delete(
+    chatId: ChatIdentifier,
+    messageIds: List<MessageId>
+): Unit = deleteMessages(chatId = chatId, messageIds = messageIds)
+
+public suspend fun TelegramBot.delete(
+    chatId: ChatIdentifier,
+    messageIds: Array<MessageId>
+): Unit = deleteMessages(chatId = chatId, messageIds = messageIds)
+
+public suspend fun TelegramBot.delete(
+    messagesMetas: List<Message.MetaInfo>
+): Unit = deleteMessages(messagesMetas)
+
+@JvmName("deleteWithMessages")
+public suspend fun TelegramBot.delete(
+    messages: List<AccessibleMessage>
+): Unit = deleteMessages(messages)

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

@@ -3,62 +3,145 @@ 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.EffectId
 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)
+    protectContent: Boolean = false,
+    effectId: EffectId? = null
+): PossiblyForwardedMessage = execute(
+    ForwardMessage(
+        fromChatId = fromChatId,
+        toChatId = toChatId,
+        messageId = messageId,
+        threadId = threadId,
+        directMessageThreadId = directMessageThreadId,
+        startTimestamp = startTimestamp,
+        disableNotification = disableNotification,
+        protectContent = protectContent,
+        effectId = effectId
+    )
 )
 
-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)
+    protectContent: Boolean = false,
+    effectId: EffectId? = null
+): PossiblyForwardedMessage = forwardMessage(
+    fromChatId = fromChat.id,
+    toChatId = toChatId,
+    messageId = messageId,
+    threadId = threadId,
+    directMessageThreadId = directMessageThreadId,
+    startTimestamp = startTimestamp,
+    disableNotification = disableNotification,
+    protectContent = protectContent,
+    effectId = effectId
+)
 
-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)
+    protectContent: Boolean = false,
+    effectId: EffectId? = null
+): PossiblyForwardedMessage = forwardMessage(
+    fromChatId = fromChatId,
+    toChatId = toChat.id,
+    messageId = messageId,
+    threadId = threadId,
+    directMessageThreadId = directMessageThreadId,
+    startTimestamp = startTimestamp,
+    disableNotification = disableNotification,
+    protectContent = protectContent,
+    effectId = effectId
+)
 
-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)
+    protectContent: Boolean = false,
+    effectId: EffectId? = null
+): PossiblyForwardedMessage = forwardMessage(
+    fromChatId = fromChat.id,
+    toChatId = toChat.id,
+    messageId = messageId,
+    threadId = threadId,
+    directMessageThreadId = directMessageThreadId,
+    startTimestamp = startTimestamp,
+    disableNotification = disableNotification,
+    protectContent = protectContent,
+    effectId = effectId
+)
 
-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)
+    protectContent: Boolean = false,
+    effectId: EffectId? = null
+): PossiblyForwardedMessage = forwardMessage(
+    fromChat = message.chat,
+    toChatId = toChatId,
+    messageId = message.messageId,
+    threadId = threadId,
+    directMessageThreadId = directMessageThreadId,
+    startTimestamp = startTimestamp,
+    disableNotification = disableNotification,
+    protectContent = protectContent,
+    effectId = effectId
+)
 
-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)
+    protectContent: Boolean = false,
+    effectId: EffectId? = null
+): PossiblyForwardedMessage = forwardMessage(
+    fromChat = message.chat,
+    toChat = toChat,
+    messageId = message.messageId,
+    threadId = threadId,
+    directMessageThreadId = directMessageThreadId,
+    startTimestamp = startTimestamp,
+    disableNotification = disableNotification,
+    protectContent = protectContent,
+    effectId = effectId
+)

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/GetUserPersonalChatMessages.kt

@@ -0,0 +1,13 @@
+package dev.inmo.tgbotapi.extensions.api
+
+import dev.inmo.tgbotapi.bot.TelegramBot
+import dev.inmo.tgbotapi.requests.GetUserPersonalChatMessages
+import dev.inmo.tgbotapi.types.ChatId
+import dev.inmo.tgbotapi.types.message.abstracts.ContentMessage
+
+public suspend fun TelegramBot.getUserPersonalChatMessages(
+    userId: ChatId,
+    limit: Int
+): List<ContentMessage<*>> = execute(
+    GetUserPersonalChatMessages(userId = userId, limit = limit)
+)

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(): Unit = execute(LogOut)

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

@@ -0,0 +1,21 @@
+package dev.inmo.tgbotapi.extensions.api
+
+import dev.inmo.tgbotapi.bot.TelegramBot
+import dev.inmo.tgbotapi.requests.SavePreparedKeyboardButton
+import dev.inmo.tgbotapi.types.ChatId
+import dev.inmo.tgbotapi.types.buttons.KeyboardButton
+import dev.inmo.tgbotapi.types.buttons.PreparedKeyboardButton
+import dev.inmo.tgbotapi.types.chat.User
+import dev.inmo.tgbotapi.types.toChatId
+
+public suspend fun TelegramBot.savePreparedKeyboardButton(
+    userId: ChatId,
+    button: KeyboardButton
+): PreparedKeyboardButton = execute(
+    SavePreparedKeyboardButton(userId = userId, button = button)
+)
+
+public suspend fun TelegramBot.savePreparedKeyboardButton(
+    user: User,
+    button: KeyboardButton
+): PreparedKeyboardButton = savePreparedKeyboardButton(userId = user.id.toChatId(), button = button)

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))
+): Unit = 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)
+): Unit = 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)
+): Unit = answerCallbackQuery(callbackQuery.id, text, showAlert, url, cachedTimeSeconds)

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

@@ -0,0 +1,17 @@
+package dev.inmo.tgbotapi.extensions.api.answers
+
+import dev.inmo.tgbotapi.bot.TelegramBot
+import dev.inmo.tgbotapi.requests.answers.AnswerGuestQuery
+import dev.inmo.tgbotapi.types.GuestQueryId
+import dev.inmo.tgbotapi.types.InlineQueries.InlineQueryResult.abstracts.InlineQueryResult
+import dev.inmo.tgbotapi.types.guest.SentGuestMessage
+
+public suspend fun TelegramBot.answerGuestQuery(
+    guestQueryId: GuestQueryId,
+    result: InlineQueryResult
+): SentGuestMessage = execute(AnswerGuestQuery(guestQueryId, result))
+
+public suspend fun TelegramBot.answer(
+    guestQueryId: GuestQueryId,
+    result: InlineQueryResult
+): SentGuestMessage = execute(AnswerGuestQuery(guestQueryId, result))

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(
+): Unit = 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)
+): Unit = 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)
+): Unit = 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(
+): Unit = 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)
+): Unit = 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)
+): Unit = 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(
+): Unit = execute(AnswerPreCheckoutQueryOk(id))
+public suspend fun TelegramBot.answerPreCheckoutQueryOk(
     preCheckoutQuery: PreCheckoutQuery
-) = answerPreCheckoutQueryOk(preCheckoutQuery.id)
+): Unit = answerPreCheckoutQueryOk(preCheckoutQuery.id)
 
-suspend fun TelegramBot.answerPreCheckoutQueryError(
+public suspend fun TelegramBot.answerPreCheckoutQueryError(
     id: PreCheckoutQueryId,
     error: String
-) = execute(AnswerPreCheckoutQueryError(id, error))
-suspend fun TelegramBot.answerPreCheckoutQueryError(
+): Unit = execute(AnswerPreCheckoutQueryError(id, error))
+public suspend fun TelegramBot.answerPreCheckoutQueryError(
     preCheckoutQuery: PreCheckoutQuery,
     error: String
-) = answerPreCheckoutQueryError(preCheckoutQuery.id, error)
+): Unit = 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(
+): Unit = execute(AnswerShippingQueryOk(id, shippingOptions))
+public suspend fun TelegramBot.answerShippingQueryOk(
     shippingQuery: ShippingQuery,
     shippingOptions: List<ShippingOption>
-) = answerShippingQueryOk(shippingQuery.id, shippingOptions)
+): Unit = 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(
+): Unit = execute(AnswerShippingQueryError(id, error))
+public suspend fun TelegramBot.answerShippingQueryError(
     shippingQuery: ShippingQuery,
     error: String
-) = answerShippingQueryError(shippingQuery.id, error)
+): Unit = 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))
+): Unit = execute(ClearMyDefaultAdministratorRights(forChannels))
 
-suspend fun TelegramBot.clearMyDefaultAdministratorRightsForChannels() = clearMyDefaultAdministratorRights(forChannels = true)
+public suspend fun TelegramBot.clearMyDefaultAdministratorRightsForChannels(): Unit = clearMyDefaultAdministratorRights(forChannels = true)
 
-suspend fun TelegramBot.clearMyDefaultAdministratorRightsForGroupsAndSupergroups() = clearMyDefaultAdministratorRights(forChannels = false)
+public suspend fun TelegramBot.clearMyDefaultAdministratorRightsForGroupsAndSupergroups(): Unit = clearMyDefaultAdministratorRights(forChannels = false)

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

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

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

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

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

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

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

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

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

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

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

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

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

@@ -1,16 +1,17 @@
 package dev.inmo.tgbotapi.extensions.api.bot
 
-import dev.inmo.micro_utils.language_codes.IetfLanguageCode
+import dev.inmo.micro_utils.language_codes.IetfLang
 import dev.inmo.tgbotapi.bot.TelegramBot
 import dev.inmo.tgbotapi.requests.bot.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(
-    languageCode: IetfLanguageCode? = null
-) = execute(GetMyShortDescription(languageCode))
+public suspend fun TelegramBot.getMyShortDescription(
+    languageCode: IetfLang? = null
+): BotShortDescription = execute(GetMyShortDescription(languageCode))
 
-suspend fun TelegramBot.getMyShortDescription(
+public suspend fun TelegramBot.getMyShortDescription(
     languageCode: String?
-) = getMyShortDescription(languageCode ?.let(::IetfLanguageCode))
+): 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/RemoveMyProfilePhoto.kt

@@ -0,0 +1,6 @@
+package dev.inmo.tgbotapi.extensions.api.bot
+
+import dev.inmo.tgbotapi.bot.TelegramBot
+import dev.inmo.tgbotapi.requests.bot.RemoveMyProfilePhoto
+
+public suspend fun TelegramBot.removeMyProfilePhoto(): Unit = execute(RemoveMyProfilePhoto)

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

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

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

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

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

@@ -1,6 +1,6 @@
 package dev.inmo.tgbotapi.extensions.api.bot
 
-import dev.inmo.micro_utils.language_codes.IetfLanguageCode
+import dev.inmo.micro_utils.language_codes.IetfLang
 import dev.inmo.tgbotapi.bot.TelegramBot
 import dev.inmo.tgbotapi.requests.bot.GetMyCommands
 import dev.inmo.tgbotapi.requests.bot.GetMyDescription
@@ -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: IetfLanguageCode? = null
-) = execute(SetMyDescription(description, languageCode))
+    languageCode: IetfLang? = null
+): Unit = execute(SetMyDescription(description, languageCode))
 
-suspend fun TelegramBot.setMyDescription(
+public suspend fun TelegramBot.setMyDescription(
     description: String?,
     languageCode: String?
-) = setMyDescription(description, languageCode ?.let(::IetfLanguageCode))
+): Unit = setMyDescription(description, languageCode ?.let(::IetfLang))

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

@@ -1,6 +1,6 @@
 package dev.inmo.tgbotapi.extensions.api.bot
 
-import dev.inmo.micro_utils.language_codes.IetfLanguageCode
+import dev.inmo.micro_utils.language_codes.IetfLang
 import dev.inmo.tgbotapi.bot.TelegramBot
 import dev.inmo.tgbotapi.requests.bot.GetMyCommands
 import dev.inmo.tgbotapi.requests.bot.GetMyName
@@ -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: IetfLanguageCode? = null
-) = execute(SetMyName(name, languageCode))
+    languageCode: IetfLang? = null
+): Unit = execute(SetMyName(name, languageCode))
 
-suspend fun TelegramBot.setMyName(
+public suspend fun TelegramBot.setMyName(
     name: String?,
     languageCode: String?
-) = setMyName(name, languageCode ?.let(::IetfLanguageCode))
+): Unit = setMyName(name, languageCode ?.let(::IetfLang))

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

@@ -0,0 +1,9 @@
+package dev.inmo.tgbotapi.extensions.api.bot
+
+import dev.inmo.tgbotapi.bot.TelegramBot
+import dev.inmo.tgbotapi.requests.bot.SetMyProfilePhoto
+import dev.inmo.tgbotapi.requests.business_connection.InputProfilePhoto
+
+public suspend fun TelegramBot.setMyProfilePhoto(
+    photo: InputProfilePhoto
+): Unit = execute(SetMyProfilePhoto(photo))

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

@@ -1,15 +1,15 @@
 package dev.inmo.tgbotapi.extensions.api.bot
 
-import dev.inmo.micro_utils.language_codes.IetfLanguageCode
+import dev.inmo.micro_utils.language_codes.IetfLang
 import dev.inmo.tgbotapi.bot.TelegramBot
 import dev.inmo.tgbotapi.requests.bot.SetMyShortDescription
 
-suspend fun TelegramBot.setMyShortDescription(
+public suspend fun TelegramBot.setMyShortDescription(
     shortDescription: String? = null,
-    languageCode: IetfLanguageCode? = null
-) = execute(SetMyShortDescription(shortDescription, languageCode))
+    languageCode: IetfLang? = null
+): Unit = execute(SetMyShortDescription(shortDescription, languageCode))
 
-suspend fun TelegramBot.setMyShortDescription(
+public suspend fun TelegramBot.setMyShortDescription(
     shortDescription: String?,
     languageCode: String?
-) = setMyShortDescription(shortDescription, languageCode ?.let(::IetfLanguageCode))
+): Unit = 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
+): Unit = execute(
+    ConvertGiftToStars(businessConnectionId, ownedGiftId)
+)
+
+public suspend fun TelegramBot.convertGiftToStars(
+    businessConnectionId: BusinessConnectionId,
+    gift: Gift.Regular
+): Unit = 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>
+): Unit = 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>): Unit = 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,105 @@
+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.GiftSentOrReceivedEvent
+import dev.inmo.tgbotapi.types.gifts.OwnedGift
+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,
+    excludeLimitedUpgradable: Boolean = false,
+    excludeLimitedNonUpgradable: Boolean = false,
+    excludeUnique: Boolean = false,
+    excludeFromBlockchain: Boolean = false,
+    sortByPrice: Boolean = false,
+    offset: String? = null,
+    limit: Int? = null
+): OwnedGifts<OwnedGift.OwnedByBusinessAccount> = execute(
+    GetBusinessAccountGifts(
+        businessConnectionId,
+        excludeUnsaved,
+        excludeSaved,
+        excludeUnlimited,
+        excludeLimitedUpgradable,
+        excludeLimitedNonUpgradable,
+        excludeUnique,
+        excludeFromBlockchain,
+        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 excludeLimitedUpgradable Whether to exclude limited upgradable gifts
+ * @param excludeLimitedNonUpgradable Whether to exclude limited non-upgradable gifts
+ * @param excludeUnique Whether to exclude unique gifts
+ * @param excludeFromBlockchain Whether to exclude gifts from blockchain
+ * @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,
+    excludeLimitedUpgradable: Boolean = false,
+    excludeLimitedNonUpgradable: Boolean = false,
+    excludeUnique: Boolean = false,
+    excludeFromBlockchain: Boolean = false,
+    sortByPrice: Boolean = false,
+    initialOffset: String? = null,
+    limit: Int? = null,
+    onErrorContinueChecker: suspend (Throwable?) -> Boolean = { false }
+): Flow<OwnedGifts<OwnedGift.OwnedByBusinessAccount>> = flow {
+    var currentOffset = initialOffset
+    do {
+        val response = runCatching {
+            getBusinessAccountGifts(
+                businessConnectionId,
+                excludeUnsaved,
+                excludeSaved,
+                excludeUnlimited,
+                excludeLimitedUpgradable,
+                excludeLimitedNonUpgradable,
+                excludeUnique,
+                excludeFromBlockchain,
+                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
+): Unit = execute(
+    ReadBusinessMessage(businessConnectionId, chatId, messageId)
+)
+
+public suspend fun TelegramBot.readBusinessMessage(
+    businessConnectionId: BusinessConnectionId,
+    message: AccessibleMessage
+): Unit = 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,
+): Unit = 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
+): Unit = 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
+): Unit = 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
+): Unit = 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
+): Unit = 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
+): Unit = 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
+): Unit = execute(
+    SetBusinessAccountProfilePhoto(businessConnectionId, photo, isPublic)
+) 

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

@@ -0,0 +1,15 @@
+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
+
+public suspend fun TelegramBot.setBusinessAccountUsername(
+    businessConnectionId: BusinessConnectionId,
+    username: Username? = null
+): Unit = execute(
+    SetBusinessAccountUsername(businessConnectionId, username)
+) 

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

@@ -0,0 +1,18 @@
+// 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?
+): Unit = setBusinessAccountUsername(
+    businessConnectionId = businessConnectionId,
+    username = username ?.let { 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
+): Unit = 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,
+): Unit = 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,
+): Unit = 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
+): Unit = execute(
+    UpgradeGift(
+        businessConnectionId = businessConnectionId,
+        ownedGiftId = ownedGiftId,
+        keepOriginalDetails = keepOriginalDetails,
+        starCount = starCount
+    )
+)
+
+public suspend fun TelegramBot.convertGiftToStars(
+    businessConnectionId: BusinessConnectionId,
+    gift: Gift.Regular,
+    keepOriginalDetails: Boolean = false,
+): Unit = 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))
+): Unit = execute(LeaveChat(chatId))
 
-suspend fun TelegramBot.leaveChat(
+public suspend fun TelegramBot.leaveChat(
     chat: PublicChat
-) = leaveChat(chat.id)
+): Unit = 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(
+): Unit = execute(
     CloseForumTopic(
         chatId,
         messageThreadId
     )
 )
 
-suspend fun TelegramBot.closeForumTopic(
+public suspend fun TelegramBot.closeForumTopic(
     chat: Chat,
     messageThreadId: MessageThreadId
-) = closeForumTopic(chat.id, messageThreadId)
+): Unit = closeForumTopic(chat.id, messageThreadId)
 
-suspend fun TelegramBot.closeForumTopic(
+public suspend fun TelegramBot.closeForumTopic(
     chat: Chat,
     forumTopic: ForumTopic
-) = closeForumTopic(chat.id, forumTopic.messageThreadId)
+): Unit = 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(
+): Unit = execute(
     CloseGeneralForumTopic(chatId)
 )
 
-suspend fun TelegramBot.closeGeneralForumTopic(
+public suspend fun TelegramBot.closeGeneralForumTopic(
     chat: Chat
-) = closeGeneralForumTopic(chat.id)
+): Unit = 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(
+): Unit = execute(
     DeleteForumTopic(
         chatId,
         messageThreadId
     )
 )
 
-suspend fun TelegramBot.deleteForumTopic(
+public suspend fun TelegramBot.deleteForumTopic(
     chatId: ChatIdentifier,
     forumTopic: ForumTopic
-) = deleteForumTopic(chatId, forumTopic.messageThreadId)
+): Unit = deleteForumTopic(chatId, forumTopic.messageThreadId)
 
-suspend fun TelegramBot.deleteForumTopic(
+public suspend fun TelegramBot.deleteForumTopic(
     chat: Chat,
     messageThreadId: MessageThreadId
-) = deleteForumTopic(chat.id, messageThreadId)
+): Unit = deleteForumTopic(chat.id, messageThreadId)
 
-suspend fun TelegramBot.deleteForumTopic(
+public suspend fun TelegramBot.deleteForumTopic(
     chat: Chat,
     forumTopic: ForumTopic
-) = deleteForumTopic(chat.id, forumTopic.messageThreadId)
+): Unit = 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(
+): Unit = 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)
+): Unit = 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)
+): Unit = 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(
+): Unit = execute(
     EditGeneralForumTopic(
         chatId,
         name
     )
 )
 
-suspend fun TelegramBot.editGeneralForumTopic(
+public suspend fun TelegramBot.editGeneralForumTopic(
     chat: Chat,
     name: String
-) = editGeneralForumTopic(chat.id, name)
+): Unit = editGeneralForumTopic(chat.id, name)
 
-suspend fun TelegramBot.editGeneralForumTopic(
+public suspend fun TelegramBot.editGeneralForumTopic(
     chatIdentifier: ChatIdentifier,
     forumTopic: ForumTopic,
-) = editGeneralForumTopic(chatIdentifier, forumTopic.name)
+): Unit = 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(
+): Unit = execute(
     HideGeneralForumTopic(chatId)
 )
 
-suspend fun TelegramBot.hideGeneralForumTopic(
+public suspend fun TelegramBot.hideGeneralForumTopic(
     chat: Chat
-) = hideGeneralForumTopic(chat.id)
+): Unit = 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(
+): Unit = execute(
     ReopenForumTopic(
         chatId,
         messageThreadId
     )
 )
 
-suspend fun TelegramBot.reopenForumTopic(
+public suspend fun TelegramBot.reopenForumTopic(
     chat: Chat,
     messageThreadId: MessageThreadId
-) = reopenForumTopic(chat.id, messageThreadId)
+): Unit = reopenForumTopic(chat.id, messageThreadId)
 
-suspend fun TelegramBot.reopenForumTopic(
+public suspend fun TelegramBot.reopenForumTopic(
     chat: Chat,
     forumTopic: ForumTopic
-) = reopenForumTopic(chat.id, forumTopic.messageThreadId)
+): Unit = 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(
+): Unit = execute(
     ReopenGeneralForumTopic(chatId)
 )
 
-suspend fun TelegramBot.reopenGeneralForumTopic(
+public suspend fun TelegramBot.reopenGeneralForumTopic(
     chat: Chat
-) = reopenGeneralForumTopic(chat.id)
+): Unit = 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(
+): Unit = execute(
     UnhideGeneralForumTopic(chatId)
 )
 
-suspend fun TelegramBot.unhideGeneralForumTopic(
+public suspend fun TelegramBot.unhideGeneralForumTopic(
     chat: Chat
-) = unhideGeneralForumTopic(chat.id)
+): Unit = 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(
+): Unit = execute(
     UnpinAllForumTopicMessages(
         chatId,
         messageThreadId
     )
 )
 
-suspend fun TelegramBot.unpinAllForumTopicMessages(
+public suspend fun TelegramBot.unpinAllForumTopicMessages(
     chat: Chat,
     messageThreadId: MessageThreadId
-) = unpinAllForumTopicMessages(chat.id, messageThreadId)
+): Unit = unpinAllForumTopicMessages(chat.id, messageThreadId)
 
-suspend fun TelegramBot.unpinAllForumTopicMessages(
+public suspend fun TelegramBot.unpinAllForumTopicMessages(
     chat: Chat,
     forumTopic: ForumTopic
-) = unpinAllForumTopicMessages(chat.id, forumTopic.messageThreadId)
+): Unit = 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(
+): Unit = execute(
     UnpinAllGeneralForumTopicMessages(
         chatId
     )
 )
 
-suspend fun TelegramBot.unpinAllGeneralForumTopicMessages(
+public suspend fun TelegramBot.unpinAllGeneralForumTopicMessages(
     chat: Chat
-) = unpinAllGeneralForumTopicMessages(chat.id)
+): Unit = 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,20 @@ 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
+ * [ExtendedPrivateForumChatImpl] with unsafe operator "as"
+ *
+ * @throws ClassCastException
+ */
+@PreviewFeature
+public suspend fun TelegramBot.getChat(
+    chat: PrivateForumChatImpl
+): ExtendedPrivateForumChatImpl = getChat(chat.id) as ExtendedPrivateForumChatImpl
 
 /**
  * Will cast incoming [dev.inmo.tgbotapi.types.chat.ExtendedChat] to a
@@ -144,6 +135,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,14 @@ 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(
-    chatId: ChatIdentifier
-) = execute(GetChatAdministrators(chatId))
+public suspend fun TelegramBot.getChatAdministrators(
+    chatId: ChatIdentifier,
+    retrieveOtherBots: Boolean? = null
+): List<AdministratorChatMember> = execute(GetChatAdministrators(chatId = chatId, retrieveOtherBots = retrieveOtherBots))
 
-suspend fun TelegramBot.getChatAdministrators(
-    chat: PublicChat
-) = getChatAdministrators(chat.id)
+public suspend fun TelegramBot.getChatAdministrators(
+    chat: PublicChat,
+    retrieveOtherBots: Boolean? = null
+): List<AdministratorChatMember> = getChatAdministrators(chat.id, retrieveOtherBots)

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)