# TelegramBotAPI changelog ## 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 ## 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.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.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.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.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.25.1 * Update kotlin: `1.3.70` -> `1.3.71` * Fix of error inside of update utils for media groups ## 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.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.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.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.2 * Fixes in `InputMedia` - `media` field was not included to serialization ### 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.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.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.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.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.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.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.2 * New exception type `MessageIsNotModifierException` was added * New exception type `MessageToEditNotFoundException` was added * Now exceptions in requests will be caught correctly ### 0.20.3 * Now `LeftChatMamber` is a `CommonEvent` ### 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.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.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.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.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.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.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.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.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.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.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.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.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.12.1 Hotfix for media groups * Added additional media group types (like `MessageMediaGroupUpdate`) * Fixed handling of media group updates in `UpdatesFilter` ### 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.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.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.5 `MediaContent` improvements * Now `MediaGroupContent` is `MediaContent` * All `MedaContent` now have no generics and have basic `TelegramMediaFile` media 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.7 Hotfix version * Now temporary all requests of input media will contains `file` field ## 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.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.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.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.3 * Hotfix for username data class ## 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.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.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.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.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`