tdlib-ruby 2.1.0 → 2.2.0

data/lib/tdlib/types/input_message_content/text.rb

@@ -2,7 +2,8 @@ module TD::Types
   # A text message.
   #
   # @attr text [TD::Types::FormattedText] Formatted text to be sent; 1-GetOption("message_text_length_max") characters.
-  #   Only Bold, Italic, Code, Pre, PreCode and TextUrl entities are allowed to be specified manually.
+  #   Only Bold, Italic, Underline, Strikethrough, Code, Pre, PreCode, TextUrl and MentionName entities are allowed to
+  #   be specified manually.
   # @attr disable_web_page_preview [Boolean] True, if rich web page previews for URLs in the message text should be
   #   disabled.
   # @attr clear_draft [Boolean] True, if a chat message draft should be deleted.

data/lib/tdlib/types/log_stream/file.rb

@@ -2,8 +2,8 @@ module TD::Types
   # The log is written to a file.
   #
   # @attr path [String] Path to the file to where the internal TDLib log will be written.
-  # @attr max_file_size [Integer] Maximum size of the file to where the internal TDLib log is written before the file
-  #   will be auto-rotated.
+  # @attr max_file_size [Integer] The maximum size of the file to where the internal TDLib log is written before the
+  #   file will be auto-rotated.
   class LogStream::File < LogStream
     attribute :path, TD::Types::String
     attribute :max_file_size, TD::Types::Integer

data/lib/tdlib/types/login_url_info.rb

@@ -0,0 +1,11 @@
+module TD::Types
+  # Contains information about an inline button of type inlineKeyboardButtonTypeLoginUrl.
+  class LoginUrlInfo < Base
+    %w[
+      open
+      request_confirmation
+    ].each do |type|
+      autoload TD::Types.camelize(type), "tdlib/types/login_url_info/#{type}"
+    end
+  end
+end

data/lib/tdlib/types/login_url_info/open.rb

@@ -0,0 +1,10 @@
+module TD::Types
+  # An HTTP url needs to be open.
+  #
+  # @attr url [String] The URL to open.
+  # @attr skip_confirm [Boolean] True, if there is no need to show an ordinary open URL confirm.
+  class LoginUrlInfo::Open < LoginUrlInfo
+    attribute :url, TD::Types::String
+    attribute :skip_confirm, TD::Types::Bool
+  end
+end

data/lib/tdlib/types/login_url_info/request_confirmation.rb

@@ -0,0 +1,15 @@
+module TD::Types
+  # An authorization confirmation dialog needs to be shown to the user.
+  #
+  # @attr url [String] An HTTP URL to be opened.
+  # @attr domain [String] A domain of the URL.
+  # @attr bot_user_id [Integer] User identifier of a bot linked with the website.
+  # @attr request_write_access [Boolean] True, if the user needs to be requested to give the permission to the bot to
+  #   send them messages.
+  class LoginUrlInfo::RequestConfirmation < LoginUrlInfo
+    attribute :url, TD::Types::String
+    attribute :domain, TD::Types::String
+    attribute :bot_user_id, TD::Types::Integer
+    attribute :request_write_access, TD::Types::Bool
+  end
+end

data/lib/tdlib/types/message.rb

@@ -7,9 +7,11 @@ module TD::Types
   # @attr chat_id [Integer] Chat identifier.
   # @attr sending_state [TD::Types::MessageSendingState, nil] Information about the sending state of the message; may
   #   be null.
+  # @attr scheduling_state [TD::Types::MessageSchedulingState, nil] Information about the scheduling state of the
+  #   message; may be null.
   # @attr is_outgoing [Boolean] True, if the message is outgoing.
   # @attr can_be_edited [Boolean] True, if the message can be edited.
-  #   For live location and poll messages this fields shows, whether editMessageLiveLocation or stopPoll can be used
+  #   For live location and poll messages this fields shows whether editMessageLiveLocation or stopPoll can be used
   #   with this message by the client.
   # @attr can_be_forwarded [Boolean] True, if the message can be forwarded.
   # @attr can_be_deleted_only_for_self [Boolean] True, if the message can be deleted only for the current user while
@@ -31,6 +33,8 @@ module TD::Types
   # @attr views [Integer] Number of times this message was viewed.
   # @attr media_album_id [Integer] Unique identifier of an album this message belongs to.
   #   Only photos and videos can be grouped together in albums.
+  # @attr restriction_reason [String] If non-empty, contains a human-readable description of the reason why access to
+  #   this message must be restricted.
   # @attr content [TD::Types::MessageContent] Content of the message.
   # @attr reply_markup [TD::Types::ReplyMarkup, nil] Reply markup for the message; may be null.
   class Message < Base
@@ -38,6 +42,7 @@ module TD::Types
     attribute :sender_user_id, TD::Types::Integer
     attribute :chat_id, TD::Types::Integer
     attribute :sending_state, TD::Types::MessageSendingState.optional.default(nil)
+    attribute :scheduling_state, TD::Types::MessageSchedulingState.optional.default(nil)
     attribute :is_outgoing, TD::Types::Bool
     attribute :can_be_edited, TD::Types::Bool
     attribute :can_be_forwarded, TD::Types::Bool
@@ -55,6 +60,7 @@ module TD::Types
     attribute :author_signature, TD::Types::String.optional.default(nil)
     attribute :views, TD::Types::Integer
     attribute :media_album_id, TD::Types::Integer
+    attribute :restriction_reason, TD::Types::String
     attribute :content, TD::Types::MessageContent
     attribute :reply_markup, TD::Types::ReplyMarkup.optional.default(nil)
   end

data/lib/tdlib/types/message_forward_info.rb

@@ -3,11 +3,11 @@ module TD::Types
   #
   # @attr origin [TD::Types::MessageForwardOrigin] Origin of a forwarded message.
   # @attr date [Integer] Point in time (Unix timestamp) when the message was originally sent.
-  # @attr from_chat_id [Integer] For messages forwarded to the chat with the current user (saved messages) or to the
-  #   channel discussion supergroup, the identifier of the chat from which the message was forwarded last time; 0 if unknown.
-  # @attr from_message_id [Integer] For messages forwarded to the chat with the current user (saved messages) or to the
-  #   channel discussion supergroup, the identifier of the original message from which the new message was forwarded last
-  #   time; 0 if unknown.
+  # @attr from_chat_id [Integer] For messages forwarded to the chat with the current user (Saved Messages) or to the
+  #   channel's discussion group, the identifier of the chat from which the message was forwarded last time; 0 if unknown.
+  # @attr from_message_id [Integer] For messages forwarded to the chat with the current user (Saved Messages) or to the
+  #   channel's discussion group, the identifier of the original message from which the new message was forwarded last time;
+  #   0 if unknown.
   class MessageForwardInfo < Base
     attribute :origin, TD::Types::MessageForwardOrigin
     attribute :date, TD::Types::Integer

data/lib/tdlib/types/message_scheduling_state.rb

@@ -0,0 +1,11 @@
+module TD::Types
+  # Contains information about the time when a scheduled message will be sent.
+  class MessageSchedulingState < Base
+    %w[
+      send_at_date
+      send_when_online
+    ].each do |type|
+      autoload TD::Types.camelize(type), "tdlib/types/message_scheduling_state/#{type}"
+    end
+  end
+end

data/lib/tdlib/types/message_scheduling_state/send_at_date.rb

@@ -0,0 +1,9 @@
+module TD::Types
+  # The message will be sent at the specified date.
+  #
+  # @attr send_date [Integer] Date the message will be sent.
+  #   The date must be within 367 days in the future.
+  class MessageSchedulingState::SendAtDate < MessageSchedulingState
+    attribute :send_date, TD::Types::Integer
+  end
+end

data/lib/tdlib/types/message_scheduling_state/send_when_online.rb

@@ -0,0 +1,6 @@
+module TD::Types
+  # The message will be sent when the peer will be online.
+  # Applicable to private chats only and when the exact online status of the peer is known.
+  class MessageSchedulingState::SendWhenOnline < MessageSchedulingState
+  end
+end

data/lib/tdlib/types/notification.rb

@@ -3,10 +3,12 @@ module TD::Types
   #
   # @attr id [Integer] Unique persistent identifier of this notification.
   # @attr date [Integer] Notification date.
+  # @attr is_silent [Boolean] True, if the notification was initially silent.
   # @attr type [TD::Types::NotificationType] Notification type.
   class Notification < Base
     attribute :id, TD::Types::Integer
     attribute :date, TD::Types::Integer
+    attribute :is_silent, TD::Types::Bool
     attribute :type, TD::Types::NotificationType
   end
 end

data/lib/tdlib/types/page_block.rb

@@ -20,6 +20,7 @@ module TD::Types
       audio
       photo
       video
+      voice_note
       cover
       embedded
       embedded_post

data/lib/tdlib/types/page_block/voice_note.rb

@@ -0,0 +1,10 @@
+module TD::Types
+  # A voice note.
+  #
+  # @attr voice_note [TD::Types::VoiceNote, nil] Voice note; may be null.
+  # @attr caption [TD::Types::PageBlockCaption] Voice note caption.
+  class PageBlock::VoiceNote < PageBlock
+    attribute :voice_note, TD::Types::VoiceNote.optional.default(nil)
+    attribute :caption, TD::Types::PageBlockCaption
+  end
+end

data/lib/tdlib/types/page_block_table_cell.rb

@@ -1,14 +1,15 @@
 module TD::Types
   # Represents a cell of a table.
   #
-  # @attr text [TD::Types::RichText] Cell text.
+  # @attr text [TD::Types::RichText, nil] Cell text; may be null.
+  #   If the text is null, then the cell should be invisible.
   # @attr is_header [Boolean] True, if it is a header cell.
   # @attr colspan [Integer] The number of columns the cell should span.
   # @attr rowspan [Integer] The number of rows the cell should span.
   # @attr align [TD::Types::PageBlockHorizontalAlignment] Horizontal cell content alignment.
   # @attr valign [TD::Types::PageBlockVerticalAlignment] Vertical cell content alignment.
   class PageBlockTableCell < Base
-    attribute :text, TD::Types::RichText
+    attribute :text, TD::Types::RichText.optional.default(nil)
     attribute :is_header, TD::Types::Bool
     attribute :colspan, TD::Types::Integer
     attribute :rowspan, TD::Types::Integer

data/lib/tdlib/types/public_chat_type.rb

@@ -0,0 +1,11 @@
+module TD::Types
+  # Describes a type of public chats.
+  class PublicChatType < Base
+    %w[
+      has_username
+      is_location_based
+    ].each do |type|
+      autoload TD::Types.camelize(type), "tdlib/types/public_chat_type/#{type}"
+    end
+  end
+end

data/lib/tdlib/types/public_chat_type/has_username.rb

@@ -0,0 +1,5 @@
+module TD::Types
+  # The chat is public, because it has username.
+  class PublicChatType::HasUsername < PublicChatType
+  end
+end

data/lib/tdlib/types/public_chat_type/is_location_based.rb

@@ -0,0 +1,5 @@
+module TD::Types
+  # The chat is public, because it is a location-based supergroup.
+  class PublicChatType::IsLocationBased < PublicChatType
+  end
+end

data/lib/tdlib/types/public_message_link.rb

@@ -1,5 +1,5 @@
 module TD::Types
-  # Contains a public HTTPS link to a message in a public supergroup or channel with a username.
+  # Contains a public HTTPS link to a message in a supergroup or channel with a username.
   #
   # @attr link [String] Message link.
   # @attr html [String] HTML-code for embedding the message.

data/lib/tdlib/types/push_message_content/chat_add_members.rb

@@ -3,7 +3,7 @@ module TD::Types
   #
   # @attr member_name [String] Name of the added member.
   # @attr is_current_user [Boolean] True, if the current user was added to the group.
-  # @attr is_returned [Boolean] True, if the user has returned to the group himself.
+  # @attr is_returned [Boolean] True, if the user has returned to the group themself.
   class PushMessageContent::ChatAddMembers < PushMessageContent
     attribute :member_name, TD::Types::String
     attribute :is_current_user, TD::Types::Bool

data/lib/tdlib/types/push_message_content/chat_delete_member.rb

@@ -3,7 +3,7 @@ module TD::Types
   #
   # @attr member_name [String] Name of the deleted member.
   # @attr is_current_user [Boolean] True, if the current user was deleted from the group.
-  # @attr is_left [Boolean] True, if the user has left the group himself.
+  # @attr is_left [Boolean] True, if the user has left the group themself.
   class PushMessageContent::ChatDeleteMember < PushMessageContent
     attribute :member_name, TD::Types::String
     attribute :is_current_user, TD::Types::Bool

data/lib/tdlib/types/remote_file.rb

@@ -3,18 +3,23 @@ module TD::Types
   #
   # @attr id [String, nil] Remote file identifier; may be empty.
   #   Can be used across application restarts or even from other devices for the current user.
+  #   Uniquely identifies a file, but a file can have a lot of different valid identifiers.
   #   If the ID starts with "http://" or "https://", it represents the HTTP URL of the file.
   #   TDLib is currently unable to download files if only their URL is known.
   #   If downloadFile is called on such a file or if it is sent to a secret chat, TDLib starts a file generation
   #   process by sending {TD::Types::Update::FileGenerationStart} to the client with the HTTP URL in the original_path and
   #   "#url#" as the conversion string.
   #   Clients should generate the file by downloading it to the specified location.
+  # @attr unique_id [String, nil] Unique file identifier; may be empty if unknown.
+  #   The unique file identifier which is the same for the same file even for different users and is persistent over
+  #   time.
   # @attr is_uploading_active [Boolean] True, if the file is currently being uploaded (or a remote copy is being
   #   generated by some other means).
   # @attr is_uploading_completed [Boolean] True, if a remote copy is fully available.
   # @attr uploaded_size [Integer] Size of the remote available part of the file; 0 if unknown.
   class RemoteFile < Base
     attribute :id, TD::Types::String.optional.default(nil)
+    attribute :unique_id, TD::Types::String.optional.default(nil)
     attribute :is_uploading_active, TD::Types::Bool
     attribute :is_uploading_completed, TD::Types::Bool
     attribute :uploaded_size, TD::Types::Integer

data/lib/tdlib/types/rich_text/strikethrough.rb

@@ -1,5 +1,5 @@
 module TD::Types
-  # A strike-through rich text.
+  # A strikethrough rich text.
   #
   # @attr text [TD::Types::RichText] Text.
   class RichText::Strikethrough < RichText

data/lib/tdlib/types/rich_text/url.rb

@@ -3,8 +3,10 @@ module TD::Types
   #
   # @attr text [TD::Types::RichText] Text.
   # @attr url [String] URL.
+  # @attr is_cached [Boolean] True, if the URL has cached instant view server-side.
   class RichText::Url < RichText
     attribute :text, TD::Types::RichText
     attribute :url, TD::Types::String
+    attribute :is_cached, TD::Types::Bool
   end
 end

data/lib/tdlib/types/secret_chat.rb

@@ -7,13 +7,14 @@ module TD::Types
   # @attr is_outbound [Boolean] True, if the chat was created by the current user; otherwise false.
   # @attr ttl [Integer] Current message Time To Live setting (self-destruct timer) for the chat, in seconds.
   # @attr key_hash [String] Hash of the currently used key for comparison with the hash of the chat partner's key.
-  #   This is a string of 36 bytes, which must be used to make a 12x12 square image with a color depth of 4.
-  #   The first 16 bytes should be used to make a central 8x8 square, while the remaining 20 bytes should be used to
-  #   construct a 2-pixel-wide border around that square.
+  #   This is a string of 36 little-endian bytes, which must be split into groups of 2 bits, each denoting a pixel of
+  #   one of 4 colors.
+  #   The pixels must be used to make a 12x12 square image filled from left to right, top to bottom.
   #   Alternatively, the first 32 bytes of the hash can be converted to the hexadecimal format and printed as 32
   #   2-digit hex numbers.
   # @attr layer [Integer] Secret chat layer; determines features supported by the other client.
-  #   Video notes are supported if the layer >= 66.
+  #   Video notes are supported if the layer >= 66; nested text entities and underline and strikethrough entities are
+  #   supported if the layer >= 101.
   class SecretChat < Base
     attribute :id, TD::Types::Integer
     attribute :user_id, TD::Types::Integer

data/lib/tdlib/types/send_message_options.rb

@@ -0,0 +1,14 @@
+module TD::Types
+  # Options to be used when a message is send.
+  #
+  # @attr disable_notification [Boolean] Pass true to disable notification for the message.
+  #   Must be false if the message is sent to a secret chat.
+  # @attr from_background [Boolean] Pass true if the message is sent from the background.
+  # @attr scheduling_state [TD::Types::MessageSchedulingState] Message scheduling state.
+  #   Messages sent to a secret chat, live location messages and self-destructing messages can't be scheduled.
+  class SendMessageOptions < Base
+    attribute :disable_notification, TD::Types::Bool
+    attribute :from_background, TD::Types::Bool
+    attribute :scheduling_state, TD::Types::MessageSchedulingState
+  end
+end

data/lib/tdlib/types/supergroup.rb

@@ -9,20 +9,21 @@ module TD::Types
   # @attr username [String, nil] Username of the supergroup or channel; empty for private supergroups or channels.
   # @attr date [Integer] Point in time (Unix timestamp) when the current user joined, or the point in time when the
   #   supergroup or channel was created, in case the user is not a member.
-  # @attr status [TD::Types::ChatMemberStatus] Status of the current user in the supergroup or channel.
+  # @attr status [TD::Types::ChatMemberStatus] Status of the current user in the supergroup or channel; custom title
+  #   will be always empty.
   # @attr member_count [Integer] Member count; 0 if unknown.
   #   Currently it is guaranteed to be known only if the supergroup or channel was found through SearchPublicChats.
+  # @attr has_linked_chat [Boolean] True, if the channel has a discussion group, or the supergroup is the designated
+  #   discussion group for a channel.
+  # @attr has_location [Boolean] True, if the supergroup is connected to a location, i.e.
+  #   the supergroup is a location-based supergroup.
   # @attr sign_messages [Boolean] True, if messages sent to the channel should contain information about the sender.
   #   This field is only applicable to channels.
+  # @attr is_slow_mode_enabled [Boolean] True, if the slow mode is enabled in the supergroup.
   # @attr is_channel [Boolean] True, if the supergroup is a channel.
   # @attr is_verified [Boolean] True, if the supergroup or channel is verified.
-  # @attr restriction_reason [String] If non-empty, contains the reason why access to this supergroup or channel must
-  #   be restricted.
-  #   Format of the string is "{type}: {description}".
-  #   {type} Contains the type of the restriction and at least one of the suffixes "-all", "-ios", "-android", or
-  #   "-wp", which describe the platforms on which access should be restricted.
-  #   (For example, "terms-ios-android".
-  #   {description} contains a human-readable description of the restriction, which can be shown to the user).
+  # @attr restriction_reason [String] If non-empty, contains a human-readable description of the reason why access to
+  #   this supergroup or channel must be restricted.
   # @attr is_scam [Boolean] True, if many users reported this supergroup as a scam.
   class Supergroup < Base
     attribute :id, TD::Types::Integer
@@ -30,7 +31,10 @@ module TD::Types
     attribute :date, TD::Types::Integer
     attribute :status, TD::Types::ChatMemberStatus
     attribute :member_count, TD::Types::Integer
+    attribute :has_linked_chat, TD::Types::Bool
+    attribute :has_location, TD::Types::Bool
     attribute :sign_messages, TD::Types::Bool
+    attribute :is_slow_mode_enabled, TD::Types::Bool
     attribute :is_channel, TD::Types::Bool
     attribute :is_verified, TD::Types::Bool
     attribute :restriction_reason, TD::Types::String

data/lib/tdlib/types/supergroup_full_info.rb

@@ -6,15 +6,24 @@ module TD::Types
   # @attr administrator_count [Integer] Number of privileged users in the supergroup or channel; 0 if unknown.
   # @attr restricted_count [Integer] Number of restricted users in the supergroup; 0 if unknown.
   # @attr banned_count [Integer] Number of users banned from chat; 0 if unknown.
+  # @attr linked_chat_id [Integer] Chat identifier of a discussion group for the channel, or a channel, for which the
+  #   supergroup is the designated discussion group; 0 if none or unknown.
+  # @attr slow_mode_delay [Integer] Delay between consecutive sent messages for non-administrator supergroup members,
+  #   in seconds.
+  # @attr slow_mode_delay_expires_in [Float] Time left before next message can be sent in the supergroup, in seconds.
+  #   An {TD::Types::Update::SupergroupFullInfo} update is not triggered when value of this field changes, but both new
+  #   and old values are non-zero.
   # @attr can_get_members [Boolean] True, if members of the chat can be retrieved.
-  # @attr can_set_username [Boolean] True, if the chat can be made public.
+  # @attr can_set_username [Boolean] True, if the chat username can be changed.
   # @attr can_set_sticker_set [Boolean] True, if the supergroup sticker set can be changed.
+  # @attr can_set_location [Boolean] True, if the supergroup location can be changed.
   # @attr can_view_statistics [Boolean] True, if the channel statistics is available through getChatStatisticsUrl.
   # @attr is_all_history_available [Boolean] True, if new chat members will have access to old messages.
-  #   In public supergroups and both public and private channels, old messages are always available, so this option
-  #   affects only private supergroups.
+  #   In public or discussion groups and both public and private channels, old messages are always available, so this
+  #   option affects only private supergroups without a linked chat.
   #   The value of this field is only available for chat administrators.
   # @attr sticker_set_id [Integer] Identifier of the supergroup sticker set; 0 if none.
+  # @attr location [TD::Types::ChatLocation, nil] Location to which the supergroup is connected; may be null.
   # @attr invite_link [String] Invite link for this chat.
   # @attr upgraded_from_basic_group_id [Integer] Identifier of the basic group from which supergroup was upgraded; 0 if
   #   none.
@@ -26,12 +35,17 @@ module TD::Types
     attribute :administrator_count, TD::Types::Integer
     attribute :restricted_count, TD::Types::Integer
     attribute :banned_count, TD::Types::Integer
+    attribute :linked_chat_id, TD::Types::Integer
+    attribute :slow_mode_delay, TD::Types::Integer
+    attribute :slow_mode_delay_expires_in, TD::Types::Float
     attribute :can_get_members, TD::Types::Bool
     attribute :can_set_username, TD::Types::Bool
     attribute :can_set_sticker_set, TD::Types::Bool
+    attribute :can_set_location, TD::Types::Bool
     attribute :can_view_statistics, TD::Types::Bool
     attribute :is_all_history_available, TD::Types::Bool
     attribute :sticker_set_id, TD::Types::Integer
+    attribute :location, TD::Types::ChatLocation.optional.default(nil)
     attribute :invite_link, TD::Types::String
     attribute :upgraded_from_basic_group_id, TD::Types::Integer
     attribute :upgraded_from_max_message_id, TD::Types::Integer

data/lib/tdlib/types/supergroup_members_filter/administrators.rb

@@ -1,5 +1,5 @@
 module TD::Types
-  # Returns the creator and administrators.
+  # Returns the owner and administrators.
   class SupergroupMembersFilter::Administrators < SupergroupMembersFilter
   end
 end

data/lib/tdlib/types/terms_of_service.rb

@@ -2,7 +2,7 @@ module TD::Types
   # Contains Telegram terms of service.
   #
   # @attr text [TD::Types::FormattedText] Text of the terms of service.
-  # @attr min_user_age [Integer] Minimum age of a user to be able to accept the terms; 0 if any.
+  # @attr min_user_age [Integer] The minimum age of a user to be able to accept the terms; 0 if any.
   # @attr show_popup [Boolean] True, if a blocking popup with terms of service must be shown to the user.
   class TermsOfService < Base
     attribute :text, TD::Types::FormattedText

data/lib/tdlib/types/text_entity_type.rb

@@ -8,14 +8,16 @@ module TD::Types
       bot_command
       url
       email_address
+      phone_number
       bold
       italic
+      underline
+      strikethrough
       code
       pre
       pre_code
       text_url
       mention_name
-      phone_number
     ].each do |type|
       autoload TD::Types.camelize(type), "tdlib/types/text_entity_type/#{type}"
     end