mirror of
https://github.com/InsanusMokrassar/TelegramBotAPI.git
synced 2024-11-04 15:33:47 +00:00
847 lines
40 KiB
Markdown
847 lines
40 KiB
Markdown
# TelegramBotAPI changelog
|
|
|
|
## 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<TextPart>#justTextSources` was added for mapping of `List<TextPart>` to `List<TextSource>`
|
|
* 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<TextSource>` 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.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<ChatEventMessage>#onlyChannelEvents` was added
|
|
* Extension `Flow<ChatEventMessage>#onlyGroupEvents` was added
|
|
* Extension `Flow<ChatEventMessage>#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<TextSource>` 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<InvoiceContent>`
|
|
* `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<ContentMessage<GenericType>>`
|
|
* `ResendableContent` now extends `Request<out Message>` instead of `Request<Message>`
|
|
* 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>
|
|
* 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<TextSource>`
|
|
* `createHtmlText` method now accept `List<TextSource>`
|
|
* `createMarkdownText` method now accept `List<TextSource>`
|
|
* 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<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`
|
|
|
|
### 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<Update>` 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=<chatId>`
|
|
* 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<BaseMessageUpdated>` 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`
|