tgbotapi/CHANGELOG.md

TelegramBotAPI changelog

0.28.0

RC

THIS VERSION CONTAINS BREAKING CHANGES

• 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

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.11

• TelegramBotAPI:
  • Extension String#filenameFromUrl was created
    • Extension PathedFile#filename was created
• TelegramBotAPI-extensions-utils:
  • Flow<Iterable<T>>.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<BaseSentMessageUpdate>#textMessages were added:
    • Flow<BaseSentMessageUpdate>#animationMessages
    • Flow<BaseSentMessageUpdate>#audioMessages
    • Flow<BaseSentMessageUpdate>#contactMessages
    • Flow<BaseSentMessageUpdate>#diceMessages
    • Flow<BaseSentMessageUpdate>#documentMessages
    • Flow<BaseSentMessageUpdate>#gameMessages
    • Flow<BaseSentMessageUpdate>#invoiceMessages
    • Flow<BaseSentMessageUpdate>#locationMessages
    • Flow<BaseSentMessageUpdate>#photoMessages
      • Flow<BaseSentMessageUpdate>#imageMessages
    • Flow<BaseSentMessageUpdate>#pollMessages
    • Flow<BaseSentMessageUpdate>#stickerMessages
    • Flow<BaseSentMessageUpdate>#textMessages
    • Flow<BaseSentMessageUpdate>#venueMessages
    • Flow<BaseSentMessageUpdate>#videoMessages
    • Flow<BaseSentMessageUpdate>#videoNoteMessages
    • Flow<BaseSentMessageUpdate>#voiceMessages
    • Flow<BaseSentMessageUpdate>#mediaGroupMessages
    • Flow<BaseSentMessageUpdate>#mediaGroupPhotosMessages
    • Flow<BaseSentMessageUpdate>#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<BaseMessageUpdate>
    • 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<BaseMessageUpdate>
      • Several new extensions for SentMediaGroupUpdate were added:
        • SentMediaGroupUpdate#forwardInfo
        • SentMediaGroupUpdate#replyTo
        • SentMediaGroupUpdate#chat
        • SentMediaGroupUpdate#mediaGroupId
      • Several List<MediaGroupMessage>.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<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)
  • Class Dice was added (type dice)
  • Class DiceContent was added (for including it in 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, PR-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)
  • 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:

  • 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 TextSources 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
    • 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:

• 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 MediaGroupMessages 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