telegram-bot-ruby 2.7.0 → 2.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 147ce110bf7814bf274a349a690e50c3c765d21465de7a705e828751f8467f23
-  data.tar.gz: beaf1f9e171e3da2e57ec678a39732a715938542401369ab879d3ee4f6c0c310
+  metadata.gz: 305b7281c7f2f3d51656d5556d9435d3b6267ae4f275fc9a04b430cb275eabb2
+  data.tar.gz: cc6af3a9f74e56a9eb70d4b32cceeaddffb5a4c20cb0e8577b2abdb3ba5ccfb0
 SHA512:
-  metadata.gz: c877eedeec06700c6691d569ba6ec01891274b661e6a3d40455c16492ef3486c26b3abe3c44de1857fb444c64aad651d792c6de1f2dda3c3299c77b11cd64955
-  data.tar.gz: cccdc34911f698b2069d6e0a6221d2e80cbecc5df947b19b7f204670bdfd59b6e6870dd52b5695a53f2baa916eca3b3719251db7c3812a8521f2512e2b1ee40b
+  metadata.gz: b72f319422e8943a43fb2128e0553a4bf8518c28ed01489724b2a277797cceb60122302d1127aa14f55938f6d063e10226dd3d72e1fade237975e2648925d7a3
+  data.tar.gz: 17365086472228247b0e51cfba2d5f3661df32264267c9a2643f7372c39d315255626360dc5cc59341619ded5cf1c6e7528a0e368049b9b8740f9973eb5c8ba0

data/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 2.8.0
+
+### Added
+
+- [Bot API 10.0](https://core.telegram.org/bots/api-changelog#may-8-2026) + [Bot API 10.1](https://core.telegram.org/bots/api-changelog#june-11-2026) + [Bot API 10.2](https://core.telegram.org/bots/api-changelog#july-14-2026) [#336](https://github.com/atipugin/telegram-bot-ruby/pull/336)
+
 ## 2.7.0
 
 ### Added

data/README.md

@@ -5,14 +5,13 @@ Ruby wrapper for [Telegram's Bot API](https://core.telegram.org/bots/api).
 [![Gem Version](https://badge.fury.io/rb/telegram-bot-ruby.svg)](http://badge.fury.io/rb/telegram-bot-ruby)
 [![Build Status](https://github.com/atipugin/telegram-bot-ruby/actions/workflows/ci.yml/badge.svg)](https://github.com/atipugin/telegram-bot-ruby/actions)
 [![Maintainability](https://api.codeclimate.com/v1/badges/7e61fbf5bec86e118fb1/maintainability)](https://codeclimate.com/github/atipugin/telegram-bot-ruby/maintainability)
-[![Say Thanks!](https://img.shields.io/badge/Say%20Thanks!-🦉-1EAEDB.svg)](https://saythanks.io/to/atipugin)
 
 ## Installation
 
 Add following line to your Gemfile:
 
 ```ruby
-gem 'telegram-bot-ruby', '~> 2.5'
+gem 'telegram-bot-ruby', '~> 2.7'
 ```
 
 And then execute:
@@ -200,11 +199,9 @@ bot.listen do |message|
 end
 ```
 
-Now, with `inline` mode enabled, your `message` object can be an instance of
-[Message](https://core.telegram.org/bots/api#message),
-[InlineQuery](https://core.telegram.org/bots/api#inlinequery) or
-[ChosenInlineResult](https://core.telegram.org/bots/api#choseninlineresult).
-That's why you need to check type of each message and decide how to handle it.
+Now, with `inline` mode enabled, your `message` object can be an instance of any
+[update type](https://core.telegram.org/bots/api#update) supported by the Bot API.
+That's why you need to check the type of each message and decide how to handle it.
 
 Using `answer_inline_query` you can send query results to user.
 `results` field must be an array of [query result objects](https://core.telegram.org/bots/api#inlinequeryresult).
@@ -225,7 +222,7 @@ bot.listen do |message|
   case message.text
   when '/photo'
     path_to_photo = File.expand_path('~/Desktop/jennifer.jpg')
-    bot.api.send_photo(chat_id: message.chat.id, photo: Faraday::UploadIO.new(path_to_photo, 'image/jpeg'))
+    bot.api.send_photo(chat_id: message.chat.id, photo: Faraday::Multipart::FilePart.new(path_to_photo, 'image/jpeg'))
   end
 end
 ```
@@ -247,7 +244,7 @@ end
 
 ## Connection adapters
 
-Since version `0.5.0` we rely on [faraday](https://github.com/lostisland/faraday) under the hood.
+We rely on [faraday](https://github.com/lostisland/faraday) under the hood.
 You can use any of supported adapters (for example, `net/http/persistent`):
 
 ```ruby

data/lib/telegram/bot/api/endpoints.rb

@@ -17,6 +17,7 @@ module Telegram
         'copyMessage' => Types::MessageId,
         'copyMessages' => Types::Array.of(Types::MessageId),
         'sendPhoto' => Types::Message,
+        'sendLivePhoto' => Types::Message,
         'sendAudio' => Types::Message,
         'sendDocument' => Types::Message,
         'sendVideo' => Types::Message,
@@ -55,6 +56,8 @@ module Telegram
         'revokeChatInviteLink' => Types::ChatInviteLink,
         'approveChatJoinRequest' => Types::Bool,
         'declineChatJoinRequest' => Types::Bool,
+        'answerChatJoinRequestQuery' => Types::Bool,
+        'sendChatJoinRequestWebApp' => Types::Bool,
         'setChatPhoto' => Types::Bool,
         'deleteChatPhoto' => Types::Bool,
         'setChatTitle' => Types::Bool,
@@ -65,8 +68,8 @@ module Telegram
         'leaveChat' => Types::Bool,
         'getChat' => Types::ChatFullInfo,
         'getChatAdministrators' => Types::Array.of(Types::ChatMember),
-        'getChatMemberCount' => Types::Integer,
         'getChatMember' => Types::ChatMember,
+        'getUserPersonalChatMessages' => Types::Array.of(Types::Message),
         'setChatStickerSet' => Types::Bool,
         'deleteChatStickerSet' => Types::Bool,
         'getForumTopicIconStickers' => Types::Array.of(Types::Sticker),
@@ -83,10 +86,13 @@ module Telegram
         'unhideGeneralForumTopic' => Types::Bool,
         'unpinAllGeneralForumTopicMessages' => Types::Bool,
         'answerCallbackQuery' => Types::Bool,
+        'answerGuestQuery' => Types::SentGuestMessage,
         'getUserChatBoosts' => Types::UserChatBoosts,
         'getBusinessConnection' => Types::BusinessConnection,
         'getManagedBotToken' => Types::String,
         'replaceManagedBotToken' => Types::String,
+        'getManagedBotAccessSettings' => Types::BotAccessSettings,
+        'setManagedBotAccessSettings' => Types::Bool,
         'setMyCommands' => Types::Bool,
         'deleteMyCommands' => Types::Bool,
         'getMyCommands' => Types::Array.of(Types::BotCommand),
@@ -140,10 +146,17 @@ module Telegram
         'editMessageChecklist' => Types::Message,
         'editMessageReplyMarkup' => Types::Message | Types::Bool,
         'stopPoll' => Types::Poll,
+        'editEphemeralMessageText' => Types::Bool,
+        'editEphemeralMessageMedia' => Types::Bool,
+        'editEphemeralMessageCaption' => Types::Bool,
+        'editEphemeralMessageReplyMarkup' => Types::Bool,
         'approveSuggestedPost' => Types::Bool,
         'declineSuggestedPost' => Types::Bool,
         'deleteMessage' => Types::Bool,
         'deleteMessages' => Types::Bool,
+        'deleteEphemeralMessage' => Types::Bool,
+        'deleteMessageReaction' => Types::Bool,
+        'deleteAllMessageReactions' => Types::Bool,
         'sendSticker' => Types::Message,
         'getStickerSet' => Types::StickerSet,
         'getCustomEmojiStickers' => Types::Array.of(Types::Sticker),
@@ -160,6 +173,8 @@ module Telegram
         'setStickerSetThumbnail' => Types::Bool,
         'setCustomEmojiStickerSetThumbnail' => Types::Bool,
         'deleteStickerSet' => Types::Bool,
+        'sendRichMessage' => Types::Message,
+        'sendRichMessageDraft' => Types::Bool,
         'answerInlineQuery' => Types::Bool,
         'sendInvoice' => Types::Message,
         'createInvoiceLink' => Types::String,

data/lib/telegram/bot/types/bot_access_settings.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module Telegram
+  module Bot
+    module Types
+      class BotAccessSettings < Base
+        attribute :is_access_restricted, Types::Bool
+        attribute? :added_users, Types::Array.of(User)
+      end
+    end
+  end
+end

data/lib/telegram/bot/types/bot_command.rb

@@ -6,6 +6,7 @@ module Telegram
       class BotCommand < Base
         attribute :command, Types::String.constrained(min_size: 1, max_size: 32)
         attribute :description, Types::String.constrained(min_size: 1, max_size: 256)
+        attribute? :is_ephemeral, Types::Bool
       end
     end
   end

data/lib/telegram/bot/types/bot_subscription_updated.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Telegram
+  module Bot
+    module Types
+      class BotSubscriptionUpdated < Base
+        attribute :user, User
+        attribute :invoice_payload, Types::String
+        attribute :state, Types::String
+      end
+    end
+  end
+end

data/lib/telegram/bot/types/chat_full_info.rb

@@ -55,6 +55,8 @@ module Telegram
         attribute? :first_profile_audio, Audio
         attribute? :unique_gift_colors, UniqueGiftColors
         attribute? :paid_message_star_count, Types::Integer
+        attribute? :guard_bot, User
+        attribute? :community, Community
       end
     end
   end

data/lib/telegram/bot/types/chat_join_request.rb

@@ -10,6 +10,7 @@ module Telegram
         attribute :date, Types::Integer
         attribute? :bio, Types::String
         attribute? :invite_link, ChatInviteLink
+        attribute? :query_id, Types::String
       end
     end
   end

data/lib/telegram/bot/types/chat_member_restricted.rb

@@ -18,6 +18,7 @@ module Telegram
         attribute :can_send_polls, Types::Bool
         attribute :can_send_other_messages, Types::Bool
         attribute :can_add_web_page_previews, Types::Bool
+        attribute :can_react_to_messages, Types::Bool
         attribute :can_edit_tag, Types::Bool
         attribute :can_change_info, Types::Bool
         attribute :can_invite_users, Types::Bool

data/lib/telegram/bot/types/chat_permissions.rb

@@ -14,6 +14,7 @@ module Telegram
         attribute? :can_send_polls, Types::Bool
         attribute? :can_send_other_messages, Types::Bool
         attribute? :can_add_web_page_previews, Types::Bool
+        attribute? :can_react_to_messages, Types::Bool
         attribute? :can_edit_tag, Types::Bool
         attribute? :can_change_info, Types::Bool
         attribute? :can_invite_users, Types::Bool

data/lib/telegram/bot/types/community.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module Telegram
+  module Bot
+    module Types
+      class Community < Base
+        attribute :id, Types::Integer
+        attribute :name, Types::String
+      end
+    end
+  end
+end

data/lib/telegram/bot/types/community_chat_added.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module Telegram
+  module Bot
+    module Types
+      class CommunityChatAdded < Base
+        attribute :community, Community
+      end
+    end
+  end
+end

data/lib/telegram/bot/types/community_chat_removed.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+module Telegram
+  module Bot
+    module Types
+      class CommunityChatRemoved < Base
+      end
+    end
+  end
+end

data/lib/telegram/bot/types/external_reply_info.rb

@@ -11,6 +11,7 @@ module Telegram
         attribute? :animation, Animation
         attribute? :audio, Audio
         attribute? :document, Document
+        attribute? :live_photo, LivePhoto
         attribute? :paid_media, PaidMediaInfo
         attribute? :photo, Types::Array.of(PhotoSize)
         attribute? :sticker, Sticker

data/lib/telegram/bot/types/inline_query_result_location.rb

@@ -10,7 +10,7 @@ module Telegram
         attribute :longitude, Types::Float
         attribute :title, Types::String
         attribute? :horizontal_accuracy, Types::Float
-        attribute? :live_period, Types::Integer
+        attribute? :live_period, Types::Integer.constrained(min_size: 60, max_size: 86_400)
         attribute? :heading, Types::Integer
         attribute? :proximity_alert_radius, Types::Integer
         attribute? :reply_markup, InlineKeyboardMarkup

data/lib/telegram/bot/types/input_location_message_content.rb

@@ -7,7 +7,7 @@ module Telegram
         attribute :latitude, Types::Float
         attribute :longitude, Types::Float
         attribute? :horizontal_accuracy, Types::Float
-        attribute? :live_period, Types::Integer
+        attribute? :live_period, Types::Integer.constrained(min_size: 60, max_size: 86_400)
         attribute? :heading, Types::Integer
         attribute? :proximity_alert_radius, Types::Integer
       end

data/lib/telegram/bot/types/input_media.rb

@@ -7,8 +7,9 @@ module Telegram
       # rubocop:disable Naming/ConstantName
       InputMedia = (
         InputMediaAnimation |
-        InputMediaDocument |
         InputMediaAudio |
+        InputMediaDocument |
+        InputMediaLivePhoto |
         InputMediaPhoto |
         InputMediaVideo
       )

data/lib/telegram/bot/types/input_media_link.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module Telegram
+  module Bot
+    module Types
+      class InputMediaLink < Base
+        attribute :type, Types::String.constrained(eql: 'link').default('link')
+        attribute :url, Types::String
+      end
+    end
+  end
+end

data/lib/telegram/bot/types/input_media_live_photo.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module Telegram
+  module Bot
+    module Types
+      class InputMediaLivePhoto < Base
+        attribute :type, Types::String.constrained(eql: 'live_photo').default('live_photo')
+        attribute :media, Types::String
+        attribute :photo, Types::String
+        attribute? :caption, Types::String
+        attribute? :parse_mode, Types::String
+        attribute? :caption_entities, Types::Array.of(MessageEntity)
+        attribute? :show_caption_above_media, Types::Bool
+        attribute? :has_spoiler, Types::Bool
+      end
+    end
+  end
+end

data/lib/telegram/bot/types/input_media_location.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module Telegram
+  module Bot
+    module Types
+      class InputMediaLocation < Base
+        attribute :type, Types::String.constrained(eql: 'location').default('location')
+        attribute :latitude, Types::Float
+        attribute :longitude, Types::Float
+        attribute? :horizontal_accuracy, Types::Float
+      end
+    end
+  end
+end

data/lib/telegram/bot/types/input_media_sticker.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Telegram
+  module Bot
+    module Types
+      class InputMediaSticker < Base
+        attribute :type, Types::String.constrained(eql: 'sticker').default('sticker')
+        attribute :media, Types::String
+        attribute? :emoji, Types::String
+      end
+    end
+  end
+end

data/lib/telegram/bot/types/input_media_venue.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module Telegram
+  module Bot
+    module Types
+      class InputMediaVenue < Base
+        attribute :type, Types::String.constrained(eql: 'venue').default('venue')
+        attribute :latitude, Types::Float
+        attribute :longitude, Types::Float
+        attribute :title, Types::String
+        attribute :address, Types::String
+        attribute? :foursquare_id, Types::String
+        attribute? :foursquare_type, Types::String
+        attribute? :google_place_id, Types::String
+        attribute? :google_place_type, Types::String
+      end
+    end
+  end
+end

data/lib/telegram/bot/types/input_media_voice_note.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module Telegram
+  module Bot
+    module Types
+      class InputMediaVoiceNote < Base
+        attribute :type, Types::String.constrained(eql: 'voice_note').default('voice_note')
+        attribute :media, Types::String
+        attribute? :caption, Types::String
+        attribute? :parse_mode, Types::String
+        attribute? :caption_entities, Types::Array.of(MessageEntity)
+        attribute? :duration, Types::Integer
+      end
+    end
+  end
+end

data/lib/telegram/bot/types/input_message_content.rb

@@ -7,6 +7,7 @@ module Telegram
       # rubocop:disable Naming/ConstantName
       InputMessageContent = (
         InputTextMessageContent |
+        InputRichMessageContent |
         InputLocationMessageContent |
         InputVenueMessageContent |
         InputContactMessageContent |

data/lib/telegram/bot/types/input_paid_media.rb

@@ -6,6 +6,7 @@ module Telegram
       ## Just for classes consistency
       # rubocop:disable Naming/ConstantName
       InputPaidMedia = (
+        InputPaidMediaLivePhoto |
         InputPaidMediaPhoto |
         InputPaidMediaVideo
       )

data/lib/telegram/bot/types/input_paid_media_live_photo.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Telegram
+  module Bot
+    module Types
+      class InputPaidMediaLivePhoto < Base
+        attribute :type, Types::String.constrained(eql: 'live_photo').default('live_photo')
+        attribute :media, Types::String
+        attribute :photo, Types::String
+      end
+    end
+  end
+end

data/lib/telegram/bot/types/input_poll_media.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module Telegram
+  module Bot
+    module Types
+      ## Just for classes consistency
+      # rubocop:disable Naming/ConstantName
+      InputPollMedia = (
+        InputMediaAnimation |
+        InputMediaAudio |
+        InputMediaDocument |
+        InputMediaLivePhoto |
+        InputMediaLocation |
+        InputMediaPhoto |
+        InputMediaVenue |
+        InputMediaVideo
+      )
+      # rubocop:enable Naming/ConstantName
+    end
+  end
+end

data/lib/telegram/bot/types/input_poll_option.rb

@@ -7,6 +7,7 @@ module Telegram
         attribute :text, Types::String.constrained(min_size: 1, max_size: 100)
         attribute? :text_parse_mode, Types::String
         attribute? :text_entities, Types::Array.of(MessageEntity)
+        attribute? :media, InputPollOptionMedia
       end
     end
   end

data/lib/telegram/bot/types/input_poll_option_media.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module Telegram
+  module Bot
+    module Types
+      ## Just for classes consistency
+      # rubocop:disable Naming/ConstantName
+      InputPollOptionMedia = (
+        InputMediaAnimation |
+        InputMediaLink |
+        InputMediaLivePhoto |
+        InputMediaLocation |
+        InputMediaPhoto |
+        InputMediaSticker |
+        InputMediaVenue |
+        InputMediaVideo
+      )
+      # rubocop:enable Naming/ConstantName
+    end
+  end
+end

data/lib/telegram/bot/types/input_rich_block.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+module Telegram
+  module Bot
+    module Types
+      ## Just for classes consistency
+      # rubocop:disable Naming/ConstantName
+      InputRichBlock = (
+        InputRichBlockParagraph |
+        InputRichBlockSectionHeading |
+        InputRichBlockPreformatted |
+        InputRichBlockFooter |
+        InputRichBlockDivider |
+        InputRichBlockMathematicalExpression |
+        InputRichBlockAnchor |
+        InputRichBlockList |
+        InputRichBlockBlockQuotation |
+        InputRichBlockPullQuotation |
+        InputRichBlockCollage |
+        InputRichBlockSlideshow |
+        InputRichBlockTable |
+        InputRichBlockDetails |
+        InputRichBlockMap |
+        InputRichBlockAnimation |
+        InputRichBlockAudio |
+        InputRichBlockPhoto |
+        InputRichBlockVideo |
+        InputRichBlockVoiceNote |
+        InputRichBlockThinking
+      )
+      # rubocop:enable Naming/ConstantName
+    end
+  end
+end

data/lib/telegram/bot/types/input_rich_block_anchor.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module Telegram
+  module Bot
+    module Types
+      class InputRichBlockAnchor < Base
+        attribute :type, Types::String.constrained(eql: 'anchor').default('anchor')
+        attribute :name, Types::String
+      end
+    end
+  end
+end

data/lib/telegram/bot/types/input_rich_block_animation.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Telegram
+  module Bot
+    module Types
+      class InputRichBlockAnimation < Base
+        attribute :type, Types::String.constrained(eql: 'animation').default('animation')
+        attribute :animation, InputMediaAnimation
+        attribute? :caption, RichBlockCaption
+      end
+    end
+  end
+end

data/lib/telegram/bot/types/input_rich_block_audio.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Telegram
+  module Bot
+    module Types
+      class InputRichBlockAudio < Base
+        attribute :type, Types::String.constrained(eql: 'audio').default('audio')
+        attribute :audio, InputMediaAudio
+        attribute? :caption, RichBlockCaption
+      end
+    end
+  end
+end

data/lib/telegram/bot/types/input_rich_block_block_quotation.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Telegram
+  module Bot
+    module Types
+      class InputRichBlockBlockQuotation < Base
+        attribute :type, Types::String.constrained(eql: 'blockquote').default('blockquote')
+        attribute :blocks, Types::Array.of(Types.deferred(:InputRichBlock))
+        attribute? :credit, RichText
+      end
+    end
+  end
+end

data/lib/telegram/bot/types/input_rich_block_collage.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Telegram
+  module Bot
+    module Types
+      class InputRichBlockCollage < Base
+        attribute :type, Types::String.constrained(eql: 'collage').default('collage')
+        attribute :blocks, Types::Array.of(Types.deferred(:InputRichBlock))
+        attribute? :caption, RichBlockCaption
+      end
+    end
+  end
+end

data/lib/telegram/bot/types/input_rich_block_details.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module Telegram
+  module Bot
+    module Types
+      class InputRichBlockDetails < Base
+        attribute :type, Types::String.constrained(eql: 'details').default('details')
+        attribute :summary, RichText
+        attribute :blocks, Types::Array.of(Types.deferred(:InputRichBlock))
+        attribute? :is_open, Types::True
+      end
+    end
+  end
+end

data/lib/telegram/bot/types/input_rich_block_divider.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module Telegram
+  module Bot
+    module Types
+      class InputRichBlockDivider < Base
+        attribute :type, Types::String.constrained(eql: 'divider').default('divider')
+      end
+    end
+  end
+end

data/lib/telegram/bot/types/input_rich_block_footer.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module Telegram
+  module Bot
+    module Types
+      class InputRichBlockFooter < Base
+        attribute :type, Types::String.constrained(eql: 'footer').default('footer')
+        attribute :text, RichText
+      end
+    end
+  end
+end

data/lib/telegram/bot/types/input_rich_block_list.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module Telegram
+  module Bot
+    module Types
+      class InputRichBlockList < Base
+        attribute :type, Types::String.constrained(eql: 'list').default('list')
+        attribute :items, Types::Array.of(InputRichBlockListItem)
+      end
+    end
+  end
+end