telegram-bot-ruby 2.4.0 → 2.6.0

data/lib/telegram/bot/types/story_area_type_link.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module Telegram
+  module Bot
+    module Types
+      class StoryAreaTypeLink < Base
+        attribute :type, Types::String.constrained(eql: 'link').default('link')
+        attribute :url, Types::String
+      end
+    end
+  end
+end

data/lib/telegram/bot/types/story_area_type_location.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module Telegram
+  module Bot
+    module Types
+      class StoryAreaTypeLocation < Base
+        attribute :type, Types::String.constrained(eql: 'location').default('location')
+        attribute :latitude, Types::Float
+        attribute :longitude, Types::Float
+        attribute? :address, LocationAddress
+      end
+    end
+  end
+end

data/lib/telegram/bot/types/story_area_type_suggested_reaction.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module Telegram
+  module Bot
+    module Types
+      class StoryAreaTypeSuggestedReaction < Base
+        attribute :type, Types::String.constrained(eql: 'suggested_reaction').default('suggested_reaction')
+        attribute :reaction_type, ReactionType
+        attribute? :is_dark, Types::Bool
+        attribute? :is_flipped, Types::Bool
+      end
+    end
+  end
+end

data/lib/telegram/bot/types/story_area_type_unique_gift.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module Telegram
+  module Bot
+    module Types
+      class StoryAreaTypeUniqueGift < Base
+        attribute :type, Types::String.constrained(eql: 'unique_gift').default('unique_gift')
+        attribute :name, Types::String
+      end
+    end
+  end
+end

data/lib/telegram/bot/types/story_area_type_weather.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module Telegram
+  module Bot
+    module Types
+      class StoryAreaTypeWeather < Base
+        attribute :type, Types::String.constrained(eql: 'weather').default('weather')
+        attribute :temperature, Types::Float
+        attribute :emoji, Types::String
+        attribute :background_color, Types::Integer
+      end
+    end
+  end
+end

data/lib/telegram/bot/types/suggested_post_approval_failed.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module Telegram
+  module Bot
+    module Types
+      class SuggestedPostApprovalFailed < Base
+        attribute? :suggested_post_message, Message
+        attribute :price, SuggestedPostPrice
+      end
+    end
+  end
+end

data/lib/telegram/bot/types/suggested_post_approved.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Telegram
+  module Bot
+    module Types
+      class SuggestedPostApproved < Base
+        attribute? :suggested_post_message, Message
+        attribute? :price, SuggestedPostPrice
+        attribute :send_date, Types::Integer
+      end
+    end
+  end
+end

data/lib/telegram/bot/types/suggested_post_declined.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module Telegram
+  module Bot
+    module Types
+      class SuggestedPostDeclined < Base
+        attribute? :suggested_post_message, Message
+        attribute? :comment, Types::String
+      end
+    end
+  end
+end

data/lib/telegram/bot/types/suggested_post_info.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Telegram
+  module Bot
+    module Types
+      class SuggestedPostInfo < Base
+        attribute :state, Types::String
+        attribute? :price, SuggestedPostPrice
+        attribute? :send_date, Types::Integer
+      end
+    end
+  end
+end

data/lib/telegram/bot/types/suggested_post_paid.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module Telegram
+  module Bot
+    module Types
+      class SuggestedPostPaid < Base
+        attribute? :suggested_post_message, Message
+        attribute :currency, Types::String
+        attribute? :amount, Types::Integer
+        attribute? :star_amount, StarAmount
+      end
+    end
+  end
+end

data/lib/telegram/bot/types/suggested_post_parameters.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module Telegram
+  module Bot
+    module Types
+      class SuggestedPostParameters < Base
+        attribute? :price, SuggestedPostPrice
+        attribute? :send_date, Types::Integer
+      end
+    end
+  end
+end

data/lib/telegram/bot/types/suggested_post_price.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module Telegram
+  module Bot
+    module Types
+      class SuggestedPostPrice < Base
+        attribute :currency, Types::String
+        attribute :amount, Types::Integer.constrained(min_size: 5, max_size: 100_000)
+      end
+    end
+  end
+end

data/lib/telegram/bot/types/suggested_post_refunded.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module Telegram
+  module Bot
+    module Types
+      class SuggestedPostRefunded < Base
+        attribute? :suggested_post_message, Message
+        attribute :reason, Types::String
+      end
+    end
+  end
+end

data/lib/telegram/bot/types/transaction_partner_user.rb

@@ -5,6 +5,7 @@ module Telegram
     module Types
       class TransactionPartnerUser < Base
         attribute :type, Types::String.constrained(eql: 'user').default('user')
+        attribute :transaction_type, Types::String
         attribute :user, User
         attribute? :affiliate, AffiliateInfo
         attribute? :invoice_payload, Types::String
@@ -12,6 +13,7 @@ module Telegram
         attribute? :paid_media, Types::Array.of(PaidMedia)
         attribute? :paid_media_payload, Types::String
         attribute? :gift, Gift
+        attribute? :premium_subscription_duration, Types::Integer
       end
     end
   end

data/lib/telegram/bot/types/unique_gift.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module Telegram
+  module Bot
+    module Types
+      class UniqueGift < Base
+        attribute :gift_id, Types::String
+        attribute :base_name, Types::String
+        attribute :name, Types::String
+        attribute :number, Types::Integer
+        attribute :model, UniqueGiftModel
+        attribute :symbol, UniqueGiftSymbol
+        attribute :backdrop, UniqueGiftBackdrop
+        attribute? :is_premium, Types::True
+        attribute? :is_burned, Types::True
+        attribute? :is_from_blockchain, Types::True
+        attribute? :colors, UniqueGiftColors
+        attribute? :publisher_chat, Chat
+      end
+    end
+  end
+end

data/lib/telegram/bot/types/unique_gift_backdrop.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Telegram
+  module Bot
+    module Types
+      class UniqueGiftBackdrop < Base
+        attribute :name, Types::String
+        attribute :colors, UniqueGiftBackdropColors
+        attribute :rarity_per_mille, Types::Integer
+      end
+    end
+  end
+end

data/lib/telegram/bot/types/unique_gift_backdrop_colors.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module Telegram
+  module Bot
+    module Types
+      class UniqueGiftBackdropColors < Base
+        attribute :center_color, Types::Integer
+        attribute :edge_color, Types::Integer
+        attribute :symbol_color, Types::Integer
+        attribute :text_color, Types::Integer
+      end
+    end
+  end
+end

data/lib/telegram/bot/types/unique_gift_colors.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module Telegram
+  module Bot
+    module Types
+      class UniqueGiftColors < Base
+        attribute :model_custom_emoji_id, Types::String
+        attribute :symbol_custom_emoji_id, Types::String
+        attribute :light_theme_main_color, Types::Integer
+        attribute :light_theme_other_colors, Types::Array.of(Types::Integer)
+        attribute :dark_theme_main_color, Types::Integer
+        attribute :dark_theme_other_colors, Types::Array.of(Types::Integer)
+      end
+    end
+  end
+end

data/lib/telegram/bot/types/unique_gift_info.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module Telegram
+  module Bot
+    module Types
+      class UniqueGiftInfo < Base
+        attribute :gift, UniqueGift
+        attribute :origin, Types::String
+        attribute? :last_resale_currency, Types::String
+        attribute? :last_resale_amount, Types::Integer
+        attribute? :owned_gift_id, Types::String
+        attribute? :transfer_star_count, Types::Integer
+        attribute? :next_transfer_date, Types::Integer
+      end
+    end
+  end
+end

data/lib/telegram/bot/types/unique_gift_model.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module Telegram
+  module Bot
+    module Types
+      class UniqueGiftModel < Base
+        attribute :name, Types::String
+        attribute :sticker, Sticker
+        attribute :rarity_per_mille, Types::Integer
+        attribute? :rarity, Types::String
+      end
+    end
+  end
+end

data/lib/telegram/bot/types/unique_gift_symbol.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Telegram
+  module Bot
+    module Types
+      class UniqueGiftSymbol < Base
+        attribute :name, Types::String
+        attribute :sticker, Sticker
+        attribute :rarity_per_mille, Types::Integer
+      end
+    end
+  end
+end

data/lib/telegram/bot/types/user.rb

@@ -17,6 +17,8 @@ module Telegram
         attribute? :supports_inline_queries, Types::Bool
         attribute? :can_connect_to_business, Types::Bool
         attribute? :has_main_web_app, Types::Bool
+        attribute? :has_topics_enabled, Types::Bool
+        attribute? :allows_users_to_create_topics, Types::Bool
       end
     end
   end

data/lib/telegram/bot/types/user_profile_audios.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module Telegram
+  module Bot
+    module Types
+      class UserProfileAudios < Base
+        attribute :total_count, Types::Integer
+        attribute :audios, Types::Array.of(Audio)
+      end
+    end
+  end
+end

data/lib/telegram/bot/types/user_rating.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module Telegram
+  module Bot
+    module Types
+      class UserRating < Base
+        attribute :level, Types::Integer
+        attribute :rating, Types::Integer
+        attribute :current_level_rating, Types::Integer
+        attribute? :next_level_rating, Types::Integer
+      end
+    end
+  end
+end

data/lib/telegram/bot/types/video.rb

@@ -12,6 +12,7 @@ module Telegram
         attribute? :thumbnail, PhotoSize
         attribute? :cover, Types::Array.of(PhotoSize)
         attribute? :start_timestamp, Types::Integer
+        attribute? :qualities, Types::Array.of(VideoQuality)
         attribute? :file_name, Types::String
         attribute? :mime_type, Types::String
         attribute? :file_size, Types::Integer

data/lib/telegram/bot/types/video_quality.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module Telegram
+  module Bot
+    module Types
+      class VideoQuality < Base
+        attribute :file_id, Types::String
+        attribute :file_unique_id, Types::String
+        attribute :width, Types::Integer
+        attribute :height, Types::Integer
+        attribute :codec, Types::String
+        attribute? :file_size, Types::Integer
+      end
+    end
+  end
+end

data/lib/telegram/bot/version.rb

@@ -2,6 +2,6 @@
 
 module Telegram
   module Bot
-    VERSION = '2.4.0'
+    VERSION = '2.6.0'
   end
 end

data/rakelib/builders/endpoints_builder.rb

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+require 'erb'
+
+module Builders
+  class EndpointsBuilder
+    attr_reader :methods, :templates_dir
+
+    def initialize(methods, templates_dir:)
+      @methods = methods.transform_values { |type| convert_to_types_format(type) }
+      @templates_dir = templates_dir
+    end
+
+    def build
+      template_path = File.join(templates_dir, 'endpoints.erb')
+      template = ERB.new(File.read(template_path), trim_mode: '-')
+
+      b = binding
+      b.local_variable_set(:methods, methods)
+
+      template.result(b)
+    end
+
+    private
+
+    def convert_to_types_format(type)
+      return convert_union_type(type) if type.include?(' | ')
+
+      convert_single_type(type)
+    end
+
+    def convert_union_type(type)
+      type.split(' | ').map { |t| convert_to_types_format(t.strip) }.join(' | ')
+    end
+
+    def convert_single_type(type)
+      return convert_array_type(type) if type.start_with?('Array<')
+
+      convert_primitive_type(type)
+    end
+
+    def convert_array_type(type)
+      inner_type = type.match(/Array<(.+)>/)[1]
+      "Types::Array.of(#{convert_to_types_format(inner_type)})"
+    end
+
+    def convert_primitive_type(type)
+      type == 'Boolean' ? 'Types::Bool' : "Types::#{type}"
+    end
+  end
+end

data/rakelib/builders/type_builder.rb

@@ -0,0 +1,140 @@
+# frozen_string_literal: true
+
+require 'erb'
+
+module Builders
+  class TypeBuilder
+    DRY_TYPES = %w[string integer float decimal array hash symbol boolean date date_time time range].freeze
+
+    attr_reader :name, :attributes, :templates_dir
+
+    def initialize(name, attributes, templates_dir:)
+      @name = name
+      @attributes = deep_dup(attributes)
+      @templates_dir = templates_dir
+    end
+
+    def build
+      if empty_type?
+        build_empty_type
+      else
+        build_full_type
+      end
+    end
+
+    def self.underscore(camel_cased_word)
+      camel_cased_word.to_s.gsub('::', '/')
+                      .gsub(/([A-Z]+)([A-Z][a-z])/, '\1_\2')
+                      .gsub(/([a-z\d])([A-Z])/, '\1_\2')
+                      .tr('-', '_')
+                      .downcase
+    end
+
+    private
+
+    def empty_type?
+      attributes[:type].is_a?(Array)
+    end
+
+    def build_empty_type
+      attrs = attributes[:type].join(" |\n        ")
+      render_template('empty_type.erb', name: name, attributes: attrs)
+    end
+
+    def build_full_type
+      process_attributes!
+      render_template('type.erb', name: name, attributes: attributes)
+    end
+
+    def process_attributes!
+      attributes.each_pair do |attr_name, properties|
+        process_attribute!(attr_name, properties)
+      end
+    end
+
+    def process_attribute!(attr_name, properties)
+      process_type!(attr_name, properties)
+      process_items!(attr_name, properties)
+
+      original_type = properties[:type]
+      apply_required!(attr_name, properties, original_type)
+      apply_min_max!(attr_name, properties)
+      apply_default!(attr_name, properties, original_type)
+
+      normalize_boolean_type!(attr_name)
+    end
+
+    def normalize_boolean_type!(attr_name)
+      attributes[attr_name][:type] = 'Types::True' if attributes[attr_name][:type] == 'Types::Boolean.default(true)'
+      attributes[attr_name][:type] = attributes[attr_name][:type].gsub('Types::Boolean', 'Types::Bool')
+    end
+
+    def process_type!(attr_name, properties)
+      attributes[attr_name][:type] = if properties[:type].is_a?(Array)
+                                       properties[:type].map { |t| add_module_types(t) }.join(' | ')
+                                     else
+                                       add_module_types(properties[:type])
+                                     end
+    end
+
+    def process_items!(attr_name, properties)
+      if properties[:items].is_a?(String)
+        attributes[attr_name][:type] += ".of(#{add_module_types(properties[:items])})"
+      elsif properties[:items] && properties[:items][:type] == 'array'
+        attributes[attr_name][:type] += ".of(Types::Array.of(#{properties[:items][:items]}))"
+      end
+    end
+
+    def apply_required!(attr_name, properties, original_type)
+      return unless properties[:required_value]
+
+      attributes[attr_name][:type] += ".constrained(eql: #{typecast(original_type, properties[:required_value])})"
+    end
+
+    def apply_min_max!(attr_name, properties)
+      return unless properties[:min_size] || properties[:max_size]
+
+      constrain = '.constrained(minmax)'
+      constrain = properties[:min_size] ? constrain.gsub('min', "min_size: #{properties[:min_size]}, ") : ''
+      constrain = constrain.gsub('max', "max_size: #{properties[:max_size]}") if properties[:max_size]
+      attributes[attr_name][:type] += constrain
+    end
+
+    def apply_default!(attr_name, properties, original_type)
+      return if properties[:default].nil?
+
+      attributes[attr_name][:type] += ".default(#{typecast(original_type, properties[:default])})"
+    end
+
+    def add_module_types(type)
+      return 'Types::Float' if type == 'number'
+
+      DRY_TYPES.include?(type) ? "Types::#{type.capitalize}" : type
+    end
+
+    def typecast(type, obj)
+      type == 'Types::String' ? "'#{obj}'" : obj
+    end
+
+    def render_template(template_name, vars)
+      template_path = File.join(templates_dir, template_name)
+      template = ERB.new(File.read(template_path))
+
+      # Create binding with the variables
+      b = binding
+      vars.each { |k, v| b.local_variable_set(k, v) }
+
+      template.result(b).gsub("      \n", '')
+    end
+
+    def deep_dup(hash)
+      hash.transform_values do |v|
+        case v
+        when Hash then deep_dup(v)
+        when Array then v.dup
+        else v
+        end
+      end
+    end
+  end
+end

data/rakelib/parse.rake

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+require 'json'
+require_relative 'parsers/types_parser'
+require_relative 'parsers/methods_parser'
+
+namespace :parse do
+  desc 'Parse types from Telegram Bot API HTML documentation'
+  task :types do
+    puts 'Parsing types from Telegram Bot API...'
+
+    result = Parsers::TypesParser.new.parse
+
+    puts "Found #{result.keys.count} types"
+
+    File.write "#{__dir__}/../data/types.json", JSON.pretty_generate(result)
+    puts 'Written to data/types.json'
+  end
+
+  desc 'Parse methods from Telegram Bot API HTML documentation'
+  task :methods do
+    puts 'Parsing methods from Telegram Bot API...'
+
+    result = Parsers::MethodsParser.new.parse
+
+    puts "Found #{result.keys.count} methods"
+
+    File.write "#{__dir__}/../data/methods.json", JSON.pretty_generate(result)
+    puts 'Written to data/methods.json'
+  end
+end