# TelegramBotAPI changelog ## 10.0.0 **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`: * Potential fix of incorrect parsing in `RawMessageEntity` ## 9.1.0 **This update contains adding of [Telegram Bot API 6.8](https://core.telegram.org/bots/api-changelog#august-18-2023) support** * `Version`: * `Coroutines`: `1.7.2` -> `1.7.3` * `Ktor`: `2.3.2` -> `2.3.3` * `MicroUtils`: `0.19.7` -> `0.19.9` ## 9.0.0 **THIS UPDATE CONTAINS BREAKING CHANGES: USERNAMES OF BOTS NOW BECAME NULLABLE** * `Version`: * `Coroutines`: `1.6.4` -> `1.7.1` * `Ktor`: `2.3.1` -> `2.3.2` * `MicroUtils`: `0.19.4` -> `0.19.7` * `Core`: * **All bots now have nullable usernames just like common users ([#772](https://github.com/InsanusMokrassar/ktgbotapi/issues/772))** * Decrease possible errors in updates handling by additional handling of update deserialization wrapping ([#773](https://github.com/InsanusMokrassar/ktgbotapi/issues/773)) * New interface `GetUpdatesRequest`. You may implement it to show default telegram bot ktor executor that this request is an updates request and should be handled in a different way * Now it is possible to get raw updates with `GetUpdatesRaw` request * `Utils`: * Improve extension `Update.sourceChat` to add opportunity to select some chats by logic different with the default ## 8.1.0 **PARTIALLY BREAKING CHANGES: Exclude `.*Impl` classcasts from `ClassCastsNew`** * `Version`: * `MicroUtils`: `0.19.2` -> `0.19.4` * `Utils`: * Add deep links formatting for internal `tg://` prefix (thanks to [@klimatov](https://github.com/klimatov)) * Exclude `.*Impl` classcasts from `ClassCastsNew` ## 8.0.1 * `Version`: * `UUID`: `0.7.0` -> `0.7.1` * `Ktor`: `2.3.0` -> `2.3.1` * `MicroUtils`: `0.19.1` -> `0.19.2` ## 8.0.0 **THIS UPDATE CONTAINS BREAKING CHANGES** **ALL PROJECT DEPRECATIONS HAVE BEEN REMOVED** **IN THIS UPDATE KORLIBS HAVE BEEN UPDATED TO VERSION `4.0.2`. SINCE THAT VERSION A LOT OF PACKAGES HAVE BEEN RENAMED. MIGRATIONS USED IN THIS LIB:** * `com.soywiz.klock` -> `korlibs.time` * `com.soywiz.krypto` -> `korlibs.crypto` * `Versions`: * `Korlibs`: `3.4.0` -> `4.0.3` * `MicroUtils`: `0.18.4` -> `0.19.1` ## 7.1.3 * `Versions`: * `Serialization`: `1.5.0` -> `1.5.1` * `MicroUtils`: `0.18.1` -> `0.18.4` * `Core`: * Actualize kdocs in `InputFile` * `BehaviourBuilder`: * Now it is possible to use `waitMediaContent`/`waitMediaContentMessage`/`onMediaContent` * Add `onMention`/`waitMention` functionality * Add opportunity to map content with extensions to `Flow` ## 7.1.2 * `Versions`: * `MicroUtils`: `0.18.0` -> `0.18.1` * `Core`: * Now it is possible to serialize `Sticker`s ## 7.1.1 * `Versions`: * `Kotlin`: `1.8.20` -> `1.8.21` * `MicroUtils`: `0.17.8` -> `0.18.0` * `Utils`: * Fixes in `makeLinkToMessage` ## 7.1.0 **This update contains changes according to the [Telegram Bot API 6.7](https://core.telegram.org/bots/api-changelog#april-21-2023)** * `API`: * Rename `editMessageCaption` to `editMessageMedia` due to wrong old naming * Add `edit` extensions for `InlineMessageIdentifier`s * `BehaviourBuilder`: * `BehaviourContext` extensions `onDeepLink` and `waitDeepLinks` now can be used with `Regex` or `String` as first parameters ## 7.0.2 _This update brings experimental support of `linuxX64` and `mingwX64` platforms_ * `Versions`: * `Kotlin`: `1.8.10` -> `1.8.20` * `MicroUtils`: `0.17.5` -> `0.17.8` * `Ktor`: `2.2.4` -> `2.3.0` * `Core`: * New `RequestsExecutor` - `MultipleClientKtorRequestsExecutor` * Old `KtorRequestsExecutor` has been renamed to `DefaultKtorRequestsExecutor` * `KtorRequestsExecutor` now is `expect class` * On `JS`, `JVM` and `MinGWX64` platforms it is `DefaultKtorRequestsExecutor` * On `LinuxX64` platform it is `MultipleClientKtorRequestsExecutor` ## 7.0.1 * `Core`: * New interface `WithChat` which contains `chat` field * `Message` now inherits `WithChat` * `ChatMemberUpdated` now inherits `WithChat` * `Utils`: * Improvements in `same`-notations ## 7.0.0 This update contains support of [Telegram Bot API 6.6](https://core.telegram.org/bots/api-changelog#march-9-2023) **THIS VERSION CONTAINS BREAKING CHANGES**: * All previous deprecations have been removed * Fully reworked mechanism of stickers creating and adding * All separations of stickers types like `Animeted` have been replaces with type `StickerFormat` * New `InputSticker` type (and all subtypes) as replacements for old raw fields in methods * Reworked mechanism of files uploading Other changes * `Versions`: * `MicroUtils`: `0.17.3` -> `0.17.5` ## 6.1.0 * `Versions`: * `MicroUtils`: `0.17.2` -> `0.17.3` * `API`: * Fix of [#732](https://github.com/InsanusMokrassar/TelegramBotAPI/issues/732) ## 6.0.3 * `Versions`: * `MicroUtils`: `0.17.1` -> `0.17.2` * `Core`: * `User` in `CallbackQuery` now is `CommonUser` as well as in `from` * `User` in `InlineQuery` now is `CommonUser` as well as in `from` * `BehaviourBuilder`: * Fixes in `DeepLink` triggers and waiters ## 6.0.2 * `Core`: * Long polling now uses media groups debounce as in webhooks ## 6.0.1 * `Versions`: * `Ktor`: `2.2.3` -> `2.2.4` * `MicroUtils`: `0.17.0` -> `0.17.1` ## 6.0.0 * `Versions`: * `Kotlin`: `1.7.22` -> `1.8.10` * `MicroUtils`: `0.16.10` -> `0.17.0` * `Serialization`: `1.4.1` -> `1.5.0` * `uuid`: `0.6.0` -> `0.7.0` * `Core`: * `*.link` extensions have been deprecated with renaming to avoid collisions with `link` methods * `API`: * Add `TelegramBot.resend` methods * `BehaviourBuilder`: * Add triggers and waiters for `VisualMediaGroupPartContent` * `Utils`: * `*.link` extensions have been deprecated with renaming to avoid collisions with `link` methods ## 5.2.1 * `Core`: * All the `CallbackQuery`es now will receive `CommonUser` instead of `User` due inability of bots to trigger any inline interaction with others bots * `API`: * Now `sentMessageFlow` will take each sent message in `handleLiveLocation` ## 5.2.0 * `Versions`: * `MicroUtils`: `0.16.8` -> `0.16.10` ## 5.1.1 * `Core`: * Add opportunity to get user link with `makeUserLink` * `BehaviourBuilder`: * Fixes in content waiting expectators ## 5.1.0 [Bot API 6.5](https://core.telegram.org/bots/api-changelog#february-3-2023) support * `Core`: * `ChatPermissions` now is interface and have two main realizations: `ChatPermissions.Granular` and `ChatPermissions.Common` * `RestrictedChatMember` now implements `ChatPermissions` too * `API`: * Now it is possible to pass all long polling parameters in all places used it * `Issues`: * Fix of [#697](https://github.com/InsanusMokrassar/TelegramBotAPI/issues/697) ## 5.0.2 * `Versions`: * `MicroUtils`: `0.16.6` -> `0.16.8` * `Ktor`: `2.2.2` -> `2.2.3` * `BehaviourBuilder`: * Fixes in `BehaviourContext.onEditedContentMessage` - now it will trigger callback on channel post edits too ## 5.0.1 * `Versions`: * `MicroUtils`: `0.16.4` -> `0.16.6` * `Ktor`: `2.2.1` -> `2.2.2` * `Core`: * Fixes in `SendMediaGroup` request * Fixes in `SetChatAdministratorCustomTitle` request (thanks to [@madhead](https://github.com/madhead)) ## 5.0.0 [Bot API 6.4](https://core.telegram.org/bots/api-changelog#december-30-2022) support! * Long-polling improvements ## 4.2.4 * `Core`: * Fixes in webhook parts adapter * `BehaviourBuilderWithFSM`: * Fixes in `DefaultBehaviourContextWithFSM` ## 4.2.3 * `Versions`: * `MicroUtils`: `0.16.2` -> `0.16.4` * `Core`: * Simplify default `RequestsLimiter` (`ExceptionsOnlyLimiter`) (thanks to [@y9san9](https://github.com/y9san9) for help) ## 4.2.2 * `Versions`: * `MicroUtils`: `0.16.0` -> `0.16.2` * `Core`: * Fix of [#694](https://github.com/InsanusMokrassar/TelegramBotAPI/issues/694): add opportunity to create `ChatId` and `ChatIdWithThreadId` from `IdChatIdentifier` ## 4.2.1 * `Versions`: * `MicroUtils`: `0.15.0` -> `0.16.0` * `Ktor`: `2.1.3` -> `2.2.1` * `Utils`: * Improve support of `makeLinkToMessage` extensions ## 4.2.0 * `Versions`: * `Kotlin`: `1.7.21` -> `1.7.22` * `MicroUtils`: `0.14.4` -> `0.15.0` ## 4.1.3 * `Versions`: * `MicroUtils`: `0.14.2` -> `0.14.4` * `Core`: * `ContentMessage`, `CommonMessage`, `PossiblyMediaGroupMessage` and `PossiblySentViaBotCommonMessage` got `out` variance * `UserId` now is `ChatId` instead of `IdChatIdentififer` ## 4.1.2 * `Versions`: * `MicroUtils`: `0.14.1` -> `0.14.2` * `BehaviourBuilder`: * Fixes in `CallbackQuery` waiters ## 4.1.1 * `Core`: * Add opportunity to create `IdChatIdentifier` with optional `threadId` * New serializer `FullChatIdentifierSerializer` with serialization of `ChatIdWithThreadId` ## 4.1.0 * `Versions`: * `Kotlin`: `1.7.20` -> `1.7.21` * `MicroUtils`: `0.14.0` -> `0.14.1` * `Korlibs`: `3.3.1` -> `3.4.0` * `UUID`: `0.5.0` -> `0.6.0` * `Core`: * All the chats identifiers has been rewritten as value classes * New chat identifier: `ChatIdWithThreadId` * `RawMessage` will create `ChatIdWithThreadId` chat id under the hood by default * All the methods which potentially using `threadId` will try to take it from `chatId` * `API`: * All default `threadId` null values has been replaced with auto-calculated threadId from chats/chat ids ## 4.0.0 **!!! THIS UPDATE CONTAINS FULL REWORK OF MEDIA GROUPS FUNCTIONALITY !!!** **THIS UPDATE CONTAINS BREAKING CHANGES** * `Common`: * All the media groups have been rewritten. Since this update, there are no separated messages types for media groups, but new type of content (`MediaGroupContent`) has been introduced * [Bot API 6.3](https://core.telegram.org/bots/api-changelog#november-5-2022) support * `Versions`: * `MicroUtils`: `0.13.2` -> `0.14.0` * `Core`: * New requests ## 3.3.1 * `Versions`: * `Ktor`: `2.1.2` -> `2.1.3` * `Klock`: `3.2.0` -> `3.3.1` * `MicroUtils`: `0.13.1` -> `0.13.2` * `Utils`: * New extensions on `CommonMessage`: `hasCommands` and `hasNoCommands`. Useful for the `initialFilter` parameter in behaviour builder triggers. ## 3.3.0 **THIS VERSION CONTAINS UPGRADE KOTLIN (AND ALL RELATED LIBRARIES) UP TO 1.7.20** * `Versions`: * `Kotlin`: `1.7.10` -> `1.7.20` * `Kotlin Serialization`: `1.4.0` -> `1.4.1` * `Korlibs`: `3.1.0` -> `3.2.0` * `MicroUtils`: `0.12.17` -> `0.13.1` * `Core`: * Add opportunity to create command text source and add command in entities builder via `BotCommamd` (thanks to [d1shin](https://github.com/InsanusMokrassar/TelegramBotAPI/pull/664)) * `API`: * New extensions `TelegramBot#getStickerSetOrNull` and `TelegramBot#getStickerSetOrThrow` * Old `TelegramBot#getStickerSet` has been deprecated * `Behaviour Builder`: * Add opportunity to use triggers and waiters with `BotCommand` (thanks to [d1shin](https://github.com/InsanusMokrassar/TelegramBotAPI/pull/664)) ## 3.2.7 * `Versions`: * `MicroUtils`: `0.12.13` -> `0.12.17` * `Ktor`: `2.1.1` -> `2.1.2` * `Utils`: * Next classes become typealiases instead of classes: * `ReplyKeyboardBuilder` * `ReplyKeyboardRowBuilder` * `InlineKeyboardBuilder` * `InlineKeyboardRowBuilder` ## 3.2.6 * `Core`: * Fixes in `ChatMemberSerializer#serialize` method * Migration of `EntitiesBuilder` from `Utils` to `Core` * `API`: * All the extensions related to text messages (replies, sending, editing) got their duplicates with `buildEntities` lambda and separator * `Utils`: * Migration of `EntitiesBuilder` from `Utils` to `Core` ## 3.2.5 * `Common`: * Improve support of new exceptions recovering mechanism ## 3.2.4 * `API`: * New `edit`'s with chats and message ids ## 3.2.3 * `Core`: * Fixes in `DeleteMyCommands` ## 3.2.2 * `Versions`: * `MicroUtils`: `0.12.10` -> `0.12.13` * `Core`: * `MessageIdentifier` has been renamed to `MessageId` * `API`: * New `reply`'es with chats and message ids ## 3.2.1 * `Versions`: * `Ktor`: `2.1.0` -> `2.1.1` * `Korlibs`: `3.0.0` -> `3.1.0` * `MicroUtils`: `0.12.4` -> `0.12.10` ## 3.2.0 **Since this update, `RequestsExecutor#execute` may throw only `BotException`. In case you wish to handle some exceptions from `execute` you must catch `BotException` and handle its `cause`** * `Versions`: * `Serialization`: `1.4.0-RC` -> `1.4.0` * `MicroUtils`: `0.12.1` -> `0.12.4` * `Core`: * `SetWebhook#allowedUpdates` now is `ALL_UPDATES_LIST` by default instead of `null` * `API`: * Extension `TelegramBot#setWebhook` parameter `allowedUpdates` now is `ALL_UPDATES_LIST` by default instead of `null` * `Utils`: * All related to long polling extensions parameters `allowedUpdates` now are `ALL_UPDATES_LIST` by default instead of `null` ## 3.1.1 * `Common`: * Complete Bot API 6.2 implementation ## 3.1.0 **This update contains including of Bot API 6.2** * `Versions`: * `Ktor`: `2.0.3` -> `2.1.0` * `MicroUtils`: `0.12.0` -> `0.12.1` * `Core`: * Add support of `custom emoji`s * Add support of `sticker_type` ## 3.0.2 **ALL OLD DEPRECATIONS HAVE BEEN REMOVED** **`copyMessage` HAVE CHANGED THEIR SIGNATURE BY SWAPPING FROM AND TO CHAT IDS** * `Versions`: * `Kotlin`: `1.6.21` -> `1.7.10` * `Serialization`: `1.3.3` -> `1.4.0-RC` * `Korlibs`: `2.7.0` -> `3.0.0` * `UUID`: `0.4.1` -> `0.5.0` * `MicroUtils`: `0.11.13` -> `0.12.0` * `Core`: * Interface `ReplyMakrup` has been renamed to `WithReplyMarkup` to correspond its purpose * Data class `LeftChatMember` has been renamed to `LeftChatMemberEvent` to avoid type ambiguite with the other `LeftChatMember` * `ForwardInfo` hierarchy has been fully reworked: * `AnonymousForwardInfo` -> `ForwardInfo.ByAnonymous` * `UserForwardInfo` -> `ForwardInfo.ByUser` * `ForwardFromPublicChatInfo` -> `ForwardInfo.PublicChat` * `ForwardFromChannelInfo` -> `ForwardInfo.PublicChat.FromChannel` * `ForwardFromSupergroupInfo` -> `ForwardInfo.PublicChat.FromSupergroup` * `ForwardInfo.PublicChat.SentByChannel` ___has been created___ * `API`: * Add new `Flow`-based live locations API * Add `sendLocation` for sending live locations * `Utils`: * **BREAKING CHANGES** Now all new classcasts (like `Chat.ifPrivateChat` etc.) have been rewritten to be generated with `ksp` and `kotlin poet` *Note: Versions 3.0.0 and 3.0.1 have been published with errors and didn't recommend to use* ## 2.2.2 * `Utils`: * `buildEntities` now is inline * `Behaviour Builder`: * Fixes in `CallbackQuery` triggers ## 2.2.1 * `Versions`: * `Coroutines`: `1.6.3` -> `1.6.4` * `MicroUtils`: `0.11.12` -> `0.11.13` * `Core`: * New `typealiase`s for `CommonMessage` with all supported content types, more info: [PR](https://github.com/InsanusMokrassar/TelegramBotAPI/pull/629) * `Utils`: * New extensions for all types of messages `*.withContentOrNull` and `*.withContentOrThrow` as analogies to the same ones from class casts ## 2.2.0 * `Core`: * For `CopyMessage` order of parameters has been changed * `ReplyForce` defaults changes: * All old companion properties (like `ReplyForce.ReplyForceSelective`) have been renamed: * `ReplyForceSelective` -> `Selective` * `ReplyForceNonSelective` -> `NonSelective` * `ReplyForceDefault` -> `Default` * New companion functions: * `ReplyForce#Selective` * `ReplyForce#NonSelective` * Rename `CreatorChatMember` -> `OwnerChatMember` * `API`: * For `copyMessage` order of parameters has been changed * `Utils`: * New extension `Message#sameChat` * New extension `Message#sameMessage` * New functions `flatInlineKeyboard` and `flatReplyKeyboard` * Experimentally add new triple of class casts: `if*`, `*OrNull` and `*OrThrow` ## 2.1.3 * `Versions`: * `MicroUtils`: `0.11.9` -> `0.11.12` * `Utils`: * Rename `UserId` extension `link` to `userLink` * `Core` * `ChatJoinRequest#inviteLink` is nullable due to the fact that join requests without link do not require invite link ## 2.1.2 * `Versions`: * `Coroutines`: `1.6.1` -> `1.6.3` * `Ktor`: `2.0.2` -> `2.0.3` * `MicroUtils`: `0.11.6` -> `0.11.9` ## 2.1.1 * `API`: * Now it is possible to edit any message text via `editMessageText` (but with warning) * Now it is possible to edit any message caption via `editMessageCaption` (but with warning) * Media message caption edit method (`editMessageCaption`) now returns the message with the same generic type (as it must be in telegram system) * New extensions `TelegramBot#edit` has been added for all possible editions types * New extensions `TelegramBot#send` has been added for all possible sending types * New extensions `TelegramBot#delete` has been added * `Versions`: * `MicroUtils`: `0.11.3` -> `0.11.6` ## 2.1.0 __This update contains including of [Telegram Bot API 6.1](https://core.telegram.org/bots/api-changelog#june-20-2022)__ * Add support of functionality for `WebApp`s from [Bot API 6.1](https://core.telegram.org/bots/api-changelog#june-20-2022) * Add support of functionality for premium feature from [Bot API 6.1](https://core.telegram.org/bots/api-changelog#june-20-2022) * Add support of `addedToAttachmentMenu` in `CommonUser` from [Bot API 6.1](https://core.telegram.org/bots/api-changelog#june-20-2022) * Add support of `secret_token` in `SetWebhook` request from [Bot API 6.1](https://core.telegram.org/bots/api-changelog#june-20-2022) * Add support of `createInvoiceLink` request from [Bot API 6.1](https://core.telegram.org/bots/api-changelog#june-20-2022) ## 2.0.3 * `Core`: * New function `regularln` for simple creating of `RegularTextSource` with new line in the end * `API`: * New function `downloadFileToTemp` for simple downloading of file in filesystem and manipulation with avoiding of direct using input streams and other low-level things * `Versions`: * `MicroUtils`: `0.11.0` -> `0.11.3` ## 2.0.2 * `Versions`: * `MicroUtils`: `0.10.8` -> `0.11.0` * `UUID`: `0.4.0` -> `0.4.1` ## 2.0.1 * `Versions`: * `Ktor`: `2.0.1` -> `2.0.2` * `MicroUtils`: `0.10.5` -> `0.10.8` * `Utils`: * `TelegramBot#longPolling` now accepts `UpdatesFilter` instead of `FlowsUpdatesFilter` ## 2.0.0 ___ALL PREVIOUS DEPRECATIONS HAVE BEEN REMOVED___ * `Behaviour Builder`: * Mappers have been removed from waiters extensions * Triggers extensions now will use filtering inside of context receiver instead of passing the filters into `BehaviourContext`. That means that in the subcontext will not be used preinstalled filters for their `BehaviourContext` and filter of trigger will not be used in subcontext * Waiters do not take count parameter anymore * Waiters do not take filter parameter anymore. Use flows filters * `Utils`: * Add opportunity to get event messages with specific `ChatEvent` type using `withEvent`/`requireWithEvent` (by analog with `withEvent` and `requireWithEvent`) ## 1.1.3 * `Behaviour Builder with FSM`: * Typealias `StateHandlingErrorHandler` from `1.1.2` has been deprecated and should be replaced with the new one from microutils ## 1.1.2 * `Core`: * Rename of `TelegramAPIUrlsKeeper#checkWebAppLink` -> `TelegramAPIUrlsKeeper#checkWebAppData` (fix of [#591](https://github.com/InsanusMokrassar/TelegramBotAPI/issues/591)) * `Behaviour Builder with FSM`: * New typealias `StateHandlingErrorHandler` * `BehaviourBuilderWithFSM` now accepts new parameter `onStateHandlingErrorHandler` which will be used in case if state has not been successfully completed ## 1.1.1 * `Versions`: * `MicroUtils.Crypto` will not be provided with that library anymore. Instead, it is recommended to use `Korlibs.Krypto`. You still can add crypto from microutils using next groovy dependency: `dev.inmo:micro_utils.crypto:$micro_utils_version` * `Core`: * Improvements in `TelegramAPIUrlsKeeper#checkWebAppLink` * New field in `TelegramAPIUrlsKeeper#webAppDataSecretKeyHash` * `Behaviour Builder`: * Extension `TelegramBot#buildBehaviour` now returns `BehaviourContext` ## 1.1.0 * `Utils`: * New parameter `additionalApplicationEngineEnvironmentConfigurator` in `RequestsExecutor#setWebhookInfoAndStartListenWebhooks` and `startListenWebhooks` ## 1.0.1 * `Versions`: * `Serialization`: `1.3.2` -> `1.3.3` * `MicroUtils`: `0.10.3` -> `0.10.4` ## 1.0.0 __All the `tgbotapi.extensions.*` packages have been removed__ * `Versions`: * `Kotlin`: `1.6.10` -> `1.6.21` * `Ktor`: `1.6.8` -> `2.0.1` * `MicroUtils`: `0.9.24` -> `0.10.3` * `Core`: * **`Ktor` package renamed. Migration:** `dev.inmo.tgbotapi.bot.Ktor` -> `dev.inmo.tgbotapi.bot.ktor` * **`CallbackQuery` package renamed. Migration:** `dev.inmo.tgbotapi.types.CallbackQuery([\s\\.])` -> `dev.inmo.tgbotapi.types.queries.callback$1` * **`ChatMember` package renamed. Migration:** `dev.inmo.tgbotapi.types.ChatMember([\s\\.])` -> `dev.inmo.tgbotapi.types.chat.member$1` * **`ChatAdministratorRightsImpl` replaced. Migration:** `dev.inmo.tgbotapi.types.ChatAdministratorRightsImpl` -> `dev.inmo.tgbotapi.types.chat.member.ChatAdministratorRightsImpl` * **`chat.abstract.extended` replaced. Migration:** `dev.inmo.tgbotapi.types.chat.abstract.extended` -> `dev.inmo.tgbotapi.types.chat.member.chat` * **`chat.abstract` replaced. Migration:** `dev.inmo.tgbotapi.types.chat.abstract` -> `dev.inmo.tgbotapi.types.chat.member.chat` * **`chat.extended` replaced. Migration:** `dev.inmo.tgbotapi.types.chat.extended` -> `dev.inmo.tgbotapi.types.chat.member.chat` * **User interfaces have been fully replaced**: * `dev.inmo.tgbotapi.types.User` -> `dev.inmo.tgbotapi.types.chat.User` * `dev.inmo.tgbotapi.types.CommonUser` -> `dev.inmo.tgbotapi.types.chat.CommonUser` * `dev.inmo.tgbotapi.types.ExtendedUser` -> `dev.inmo.tgbotapi.types.chat.ExtendedUser` * `dev.inmo.tgbotapi.types.Bot` -> `dev.inmo.tgbotapi.types.chat.Bot` * `dev.inmo.tgbotapi.types.CommonBot` -> `dev.inmo.tgbotapi.types.chat.CommonBot` * `dev.inmo.tgbotapi.types.ExtendedBot` -> `dev.inmo.tgbotapi.types.chat.ExtendedBot` * `dev.inmo.tgbotapi.types.UserSerializer` -> `dev.inmo.tgbotapi.types.chat.UserSerializer` * **All `InputMedia` has been renamed as `TelegramMedia`. Migration:** `InputMedia` -> `TelegramMedia` * `dev.inmo.tgbotapi.types.InputMedia` -> `dev.inmo.tgbotapi.types.media` * **Replaces of `MessageContent`. Migrations:** * `dev.inmo.tgbotapi.types.message.content.abstracts` -> `dev.inmo.tgbotapi.types.message.content` * `dev.inmo.tgbotapi.types.message.content.media` -> `dev.inmo.tgbotapi.types.message.content` * **Replaces of `TextSource`s. Migrations:** `dev.inmo.tgbotapi.types.MessageEntity.textsources` -> `dev.inmo.tgbotapi.types.message.textsources` * **Replaces of `ParseMode`s. Migrations:** `dev.inmo.tgbotapi.types.ParseMode` -> `dev.inmo.tgbotapi.types.message` * **Replaces of `MediaGroupUpdate`s. Migrations:** `dev.inmo.tgbotapi.types.update.MediaGroupUpdates` -> `dev.inmo.tgbotapi.types.update.media_group` * **`InvoiceContent` has been replaced: `dev.inmo.tgbotapi.types.message.payments.InvoiceContent` -> `dev.inmo.tgbotapi.types.message.content.InvoiceContent`** * **`PossiblySentViaBotCommonMessage` has been replaced: `dev.inmo.tgbotapi.types.message.content.abstracts.PossiblySentViaBotCommonMessage` -> `dev.inmo.tgbotapi.types.message.abstracts.PossiblySentViaBotCommonMessage`** * **Edit live location requests have been replaced:** * `dev.inmo.tgbotapi.requests.edit.LiveLocation` -> `dev.inmo.tgbotapi.requests.edit.location.live` * `dev.inmo.tgbotapi.extensions.api.edit.LiveLocation` -> `dev.inmo.tgbotapi.extensions.api.edit.location.live` * **Edit reply markup requests have been replaced:** * `dev.inmo.tgbotapi.requests.edit.ReplyMarkup` -> `dev.inmo.tgbotapi.requests.edit.reply_markup` * `dev.inmo.tgbotapi.extensions.api.edit.ReplyMarkup` -> `dev.inmo.tgbotapi.extensions.api.edit.reply_markup` * **Common abstracts have been replaced: `dev.inmo.tgbotapi.CommonAbstracts` -> `dev.inmo.tgbotapi.abstracts`** * Constructor of `UnknownInlineKeyboardButton` is not internal and can be created with any `json` ([#563](https://github.com/InsanusMokrassar/TelegramBotAPI/issues/563)) * All the interfaces from `dev.inmo.tgbotapi.types.files.abstracts` have been replaced to `dev.inmo.tgbotapi.types.files` and converted to sealed ([#550](https://github.com/InsanusMokrassar/TelegramBotAPI/issues/550)) * `PassportFile` has been replaced to `dev.inmo.tgbotapi.types.files` * `StorageFile` has been deprecated (fix of [#556](https://github.com/InsanusMokrassar/TelegramBotAPI/issues/556)) * `MultipartFile` do not require `StorageFile` anymore * `InputFile` companion got functions to simplify creation of `InputFile`s * New typealias `FileUrl` (represents `FileId` but declare that they are the same) * `BehaviourBuilder`: * `SimpleFilter` now is a `fun interface` instead of just callback (fix of [#546](https://github.com/InsanusMokrassar/TelegramBotAPI/issues/546)) * New extension `BehaviourContext#createSubContext`. It uses separated `AccumulatorFlow` and will retrieve updates by itself * New extension `BehaviourContext#doInContext` * Extension `BehaviourContext#doInSubContextWithUpdatesFilter` has been renamed to `BehaviourContext#createSubContextAndDoWithUpdatesFilter` * Extension `BehaviourContext#doInSubContext` has been deprecated * `BehaviourContextWithFSM`: * `launchStateHandling` lost its parameter `contextUpdatesFlow: Flow` * `handleState` of `BehaviourContextWithFSM` now will get/create sub context for the state and launch handling in it * `BehaviourWithFSMStateHandler` now extends `StatesHandler` * `BehaviourWithFSMStateHandlerHolder` now extends `CheckableHandlerHolder` and `BehaviourWithFSMStateHandler` * Function `checkHandleable` of `BehaviourWithFSMStateHandlerHolder` now is `suspend` ## 0.38.23 * `BehaviourHandler`: * Add support of fallback triggers (fix of [#560](https://github.com/InsanusMokrassar/TelegramBotAPI/issues/560)) ## 0.38.22 * `Core`: * New constant `tgWebAppStartParamField` * All keyboards builders and rows blocks becomes not crossinline ## 0.38.21 * `WebApps`: * `WebAppInitData#queryId` now have correct js name of field * New function `sendDataOrWorkWithQueryId` ## 0.38.20 * `BehaviourBuilder FSM`: * Hotfixes * `WebApps`: * New extension `TelegramBot#answerWebAppQuery` * New function `handleResult` ## 0.38.19 * `BehaviourBuilder`: * Hotfixes * `BehaviourBuilder FSM`: * `BehaviourContextWithFSMBuilder` deprecated in favor to `BehaviourContextWithFSM` * Now it is possible to define additional handlers in subcontexts of `BehaviourBuilderWithFSM` ## 0.38.18 * `Core`: * Add support of test servers (fix of [#577](https://github.com/InsanusMokrassar/TelegramBotAPI/issues/577)) * `BehaviourBuilder`: * Fixes in extension `BehaviourContext#doInSubContextWithUpdatesFilter` (thanks to [xzima](https://github.com/xzima)) ## 0.38.17 * `Core`: * Add `BotCommandScopeChat` as new `BotCommandScope` (fix of [#574](https://github.com/InsanusMokrassar/TelegramBotAPI/issues/574)) * `BotCommandScope` companion got several properties and functions for more useful scope creation ## 0.38.16 * `Core`: * `TelegramAPIUrlsKeeper` now have two new things: properties `webAppDataSecretKey` and fun `checkWebAppLink` ## 0.38.15 * `Common`: * `Version`: * `MicroUtils`: `0.9.20` -> `0.9.24` * `Core`: * Fixes in `MessageContent#serializationModule` * `BehaviourBuilder`: * Add triggers for `DataCallbackQuery` and subtypes with regex checking of data ## 0.38.14 __This update contains including of [Telegram Bot API 6.0](https://core.telegram.org/bots/api-changelog#april-16-2022)__ * `Core`: * Constructor of `UnknownInlineKeyboardButton` is not internal and can be created with any `json` * `WebApps`: * Created 🎉 ## 0.38.13 * `Core`: * Fixes in `mention` creation * Deprecate `StorageFileInfo` * `BehaviourBuilder`: * In the expectations a lot of `on*Message` extensions have been added (like `onContentMessage`). These extensions could be useful when with the `Content` its message info is important ## 0.38.12 * `Common`: * `Version`: * `MicroUtils`: `0.9.17` -> `0.9.19` * `Coroutines`: `1.6.0` -> `1.6.1` * `Core`: * New type `TextedMediaContent` which will unite `TextedInput` and `MediaContent` * `MediaGroupContent` and all subsequent inheritors have been replaced to the package `dev.inmo.tgbotapi.types.message.content.media` * `MediaGroupContent` Now extends `TextedMediaContent` instead of `MediaContent` * Add `reply` functions with the texted content with including of text * `Utils`: * Improve work with retrieving of accumulated updates ## 0.38.11 * `Common`: * `Version`: * `MicroUtils`: `0.9.16` -> `0.9.17` * `Klock`: `2.6.3` -> `2.7.0` * `Core`: * Fixes in `TextSourcesList` creating in from `RawMessageEntities` * Old ways to create keyboards (`matrix` and `row`) have been deprecated * `API`: * Add ability to `reply` with `Poll` * Add ability to `reply` with any `MessageContent` * Add ability to `reply` with any `TelegramMediaFile` ## 0.38.10 * `API`: * All `with*Action` extensions got a contracts which declare that `block` will be called once * Add several extensions `TelegramBot#sendPhoto` with `PhotoSize` * Add several extensions `TelegramBot#reply` with `PhotoSize` ## 0.38.9 * `Core`: * New function `MessageContent.Companion#serializationModule` * Now it is possible to create `TelegramBot` (`RequestsExecutor`) with several bots under the hood and opportunity for bots requests load balancing or fault-fix via sending of the requests via another bot * `API`: * Add replies which will use another message as a source for reply (`copyMessage`) ## 0.38.8 * `Common`: * `Version`: * `MicroUtils`: `0.9.12` -> `0.9.16` * `Klock`: `2.6.2` -> `2.6.3` * `Ktor`: `1.6.7` -> `1.6.8` * `BehaviourBuilder`: * Fixes in `onMediaGroup` and dependent functions * Add several new extensions for `SimpleFilter`: * `SimpleFilter#listAll` * `SimpleFilter#listAny` * `SimpleFilter#listNone` ## 0.38.7 * `Common`: * `Version`: * `MicroUtils`: `0.9.9` -> `0.9.12` * `Klock`: `2.5.2` -> `2.6.2` * `Core`: * `SimplePollOption#votes` now is `0` by default * New function `PollOption.Companion#simple` ## 0.38.6 * `Common`: * `Version`: * `MicroUtils`: `0.9.6` -> `0.9.9` * `Klock`: `2.4.13` -> `2.5.2` * `Core`: * New member of `MentionTextSource` - `username` ## 0.38.5 * `Common`: * `Version`: * `MicroUtils`: `0.9.5` -> `0.9.6` * `Core`: * `Username` got new property `usernameWithoutAt` which will return `username` without leading `@` * `Utils`: * Several new functions for working with deep links: * `makeUsernameDeepLinkPrefix` * `makeTelegramDeepLink` * `makeDeepLink` ## 0.38.4 __This update contains including of [Telegram Bot API 5.7](https://core.telegram.org/bots/api-changelog#january-31-2022)__ * `Core`: * Support of new fields `Sticker` * Support of new fields `StickerSet` * Support of new fields in creating of sticker set and sticker * `Utils`: * Rename `PathedFile` to avoid clash with core file (fix of [#529](https://github.com/InsanusMokrassar/TelegramBotAPI/issues/529)) ## 0.38.3 * `Common`: * `Version`: * `MicroUtils`: `0.9.1` -> `0.9.2` * `Klock`: `2.4.10` -> `2.4.12` * `UUID`: `0.3.1` -> `0.4.0` * `API` * New extensions `TelegramBot#send*` for media groups with contents ## 0.38.2 * `Common`: * `Version`: * `MicroUtils`: `0.9.0` -> `0.9.1` * `API` * New extensions `TelegramBot#copyMessages` for media groups ## 0.38.1 * `Core`: * `MessageCallbackQuery` (and all implementers as well) has changed the type of `message`: now it is `ContentMessage` instead of `Message` * New type `ForwardFromPublicChatInfo` as extender of `ForwardInfo`: * `ForwardFromChannelInfo` now extends `ForwardFromPublicChatInfo` * `ForwardFromSupergroupInfo` now extends `ForwardFromPublicChatInfo` * New type of events: `UserLoggedIn` * `Utils`: * ([#511](https://github.com/InsanusMokrassar/TelegramBotAPI/issues/511)) New extensions properties (raw fields as in original API) for several types have been added: * `Message` * `CallbackQuery` * `ChosenInlineResult` * `InlineQuery` * `Poll` ## 0.38.0 _This update contains [Telegram Bot API 5.6](https://core.telegram.org/bots/api-changelog#december-30-2021) implementation_ _This update contains migration onto Kotlin 1.6_ _This update has changed constructors of all `CommonMessage` implementations_ * `Common`: * `Version`: * `Kotlin`: `1.5.31` -> `1.6.10` * `Coroutines`: `1.5.2` -> `1.6.0` * `Serialization`: `1.3.1` -> `1.3.2` * `Klock`: `2.4.8` -> `2.4.10` * `Ktor`: `1.6.5` -> `1.6.7` * `MicroUtils`: `0.8.7` -> `0.9.0` * `Core`: * Add `SpoilerTextSource` (as part of `Telegram Bot API 5.6` update) * Add support of `protect_content` as a field `protectContent` in all send message requests and parameter in all functions related to that requests (as part of `Telegram Bot API 5.6` update) * **ALL IMPLEMENTERS OF `CommonMessage` HAS CHANGED THEIR CONSTRUCTOR: NOW THEY GET `hasProtectedContent` instead of `forwardable` (inversed) field** * `ChannelContentMessageImpl` * `ChannelMediaGroupMessage` * `CommonMediaGroupMessage` * `GroupContentMessage` implementers * `ConnectedFromChannelGroupContentMessageImpl` * `UnconnectedFromChannelGroupContentMessageImpl` * `AnonymousGroupContentMessageImpl` * `CommonGroupContentMessageImpl` * `PrivateContentMessageImpl` ## 0.37.4 * `Common`: * `Version`: * `MicroUtils`: `0.8.7` -> `0.8.9` * `Core`: * New `SupergroupEvent` subtype: `MigratedToSupergroup`. This event is sent when a group is converted to a supergroup while bot is in the group. * Helper extenstion functions on `ChatEvent` to cast it to `MigratedToSupergroup`. ## 0.37.3 Hotfix of 0.37.2 * `Core`: * Fixes in hierarchy (and creating) of messages from channels --- `0.37.2` changelog: _This update contains [Telegram Bot API 5.5](https://core.telegram.org/bots/api-changelog#december-7-2021) implementation_ * `Common`: * `Version`: * `MicroUtils`: `0.8.2` -> `0.8.7` * `Core`: * New request type: `ChatSenderRequest` * New request `BanChatSenderChat` * New request `UnbanChatSenderChat` * `ExtendedPrivateChat` got new properties: `hasPrivateForwards` and `allowCreateUserIdLink` (same as `hasPrivateForwards`) * All `ContentMessage` got field `forwardable` (old constructors marked as `Deprecated`) * `FromChannelGroupContentMessage` has been divided for two interfaces (and corresponding classes): * `ConnectedFromChannelGroupContentMessage` (and `ConnectedFromChannelGroupContentMessageImpl`) for connected to the group channels messages * `UnconnectedFromChannelGroupContentMessage` (and `UnconnectedFromChannelGroupContentMessageImpl`) for unconnected channels * `API`: * New extensions `TelegramBot#banChatSenderChat` * New extensions `TelegramBot#unbanChatSenderChat` * `Utils`: * Fix of `EntitiesBuilder#linkln` ## 0.37.2 Telegram Bot API 5.5 * `Common`: * `Version`: * `MicroUtils`: `0.8.2` -> `0.8.7` * `Core`: * New request type: `ChatSenderRequest` * New request `BanChatSenderChat` * New request `UnbanChatSenderChat` * `ExtendedPrivateChat` got new properties: `hasPrivateForwards` and `allowCreateUserIdLink` (same as `hasPrivateForwards`) * All `ContentMessage` got field `forwardable` (old constructors marked as `Deprecated`) * `ChannelContentMessage` has been divided for two interfaces (and corresponding classes): * `ConnectedChannelContentMessage` (and `ConnectedChannelContentMessageImpl`) for connected to the group channels messages * `UnconnectedChannelContentMessage` (and `UnconnectedChannelContentMessageImpl`) for unconnected channels * `API`: * New extensions `TelegramBot#banChatSenderChat` * New extensions `TelegramBot#unbanChatSenderChat` * `Utils`: * Fix of `EntitiesBuilder#linkln` ## 0.37.1 * `Common`: * `Version`: * `Serialization`: `1.3.0` -> `1.3.1` * `Klock`: `2.4.7` -> `2.4.8` * `MicroUtils`: `0.8.1` -> `0.8.2` ## 0.37.0 Telegram Bot API 5.4 **ALL DEPRECATIONS WERE REMOVED** * `Common`: * `Version`: * `Klock`: `2.4.6` -> `2.4.7` * `Ktor`: `1.6.4` -> `1.6.5` * `MicroUtils`: `0.7.3` -> `0.8.1` * `Core`: * Replacement of simple `CreateChatInviteLink` and `EditChatInviteLink` with several new: * `CreateChatInviteLinkSimple` * `CreateChatInviteLinkWithLimitedMembers` * `CreateChatInviteLinkWithJoinRequest` * `EditChatInviteLinkSimple` * `EditChatInviteLinkWithLimitedMembers` * `EditChatInviteLinkWithJoinRequest` * New `BotAction`: `ChooseStickerAction` * Now requester will throw exceptions related to responses decoding directly instead of wrapping in `RequestException` * * `BehaviourBuilder FSM`: * **Incompatible changes** (now generics are used in state machines) * `strictlyOn` and `onStateOrSubstate` now are part of `BehaviourContextWithFSMBuilder` ## 0.36.1 * `Common`: * `Version`: * `MicroUtils`: `0.7.2` -> `0.7.3` * `API`: * Fix `getMyCommands` overloads conflict when no arguments provided * `Utils`: * `buildEntities` DSL now have parameter `separator` to specify `TextSource` that will be inserted between other sources ## 0.36.0 **ALL PREVIOUS DEPRECATIONS HAVE BEEN REMOVED** **ALL EXTENSION PACKAGES HAS BEEN RENAMES**. Old packages are still available, but will be removed in next major update: * `tgbotapi.extensions.api` -> `tgbotape.api` * `tgbotapi.extensions.utils` -> `tgbotape.utils` * `tgbotapi.extensions.behaviour_builder` -> `tgbotape.behaviour_builder` * `Common`: * `Version`: * `Serialization`: `1.2.2` -> `1.3.0` * `MicroUtils`: `0.5.28` -> `0.7.2` * `Klock`: `2.4.3` -> `2.4.6` * `Ktor`: `1.6.3` -> `1.6.4` * `Core`: * `PrivateContentMessageImpl#paymentInfo` now is deprecated and will always be null * `PayInlineKeyboardButton#pay` now is deprecated * `RowBuilder` and `MatrixBuilder` now are open and available for extending * `MatrixBuilder#matrix` will return read-only new list instead of original internal `mutMatrix` * Introduced new type of events `SuccessfulPaymentEvent` instead of putting of payment inside of message * New type of events union: `PublicChatEvent`. `CommonEvent` is still union of any `ChatEvent` * New `AbstractFlowsUpdatesFilter` with default `lazy` realization for all typed flows * `FlowsUpdatesFilter` fun now have `onBufferOverflow` and `upstreamUpdatesFlow` as incoming params * `DefaultFlowsUpdatesFilter` now use additional `upstreamUpdatesFlow` as source of updates * `Utils`: * Two new dsl: * `inlineKeyboard` for creating `InlineKeyboardMarkup` * `replyKeyboard` for creating `ReplyKeyboardMarkup` * Cast helpers for `Message` (thanks to [madhead](https://github.com/madhead)): * `asPossiblyReplyMessage`: tries to cast a `Message` to `PossiblyReplyMessage`, returns `null` if the message is not of that type * `requirePossiblyReplyMessage`: casts a `Message` to `PossiblyReplyMessage`, fails if the message is not of that type * `whenPossiblyReplyMessage`: tries to cast a `Message` to `PossiblyReplyMessage` and runs the given block of code with it, if the cast is successful * New type `WithUser` for unioning of all types with `user` * `FromUser` now extends `WithUser` * Cast helpers for type `WithUser`: `asWithUser`, `whenWithUser`, `requireWithUser` * `Behaviour Builder`: * New expecters and waiters: * `waitShippingQueries`/`onShippingQuery` * `waitPreCheckoutQueries`/`onPreCheckoutQuery` * `waitChosenInlineResult`/`onChosenInlineResult` * `waitPollUpdates`/`onPollUpdates` * `Behaviour Builder FSM extension`: * See [Difference between old Behaviour Builder and new one with FSM](https://telegra.ph/Difference-between-old-Behaviour-Builder-and-new-one-with-FSM-10-18) ## 0.35.9 * `Common`: * `Version`: * `Kotlin`: `1.5.30` -> `1.5.31` * `Klock`: `2.4.1` -> `2.4.2` * `MicroUtils`: `0.5.25` -> `0.5.28` * `Core`: * New `BotAction` implementation - `CustomBotAction` * `LocationContent` has been divided to two different types: `LiveLocationContent` and `StaticLocationContent` * `API`: * Two new extensions: `TelegramBot#answer` with `CallbackQuery` and `InlineQuery` * `Behaviour Builder`: * All triggers have been changed to use two filters: filter for in subcontext data and filter for incoming data * New waiters for edited content * New extension `BehaviourContext#followLocation` * New factory-functions: * `BehaviourContextReceiver` * `BehaviourContextAndTypeReceiver` * `BehaviourContextAndTwoTypesReceiver` * Old API for triggers with the flags like `includeFilterByChatInBehaviourSubContext` have been deprecated ## 0.35.8 * `Common`: * `Version`: * `MicroUtils`: `0.5.24` -> `0.5.25` * `UUID`: `0.3.0` -> `0.3.1` * `Core`: * `MultipartRequestCallFactory` now will use file name as multipart `filename` parameter instead of generated file id * New extension `MPPFile#asMultipartFile` * `API` * Fixes in `TelegramBot#withAction` * `Behaviour Builder`: * New extensions `BehaviourContext#commandWithArgs` and `BehaviourContext#onCommandWithArgs` ## 0.35.7 * `Common`: * `Version`: * `Kotlin`: `1.5.21` -> `1.5.30` * `Klock`: `2.3.3` -> `2.4.1` * `Ktor`: `1.6.2` -> `1.6.3` * `Coroutines`: `1.5.1` -> `1.5.2` * `MicroUtils`: `0.5.21` -> `0.5.24` ## 0.35.6 * `Common`: * `Version`: * `Klock`: `2.3.1` -> `2.3.3` * `MicroUtils`: `0.5.19` -> `0.5.21` * `Core`: * All `FlowsUpdatesFilter` flows have been renamed and updated * `Utils`: * Extensions `allSentMessagesFlow` and `allSentMediaGroupsFlow` have been deprecated ## 0.35.5 **MIME TYPES FOR REQUESTS HAVE BEEN DEPRECATED DUE TO REDUNDANCY OF MIME TYPES IN FILES SENDING** * `Core`: * Several new extensions `ByteReadChannel#asStorageFile` and `ByteReadChannelAllocator#asStorageFile` * Several new extensions `ByteArray#asMultipartFile`, `ByteReadChannel#asMultipartFile` and `ByteReadChannelAllocator#asMultipartFile` * New extension `StorageFile#asMultipartFile` * `API`: * New extensions `TelegramBot#downloadFile` for writing of incoming bytes to the file * New extensions `TelegramBot#downloadFileStream` and `TelegramBot#downloadFileStreamAllocator` for getting of input streams instead of whole bytes arrays * Old extensions `TelegramBot#downloadFile` has been replaced to the new package. Migration: replace in your project `import dev.inmo.tgbotapi.extensions.api.downloadFile` with `import dev.inmo.tgbotapi.extensions.api.files.downloadFile` * `PathedFile#filename` extension has been deprecated, and new property `PathedFile#fileName` has been included directly in `PathedFile` * `Utils`: * Add several functions `convertToStorageFile` and extensions `TelegramBot#convertToStorageFile` ## 0.35.4 Hotfix * `Common`: * `Version`: * `MicroUtils`: `0.5.18` -> `0.5.19` ## 0.35.3 * `Common`: * `Version`: * `Klock`: `2.2.0` -> `2.3.1` * `Ktor`: `1.6.1` -> `1.6.2` * `MicroUtils`: `0.5.16` -> `0.5.18` * `Core`: * **`SimpleRequestCallFactory` and `MultipartRequestCallFactory` became a classes instead of objects to avoid collisions in different bots** * Support of strongly-typed ietf language codes has been added * `API`: * New extension `TelegramBot#downloadFile` for any `MediaContent` * `Behaviour Builder`: * New provider `defaultCoroutineScopeProvider` * Now it is not necessary to provide `CoroutineScope` to `TelegramBot#buildBehaviour` extension * New `TelegramBot#buildBehaviour` extension with `FlowUpdatesFilter` and `CoroutineScope` with default `CoroutineScope` * New typealias `SimpleFilter` for unifying triggers filter signatures * All waiters got real filters (`SimpleFilter`) and rename old filters as mappers * New extensions for `Any`: `as`/`when`/`require` for `WithOptionalLanguageCode` and `WithLanguageCode` ## 0.35.2 * `Common`: * `Version`: * `Kotlin`: `1.5.20` -> `1.5.21` * `Coroutines`: `1.5.0` -> `1.5.1` * `Serialization`: `1.2.1` -> `1.2.2` * `Klock`: `2.1.2` -> `2.2.0` * `Ktor`: `1.6.0` -> `1.6.1` * `MicroUtils`: `0.5.15` -> `0.5.16` ## 0.35.1 * `Common`: * `Version`: * `Kotlin`: `1.5.10` -> `1.5.20` * `MicroUtils`: `0.5.6` -> `0.5.15` * `Core`: * New interface `MyCommandsRequest` (also see `Bot API 5.3` below) * New extensions `TextSourcesList#make*String` for all parse modes * All `MessageContent` subclasses now serializable * `ChosenInlineResult` was replaced and modified to be sealed * `ChosenInlineResult` now extends `FromUser` * Added `Update#sourceUser` method * More types assumed as sent by user types now implements `FromUser` interface * Added `Any#whenFromUser`, `Any#asFromUser` and`Any#requireFromUser` extensions * `MedaGroupUpdate` and its direct extenders `SentMediaGroupUpdate` and `EditMediaGroupUpdate` became `sealed interface`s * New built-in `RequestException` implementator `GetUpdatesConflict` has been added * `Behaviour Builder`: * ❗️ All triggers (`on*` extensions) have been modified to work in parallel by some marker by default (new parameter `markerFactory`, in most cases will work async for different chats) * New extensions `telegramBotWithBehaviour` * All behaviour builder extensions got new parameter `defaultExceptionsHandler` * Class `BehaviourContext` was rewritten as an interface with default realization `DefaultBehaviourContext` and factory `BehaviourContext(TelegramBot, CoroutineScope, FlowsUpdatesFilter)` * Extension `buildBehaviour` (and all related extensions/functions) for opportunity to pass `defaultExceptionsHandler` * Trigger `onContentMessage` and waiter `waitContentMessage` now may include media groups * `API`: * All `reply` and subsequent extensions have been replaced in send package * `Utils`: * With class casts like `as*` and `require*` now you may use `when*` with parameter callback * Methods of `EntitiesBuilder` now will return builder itself, so you may create sequences like `buildEntities { bold("Hello,") + italic(" world") }` directly in `buildEntities` body * New extension `TelegramBot#longPollingFlow` has been added with returning value `Flow` with updates * `Bot API 5.3`: * Add type `BotCommandScope`, its serializer `BotCommandScopeSerializer` and all its children * New request `DeleteMyCommands` and updates in `GetMyCommands` and `SetMyCommands` * Renames according to `And more` of [June 25, 2021](https://core.telegram.org/bots/api-changelog#june-25-2021) update ## 0.35.0 **ALL PREVIOUS DEPRECATIONS HAVE BEEN REMOVED** **JS PART NOW USE IR COMPILER ONLY** * `Common`: * `Version`: * `Kotlin`: `1.4.72` -> `1.5.10` * `MicroUtils`: `0.4.36` -> `0.5.6` * `Coroutines`: `1.4.3` -> `1.5.0` * `Serialization`: `1.1.0` -> `1.2.1` * `Klock`: `2.0.7` -> `2.1.2` * `UUID`: `0.2.3` -> `0.3.0` * `Ktor`: `1.5.4` -> `1.6.0` * `Core`: * `ForceReply` has been renamed to `ReplyForce` * `Captioned` and `Explained` interfaces have been removed * `RecordAudioAction` and `UploadAudioAction` (and all related to these actions functionality) have been removed * `TextSource` interface and all related things have been replaced * `CallbackQuery` interface and all its extenders/implementers become `sealed` * `InputMedia` interface and all its extenders/implementers become `sealed` * `ParseMode` interface and all its extenders/implementers become `sealed` * `ChatMember` becomes `sealed` * `KeyboardMarkup` becomes `sealed` * `LeftChatMember` and `MemberChatMember` become interfaces. All their code were replaced to the `*Impl` classes * Most of `sealed` classes have been modified to be interfaces * Most serializers becomes public, but they are still `RistFeature` * For `EntitiesBuilder` multilevel text sources builders with callback have been added ## 0.34.1 * `Common`: * `Version`: * `ktor`: `1.5.3` -> `1.5.4` * `MicroUtils`: `0.4.35` -> `0.4.36` * `Core` * Fix in creating of text sources list ## 0.34.0 _**It is recommended to use [0.34.1](https://github.com/InsanusMokrassar/TelegramBotAPI/releases/tag/0.34.1) version due to the bug in 0.34.0 related to rewriting of `TextSource`s creating mechanism.**_ **UPDATE UP TO Telegram Bot API 5.2** _**ALL OLD DEPRECATIONS WERE REMOVED**_ * `Core`: * Type `ChatType` has been added * New `ExtendedChat` for unknown messages `UnknownExtendedChat` has been added * `SendInvoice#startParameter` becomes optional and replaced in `SendInvoice` constructor * New interface `CommonSendInvoiceData` has been added * Fields `CommonSendInvoiceData#maxTipAmount` and `CommonSendInvoiceData#suggestedTipAmounts` have been added * New type `InputInvoiceMessageContent` has been added * New interface `TextedWithTextSources` on top of `Texted` interface * Interface `TextedInput` now extends `TextedWithTextSources` with overriding of `textSources` field as not nullable * `textSources` become main field in `TextedInput` * **MIGRATION** Remove all `import dev.inmo.tgbotapi.CommonAbstracts.textSources` in your project * `textEntities` become are calculable property in `TextedInput` * Interface `Captioned` and `CaptionedInput` now is deprecated * Most of captions usages were replaced with texts * Interface `Explained` and `ExplainedInput` now is deprecated * Most of captions usages were replaced with texts * Interface `VoiceChatEvent` now is `CommonEvent` * Mechanism of `RawMessageEntity` converting were fully rewritten ## 0.33.4 * `Common`: * `Version`: * `uuid`: `0.2.3` -> `0.2.4` * `MicroUtils`: `0.4.33` -> `0.4.35` * `Core`: * All `TextSource` implementators have become `Serializable` * New serializer `TextSourceSerializer` * Interface`FromUserMessage` now extends `Message` * New interface `FromUser` * Interface `FromUserMessage` now extends `FromUser` * `Extensions Utils` * Fixes in `parseCommandsWithParams` ## 0.33.3 * `Common`: * `Version`: * `MicroUtils`: `0.4.32` -> `0.4.33` * `Ktor`: `1.5.2` -> `1.5.3` * `API`: * Bot actions DSL (fix for [#358](https://github.com/InsanusMokrassar/TelegramBotAPI/issues/358)) * `Behaviour Builder`: * Rewrite logic of `doInSubContextWithUpdatesFilter` and `doInSubContextWithFlowsUpdatesFilterSetup` extensions * All triggers now work with `stopOnCompletion` set up to `false` ## 0.33.2 * `Common`: * `Version`: * `MicroUtils`: `0.4.30` -> `0.4.32` * `Behaviour Builder`: * New typealias `MediaGroupFilter` has been added for `MediaGroup` expectators * Several typealiases became `suspend`: * `CallbackQueryMapper` * `ChatMemberUpdatedMapper` * `InlineQueryMapper` * Commands got an additional parameter - `additionalFilter`. It will be called when all command filters were passed ## 0.33.1 * `Common`: * `Version`: * `Kotlin`: `1.4.31` -> `1.4.32` * `MicroUtils`: `0.4.29` -> `0.4.30` * `Klocks`: `2.0.6` -> `2.0.7` * `Utils Extensions`: * Add extensions `parseCommandsWithParams` ## 0.33.0 **UPDATE UP TO Telegram Bot API 5.1** _**ALL DEPRECATIONS WERE REMOVED**_ * `Common`: * `Version`: * `MicroUtils`: `0.4.28` -> `0.4.29` * `Core`: * `AdministratorChatMemberSerializer` and `ChatMemberSerializer` has changed their visibility: they are public for now * Add `ChatInviteLinkRequest` with subrequests like `KnownChatInviteLinkRequest` * Add `CreateChatInviteLink`/`EditChatInviteLink`/`RevokeChatInviteLink` requests * Update `KickChatMember` to include `revokeMessages` flag * Update `PromoteChatMember` to include `canManageVoiceChats` and `canManageChat` flags * Add `ChatInviteLink` object * Add `PrimaryInviteLink` for `ChatInviteLink` with `isPrimary == true` * Add `CommonInviteLink` for `ChatInviteLink` with `isPrimary == false` * `AdministratorChatMemberSerializer` has been set as public for several versions * `ChatMemberSerializer` has been set as public for several versions * Add `ChatMemberUpdated` * Add `MessageAutoDeleteTimerChanged` * Add `VoiceChatEvent` * Add `VoiceChatEnded` * Add `VoiceChatParticipantsInvited` * Add `VoiceChatStarted` * Add `ChatMemberUpdatedUpdate` * Add `CommonChatMemberUpdatedUpdate` * Add `MyChatMemberUpdatedUpdate` * `API`: * All API extensions has been updated * `Behaviour Builder`: * Now content triggers and expectators will wait for channel posts too * New waiters and triggers for `ChatMemberUpdated` and its variations ## 0.32.9 * `Common`: * `Version`: * `Kotlin`: `1.4.30` -> `1.4.31` * `Ktor`: `1.5.1` -> `1.5.2` * `MicroUtils`: `0.4.26` -> `0.4.28` * `Coroutines`: `1.4.2` -> `1.4.3` ## 0.32.8 * `Common`: * `Version`: * `Serialization`: `1.1.0-RC` -> `1.1.0` * `MicroUtils`: `0.4.25` -> `0.4.26` ## 0.32.7 * `Core`: * New variable `LeftRestrictionsChatPermissions` and `RestrictionsChatPermissions` * `Extensions Utils`: * `DiceAnimationType` class casts * `Behaviour Builder`: * Now `doInSubContextWithUpdatesFilter` and `doInSubContext` will automatically subscribe on updates of parent `BehaviourContext` * `doInSubContextWithFlowsUpdatesFilterSetup`, `doInSubContextWithUpdatesFilter` and `doInSubContext` got new parameter `stopOnCompletion` to be able to disable stopping of behaviour context on finishing ## 0.32.6 * `Common`: * `Version`: * `MicroUtils`: `0.4.24` -> `0.4.25` * `Extensions API`: * New extension `TelegramBot#replyWithDice` * `Extensions Utils`: * `SlotMachineReelImages` has been renamed to `SlotMachineReelImage` * `SlotMachineReelImage` got two built-in parameters: `text` and `number` * New extension `String#asSlotMachineReelImage` ## 0.32.5 * `Core`: * Add `mention` variants for user ids and receiver variants ([#294](https://github.com/InsanusMokrassar/TelegramBotAPI/issues/294)) * Now `AbstractRequestCallFactory` will set up one-second delay for zero timeouts in `GetUpdate` requests * Several extensions for `TelegramBotAPI` like `retrieveAccumulatedUpdates` have been added as a solution for [#293](https://github.com/InsanusMokrassar/TelegramBotAPI/issues/293) * Links for `tg://user?id=` have been updated ([#292](https://github.com/InsanusMokrassar/TelegramBotAPI/issues/292)) * All usages of captions or texts in resends and same things have been replaced with `textSources` * Global `defaultParseMode` has been added ([#291](https://github.com/InsanusMokrassar/TelegramBotAPI/issues/291)) ## 0.32.4 * `Common`: * `Version`: * `Kotlin`: `1.4.21` -> `1.4.30` * `Klock`: `2.0.4` -> `2.0.6` * `MicroUtils`: `0.4.23` -> `0.4.24` * `Core`: * Renames: * `ChannelMessage` -> `ChannelContentMessage` * `PublicMessage` -> `PublicContentMessage` * `GroupMessage` -> `GroupContentMessage` * `FromChannelGroupMessage` -> `FromChannelGroupContentMessage` * `AnonymousGroupMessage` -> `AnonymousGroupContentMessage` * `CommonGroupMessage` -> `CommonGroupContentMessage` * `PrivateMessage` -> `PrivateContentMessage` * `Extensions Utils`: * Renames of extensions in `ClassCasts` according to changes in `Core` ## 0.32.3 * `Behaviour Builder`: * Add expectators and waiters for inline queries ## 0.32.2 * `Core`: * Fix of [#275](https://github.com/InsanusMokrassar/TelegramBotAPI/issues/275) ## 0.32.1 * `Core`: * Fix of [#272](https://github.com/InsanusMokrassar/TelegramBotAPI/issues/272) * `Utils`: * Fix of [#273](https://github.com/InsanusMokrassar/TelegramBotAPI/issues/273) ## 0.32.0 **THIS UPDATE CONTAINS BREAKING CHANGES** * `Common`: * `Version`: * `MicroUtils`: `0.4.16` -> `0.4.23` * `Klock`: `0.2.3` -> `0.2.4` * `Ktor`: `1.5.0` -> `1.5.1` * `Core`: * **BREAKING CHANGE** Now `MediaGroupMessage` have a generic type related to `MediaGroupContent` * Methods and types related to `MediaGroupMessage` have been modified according to their meanings * **Important Change** `FlowsUpdatesFilter` now is an interface. Old class has been renamed to `DefaultFlowsUpdatesFilter` and factory method `FlowsUpdatesFilter` has been added * **PASSPORT** Full support of `Telegram Passport API` * `PassportData` * All variants of `EncryptedPassportElement` * All variants of `SecureValue` * All variants of `PassportElementError` * New request `SetPassportDataErrors` * `Credentials`: * `EncryptedCredentials` * `DeryptedCredentials` * `EndDataCredentials` * `Behaviour Builder`: * Trigger and expectation extensions for `MessageContent` (`onContentMessage` and `waitContentMessage`) * `onMediaGroup` has been replaced * `waitMediaGroup` has been added * `onVisualMediaGroup` now is just an alternative to `onVisualGallery` * `command` and `onCommand` expectations has been added for commands `String` variant * New extensions `BehaviourContext#oneOf`, `BehaviourContext#parallel` and `Deferred#withAction` * Several renames: * `waitAudioMediaGroup` -> `waitAudioMediaGroupContent` * `waitDocumentMediaGroup` -> `waitDocumentMediaGroupContent` * `waitMediaGroup` -> `waitAnyMediaGroupContent` * `waitVisualMediaGroup` -> `waitVisualMediaGroupContent` * New extensions `BehaviourContext#waitPassportMessagesWith` and `BehaviourContext#waitAnyPassportMessages` * New extensions `BehaviourContext#onPassportMessage` and `BehaviourContext#onPassportMessageWith` * `Utils`: * New `ClassCasts` for * `Message` * **PASSPORT** `EncryptedPassportElement` * **PASSPORT** `PassportElementError` * **PASSPORT** `SecureValue` * Several tools for decryption have been added: * `AESDecryptor` is available for `JVM` platform * Extensions `EncryptedCredentials#decryptWithPKCS8PrivateKey` are available for `JVM` platform * Extensions `EndDataCredentials#decryptData` and `FileCredentials#decryptFile` have been added * Several extensions `createDecryptor` * Several extensions `doInDecryptionContextWithPKCS8Key` * New extension `Flow#passportMessages` * In most of webhook setting up functions/methods now available parameter `mediaGroupsDebounceTimeMillis` * `API`: * **PASSPORT** New extensions `TelegramBot#setPassportDataErrors` ## 0.31.0 **THIS UPDATE CONTAINS BREAKING CHANGES** * `Common`: * **ALL DEPRECATIONS CREATED SINCE 0.30.0 WERE REMOVED** * `Behaviour Builder`: * Extension `TelegramBot#buildBehaviour` have changed its return value: now it is `Job` instead of `FlowsUpdatesFilter` * `Utils` * New extensions `TelegramBot#longPolling` were added as new recommended way to start getting updates via long polling * Old extensions `RequestsExecutor#startGettingFlowsUpdatesByLongPolling` has been deprecated ## 0.30.13 * `Common`: * `Version`: * `MicroUtils`: `0.4.15` -> `0.4.16` * `Core`: * New variable `FlowsUpdatesFilter#allUpdatesWithoutMediaGroupsGroupingFlow` which will contains updates without `SentMediaGroupUpdate` * `Utils`: * Extensions for `ResendableContent` has been added * Extensions for `TextSource` has been added * `Behaviour Builder`: * Project has been created :) ## 0.30.12 * `Utils`: * Class casts has been added. Now you can write something like `message.asGroupMessage() ?.let { ... }` instead of `(message as? GroupMessage<*>) ?.let { ... }` ## 0.30.11 * `Common`: * `Version`: * `MicroUtils`: `0.4.11` -> `0.4.15` * `Klock`: `2.0.1` -> `2.0.3` * `Ktor`: `1.4.3` -> `1.5.0` * `Core`: * All bot actions got functions for short calling, like `recordVideo` for `RecordVideoNote` * All bot actions got class-cast shortcuts ## 0.30.10 * `Common`: * `Version`: * `Kotlin`: `1.4.20` -> `1.4.21` * `Klock`: `2.0.0` -> `2.0.1` * `Ktor`: `1.4.2` -> `1.4.3` * `MicroUtils`: `0.4.6` -> `0.4.11` * `API Extensions`: * New function `buildBot` ## 0.30.9 * `Common`: * `Version`: * `UUID`: `0.2.2` -> `0.2.3` * `Coroutines`: `1.4.1` -> `1.4.2` * `MicroUtils`: `0.4.3` -> `0.4.6` * `Core`: * Add `BowlingDiceAnimationType` ## 0.30.8 * `Common`: * `Version`: * `Kotlin`: `1.4.10` -> `1.4.20` * `Klock`: `1.12.1` -> `2.0.0` * `MicroUtils`: `0.4.1` -> `0.4.3` ## 0.30.7 * `Common`: * `Version`: * `MicroUtils`: `0.4.0` -> `0.4.1` * `Core`: * `TelegramAPIUrlsKeeper` will fix ending of host url since this version * New mechanisms in`PowLimiter` and `CommonLimiter` has been added * New builder `KtorRequestsExecutorBuilder` * New function `telegramBot` * `Utils`: * Simple function `telegramBot(TelegramAPIUrlsKeeper)` has been deprecated with replacement by almost the same function in `Core` ## 0.30.6 * `Core` * `TextSource` properties has been renamed: * `asMarkdownSource` -> `markdown` * `asMarkdownV2Source` -> `markdownV2` * `asHtmlSource` -> `html` * `PrivateChat` override `id` property with type `UserId` * Several new extensions and functions in links creation: * New function `makeUsernameLink` with parameter `String` * New extension `Username#link` and function `makeLink(Username)` * Function `makeLinkToMessage` now able to get any type of chat * New extension `Message#link` * Old functions `makeLinkToAddStickerSet...` has been deprecated: * `makeLinkToAddStickerSet` * `makeLinkToAddStickerSetInMarkdownV2` * `makeLinkToAddStickerSetInMarkdown` * `makeLinkToAddStickerSetInHtml` ## 0.30.5 * `Common`: * `Version`: * `MicroUtils`: `0.3.3` -> `0.4.0` * `Core`: * Mechanism of `ChatMember` serialization has been changed * Since this version any `ChatMember` can be serialized (even outside in case it marked by `@Serializable`) * Since this version any `ChatMember` (included in this project) can be deserialized in common way * `User` property `id` has changed its type: now it is `UserId` (under the hood it is the same as `ChatId`) ## 0.30.4 * `Common`: * `Version`: * `MicroUtils`: `0.3.1` -> `0.3.3` * `Core`: * `MultilevelTextSource#textSources` has been safely renamed to `subsources` * `TextContent#fullEntitiesList` has been deprecated * Now `TextContent` implements `TextedInput` * `TextContent#entities` has been deprecated * `GroupEventMessage` now overrides `chatEvent` with type `GroupEvent` * `SupergroupEventMessage` now overrides `chatEvent` with type `SupergroupEvent` * Any `ChatEventMessage` now have generic type of its `chatEvent` (just like messages) * `Utils`: * Old extensions related to chat events are deprecated: * `Flow>#divideBySource` * `Flow>#onlyChannelEvents` * `Flow>#onlyGroupEvents` * `Flow>#onlySupergroupEvents` * A lot of extensions for `Flow` has been added: * `FlowsUpdatesFilter#events` * `FlowsUpdatesFilter#channelEvents` * `FlowsUpdatesFilter#groupEvents` * `FlowsUpdatesFilter#supergroupEvents` * And a lot of other filters with specific types ## 0.30.3 * `Common`: * `Version`: * `MicroUtils`: `0.3.0` -> `0.3.1` * `Core`: * New type of requests exceptions `TooMuchRequestsException`. In fact it will be rare case when you will get this exception * `EmptyLimiter` has been renamed to `ExceptionsOnlyLimiter` and currently will stop requests after `TooMuchRequestsException` happen until retry time is actual * Now `ExceptionsOnlyLimiter` (previously `EmptyLimiter`) is a class * `AbstractRequestCallFactory` currently will not look at the response and wait if it have `RetryAfter` error. New behaviour aimed on delegating of this work to `RequestsLimiter` ## 0.30.2 * `Common`: * `Version`: * `Ktor`: `1.4.1` -> `1.4.2` * `Core`: * New sealed class `SetWebhookRequest` which can be used in `SetWebhook` requests * `Utils`: * Extensions `setWebhookInfoAndStartListenWebhooks` has been united in one extension with `SetWebhookRequest` incoming parameter ## 0.30.1 * `Common`: * `Version`: * `MicroUtils`: `0.2.7` -> `0.3.0` * `Utils`: * Builder-style DSL for text sources - `buildEntities` (thanks to [djaler](https://github.com/djaler)) ## 0.30.0 Bot API 5.0 **THIS UPDATE CONTAINS A LOT OF BREAKING CHANGES. PLEASE, BE CAREFUL ON UPGRADING OF YOUR PROJECT** * `Common`: * `Version`: * `Coroutine`: `1.4.0` -> `1.4.1` * **NEW** `MicroUtils`: `0.2.7` * `Core`: * Support of `logOut` method (`LogOut` object as a `Request`) * Support of `close` method (`Close` object as a `Request`) * `SetWebhook` updates: * New field `ipAddress`. It works the same as `ip_address` in [setWebhook](https://core.telegram.org/bots/api#setwebhook) section * New field `dropPendingUpdates`. It works the same as `drop_pending_updates` in [setWebhook](https://core.telegram.org/bots/api#setwebhook) section * New field `ExtendedPrivateChat#bio` * New data class `ChatLocation` * New field `UnbanChatMember#onlyIfBanned` * New fields `ExtendedChannelChat#linkedGroupChatId` and `ExtendedSupergroupChat#linkedChannelChatId` * New fields `ExtendedSupergroupChat#location` * New fields `AudioFile#fileName` and `VideoFile#fileName` * New fields `SendDocument#disableContentTypeDetection` and `InputMediaDocument#disableContentTypeDetection` * New request `UnpinAllChatMessages` * New parameter for `unpinChatMessage` method: `messageId` * New dice type `FootballDiceAnimationType` * Limits for dices has been changed * `commonDiceResultLimit` has been deprecated * New field `DiceAnimationType#valueLimits` * Locations updates: * New interface `Headed` with property `heading` * New interface `HorizontallyAccured` with property `horizontalAccuracy` * New interface `ProximityAlertable` with property `proximityAlertRadius` * `Location` class has been separated: * `StaticLocation` for static locations * `LiveLocation` for live locations * Property `Livable#livePeriod` now use typealias type `Seconds` (the same by meaning - `Int`) * `EditLocationMessage` now extends `Locationed`, `HorizontallyAccured`, `ProximityAlertable` and `Headed` interfaces * New properties in `EditChatMessageLiveLocation`: `horizontalAccuracy`, `heading`, `proximityAlertRadius` * New properties in `EditInlineMessageLiveLocation`: `horizontalAccuracy`, `heading`, `proximityAlertRadius` * Main constructor of `SendLocation` now is internal. Instead of that currently available next factories: * `SendLocation` - sending of static location without live parameters * `SendStaticLocation` - sending of static location without live parameters * `SendLiveLocation` - sending of live location with live parameters * `PositionedSendMessageRequest` now extends `Locationed` * `LocationContent#createResend` now can create `LiveLocation` * Support of `ProximityAlertTriggered`. It is `CommonEvent` * Property `pollQuestionTextLength` now have maximum up to `300` * Anonymous Admins: * New field `AdministratorChatMember#isAnonymous` * Several new interfaces of messages: * `SignedMessage` - any message which possibly have `authorSignature` * `WithSenderChatMessage` - any message which have `senderChat`. Property `senderChat` is not-nullable due to separation of implementators * `PublicMessage` - all channel messages have property `val chat: PublicChat` instead of common `val chat: Chat` * `ChannelMessage` - all channel messages have property `val chat: ChannelChat` instead of common `val chat: Chat` * Old `ChannelMessage` was safely renamed to `ChannelMessageImpl` (old name was set as typealias and deprecated) * `GroupMessage` - all group messages have property `val chat: GroupChat` instead of common `val chat: Chat` * `FromChannelGroupMessage` - instances should have property `val channel: ChannelChat` * `AnonymousGroupMessage` - instances may have setup property `authorSignature` * `CommonGroupMessage` - just common message * `PrivateMessage` - works like previous `CommonMessageImpl` * Previous `CommonMessageImpl` safely renamed to `PrivateMessageImpl` * New property `PromoteChatMember#isAnonymous` * Update all classes which must have `entities`/`caption_entities` fields * New request `CopyMessage` * New extension `List#makeString` for more comfortable work with new api with entities * Support for Google Places identifiers for venues * New extensions for text sources separating: * `List#separateForMessage` * `List#separateForCaption` * `List#separateForText` * Rewritten work with text sources and text parts: * Now any `Message` type with entities will have full list of entities. That means that parts without any formatter entities will use `RegularTextSource` * `MultilevelTextSource#textParts` has been deprecated. Now each `MultilevelTextSource` have its own `textSources` list * New dsl for creating of `TextSource` lists * Built-in `handleSafely` and `ExceptionHandler` is deprecated * New common factories for `StorageFile` * `API`: * Extensions `TelegramBot#pinChatMessage` now support any `Chat` and `Message`s from any `Chat` * New extensions `TelegramBot#unpinAllChatMessages` * Extensions `TelegramBot#promoteChatMember` got `isAnonymous` parameter * All old api methods has been actualized to their analogs in `Core` * All `telegramBot` with `token: String` got `apiUrl` parameter * Factory `telegramBotWithCustomClientConfig` has been renamed to `telegramBot` ## 0.29.4 * `Core`: * `diceResultLimit` now is deprecated, use `commonDiceResultLimit` instead * New extension `slotMachineDiceResultLimit` * `Utils`: * New enum `SlotMachineReelImages` * New extension `Int#asSlotMachineReelImage` * New data class `SlotMachineResult` * New extension `Dice#calculateSlotMachineResult` ## 0.29.3 * `Common`: * Version updates: * `Serialization`: `1.0.0` -> `1.0.1` * `Core`: * New annotation `RiskFeature`. This annotation will be applied to the things which contains unsafe types usage * `SendMediaGroup` factory now marked with `RiskFeature` * Media groups updates: * New functions `SendPlaylist` * New functions `SendDocumentsGroup` * New functions `SendVisualMediaGroup` * New type `VisualMediaGroupMemberInputMedia : MediaGroupMemberInputMedia` * `InputMediaPhoto` now implements `VisualMediaGroupMemberInputMedia` instead of `MediaGroupMemberInputMedia` * `InputMediaVideo` now implements `VisualMediaGroupMemberInputMedia` instead of `MediaGroupMemberInputMedia` * New type `VisualMediaGroupContent : MediaGroupContent` * `PhotoContent` now implements `VisualMediaGroupContent` instead of `MediaGroupContent` * `VideoContent` now implements `VisualMediaGroupContent` instead of `MediaGroupContent` * New type `AudioMediaGroupContent : MediaGroupContent` * `AudioContent` now implements `AudioMediaGroupContent` instead of `MediaContent` and `CaptionedInput` * New type `DocumentMediaGroupContent : MediaGroupContent` * `DocumentContent` now implements `DocumentMediaGroupContent` instead of `MediaContent` and `CaptionedInput` * New type `AudioMediaGroupMemberInputMedia : MediaGroupMemberInputMedia` * `InputMediaAudio` now implements `AudioMediaGroupMemberInputMedia` * New type `DocumentMediaGroupMemberInputMedia : MediaGroupMemberInputMedia` * `InputMediaDocument` now implements `DocumentMediaGroupMemberInputMedia` * New extension `AudioFile#toInputMediaAudio` * `AudioContent` now implements `MediaGroupContent` * New extension `DocumentFile#toInputMediaDocument` * `DocumentContent` now implements `MediaGroupContent` * New dice type `SlotMachineDiceAnimationType` * New extension `TelegramMediaFile#asDocumentFile` * New extension `VideoFile#toInputMediaVideo` * New exception `WrongFileIdentifierException` * Extension `String#toInputMediaFileAttachmentName` now is deprecated * Property `ThumbedInputMedia#thumbMedia` now is deprecated * `API`: * New extensions for media groups: * `TelegramBot#sendPlaylist` * `TelegramBot#replyWithPlaylist` * `TelegramBot#sendDocumentsGroup` * `TelegramBot#replyWithDocumentsGroup` * `TelegramBot#sendVisualMediaGroup` * `TelegramBot#replyWithVisualMediaGroup` * `Utils`: * New extensions for `Flow`s: * `Flow#mediaGroupVisualMessages` * `Flow#mediaGroupAudioMessages` * `Flow#mediaGroupDocumentMessages` * New extensions for `FlowsUpdatesFilter`: * `FlowsUpdatesFilter#audioMessagesWithMediaGroups` * `FlowsUpdatesFilter#mediaGroupAudioMessages` * `FlowsUpdatesFilter#documentMessagesWithMediaGroups` * `FlowsUpdatesFilter#mediaGroupDocumentMessages` * `FlowsUpdatesFilter#mediaGroupVisualMessages` ## 0.29.2 * `Common`: * Version updates: * `Coroutines`: `1.3.9` -> `1.4.0` * Internal broadcast channels were replaced with `SharedFlow` * `TelegramBotAPI-extensions-utils`: * Extension `ReceiveChannel#debounceByValue` has been deprecated ## 0.29.1 * `Common`: * Version updates: * `Serialization`: `1.0.0-RC2` -> `1.0.0` ## 0.29.0 * **THIS VERSION CONTAINS BREAKING CHANGES** * ***PROJECT PACKAGES WERE CHANGED*** * Packages in the whole project were changed `com.github.insanusmokrassar.TelegramBotAPI` -> `dev.inmo.tgbotapi` * Project group in repositories were changed: `com.github.insanusmokrassar` -> `dev.inmo` * Migration ([Examples migration](https://github.com/InsanusMokrassar/TelegramBotAPI-examples/pull/11)): 1. Change implementation in your gradle files: * `implementation "com.github.insanusmokrassar:TelegramBotAPI-core:*"` -> `implementation "dev.inmo:tgbotapi.core:*"` * `implementation "com.github.insanusmokrassar:TelegramBotAPI-extensions-utils:*"` -> `implementation "dev.inmo:tgbotapi.extensions.utils:*"` * `implementation "com.github.insanusmokrassar:TelegramBotAPI-extensions-api:*"` -> `implementation "dev.inmo:tgbotapi.extensions.api:*"` * `implementation "com.github.insanusmokrassar:TelegramBotAPI:*"` -> `implementation "dev.inmo:tgbotapi:*"` 2. Replace packages `com.github.insanusmokrassar.TelegramBotAPI` in the whole project by `dev.inmo.tgbotapi` * `TelegramBotAPI-core`: * Now in forward info you can get `ForwardFromSupergroupInfo` * **BREAKING CHANGE** `SendVoice` factory function has changed its signature: now it have now `thumb` (according to the [documentation](https://core.telegram.org/bots/api#sendvoice)) * `AudioFile` now can be converted to `VoiceFile` * `VoiceFile` now can be converted to `AudioFile` * `TelegramBotAPI-extensions-api`: * ALL REQUESTS EXECUTOR USAGES WERE REPLACED WITH `TelegramBot` TYPEALIAS. It should not bring any break changes * Internal changes of `sendRegularPoll` and `sendQuizPoll` extensions * Variable `defaultLivePeriodDelayMillis` now is public * All `send` extensions for `TelegramBot` got their `reply` variations (issue [#144](https://github.com/InsanusMokrassar/TelegramBotAPI/issues/144)) * A lot of `send` extensions for `TelegramBot` got their variation with `Chat` instead of `ChatIdentifier` ## 0.28.4 * `Common`: * Version updates: * `Ktor`: `1.4.0` -> `1.4.1` * `TelegramBotAPI-core` * Interface `GroupEventMessage` has been added ([#140](https://github.com/InsanusMokrassar/TelegramBotAPI/pull/140)) * Old `GroupEventMessage` was renamed to `CommonGroupEventMessage` ([#140](https://github.com/InsanusMokrassar/TelegramBotAPI/pull/140)) * Interface `SupergroupEventMessage` has been added ([#140](https://github.com/InsanusMokrassar/TelegramBotAPI/pull/140)) * Old `SupergroupEventMessage` was renamed to `CommonSupergroupEventMessage` ([#140](https://github.com/InsanusMokrassar/TelegramBotAPI/pull/140)) * Any `GroupEventMessage` now have `from` field ([#140](https://github.com/InsanusMokrassar/TelegramBotAPI/pull/140)) * `TelegramBotAPI-extensions-utils` * Extensions `Flow#onlyGroupEvents` and `Flow#onlySupergroupEvents` now returns `CommonGroupEventMessage` and `CommonSupergroupEventMessage` ## 0.28.3 * Common: * Version updates: * `Klock`: `0.12.0` -> `0.12.1` * `Kotlin serialization`: `1.0.0-RC` -> `1.0.0-RC2` (dependency `kotlinx-serialization-core` was replaced with `kotlinx-serialization-json` due to [kotlinx.serialization library update](https://github.com/Kotlin/kotlinx.serialization/blob/master/CHANGELOG.md#100-rc2--2020-09-21)) * `TelegramBotAPI-core`: * All `InlineQueryResult` has changed their type of id for more obvious relation between `InlineQueryResult#id` and `ChosenInlineResult#resultId`: `String` -> `InlineQueryIdentifier` * `TelegramBotAPI-extensions-utils`: * Several extensions for updates flows based on `InlineQueryUpdate` has been added: * `Flow#onlyBaseInlineQueriesWithUpdates` * `Flow#onlyBaseInlineQueries` * `Flow#onlyLocationInlineQueriesWithUpdates` * `Flow#onlyLocationInlineQueries` * Several extensions for updates flows based on `ChosenInlineResultUpdate` has been added: * `Flow.onlyBaseChosenInlineResultsWithUpdates` * `Flow.onlyBaseChosenInlineResults` * `Flow.onlyLocationChosenInlineResultsWithUpdates` * `Flow.onlyLocationChosenInlineResults` ## 0.28.2 * `TelegramBotAPI-extensions-utils`: * Several commands shortcuts for `Flow>` has been added: * `filterExactCommands` * `filterCommandsInsideTextMessages` * `filterCommandsWithArgs` * Extension `Flow.filterCommandsWithArgs` has changed its signature: now it will also have original message paired with list of text sources * Shortcut method `commonMessages` for `onlyCommonMessages` * Shortcuts `onlySentViaBot` and `withoutSentViaBot` now are extensions for any `Flow` with types which implementing `ContentMessage` ## 0.28.1 * Common: * Versions updates: * `Kotlin`: `1.4.0` -> `1.4.10` * `UUID`: `0.2.1` -> `0.2.2` * `TelegramBotAPI-core`: * `ExceptionHandler` has changed its incoming type: `Exception` -> `Throwable` * `handleSafely` has changed its signature * `executeUnsafe` has changed its signature ## 0.28.0 * **THIS VERSION CONTAINS BREAKING CHANGES** * ***PROJECT PACKAGES WERE CHANGED*** * Project `TelegramBotAPI` -> `TelegramBotAPI-core` * Project `TelegramBotAPI-all` -> `TelegramBotAPI` * `Common`: * Version updates: * `Kotlin`: `1.3.72` -> `1.4.0` * `Coroutines`: `1.3.8` -> `1.3.9` * `Serialization`: `0.20.0` -> `1.0.0-RC` * `Klock`: `1.11.14` -> `1.12.0` * `UUID`: `0.1.1` -> `0.2.1` * `Ktor`: `1.3.2` -> `1.4.0` * `buildMimeType` function now is cache-oriented getter which will save already got mime types into internal map * All deprecations from previous versions were removed * `TelegramBotAPI-core`: * Typealias `TelegramBot` was added * Fully rebuilt `KtorCallFactory` interface to be able to handle custom answers from telegram bot api system * New implementation of `KtorCallFactory` was added: `DownloadFileRequestCallFactory` * `DownloadFile` request was added * All included `KtorCallFactory` realizations (except of abstract) now are objects: * `MultipartRequestCallFactory` * `SimpleRequestCallFactory` * `MediaGroupMemberInputMedia` members now will not have `arguments` property due to redundancy and buggy of that * Field `media` now is common for all `InputMedia` objects * `TelegramBotAPI-extensions-api`: * Extensions `TelegramBot#downloadFile` were added * `TelegramBotAPI-extensions-utils`: * All extensions for media groups (except of `mediaGroupId`) have changed their context: `List` -> `List>` * `forwardInfo` * `replyTo` * `chat` * `createResend` (several extensions) * Several extensions for downloading of files: * `HttpClient#loadFile` * `PathedFile#download` ## 0.27.11 * `TelegramBotAPI`: * Extension `String#filenameFromUrl` was created * Extension `PathedFile#filename` was created * `TelegramBotAPI-extensions-utils`: * `Flow>.flatMap` extension was added * Extensions for `FlowUpdatesFilter` were added: * `FlowsUpdatesFilter#allSentMessagesFlow` (combination of `messageFlow` and `channelPostFlow`) * `FlowsUpdatesFilter#allSentMediaGroupsFlow` (combination of `messageMediaGroupFlow` and `channelPostMediaGroupFlow`) * `FlowsUpdatesFilter#sentMessages` * `FlowsUpdatesFilter#sentMessagesWithMediaGroups` * `FlowsUpdatesFilter#photoMessagesWithMediaGroups` * `FlowsUpdatesFilter#imageMessagesWithMediaGroups` * `FlowsUpdatesFilter#videoMessagesWithMediaGroups` * `FlowsUpdatesFilter#mediaGroupMessages` * `FlowsUpdatesFilter#mediaGroupPhotosMessages` * `FlowsUpdatesFilter#mediaGroupVideosMessages` * A lot of extensions like `Flow#textMessages` were added: * `Flow#animationMessages` * `Flow#audioMessages` * `Flow#contactMessages` * `Flow#diceMessages` * `Flow#documentMessages` * `Flow#gameMessages` * `Flow#invoiceMessages` * `Flow#locationMessages` * `Flow#photoMessages` * `Flow#imageMessages` * `Flow#pollMessages` * `Flow#stickerMessages` * `Flow#textMessages` * `Flow#venueMessages` * `Flow#videoMessages` * `Flow#videoNoteMessages` * `Flow#voiceMessages` * `Flow#mediaGroupMessages` * `Flow#mediaGroupPhotosMessages` * `Flow#mediaGroupVideosMessages` ## 0.27.10 * `TelegramBotAPI-extensions-api`: * Function `telegramBot(TelegramAPIUrlsKeeper)` was added * `TelegramBotAPI-extensions-utils`: * Extension `Route#includeWebhookHandlingInRouteWithFlows` was added * A lot of extensions like `FlowsUpdatesFilter#textMessages` were added: * `FlowsUpdatesFilter#animationMessages` * `FlowsUpdatesFilter#audioMessages` * `FlowsUpdatesFilter#contactMessages` * `FlowsUpdatesFilter#diceMessages` * `FlowsUpdatesFilter#documentMessages` * `FlowsUpdatesFilter#gameMessages` * `FlowsUpdatesFilter#invoiceMessages` * `FlowsUpdatesFilter#locationMessages` * `FlowsUpdatesFilter#photoMessages` * `FlowsUpdatesFilter#imageMessages` * `FlowsUpdatesFilter#pollMessages` * `FlowsUpdatesFilter#stickerMessages` * `FlowsUpdatesFilter#textMessages` * `FlowsUpdatesFilter#venueMessages` * `FlowsUpdatesFilter#videoMessages` * `FlowsUpdatesFilter#videoNoteMessages` * `FlowsUpdatesFilter#voiceMessages` ## 0.27.9 * `Common` * Versions updates: * `Gradle Wrapper`: `6.5-all` -> `6.5.1-bin` * `Coroutines`: `1.3.7` -> `1.3.8` * `Klock`: `1.11.3` -> `1.11.14` * `UUID`: `0.1.0` -> `0.1.1` ## 0.27.8 * `TelegramBotAPI`: * `UnknownUpdateType` was renamed to `UnknownUpdate` * Refactoring and optimization of `FlowsUpdatesFilter` * `Venue` type was replaced to a new package: `com.github.insanusmokrassar.TelegramBotAPI.types.venue.Venue` * `Venue` type now implements `Locationed` and delegate realisation to its `location` field * `FoursquareId` and `FoursquareType` typealiases were added * `TelegramBotAPI-extensions-utils`: * Several new functions `makeLinkToMessage` was added * `Foursquare` data class was added * Extension `Venue#foursquare` was added * Factory function `Venue` with `Foursquare` parameter was added ## 0.27.7 * `TelegramBotAPI`: * Operator function `unaryPlus` was added to `RowBuilder`. Now it is possible to write `row { +button }` * Function `flatMatrix` was added for single-row columns * Operator extension `RowBuilder#plus` was added to be able to write things like `row { this + button }` * `TelegramBotAPI-extensions-api`: * Extensions `RequestsExecutor#sendVenue` with `Location` args were added * `TelegramBotAPI-extensions-utils`: * Function `InlineKeyboardMarkup` for flat keyboards was added * Function `ReplyKeyboardMarkup` for flat keyboards was added ## 0.27.6 * `Common`: * Versions: * `Kotlin Coroutines`: `1.3.6` -> `1.3.7` * `TelegramBotAPI`: * Interface `PossiblySentViaBot` has been added * Additional interface `PossiblySentViaBotCommonMessage` was added for more explicit typing declaration for compiler * Currently, only `ChannelMessage` and `CommonMessageImpl` are implementing the interface `PossiblySentViaBotCommonMessage`. It could be changed in future * Factory `buildMimeType` was added * `BuiltinMimeTypes` was added * Abstraction `ThumbedWithMimeTypeInlineQueryResult` with `thumbMimeType` field was added * `InlineQueryResultGif` and `InlineQueryResultMpeg4Gif` now extend `ThumbedWithMimeTypeInlineQueryResult` instead of `ThumbedInlineQueryResult` * `TelegramBotAPI-extensions-utils`: * New extensions `onlyCommonMessages`, `onlySentViaBot` and `withoutSentViaBot` was added ## 0.27.5 * `Common`: * Versions: * `Klock`: `1.11.1` -> `1.11.3` * `TelegramotAPI`: * Fix: for sending requests caption and text lengths limits were updated * New variant of `row` was added * `makeLinkToMessage` extensions has been deprecated (replaced into `TelegramBotAPI-extensions-utils`) * Next things was deprecated and replaced into `TelegramBotAPI-extensions-utils`: * All `String` formatting public extensions and functions * All extensions like `CaptionedInput#toHtmlCaptions` * All helper extensions for `List` * All `RequestsExecutor#executeAsync` and `RequestsExecutor#executeUnsafe` * `BotCommand` now more strictly check commands which passed to it * Regex `BotCommandNameRegex` was added * `TelegramBotAPI-extensions-api`: * A lot of `RequesstExecutor#getChat` extensions was added for more explicit types showing * New `RequesstExecutor#setMyCommands` extension was added * New field `BotBuilder#ktorClientEngineFactory` introduced * Field `BotBuilder#ktorClientEngine` now is deprecated * `TelegramBotAPI-extensions-utils`: * `safely` function was introduced. It is in `PreviewFeature` state currently * `makeLinkToMessage` extensions has been added * `makeLinkToAddStickerSet` function and its variations were added * Next tools was added from `TelegramBotAPI`: * All `String` formatting extensions and functions * All extensions like `CaptionedInput#toHtmlCaptions` * All helper extensions for `List` * Several new extensions for `SentMediaGroupUpdate` were added: * `SentMediaGroupUpdate#forwardInfo` * `SentMediaGroupUpdate#replyTo` * `SentMediaGroupUpdate#chat` * `SentMediaGroupUpdate#mediaGroupId` * Several `List.createResend` extensions were added * `RequestsExecutor#executeAsync` and `RequestsExecutor#executeUnsafe` ## 0.27.4 * `TelegramBotAPI-extensions-utils`: * Several extensions for updates was added: * `onlyBaseMessageUpdates` * `onlySentMessageUpdates` * `onlyEditMessageUpdates` * `onlyMediaGroupsUpdates` * `onlySentMediaGroupUpdates` * `onlyEditMediaGroupUpdates` * Renames in chat filters extensions: * `filterBaseMessageUpdates` -> `filterBaseMessageUpdatesByChatId` and `filterBaseMessageUpdatesByChat` * `filterSentMediaGroupUpdates` -> `filterSentMediaGroupUpdatesByChatId` and `filterSentMediaGroupUpdatesByChat` ## 0.27.3 * `TelegramBotAPI`: * `UpdateDeserializationStrategy` is publicly available now * All `setWebhook` extensions was marked as deprecated, renamed and replaced into `TelegramBotAPI-extensions-utils` * Typealias `ExceptionHandler` was added - it will be used for `handleSafely` * `SetWebhook` factories signatures was changed (backward compatibility was not broken) * `executeUnsafe` now working differently * Now it is possible to pass exceptions handler into `executeUnsafe` * `BasketballDiceAnimationType` was added * `UnknownDiceAnimationType` now is deprecated due to renaming - currently it is typealias for `CustomDiceAnimationType` * `CustomDiceAnimationType` now is `data` class instead of common class * `FlowsUpdatesFilter` will use size 64 by default for internal broadcast channels * `TelegramBotAPI-extensions-api`: * Long Polling extensions now are deprecated in this project. It was replaced into `TelegramBotAPI-extensions-utils` * Several `telegramBot` functions was renamed into `telegramBotWithCustomClientConfig` * Add one more `setWebhookInfo` realisation * `TelegramBotAPI-extensions-utils`: * Extension `toTelegramUpdate` was added * Long Polling extensions were added * Updates utils were added * New extensions `startListenWebhooks`, `setWebhookInfoAndStartListenWebhooks` and `includeWebhookHandlingInRoute` was added * New extension `CoroutineScope#updateHandlerWithMediaGroupsAdaptation` was added * New extension `flowsUpdatesFilter` was added * `TelegramBotAPI-all`: * Project was created ## 0.27.2 * `Common`: * Versions: * Coroutines: `1.3.5` -> `1.3.6` * Klock: `1.10.5` -> `1.11.1` * `TelegramBotAPI`: * Expected class `MimeType` was added * Field `MimeTyped#mimeType` now typed by `MimeType` instead of `String` * `MediaGroupMemberInputMedia` children now can be deserialized (but only those ones who are declared inside library) * `TelegramBotAPI-extensions-utils`: * Chat events splitters added: * Extension `Flow#onlyChannelEvents` was added * Extension `Flow#onlyGroupEvents` was added * Extension `Flow#onlySupergroupEvents` was added ## 0.27.1 * `TelegramBotAPI`: * Interface `Explained` and subsinterfaces `ExplainedInput` and `ExplainedOutput` was added * Class `QuizPoll` now implement `ExplainedInput` * In `QuizPoll#caption` and `QuizPoll#captionEntities` are deprecated now * Class `SendQuizPoll` now implement `ExplainedOutput` * In `SendQuizPoll#caption` is deprecated now * `explanationLimit` range was added as future replacement of `quizPollExplanationLimit` * `quizPollExplanationLimit` now is deprecated * Extensions `toMarkdownExplanations`, `toMarkdownV2Explanations` and `toHtmlExplanations` was added * Typealias `FullTextSourcesList` was added * All extensions `fullEntitiesList` now return `FullTextSourcesList` * All extensions of `List` now are extensions for `FullTextSourcesList` * `TelegramBotAPI-extensions-api`: * `sendQuizPoll` now is using `explanation` parameter instead of `caption` ## 0.27.0 * `Common`: * Versions updates: * `Kotlin`: `1.3.71` -> `1.3.72` * `Klock`: `1.10.3` -> `1.10.5` * `TelegramBotAPI`: * Typealias `LongSeconds` was added for correct explanation of seconds in `Long` primitive type * Several new fields was added: * `explanationField` * `explanationEntitiesField` * `openPeriodField` * `closeDateField` * Extension `List#justTextSources` was added for mapping of `List` to `List` * Field `SendPoll#closeInfo` was added * Range `openPeriodPollSecondsLimit` was added and used in all `SendPoll` requests for checking income data * `SendQuizPoll` now able to use fields `caption` and `parseMode` for `explanation` functionality * `quizPollExplanationLimit` was added for checking `QuizPoll` explanation size * Field `TextLinkTextSource#url` was added * Field `TextMentionTextSource#user` was added * Sealed class `ScheduledCloseInfo` was added * Class `ExactScheduledCloseInfo` was added for cases with `close_date` * Class `ApproximateScheduledCloseInfo` was added for cases with `open_period` * Field `Poll#scheduledCloseInfo` was added * Sealed class `MultipleAnswersPoll` was added * Class `RegularPoll` now extends `MultipleAnswersPoll` * `Dice` class was replaced into new package * Sealed class `DiceAnimationType` was added * Field `Dice#animationType` was added as `emoji` API representation * `SendDice` now receive `animationType` as second parameter * For `List` was added several extensions: * `toMarkdownCaptions` * `toMarkdownTexts` * `toMarkdownV2Captions` * `toMarkdownV2Texts` * `toHtmlCaptions` * `toHtmlTexts` * `TelegramBotAPI-extensions-api`: * All `RequestsExecutor#sendDice` extensions now accept `DiceAnimationType?` as second parameter * All `RequestsExecutor#sendRegularPoll` extensions now accept `ScheduledCloseInfo` fourth parameter * All `RequestsExecutor#sendQuizPoll` extensions now accept additional parameters `caption: String` and `parseMode: ParseMode` for `explanation` functionality and `closeInfo: ScheduledCloseInfo?` for autoclose poll functionality * `TelegramBotAPI-extensions-utils`: * Several shortcuts for `ScheduledCloseInfo` was added: * `closePollExactAt` * `closePollExactAfter` * `closePollAfter` ## 0.26.4 * `TelegramBotAPI`: * Now any getting of updates will return `UnknownUpdateType` when inside of deserialization will be `SerializationException` or `NotImplemented` error * `CallbackGame` currently is an object * It is possible to use `CallbackGame` for now * `CallbackGameInlineKeyboardButton` now will not accept `callbackGame` as income object * Now it is possible to pass exception handler in webhook ## 0.26.3 * `TelegramBotAPI`: * `CallbackGameInlineKeyboardButton` was added ([Issue-79](https://github.com/InsanusMokrassar/TelegramBotAPI/issues/79), [PR-80](https://github.com/InsanusMokrassar/TelegramBotAPI/pull/80)) * `UnknownInlineKeyboardButton` was added. It is unavailable for creating, but you can receive it, for example, in `InlineQueryResult` * `Update` now will be created even if was `SerializationException` inside of creating the update instance - in this case will be created `UnknownUpdateType` * `UnknownUpdateType$rawJson` value now is included (`JsonElement`) * **EXPERIMENTALLY** `BaseEditMessageUpdate#data` now is `CommonMessage<*>` * Suspend inline function `handleSafely` was added * `KtorRequestsExecutor` now use `handleSafely` instead of `try` with `supervisorScope` * `UpdatesPolling` now use `handleSafely` instead of `try` with `supervisorScope` ## 0.26.2 * `TelegramBotAPI`: * Now `EditMediaGroupUpdate` also extends `BaseEditMessageUpdate` * **EXPERIMENTALLY** Now all `TextSource` realisations will contain `source` field as a property inside of them * `TelegramBotAPI-extensions-api`: * `startGettingFlowsUpdates` extension which do not require filter (but return a new one) was added * `TelegramBotAPI-extensions-utils`: * Subproject was added * `filterBaseMessageUpdates`, `filterSentMediaGroupUpdates` and `filterEditMediaGroupUpdates` extensions was added * `filterCommandsWithArgs`, `filterExactCommands` and `filterCommandsInsideTextMessages` extensions was added * `asContentMessagesFlow`, `asChatEventsFlow` and `asUnknownMessagesFlow` extensions was added * `withContentType` extension was added * `onlyAnimationContentMessages` extension was added * `onlyAudioContentMessages` extension was added * `onlyContactContentMessages` extension was added * `onlyDiceContentMessages` extension was added * `onlyDocumentContentMessages` extension was added * `onlyGameContentMessages` extension was added * `onlyInvoiceContentMessages` extension was added * `onlyLocationContentMessages` extension was added * `onlyPhotoContentMessages` extension was added * `onlyPollContentMessages` extension was added * `onlyStickerContentMessages` extension was added * `onlyTextContentMessages` extension was added * `onlyVenueContentMessages` extension was added * `onlyVideoContentMessages` extension was added * `onlyVideoNoteContentMessages` extension was added * `onlyVoiceContentMessages` extension was added ## 0.26.1 * `TelegramBotAPI`: * `BotCommand` now will check and throw error in case when command or description lengths is/are incorrect * `StorageFile` now is common for all platforms * JavaScript realization was removed due to its redundancy * JVM realization was replaced with `fun` factory * `StorageFile` now able to accept any factory of `Input` * `StorageFileInfo` was added to avoid strange collisions with throws in `StorageFile` * Fixes issue with `hashTag` for markdown * `InvalidPhotoDimensionsException` was added for cases when `PHOTO_INVALID_DIMENSION` answer received * Other fixes ## 0.26.0 * `Common`: * Versions updates: * `Klock`: `1.10.0` -> `1.10.3` * `TelegramBotAPI`: * Request `SendDice` was added (calling [sendDice](https://core.telegram.org/bots/api#senddice)) * Class `Dice` was added (type [dice](https://core.telegram.org/bots/api#dice)) * Class `DiceContent` was added (for including it in [message](https://core.telegram.org/bots/api#message) object) * `BotCommand` was added * `GetMyCommands` request was added * `SetMyCommands` request was added * `GetMe` now is object instead of class * `GetMe` was replaced into package `com.github.insanusmokrassar.TelegramBotAPI.requests.bot.GetMe` * `CreateNewStickerSet` renamed to `CreateStaticNewStickerSet` * `CreateNewAnimatedStickerSet` request was added (it handle work with `tgs_sticker`) * `StickerSet#thumb` was added * `AddStickerToSet` renamed to `AddStaticStickerToSet` * `AddAnimatedStickerToSet` request was added * `SetStickerSetThumb` request was added * Most of sticker actions now implements `StandardStickerSetAction` instead of `StickerSetAction` * `getUpdatesLimit` was added to be ensure in get updates limit * `GetUpdates` now will check count of requesting updates and throw exception if it is not in range `1 .. 100` * `GetUpdates#limit` now is not nullable and by default set up to 100 * `TelegramBotAPI-extensions-api`: * Extensions `sendDice` was added * Extension `getMyCommands` request was added * Extension `setMyCommands` request was added * Extension `getMe` was replaced into package `com.github.insanusmokrassar.TelegramBotAPI.extensions.api.bot.GetMeKt.getMe` * **All extensions `createNewStickerSet` was renamed to `createNewStaticStickerSet`** * Extensions `createNewAnimatedStickerSet` was added * **All extensions `addStickerToSet` was renamed to `addStaticStickerToSet`** * Extensions `addAnimatedStickerToSet` was added * Extensions `setStickerSetThumb` was added * Extension `startGettingUpdates` now will drop `SentMediaGroupUpdate` in case if it is the last in updates group and size of retrieved updates is equal to 100 (max count of retrieved updates) * Extensions `getUpdates` now will receive only not nullable `limit` parameter ## 0.25.1 * Update kotlin: `1.3.70` -> `1.3.71` * Fix of error inside of update utils for media groups ## 0.25.0 * Common: * Versions updates: * `Kotlin`: `1.3.61` -> `1.3.70` * `Kotlin coroutines`: `1.3.3` -> `1.3.5` * `Kotlin serialization`: `0.14.0` -> `0.20.0` * `Ktor`: `1.3.1` -> `1.3.2` * `Klock`: `1.8.7` -> `1.10.0` * `UUID`: `0.0.7` -> `0.1.0` * `TelegramBotAPI`: * `Bot` implementations (as and `Bot` itself) now have not nullable `username` * `File#toInputFile` extension now will throw error when file does not exists * `InlineKeyboardMarkup` will check that `PayInlineKeyboardButton` is the first in case if it is exists in `keyboard` * `makeLinkToMessage` now is not `PreviewFeature` * All deprecations was removed * `RequestException` now extends `io.ktor.utils.io.errors.IOException` instead of `kotlinx.io.IOException` * `Any#toJson` now is NOT `inline` * `FlowsUpdatesFilter` now as marked my annotation `FlowPreview` * `PathedFile#fullUrl` now is not `inline` function * `SimpleRequest#json` now is not `inline` and `internal` function * `FlowsUpdatesFilter` now have two additional flows: `pollAnswerFlow`, `unknownUpdateTypeFlow` * `ExtendedUser` (`typealias`) was added as a `PreviewFeature` ## 0.24.1 * `TelegramBotAPI`: * `UpdateReceiver` was replaced to the package `com.github.insanusmokrassar.TelegramBotAPI.updateshandlers` * All functions inside `com.github.insanusmokrassar.TelegramBotAPI.utils.extensions.UpdatesPolling` are deprecated and will be removed in some soon versions. Their replacement are able inside `TelegramBotAPI-extensions-api` * `UpdatesFilter` is interface for now * Previous `UpdatesFilter` class was renamed to `SimpleUpdatesFilter` and for backward compatibility was added builder function `UpdatesFilter`, which will be removed in near releases * `FlowsUpdatesFilter` now implements `UpdatesFilter` * `BaseSentMessageUpdate` and `BaseEditMessageUpdate` interfaces was added * `EditChannelPostUpdate` now is implementing `BaseEditMessageUpdate` interface * `EditMessageUpdate` now is implementing `BaseEditMessageUpdate` interface * `ChannelPostUpdate` now is implementing `BaseSentMessageUpdate` interface * `MessageUpdate` now is implementing `BaseSentMessageUpdate` interface * `UpdatesPoller` and all its usages, childs and childs usages now are deprecated * `GetUpdates#timeout` type now is `Seconds` (in fact it is `Int` as previously) * `KtorRequestsExecutor` now is using a copy of incoming `HttpClient` object and install `HttpTimeout` feature * `AbstractRequestCallFactory` now setting up a custom delay in case if request is `GetUpdates` * `TelegramBotAPI-extensions-api`: * All functions from `com.github.insanusmokrassar.TelegramBotAPI.utils.extensions.UpdatesPolling` now available in package `com.github.insanusmokrassar.TelegramBotAPI.extensions.api.updates.UpdatesPolling` * Now new method of getting updates available: `startGettingUpdates` with `UpdatesFilter` as incoming first parameter * `startGettingUpdates` with `receiver` and `allowedUpdates` parameters now will handle updates by itself ## 0.24.0 * `TelegramBotAPI`: * All suspend functions for `RequestsExecutor` was removed (due to replacement into [TelegramBotAPI extensions project](TelegramBotAPI-extensions-api/README.md)) * `ForwardFromChannelInfo#channelChat` now is `ChannelChat` instead of `Chat` * `TelegramBotAPI-extensions-api`: * Most part of sending media messages functions was removed and replaced with their `InputFile` args analogs ## 0.23.3 Project separating prepare version __API Extensions__ * Project created * For `SendPhoto` was added new functions for uploading of `MultipartFile` * `deleteWebhook` extension for `RequestsExecutor` was added __Telegram Bot API__ * All `RequestsExecutor` extensions related to Telegram Bots API was replaced into `API Extensions` project ## 0.23.2 * Fixes in `InputMedia` - `media` field was not included to serialization ## 0.23.1 * Versions updates: * Klock `1.8.6` -> `1.8.7` * Ktor `1.3.0` -> `1.3.1` * Now it is possible to get updates by polling with custom executor engine * `CommonMultipartFileRequest` now is internal * Added `LiveLocation` class for more useful tracking live locations * `InvoiceOfPayment` is renamed to `InvoiceContent` and now is `MessageContent` instead of `PaymentInfo` * `SendInvoice` now return `ContentMessage` * `paymentInfo` inside of `CommonMessageImpl` now can be set only to `SuccessfulPaymentInfo` * Added `RecordVideoNoteAction` and `UploadVideoNoteAction` for `record_video_note` and `upload_video_note` actions * For most part of messages was added `RequestsExecutor` extensions for more useful way of usage * `toInputFile` extensions now will return more exact types * Now it is possible to send broadcast channels size for `FlowsUpdatesFilter` ## 0.23.0 TelegramBotAPI 4.6 * `Poll` now is sealed class * `RegularPoll` type was added to represent polls with type `regular` * `QuizPoll` type was added to represent polls with type `quiz` * `UnknownPollType` type was added to represent polls which are unknown in current version * `AnonymousPollOption` was renamed to `SimplePollOption` * `SendPoll` was rewritten as sealed class * `SendRegularPoll` was created and represent `sendPoll` method with type `regular` * `SendQuizPoll` was created and represent `sendPoll` method with type `quiz` * `Poll#createRequest` extension was added * `PollAnswerUpdate` type of update was added * `PollAnswer` type was added * `UpdatesFilter` now support work with `PollAnswerUpdate` * `language` field in PreTextSource now correctly passed from telegram MessageEntities * `KeyboardButton` now is sealed class * Fixed problem of incorrect representation of this class (any type of request can be created separately) * Added new types of `KeyboardButton`: * `UnknownKeyboardButton` * `SimpleKeyboardButton` * `RequestContactKeyboardButton` * `RequestLocationKeyboardButton` * `RequestPollKeyboardButton` * Added new type `KeyboardButtonPollType`: * `UnknownKeyboardButtonPollType` * `RegularKeyboardButtonPollType` * `QuizKeyboardButtonPollType` * `User` now is sealed class * `CommonUser` was added as representation of default `User` * `Bot` was added as representation of bot user (it is sealed class) * `ExtendedBot` with additional info * `CommonBot` with simple info * `GetMe` now return `ExtendedBot` object * Now extension `javaLocale` is extension for `CommonUser` ## 0.22.2 CashTag and independent updates handling * `cashtag` entity type was added * Several `Unknown*` realizations was added: * `UnknownUpdateType` * `UnknownMessageType` * `UnknownChatType` * `UnknownCallbackQueryType` * `UpdatesFilter` now have one additional income callback: `unknownUpdateTypeCallback` * `createSimpleUpdateFilter` can receive one more callback: `unknownCallback` (for `unknownUpdateTypeCallback`) ## 0.22.1 MediaContent#asInputMedia * All `MediaContent` instances now can create their `InputMedia` analog * New annotation `PreviewFeature` was added to mark new thing as preview for the time while they can work incorrectly * Added links utils: * `makeLinkToMessage` have two signatures - for direct creating using username and for abstract creating using chat id ## 0.22.0 * **`KtorCallFactory` must return `HttpStatement` instead of `HttpClientCall`** * `SendMessage` was renamed to `SendTextMessage` and previous `SendMessage` is deprecated * All `AbleToBe*` interfaces was renamed to `Possibly*` * `AbleToBeEditedMessage` -> `PossiblyEditedMessage` * `AbleToBeForwardedMessage` -> `PossiblyForwardedMessage` * `AbleToBeMarkedUp` -> `PossiblyMarkedUp` * `AbleToBeEditedMessage` -> `PossiblyEditedMessage` * `ForwardedMessage` type was renamed to `ForwardInfo` * `AnonymousForwardedMessage` -> `AnonymousForwardInfo` * `UserForwardedMessage` -> `UserForwardInfo` * `ForwardedFromChannelMessage` -> `ForwardFromChannelInfo` * `PossiblyForwardedMessage#forwarded` field now renamed to `forwardInfo` * All serializers in library now are `internal`. **If you have used some of them or I have marked as internal by a mistake - don't hesitate to say this.** * `EditChatMessage` now have generic type and extends `SimpleRequest>` * `ResendableContent` now extends `Request` instead of `Request` * Most part of requests have changed return type. They are listed below:
* `ForwardMessage` * `GetChatAdministrators` * `EditChatMessageLiveLocation` * `StopChatMessageLiveLocation` * `EditChatMessageText` * `EditChatMessageCaption` * `EditChatMessageMedia` * `EditChatMessageReplyMarkup` * `SendAnimation` * `SendAudio` * `SendContact` * `SendLocation` * `SendTextMessage` * `SendPoll` * `SendVenue` * `SendGame` * `SendDocument` * `SendMediaGroup` * `SendPhoto` * `SendVideo` * `SendVideoNote` * `SendVoice` * `SendSticker`
* Changed type of `createResend`
* `GameContent` * `LocationContent` * `PollContent` * `TextContent` * `VenueContent` * `AnimationContent` * `AudioContent` * `DocumentContent` * `ContactContent` * `PhotoContent` * `VideoContent` * `VideoNoteContent` * `VoiceContent` * `StickerContent`
* Version updates: * Ktor `1.2.6` -> `1.3.0` ## 0.21.0 TelegramBotAPI 4.5 * _**All `MessageEntity`'es now are replaced with `TextPart`**_ * Added support of strikethrough and underline * Added `UnderlineTextSource` * Added `StrikethroughTextSource` * Added support in `RawMessageEntity` * Added support of `MarkdownV2` * Now will not be thrown exception when there is income unknown type of `RawMessageEntity`. Instead of this will be created `RegularTextSource` with the same text * Fixed problem that usually string formatting did not trigger escaping of control characters * Actualized work with `pre` type of text - now it is possible to use `language` for formatting of text * Removed constructor of `TextMentionTextSource`, which was deprecated previously * All `TelegramMediaFile` instances now have field `fileUniqueId`, which represents `file_unique_id` field from API * Now `ChatPhoto` have two additional fields: `smallFileUniqueId` and `bigFileUniqueId` * Now any administrator object instance have `customTitle` nullable field * Added the new request `SetChatAdministratorCustomTitle` to manage the custom titles of administrators promoted by the bot. * Added the field `slowModeDelay` to the `ExtendedSupergroupChat` objects. * `CaptionedInput` now have extension `fullEntitiesList` which will return list of `TextPart` with `RegularSource`'s * `TextPart` added - it will be used as part of some text and can be not related to telegram bot * `MultilevelTextSource` was added - it is type of `TextSource`, which can have subsources as parts of this text * In all `TextSource`s all fields now are lazy for avoiding of potential risk for performance issues * Updates in versions: * Coroutines `1.3.2` -> `1.3.3` * Klock `1.8.0` -> `1.8.6` * UUID `0.0.6` -> `0.0.7` ## 0.20.4 * Now `setWebhook` supports setting up of path for listening * Now `setWebhook` supports custom listen address even if certificate was not provided ## 0.20.3 * Now `LeftChatMamber` is a `CommonEvent` ## 0.20.2 * New exception type `MessageIsNotModifierException` was added * New exception type `MessageToEditNotFoundException` was added * Now exceptions in requests will be caught correctly ## 0.20.1 * `User` now implement `PrivateChat` * `TextMentionMessageEntity` now accept `PrivateChat` instead of `User` in main constructor * `TextMentionMessageEntity` now contains not user, but contains `PrivateChat` * Fixed: `TextMentionMessageEntity#asHtmlSource` previously worked incorrect * Abstraction `TextSource` * `MessageEntity` now extends `TextSource` * `createFormattedText` method now accept `List` * `createHtmlText` method now accept `List` * `createMarkdownText` method now accept `List` * A lot of `TextSource` implementors was added. More info [here](src/commonMain/kotlin/com/github/insanusmokrassar/TelegramBotAPI/types/MessageEntity/textsources/) * All `MessageEntity` implementations now are using new `TextSource` analogues as delegates ## 0.20.0 MPP Migration * Time library change: `joda-time` -> `com.soywiz.korlibs.klock:klock` * `Currencied` now using as `currency` value with type `String` * For `Java` there is `Currencied#javaCurrency` extension function, which will give an old currency work way * `User` now have no field `userLocale` * For `Java` there is `User#javaLocale` extension function, which will give an old locale work way ## 0.19.0 ImplicitReflection removing * Total rework of serialization for requests. Now all `SimpleRequest` children have: * `requestSerializer` - field, which must provide serializer of current type * `resultDeserializer` - field, which must provide opportunity to deserializer result. Previously it was a function * Removed deprecations: * `com.github.insanusmokrassar.TelegramBotAPI.utils.extensions.WebhookPrivateKeyConfig` * `com.github.insanusmokrassar.TelegramBotAPI.utils.extensions.UpdatesFilter` * `com.github.insanusmokrassar.TelegramBotAPI.utils.extensions.createSimpleUpdateFilter` * `com.github.insanusmokrassar.TelegramBotAPI.utils.createMarkdownText` * `com.github.insanusmokrassar.TelegramBotAPI.utils.toMarkdownCaption` * `com.github.insanusmokrassar.TelegramBotAPI.utils.toMarkdownText` * `com.github.insanusmokrassar.TelegramBotAPI.updateshandlers.KtorUpdatesPoller` * `com.github.insanusmokrassar.TelegramBotAPI.types.message.content.abstracts.CaptionedMediaContent` * `com.github.insanusmokrassar.TelegramBotAPI.types.message.CommonForwardedMessage` * `com.github.insanusmokrassar.TelegramBotAPI.types.InputMedia.CaptionedInputMedia` * `com.github.insanusmokrassar.TelegramBotAPI.types.games.Game#text` * `com.github.insanusmokrassar.TelegramBotAPI.types.games.Game#textEntities` * `com.github.insanusmokrassar.TelegramBotAPI.types.files.PathedFileKt.makeFileUrl` * `com.github.insanusmokrassar.TelegramBotAPI.types.files.PathedFileKt.downloadingFilesBaseUrl` * `com.github.insanusmokrassar.TelegramBotAPI.requests.send.media.base.Data` * `com.github.insanusmokrassar.TelegramBotAPI.CommonAbstracts.types.ByInlineMessageId` * `com.github.insanusmokrassar.TelegramBotAPI.CommonAbstracts.types.ByMessageId` * `com.github.insanusmokrassar.TelegramBotAPI.bot.RequestException` * `com.github.insanusmokrassar.TelegramBotAPI.bot.exceptions.ReplyMessageNotFound` * `com.github.insanusmokrassar.TelegramBotAPI.bot.BaseRequestsExecutor#baseUrl` * `com.github.insanusmokrassar.TelegramBotAPI.bot.BaseRequestsExecutor#constructor(token, hostUrl)` * `com.github.insanusmokrassar.TelegramBotAPI.bot.Ktor.KtorRequestsExecutor#constructor(token, client, hostUrl, callsFactories, excludeDefaultFactories, requestsLimiter, jsonFormatter)` * `com.github.insanusmokrassar.TelegramBotAPI.bot.Ktor.KtorRequestsExecutor#constructor(token, engine, hostUrl)` ## 0.18.1 Libraries update * Update libraries: * `kotlin`: 1.3.41 -> 1.3.61 * `kotlin coroutines`: 1.2.2 -> 1.3.2 * `kotlin serialization`: 0.11.1 -> 0.14.0 * `joda time`: 2.10.3 -> 2.10.5 * `ktor`: 1.2.3 -> 1.2.6 * `BotAction` now will be deserialized in a little bit other way * `BotActionSerializer` now is internal * Most part of serializers now are objects (instead of classes as was previously) ## 0.18.0 Raws cleaning * Made internal and not available outside of library: * `RawMessage` * `RawUpdate` * `RawChatMember` * `RawMessageEntity` * `RawInlineQuery` * `RawCallbackQuery` * `RawChosenInlineResult` * All `RawMessage` usages was replaced with `Message` interface (with some of other raw classes was made the same things) * `TelegramBotAPIMessageDeserializationStrategy` was created. It was used for deserialization of Telegram Bot API incoming messages * `TelegramBotAPIMessageDeserializeOnlySerializer` was created. It **MUST NOT** be used to serialize messages * Update of description * Make `Game` object a little bit more standartizated * `Game` now is not serializable and have no additional trash, related to serialization * `TelegramFile` was removed ## 0.17.0 July 29, 2019 API Update Libraries updates: * Kotlin version `1.3.31` -> `1.3.41` * Kotlin Coroutines version `1.2.1` -> `1.2.2` * Kotlin Serialization version `0.11.0` -> `0.11.1` * Joda Time version `2.10.1` -> `2.10.3` * ktor version `1.1.4` -> `1.2.3` Changes according to [July 29, 2019 Telegram Bot API update](https://core.telegram.org/bots/api#july-29-2019): * `Sticker` and `StickerSet` now have field `isAnimated` * `ChatPermissions` object was added, `GroupChat` interface got `permissions` field, request `SetChatPermissions` was added * `GroupChat` object now have no field `allMembersAreAdmins` * `SpecialRightsChatMember` was added for administrators and restricted members rights union, chat members abstractions was replaced into `abstracts` package and available permissions was updated * `RestrictChatMember` request now accept `permissions` object instead of separated permissions * All `GroupChat` instances have description Other important changes: * Totally reworked chats hierarchy. `Extended` abstractions was added for cases when called `GetChat` request * `RawChat` boilerplate was removed and replaced by serializers * `BotCommandMessageEntity#command` will not contain `/`/`!` parts and also will cut outside of command begin token (`/` or `!`) and username token (`@`) or end of command (any space character) * `RequestsExecutor` now is `Closeable` * `TelegramAPIUrlsKeeper` was added to provide more comfortable work with file urls and other things like this ## 0.16.1 * Now old uncommon `CaptionedMediaContent` and `CaptionedInputMedia` are replaced by almost the same interfaces `CaptionedInput` and `CaptionedOutput`. They are both implementing `Captioned` interface * `AnimationContent` now is `CaptionedInput` ## 0.16.0 Bot API 4.3 * `LoginURL` and `LoginURLInlineKeyboardButton` has been added * `replyMarkup` field was added to the `CommonMessage` objects via `AbleToBeMarkedUp` interface * `SwitchInlineQueryCurrentChatInlineKeyboardButton#switchInlineQueryCurrentChat` field fixed * `InlineKeyboardButton` now is sealed class and all its possible realisations are inside of its class file * `String#asUsername` method renamed to `String#toUsername` * Several `toChatId` extensions added ## 0.15.0 * Old `UpdatesPoller` removed (was deprecated) * `UpdatesPoller` renamed to `KtorUpdatesPoller` * Now `KtorUpdatesPoller` do not use additional delay between requests and await answer from Telegram all timeout time * Added abstraction `UpdatesPoller` * Changed signature of the most count of `startGettingOfUpdates`: * They are not `suspend` for now * They are return `UpdatesPoller` * They are using `timeoutMillis` instead of `requestsDelayMillis` * Added `CIO` ktor client engine as lightweight default engine for long-polling ## 0.14.2 MediaGroups edit hotfixes * `convertWithMediaGroupUpdates` extension added * All media group converting extensions are internal for now * Fixes according to updates in converting of updates to media group updates ## 0.14.1 * Replace `UpdatesFilter` and `UpdatesPoller` into another package * Replace `WebhookPrivateKeyConfig` * Added `FlowsUpdatesFilter` * `UpdatesFilter` now have additional callback for polls * `StopPoll#replyMarkup` now is optional ## 0.14.0 * Now library have no default engine for both webhooks and requests executor. It is required for clients to set some default library * All proxy help methods was removed . They are will be replaced in separated project * `Ktor` version `1.1.3` -> `1.1.4` * Requests results now always decoding as `UTF-8` * `AbstractRequestCallFactory` was added with cache of methods urls to avoid memory leaks * Small refactoring of work with response in `KtorRequestsExecutor` * Kotlin version `1.3.30` -> `1.3.31` * Kotlin coroutines `1.2.0` -> `1.2.1` * `CommonForwardedMessage` was renamed to `UserForwardedMessage` * All forwarded messages are now just childs of `ForwardedMessage`: * `AnonymousForwardedMessage` - for messages without forwarded info * `UserForwardedMessage` - for messages from users and groups (contains not message id) * `ForwardedFromChannelMessage` - for messages from channels * Changed logic of forwarded messages preparing ## 0.13.0 Telegram Polls * Type `PollOption` and `AnonymousPollOption` added * Type `Poll` added * Type `PollUpdate` added and implemented in `RawUpdate`. Now `PollUpdate` can be retrieved from `RawUpdate` * Type `PollContent` added - now it can be a value of `ContentMessage#content` * Request `SendPoll` added and `PollContent#createResend` now use it * `ByInlineMessageId` is deprecated (use `InlineMessageAction` instead) * `ByMessageId` is deprecated (use `MessageAction` instead) * Most part of requests which are working with identifiers of messages now implement `MessageAction` directly or by their parents * `StopPoll` implemented * All current `Chat` abstractions are deprecated and rewritten as typealiases. Use `Chat` abstractions from `com.github.insanusmokrassar.TelegramBotAPI.types.chat.abstracts` package * Common Groups now may have pinned message * `is_member` field added into `RestrictedChatMember` * **BREAK CHANGES** Now `ForwardedMessages` can be `AnonymousForwardedMessage` and `PublicForwardedMessage`. Old implementations now extend `PublicForwardedMessage` ## 0.12.7 Hotfix version * Now temporary all requests of input media will contains `file` field ## 0.12.6 Libraries updates * `kotlin` version `1.3.21` -> `1.3.30` * `kotlin coroutines` version `1.1.1` -> `1.2.0` * `kotlin serialization` version `0.10.0` -> `0.11.0` * `ktor` version `1.1.2` -> `1.1.3` * Added `DeleteWebhook` request * All default `startGettingOfUpdates` (in fact - method `start` of `UpdatesPoller`) are suspend and will try to delete webhook ## 0.12.5 `MediaContent` improvements * Now `MediaGroupContent` is `MediaContent` * All `MedaContent` now have no generics and have basic `TelegramMediaFile` media field ## 0.12.4 * Optimized preparing of media group in `UpdatesPoller` * Add `CommonLimiter` * Add `MessageEntity#asHtmlSource` and `String#toHtml` * Add tools for work with html captions and texts * `MessageContent` which using captions or text now have default parse mode `HTMLParseMode` due to issue with escaping of `]` in links titles * Added `Markdown` and `HTML` type aliases which actually means `MarkdownParseMode` and `HTMLParseMode` * `ChatId` now have extension `link` which will automatically create link like `tg://user?id=` * Created a few of methods for all supported formats of text like bold, italic, links and others * Rewritten `MessageEntities` to use new formatting options ## 0.12.3 Cleaning * Refactor, optimizing and cleaning of code * Removed deprecated method `T#toJsonWithoutNulls()` * Renamed instances of `MediaGroupMessage`s and refactored their interfaces. `ChannelMediaGroupMessage` will not contain `user` field (but `CommonMediaGroupMessage` will have) * Now `MediaCollectionContent` is `MediaContent` (classes of this interface must choose best media for present out) * `PhotoContent` now choose biggest photo size from its collection as `media` * Fix in order of media group messages which was received by webhooks ## 0.12.2 * New in `MediaGroupUpdate`: * It is subtype of `Update` and can be use as regular update with list of messages * Data now is list with `MediaGroupMessage` * Added field `origins` which represent origin updates for `MediaGroupMessage` * `updateId` now represent LAST id of origins updates * `UpdatesFilter` and other objects now work with `UpdateReceiver` as common supertype for receivers. ## 0.12.1 Hotfix for media groups * Added additional media group types (like `MessageMediaGroupUpdate`) * Fixed handling of media group updates in `UpdatesFilter` ## 0.12.0 Webhooks * Added `DataRequest` interface which replace `Data` interface * `MultipartRequestImpl` now use `DataRequest` * All requests which implements `Data` now implement `DataRequest` * Added class `SetWebhook` and its factory * Added class `UpdatesFilter` which can help to filter updates by categories * Added function `accumulateByKey` which work as debounce for keys and send list of received values * Added webhooks functions and workaround for `Reverse Proxy` mode * Added new type of updates `MediaGroupUpdate`, which can be received only from filters * `UpdatesFilter` now use new type of updates for mediagroups * Add `GetWebhookInfo` request and `WebhookInfo` type * Replace updates types into separated place in types * Now default `RequestException` will contain plain answer from telegram * Added `UnauthorizedException` * `RequestException` now is sealed * Rename `ReplyMessageNotFound` to `ReplyMessageNotFoundException` * Added `List#mediaGroupId` extension * Added utility `T#asReference(): WeakReference(T)` extension * Added `UpdatesPoller` class which can be instantiated for manage updates polling * Separated execute extensions (now they are in file `Executes`) and poller creating extensions * `BaseMessageUpdate#toMediaGroupUpdate()` will also check condition when update-receiver already is `MediaGroupUpdate` ## 0.11.0 * Kotlin `1.3.11` -> `1.3.21` * Kotlin coroutines `1.1.0` -> `1.1.1` * Kotlin serialization `0.9.1` -> `0.10.0` * Ktor `1.1.1` -> `1.1.2` ## 0.10.3 * Hotfix for username data class ## 0.10.2 * Fixes in `Username` * Now you can create username object using string which is not starting with `@` * Now `Username` correctly comparing with strings, which are not starting with `@` * Now most part of usernames in library have type `Username` * Fix `replyMarkup` in `InlineQueryResultArticle` ## 0.10.1 * Change algorithm of `executeUnsafe`: now it use loop instead of recursive calling * Add additional `startGettingUpdates` with better management of received updates for media groups * Now `MediaGroupMessage` is `CommonMessage` with `MediaGroupContent` content * Added extensions `replyTo`, `forwarded` and `chat` for `List` for comfortable work with media groups lists * Fix `parseMode` of `InputTextMessageContent` ## 0.10.0 * Most part of abstractions was replaced from `requests` and `types` on more high level * Added abstraction `CommonVenueData` * Added abstraction `CommonContactData` * Added `InputMessageContent` * Update some types and requests according to abstractions replacing * Add all `InlineQueryResult`, `InputMessageContent` and other inline mode types * Fixes in edition of inline messages and their result types * Replace basic exception and add `ReplyMessageNotFound` exception ## 0.9.3 * `KtorRequestsExecutor` now can use custom `JSON` string formatter (by default - non strict) * `ResponseParameters` renamed to `Response` * Add `RequestError` sealed class and described in documentation known errors * Add `ResponseParametersRaw` which can create error based on input parameters * Add `parameters` field in `Response` and remove useless fields from `Response` * Add `leftToRetry` parameter in `RetryAfterError` * Add handling of `RetryAfterError` in `KtorRequestsExecutor` ## 0.9.2 * `RequestsExecutor#executeAsync(Request, CoroutineScope)` now will return `Deferred` for cases when you need result * `RequestsExecutor#executeUnsafe` will automatically retry request if it was unsuccessful and retries > 0 ## 0.9.1 * Updated built-in lengths restrictions * Apply restrictions of text limit for sending messages * Add `RegularTextMessageEntity` which is useful for representing regular text message entity * Add `convertToFullMessageEntityList` which create list of entities with `RegularTextMessageEntity` on places where must be regular text * Change signature of `createMarkdownText`: now it will return list of strings * Deprecate old signatures of `createMarkdownText`, `toMarkdownCaption`, `toMarkdownText` * Add `ResendableContent#createResends` which create adapted list of resends for content * Add `TextContent` own `createResends` realisation ## 0.9.0 * Old extension `OkHttpClient.Builder#useWith` now deprecated and must be replaced by the same in `com.github.insanusmokrassar.TelegramBotAPI.bot.Ktor` package * Replace `ProxySettings` data class in `settings` package, deprecate old link * `BaseRequestsExecutor` now have no it's own scope * Add `RequestLimiter` and base realisations * Now `KtorRequestsExecutor` can receive as one of parameters `RequestLimiter` (by default - `EmptyLimiter`) ## 0.8.5 * Add extension `String#toMarkdown` * Fix of inserting of text when create Markdown-adapted text from text and text entities * Fix default realisation of MessageEntity#asMarkdownSource ## 0.8.4 * Added `createMarkdownText` and extensions for `CaptionedMediaContent` and `TextContent` * Added `ResendableContent` and realize in different contents * Animation * Audio * Document * Photo * Sticker * Video * VideoNote * Voice * `MessageContent` now is `ResendableContent` * Now all media sending factories which contains `thumb` have default `null` value * `ChatIdentifier` classes now are `data` classes * Now `MediaGroupContent` interface contains `toMediaGroupMemberInputMedia` method for easily creating mirror input media * Change signature of `Update` * Now `Update` is untyped and data is `Any` * Media groups now are separated type of updates and you can subscribe on that receiving directly * Now `AdministratorChatMember` is interface and `CreatorChatMember` implement it ## 0.8.3 * Now `ForwardedMessage` contains nullable `from` ## 0.8.2 * Add `FromUserMessage` which must be implemented in all messages realisations which have `user` field * Add `CommonMediaGroupMessage` which in fact extension of `MediaGroupMessage` with implementation of `FromUserMessage` * `CommonMessageImpl` now implementing `FromUserMessage` ## 0.8.1 * Update `MediaGroupMessage` interface * Add implementation of `MediaGroupMessage` * Add generating of `MediaGroupMessage` in `RawMessage`