tdlib-ruby 2.0.0 → 2.1.0

data/lib/tdlib/types/chat_member_status/administrator.rb

@@ -12,9 +12,9 @@ module TD::Types
   # @attr can_delete_messages [Boolean] True, if the administrator can delete messages of other users.
   # @attr can_invite_users [Boolean] True, if the administrator can invite new users to the chat.
   # @attr can_restrict_members [Boolean] True, if the administrator can restrict, ban, or unban chat members.
-  # @attr can_pin_messages [Boolean] True, if the administrator can pin messages; applicable to supergroups only.
-  # @attr can_promote_members [Boolean] True, if the administrator can add new administrators with a subset of his own
-  #   privileges or demote administrators that were directly or indirectly promoted by him.
+  # @attr can_pin_messages [Boolean] True, if the administrator can pin messages; applicable to groups only.
+  # @attr can_promote_members [Boolean] True, if the administrator can add new administrators with a subset of their
+  #   own privileges or demote administrators that were directly or indirectly promoted by him.
   class ChatMemberStatus::Administrator < ChatMemberStatus
     attribute :can_be_edited, TD::Types::Bool
     attribute :can_change_info, TD::Types::Bool

data/lib/tdlib/types/chat_member_status/restricted.rb

@@ -7,21 +7,10 @@ module TD::Types
   #   user; 0 if never.
   #   If the user is restricted for more than 366 days or for less than 30 seconds from the current time, the user is
   #   considered to be restricted forever.
-  # @attr can_send_messages [Boolean] True, if the user can send text messages, contacts, locations, and venues.
-  # @attr can_send_media_messages [Boolean] True, if the user can send audio files, documents, photos, videos, video
-  #   notes, and voice notes.
-  #   Implies can_send_messages permissions.
-  # @attr can_send_other_messages [Boolean] True, if the user can send animations, games, and stickers and use inline
-  #   bots.
-  #   Implies can_send_media_messages permissions.
-  # @attr can_add_web_page_previews [Boolean] True, if the user may add a web page preview to his messages.
-  #   Implies can_send_messages permissions.
+  # @attr permissions [TD::Types::ChatPermissions] User permissions in the chat.
   class ChatMemberStatus::Restricted < ChatMemberStatus
     attribute :is_member, TD::Types::Bool
     attribute :restricted_until_date, TD::Types::Integer
-    attribute :can_send_messages, TD::Types::Bool
-    attribute :can_send_media_messages, TD::Types::Bool
-    attribute :can_send_other_messages, TD::Types::Bool
-    attribute :can_add_web_page_previews, TD::Types::Bool
+    attribute :permissions, TD::Types::ChatPermissions
   end
 end

data/lib/tdlib/types/chat_members_filter.rb

@@ -2,6 +2,7 @@ module TD::Types
   # Specifies the kind of chat members to return in searchChatMembers.
   class ChatMembersFilter < Base
     %w[
+      contacts
       administrators
       members
       restricted

data/lib/tdlib/types/chat_members_filter/contacts.rb

@@ -0,0 +1,5 @@
+module TD::Types
+  # Returns contacts of the user.
+  class ChatMembersFilter::Contacts < ChatMembersFilter
+  end
+end

data/lib/tdlib/types/chat_notification_settings.rb

@@ -11,6 +11,14 @@ module TD::Types
   # @attr use_default_show_preview [Boolean] If true, show_preview is ignored and the value for the relevant type of
   #   chat is used instead.
   # @attr show_preview [Boolean] True, if message content should be displayed in notifications.
+  # @attr use_default_disable_pinned_message_notifications [Boolean] If true, disable_pinned_message_notifications is
+  #   ignored and the value for the relevant type of chat is used instead.
+  # @attr disable_pinned_message_notifications [Boolean] If true, notifications for incoming pinned messages will be
+  #   created as for an ordinary unread message.
+  # @attr use_default_disable_mention_notifications [Boolean] If true, disable_mention_notifications is ignored and the
+  #   value for the relevant type of chat is used instead.
+  # @attr disable_mention_notifications [Boolean] If true, notifications for messages with mentions will be created as
+  #   for an ordinary unread message.
   class ChatNotificationSettings < Base
     attribute :use_default_mute_for, TD::Types::Bool
     attribute :mute_for, TD::Types::Integer
@@ -18,5 +26,9 @@ module TD::Types
     attribute :sound, TD::Types::String
     attribute :use_default_show_preview, TD::Types::Bool
     attribute :show_preview, TD::Types::Bool
+    attribute :use_default_disable_pinned_message_notifications, TD::Types::Bool
+    attribute :disable_pinned_message_notifications, TD::Types::Bool
+    attribute :use_default_disable_mention_notifications, TD::Types::Bool
+    attribute :disable_mention_notifications, TD::Types::Bool
   end
 end

data/lib/tdlib/types/chat_permissions.rb

@@ -0,0 +1,28 @@
+module TD::Types
+  # Describes actions that a user is allowed to take in a chat.
+  #
+  # @attr can_send_messages [Boolean] True, if the user can send text messages, contacts, locations, and venues.
+  # @attr can_send_media_messages [Boolean] True, if the user can send audio files, documents, photos, videos, video
+  #   notes, and voice notes.
+  #   Implies can_send_messages permissions.
+  # @attr can_send_polls [Boolean] True, if the user can send polls.
+  #   Implies can_send_messages permissions.
+  # @attr can_send_other_messages [Boolean] True, if the user can send animations, games, and stickers and use inline
+  #   bots.
+  #   Implies can_send_messages permissions.
+  # @attr can_add_web_page_previews [Boolean] True, if the user may add a web page preview to their messages.
+  #   Implies can_send_messages permissions.
+  # @attr can_change_info [Boolean] True, if the user can change the chat title, photo, and other settings.
+  # @attr can_invite_users [Boolean] True, if the user can invite new users to the chat.
+  # @attr can_pin_messages [Boolean] True, if the user can pin messages.
+  class ChatPermissions < Base
+    attribute :can_send_messages, TD::Types::Bool
+    attribute :can_send_media_messages, TD::Types::Bool
+    attribute :can_send_polls, TD::Types::Bool
+    attribute :can_send_other_messages, TD::Types::Bool
+    attribute :can_add_web_page_previews, TD::Types::Bool
+    attribute :can_change_info, TD::Types::Bool
+    attribute :can_invite_users, TD::Types::Bool
+    attribute :can_pin_messages, TD::Types::Bool
+  end
+end

data/lib/tdlib/types/chat_photo.rb

@@ -2,7 +2,9 @@ module TD::Types
   # Describes the photo of a chat.
   #
   # @attr small [TD::Types::File] A small (160x160) chat photo.
+  #   The file can be downloaded only before the photo is changed.
   # @attr big [TD::Types::File] A big (640x640) chat photo.
+  #   The file can be downloaded only before the photo is changed.
   class ChatPhoto < Base
     attribute :small, TD::Types::File
     attribute :big, TD::Types::File

data/lib/tdlib/types/chat_report_reason.rb

@@ -5,6 +5,7 @@ module TD::Types
       spam
       violence
       pornography
+      child_abuse
       copyright
       custom
     ].each do |type|

data/lib/tdlib/types/chat_report_reason/child_abuse.rb

@@ -0,0 +1,5 @@
+module TD::Types
+  # The chat has child abuse related content.
+  class ChatReportReason::ChildAbuse < ChatReportReason
+  end
+end

data/lib/tdlib/types/check_chat_username_result/public_chats_too_much.rb

@@ -1,5 +1,5 @@
 module TD::Types
-  # The user has too much public chats, one of them should be made private first.
+  # The user has too much chats with username, one of them should be made private first.
   class CheckChatUsernameResult::PublicChatsTooMuch < CheckChatUsernameResult
   end
 end

data/lib/tdlib/types/connection_state/waiting_for_network.rb

@@ -1,6 +1,6 @@
 module TD::Types
   # Currently waiting for the network to become available.
-  # Use SetNetworkType to change the available network type.
+  # Use setNetworkType to change the available network type.
   class ConnectionState::WaitingForNetwork < ConnectionState
   end
 end

data/lib/tdlib/types/database_statistics.rb

@@ -0,0 +1,8 @@
+module TD::Types
+  # Contains database statistics.
+  #
+  # @attr statistics [String] Database statistics in an unspecified human-readable format.
+  class DatabaseStatistics < Base
+    attribute :statistics, TD::Types::String
+  end
+end

data/lib/tdlib/types/device_token.rb

@@ -1,10 +1,10 @@
 module TD::Types
-  # Represents a data needed to subscribe for push notifications.
+  # Represents a data needed to subscribe for push notifications through registerDevice method.
   # To use specific push notification service, you must specify the correct application platform and upload valid
   #   server authentication data at https://my.telegram.org.
   class DeviceToken < Base
     %w[
-      google_cloud_messaging
+      firebase_cloud_messaging
       apple_push
       apple_push_vo_ip
       windows_push

data/lib/tdlib/types/device_token/apple_push_vo_ip.rb

@@ -3,8 +3,10 @@ module TD::Types
   #
   # @attr device_token [String, nil] Device token; may be empty to de-register a device.
   # @attr is_app_sandbox [Boolean] True, if App Sandbox is enabled.
+  # @attr encrypt [Boolean] True, if push notifications should be additionally encrypted.
   class DeviceToken::ApplePushVoIP < DeviceToken
     attribute :device_token, TD::Types::String.optional.default(nil)
     attribute :is_app_sandbox, TD::Types::Bool
+    attribute :encrypt, TD::Types::Bool
   end
 end

data/lib/tdlib/types/device_token/firebase_cloud_messaging.rb

@@ -0,0 +1,10 @@
+module TD::Types
+  # A token for Firebase Cloud Messaging.
+  #
+  # @attr token [String, nil] Device registration token; may be empty to de-register a device.
+  # @attr encrypt [Boolean] True, if push notifications should be additionally encrypted.
+  class DeviceToken::FirebaseCloudMessaging < DeviceToken
+    attribute :token, TD::Types::String.optional.default(nil)
+    attribute :encrypt, TD::Types::Bool
+  end
+end

data/lib/tdlib/types/document.rb

@@ -3,11 +3,14 @@ module TD::Types
   #
   # @attr file_name [String] Original name of the file; as defined by the sender.
   # @attr mime_type [String] MIME type of the file; as defined by the sender.
-  # @attr thumbnail [TD::Types::PhotoSize, nil] Document thumbnail; as defined by the sender; may be null.
+  # @attr minithumbnail [TD::Types::Minithumbnail, nil] Document minithumbnail; may be null.
+  # @attr thumbnail [TD::Types::PhotoSize, nil] Document thumbnail in JPEG or PNG format (PNG will be used only for
+  #   background patterns); as defined by the sender; may be null.
   # @attr document [TD::Types::File] File containing the document.
   class Document < Base
     attribute :file_name, TD::Types::String
     attribute :mime_type, TD::Types::String
+    attribute :minithumbnail, TD::Types::Minithumbnail.optional.default(nil)
     attribute :thumbnail, TD::Types::PhotoSize.optional.default(nil)
     attribute :document, TD::Types::File
   end

data/lib/tdlib/types/emojis.rb

@@ -0,0 +1,8 @@
+module TD::Types
+  # Represents a list of emoji.
+  #
+  # @attr emojis [Array<String>] List of emojis.
+  class Emojis < Base
+    attribute :emojis, TD::Types::Array.of(TD::Types::String)
+  end
+end

data/lib/tdlib/types/file_part.rb

@@ -0,0 +1,8 @@
+module TD::Types
+  # Contains a part of a file.
+  #
+  # @attr data [String] File bytes.
+  class FilePart < Base
+    attribute :data, TD::Types::String
+  end
+end

data/lib/tdlib/types/file_type/wallpaper.rb

@@ -1,5 +1,5 @@
 module TD::Types
-  # The file is a wallpaper.
+  # The file is a wallpaper or a background pattern.
   class FileType::Wallpaper < FileType
   end
 end

data/lib/tdlib/types/http_url.rb

@@ -0,0 +1,8 @@
+module TD::Types
+  # Contains an HTTP URL.
+  #
+  # @attr url [String] The URL.
+  class HttpUrl < Base
+    attribute :url, TD::Types::String
+  end
+end

data/lib/tdlib/types/inline_keyboard_button_type.rb

@@ -3,6 +3,7 @@ module TD::Types
   class InlineKeyboardButtonType < Base
     %w[
       url
+      login_url
       callback
       callback_game
       switch_inline

data/lib/tdlib/types/inline_keyboard_button_type/login_url.rb

@@ -0,0 +1,12 @@
+module TD::Types
+  # A button that opens a specified URL and automatically logs in in current user if they allowed to do that.
+  #
+  # @attr url [String] HTTP URL to open.
+  # @attr id [Integer] Unique button identifier.
+  # @attr forward_text [String] If non-empty, new text of the button in forwarded messages.
+  class InlineKeyboardButtonType::LoginUrl < InlineKeyboardButtonType
+    attribute :url, TD::Types::String
+    attribute :id, TD::Types::Integer
+    attribute :forward_text, TD::Types::String
+  end
+end

data/lib/tdlib/types/input_background.rb

@@ -0,0 +1,11 @@
+module TD::Types
+  # Contains information about background to set.
+  class InputBackground < Base
+    %w[
+      local
+      remote
+    ].each do |type|
+      autoload TD::Types.camelize(type), "tdlib/types/input_background/#{type}"
+    end
+  end
+end

data/lib/tdlib/types/input_background/local.rb

@@ -0,0 +1,10 @@
+module TD::Types
+  # A background from a local file.
+  #
+  # @attr background [TD::Types::InputFile] Background file to use.
+  #   Only {TD::Types::InputFile::Local} and {TD::Types::InputFile::Generated} are supported.
+  #   The file nust be in JPEG format for wallpapers and in PNG format for patterns.
+  class InputBackground::Local < InputBackground
+    attribute :background, TD::Types::InputFile
+  end
+end

data/lib/tdlib/types/input_background/remote.rb

@@ -0,0 +1,8 @@
+module TD::Types
+  # A background from the server.
+  #
+  # @attr background_id [Integer] The background identifier.
+  class InputBackground::Remote < InputBackground
+    attribute :background_id, TD::Types::Integer
+  end
+end

data/lib/tdlib/types/input_file/generated.rb

@@ -5,6 +5,7 @@ module TD::Types
   #   no such file.
   # @attr conversion [String] String specifying the conversion applied to the original file; should be persistent
   #   across application restarts.
+  #   Conversions beginning with '#' are reserved for internal TDLib usage.
   # @attr expected_size [Integer] Expected size of the generated file; 0 if unknown.
   class InputFile::Generated < InputFile
     attribute :original_path, TD::Types::String.optional.default(nil)

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

@@ -8,10 +8,11 @@ module TD::Types
   # @attr gif_duration [Integer] Duration of the GIF, in seconds.
   # @attr gif_width [Integer] Width of the GIF.
   # @attr gif_height [Integer] Height of the GIF.
-  # @attr reply_markup [TD::Types::ReplyMarkup::InlineKeyboard, nil] The message reply markup.
-  # @attr input_message_content [TD::Types::InputMessageContent::Text, TD::Types::InputMessageContent::Animation,
-  #   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, InputMessageAnimation, InputMessageLocation,
+  #   InputMessageVenue or InputMessageContact.
   class InputInlineQueryResult::AnimatedGif < InputInlineQueryResult
     attribute :id, TD::Types::String
     attribute :title, TD::Types::String

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

@@ -9,10 +9,11 @@ module TD::Types
   # @attr mpeg4_duration [Integer] Duration of the video, in seconds.
   # @attr mpeg4_width [Integer] Width of the video.
   # @attr mpeg4_height [Integer] Height of the video.
-  # @attr reply_markup [TD::Types::ReplyMarkup::InlineKeyboard, nil] The message reply markup.
-  # @attr input_message_content [TD::Types::InputMessageContent::Text, TD::Types::InputMessageContent::Animation,
-  #   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, InputMessageAnimation, InputMessageLocation,
+  #   InputMessageVenue or InputMessageContact.
   class InputInlineQueryResult::AnimatedMpeg4 < InputInlineQueryResult
     attribute :id, TD::Types::String
     attribute :title, TD::Types::String

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

@@ -9,10 +9,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::Article < InputInlineQueryResult
     attribute :id, TD::Types::String
     attribute :url, TD::Types::String

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

@@ -6,10 +6,11 @@ module TD::Types
   # @attr performer [String] Performer of the audio file.
   # @attr audio_url [String] The URL of the audio file.
   # @attr audio_duration [Integer] Audio file 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::Audio,
-  #   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, InputMessageAudio, InputMessageLocation, InputMessageVenue
+  #   or InputMessageContact.
   class InputInlineQueryResult::Audio < InputInlineQueryResult
     attribute :id, TD::Types::String
     attribute :title, TD::Types::String

data/lib/tdlib/types/input_inline_query_result/contact.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::Contact < InputInlineQueryResult
     attribute :id, TD::Types::String
     attribute :contact, TD::Types::Contact

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

@@ -10,10 +10,11 @@ module TD::Types
   # @attr thumbnail_url [String] The URL of the file thumbnail, if it exists.
   # @attr thumbnail_width [Integer] Width of the thumbnail.
   # @attr thumbnail_height [Integer] Height of the thumbnail.
-  # @attr reply_markup [TD::Types::ReplyMarkup::InlineKeyboard, nil] The message reply markup.
-  # @attr input_message_content [TD::Types::InputMessageContent::Text, TD::Types::InputMessageContent::Document,
-  #   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, InputMessageDocument, InputMessageLocation,
+  #   InputMessageVenue or InputMessageContact.
   class InputInlineQueryResult::Document < InputInlineQueryResult
     attribute :id, TD::Types::String
     attribute :title, TD::Types::String

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

@@ -3,7 +3,8 @@ module TD::Types
   #
   # @attr id [String] Unique identifier of the query result.
   # @attr game_short_name [String] Short name of the game.
-  # @attr reply_markup [TD::Types::ReplyMarkup::InlineKeyboard, nil] Message reply markup.
+  # @attr reply_markup [TD::Types::ReplyMarkup] Message reply markup.
+  #   Must be of type {TD::Types::ReplyMarkup::InlineKeyboard} or null.
   class InputInlineQueryResult::Game < InputInlineQueryResult
     attribute :id, TD::Types::String
     attribute :game_short_name, TD::Types::String

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

@@ -9,10 +9,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::Location < InputInlineQueryResult
     attribute :id, TD::Types::String
     attribute :location, TD::Types::Location