tdlib-ruby 2.0.0 → 2.1.0

data/lib/tdlib/types/input_inline_query_result/photo.rb

@@ -8,9 +8,11 @@ module TD::Types
   # @attr photo_url [String] The URL of the JPEG photo (photo size must not exceed 5MB).
   # @attr photo_width [Integer] Width of the photo.
   # @attr photo_height [Integer] Height of the photo.
-  # @attr input_message_content [TD::Types::InputMessageContent::Text, TD::Types::InputMessageContent::Photo,
-  #   TD::Types::InputMessageContent::Location, TD::Types::InputMessageContent::Venue,
-  #   TD::Types::InputMessageContent::Contact] The content of the message to be sent.
+  # @attr reply_markup [TD::Types::ReplyMarkup] The message reply markup.
+  #   Must be of type {TD::Types::ReplyMarkup::InlineKeyboard} or null.
+  # @attr input_message_content [TD::Types::InputMessageContent] The content of the message to be sent.
+  #   Must be one of the following types: InputMessageText, InputMessagePhoto, InputMessageLocation, InputMessageVenue
+  #   or InputMessageContact.
   class InputInlineQueryResult::Photo < InputInlineQueryResult
     attribute :id, TD::Types::String
     attribute :title, TD::Types::String

data/lib/tdlib/types/input_inline_query_result/sticker.rb

@@ -1,15 +1,16 @@
 module TD::Types
-  # Represents a link to a WEBP sticker.
+  # Represents a link to a WEBP or a TGS sticker.
   #
   # @attr id [String] Unique identifier of the query result.
   # @attr thumbnail_url [String] URL of the sticker thumbnail, if it exists.
-  # @attr sticker_url [String] The URL of the WEBP sticker (sticker file size must not exceed 5MB).
+  # @attr sticker_url [String] The URL of the WEBP or a TGS sticker (sticker file size must not exceed 5MB).
   # @attr sticker_width [Integer] Width of the sticker.
   # @attr sticker_height [Integer] Height of the sticker.
-  # @attr reply_markup [TD::Types::ReplyMarkup::InlineKeyboard, nil] The message reply markup.
-  # @attr input_message_content [TD::Types::InputMessageContent::Text, TD::Types::InputMessageContent::Sticker,
-  #   TD::Types::InputMessageContent::Location, TD::Types::InputMessageContent::Venue,
-  #   TD::Types::InputMessageContent::Contact] The content of the message to be sent.
+  # @attr reply_markup [TD::Types::ReplyMarkup] The message reply markup.
+  #   Must be of type {TD::Types::ReplyMarkup::InlineKeyboard} or null.
+  # @attr input_message_content [TD::Types::InputMessageContent] The content of the message to be sent.
+  #   Must be one of the following types: InputMessageText, inputMessageSticker, InputMessageLocation,
+  #   InputMessageVenue or InputMessageContact.
   class InputInlineQueryResult::Sticker < InputInlineQueryResult
     attribute :id, TD::Types::String
     attribute :thumbnail_url, TD::Types::String

data/lib/tdlib/types/input_inline_query_result/venue.rb

@@ -6,10 +6,11 @@ module TD::Types
   # @attr thumbnail_url [String] URL of the result thumbnail, if it exists.
   # @attr thumbnail_width [Integer] Thumbnail width, if known.
   # @attr thumbnail_height [Integer] Thumbnail height, if known.
-  # @attr reply_markup [TD::Types::ReplyMarkup::InlineKeyboard, nil] The message reply markup.
-  # @attr input_message_content [TD::Types::InputMessageContent::Text, TD::Types::InputMessageContent::Location,
-  #   TD::Types::InputMessageContent::Venue, TD::Types::InputMessageContent::Contact] The content of the message to be
-  #   sent.
+  # @attr reply_markup [TD::Types::ReplyMarkup] The message reply markup.
+  #   Must be of type {TD::Types::ReplyMarkup::InlineKeyboard} or null.
+  # @attr input_message_content [TD::Types::InputMessageContent] The content of the message to be sent.
+  #   Must be one of the following types: InputMessageText, InputMessageLocation, InputMessageVenue or
+  #   InputMessageContact.
   class InputInlineQueryResult::Venue < InputInlineQueryResult
     attribute :id, TD::Types::String
     attribute :venue, TD::Types::Venue

data/lib/tdlib/types/input_inline_query_result/video.rb

@@ -11,10 +11,11 @@ module TD::Types
   # @attr video_width [Integer] Width of the video.
   # @attr video_height [Integer] Height of the video.
   # @attr video_duration [Integer] Video duration, in seconds.
-  # @attr reply_markup [TD::Types::ReplyMarkup::InlineKeyboard, nil] The message reply markup.
-  # @attr input_message_content [TD::Types::InputMessageContent::Text, TD::Types::InputMessageContent::Video,
-  #   TD::Types::InputMessageContent::Location, TD::Types::InputMessageContent::Venue,
-  #   TD::Types::InputMessageContent::Contact] The content of the message to be sent.
+  # @attr reply_markup [TD::Types::ReplyMarkup] The message reply markup.
+  #   Must be of type {TD::Types::ReplyMarkup::InlineKeyboard} or null.
+  # @attr input_message_content [TD::Types::InputMessageContent] The content of the message to be sent.
+  #   Must be one of the following types: InputMessageText, InputMessageVideo, InputMessageLocation, InputMessageVenue
+  #   or InputMessageContact.
   class InputInlineQueryResult::Video < InputInlineQueryResult
     attribute :id, TD::Types::String
     attribute :title, TD::Types::String

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

@@ -5,10 +5,11 @@ module TD::Types
   # @attr title [String] Title of the voice note.
   # @attr voice_note_url [String] The URL of the voice note file.
   # @attr voice_note_duration [Integer] Duration of the voice note, in seconds.
-  # @attr reply_markup [TD::Types::ReplyMarkup::InlineKeyboard, nil] The message reply markup.
-  # @attr input_message_content [TD::Types::InputMessageContent::Text, TD::Types::InputMessageContent::VoiceNote,
-  #   TD::Types::InputMessageContent::Location, TD::Types::InputMessageContent::Venue,
-  #   TD::Types::InputMessageContent::Contact] The content of the message to be sent.
+  # @attr reply_markup [TD::Types::ReplyMarkup] The message reply markup.
+  #   Must be of type {TD::Types::ReplyMarkup::InlineKeyboard} or null.
+  # @attr input_message_content [TD::Types::InputMessageContent] The content of the message to be sent.
+  #   Must be one of the following types: InputMessageText, InputMessageVoiceNote, InputMessageLocation,
+  #   InputMessageVenue or InputMessageContact.
   class InputInlineQueryResult::VoiceNote < InputInlineQueryResult
     attribute :id, TD::Types::String
     attribute :title, TD::Types::String

data/lib/tdlib/types/input_message_content.rb

@@ -16,6 +16,7 @@ module TD::Types
       contact
       game
       invoice
+      poll
       forwarded
     ].each do |type|
       autoload TD::Types.camelize(type), "tdlib/types/input_message_content/#{type}"

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

@@ -5,9 +5,16 @@ module TD::Types
   # @attr message_id [Integer] Identifier of the message to forward.
   # @attr in_game_share [Boolean] True, if a game message should be shared within a launched game; applies only to game
   #   messages.
+  # @attr send_copy [Boolean] True, if content of the message needs to be copied without a link to the original
+  #   message.
+  #   Always true if the message is forwarded to a secret chat.
+  # @attr remove_caption [Boolean] True, if media caption of the message copy needs to be removed.
+  #   Ignored if send_copy is false.
   class InputMessageContent::Forwarded < InputMessageContent
     attribute :from_chat_id, TD::Types::Integer
     attribute :message_id, TD::Types::Integer
     attribute :in_game_share, TD::Types::Bool
+    attribute :send_copy, TD::Types::Bool
+    attribute :remove_caption, TD::Types::Bool
   end
 end

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

@@ -0,0 +1,11 @@
+module TD::Types
+  # A message with a poll.
+  # Polls can't be sent to private or secret chats.
+  #
+  # @attr question [String] Poll question, 1-255 characters.
+  # @attr options [Array<String>] List of poll answer options, 2-10 strings 1-100 characters each.
+  class InputMessageContent::Poll < InputMessageContent
+    attribute :question, TD::Types::String
+    attribute :options, TD::Types::Array.of(TD::Types::String)
+  end
+end

data/lib/tdlib/types/input_thumbnail.rb

@@ -4,9 +4,9 @@ module TD::Types
   #
   # @attr thumbnail [TD::Types::InputFile] Thumbnail file to send.
   #   Sending thumbnails by file_id is currently not supported.
-  # @attr width [Integer] Thumbnail width, usually shouldn't exceed 90.
+  # @attr width [Integer] Thumbnail width, usually shouldn't exceed 320.
   #   Use 0 if unknown.
-  # @attr height [Integer] Thumbnail height, usually shouldn't exceed 90.
+  # @attr height [Integer] Thumbnail height, usually shouldn't exceed 320.
   #   Use 0 if unknown.
   class InputThumbnail < Base
     attribute :thumbnail, TD::Types::InputFile

data/lib/tdlib/types/json_object_member.rb

@@ -0,0 +1,10 @@
+module TD::Types
+  # Represents one member of a JSON object.
+  #
+  # @attr key [String] Member's key.
+  # @attr value [TD::Types::JsonValue] Member's value.
+  class JsonObjectMember < Base
+    attribute :key, TD::Types::String
+    attribute :value, TD::Types::JsonValue
+  end
+end

data/lib/tdlib/types/json_value.rb

@@ -0,0 +1,15 @@
+module TD::Types
+  # Represents a JSON value.
+  class JsonValue < Base
+    %w[
+      null
+      boolean
+      number
+      string
+      array
+      object
+    ].each do |type|
+      autoload TD::Types.camelize(type), "tdlib/types/json_value/#{type}"
+    end
+  end
+end

data/lib/tdlib/types/json_value/array.rb

@@ -0,0 +1,8 @@
+module TD::Types
+  # Represents a JSON array.
+  #
+  # @attr values [Array<TD::Types::JsonValue>] The list of array elements.
+  class JsonValue::Array < JsonValue
+    attribute :values, TD::Types::Array.of(TD::Types::JsonValue)
+  end
+end

data/lib/tdlib/types/json_value/boolean.rb

@@ -0,0 +1,8 @@
+module TD::Types
+  # Represents a boolean JSON value.
+  #
+  # @attr value [Boolean] The value.
+  class JsonValue::Boolean < JsonValue
+    attribute :value, TD::Types::Bool
+  end
+end

data/lib/tdlib/types/json_value/null.rb

@@ -0,0 +1,5 @@
+module TD::Types
+  # Represents a null JSON value.
+  class JsonValue::Null < JsonValue
+  end
+end

data/lib/tdlib/types/json_value/number.rb

@@ -0,0 +1,8 @@
+module TD::Types
+  # Represents a numeric JSON value.
+  #
+  # @attr value [Float] The value.
+  class JsonValue::Number < JsonValue
+    attribute :value, TD::Types::Float
+  end
+end

data/lib/tdlib/types/json_value/object.rb

@@ -0,0 +1,8 @@
+module TD::Types
+  # Represents a JSON object.
+  #
+  # @attr members [Array<TD::Types::JsonObjectMember>] The list of object members.
+  class JsonValue::Object < JsonValue
+    attribute :members, TD::Types::Array.of(TD::Types::JsonObjectMember)
+  end
+end

data/lib/tdlib/types/json_value/string.rb

@@ -0,0 +1,8 @@
+module TD::Types
+  # Represents a string JSON value.
+  #
+  # @attr value [String] The value.
+  class JsonValue::String < JsonValue
+    attribute :value, TD::Types::String
+  end
+end

data/lib/tdlib/types/language_pack_info.rb

@@ -2,13 +2,34 @@ module TD::Types
   # Contains information about a language pack.
   #
   # @attr id [String] Unique language pack identifier.
+  # @attr base_language_pack_id [String, nil] Identifier of a base language pack; may be empty.
+  #   If a string is missed in the language pack, then it should be fetched from base language pack.
+  #   Unsupported in custom language packs.
   # @attr name [String] Language name.
   # @attr native_name [String] Name of the language in that language.
+  # @attr plural_code [String] A language code to be used to apply plural forms.
+  #   See https://www.unicode.org/cldr/charts/latest/supplemental/language_plural_rules.html for more info.
+  # @attr is_official [Boolean] True, if the language pack is official.
+  # @attr is_rtl [Boolean] True, if the language pack strings are RTL.
+  # @attr is_beta [Boolean] True, if the language pack is a beta language pack.
+  # @attr is_installed [Boolean] True, if the language pack is installed by the current user.
+  # @attr total_string_count [Integer] Total number of non-deleted strings from the language pack.
+  # @attr translated_string_count [Integer] Total number of translated strings from the language pack.
   # @attr local_string_count [Integer] Total number of non-deleted strings from the language pack available locally.
+  # @attr translation_url [String, nil] Link to language translation interface; empty for custom local language packs.
   class LanguagePackInfo < Base
     attribute :id, TD::Types::String
+    attribute :base_language_pack_id, TD::Types::String.optional.default(nil)
     attribute :name, TD::Types::String
     attribute :native_name, TD::Types::String
+    attribute :plural_code, TD::Types::String
+    attribute :is_official, TD::Types::Bool
+    attribute :is_rtl, TD::Types::Bool
+    attribute :is_beta, TD::Types::Bool
+    attribute :is_installed, TD::Types::Bool
+    attribute :total_string_count, TD::Types::Integer
+    attribute :translated_string_count, TD::Types::Integer
     attribute :local_string_count, TD::Types::Integer
+    attribute :translation_url, TD::Types::String.optional.default(nil)
   end
 end

data/lib/tdlib/types/language_pack_string_value/pluralized.rb

@@ -1,5 +1,6 @@
 module TD::Types
   # A language pack string which has different forms based on the number of some object it mentions.
+  # See https://www.unicode.org/cldr/charts/latest/supplemental/language_plural_rules.html for more info.
   #
   # @attr zero_value [String] Value for zero objects.
   # @attr one_value [String] Value for one object.

data/lib/tdlib/types/link_state/is_contact.rb

@@ -1,5 +1,5 @@
 module TD::Types
-  # The phone number of user A has been saved to the contacts list of user B.
+  # The phone number of user A has been saved to the contact list of user B.
   class LinkState::IsContact < LinkState
   end
 end

data/lib/tdlib/types/link_state/knows_phone_number.rb

@@ -1,5 +1,5 @@
 module TD::Types
-  # The phone number of user A is known but that number has not been saved to the contacts list of user B.
+  # The phone number of user A is known but that number has not been saved to the contact list of user B.
   class LinkState::KnowsPhoneNumber < LinkState
   end
 end

data/lib/tdlib/types/local_file.rb

@@ -7,8 +7,10 @@ module TD::Types
   # @attr is_downloading_active [Boolean] True, if the file is currently being downloaded (or a local copy is being
   #   generated by some other means).
   # @attr is_downloading_completed [Boolean] True, if the local copy is fully available.
-  # @attr downloaded_prefix_size [Integer] If is_downloading_completed is false, then only some prefix of the file is
-  #   ready to be read.
+  # @attr download_offset [Integer] Download will be started from this offset.
+  #   downloaded_prefix_size is calculated from this offset.
+  # @attr downloaded_prefix_size [Integer] If is_downloading_completed is false, then only some prefix of the file
+  #   starting from download_offset is ready to be read.
   #   downloaded_prefix_size is the size of that prefix.
   # @attr downloaded_size [Integer] Total downloaded file bytes.
   #   Should be used only for calculating download progress.
@@ -19,6 +21,7 @@ module TD::Types
     attribute :can_be_deleted, TD::Types::Bool
     attribute :is_downloading_active, TD::Types::Bool
     attribute :is_downloading_completed, TD::Types::Bool
+    attribute :download_offset, TD::Types::Integer
     attribute :downloaded_prefix_size, TD::Types::Integer
     attribute :downloaded_size, TD::Types::Integer
   end

data/lib/tdlib/types/log_stream.rb

@@ -0,0 +1,12 @@
+module TD::Types
+  # Describes a stream to which TDLib internal log is written.
+  class LogStream < Base
+    %w[
+      default
+      file
+      empty
+    ].each do |type|
+      autoload TD::Types.camelize(type), "tdlib/types/log_stream/#{type}"
+    end
+  end
+end

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

@@ -0,0 +1,5 @@
+module TD::Types
+  # The log is written to stderr or an OS specific log.
+  class LogStream::Default < LogStream
+  end
+end

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

@@ -0,0 +1,5 @@
+module TD::Types
+  # The log is written nowhere.
+  class LogStream::Empty < LogStream
+  end
+end

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

@@ -0,0 +1,11 @@
+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.
+  class LogStream::File < LogStream
+    attribute :path, TD::Types::String
+    attribute :max_file_size, TD::Types::Integer
+  end
+end

data/lib/tdlib/types/log_tags.rb

@@ -0,0 +1,8 @@
+module TD::Types
+  # Contains a list of available TDLib internal log tags.
+  #
+  # @attr tags [Array<String>] List of log tags.
+  class LogTags < Base
+    attribute :tags, TD::Types::Array.of(TD::Types::String)
+  end
+end

data/lib/tdlib/types/log_verbosity_level.rb

@@ -0,0 +1,8 @@
+module TD::Types
+  # Contains a TDLib internal log verbosity level.
+  #
+  # @attr verbosity_level [Integer] Log verbosity level.
+  class LogVerbosityLevel < Base
+    attribute :verbosity_level, TD::Types::Integer
+  end
+end

data/lib/tdlib/types/message.rb

@@ -3,12 +3,14 @@ module TD::Types
   #
   # @attr id [Integer] Message identifier, unique for the chat to which the message belongs.
   # @attr sender_user_id [Integer] Identifier of the user who sent the message; 0 if unknown.
-  #   It is unknown for channel posts.
+  #   Currently, it is unknown for channel posts and for channel posts automatically forwarded to discussion group.
   # @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 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
+  #   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
   #   other users will continue to see it.

data/lib/tdlib/types/message_content.rb

@@ -17,6 +17,7 @@ module TD::Types
       venue
       contact
       game
+      poll
       invoice
       call
       basic_group_chat_create

data/lib/tdlib/types/message_content/game_score.rb

@@ -2,7 +2,7 @@ module TD::Types
   # A new high score was achieved in a game.
   #
   # @attr game_message_id [Integer] Identifier of the message with the game, can be an identifier of a deleted message.
-  # @attr game_id [Integer] Identifier of the game, may be different from the games presented in the message with the
+  # @attr game_id [Integer] Identifier of the game; may be different from the games presented in the message with the
   #   game.
   # @attr score [Integer] New score.
   class MessageContent::GameScore < MessageContent

data/lib/tdlib/types/message_content/pin_message.rb

@@ -1,7 +1,7 @@
 module TD::Types
   # A message has been pinned.
   #
-  # @attr message_id [Integer] Identifier of the pinned message, can be an identifier of a deleted message.
+  # @attr message_id [Integer] Identifier of the pinned message, can be an identifier of a deleted message or 0.
   class MessageContent::PinMessage < MessageContent
     attribute :message_id, TD::Types::Integer
   end

data/lib/tdlib/types/message_content/poll.rb

@@ -0,0 +1,8 @@
+module TD::Types
+  # A message with a poll.
+  #
+  # @attr poll [TD::Types::Poll] Poll.
+  class MessageContent::Poll < MessageContent
+    attribute :poll, TD::Types::Poll
+  end
+end

data/lib/tdlib/types/message_forward_info.rb

@@ -1,11 +1,17 @@
 module TD::Types
-  # Contains information about the initial sender of a forwarded message.
+  # Contains information about a forwarded message.
+  #
+  # @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.
   class MessageForwardInfo < Base
-    %w[
-      message_forwarded_from_user
-      message_forwarded_post
-    ].each do |type|
-      autoload TD::Types.camelize(type), "tdlib/types/message_forward_info/#{type}"
-    end
+    attribute :origin, TD::Types::MessageForwardOrigin
+    attribute :date, TD::Types::Integer
+    attribute :from_chat_id, TD::Types::Integer
+    attribute :from_message_id, TD::Types::Integer
   end
 end