2019-01-01 10:15:01 +00:00
# TelegramBotAPI changelog
2020-03-30 16:18:59 +00:00
## 0.26.0
2020-03-30 15:16:04 +00:00
2020-03-30 15:30:22 +00:00
* `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)
2020-03-30 15:40:36 +00:00
* `BotCommand` was added
2020-03-30 15:52:00 +00:00
* `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`
2020-03-30 16:03:59 +00:00
* `CreateNewStickerSet` renamed to `CreateStaticNewStickerSet`
* `CreateNewAnimatedStickerSet` request was added (it handle work with `tgs_sticker` )
2020-03-30 16:07:13 +00:00
* `StickerSet#thumb` was added
2020-03-30 16:12:31 +00:00
* `AddStickerToSet` renamed to `AddStaticStickerToSet`
* `AddAnimatedStickerToSet` request was added
2020-03-30 16:29:34 +00:00
* `SetStickerSetThumb` request was added
2020-03-30 16:31:54 +00:00
* Most of sticker actions now implements `StandardStickerSetAction` instead of `StickerSetAction`
2020-03-30 15:33:17 +00:00
* `TelegramBotAPI-extensions-api` :
* Extensions `sendDice` was added
2020-03-30 15:52:00 +00:00
* 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`
2020-03-30 16:03:59 +00:00
* **All extensions `createNewStickerSet` was renamed to `createNewStaticStickerSet` **
* Extensions `createNewAnimatedStickerSet` was added
2020-03-30 16:12:31 +00:00
* **All extensions `addStickerToSet` was renamed to `addStaticStickerToSet` **
* Extensions `addAnimatedStickerToSet` was added
2020-03-30 16:29:34 +00:00
* Extensions `setStickerSetThumb` was added
2020-03-30 15:30:22 +00:00
2020-03-30 16:18:59 +00:00
## 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`
2020-03-26 08:13:00 +00:00
### 0.25.1
2020-03-26 08:27:17 +00:00
* Update kotlin: `1.3.70` -> `1.3.71`
2020-03-26 08:26:44 +00:00
* Fix of error inside of update utils for media groups
2020-02-23 14:23:33 +00:00
## 0.24.0
* `TelegramBotAPI` :
* All suspend functions for `RequestsExecutor` was removed (due to replacement into
[TelegramBotAPI extensions project ](TelegramBotAPI-extensions-api/README.md ))
2020-02-25 07:45:32 +00:00
* `ForwardFromChannelInfo#channelChat` now is `ChannelChat` instead of `Chat`
2020-02-23 15:29:31 +00:00
* `TelegramBotAPI-extensions-api` :
* Most part of sending media messages functions was removed and replaced with their `InputFile` args analogs
2020-03-17 10:47:59 +00:00
### 0.24.1
2020-02-23 14:23:33 +00:00
2020-03-17 10:59:28 +00:00
* `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`
2020-03-17 11:16:14 +00:00
* `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`
2020-03-17 13:46:42 +00:00
* `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
2020-03-17 14:24:31 +00:00
* `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)
2020-03-17 15:24:04 +00:00
* `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`
2020-03-17 10:59:28 +00:00
* `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`
2020-03-17 11:20:42 +00:00
* Now new method of getting updates available: `startGettingUpdates` with `UpdatesFilter` as incoming first
parameter
2020-03-17 14:24:31 +00:00
* `startGettingUpdates` with `receiver` and `allowedUpdates` parameters now will handle updates by itself
2020-03-17 10:59:28 +00:00
2020-01-23 10:00:46 +00:00
## 0.23.0 TelegramBotAPI 4.6
2020-01-23 10:36:25 +00:00
* `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
2020-01-23 14:11:24 +00:00
* `AnonymousPollOption` was renamed to `SimplePollOption`
2020-01-23 11:01:13 +00:00
* `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`
2020-01-23 11:25:25 +00:00
* `Poll#createRequest` extension was added
2020-01-23 11:29:09 +00:00
* `PollAnswerUpdate` type of update was added
2020-01-23 11:32:04 +00:00
* `PollAnswer` type was added
* `UpdatesFilter` now support work with `PollAnswerUpdate`
* `language` field in PreTextSource now correctly passed from telegram MessageEntities
2020-01-23 12:06:22 +00:00
* `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`
2020-01-23 13:08:02 +00:00
* `User` now is sealed class
* `CommonUser` was added as representation of default `User`
2020-01-23 16:32:45 +00:00
* `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
2020-01-23 13:14:33 +00:00
* Now extension `javaLocale` is extension for `CommonUser`
2020-01-23 10:36:25 +00:00
2020-02-01 08:14:45 +00:00
### 0.23.1
2020-02-06 06:07:23 +00:00
* 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
2020-02-06 07:29:14 +00:00
* `CommonMultipartFileRequest` now is internal
2020-02-06 16:32:20 +00:00
* Added `LiveLocation` class for more useful tracking live locations
2020-02-07 04:47:35 +00:00
* `InvoiceOfPayment` is renamed to `InvoiceContent` and now is `MessageContent` instead of `PaymentInfo`
* `SendInvoice` now return `ContentMessage<InvoiceContent>`
2020-02-06 18:15:28 +00:00
* `paymentInfo` inside of `CommonMessageImpl` now can be set only to `SuccessfulPaymentInfo`
2020-02-07 04:36:31 +00:00
* Added `RecordVideoNoteAction` and `UploadVideoNoteAction` for `record_video_note` and `upload_video_note` actions
2020-02-07 05:00:21 +00:00
* For most part of messages was added `RequestsExecutor` extensions for more useful way of usage
2020-02-07 16:12:18 +00:00
* `toInputFile` extensions now will return more exact types
2020-02-09 09:15:36 +00:00
* Now it is possible to send broadcast channels size for `FlowsUpdatesFilter`
2020-02-06 06:07:23 +00:00
2020-02-14 06:06:43 +00:00
### 0.23.2
* Fixes in `InputMedia` - `media` field was not included to serialization
2020-02-15 10:56:15 +00:00
### 0.23.3 Project separating prepare version
2020-02-14 18:55:37 +00:00
2020-02-15 09:33:04 +00:00
__API Extensions__
2020-02-15 09:37:15 +00:00
* Project created
2020-02-15 09:33:04 +00:00
* For `SendPhoto` was added new functions for uploading of `MultipartFile`
* `deleteWebhook` extension for `RequestsExecutor` was added
__Telegram Bot API__
2020-02-15 09:37:15 +00:00
* All `RequestsExecutor` extensions related to Telegram Bots API was replaced into `API Extensions` project
2020-02-15 09:33:04 +00:00
2020-01-15 07:12:35 +00:00
## 0.22.0
2020-01-08 06:11:57 +00:00
2020-01-15 06:28:06 +00:00
* **`KtorCallFactory` must return `HttpStatement` instead of `HttpClientCall` **
2020-01-15 05:48:44 +00:00
* `SendMessage` was renamed to `SendTextMessage` and previous `SendMessage` is deprecated
2020-01-15 06:52:52 +00:00
* 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`
2020-01-15 07:03:42 +00:00
* 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.**
2020-01-15 07:27:29 +00:00
* `EditChatMessage` now have generic type and extends `SimpleRequest<ContentMessage<GenericType>>`
2020-01-15 07:30:28 +00:00
* `ResendableContent` now extends `Request<out Message>` instead of `Request<Message>`
2020-01-15 05:48:44 +00:00
* Most part of requests have changed return type. They are listed below:
< details >
* `ForwardMessage`
* `GetChatAdministrators`
* `EditChatMessageLiveLocation`
* `StopChatMessageLiveLocation`
* `EditChatMessageText`
* `EditChatMessageCaption`
* `EditChatMessageMedia`
* `EditChatMessageReplyMarkup`
* `SendAnimation`
* `SendAudio`
* `SendContact`
* `SendLocation`
* `SendTextMessage`
* `SendPoll`
* `SendVenue`
* `SendGame`
* `SendDocument`
* `SendMediaGroup`
* `SendPhoto`
* `SendVideo`
* `SendVideoNote`
* `SendVoice`
* `SendSticker`
< / details >
* Changed type of `createResend`
< details >
* `GameContent`
* `LocationContent`
* `PollContent`
* `TextContent`
* `VenueContent`
* `AnimationContent`
* `AudioContent`
* `DocumentContent`
* `ContactContent`
* `PhotoContent`
* `VideoContent`
* `VideoNoteContent`
* `VoiceContent`
* `StickerContent`
< / details >
2020-01-15 06:28:06 +00:00
* Version updates:
* Ktor `1.2.6` -> `1.3.0`
2020-01-15 05:48:44 +00:00
2020-01-20 08:42:38 +00:00
### 0.22.1 MediaContent#asInputMedia
* All `MediaContent` instances now can create their `InputMedia` analog
2020-01-20 10:35:36 +00:00
* 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
2020-01-20 08:42:38 +00:00
2020-01-22 21:03:38 +00:00
### 0.22.2 CashTag and independent updates handling
2020-01-22 21:05:28 +00:00
* `cashtag` entity type was added
2020-01-22 21:47:43 +00:00
* Several `Unknown*` realizations was added:
* `UnknownUpdateType`
* `UnknownMessageType`
* `UnknownChatType`
2020-01-22 21:59:59 +00:00
* `UnknownCallbackQueryType`
2020-01-22 22:21:45 +00:00
* `UpdatesFilter` now have one additional income callback: `unknownUpdateTypeCallback`
* `createSimpleUpdateFilter` can receive one more callback: `unknownCallback` (for `unknownUpdateTypeCallback` )
2020-01-22 21:05:28 +00:00
2020-01-15 06:31:17 +00:00
## 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`
2019-12-03 05:07:25 +00:00
## 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
2019-12-11 03:45:31 +00:00
### 0.20.1
2019-12-11 04:18:12 +00:00
* `User` now implement `PrivateChat`
* `TextMentionMessageEntity` now accept `PrivateChat` instead of `User` in main constructor
* `TextMentionMessageEntity` now contains not user, but contains `PrivateChat`
2019-12-11 11:05:48 +00:00
* Fixed: `TextMentionMessageEntity#asHtmlSource` previously worked incorrect
2019-12-11 07:49:17 +00:00
* Abstraction `TextSource`
* `MessageEntity` now extends `TextSource`
* `createFormattedText` method now accept `List<TextSource>`
* `createHtmlText` method now accept `List<TextSource>`
* `createMarkdownText` method now accept `List<TextSource>`
2019-12-11 08:06:09 +00:00
* 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
2019-12-11 04:18:12 +00:00
2019-12-13 17:34:58 +00:00
### 0.20.2
* New exception type `MessageIsNotModifierException` was added
2019-12-13 17:55:06 +00:00
* New exception type `MessageToEditNotFoundException` was added
2019-12-13 17:54:02 +00:00
* Now exceptions in requests will be caught correctly
2019-12-13 17:34:58 +00:00
2019-12-16 17:24:40 +00:00
### 0.20.3
* Now `LeftChatMamber` is a `CommonEvent`
2020-01-01 08:06:03 +00:00
### 0.20.4
2020-01-01 08:07:17 +00:00
* Now `setWebhook` supports setting up of path for listening
2020-01-01 08:43:32 +00:00
* Now `setWebhook` supports custom listen address even if certificate was not provided
2020-01-01 08:07:17 +00:00
2019-12-02 07:52:22 +00:00
## 0.19.0 ImplicitReflection removing
2019-12-02 08:35:37 +00:00
* 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
2019-12-02 08:39:19 +00:00
* 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`
2019-12-02 08:44:23 +00:00
* `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`
2019-12-02 08:48:23 +00:00
* `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)`
2019-12-02 08:35:37 +00:00
2019-08-18 06:31:33 +00:00
## 0.18.0 Raws cleaning
2019-08-17 05:32:39 +00:00
2019-08-17 16:55:41 +00:00
* 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)
2019-08-17 05:50:46 +00:00
* `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
2019-08-17 05:53:19 +00:00
* Update of description
2019-08-17 16:48:18 +00:00
* Make `Game` object a little bit more standartizated
2019-08-18 06:31:33 +00:00
* `Game` now is not serializable and have no additional trash, related to serialization
2019-08-18 06:58:17 +00:00
* `TelegramFile` was removed
2019-08-17 05:50:46 +00:00
2019-11-29 06:19:24 +00:00
### 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
2019-11-29 06:26:31 +00:00
* `ktor` : 1.2.3 -> 1.2.6
2019-11-29 06:25:22 +00:00
* `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)
2019-11-29 06:19:24 +00:00
2019-08-18 06:31:33 +00:00
## 0.17.0 July 29, 2019 API Update
2019-07-22 23:24:14 +00:00
2019-08-12 09:15:22 +00:00
Libraries updates:
2019-07-22 23:43:32 +00:00
* 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`
2019-08-12 12:03:38 +00:00
* ktor version `1.1.4` -> `1.2.3`
2019-07-22 23:43:32 +00:00
2019-08-12 07:25:55 +00:00
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`
2019-08-12 07:46:16 +00:00
* `ChatPermissions` object was added, `GroupChat` interface got `permissions` field, request `SetChatPermissions` was added
2019-08-12 07:48:38 +00:00
* `GroupChat` object now have no field `allMembersAreAdmins`
2019-08-12 08:09:14 +00:00
* `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
2019-08-12 08:15:06 +00:00
* All `GroupChat` instances have description
2019-08-12 07:25:55 +00:00
2019-08-12 09:15:22 +00:00
Other important changes:
* Totally reworked chats hierarchy. `Extended` abstractions was added for cases when called `GetChat` request
2019-08-12 09:41:07 +00:00
* `RawChat` boilerplate was removed and replaced by serializers
2019-08-12 11:25:51 +00:00
* `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)
2019-08-12 09:15:22 +00:00
* `RequestsExecutor` now is `Closeable`
* `TelegramAPIUrlsKeeper` was added to provide more comfortable work with file urls and other things
like this
2019-06-01 09:12:57 +00:00
## 0.16.0 Bot API 4.3
2019-06-01 09:21:02 +00:00
* `LoginURL` and `LoginURLInlineKeyboardButton` has been added
2019-06-01 09:28:37 +00:00
* `replyMarkup` field was added to the `CommonMessage` objects via `AbleToBeMarkedUp` interface
2019-06-01 09:31:48 +00:00
* `SwitchInlineQueryCurrentChatInlineKeyboardButton#switchInlineQueryCurrentChat` field fixed
2019-06-02 14:02:12 +00:00
* `InlineKeyboardButton` now is sealed class and all its possible realisations are inside of its class file
2019-06-02 14:57:52 +00:00
* `String#asUsername` method renamed to `String#toUsername`
2019-06-02 14:59:24 +00:00
* Several `toChatId` extensions added
2019-06-01 09:21:02 +00:00
2019-06-28 10:31:08 +00:00
### 0.16.1
2019-06-28 10:43:54 +00:00
* Now old uncommon `CaptionedMediaContent` and `CaptionedInputMedia` are replaced by almost the same
interfaces `CaptionedInput` and `CaptionedOutput` . They are both implementing `Captioned` interface
2019-06-28 10:58:35 +00:00
* `AnimationContent` now is `CaptionedInput`
2019-06-28 10:43:54 +00:00
2019-05-25 06:14:44 +00:00
## 0.15.0
2019-05-28 11:13:01 +00:00
* 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`
2019-05-28 11:14:32 +00:00
* Added `CIO` ktor client engine as lightweight default engine for long-polling
2019-05-28 11:13:01 +00:00
2019-04-20 04:17:03 +00:00
## 0.14.0
2019-04-20 04:55:11 +00:00
* 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`
2019-04-26 02:34:32 +00:00
* Requests results now always decoding as `UTF-8`
2019-04-26 03:12:01 +00:00
* `AbstractRequestCallFactory` was added with cache of methods urls to avoid memory leaks
* Small refactoring of work with response in `KtorRequestsExecutor`
2019-04-26 06:09:45 +00:00
* Kotlin version `1.3.30` -> `1.3.31`
2019-04-28 00:57:51 +00:00
* Kotlin coroutines `1.2.0` -> `1.2.1`
2019-04-30 07:56:28 +00:00
* `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
2019-04-20 04:55:11 +00:00
2019-05-10 03:16:31 +00:00
### 0.14.1
2019-05-10 03:26:58 +00:00
* Replace `UpdatesFilter` and `UpdatesPoller` into another package
2019-05-10 03:30:26 +00:00
* Replace `WebhookPrivateKeyConfig`
2019-05-10 03:54:57 +00:00
* Added `FlowsUpdatesFilter`
2019-05-10 05:14:50 +00:00
* `UpdatesFilter` now have additional callback for polls
2019-05-10 11:17:47 +00:00
* `StopPoll#replyMarkup` now is optional
2019-05-10 03:26:58 +00:00
2019-05-16 06:58:19 +00:00
### 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
2019-04-14 10:51:13 +00:00
## 0.13.0 Telegram Polls
2019-04-16 07:51:53 +00:00
* Type `PollOption` and `AnonymousPollOption` added
* Type `Poll` added
2019-04-16 07:56:04 +00:00
* Type `PollUpdate` added and implemented in `RawUpdate` . Now `PollUpdate` can be retrieved from `RawUpdate`
2019-04-16 08:16:13 +00:00
* Type `PollContent` added - now it can be a value of `ContentMessage#content`
* Request `SendPoll` added and `PollContent#createResend` now use it
2019-04-16 08:45:20 +00:00
* `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
2019-04-16 09:03:35 +00:00
* 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
2019-04-16 09:10:20 +00:00
* `is_member` field added into `RestrictedChatMember`
2019-04-16 09:26:02 +00:00
* **BREAK CHANGES** Now `ForwardedMessages` can be `AnonymousForwardedMessage` and `PublicForwardedMessage` . Old
implementations now extend `PublicForwardedMessage`
2019-04-16 07:45:29 +00:00
2019-02-26 08:01:26 +00:00
## 0.12.0 Webhooks
2019-02-26 01:15:52 +00:00
2019-02-26 01:45:56 +00:00
* 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
2019-02-26 08:01:26 +00:00
* 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
2019-02-27 03:01:32 +00:00
* Added new type of updates `MediaGroupUpdate` , which can be received only from filters
* `UpdatesFilter` now use new type of updates for mediagroups
2019-02-27 06:01:04 +00:00
* Add `GetWebhookInfo` request and `WebhookInfo` type
* Replace updates types into separated place in types
2019-03-04 02:32:26 +00:00
* Now default `RequestException` will contain plain answer from telegram
2019-03-06 00:10:29 +00:00
* Added `UnauthorizedException`
* `RequestException` now is sealed
* Rename `ReplyMessageNotFound` to `ReplyMessageNotFoundException`
2019-03-06 02:09:45 +00:00
* Added `List<BaseMessageUpdate>#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`
2019-02-26 01:45:56 +00:00
2019-03-14 07:44:19 +00:00
### 0.12.1 Hotfix for media groups
* Added additional media group types (like `MessageMediaGroupUpdate` )
* Fixed handling of media group updates in `UpdatesFilter`
2019-03-14 23:24:10 +00:00
### 0.12.2
2019-03-15 00:16:01 +00:00
* 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<Update>` as common supertype
for receivers.
2019-03-20 00:52:36 +00:00
### 0.12.3 Cleaning
2019-03-20 00:53:37 +00:00
* Refactor, optimizing and cleaning of code
2019-03-20 00:55:46 +00:00
* Removed deprecated method `T#toJsonWithoutNulls()`
2019-03-21 00:45:51 +00:00
* Renamed instances of `MediaGroupMessage` s and refactored their interfaces. `ChannelMediaGroupMessage`
will not contain `user` field (but `CommonMediaGroupMessage` will have)
2019-03-21 01:18:54 +00:00
* 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`
2019-03-22 01:07:09 +00:00
* Fix in order of media group messages which was received by webhooks
2019-03-20 00:53:37 +00:00
2019-03-27 01:35:37 +00:00
### 0.12.4
2019-03-23 06:26:22 +00:00
2019-03-23 06:31:13 +00:00
* Optimized preparing of media group in `UpdatesPoller`
2019-03-27 01:13:07 +00:00
* Add `CommonLimiter`
2019-03-27 01:35:37 +00:00
* Add `MessageEntity#asHtmlSource` and `String#toHtml`
2019-03-27 01:43:36 +00:00
* Add tools for work with html captions and texts
2019-03-30 12:12:00 +00:00
* `MessageContent` which using captions or text now have default parse mode `HTMLParseMode` due to issue with escaping
of `]` in links titles
2019-03-31 02:20:14 +00:00
* Added `Markdown` and `HTML` type aliases which actually means `MarkdownParseMode` and `HTMLParseMode`
2019-03-31 03:11:32 +00:00
* `ChatId` now have extension `link` which will automatically create link like `tg://user?id=<chatId>`
* Created a few of methods for all supported formats of text like bold, italic, links and others
2019-03-31 03:26:41 +00:00
* Rewritten `MessageEntities` to use new formatting options
2019-03-23 06:31:13 +00:00
2019-04-05 05:11:17 +00:00
### 0.12.5 `MediaContent` improvements
2019-04-04 03:04:22 +00:00
2019-04-04 11:32:47 +00:00
* Now `MediaGroupContent` is `MediaContent`
2019-04-04 14:10:52 +00:00
* All `MedaContent` now have no generics and have basic `TelegramMediaFile` media field
2019-04-04 11:32:47 +00:00
2019-04-13 01:23:55 +00:00
### 0.12.6 Libraries updates
2019-04-13 01:26:41 +00:00
* `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`
2019-04-13 08:02:24 +00:00
* Added `DeleteWebhook` request
2019-04-13 08:06:58 +00:00
* All default `startGettingOfUpdates` (in fact - method `start` of `UpdatesPoller` ) are suspend and
will try to delete webhook
2019-04-13 01:26:41 +00:00
2019-04-15 09:06:33 +00:00
### 0.12.7 Hotfix version
2019-04-15 11:31:54 +00:00
* Now temporary all requests of input media will contains `file` field
2019-02-21 04:07:05 +00:00
## 0.11.0
2019-02-21 04:10:14 +00:00
* 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`
2019-02-07 06:21:46 +00:00
## 0.10.0
2019-01-01 10:15:01 +00:00
2019-02-07 06:29:38 +00:00
* 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
2019-02-07 12:19:25 +00:00
* Fixes in edition of inline messages and their result types
2019-02-10 05:41:20 +00:00
* Replace basic exception and add `ReplyMessageNotFound` exception
2019-02-07 06:29:38 +00:00
2019-02-14 08:39:55 +00:00
### 0.10.1
2019-02-14 08:45:25 +00:00
* Change algorithm of `executeUnsafe` : now it use loop instead of recursive calling
2019-02-15 01:54:18 +00:00
* Add additional `startGettingUpdates` with better management of received updates for media groups
2019-02-17 06:29:17 +00:00
* Now `MediaGroupMessage` is `CommonMessage` with `MediaGroupContent` content
2019-02-17 08:39:04 +00:00
* Added extensions `replyTo` , `forwarded` and `chat` for `List<BaseMessageUpdated>` for comfortable
work with media groups lists
2019-02-17 10:53:00 +00:00
* Fix `parseMode` of `InputTextMessageContent`
2019-02-14 08:45:25 +00:00
2019-02-17 13:10:42 +00:00
### 0.10.2
2019-02-17 13:12:56 +00:00
* 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 `@`
2019-02-18 04:56:50 +00:00
* Now most part of usernames in library have type `Username`
2019-02-18 04:59:09 +00:00
* Fix `replyMarkup` in `InlineQueryResultArticle`
2019-02-17 13:12:56 +00:00
2019-02-18 06:35:58 +00:00
### 0.10.3
* Hotfix for username data class
2019-01-26 05:28:54 +00:00
## 0.9.0
2019-01-10 14:09:51 +00:00
2019-01-26 05:28:54 +00:00
* 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` )
2019-01-10 14:09:51 +00:00
2019-01-29 00:14:52 +00:00
### 0.9.1
2019-01-29 00:18:07 +00:00
* Updated built-in lengths restrictions
2019-01-29 00:18:52 +00:00
* Apply restrictions of text limit for sending messages
2019-01-29 01:47:01 +00:00
* 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
2019-01-29 02:13:59 +00:00
* Change signature of `createMarkdownText` : now it will return list of strings
* Deprecate old signatures of `createMarkdownText` , `toMarkdownCaption` , `toMarkdownText`
2019-01-29 02:22:09 +00:00
* Add `ResendableContent#createResends` which create adapted list of resends for content
* Add `TextContent` own `createResends` realisation
2019-01-29 00:18:07 +00:00
2019-01-31 01:52:43 +00:00
### 0.9.2
2019-01-31 01:53:58 +00:00
* `RequestsExecutor#executeAsync(Request, CoroutineScope)` now will return `Deferred` for cases when you need result
2019-01-31 01:57:49 +00:00
* `RequestsExecutor#executeUnsafe` will automatically retry request if it was unsuccessful and retries > 0
2019-01-31 01:53:58 +00:00
2019-02-05 04:27:33 +00:00
### 0.9.3
2019-02-05 04:30:09 +00:00
* `KtorRequestsExecutor` now can use custom `JSON` string formatter (by default - non strict)
2019-02-05 04:40:29 +00:00
* `ResponseParameters` renamed to `Response`
2019-02-05 04:58:38 +00:00
* 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`
2019-02-05 04:30:09 +00:00
2019-01-26 05:28:54 +00:00
### 0.8.5
2019-01-11 03:54:51 +00:00
2019-01-26 05:28:54 +00:00
* 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
2019-01-17 00:21:01 +00:00
2019-01-23 04:15:57 +00:00
### 0.8.4
2019-01-17 01:42:23 +00:00
* Added `createMarkdownText` and extensions for `CaptionedMediaContent` and `TextContent`
2019-01-17 02:19:33 +00:00
* Added `ResendableContent` and realize in different contents
* Animation
* Audio
* Document
* Photo
* Sticker
* Video
* VideoNote
* Voice
2019-01-17 02:40:37 +00:00
* `MessageContent` now is `ResendableContent`
2019-01-20 05:13:42 +00:00
* Now all media sending factories which contains `thumb` have default `null` value
2019-01-21 00:23:27 +00:00
* `ChatIdentifier` classes now are `data` classes
2019-01-21 02:22:51 +00:00
* Now `MediaGroupContent` interface contains `toMediaGroupMemberInputMedia` method for easily creating mirror input media
2019-01-21 06:13:31 +00:00
* 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
2019-01-21 08:04:55 +00:00
* Now `AdministratorChatMember` is interface and `CreatorChatMember` implement it
2019-01-23 04:15:57 +00:00
2019-01-26 05:28:54 +00:00
### 0.8.3
2019-01-23 04:15:57 +00:00
2019-01-26 05:28:54 +00:00
* Now `ForwardedMessage` contains nullable `from`
2019-01-24 00:20:13 +00:00
2019-01-26 05:28:54 +00:00
### 0.8.2
2019-01-24 00:37:39 +00:00
2019-01-26 05:28:54 +00:00
* 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`
