Skip to content

34.0.0

Choose a tag to compare

View all tags
@InsanusMokrassar InsanusMokrassar released this 13 Jun 08:54
v34.0.0
fa73f34

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
Assets 2
Loading