telegem 3.5.0 → 3.6.0

data/lib/api/client.rb

@@ -1,11 +1,112 @@
-require 'async/http'
-require 'json'
+require "async/http"
+require "json"
+require "logger"
+require "securerandom"
+require "stringio"
+require "tempfile"
 
 module Telegem
   module API
+    class MultipartForm
+      CRLF = "\r\n"
+
+      attr_reader :content_type
+
+      def initialize
+        @boundary = "----telegem#{SecureRandom.hex(16)}"
+        @content_type = "multipart/form-data; boundary=#{@boundary}"
+        @parts = []
+      end
+
+      def add(name, value)
+        if file?(value)
+          append_file(name, value)
+        else
+          append_field(name, value.to_s)
+        end
+      end
+
+      def body
+        String.new.tap do |buffer|
+          @parts.each do |part|
+            buffer << "--#{@boundary}#{CRLF}"
+            buffer << part
+            buffer << CRLF
+          end
+
+          buffer << "--#{@boundary}--#{CRLF}"
+        end
+      end
+
+      private
+
+      def append_field(name, value)
+        @parts << <<~PART.gsub("\n", CRLF)
+          Content-Disposition: form-data; name="#{name}"
+
+          #{value}
+        PART
+      end
+
+      def append_file(name, value)
+        io =
+          case value
+          when String
+            File.open(value, "rb")
+          else
+            value
+          end
+
+        filename =
+          if io.respond_to?(:path) && io.path
+            File.basename(io.path)
+          else
+            "upload.bin"
+          end
+
+        mime =
+          case File.extname(filename).downcase
+          when ".jpg", ".jpeg"
+            "image/jpeg"
+          when ".png"
+            "image/png"
+          when ".gif"
+            "image/gif"
+          when ".webp"
+            "image/webp"
+          when ".mp4"
+            "video/mp4"
+          when ".mp3"
+            "audio/mpeg"
+          when ".ogg"
+            "audio/ogg"
+          when ".pdf"
+            "application/pdf"
+          else
+            "application/octet-stream"
+          end
+
+        @parts << String.new.tap do |part|
+          part << %(Content-Disposition: form-data; name="#{name}"; filename="#{filename}") << CRLF
+          part << "Content-Type: #{mime}" << CRLF
+          part << CRLF
+          part << io.read
+        end
+
+        io.close if value.is_a?(String)
+      end
+
+      def file?(obj)
+        obj.is_a?(File) ||
+          obj.is_a?(Tempfile) ||
+          obj.is_a?(StringIO) ||
+          (obj.is_a?(String) && File.file?(obj))
+      end
+    end
+
     class Client
-      BASE_URL = 'https://api.telegram.org'
-      
+      BASE_URL = "https://api.telegram.org"
+
       attr_reader :token, :logger
 
       def initialize(token, **options)
@@ -13,20 +114,21 @@ module Telegem
         @logger = options[:logger] || Logger.new($stdout)
         @timeout = options[:timeout] || 30
         @retries = options[:retries] || 3
-        @retry_delay = options[:retry_delay] || 1  # seconds
-        
+        @retry_delay = options[:retry_delay] || 1
+
         @endpoint = Async::HTTP::Endpoint.parse(BASE_URL, timeout: @timeout)
         @client = Async::HTTP::Client.new(@endpoint)
       end
-      
+
       def call(method, params = {})
         with_retry do
           make_request(method, params)
         end
       end
-      
+
       def call!(method, params = {}, &callback)
         return unless callback
+
         begin
           result = call(method, params)
           callback.call(result, nil)
@@ -34,38 +136,45 @@ module Telegem
           callback.call(nil, error)
         end
       end
-      
+
       def upload(method, params)
         with_retry do
           url = "/bot#{@token}/#{method}"
-          
-          body = Async::HTTP::Body::Multipart.new
-          
+
+          form = MultipartForm.new
+
           params.each do |key, value|
-            if file_object?(value)
-              body.add(key.to_s, value, filename: File.basename(value))
-            else
-              body.add(key.to_s, value.to_s)
-            end
+            form.add(key.to_s, value)
           end
-          
-          response = @client.post(url, {}, body)
+
+          body = form.body
+
+          response = @client.post(
+            url,
+            {
+              "content-type" => form.content_type,
+              "content-length" => body.bytesize.to_s
+            },
+            body
+          )
+
           handle_response(response)
         end
       end
-      
+
       def download(file_id, destination_path = nil)
         with_retry do
-          file_info = call('getFile', file_id: file_id)
-          return nil unless file_info && file_info['file_path']
-          
-          file_path = file_info['file_path']
+          file_info = call("getFile", file_id: file_id)
+          return nil unless file_info && file_info["file_path"]
+
+          file_path = file_info["file_path"]
           download_url = "/file/bot#{@token}/#{file_path}"
-          
+
           response = @client.get(download_url)
-          
+
           if response.status == 200
             content = response.read
+
             if destination_path
               File.binwrite(destination_path, content)
               destination_path
@@ -77,78 +186,90 @@ module Telegem
           end
         end
       end
-      
+
       def get_updates(offset: nil, timeout: 30, limit: 100, allowed_updates: nil)
-        params = { timeout: timeout, limit: limit }
+        params = {
+          timeout: timeout,
+          limit: limit
+        }
+
         params[:offset] = offset if offset
         params[:allowed_updates] = allowed_updates if allowed_updates
-        call('getUpdates', params)
+
+        call("getUpdates", params)
       end
-      
+
       def close
         @client.close
       end
-      
+
       private
-      
-      def with_retry(&block)
+
+      def with_retry
         retries = 0
+
         begin
-          block.call
+          yield
         rescue NetworkError, Async::TimeoutError => e
           retries += 1
+
           if retries <= @retries
             @logger.warn("API request failed: #{e.message}. Retry #{retries}/#{@retries}") if @logger
-            sleep @retry_delay * retries  # exponential backoff
+            sleep(@retry_delay * retries)
             retry
           else
             raise
           end
-        rescue APIError => e
-          # Don't retry API errors (bad request, unauthorized, etc.)
+        rescue APIError
           raise
         end
       end
-      
+
       def make_request(method, params)
         url = "/bot#{@token}/#{method}"
-        @logger.debug("Api call #{method}") if @logger
-        
+
+        @logger.debug("API call #{method}") if @logger
+
         response = @client.post(
           url,
-          { 'content-type' => 'application/json' },
+          {
+            "content-type" => "application/json"
+          },
           JSON.dump(params.compact)
         )
-        
+
         handle_response(response)
       end
-      
+
       def handle_response(response)
         json = JSON.parse(response.read)
-        
-        if json && json['ok']
-          json['result']
+
+        if json["ok"]
+          json["result"]
         else
-          error_msg = json ? json['description'] : "HTTP #{response.status} - Empty response"
+          error_msg = json["description"] || "HTTP #{response.status}"
           raise APIError.new(error_msg, response.status)
         end
       end
-      
+
       def file_object?(obj)
-        obj.is_a?(File) || obj.is_a?(StringIO) || obj.is_a?(Tempfile) ||
-          (obj.is_a?(String) && File.exist?(obj))
+        obj.is_a?(File) ||
+          obj.is_a?(StringIO) ||
+          obj.is_a?(Tempfile) ||
+          (obj.is_a?(String) && File.file?(obj))
       end
     end
-    
+
     class APIError < StandardError
       attr_reader :code
-      
+
       def initialize(message, code = nil)
         super(message)
         @code = code
       end
     end
-    
-    class NetworkError < APIError; end
+
+    class NetworkError < APIError
+    end
   end
-end
+end

data/lib/api/types.rb

@@ -53,10 +53,7 @@ module Telegem
         elsif @_raw_data.key?(camel_key)
           define_singleton_method(name) { @_raw_data[camel_key] }
         else
-          define_singleton_method(name) do
-            raise NoMethodError,
-                  "undefined method `#{name}' for #{self.class} with keys: #{@_raw_data.keys}"
-          end
+          define_singleton_method(name) { nil } 
         end
 
         @_accessors_defined[name] = true

data/lib/core/context.rb

@@ -124,6 +124,62 @@ module Telegem
         params = { chat_id: chat.id, text: text }.merge(options)
         @bot.api.call('sendMessage', params)
       end
+
+      def reply_rich(rich_message, **options)
+       return nil unless chat
+  
+       params = { chat_id: chat.id, rich_message: rich_message }.merge(options)
+       @bot.api.call('sendRichMessage', params)
+      end
+
+      # Draft streaming support (Bot API 10.1)
+def start_draft(initial_text = "", **options)
+  return nil unless chat
+  
+  draft_id = "draft_#{chat.id}_#{Time.now.to_i}_#{rand(1000)}"
+  session[:telegem_draft_id] = draft_id
+  
+  rich_message = { blocks: [{ type: "paragraph", content: initial_text }] }
+  params = { chat_id: chat.id, draft_id: draft_id, rich_message: rich_message }.merge(options)
+  @bot.api.call('sendRichMessageDraft', params)
+  
+  draft_id
+end
+
+def append_to_draft(draft_id = nil, content, **options)
+  return nil unless chat
+  
+  draft_id ||= session[:telegem_draft_id]
+  return nil unless draft_id
+  
+  rich_message = { blocks: [{ type: "paragraph", content: content }] }
+  params = { chat_id: chat.id, draft_id: draft_id, rich_message: rich_message }.merge(options)
+  @bot.api.call('sendRichMessageDraft', params)
+end
+
+def publish_draft(draft_id = nil, **options)
+  return nil unless chat
+  
+  draft_id ||= session[:telegem_draft_id]
+  return nil unless draft_id
+  
+  params = { chat_id: chat.id, draft_id: draft_id }.merge(options)
+  result = @bot.api.call('publishRichMessageDraft', params)
+  session.delete(:telegem_draft_id)
+  result
+end
+
+def cancel_draft(draft_id = nil, **options)
+  return nil unless chat
+  
+  draft_id ||= session[:telegem_draft_id]
+  return nil unless draft_id
+  
+  params = { chat_id: chat.id, draft_id: draft_id }.merge(options)
+  result = @bot.api.call('cancelRichMessageDraft', params)
+  session.delete(:telegem_draft_id)
+  result
+end
       
       def edit_message_text(text, **options)
         return nil unless message && chat

data/lib/telegem.rb

@@ -3,7 +3,7 @@ require 'logger'
 require 'json'
 
 module Telegem
-  VERSION = "3.5.0"
+  VERSION = "3.6.0"
 end
 
 #

data/lib/webhook/server.rb

@@ -104,28 +104,38 @@ module Telegem
       end
 
       def handle_request(request)
-        case request.path
-        when @secret_token, "/#{@secret_token}"
-          handle_webhook_request(request)
-        when '/health', '/healthz'
-          health_endpoint(request)
-        else
-          [404, {}, ["Not Found"]]
+        begin
+          case request.path
+          when @secret_token, "/#{@secret_token}"
+            handle_webhook_request(request)
+          when '/health', '/healthz'
+            health_endpoint(request)
+          else
+            [404, {}, ["Not Found"]]
+          end
+        rescue => e
+          @logger.error("Request handler error: #{e.class} - #{e.message}\n#{e.backtrace.join("\n")}")
+          [500, {}, ["Internal Server Error"]]
         end
       end
 
       def handle_webhook_request(request)
         return [405, {}, ["Method Not Allowed"]] unless request.post?
+        
         received = request.headers['X-Telegram-Bot-Api-Secret-Token'] ||
-           request.headers['x-telegram-bot-api-secret-token']
-        return [403, {}, ["Forbidden"]] unless received  == @secret_token
+                   request.headers['x-telegram-bot-api-secret-token']
+        return [403, {}, ["Forbidden"]] unless received == @secret_token
 
         begin
           body = request.body.read
-          update_data = JSON.parse(body)
-           process_webhook_update(update_data) 
+          update_data = json_to_symbols(JSON.parse(body))
+          process_webhook_update(update_data)
           [200, {}, ["OK"]]
-        rescue
+        rescue JSON::ParserError => e
+          @logger.error("JSON parse error: #{e}")
+          [400, {}, ["Bad Request"]]
+        rescue => e
+          @logger.error("Webhook handler error: #{e.class} - #{e.message}")
           [500, {}, ["Internal Server Error"]]
         end
       end
@@ -137,11 +147,12 @@ module Telegem
       end
 
       def health_endpoint(request)
-        [200, { 'Content-Type' => 'application/json' }, [{
+        body = {
           status: 'ok',
           mode: @ssl_mode.to_s,
           ssl: @ssl_mode != :none
-        }.to_json]]
+        }.to_json
+        [200, { 'Content-Type' => 'application/json' }, [body]]
       end
 
       def stop
@@ -183,6 +194,17 @@ module Telegem
       def running?
         @running
       end
+
+      def json_to_symbols(obj)
+         case obj
+           when Hash
+            obj.transform_keys { |k| k.to_sym }.transform_values { |v| json_to_symbols(v) }
+           when Array
+            obj.map { |v| json_to_symbols(v) }
+           else
+            obj
+          end
+      end
     end
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: telegem
 version: !ruby/object:Gem::Version
-  version: 3.5.0
+  version: 3.6.0
 platform: ruby
 authors:
 - zendrx
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-05-13 00:00:00.000000000 Z
+date: 2026-06-29 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: securerandom
@@ -44,14 +44,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.92.1
+        version: '0.8'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.92.1
+        version: '0.8'
 - !ruby/object:Gem::Dependency
   name: pdf-reader
   requirement: !ruby/object:Gem::Requirement
@@ -108,6 +108,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '1.50'
+- !ruby/object:Gem::Dependency
+  name: logger
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.6'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.6'
 description: |
   Telegem is a modern Telegram Bot Framework for Ruby inspired by Telegraf.js.
   Built with async-first design using async-http, featuring scenes, middleware,
@@ -119,14 +133,14 @@ executables:
 extensions: []
 extra_rdoc_files: []
 files:
+- ".anv"
 - ".rubocop.yml"
 - CHANGELOG.md
-- CODE_OF_CONDUCT.md
 - Gemfile
-- Gemfile.lock
 - LICENSE
 - README.md
 - Starts_HallofFame.md
+- _config.yml
 - assets/.gitkeep
 - assets/logo.png
 - bin/.gitkeep
@@ -186,7 +200,7 @@ metadata:
   documentation_uri: https://github.com/slick-lab/telegem/tree/main/docs
   rubygems_mfa_required: 'false'
 post_install_message: |
-  Thanks for installing Telegem 3.5.0!
+  Thanks for installing Telegem 3.6.0!
 
   Documentation: https://github.com/slick-lab/telegem
 
@@ -203,7 +217,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 3.1.0
+      version: 3.2.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="

data/CODE_OF_CONDUCT.md

@@ -1,13 +0,0 @@
-# Contributor Covenant Code of Conduct
-
-## Our Pledge
-We pledge to make participation in our project a harassment-free experience for everyone...
-
-## Our Standards
-Examples of behavior that contributes to a positive environment...
-
-## Enforcement
-Instances of abusive, harassing, or otherwise unacceptable behavior may be reported...
-
-## Attribution
-This Code of Conduct is adapted from the [Contributor Covenant](https://www.contributor-covenant.org)...

data/Gemfile.lock

@@ -1,11 +0,0 @@
-GEM
-  remote: https://rubygems.org/
-  specs:
-
-PLATFORMS
-  x86_64-linux
-
-DEPENDENCIES
-
-BUNDLED WITH
-   2.4.10