tdlib-ruby 2.0.0 → 2.1.0

data/lib/tdlib/types/animation.rb

@@ -7,6 +7,7 @@ module TD::Types
   # @attr height [Integer] Height of the animation.
   # @attr file_name [String] Original name of the file; as defined by the sender.
   # @attr mime_type [String] MIME type of the file, usually "image/gif" or "video/mp4".
+  # @attr minithumbnail [TD::Types::Minithumbnail, nil] Animation minithumbnail; may be null.
   # @attr thumbnail [TD::Types::PhotoSize, nil] Animation thumbnail; may be null.
   # @attr animation [TD::Types::File] File containing the animation.
   class Animation < Base
@@ -15,6 +16,7 @@ module TD::Types
     attribute :height, TD::Types::Integer
     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 :animation, TD::Types::File
   end

data/lib/tdlib/types/audio.rb

@@ -7,6 +7,7 @@ module TD::Types
   # @attr performer [String] Performer of the audio; as defined by the sender.
   # @attr file_name [String] Original name of the file; as defined by the sender.
   # @attr mime_type [String] The MIME type of the file; as defined by the sender.
+  # @attr album_cover_minithumbnail [TD::Types::Minithumbnail, nil] The minithumbnail of the album cover; may be null.
   # @attr album_cover_thumbnail [TD::Types::PhotoSize, nil] The thumbnail of the album cover; as defined by the sender.
   #   The full size thumbnail should be extracted from the downloaded file; may be null.
   # @attr audio [TD::Types::File] File containing the audio.
@@ -16,6 +17,7 @@ module TD::Types
     attribute :performer, TD::Types::String
     attribute :file_name, TD::Types::String
     attribute :mime_type, TD::Types::String
+    attribute :album_cover_minithumbnail, TD::Types::Minithumbnail.optional.default(nil)
     attribute :album_cover_thumbnail, TD::Types::PhotoSize.optional.default(nil)
     attribute :audio, TD::Types::File
   end

data/lib/tdlib/types/authorization_state.rb

@@ -6,6 +6,7 @@ module TD::Types
       wait_encryption_key
       wait_phone_number
       wait_code
+      wait_registration
       wait_password
       ready
       logging_out

data/lib/tdlib/types/authorization_state/wait_code.rb

@@ -1,13 +1,8 @@
 module TD::Types
-  # TDLib needs the user's authentication code to finalize authorization.
+  # TDLib needs the user's authentication code to authorize.
   #
-  # @attr is_registered [Boolean] True, if the user is already registered.
-  # @attr terms_of_service [TD::Types::TermsOfService, nil] Telegram terms of service, which should be accepted before
-  #   user can continue registration; may be null.
   # @attr code_info [TD::Types::AuthenticationCodeInfo] Information about the authorization code that was sent.
   class AuthorizationState::WaitCode < AuthorizationState
-    attribute :is_registered, TD::Types::Bool
-    attribute :terms_of_service, TD::Types::TermsOfService.optional.default(nil)
     attribute :code_info, TD::Types::AuthenticationCodeInfo
   end
 end

data/lib/tdlib/types/authorization_state/wait_password.rb

@@ -1,8 +1,8 @@
 module TD::Types
   # The user has been authorized, but needs to enter a password to start using the application.
   #
-  # @attr password_hint [String, nil] Hint for the password; can be empty.
-  # @attr has_recovery_email_address [Boolean] True if a recovery email address has been set up.
+  # @attr password_hint [String, nil] Hint for the password; may be empty.
+  # @attr has_recovery_email_address [Boolean] True, if a recovery email address has been set up.
   # @attr recovery_email_address_pattern [String, nil] Pattern of the email address to which the recovery email was
   #   sent; empty until a recovery email has been sent.
   class AuthorizationState::WaitPassword < AuthorizationState

data/lib/tdlib/types/authorization_state/wait_registration.rb

@@ -0,0 +1,9 @@
+module TD::Types
+  # The user is unregistered and need to accept terms of service and enter their first name and last name to finish
+  #   registration.
+  #
+  # @attr terms_of_service [TD::Types::TermsOfService] Telegram terms of service.
+  class AuthorizationState::WaitRegistration < AuthorizationState
+    attribute :terms_of_service, TD::Types::TermsOfService
+  end
+end

data/lib/tdlib/types/auto_download_settings.rb

@@ -0,0 +1,21 @@
+module TD::Types
+  # Contains auto-download settings.
+  #
+  # @attr is_auto_download_enabled [Boolean] True, if the auto-download is enabled.
+  # @attr max_photo_file_size [Integer] Maximum size of a photo file to be auto-downloaded.
+  # @attr max_video_file_size [Integer] Maximum size of a video file to be auto-downloaded.
+  # @attr max_other_file_size [Integer] Maximum size of other file types to be auto-downloaded.
+  # @attr preload_large_videos [Boolean] True, if the beginning of videos needs to be preloaded for instant playback.
+  # @attr preload_next_audio [Boolean] True, if the next audio track needs to be preloaded while the user is listening
+  #   to an audio file.
+  # @attr use_less_data_for_calls [Boolean] True, if "use less data for calls" option needs to be enabled.
+  class AutoDownloadSettings < Base
+    attribute :is_auto_download_enabled, TD::Types::Bool
+    attribute :max_photo_file_size, TD::Types::Integer
+    attribute :max_video_file_size, TD::Types::Integer
+    attribute :max_other_file_size, TD::Types::Integer
+    attribute :preload_large_videos, TD::Types::Bool
+    attribute :preload_next_audio, TD::Types::Bool
+    attribute :use_less_data_for_calls, TD::Types::Bool
+  end
+end

data/lib/tdlib/types/auto_download_settings_presets.rb

@@ -0,0 +1,15 @@
+module TD::Types
+  # Contains auto-download settings presets for the user.
+  #
+  # @attr low [TD::Types::AutoDownloadSettings] Preset with lowest settings; supposed to be used by default when
+  #   roaming.
+  # @attr medium [TD::Types::AutoDownloadSettings] Preset with medium settings; supposed to be used by default when
+  #   using mobile data.
+  # @attr high [TD::Types::AutoDownloadSettings] Preset with highest settings; supposed to be used by default when
+  #   connected on Wi-Fi.
+  class AutoDownloadSettingsPresets < Base
+    attribute :low, TD::Types::AutoDownloadSettings
+    attribute :medium, TD::Types::AutoDownloadSettings
+    attribute :high, TD::Types::AutoDownloadSettings
+  end
+end

data/lib/tdlib/types/background.rb

@@ -0,0 +1,19 @@
+module TD::Types
+  # Describes a chat background.
+  #
+  # @attr id [Integer] Unique background identifier.
+  # @attr is_default [Boolean] True, if this is one of default backgrounds.
+  # @attr is_dark [Boolean] True, if the background is dark and is recommended to be used with dark theme.
+  # @attr name [String] Unique background name.
+  # @attr document [TD::Types::Document, nil] Document with the background; may be null.
+  #   Null only for solid backgrounds.
+  # @attr type [TD::Types::BackgroundType] Type of the background.
+  class Background < Base
+    attribute :id, TD::Types::Integer
+    attribute :is_default, TD::Types::Bool
+    attribute :is_dark, TD::Types::Bool
+    attribute :name, TD::Types::String
+    attribute :document, TD::Types::Document.optional.default(nil)
+    attribute :type, TD::Types::BackgroundType
+  end
+end

data/lib/tdlib/types/background_type.rb

@@ -0,0 +1,12 @@
+module TD::Types
+  # Describes a type of a background.
+  class BackgroundType < Base
+    %w[
+      wallpaper
+      pattern
+      solid
+    ].each do |type|
+      autoload TD::Types.camelize(type), "tdlib/types/background_type/#{type}"
+    end
+  end
+end

data/lib/tdlib/types/background_type/pattern.rb

@@ -0,0 +1,12 @@
+module TD::Types
+  # A PNG pattern to be combined with the color chosen by the user.
+  #
+  # @attr is_moving [Boolean] True, if the background needs to be slightly moved when device is rotated.
+  # @attr color [Integer] Main color of the background in RGB24 format.
+  # @attr intensity [Integer] Intensity of the pattern when it is shown above the main background color, 0-100.
+  class BackgroundType::Pattern < BackgroundType
+    attribute :is_moving, TD::Types::Bool
+    attribute :color, TD::Types::Integer
+    attribute :intensity, TD::Types::Integer
+  end
+end

data/lib/tdlib/types/background_type/solid.rb

@@ -0,0 +1,8 @@
+module TD::Types
+  # A solid background.
+  #
+  # @attr color [Integer] A color of the background in RGB24 format.
+  class BackgroundType::Solid < BackgroundType
+    attribute :color, TD::Types::Integer
+  end
+end

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

@@ -0,0 +1,11 @@
+module TD::Types
+  # A wallpaper in JPEG format.
+  #
+  # @attr is_blurred [Boolean] True, if the wallpaper must be downscaled to fit in 450x450 square and then box-blurred
+  #   with radius 12.
+  # @attr is_moving [Boolean] True, if the background needs to be slightly moved when device is rotated.
+  class BackgroundType::Wallpaper < BackgroundType
+    attribute :is_blurred, TD::Types::Bool
+    attribute :is_moving, TD::Types::Bool
+  end
+end

data/lib/tdlib/types/backgrounds.rb

@@ -0,0 +1,8 @@
+module TD::Types
+  # Contains a list of backgrounds.
+  #
+  # @attr backgrounds [Array<TD::Types::Background>] A list of backgrounds.
+  class Backgrounds < Base
+    attribute :backgrounds, TD::Types::Array.of(TD::Types::Background)
+  end
+end

data/lib/tdlib/types/basic_group.rb

@@ -4,14 +4,12 @@ module TD::Types
   # @attr id [Integer] Group identifier.
   # @attr member_count [Integer] Number of members in the group.
   # @attr status [TD::Types::ChatMemberStatus] Status of the current user in the group.
-  # @attr everyone_is_administrator [Boolean] True, if all members have been granted administrator rights in the group.
   # @attr is_active [Boolean] True, if the group is active.
   # @attr upgraded_to_supergroup_id [Integer] Identifier of the supergroup to which this group was upgraded; 0 if none.
   class BasicGroup < Base
     attribute :id, TD::Types::Integer
     attribute :member_count, TD::Types::Integer
     attribute :status, TD::Types::ChatMemberStatus
-    attribute :everyone_is_administrator, TD::Types::Bool
     attribute :is_active, TD::Types::Bool
     attribute :upgraded_to_supergroup_id, TD::Types::Integer
   end

data/lib/tdlib/types/basic_group_full_info.rb

@@ -1,11 +1,13 @@
 module TD::Types
   # Contains full information about a basic group.
   #
+  # @attr description [String] Group description.
   # @attr creator_user_id [Integer] User identifier of the creator of the group; 0 if unknown.
   # @attr members [Array<TD::Types::ChatMember>] Group members.
   # @attr invite_link [String] Invite link for this group; available only for the group creator and only after it has
   #   been generated at least once.
   class BasicGroupFullInfo < Base
+    attribute :description, TD::Types::String
     attribute :creator_user_id, TD::Types::Integer
     attribute :members, TD::Types::Array.of(TD::Types::ChatMember)
     attribute :invite_link, TD::Types::String

data/lib/tdlib/types/call_problem.rb

@@ -0,0 +1,16 @@
+module TD::Types
+  # Describes the exact type of a problem with a call.
+  class CallProblem < Base
+    %w[
+      echo
+      noise
+      interruptions
+      distorted_speech
+      silent_local
+      silent_remote
+      dropped
+    ].each do |type|
+      autoload TD::Types.camelize(type), "tdlib/types/call_problem/#{type}"
+    end
+  end
+end

data/lib/tdlib/types/call_problem/distorted_speech.rb

@@ -0,0 +1,5 @@
+module TD::Types
+  # The speech was distorted.
+  class CallProblem::DistortedSpeech < CallProblem
+  end
+end

data/lib/tdlib/types/call_problem/dropped.rb

@@ -0,0 +1,5 @@
+module TD::Types
+  # The call ended unexpectedly.
+  class CallProblem::Dropped < CallProblem
+  end
+end

data/lib/tdlib/types/call_problem/echo.rb

@@ -0,0 +1,5 @@
+module TD::Types
+  # The user heard their own voice.
+  class CallProblem::Echo < CallProblem
+  end
+end

data/lib/tdlib/types/call_problem/interruptions.rb

@@ -0,0 +1,5 @@
+module TD::Types
+  # The other side kept disappearing.
+  class CallProblem::Interruptions < CallProblem
+  end
+end

data/lib/tdlib/types/call_problem/noise.rb

@@ -0,0 +1,5 @@
+module TD::Types
+  # The user heard background noise.
+  class CallProblem::Noise < CallProblem
+  end
+end

data/lib/tdlib/types/call_problem/silent_local.rb

@@ -0,0 +1,5 @@
+module TD::Types
+  # The user couldn't hear the other side.
+  class CallProblem::SilentLocal < CallProblem
+  end
+end

data/lib/tdlib/types/call_problem/silent_remote.rb

@@ -0,0 +1,5 @@
+module TD::Types
+  # The other side couldn't hear the user.
+  class CallProblem::SilentRemote < CallProblem
+  end
+end

data/lib/tdlib/types/call_state/ready.rb

@@ -6,11 +6,13 @@ module TD::Types
   # @attr config [String] A JSON-encoded call config.
   # @attr encryption_key [String] Call encryption key.
   # @attr emojis [Array<String>] Encryption key emojis fingerprint.
+  # @attr allow_p2p [Boolean] True, if peer-to-peer connection is allowed by users privacy settings.
   class CallState::Ready < CallState
     attribute :protocol, TD::Types::CallProtocol
     attribute :connections, TD::Types::Array.of(TD::Types::CallConnection)
     attribute :config, TD::Types::String
     attribute :encryption_key, TD::Types::String
     attribute :emojis, TD::Types::Array.of(TD::Types::String)
+    attribute :allow_p2p, TD::Types::Bool
   end
 end

data/lib/tdlib/types/chat.rb

@@ -6,6 +6,8 @@ module TD::Types
   # @attr type [TD::Types::ChatType] Type of the chat.
   # @attr title [String] Chat title.
   # @attr photo [TD::Types::ChatPhoto, nil] Chat photo; may be null.
+  # @attr permissions [TD::Types::ChatPermissions] Actions that non-administrator chat members are allowed to take in
+  #   the chat.
   # @attr last_message [TD::Types::Message, nil] Last message in the chat; may be null.
   # @attr order [Integer] Descending parameter by which chats are sorted in the main chat list.
   #   If the order number of two chats is the same, they must be sorted in descending order by ID.
@@ -13,6 +15,9 @@ module TD::Types
   # @attr is_pinned [Boolean] True, if the chat is pinned.
   # @attr is_marked_as_unread [Boolean] True, if the chat is marked as unread.
   # @attr is_sponsored [Boolean] True, if the chat is sponsored by the user's MTProxy server.
+  # @attr can_be_deleted_only_for_self [Boolean] True, if the chat messages can be deleted only for the current user
+  #   while other users will continue to see the messages.
+  # @attr can_be_deleted_for_all_users [Boolean] True, if the chat messages can be deleted for all users.
   # @attr can_be_reported [Boolean] True, if the chat can be reported to Telegram moderators through reportChat.
   # @attr default_disable_notification [Boolean] Default value of the disable_notification parameter, used when a
   #   message is sent to the chat.
@@ -21,6 +26,7 @@ module TD::Types
   # @attr last_read_outbox_message_id [Integer] Identifier of the last read outgoing message.
   # @attr unread_mention_count [Integer] Number of unread messages with a mention/reply in the chat.
   # @attr notification_settings [TD::Types::ChatNotificationSettings] Notification settings for this chat.
+  # @attr pinned_message_id [Integer] Identifier of the pinned message in the chat; 0 if none.
   # @attr reply_markup_message_id [Integer] Identifier of the message from which reply markup needs to be used; 0 if
   #   there is no default custom reply markup in the chat.
   # @attr draft_message [TD::Types::DraftMessage, nil] A draft of a message in the chat; may be null.
@@ -32,11 +38,14 @@ module TD::Types
     attribute :type, TD::Types::ChatType
     attribute :title, TD::Types::String
     attribute :photo, TD::Types::ChatPhoto.optional.default(nil)
+    attribute :permissions, TD::Types::ChatPermissions
     attribute :last_message, TD::Types::Message.optional.default(nil)
     attribute :order, TD::Types::Integer
     attribute :is_pinned, TD::Types::Bool
     attribute :is_marked_as_unread, TD::Types::Bool
     attribute :is_sponsored, TD::Types::Bool
+    attribute :can_be_deleted_only_for_self, TD::Types::Bool
+    attribute :can_be_deleted_for_all_users, TD::Types::Bool
     attribute :can_be_reported, TD::Types::Bool
     attribute :default_disable_notification, TD::Types::Bool
     attribute :unread_count, TD::Types::Integer
@@ -44,6 +53,7 @@ module TD::Types
     attribute :last_read_outbox_message_id, TD::Types::Integer
     attribute :unread_mention_count, TD::Types::Integer
     attribute :notification_settings, TD::Types::ChatNotificationSettings
+    attribute :pinned_message_id, TD::Types::Integer
     attribute :reply_markup_message_id, TD::Types::Integer
     attribute :draft_message, TD::Types::DraftMessage.optional.default(nil)
     attribute :client_data, TD::Types::String

data/lib/tdlib/types/chat_event_action.rb

@@ -4,6 +4,7 @@ module TD::Types
     %w[
       message_edited
       message_deleted
+      poll_stopped
       message_pinned
       message_unpinned
       member_joined
@@ -12,6 +13,7 @@ module TD::Types
       member_promoted
       member_restricted
       title_changed
+      permissions_changed
       description_changed
       username_changed
       photo_changed

data/lib/tdlib/types/chat_event_action/invites_toggled.rb

@@ -1,8 +1,8 @@
 module TD::Types
-  # The anyone_can_invite setting of a supergroup chat was toggled.
+  # The can_invite_users permission of a supergroup chat was toggled.
   #
-  # @attr anyone_can_invite [Boolean] New value of anyone_can_invite.
+  # @attr can_invite_users [Boolean] New value of can_invite_users permission.
   class ChatEventAction::InvitesToggled < ChatEventAction
-    attribute :anyone_can_invite, TD::Types::Bool
+    attribute :can_invite_users, TD::Types::Bool
   end
 end

data/lib/tdlib/types/chat_event_action/permissions_changed.rb

@@ -0,0 +1,10 @@
+module TD::Types
+  # The chat permissions was changed.
+  #
+  # @attr old_permissions [TD::Types::ChatPermissions] Previous chat permissions.
+  # @attr new_permissions [TD::Types::ChatPermissions] New chat permissions.
+  class ChatEventAction::PermissionsChanged < ChatEventAction
+    attribute :old_permissions, TD::Types::ChatPermissions
+    attribute :new_permissions, TD::Types::ChatPermissions
+  end
+end

data/lib/tdlib/types/chat_event_action/photo_changed.rb

@@ -1,10 +1,10 @@
 module TD::Types
   # The chat photo was changed.
   #
-  # @attr old_photo [TD::Types::ChatPhoto, nil] Previous chat photo value; may be null.
-  # @attr new_photo [TD::Types::ChatPhoto, nil] New chat photo value; may be null.
+  # @attr old_photo [TD::Types::Photo, nil] Previous chat photo value; may be null.
+  # @attr new_photo [TD::Types::Photo, nil] New chat photo value; may be null.
   class ChatEventAction::PhotoChanged < ChatEventAction
-    attribute :old_photo, TD::Types::ChatPhoto.optional.default(nil)
-    attribute :new_photo, TD::Types::ChatPhoto.optional.default(nil)
+    attribute :old_photo, TD::Types::Photo.optional.default(nil)
+    attribute :new_photo, TD::Types::Photo.optional.default(nil)
   end
 end

data/lib/tdlib/types/chat_event_action/poll_stopped.rb

@@ -0,0 +1,8 @@
+module TD::Types
+  # A poll in a message was stopped.
+  #
+  # @attr message [TD::Types::Message] The message with the poll.
+  class ChatEventAction::PollStopped < ChatEventAction
+    attribute :message, TD::Types::Message
+  end
+end

data/lib/tdlib/types/chat_invite_link_info.rb

@@ -7,7 +7,7 @@ module TD::Types
   # @attr photo [TD::Types::ChatPhoto, nil] Chat photo; may be null.
   # @attr member_count [Integer] Number of members.
   # @attr member_user_ids [Array<Integer>] User identifiers of some chat members that may be known to the current user.
-  # @attr is_public [Boolean] True, if the chat is a public supergroup or channel with a username.
+  # @attr is_public [Boolean] True, if the chat is a public supergroup or a channel with a username.
   class ChatInviteLinkInfo < Base
     attribute :chat_id, TD::Types::Integer
     attribute :type, TD::Types::ChatType