Update telegram_bot_api_version to v34

[renovate]

ℹ️ Note

This PR body was truncated due to platform limits.

This PR contains the following updates:

Package	Change	Age	Confidence
dev.inmo:tgbotapi (source)	0.38.12 → 34.0.0

---

Release Notes

insanusmokrassar/TelegramBotAPI (dev.inmo:tgbotapi)

v34.0.0

THIS UPDATE CONTAINS SUPPORT OF TELEGRAM BOTS API 10.0

THIS UPDATE CONTAINS BREAKING CHANGES

Breaking changes:

• Removed the CommonMessage<T> super-type — replaced by the new sealed ChatContentMessage<T> (CommonContentMessage, ChatMessage); code referencing CommonMessage in types, when branches or signatures must switch to ChatContentMessage
• Renamed casts commonMessageOrNull/commonMessageOrThrow/ifCommonMessage to chatContentMessageOrNull/chatContentMessageOrThrow/ifChatContentMessage
• Reworked the message hierarchy (ContentMessage, Message, FromUserMessage, PossiblyEditedMessage, PossiblyForwardedMessage, PossiblyPaymentMessage, PossiblySentViaBotCommonMessage, PossiblyTopicMessage, SignedMessage, ChatEventMessage, PassportMessage) and related typealiases — dependent type signatures may need updates
• Chat send/reply extensions now return ChatContentMessage<*> (previously ContentMessage<*>)
• ChatPermissions interface gained the abstract canReactToMessages member — custom implementations must add it
• SendMessageDraft no longer throws when the text length is out of range: it now logs a warning and validates against the new draftMessageTextLength (0..textLength.last) range, allowing empty text
• pollOptionsLimit changed from 2..12 to 1..12

Migration advice: Replace CommonMessage usages with ChatContentMessage, commonMessageOr with chatContentMessageOr

• Core:
  • (Guest Mode) Added GuestQueryId value class in dev.inmo.tgbotapi.types and WithOptionalGuestQueryId interface in dev.inmo.tgbotapi.abstracts.types
  • (Guest Mode) Added RequestGuestMessage and RequestGuestContentMessage<T> message abstractions (CommonContentMessage, SpecialMessage, FromUserMessage, PossiblySentViaBot) exposing guestQueryId; added PossiblyGuestAnswerMessage exposing guestBotCallerUser and guestBotCallerChat
  • (Guest Mode) Added RequestGuestContentMessageImpl data class implementing RequestGuestContentMessage
  • (Guest Mode) Added SentGuestMessage carrying InlineMessageId
  • (Guest Mode) Added GuestMessageUpdate (BaseSentMessageUpdate) and guest_message update type wiring in RawUpdate/UpdateTypes/FlowsUpdatesFilter
  • (Guest Mode) Added AnswerGuestQuery request returning SentGuestMessage
  • Introduced sealed ChatContentMessage<T> super-type extending CommonContentMessage and ChatMessage, used as the common return type of chat send/reply operations
  • Reworked ContentMessage, Message, FromUserMessage, PossiblyEditedMessage, PossiblyForwardedMessage, PossiblyPaymentMessage, PossiblySentViaBotCommonMessage, PossiblyTopicMessage, SignedMessage, ChatEventMessage, PassportMessage and related typealiases to integrate guest messages and unify chat content messages
  • Updated RawMessage, MessageUpdate, ChannelPostUpdate, BusinessMessageUpdate, EditMessageUpdate, EditChannelPostUpdate, BaseMessageUpdate, BaseEditMessageUpdate, BaseSentMessageUpdate to align with the new hierarchy
  • (Live Photos) Added LivePhotoFile class representing the incoming LivePhoto Telegram type (PollMedia, MediaContentVariant, UsefulAsPaidMediaFile)
  • (Live Photos) Added LivePhotoContent (VisualMediaGroupPartContent) representing live photo messages
  • (Live Photos) Added TelegramMediaLivePhoto (TelegramFreeMedia, VisualMediaGroupMemberTelegramMedia, InputPollMedia, InputPollOptionMedia) — usable in sendMediaGroup, editMessageMedia, and polls
  • (Live Photos) Added TelegramPaidMediaLivePhoto (VisualTelegramPaidMedia) for paid live photos
  • (Live Photos) Added PaidMedia.LivePhoto variant and PaidMedia.LivePhoto.toTelegramPaidMediaLivePhoto() conversion
  • (Live Photos) Added livePhotoField constant; added live_photo parsing to RawMessage and ReplyInfo.External surrogate
  • (Live Photos) Added SendLivePhoto request and SendLivePhotoData/SendLivePhotoFiles
  • (Live Photos) Added LivePhotoMessage typealias
  • (Live Photos) Added LivePhotoFile.toTelegramMediaLivePhoto(...) and LivePhotoFile.toTelegramPaidMediaLivePhoto() extensions
  • (Chat Management) Added canReactToMessages field to ChatPermissions (interface, Granular and Common) and RestrictedMemberChatMember
  • (Chat Management) Added optional retrieveOtherBots parameter to GetChatAdministrators request
  • (Chat Management) Added DeleteMessageReaction request with @Warning on primary constructor; added DeleteUserMessageReaction and DeleteActorChatMessageReaction factory functions
  • (Chat Management) Added DeleteAllMessageReactions request with @Warning on primary constructor; added DeleteAllUserMessageReactions and DeleteAllActorChatMessageReactions factory functions
  • (Polls) Added TelegramMediaSticker, TelegramMediaLocation and TelegramMediaVenue classes
  • (Polls) Added InputPollMedia and InputPollOptionMedia sealed interfaces representing input media variants accepted by sendPoll
  • (Polls) Added PollMedia class representing media attached to polls in incoming updates
  • (Polls) Added media field to Poll, PollOption and InputPollOption
  • (Polls) Added explanationMedia field to QuizPoll
  • (Polls) Added membersOnly field to Poll
  • (Polls) Added countryCodes field to Poll
  • (Polls) Added media, membersOnly, countryCodes parameters to SendRegularPoll and SendPoll factory functions
  • (Polls) Added media, explanationMedia, membersOnly, countryCodes parameters to SendQuizPoll factory functions
  • (Polls) Decreased minimum allowed poll options count from 2 to 1 (pollOptionsLimit is now 1..12)
  • (Managed Bots Access) Added BotAccessSettings data class in dev.inmo.tgbotapi.types.managed_bots with isAccessRestricted and addedUsers fields
  • (Managed Bots Access) Added GetManagedBotAccessSettings request returning BotAccessSettings
  • (Managed Bots Access) Added SetManagedBotAccessSettings request with userId and optional addedUserIds (isAccessRestricted is derived from addedUserIds)
  • (Managed Bots Access) Added isAccessRestrictedField, addedUsersField, addedUserIdsField constants
  • (Personal Chat) Added GetUserPersonalChatMessages request returning List<ChatContentMessage<*>>
  • (Drafts) SendMessageDraft now allows empty text via the new draftMessageTextLength (0..textLength.last) range and logs a warning instead of throwing when the text length is out of range
• API:
  • (Guest Mode) Added answerGuestQuery extensions in dev.inmo.tgbotapi.extensions.api.answers
  • (Guest Mode) Added RepliesWithGuestQueryId.kt reply extensions accepting GuestQueryId
  • (Guest Mode) Updated reply/send extensions (Replies, RepliesWithChatsAndMessages, Sends, ResendMessage, SendChecklist, SendContact, SendDice, SendLiveLocation, SendStaticLocation, SendVenue, SendMessage, media Send*, SendGame, SendInvoice, SendQuizPoll, SendRegularPoll) to return ChatContentMessage<*> and align with the new hierarchy
  • (Live Photos) Added sendLivePhoto extensions (ChatIdentifier/Chat × InputFile/LivePhotoFile × text/textSources)
  • (Chat Management) Added optional retrieveOtherBots parameter to getChatAdministrators extensions
  • (Chat Management) Added deleteUserMessageReaction and deleteActorChatMessageReaction extensions
  • (Chat Management) Added deleteAllUserMessageReactions and deleteAllActorChatMessageReactions extensions
  • (Chat Management) Added @Warning-marked catch-all deleteMessageReaction and deleteAllMessageReactions extensions
  • (Polls) Added media, membersOnly, countryCodes parameters to sendRegularPoll extension
  • (Polls) Added media, explanationMedia, membersOnly, countryCodes parameters to sendQuizPoll extension
  • (Managed Bots Access) Added getManagedBotAccessSettings extension in dev.inmo.tgbotapi.extensions.api.managed_bots
  • (Managed Bots Access) Added setManagedBotAccessSettings extension with userId and optional addedUserIds
  • (Personal Chat) Added getUserPersonalChatMessages extension returning List<ContentMessage<*>>
• Behaviour Builder:
  • (Guest Mode) Added GuestMessageTriggers with onGuestRequestMessage trigger
  • (Guest Mode) Updated WaitContent, WaitContentMessage, WaitEditedContentMessage, WaitMediaGroup, WaitMediaGroupMessages, WaitCommandsMessages, WaitDeepLinks, WaitMention, WaitMentionMessage, ContentTriggers, EditedContentTriggers, MediaGroupMessagesTriggers, MediaGroupTriggers, MentionTriggers, DeepLinkHandling, MessageFilterExcludingMediaGroups for the unified ChatContentMessage hierarchy
  • (Live Photos) Added onLivePhoto, onEditedLivePhoto, onLivePhotoGalleryMessages, onLivePhotoGallery triggers
  • (Live Photos) Added onMentionWithLivePhotoContent/onTextMentionWithLivePhotoContent triggers
  • (Live Photos) Added waitLivePhoto, waitLivePhotoMessage, waitEditedLivePhoto, waitEditedLivePhotoMessage, waitLivePhotoGallery, waitLivePhotoGalleryMessages expectations
  • (Live Photos) Added onlyLivePhotoContentMessages utility
• Utils:
  • (Guest Mode) Added guestMessageUpdateOrNull and related casts in ClassCastsNew
  • (Guest Mode) Updated MediaGroupContentMessageCreator and FlowsUpdatesFilter to support guest messages

v33.2.0

• Core:
  • Add ApiException as variant of BotException
  • Add classcasts for bots exceptions

v33.1.0

• Versions:
  • Kotlin: 2.3.10 -> 2.3.20
  • Serialization: 1.10.0 -> 1.11.0
  • Ktor: 3.4.1 -> 3.4.2
  • MicroUtils: 0.29.1 -> 0.29.2
  • KSLog: 1.6.0 -> 1.6.1

v33.0.0

THIS UPDATE CONTAINS ADDING SUPPORT OF Telegram Bots API 9.6

THIS UPDATE CONTAINS BREAKING CHANGES

• Core:
  • THIS IS BREAKING CHANGE MultipleAnswersPoll removed; RegularPoll now directly implements Poll
  • THIS IS BREAKING CHANGE allowMultipleAnswers renamed to allowsMultipleAnswers across poll types and requests
  • THIS IS BREAKING CHANGE QuizPoll.correctOptionId: Int? changed to correctOptionIds: List<Int>?
  • THIS IS BREAKING CHANGE PollOption is now a sealed interface with PollOption.Simple and PollOption.LatelyAdded subtypes; SimplePollOption removed
  • THIS IS BREAKING CHANGE PollAnswer.Anonymous.voterChat type changed from ChannelChat to PreviewPublicChat
  • THIS IS BREAKING CHANGE requestChannelReplyButton (group variant) renamed to requestGroupReplyButton
  • Added BotToken value class
  • Added SavePreparedKeyboardButton request with PreparedKeyboardButton and PreparedKeyboardButtonId types
  • Added GetManagedBotToken and ReplaceManagedBotToken requests
  • Added KeyboardButtonRequestManagedBot and RequestManagedBotKeyboardButton
  • Added ManagedBotCreated chat event and ManagedBotUpdated type with ManagedBotUpdate
  • Added PollOptionPersistentId value class
  • Added PollOptionAdded and PollOptionDeleted chat events
  • Added pollOptionId support in ReplyParameters (reply_to_poll_option_id)
  • Added canManageBots to ExtendedBot
  • Added allowsRevoting, shuffleOptions, allowAddingOptions, hideResultsUntilCloses, description/descriptionTextSources to poll types and send requests
  • Added chosenPersistentIds to PollAnswer
  • Added UsernameAtLessSerializer
  • Extended openPeriodPollSecondsLimit from 5..600 to 5..2628000
  • Fixed quiz poll serialization type (was incorrectly using regularPollType in quiz branch)
  • Fixed quiz poll explanation serialization (now correctly uses explanation/explanationTextSources)
  • Fixed SendQuizPoll correct option index range validation (off-by-one)
  • Several poll validation checks changed from throwing exceptions to logging warnings
• API:
  • Added savePreparedKeyboardButton extensions
  • Added getManagedBotToken and replaceManagedBotToken extensions
  • Added optional pollOptionId parameter to reply/replyWith* extensions
  • Updated sendQuizPoll extensions with correctOptionIds, allowsMultipleAnswers, allowsRevoting, shuffleOptions, hideResultsUntilCloses, description parameters
  • Updated sendRegularPoll extensions with allowsRevoting, shuffleOptions, allowAddingOptions, hideResultsUntilCloses, description parameters
• BehaviourBuilder:
  • Added onManagedBotCreated and onManagedBotUpdated triggers
  • Added onPollOptionAdded and onPollOptionDeleted triggers
  • Added waitManagedBotCreatedEvents and waitManagedBotUpdated expectations
  • Added waitPollOptionAddedEvents and waitPollOptionDeletedEvents expectations
  • Added ManagedBotUpdatedFilterByUser and ByUserManagedBotUpdatedMarkerFactory
• Utils:
  • Added managedBotCreationLink formatting extensions
  • Added requestManagedBotButton to ReplyKeyboardBuilder
  • Added class casts for ManagedBotUpdate, ManagedBotCreated, PollOptionAdded, PollOptionDeleted
  • Removed MultipleAnswersPoll class casts
  • Updated raw poll accessors to match new model (allowsMultipleAnswers, correctOptionIds, explanation)
  • Regenerated class casts extensions
• WebApps:
  • Added requestChat support for PreparedKeyboardButtonId
  • Fixed iconCustomEmojiId passing in BottomButton

v32.0.0

THIS UPDATE CONTAINS BREAKING CHANGES

• Version:
  • Kotlin: 2.2.21 -> 2.3.10
  • Kotlin Serialization: 1.9.0 -> 1.10.0
  • Ktor: 3.3.2 -> 3.4.1
  • KSP: 2.3.2 -> 2.3.6
  • MicroUtils: 0.26.9 -> 0.29.1
  • KSLog: 1.5.2 -> 1.6.0
• Core + API:
  • BREAKING CHANGES: ALL METHODS THAT PREVIOUSLY RETURNED BOOLEAN NOW RETURNS UNIT
• Core:
  • BREAKING CHANGE SetChatTitle init do not throw error in case when title.length is outside of chatTitleLength
  • BREAKING CHANGE SetStickerEmojiList init do not throw error in case when emojis.size is outside of emojisInStickerLimit
  • BREAKING CHANGE DeleteMessages init do not throw error in case when title is messageIds.size of deleteMessagesLimit
  • BREAKING CHANGE ForwardMessages init do not throw error in case when messageIds.size is outside of forwardMessagesLimit
  • BREAKING CHANGE CopyMessages init do not throw error in case when messageIds.size is outside of copyMessagesLimit
  • BREAKING CHANGE SwitchInlineQueryChosenChat init do not throw error in case when messageIds.size is outside of copyMessagesLimit
  • BREAKING CHANGE SetStickerKeywords init do not throw error in case when there are errors in keywords

v31.2.0

• Core:
  • Potentially fix #​1027 - drop http request exceptions on getting updates
• Core + API:
  • Add supportsStreaming in places it haven't been supported (fix of #​1026)
    • PARTIALLY BREAKING CHANGE supportStreaming has been renamed to supportsStreaming

v31.1.0

THIS UPDATE CONTAINS ADDING SUPPORT OF Telegram Bots API 9.5

• Core:
  • Added UserTag value class and senderTag field to messages
  • Added SetChatMemberTag request and UserTag support in PromoteChatMember and ChatPermissions
  • Added DateTimeTextSource for tg://time links support
  • Added DateTimeFormatPart and TgDateTimeFormatBuilder for building date-time format strings
  • Added UnitFromBooleanSerializer
• API:
  • Added setChatMemberTag extensions
• Utils:
  • Added dateTime and dateTimeln extensions to EntitiesBuilder
  • Added dateTimeMarkdown, dateTimeMarkdownV2, and dateTimeHTML string formatting extensions
  • Regenerated class casts extensions
• WebApps:
  • Added iconCustomEmojiId support to BottomButton and BottomButtonParams

v30.0.2

• Version:
  • Kotlin: 2.2.20 -> 2.2.21
  • Ktor: 3.3.1 -> 3.3.2
  • KSP: 2.2.20-2.0.4 -> 2.3.2
  • MicroUtils: 0.26.6 -> 0.26.8
  • KSLog: 1.5.1 -> 1.5.2
• Core:
  • Allow to use SetWebhook with maxAllowedConnections up to 100000 (fix of #​1019)
• KSP:
  • Fixed annotation property access for KSP2 compatibility using withNoSuchElementWorkaround
  • Removed ksp.useKSP2=false workaround from gradle.properties (KSP2 is now properly supported)
• Utils:
  • Regenerated class casts extensions
  • Allow to use custom GetUpdates in longPollingFlow

v30.0.1

• Core:
  • Potential fix of #​989 by:
    • In long polling have been added check for causing by unresolved address exception
    • Add TelegramBotPipelinesHandler.onRequestExceptionInLimiter which will be triggered in ANY exception during
      request execution

v30.0.0

THIS UPDATE MAY CONTAINS BREAKING CHANGES

• Version:
  • Kotlin: 2.2.10 -> 2.2.20
  • Ktor: 3.2.3 -> 3.3.1
  • MicroUtils: 0.26.3 -> 0.26.6
  • KSLog: 1.5.0 -> 1.5.1
• BehaviourBuilder:
  • DefaultCustomBehaviourContextAndTypeReceiver now extends suspend (BC, U) -> R instead of CustomBehaviourContextAndTypeReceiver<BC, R, U> (no changes in api in fact)

v29.0.1

• Core:
  • Fix of #​917: all OrderInfo fields now have defaults nulls

v29.0.0

THIS UPDATE CONTAINS ADDING SUPPORT OF Telegram Bots API 9.2

THIS UPDATE CONTAINS BREAKING CHANGES

• Core:
  • Add function firstOfOrNull(vararg suspend () -> T): T?
  • Change logic of firstOf - now it works based on merged flows and do not require CoroutineScope as receiver

v28.0.3

• Core:
  • Add passing of default engines in HttpClient constructors

v28.0.2

• Core:
  • #​1001 - [Bug] Invalid detection of isCausedByCancellation()
  • #​1002 - Unable to handle UnauthorizedException with buildBehaviourWithLongPolling

v28.0.1

• Version:
  • Kotlin: 2.2.0 -> 2.2.10
  • MicroUtils: 0.26.2 -> 0.26.3
  • Ktor: 3.2.2 -> 3.2.3
• Core:
  • Let all OptionallyMessageThreadRequest inheritors to use @EncodeDefault annotation to fix default value passing

v28.0.0

THIS UPDATE CONTAINS BREAKING CHANGES

• Core:
  • Add firstOf extension
• BehaviourBuilder:
  • All builders for behaviours got boolean useDefaultSubcontextInitialAction
  • Add opportunity to pass BehaviourContextData in DefaultBehaviourContext constructor and copy method
  • By default, commands to other bots will be ignored in triggers and waiters

v27.1.2

• Core:
  • Try to fix cancelling on timeout for long polling
  • Since this update phrase Something web wrong will not happen from this library 😭

v27.1.1

• Version:
  • MicroUtils: 0.26.1 -> 0.26.2
• Core:
  • Make BusinessLocation#location optional (fix of #​990)

v27.1.0

• Core:
  • Improve support of local bot api servers files. Next call factories will try to resolve file locally before real call:
    • DownloadFileRequestCallFactory.kt (for DownloadFile.kt as well)
    • DownloadFileChannelRequestCallFactory.kt (for DownloadFileStream.kt as well)

v27.0.0

THIS UPDATE MAY CONTAIN BREAKING CHANGES. IN CASE OF ANY MIGRATION PROBLEMS FEEL FREE TO ASK IN OUR CHAT

• Version:
  • Kotlin: 2.1.20 -> 2.2.0
  • Serialization: 1.8.1 -> 1.9.0
  • Ktor: 3.1.3 -> 3.2.2
  • MicroUtils: 0.25.7 -> 0.26.1
  • KSLog: 1.4.1 -> 1.5.0
• Common:
  • In most data classes with non-public constructors has been added ConsistentCopyVisibility annotation, preventing
    public nature in difference with constructor
  • Absence of several API methods for requests has been fixed

v26.1.0

THIS UPDATE CONTAINS ADDING SUPPORT OF Telegram Bots API 9.1

THIS UPDATE MAY CONTAINS BREAKING CHANGES

v26.0.0

THIS UPDATE CONTAINS BREAKING CHANGES IN BEHAVIOUR BUILDER AND CORE. BE CAREFUL ON UPDATE

• Version:
  • Serialization: 1.8.0 -> 1.8.1
  • Coroutines: 1.10.1 -> 1.10.2
  • Ktor: 3.1.1 -> 3.1.3
  • MicroUtils: 0.25.3 -> 0.25.7
• Core:
  • POTENTIALLY BREAKING CHANGE Long polling has been reworked a bit
  • BREAKING CHANGE RequestsExecutor got property RequestsExecutor.Log: KSLog
• BehaviourContext:
  • BREAKING CHANGE All triggers and waiters become non-suspend functions
  • BREAKING CHANGE Behaviour of counted extensions (commands, data callback queries, etc.) has been changed a bit: now each one will
    create subcontext and work in it
  • New extension BehaviourContext.launchInNewSubContext which will launch some job in subcontext of receiver

v25.0.1

THIS UPDATE CONTAINS ADDING SUPPORT OF Telegram Bots API 9.0

• Core:
  • Previously named Gift now presented by Gift.Regular
  • Fixes in MultipartRequestCallFactory for correct handling of all MultipartRequest.Common inheritors
  • Username now can be safely created with Username.prepare
  • Add extensions String.splitFor(Text|Caption|StoryCaption) for preparing several texts for several
    messages/captions/story captions

v25.0.0: 25.0.0

THIS UPDATE CONTAINS ADDING SUPPORT OF Telegram Bots API 9.0

• Core:
  • Previously named Gift now presented by Gift.Regular
  • Fixes in MultipartRequestCallFactory for correct handling of all MultipartRequest.Common inheritors
  • Username now can be safely created with Username.prepare
  • Add extensions String.splitFor(Text|Caption|StoryCaption) for preparing several texts for several
    messages/captions/story captions

v24.0.2

• Version:
  • Kotlin: 2.1.10 -> 2.1.20
  • Ktor: 3.1.0 -> 3.1.1
  • MicroUtils: 0.24.7 -> 0.25.3
• DefaultKTgBotAPIKSLog will drop CancellationExceptions by default
• You may configure DefaultKTgBotAPIKSLog in simple way with SetDefaultKTgBotAPIKSLog
• BehaviourBuilder:
  • FSM:
    • Fix chains cancelling on their ends

v24.0.1

• Core:
  • Now you may upload photos with EditChatMessageMedia

v24.0.0

THIS UPDATE CONTAINS BREAKING CHANGES IN subcontextUpdatesFilter WORK. TAKE CARE IN MIGRATION

• Version:
  • MicroUtils: 0.24.6 -> 0.24.7
• Core:
  • ForumContentMessage got property threadCreatingInfo which represents information about topic where message has been sent
• BehaviourBuilder:
  • Fix of overall subcontextUpdatesFilter behaviour. In fact, this update will fix its affection on scenaries

v23.2.0

THIS UPDATE CONTAINS ADDING SUPPORT OF Telegram Bots API 8.3

• Version:
  • MicroUtils: 0.24.5 -> 0.24.6
  • Ktor: 3.0.3 -> 3.1.0

v23.1.2

• Version:
  • Kotlin: 2.1.0 -> 2.1.10
  • Serialization: 1.7.3 -> 1.8.0
  • MicroUtils: 0.24.4 -> 0.24.5
  • KSLog: 1.4.0 -> 1.4.1

v23.1.1

• Version:
  • MicroUtils: 0.24.0 -> 0.24.4
• Core:
  • Replace removeFirst with removeAt(0) in createTextSources

v23.1.0

THIS UPDATE CONTAINS ADDING SUPPORT OF Telegram Bots API 8.2

v23.0.0

• Version:
  • Coroutines: 1.9.0 -> 1.10.1
  • MicroUtils: 0.23.2 -> 0.24.0
  • KSLog: 1.3.6 -> 1.4.0
  • Ktor: 3.0.2 -> 3.0.3
• Core:
  • All old factory methods for TextSources took suffix TextSource. For example: regular -> regularTextSource.
    That has been for excluding names resolution ambiguity with extensions for EntitiesBuilder

v22.0.0

THIS UPDATE CONTAINS BREAKING CHANGES

IN THIS UPDATE HAS BEEN REWORKED EVENTS API IN WEBAPPS

THIS UPDATE ADDING SUPPORT OF BOT API 8.0 AND BOT API 8.1

• Version:
  • MicroUtils: 0.23.1 -> 0.23.2
  • Ktor: 3.0.1 -> 3.0.2

v21.0.1

• Core:
  • Improvements in Update.sourceUser extension
  • Add extension PrivateChat.toUser
  • Builder methods of TextSources (like pre which returns PreTextSource) lost suppression of redundant inline
    due to its redundancy
  • Add mention builders for EntitiesBuilder with UserId as variant instead of User
• BehaviourBuilder:
  • Add support of several rounds for CombinedSubcontextInitialAction. Now it will try hard to execute all its
    SubAction while all actions will not be completed successfully OR all left actions will not complete with errors

v21.0.0

• Version:
  • Kotlin: 2.0.21 -> 2.1.0
  • MicroUtils: 0.23.0 -> 0.23.1
• BehaviourBuilder:
  • Add special val data: BehaviourContextData into all realizations of BehaviourContext
  • Add CombinedSubcontextInitialAction and functions
    buildSubcontextInitialAction/buildSubcontextInitialActionWithSubActions
  • Add subcontextInitialAction for all the functions-builders of BehaviourContext and
    additionalSubcontextInitialAction to all triggers

v20.0.1

• Core:
  • Fix of logger propagation (fix of #​860)
  • Add opportunity to modify keyboards (fix of #​761)
  • Fields of OrderInfo became nullable (fix of #​917)
  • Add default toString to ChatType (fix of #​919)
  • Fix of method in CreateInvoiceLink (merging of #​920, made by byteduck-exploit)

v20.0.0

THIS UPDATE CONTAINS SUPPORT OF BOTS API 7.11

• All:
  • ALL SEND METHODS GOT PARAMETER allowPaidBroadcast WHICH POTENTIALLY MAY SPEND MONEYS FROM BOT BALANCE

v19.0.0

THIS UPDATE CONTAINS BREAKING CHANGES

THIS UPDATE CONTAINS UPGRADE UP TO KTOR 3.0 (thanks to @​d1snin)

• Version:
  • Ktor: 2.3.12 -> 3.0.1
  • MicroUtils: 0.22.7 -> 0.23.0

v18.2.3

• Core:
  • Add default middleware ExceptionsThrottlerTelegramBotMiddleware
  • Make TelegramBotMiddlewaresPipelinesHandler to be default TelegramBotPipelinesHandler
  • Make DefaultKtorRequestsExecutor now uses runCatching instead of runCatchingSafely
  • onRequestResultPresented lambda now accepts non-nullable result

v18.2.2

• Version:
  • Kotlin: 2.0.20 -> 2.0.21
  • MicroUtils: 0.22.4 -> 0.22.7
• Core:
  • Fixes in blockquotes serializations
  • Now RawMessageEntity is public. It is still under Warning annotation and is subject of changes
• BehaviourBuilder:
  • Add CommonMessageFilterExcludeCommand to filter commands in messages
  • Add minus operation for SimpleFilters

v18.2.1

• Version:
  • Serialization: 1.7.2 -> 1.7.3
  • Coroutines: 1.8.1 -> 1.9.0
  • MicroUtils: 0.22.2 -> 0.22.4

v18.2.0

THIS UPDATE CONTAINS SUPPORT OF BOTS API 7.10

• Core:
  • Customize GiveawayCreated to use stars in some cases
  • GiveawayInfo lost parameter premiumMonths because of it is no included by default
  • GiveawayPublicResults lost parameter publicWinners because of its abcence in Telegram Bot API
  • Fix GiveawayPublicResults to be correctly deserializable
  • Fix GiveawayPrivateResults to be correctly deserializable
  • Fixes in deserialization of updates with giveaways
• BehaviourBuilder:
  • Extension buildBehaviourWithLongPolling will not report absence of /privacy handling
• WebApp:
  • MainButton has been deprecated in favor to BottomButton. Their functionality is equal

v18.1.0

• BehaviourBuilder:
  • Add createSubContextAndDoSynchronouslyWithUpdatesFilter as old logic of createSubContextAndDoWithUpdatesFilter
  • createSubContextAndDoWithUpdatesFilter has been renamed to createSubContextAndDoAsynchronouslyWithUpdatesFilter

v18.0.0

THIS UPDATE CONTAINS BREAKING CHANGES

This update contains solution for issue #​888, made by
@​Nik-mmzd

---

Migration (step-by-step)

Replace in a whole project:

1. RestrictedChatMember -> RestrictedMemberChatMember
2. BannedChatMember -> RestrictedChatMember

---

Changes:

• Version:
  • Kotlin: 2.0.10 -> 2.0.20
  • Serialization: 1.7.1 -> 1.7.2
  • MicroUtils: 0.22.0 -> 0.22.2
  • KSLog: 1.3.5 -> 1.3.6
  • Ktor: 2.3.11 -> 2.3.12
• Core:
  • RestrictedChatMember has been renamed to RestrictedMemberChatMember
  • BannedChatMember has been renamed to RestrictedChatMember
  • KickedChatMember now implements RestrictedChatMember (due to rename)
  • All ChatMembers now use PreviewUsers instead of Users
• Utils:
  • Add a lot of extensions like ChatMember.isMember
  • Add a lot of extensions like ChatMemberUpdated.joinedChat

v17.0.0

THIS UPDATE CONTAINS SUPPORT OF BOTS API 7.9

• Add support of subscriptions links handling
• Add support of info about sender chat. It is important, that for channels will be actual senderChat instead of
  from field due to User type of the last one. You also may use extensions Message.sender_chat or Any.withSenderChatMessageOrNull
  to access sender chat
• Add Reaction.Paid

Additional changes:

• Core:
  • Add top level interfaces OptionallyWithUser and OptionallyFromUser. Old WithUser and FromUser interfaces
    extending them with following overrides of user and from fields
• API:
  • Change order of delay and sending action in SendActionDSL
    (thanks to DRSchlaubi, PR #​833).
    Besides, there has been changed way to create parallel sending of action and it must not lead to memory leaks anymore

v16.0.0

THIS UPDATE CONTAINS KOTLIN UPDATE UP TO 2.0

• Version:
  • Kotlin: 1.9.23 -> 2.0.10
  • Serialization: 1.6.3 -> 1.7.1
  • MicroUtils: 0.21.2 -> 0.22.0
  • KSLog: 1.3.4 -> 1.3.5

v15.3.0

THIS UPDATE CONTAINS ADDING OF SUPPORT FOR BOTS API 7.8

• Core:
  • OptionallyBusinessConnectionRequest now extends WithOptionalBusinessConnectionId
  • Add hasMainWebApp in ExtendedBot
• API:
  • Add BusinessConnectionId to pin/unpin methods
• WebApp:
  • Add shareToStory in WebApp

v15.2.0

• API:
  • Enabled an explicit mode for API module (PR #​876)
• WebApps:
  • Built-in onClick and offClick of MainButton become public (PR #​875)
  • Old MainButton.onClick extension has been removed to avoid collisions of types

v15.1.0

THIS UPDATE CONTAINS BREAKING CHANGES

THIS UPDATE CONTAINS ADDING OF SUPPORT FOR BOTS API 7.7 (thanks to bpavuk)

THIS UPDATE CONTAINS ADDING OF SUPPORT FOR BOTS API 7.6 (with participation and help of bpavuk)

• Add support of paid media
• Update web apps
• Version:
  • MicroUtils: 0.21.1 -> 0.21.2
• Core:
  • TelegramMedia has been separated onto two interfaces: TelegramFreeMedia and TelegramPaidMedia
    • TelegramFreeMedia has replaced TelegramMedia on all old places where it have been used
  • Photo has been renamed to PhotoFile
• BehaviourBuilder:
  • Add notification when handling of /privacy command is absence
  • Add several extensions to simplify setting up /privacy reaction

v15.0.0

THIS UPDATE CONTAINS BREAKING CHANGES

THIS UPDATE CONTAINS ADDING OF SUPPORT FOR BOTS API 7.5

• Version:
  • MicroUtils: 0.21.0 -> 0.21.1
• A lot of edit methods and classes has been changed to support business connection id

v14.1.0

• Version:
  • Coroutines: 1.8.0 -> 1.8.1
  • Ktor: 2.3.10 -> 2.3.11
  • MicroUtils: 0.20.45 -> 0.21.0
  • KSLog: 1.3.3 -> 1.3.4
• BehaviourBuilder:
  • BehaviourContext updates listening job will be weakly subscribed. It means that BehaviourContext scope will
    not be prevented from cancelling by this job anymore
  • BehaviourContext.doInContext will not stop automatically current BehaviourContext job anymore
  • BehaviourContext.createSubContextAndDoWithUpdatesFilter will use supervisorScope instead of
    LinkedSupervisorScope. That will prevent scope leaking in runtime

v14.0.1

• In core and api modules related to invoices changed their APIs to suite current API

v14.0.0

Add support of Telegram Bots API 7.4

THIS UPDATE CONTAINS BREAKING CHANGES

• Core:
  • TelegramPaymentChargeId has been added as value class and replaced raw strings in SuccessfulPayment type of telegramPaymentChargeId
• All the methods/classes related to sending of messages got effectId parameter
• All the methods/classes related to sending of photos/animations/videos got showCaptionAboveMedia parameter

v13.0.0

Add support of Telegram Bots API 7.3

THIS UPDATE CONTAINS BREAKING CHANGES

• Core:
  • For polls, textSources now means question text sources. For QuizPoll there are explanation and explanationTextSources
    for hinting
• API:
  • A lot of API related to Polls has been changed to include opportunity to pass ParseMode and TextSources list

v12.0.1

• Version:
  • Ktor: 2.3.9 -> 2.3.10
  • MicroUtils: 0.20.39 -> 0.20.45
  • UUID: 0.8.2 -> 0.8.4

v12.0.0

Add support of Telegram Bots API 7.2

THIS UPDATE CONTAINS A LOT OF BREAKING CHANGES

v11.0.0

THIS UPDATE CONTAINS REMOVES OF DEPRECATED THINGS

THIS UPDATE CONTAINS A LOT OF BREAKING CHANGES

• Core:
  • MessageId now is value class. MessageIdentifier become deprecated
  • MessageThreadId now is value class
  • InlineQueryIdentifier now is value class
  • MediaGroupIdentifier has been renamed to MediaGroupId and now is value class
  • CallbackQueryIdentifier has been renamed to CallbackQueryId and now is value class
  • WebAppQueryId now is value class
  • PreCheckoutQueryId now is value class
  • FileUniqueId has been renamed to TgFileUniqueId and now is value class
  • UpdateIdentifier has been renamed to UpdateId and now is value class
  • InlineMessageIdentifier has been renamed to InlineMessageId and now is value class
  • ShippingQueryIdentifier has been renamed to ShippingQueryId and now is value class
  • Identifier has been renamed to RawChatId and now is value class
  • ShippingOptionIdentifier has been renamed to ShippingOptionId and now is value class
  • PollIdentifier has been renamed to PollId and now is value class
  • StickerSetName now is value class

v10.1.1

• Version:
  • Serialization: 1.6.2 -> 1.6.3
  • MicroUtils: 0.20.34 -> 0.20.37
  • Korlibs: 5.3.1 -> 5.3.2

v10.1.0

Add support of Telegram Bots API 7.1

• Version:
  • Coroutines: 1.7.3 -> 1.8.0
  • MicroUtils: 0.20.32 -> 0.20.34

v10.0.1

• Version:
  • Ktor: 2.3.7 -> 2.3.8
  • MicroUtils: 0.20.26 -> 0.20.32
  • Korlibs: 5.3.0 -> 5.3.1
  • KSLog: 1.3.1 -> 1.3.2

v10.0.0

Add support of Telegram Bots API 7.0

IN THIS UPDATE KLOCK DEPENDENCY CHANGED TO com.soywiz.korge:korlibs-time UP TO 5.3.0 VERSION

IN THIS UPDATE KRYPTO DEPENDENCY CHANGED TO com.soywiz.korge:korlibs-crypto UP TO 5.3.0 VERSION

• Version:
  • MicroUtils: 0.20.23 -> 0.20.26
  • Korlibs: 4.0.10 -> 5.3.0
• Core:
  • Message now inherited by two variants: AccessibleMessage and InaccessibleMessage
• Common:
  • In most places disableWebPagePreview has been replaced by new LinkPreviewOptions
  • In most places arguments replyToMessageId and allowSendingWithoutReply has been replaced with
    ReplyParameters
    • In reply extension two parameters have been added: replyInChatId and replyInThreadId

v9.4.3

IetfLanguageCode has been renamed to IetfLang in MicroUtils

• Version:
  • Kotlin: 1.9.21 -> 1.9.22
  • MicroUtils: 0.20.19 -> 0.20.23

v9.4.2

• Version:
  • Serialization: 1.6.1 -> 1.6.2
  • Ktor: 2.3.6 -> 2.3.7
  • MicroUtils: 0.20.15 -> 0.20.19
  • UUID: 0.8.1 -> 0.8.2

v9.4.1

• Replace warning about two bots from LongPolling to DefaultKtorRequestsExecutor

v9.4.0

• Version:
  • Kotlin: 1.9.20 -> 1.9.21
  • Serialization: 1.6.0 -> 1.6.1
  • Ktor: 2.3.5 -> 2.3.6
  • MicroUtils: 0.20.12 -> 0.20.15

v9.3.0

This release become possible thanks to Anton Lakotka

THIS RELEASE CONTAINS UPDATES UP TO RELEASE CANDIDATES VERSIONS

UPDATE MAY HAVE BREAKING CHANGES

SINCE THIS UPDATE IT WILL BE REQUIRED TO USE JDK 17+ FOR DEVELOPMENT

• Version:
  • Kotlin: 1.8.22 -> 1.9.20
  • Serialization: 1.5.1 -> 1.6.0
  • KorLibs: 4.0.3 -> 4.0.10
  • UUID: 0.7.1 -> 0.8.1
  • Ktor: 2.3.4 -> 2.3.5
  • MicroUtils: 0.19.9 -> 0.20.12

v9.2.4

• Utils:
  • New extensions *.parseCommandsWithNamedArgs
• BehaviourBuilder:
  • In expectaters and triggers of commands add *WithNamedArgs variants
  • In expectaters and triggers of commands add opportunity to use custom separator

v9.2.3

• Core:
  • Fix in VoiceContent#createResend

v9.2.2

• Core:
  • Fix of #​793: Add PreviewChat

v9.2.1

• Version:
  • Ktor: 2.3.3 -> 2.3.4
• Core:
  • All ChatMember inheritors have fixes status field

v9.2.0

Add support of Telegram Bots API 6.9

• Rename ChatAdministratorRightsImpl -> ChatCommonAdministratorRights
• All the request chat keyboards has changed their parameters ChatAdministratorRights to ChatCommonAdministratorRights

v9.1.2

• Core:
  • Fix of MessageContent serialization

v9.1.1

• Core:
  • Potential fix of incorrect parsing in RawMessageEntity

v9.1.0

This update contains adding of Telegram Bot API 6.8 support

• Version:
  • Coroutines: 1.7.2 -> 1.7.3
  • Ktor: 2.3.2 -> 2.3.3
  • MicroUtils: 0.19.7 -> 0.19.9

v9.0.0

THIS UPDATE CONTAINS ADDING SUPPORT OF Telegram Bots API 9.2

THIS UPDATE CONTAINS BREAKING CHANGES

• Core:
  • Add function firstOfOrNull(vararg suspend () -> T): T?
  • Change logic of firstOf - now it works based on merged flows and do not require CoroutineScope as receiver

v8.1.0

• BehaviourBuilder:
  • Add createSubContextAndDoSynchronouslyWithUpdatesFilter as old logic of createSubContextAndDoWithUpdatesFilter
  • createSubContextAndDoWithUpdatesFilter has been renamed to createSubContextAndDoAsynchronouslyWithUpdatesFilter

v8.0.1

• Version:
  • Kotlin: 2.2.0 -> 2.2.10
  • MicroUtils: 0.26.2 -> 0.26.3
  • Ktor: 3.2.2 -> 3.2.3
• Core:
  • Let all OptionallyMessageThreadRequest inheritors to use @EncodeDefault annotation to fix default value passing

v8.0.0

THIS UPDATE CONTAINS BREAKING CHANGES

• Core:
  • Add firstOf extension
• BehaviourBuilder:
  • All builders for behaviours got boolean useDefaultSubcontextInitialAction
  • Add opportunity to pass BehaviourContextData in DefaultBehaviourContext constructor and copy method
  • By default, commands to other bots will be ignored in triggers and waiters

v7.1.3

• Versions:
  • Serialization: 1.5.0 -> 1.5.1
  • MicroUtils: 0.18.1 -> 0.18.4
• Core:
  • Actualize kdocs in InputFile
• BehaviourBuilder:
  • Now it is possible to use waitMediaContent/waitMediaContentMessage/onMediaContent
  • Add onMention/waitMention functionality
  • Add opportunity to map content with extensions to Flow

v7.1.2

• Core:
  • Try to fix cancelling on timeout for long polling
  • Since this update phrase Something web wrong will not happen from this library 😭

v7.1.1

• Version:
  • MicroUtils: 0.26.1 -> 0.26.2
• Core:
  • Make BusinessLocation#location optional (fix of #​990)

v7.1.0

• Core:
  • Improve support of local bot api servers files. Next call factories will try to resolve file locally before real call:
    • DownloadFileRequestCallFactory.kt (for DownloadFile.kt as well)
    • DownloadFileChannelRequestCallFactory.kt (for DownloadFileStream.kt as well)

v7.0.2

This update brings experimental support of linuxX64 and mingwX64 platforms

• Versions:
  • Kotlin: 1.8.10 -> 1.8.20
  • MicroUtils: 0.17.5 -> 0.17.8
  • Ktor: 2.2.4 -> 2.3.0
• Core:
  • New RequestsExecutor - MultipleClientKtorRequestsExecutor
  • Old KtorRequestsExecutor has been renamed to DefaultKtorRequestsExecutor
  • KtorRequestsExecutor now is expect class
    • On JS, JVM and MinGWX64 platforms it is DefaultKtorRequestsExecutor
    • On LinuxX64 platform it is MultipleClientKtorRequestsExecutor

v7.0.1

• Core:
  • New interface WithChat which contains chat field
    • Message now inherits WithChat
    • ChatMemberUpdated now inherits WithChat
• Utils:
  • Improvements in same-notations

v7.0.0

THIS UPDATE MAY CONTAIN BREAKING CHANGES. IN CASE OF ANY MIGRATION PROBLEMS FEEL FREE TO ASK IN OUR CHAT

• Version:
  • Kotlin: 2.1.20 -> 2.2.0
  • Serialization: 1.8.1 -> 1.9.0
  • Ktor: 3.1.3 -> 3.2.2
  • MicroUtils: 0.25.7 -> 0.26.1
  • KSLog: 1.4.1 -> 1.5.0
• Common:
  • In most data classes with non-public constructors has been added ConsistentCopyVisibility annotation, preventing
    public nature in difference with constructor
  • Absence of several API methods for requests has been fixed

v6.1.0

THIS UPDATE CONTAINS ADDING SUPPORT OF Telegram Bots API 9.1

THIS UPDATE MAY CONTAINS BREAKING CHANGES

v6.0.3

• Versions:
  • MicroUtils: 0.17.1 -> 0.17.2
• Core:
  • User in CallbackQuery now is CommonUser as well as in from
  • User in InlineQuery now is CommonUser as well as in from
• BehaviourBuilder:
  • Fixes in DeepLink triggers and waiters

v6.0.2

• Core:
  • Long polling now uses media groups debounce as in webhooks

v6.0.1

• Versions:
  • Ktor: 2.2.3 -> 2.2.4
  • MicroUtils: 0.17.0 -> 0.17.1

v6.0.0

THIS UPDATE CONTAINS BREAKING CHANGES IN BEHAVIOUR BUILDER AND CORE. BE CAREFUL ON UPDATE

• Version:
  • Serialization: 1.8.0 -> 1.8.1
  • Coroutines: 1.10.1 -> 1.10.2
  • Ktor: 3.1.1 -> 3.1.3
  • MicroUtils: 0.25.3 -> 0.25.7
• Core:
  • POTENTIALLY BREAKING CHANGE Long polling has been reworked a bit
  • BREAKING CHANGE RequestsExecutor got property RequestsExecutor.Log: KSLog
• BehaviourContext:
  • BREAKING CHANGE All triggers and waiters become non-suspend functions
  • BREAKING CHANGE Behaviour of counted extensions (commands, data callback queries, etc.) has been changed a bit: now each one will
    create subcontext and work in it
  • New extension BehaviourContext.launchInNewSubContext which will launch some job in subcontext of receiver

v5.2.1

• Core:
  • All the CallbackQueryes now will receive CommonUser instead of User due inability of bots to trigger any
    inline interaction with others bots
• API:
  • Now sentMessageFlow will take each sent message in handleLiveLocation

v5.2.0

• API:
  • Enabled an explicit mode for API module (PR #​876)
• WebApps:
  • Built-in onClick and offClick of MainButton become public (PR #​875)
  • Old MainButton.onClick extension has been removed to avoid collisions of types

v5.1.1

• Core:
  • Add opportunity to get user link with makeUserLink
• BehaviourBuilder:
  • Fixes in content waiting expectators

v5.1.0

THIS UPDATE CONTAINS BREAKING CHANGES

THIS UPDATE CONTAINS ADDING OF SUPPORT FOR BOTS API 7.7 (thanks to bpavuk)

**THIS UPDATE CONTAINS ADDING OF SUPPORT FOR BOTS API 7

✂ Note

PR body was truncated to here.

---

Configuration

📅 Schedule: (UTC)

• Branch creation
  • At any time (no schedule defined)
• Automerge
  • At any time (no schedule defined)

🚦 Automerge: Disabled by config. Please merge this manually once you are satisfied.

♻ Rebasing: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox.

🔕 Ignore: Close this PR and you won't be reminded about this update again.

---

• If you want to rebase/retry this PR, check this box

---

This PR was generated by Mend Renovate. View the repository job log.