tdlib-ruby 2.0.0 → 2.1.0

data/lib/tdlib/types/message_forward_origin.rb

@@ -0,0 +1,12 @@
+module TD::Types
+  # Contains information about the origin of a forwarded message.
+  class MessageForwardOrigin < Base
+    %w[
+      user
+      hidden_user
+      channel
+    ].each do |type|
+      autoload TD::Types.camelize(type), "tdlib/types/message_forward_origin/#{type}"
+    end
+  end
+end

data/lib/tdlib/types/message_forward_origin/channel.rb

@@ -0,0 +1,12 @@
+module TD::Types
+  # The message was originally a post in a channel.
+  #
+  # @attr chat_id [Integer] Identifier of the chat from which the message was originally forwarded.
+  # @attr message_id [Integer] Message identifier of the original message; 0 if unknown.
+  # @attr author_signature [String] Original post author signature.
+  class MessageForwardOrigin::Channel < MessageForwardOrigin
+    attribute :chat_id, TD::Types::Integer
+    attribute :message_id, TD::Types::Integer
+    attribute :author_signature, TD::Types::String
+  end
+end

data/lib/tdlib/types/message_forward_origin/hidden_user.rb

@@ -0,0 +1,8 @@
+module TD::Types
+  # The message was originally written by a user, which is hidden by their privacy settings.
+  #
+  # @attr sender_name [String] Name of the sender.
+  class MessageForwardOrigin::HiddenUser < MessageForwardOrigin
+    attribute :sender_name, TD::Types::String
+  end
+end

data/lib/tdlib/types/message_forward_origin/user.rb

@@ -0,0 +1,8 @@
+module TD::Types
+  # The message was originally written by a known user.
+  #
+  # @attr sender_user_id [Integer] Identifier of the user that originally sent the message.
+  class MessageForwardOrigin::User < MessageForwardOrigin
+    attribute :sender_user_id, TD::Types::Integer
+  end
+end

data/lib/tdlib/types/message_link_info.rb

@@ -0,0 +1,14 @@
+module TD::Types
+  # Contains information about a link to a message in a chat.
+  #
+  # @attr is_public [Boolean] True, if the link is a public link for a message in a chat.
+  # @attr chat_id [Integer] If found, identifier of the chat to which the message belongs, 0 otherwise.
+  # @attr message [TD::Types::Message, nil] If found, the linked message; may be null.
+  # @attr for_album [Boolean] True, if the whole media album to which the message belongs is linked.
+  class MessageLinkInfo < Base
+    attribute :is_public, TD::Types::Bool
+    attribute :chat_id, TD::Types::Integer
+    attribute :message, TD::Types::Message.optional.default(nil)
+    attribute :for_album, TD::Types::Bool
+  end
+end

data/lib/tdlib/types/message_sending_state/failed.rb

@@ -1,5 +1,15 @@
 module TD::Types
   # The message failed to be sent.
+  #
+  # @attr error_code [Integer] An error code; 0 if unknown.
+  # @attr error_message [String] Error message.
+  # @attr can_retry [Boolean] True, if the message can be re-sent.
+  # @attr retry_after [Float] Time left before the message can be re-sent, in seconds.
+  #   No update is sent when this field changes.
   class MessageSendingState::Failed < MessageSendingState
+    attribute :error_code, TD::Types::Integer
+    attribute :error_message, TD::Types::String
+    attribute :can_retry, TD::Types::Bool
+    attribute :retry_after, TD::Types::Float
   end
 end

data/lib/tdlib/types/minithumbnail.rb

@@ -0,0 +1,12 @@
+module TD::Types
+  # Thumbnail image of a very poor quality and low resolution.
+  #
+  # @attr width [Integer] Thumbnail width, usually doesn't exceed 40.
+  # @attr height [Integer] Thumbnail height, usually doesn't exceed 40.
+  # @attr data [String] The thumbnail in JPEG format.
+  class Minithumbnail < Base
+    attribute :width, TD::Types::Integer
+    attribute :height, TD::Types::Integer
+    attribute :data, TD::Types::String
+  end
+end

data/lib/tdlib/types/notification.rb

@@ -0,0 +1,12 @@
+module TD::Types
+  # Contains information about a notification.
+  #
+  # @attr id [Integer] Unique persistent identifier of this notification.
+  # @attr date [Integer] Notification date.
+  # @attr type [TD::Types::NotificationType] Notification type.
+  class Notification < Base
+    attribute :id, TD::Types::Integer
+    attribute :date, TD::Types::Integer
+    attribute :type, TD::Types::NotificationType
+  end
+end

data/lib/tdlib/types/notification_group.rb

@@ -0,0 +1,16 @@
+module TD::Types
+  # Describes a group of notifications.
+  #
+  # @attr id [Integer] Unique persistent auto-incremented from 1 identifier of the notification group.
+  # @attr type [TD::Types::NotificationGroupType] Type of the group.
+  # @attr chat_id [Integer] Identifier of a chat to which all notifications in the group belong.
+  # @attr total_count [Integer] Total number of active notifications in the group.
+  # @attr notifications [Array<TD::Types::Notification>] The list of active notifications.
+  class NotificationGroup < Base
+    attribute :id, TD::Types::Integer
+    attribute :type, TD::Types::NotificationGroupType
+    attribute :chat_id, TD::Types::Integer
+    attribute :total_count, TD::Types::Integer
+    attribute :notifications, TD::Types::Array.of(TD::Types::Notification)
+  end
+end

data/lib/tdlib/types/notification_group_type.rb

@@ -0,0 +1,13 @@
+module TD::Types
+  # Describes type of notifications in the group.
+  class NotificationGroupType < Base
+    %w[
+      messages
+      mentions
+      secret_chat
+      calls
+    ].each do |type|
+      autoload TD::Types.camelize(type), "tdlib/types/notification_group_type/#{type}"
+    end
+  end
+end

data/lib/tdlib/types/notification_group_type/calls.rb

@@ -0,0 +1,5 @@
+module TD::Types
+  # A group containing notifications of type notificationTypeNewCall.
+  class NotificationGroupType::Calls < NotificationGroupType
+  end
+end

data/lib/tdlib/types/notification_group_type/mentions.rb

@@ -0,0 +1,6 @@
+module TD::Types
+  # A group containing notifications of type notificationTypeNewMessage and notificationTypeNewPushMessage with unread
+  #   mentions of the current user, replies to their messages, or a pinned message.
+  class NotificationGroupType::Mentions < NotificationGroupType
+  end
+end

data/lib/tdlib/types/notification_group_type/messages.rb

@@ -0,0 +1,6 @@
+module TD::Types
+  # A group containing notifications of type notificationTypeNewMessage and notificationTypeNewPushMessage with
+  #   ordinary unread messages.
+  class NotificationGroupType::Messages < NotificationGroupType
+  end
+end

data/lib/tdlib/types/notification_group_type/secret_chat.rb

@@ -0,0 +1,5 @@
+module TD::Types
+  # A group containing a notification of type notificationTypeNewSecretChat.
+  class NotificationGroupType::SecretChat < NotificationGroupType
+  end
+end

data/lib/tdlib/types/notification_settings_scope.rb

@@ -4,6 +4,7 @@ module TD::Types
     %w[
       private_chats
       group_chats
+      channel_chats
     ].each do |type|
       autoload TD::Types.camelize(type), "tdlib/types/notification_settings_scope/#{type}"
     end

data/lib/tdlib/types/notification_settings_scope/channel_chats.rb

@@ -0,0 +1,5 @@
+module TD::Types
+  # Notification settings applied to all channels when the corresponding chat setting has a default value.
+  class NotificationSettingsScope::ChannelChats < NotificationSettingsScope
+  end
+end

data/lib/tdlib/types/notification_settings_scope/group_chats.rb

@@ -1,6 +1,6 @@
 module TD::Types
-  # Notification settings applied to all basic groups, supergroups and channels when the corresponding chat setting has
-  #   a default value.
+  # Notification settings applied to all basic groups and supergroups when the corresponding chat setting has a default
+  #   value.
   class NotificationSettingsScope::GroupChats < NotificationSettingsScope
   end
 end

data/lib/tdlib/types/notification_type.rb

@@ -0,0 +1,13 @@
+module TD::Types
+  # Contains detailed information about a notification.
+  class NotificationType < Base
+    %w[
+      new_message
+      new_secret_chat
+      new_call
+      new_push_message
+    ].each do |type|
+      autoload TD::Types.camelize(type), "tdlib/types/notification_type/#{type}"
+    end
+  end
+end

data/lib/tdlib/types/notification_type/new_call.rb

@@ -0,0 +1,8 @@
+module TD::Types
+  # New call was received.
+  #
+  # @attr call_id [Integer] Call identifier.
+  class NotificationType::NewCall < NotificationType
+    attribute :call_id, TD::Types::Integer
+  end
+end

data/lib/tdlib/types/notification_type/new_message.rb

@@ -0,0 +1,8 @@
+module TD::Types
+  # New message was received.
+  #
+  # @attr message [TD::Types::Message] The message.
+  class NotificationType::NewMessage < NotificationType
+    attribute :message, TD::Types::Message
+  end
+end

data/lib/tdlib/types/notification_type/new_push_message.rb

@@ -0,0 +1,15 @@
+module TD::Types
+  # New message was received through a push notification.
+  #
+  # @attr message_id [Integer] The message identifier.
+  #   The message will not be available in the chat history, but the ID can be used in viewMessages and as
+  #   reply_to_message_id.
+  # @attr sender_user_id [Integer] Sender of the message.
+  #   Corresponding user may be inaccessible.
+  # @attr content [TD::Types::PushMessageContent] Push message content.
+  class NotificationType::NewPushMessage < NotificationType
+    attribute :message_id, TD::Types::Integer
+    attribute :sender_user_id, TD::Types::Integer
+    attribute :content, TD::Types::PushMessageContent
+  end
+end

data/lib/tdlib/types/notification_type/new_secret_chat.rb

@@ -0,0 +1,5 @@
+module TD::Types
+  # New secret chat was created.
+  class NotificationType::NewSecretChat < NotificationType
+  end
+end

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

@@ -1,5 +1,5 @@
 module TD::Types
-  # Boolean option.
+  # Represents a boolean option.
   #
   # @attr value [Boolean] The value of the option.
   class OptionValue::Boolean < OptionValue

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

@@ -1,5 +1,5 @@
 module TD::Types
-  # An unknown option or an option which has a default value.
+  # Represents an unknown option or an option which has a default value.
   class OptionValue::Empty < OptionValue
   end
 end

data/lib/tdlib/types/option_value/integer.rb

@@ -1,5 +1,5 @@
 module TD::Types
-  # An integer option.
+  # Represents an integer option.
   #
   # @attr value [Integer] The value of the option.
   class OptionValue::Integer < OptionValue

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

@@ -1,5 +1,5 @@
 module TD::Types
-  # A string option.
+  # Represents a string option.
   #
   # @attr value [String] The value of the option.
   class OptionValue::String < OptionValue

data/lib/tdlib/types/page_block.rb

@@ -7,6 +7,7 @@ module TD::Types
       author_date
       header
       subheader
+      kicker
       paragraph
       preformatted
       footer
@@ -25,6 +26,10 @@ module TD::Types
       collage
       slideshow
       chat_link
+      table
+      details
+      related_articles
+      map
     ].each do |type|
       autoload TD::Types.camelize(type), "tdlib/types/page_block/#{type}"
     end

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

@@ -2,11 +2,11 @@ module TD::Types
   # An animation.
   #
   # @attr animation [TD::Types::Animation, nil] Animation file; may be null.
-  # @attr caption [TD::Types::RichText] Animation caption.
+  # @attr caption [TD::Types::PageBlockCaption] Animation caption.
   # @attr need_autoplay [Boolean] True, if the animation should be played automatically.
   class PageBlock::Animation < PageBlock
     attribute :animation, TD::Types::Animation.optional.default(nil)
-    attribute :caption, TD::Types::RichText
+    attribute :caption, TD::Types::PageBlockCaption
     attribute :need_autoplay, TD::Types::Bool
   end
 end

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

@@ -2,9 +2,9 @@ module TD::Types
   # An audio file.
   #
   # @attr audio [TD::Types::Audio, nil] Audio file; may be null.
-  # @attr caption [TD::Types::RichText] Audio file caption.
+  # @attr caption [TD::Types::PageBlockCaption] Audio file caption.
   class PageBlock::Audio < PageBlock
     attribute :audio, TD::Types::Audio.optional.default(nil)
-    attribute :caption, TD::Types::RichText
+    attribute :caption, TD::Types::PageBlockCaption
   end
 end

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

@@ -2,9 +2,9 @@ module TD::Types
   # A block quote.
   #
   # @attr text [TD::Types::RichText] Quote text.
-  # @attr caption [TD::Types::RichText] Quote caption.
+  # @attr credit [TD::Types::RichText] Quote credit.
   class PageBlock::BlockQuote < PageBlock
     attribute :text, TD::Types::RichText
-    attribute :caption, TD::Types::RichText
+    attribute :credit, TD::Types::RichText
   end
 end

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

@@ -2,9 +2,9 @@ module TD::Types
   # A collage.
   #
   # @attr page_blocks [Array<TD::Types::PageBlock>] Collage item contents.
-  # @attr caption [TD::Types::RichText] Block caption.
+  # @attr caption [TD::Types::PageBlockCaption] Block caption.
   class PageBlock::Collage < PageBlock
     attribute :page_blocks, TD::Types::Array.of(TD::Types::PageBlock)
-    attribute :caption, TD::Types::RichText
+    attribute :caption, TD::Types::PageBlockCaption
   end
 end

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

@@ -0,0 +1,12 @@
+module TD::Types
+  # A collapsible block.
+  #
+  # @attr header [TD::Types::RichText] Always visible heading for the block.
+  # @attr page_blocks [Array<TD::Types::PageBlock>] Block contents.
+  # @attr is_open [Boolean] True, if the block is open by default.
+  class PageBlock::Details < PageBlock
+    attribute :header, TD::Types::RichText
+    attribute :page_blocks, TD::Types::Array.of(TD::Types::PageBlock)
+    attribute :is_open, TD::Types::Bool
+  end
+end

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

@@ -4,9 +4,9 @@ module TD::Types
   # @attr url [String, nil] Web page URL, if available.
   # @attr html [String] HTML-markup of the embedded page.
   # @attr poster_photo [TD::Types::Photo, nil] Poster photo, if available; may be null.
-  # @attr width [Integer] Block width.
-  # @attr height [Integer] Block height.
-  # @attr caption [TD::Types::RichText] Block caption.
+  # @attr width [Integer] Block width; 0 if unknown.
+  # @attr height [Integer] Block height; 0 if unknown.
+  # @attr caption [TD::Types::PageBlockCaption] Block caption.
   # @attr is_full_width [Boolean] True, if the block should be full width.
   # @attr allow_scrolling [Boolean] True, if scrolling should be allowed.
   class PageBlock::Embedded < PageBlock
@@ -15,7 +15,7 @@ module TD::Types
     attribute :poster_photo, TD::Types::Photo.optional.default(nil)
     attribute :width, TD::Types::Integer
     attribute :height, TD::Types::Integer
-    attribute :caption, TD::Types::RichText
+    attribute :caption, TD::Types::PageBlockCaption
     attribute :is_full_width, TD::Types::Bool
     attribute :allow_scrolling, TD::Types::Bool
   end

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

@@ -3,16 +3,16 @@ module TD::Types
   #
   # @attr url [String] Web page URL.
   # @attr author [String] Post author.
-  # @attr author_photo [TD::Types::Photo] Post author photo.
+  # @attr author_photo [TD::Types::Photo, nil] Post author photo; may be null.
   # @attr date [Integer] Point in time (Unix timestamp) when the post was created; 0 if unknown.
   # @attr page_blocks [Array<TD::Types::PageBlock>] Post content.
-  # @attr caption [TD::Types::RichText] Post caption.
+  # @attr caption [TD::Types::PageBlockCaption] Post caption.
   class PageBlock::EmbeddedPost < PageBlock
     attribute :url, TD::Types::String
     attribute :author, TD::Types::String
-    attribute :author_photo, TD::Types::Photo
+    attribute :author_photo, TD::Types::Photo.optional.default(nil)
     attribute :date, TD::Types::Integer
     attribute :page_blocks, TD::Types::Array.of(TD::Types::PageBlock)
-    attribute :caption, TD::Types::RichText
+    attribute :caption, TD::Types::PageBlockCaption
   end
 end

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

@@ -0,0 +1,8 @@
+module TD::Types
+  # A kicker.
+  #
+  # @attr kicker [TD::Types::RichText] Kicker.
+  class PageBlock::Kicker < PageBlock
+    attribute :kicker, TD::Types::RichText
+  end
+end

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

@@ -1,10 +1,8 @@
 module TD::Types
-  # A list of texts.
+  # A list of data blocks.
   #
-  # @attr items [Array<TD::Types::RichText>] Texts.
-  # @attr is_ordered [Boolean] True, if the items should be marked with numbers.
+  # @attr items [Array<TD::Types::PageBlockListItem>] The items of the list.
   class PageBlock::List < PageBlock
-    attribute :items, TD::Types::Array.of(TD::Types::RichText)
-    attribute :is_ordered, TD::Types::Bool
+    attribute :items, TD::Types::Array.of(TD::Types::PageBlockListItem)
   end
 end