telegem 2.0.0 → 2.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c55866ecfc21045fd47141b991f00a209cecd5c866fe52b73c2ffb302f0245ea
-  data.tar.gz: 0a0e93a2c61487e759ecbc1e3ed2f86b1e77fbd993076acbebc6287f36584a52
+  metadata.gz: ac41d0622154fd92c57bbd5b86a6d5209914233e1be586180f399912d093f0ea
+  data.tar.gz: 6225d0dd673a63b03d595a58c4260f462c12ac63715338bc8c95413ed69b9e86
 SHA512:
-  metadata.gz: 791184d5d43c592bbd66b844386112bd336ee4a7ab7bcfe30ce08eaca3a30f53eb819642c9ba5640084c4d17f91b81cee11cf006c4537175e2b86db2420c6db8
-  data.tar.gz: 668eb8f1b6b3e5d3d2280fb2000e545836fa53af096ab6af89b87560b7484bee51a3be8360dbfe989966423c69ea0a916cb5f40f99862c19a47205d8880d8570
+  metadata.gz: 9f1aa5e8fc79c6198afe4a5c47fdd53b3c947b4fd48c8cb3ec6f96bc3320201d152645c00ab63a0568fb242e95106455bd95b904e57adf26c682a00b44a971c3
+  data.tar.gz: 4355cd40167abbe6593a65fe2e736190a16aefde8b541b8cd679950a9cd10e5d764c9a72de328cce4f3439694875cf29e54d077169a5a47406a88cab3dae384d

data/lib/api/client.rb

@@ -1,4 +1,4 @@
-# lib/api/client.rb - V2.0.0 (ASYNC-FIRST, NON-BLOCKING)
+# lib/api/client.rb - V2.0.0 (FIXED)
 require 'httpx'
 require 'json'
 
@@ -9,11 +9,12 @@ module Telegem
       
       attr_reader :token, :logger, :http, :connection_pool
 
-      def initialize(token, logger: nil, timeout: 30, pool_size: 10)
+      def initialize(token, **options)
         @token = token
-        @logger = logger || Logger.new($stdout)
+        @logger = options[:logger] || Logger.new($stdout)
+        timeout = options[:timeout] || 30
+        pool_size = options[:pool_size] || 10
         
-        # HTTPX with proper async configuration
         @http = HTTPX.plugin(:persistent)
                      .with(
                        timeout: { 
@@ -26,60 +27,49 @@ module Telegem
                          'Content-Type' => 'application/json',
                          'User-Agent' => "Telegem/#{Telegem::VERSION} (Ruby #{RUBY_VERSION}; #{RUBY_PLATFORM})"
                        },
-                       max_requests: pool_size  # Connection pool
+                       max_requests: pool_size
                      )
         
-        # Add retry plugin if available
         if HTTPX.plugins.key?(:retries)
           @http = @http.plugin(:retries, max_retries: 3, retry_on: [500, 502, 503, 504])
         end
         
-        # Ensure proper cleanup
         ObjectSpace.define_finalizer(self, proc { close })
       end
 
-      # PRIMARY API: Async call - returns HTTPX request (promise-like)
       def call(method, params = {})
         url = "#{BASE_URL}/bot#{@token}/#{method}"
         
         @logger.debug("🚀 Async API: #{method}") if @logger
         
-        # Pure async - returns immediately
         @http.post(url, json: params.compact)
              .then(&method(:handle_response_async))
              .on_error(&method(:handle_error_async))
       end
 
-      # SYNC WRAPPER: For when you absolutely need blocking
       def call!(method, params = {}, timeout: nil)
         timeout ||= @http.options.timeout[:read_timeout]
         
-        # Start async request
         request = call(method, params)
         
-        # Wait with timeout
         begin
           wait_result = request.wait(timeout)
           
           if request.error
-            # Error already logged by handle_error_async
             raise APIError, request.error.message
           elsif !wait_result
             raise NetworkError, "Request timeout after #{timeout}s"
           end
           
-          # Return the actual result (not the request object)
           request.instance_variable_get(:@result) || request.response
         rescue Timeout::Error
           raise NetworkError, "Request timeout after #{timeout}s"
         end
       end
 
-      # File upload - also async
       def upload(method, params)
         url = "#{BASE_URL}/bot#{@token}/#{method}"
         
-        # Build multipart form
         form = build_multipart_form(params)
         
         @logger.debug("📤 Async Upload: #{method}") if @logger
@@ -89,7 +79,6 @@ module Telegem
              .on_error(&method(:handle_error_async))
       end
 
-      # Convenience method for getUpdates with proper async handling
       def get_updates(offset: nil, timeout: 30, limit: 100, allowed_updates: nil)
         params = { timeout: timeout, limit: limit }
         params[:offset] = offset if offset
@@ -98,19 +87,17 @@ module Telegem
         call('getUpdates', params)
       end
 
-      # Close connections gracefully
       def close
         @http.close
       end
 
       private
 
-      # Async response handler - stores result on request object
       def handle_response_async(response)
         response.raise_for_status unless response.status == 200
         
         case response.status
-        when 429  # Rate limit
+        when 429
           retry_after = response.headers['retry-after']&.to_i || 1
           raise RateLimitError.new("Rate limited", retry_after)
         when 200
@@ -125,7 +112,6 @@ module Telegem
           end
           
           if json['ok']
-            # Store result on request for sync access
             response.request.instance_variable_set(:@result, json['result'])
             json['result']
           else
@@ -136,7 +122,6 @@ module Telegem
         end
       end
 
-      # Async error handler
       def handle_error_async(error)
         case error
         when HTTPX::TimeoutError
@@ -150,7 +135,7 @@ module Telegem
           raise APIError, "HTTP #{error.response.status}: #{error.message}"
         when RateLimitError
           @logger.error("🚦 Rate limit: retry after #{error.retry_after}s") if @logger
-          raise error  # Re-raise for user handling
+          raise error
         else
           @logger.error("💥 Unexpected: #{error.class}: #{error.message}") if @logger
           raise APIError, error.message
@@ -174,9 +159,8 @@ module Telegem
         when Pathname
           obj.exist? && obj.readable?
         when String
-          # Check if it's a local file (not URL)
           if obj.start_with?('http://', 'https://', 'ftp://')
-            false  # Telegram handles URLs directly
+            false
           else
             File.exist?(obj) && File.readable?(obj)
           end
@@ -186,7 +170,6 @@ module Telegem
       end
     end
 
-    # Custom Errors
     class APIError < StandardError
       attr_reader :code
       

data/lib/telegem.rb

@@ -3,7 +3,7 @@ require 'logger'
 require 'json'
 
 module Telegem
-  VERSION = "2.0.0".freeze
+  VERSION = "2.0.1".freeze
 end
 
 # Load core components

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: telegem
 version: !ruby/object:Gem::Version
-  version: 2.0.0
+  version: 2.0.1
 platform: ruby
 authors:
 - sick_phantom
@@ -198,7 +198,7 @@ metadata:
   bug_tracker_uri: https://gitlab.com/ruby-telegem/telegem/-/issues
   documentation_uri: https://gitlab.com/ruby-telegem/telegem/-/blob/main/README.md
   rubygems_mfa_required: 'false'
-post_install_message: "Thanks for installing Telegem 2.0.0!\n\nQuick start:\n  bot
+post_install_message: "Thanks for installing Telegem 2.0.1!\n\nQuick start:\n  bot
   = Telegem.new(\"YOUR_TOKEN\")\n  bot.on(:message) { |ctx| ctx.reply(\"Hello!\")
   }\n  bot.start_polling\n\nDocumentation: https://gitlab.com/ruby-telegem/telegem\nHappy
   bot building! \U0001F916\n"