telegem 3.0.3 → 3.0.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: dc9031982499124e1b520cde96b341b071a695917a57804cd9375d513dcf4bf1
-  data.tar.gz: d8b52c0273d048631d8858c5e098e070ac947f3fac222e6c20eb787b69663b59
+  metadata.gz: 9e796af1eab96fc25ece5e1dfdd0913451f66087d3181ae54f7375b10be4ebfa
+  data.tar.gz: e7fdc50d3d8e1bcb570fdb03bd0e301ddcbae3702f4e03a40ba06e12fc0941f5
 SHA512:
-  metadata.gz: c442335bb33c72fad402ccc1dd1a8a759b6dbd44542794f5413eb9b7cb8966909a2075668adc0b3323a14b66a317d4301d93ff3723d9b6424c6a00656fcf8028
-  data.tar.gz: 298852f385e908d858d4a19e464fdda29b54647fac22e4080a965c0d237b71e39c7d699e26060612682895a676a8fa0ca7a1286a47ef53870d0588f60b8b7916
+  metadata.gz: 5719f4e1d5d4ef7c865c3a08abc459712637e24a33d98d954c546a442c70a473878e501ef15f44714c1f574802325940f2d2431b863c07c353a19484e5852da5
+  data.tar.gz: 36035a791dca055bb171003ab43e6e0229de75dee1ec02fd5d61cd0b0e8c97f9e385b221333a68f2f6867ad9912c4faf63b3eaaf070b4a59c614e13bd33d1a17

data/CHANGELOG

@@ -0,0 +1,15 @@
+## v3.0.4 (2026-01-17)
+
+### Fixed
+- **Critical**: Fixed `NoMethodError: undefined method 'wait'` for HTTPX responses
+- Unified HTTPX client usage across all API methods
+- Proper async/await pattern implementation
+- Improved error handling for network timeouts
+
+### Changed
+- `API::Client#call` now uses async/await instead of blocking `.wait`
+- Better timeout handling for all Telegram API calls
+
+### Notes
+- This release fixes compatibility with HTTPX >= 0.23.0
+- All async operations now use `.await` instead of deprecated `.wait`

data/lib/api/client.rb

@@ -27,26 +27,12 @@ module Telegem
           }
         )
       end
-      def call(method, params = {})
-  url = "#{BASE_URL}/bot#{@token}/#{method}"
-  @logger.debug("API Call: #{method}") if @logger
-  
-  http_sync = HTTPX.with(
-    timeout: { 
-      request_timeout: 30,
-      connect_timeout: 10,
-      write_timeout: 10,
-      read_timeout: 30
-    },
-    headers: {
-      'Content-Type' => 'application/json',
-      'User-Agent' => "Telegem/#{Telegem::VERSION}"
-    }
-  )
-  
-  response = http_sync.post(url, json: params.compact).wait
-  response.json
-end
+        def call(method, params = {}) 
+          url = "#{BASE_URL}/bot#{@token}/#{method}"
+          @logger.debug("Api call #{method}") if @logger 
+          response = @http.post(url, json: params.compact).await
+          response.json 
+         end  
         def call!(method, params = {}, &callback)
   url = "#{BASE_URL}/bot#{@token}/#{method}"
   
@@ -112,8 +98,8 @@ end
             [key.to_s, value.to_s]
           end
         end
-        
-        @http.post(url, form: form)
+         response = @http.post(url, form: form).await
+         response.json 
       end
 
       def get_updates(offset: nil, timeout: 30, limit: 100, allowed_updates: nil)

data/lib/core/bot.rb

@@ -19,7 +19,13 @@ module Telegem
           chat_member: [],
           poll: [],
           pre_checkout_query: [],
-          shipping_query: []
+          shipping_query: [],
+          poll_answer: [],
+          chat_join_request: [],
+          chat_boost: [],
+          removed_chat_boost: [],
+          message_reaction: [],
+          message_reaction_count: []
         }
         
         @middleware = []
@@ -69,6 +75,71 @@ module Telegem
         end
       end
       
+      def contact(**options, &block) 
+        on(:message, contact: true) do |ctx| 
+          block.call(ctx)
+       end 
+      end 
+      
+      def poll_answer(&block) 
+        on(:poll_answer) do |ctx| 
+          block.call(ctx)
+        end
+      end 
+      
+     def pre_checkout_query(&block) 
+       on(:pre_checkout_query) do |ctx| 
+         block.call(ctx) 
+       end 
+      end 
+      
+      def shipping_query(&block) 
+        on(:shipping_query) do |ctx| 
+          block.call(ctx) 
+        end 
+      end 
+      
+      def chat_join_request(&block)
+  on(:chat_join_request) do |ctx|
+    block.call(ctx)
+  end
+end
+
+  def chat_boost(&block)
+   on(:chat_boost) do |ctx|
+    block.call(ctx)
+   end
+ end
+
+ def removed_chat_boost(&block)
+   on(:removed_chat_boost) do |ctx|
+    block.call(ctx)
+   end
+ end
+
+  def message_reaction(&block)
+  on(:message_reaction) do |ctx|
+    block.call(ctx)
+  end
+ end
+
+def message_reaction_count(&block)
+  on(:message_reaction_count) do |ctx|
+    block.call(ctx)
+  end
+end
+      def web_app_data(&block) 
+        on(:message, web_app_data: true) do |ctx|
+          block.call(ctx) 
+        end 
+      end 
+      
+      def location(&block)
+        on(:message, location: true) do |ctx|
+          block.call(ctx) 
+        end 
+      end 
+      
       def on(type, filters = {}, &block)
         @handlers[type] << { filters: filters, handler: block }
       end
@@ -240,6 +311,12 @@ module Telegem
         return :poll if update.poll
         return :pre_checkout_query if update.pre_checkout_query
         return :shipping_query if update.shipping_query
+        return :poll_answer if update.poll_answer
+        return :chat_join_request if update.chat_join_request
+        return :chat_boost if update.chat_boost
+        return :removed_chat_boost if update.removed_chat_boost 
+        return :message_reaction if update.message_reaction
+        return :message_reaction_count if update.message_reaction_count 
         :unknown
       end
       
@@ -254,10 +331,20 @@ module Telegem
             matches_chat_type_filter(ctx, value)
           when :command
             matches_command_filter(ctx, value)
-          else
+          when :location 
+            ctx.message&.location != nil 
+          when :contact 
+             ctx.message&.contact != nil 
+          when :web_app_data 
+            ctx.message&.web_app_data != nil
+          else 
+            if  ctx.update.respond_to?(key) 
             ctx.update.send(key) == value
-          end
-        end
+          else 
+            false 
+          end 
+         end
+        end 
       end
       
       def matches_text_filter(ctx, pattern)

data/lib/telegem.rb

@@ -3,7 +3,7 @@ require 'logger'
 require 'json'
 
 module Telegem
-  VERSION = "3.0.3".freeze 
+  VERSION = "3.0.4".freeze 
 end
 
 # Load core components
@@ -80,4 +80,4 @@ if ENV['TELEGEM_GLOBAL'] == 'true'
   def Telegem(token, **options)
     ::Telegem.new(token, **options)
   end
-end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: telegem
 version: !ruby/object:Gem::Version
-  version: 3.0.3
+  version: 3.0.4
 platform: ruby
 authors:
 - sick_phantom
@@ -173,14 +173,13 @@ extensions: []
 extra_rdoc_files: []
 files:
 - ".replit"
+- CHANGELOG
 - Contributing.md
 - Gemfile
 - Gemfile.lock
 - LICENSE
 - Readme.md
 - Starts_HallofFame.md
-- Test-Projects/bot.md
-- Test-Projects/bot1.rb
 - bin/.gitkeep
 - bin/telegem-ssl
 - docs-src/.gitkeep
@@ -192,6 +191,7 @@ files:
 - docs-src/keyboard_inline.md
 - docs-src/scene.md
 - docs-src/webhook.md
+- examples/.gitkeep
 - lib/api/client.rb
 - lib/api/types.rb
 - lib/core/bot.rb
@@ -206,7 +206,6 @@ files:
 - lib/webhook/.gitkeep
 - lib/webhook/server.rb
 - public/.gitkeep
-- public/index.html
 homepage: https://gitlab.com/ruby-telegem/telegem
 licenses:
 - MIT
@@ -217,7 +216,7 @@ metadata:
   bug_tracker_uri: https://gitlab.com/ruby-telegem/telegem/-/issues
   documentation_uri: https://gitlab.com/ruby-telegem/telegem/-/tree/main/docs-src?ref_type=heads
   rubygems_mfa_required: 'false'
-post_install_message: "Thanks for installing Telegem 3.0.3!\n\n\U0001F4DA Documentation:
+post_install_message: "Thanks for installing Telegem 3.0.4!\n\n\U0001F4DA Documentation:
   https://gitlab.com/ruby-telegem/telegem\n\n\U0001F510 For SSL Webhooks:\nRun: telegem-ssl
   your-domain.com\nThis sets up Let's Encrypt certificates automatically.\n\n\U0001F916
   Happy bot building!\n"

data/Test-Projects/bot.md

@@ -1,145 +0,0 @@
-bot1.md - Telegem Response Patterns
-
-How Telegem Returns API Responses
-
-All ctx methods return HTTPX::Response objects, not JSON hashes.
-
-Pattern 1: Fire-and-Forget
-
-```ruby
-ctx.reply("Hello!")
-ctx.photo("image.jpg")
-```
-
-Pattern 2: Get Message ID
-
-```ruby
-response = ctx.reply("Sending...")
-
-if response && response.status == 200
-  data = response.json
-  if data && data['ok']
-    message_id = data['result']['message_id']
-    ctx.session[:msg_id] = message_id
-  end
-end
-```
-
-Pattern 3: Check for Errors
-
-```ruby
-response = ctx.reply("Testing...")
-
-if response && response.status != 200
-  error = response.json rescue nil
-  error_msg = error['description'] if error
-  ctx.reply("Failed: #{error_msg}")
-end
-```
-
-Pattern 4: Edit Messages
-
-```ruby
-edit_response = ctx.edit_message_text(
-  "Updated!", 
-  message_id: ctx.session[:msg_id]
-)
-
-if edit_response && edit_response.status == 200
-  ctx.reply("Edit succeeded!")
-end
-```
-
-Pattern 5: Send Media
-
-```ruby
-photo_response = ctx.photo(
-  "https://example.com/image.jpg",
-  caption: "My photo"
-)
-
-if photo_response && photo_response.status == 200
-  ctx.reply("Photo sent!")
-end
-```
-
-Pattern 6: Handle Callbacks
-
-```ruby
-bot.on(:callback_query) do |ctx|
-  ctx.answer_callback_query(text: "Clicked: #{ctx.data}")
-
-  if ctx.data == 'test'
-    ctx.edit_message_text("Updated after click!")
-  end
-end
-```
-
-Pattern 7: Error Wrapping
-
-```ruby
-begin
-  response = ctx.reply(some_text)
-  # Process response
-rescue => e
-  ctx.reply("Error: #{e.message}")
-end
-```
-
-Complete bot1.rb Explained
-
-Setup
-
-```ruby
-require 'telegem'
-require 'dotenv/load'
-bot = Telegem.new(ENV['BOT_TOKEN'])
-```
-
-/start Command
-
-Sends welcome, stores message ID in session.
-
-/help Command
-
-Simple reply with command list.
-
-/edit Command
-
-Edits the stored message, checks edit response.
-
-/photo Command
-
-Sends photo, confirms delivery.
-
-/error Command
-
-Demonstrates error handling.
-
-Callback Handler
-
-Answers inline button clicks.
-
-Startup Logic
-
-```ruby
-if ENV['RACK_ENV'] == 'production'
-  # Webhook mode
-  server = bot.webhook(port: ENV['PORT'] || 3000)
-  server.run
-  server.set_webhook
-else
-  # Polling mode (development)
-  bot.start_polling(timeout: 30, limit: 100)
-end
-```
-
-Key Takeaways
-
-1. Always check response.status (200 = success)
-2. Call .json to get data from response
-3. Check data['ok'] before using result
-4. Store message_id for later editing
-5. Wrap in begin/rescue for network issues
-
-This pattern ensures your bot handles all API scenarios correctly.

data/Test-Projects/bot1.rb

@@ -1,91 +0,0 @@
-require 'telegem'
-require 'dotenv/load'
-
-bot = Telegem.new(ENV['BOT_TOKEN'])
-
-bot.command('start') do |ctx|
-  ctx.reply("Welcome! Use /help for commands.")
-
-  response = ctx.reply("Processing your request...")
-
-  if response && response.status == 200
-    data = response.json
-    if data && data['ok']
-      ctx.session[:start_msg_id] = data['result']['message_id']
-    end
-  end
-end
-
-bot.command('help') do |ctx|
-  help_text = <<~HELP
-    Available commands:
-    /start - Start the bot
-    /help - This help message
-    /edit - Edit the start message
-    /error - Test error handling
-    /photo - Send a photo
-  HELP
-
-  ctx.reply(help_text)
-end
-
-bot.command('edit') do |ctx|
-  if ctx.session[:start_msg_id]
-    edit_response = ctx.edit_message_text(
-      "✅ Updated at #{Time.now.strftime('%H:%M:%S')}",
-      message_id: ctx.session[:start_msg_id]
-    )
-
-    if edit_response && edit_response.status == 200
-      ctx.reply("Message edited successfully!")
-    else
-      status = edit_response ? edit_response.status : 'no response'
-      ctx.reply("Edit failed (status: #{status})")
-    end
-  else
-    ctx.reply("Send /start first to create a message to edit.")
-  end
-end
-
-bot.command('photo') do |ctx|
-  photo_response = ctx.photo(
-    "https://picsum.photos/400/300",
-    caption: "Random image - #{Time.now.strftime('%H:%M:%S')}"
-  )
-
-  if photo_response && photo_response.status == 200
-    ctx.reply("Photo sent successfully!")
-  else
-    ctx.reply("Failed to send photo.")
-  end
-end
-
-bot.command('error') do |ctx|
-  begin
-    invalid_response = ctx.reply(nil)
-
-    if invalid_response && invalid_response.status != 200
-      error_data = invalid_response.json rescue nil
-      error_msg = error_data ? error_data['description'] : "Unknown error"
-      ctx.reply("API Error: #{error_msg}")
-    end
-  rescue => e
-    ctx.reply("Ruby Error: #{e.message}")
-  end
-end
-
-bot.on(:callback_query) do |ctx|
-  ctx.answer_callback_query(text: "Button clicked: #{ctx.data}")
-
-  if ctx.data == 'test'
-    ctx.edit_message_text("You clicked the test button!")
-  end
-end
-
-if ENV['RACK_ENV'] == 'production'
-  server = bot.webhook(port: ENV['PORT'] || 3000)
-  server.run
-  server.set_webhook
-else
-  bot.start_polling(timeout: 30, limit: 100)
-end

data/public/index.html

@@ -1,481 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-<head>
-    <meta charset="UTF-8">
-    <meta name="viewport" content="width=device-width, initial-scale=1.0">
-    <title>Telegem Docs - Telegram Bot Framework for Ruby</title>
-    <style>
-        * {
-            margin: 0;
-            padding: 0;
-            box-sizing: border-box;
-        }
-        
-        body {
-            font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
-            line-height: 1.6;
-            color: #1a1a1a;
-            background: #fafafa;
-            padding: 0;
-        }
-        
-        .container {
-            max-width: 900px;
-            margin: 0 auto;
-            padding: 2rem 1.5rem;
-        }
-        
-        .header {
-            padding-bottom: 2rem;
-            margin-bottom: 2rem;
-            border-bottom: 1px solid #eaeaea;
-        }
-        
-        .header h1 {
-            font-size: 2.2rem;
-            color: #2c3e50;
-            margin-bottom: 0.25rem;
-        }
-        
-        .tagline {
-            font-size: 1.1rem;
-            color: #7f8c8d;
-            margin-bottom: 1.5rem;
-        }
-        
-        .stats {
-            display: flex;
-            gap: 1.5rem;
-            margin-top: 1rem;
-        }
-        
-        .stat {
-            background: white;
-            padding: 0.75rem 1rem;
-            border-radius: 6px;
-            border: 1px solid #eaeaea;
-            min-width: 120px;
-        }
-        
-        .stat-label {
-            font-size: 0.8rem;
-            color: #95a5a6;
-            text-transform: uppercase;
-            letter-spacing: 0.5px;
-            margin-bottom: 0.25rem;
-        }
-        
-        .stat-value {
-            font-size: 1.1rem;
-            font-weight: 600;
-            color: #2c3e50;
-        }
-        
-        .doc-nav {
-            display: flex;
-            gap: 0.5rem;
-            margin: 2rem 0;
-            flex-wrap: wrap;
-        }
-        
-        .nav-btn {
-            background: white;
-            border: 1px solid #ddd;
-            padding: 0.5rem 1rem;
-            border-radius: 4px;
-            font-size: 0.9rem;
-            color: #555;
-            cursor: pointer;
-            transition: all 0.2s;
-        }
-        
-        .nav-btn:hover {
-            border-color: #3498db;
-            color: #3498db;
-        }
-        
-        .nav-btn.active {
-            background: #3498db;
-            border-color: #3498db;
-            color: white;
-        }
-        
-        .doc-section {
-            background: white;
-            border-radius: 8px;
-            padding: 2rem;
-            margin-bottom: 1.5rem;
-            border: 1px solid #eaeaea;
-        }
-        
-        .doc-section h2 {
-            font-size: 1.5rem;
-            color: #2c3e50;
-            margin-bottom: 1rem;
-            padding-bottom: 0.5rem;
-            border-bottom: 2px solid #f0f0f0;
-        }
-        
-        .doc-section h3 {
-            font-size: 1.1rem;
-            color: #34495e;
-            margin: 1.5rem 0 0.75rem;
-        }
-        
-        .doc-section p {
-            margin-bottom: 1rem;
-            color: #555;
-        }
-        
-        .method-list {
-            list-style: none;
-            margin: 1rem 0;
-        }
-        
-        .method-item {
-            margin-bottom: 0.75rem;
-            padding: 0.75rem;
-            background: #f8f9fa;
-            border-radius: 4px;
-            border-left: 3px solid #3498db;
-        }
-        
-        .method-name {
-            font-family: 'SF Mono', Monaco, Consolas, monospace;
-            font-weight: 600;
-            color: #2c3e50;
-            margin-bottom: 0.25rem;
-        }
-        
-        .method-desc {
-            color: #7f8c8d;
-            font-size: 0.9rem;
-        }
-        
-        .code-block {
-            background: #2c3e50;
-            color: #ecf0f1;
-            padding: 1.25rem;
-            border-radius: 6px;
-            margin: 1rem 0;
-            font-family: 'SF Mono', Monaco, Consolas, monospace;
-            font-size: 0.9rem;
-            line-height: 1.5;
-            overflow-x: auto;
-        }
-        
-        .code-block::selection {
-            background: #3498db;
-        }
-        
-        .links {
-            display: flex;
-            gap: 1rem;
-            margin-top: 2rem;
-            padding-top: 1.5rem;
-            border-top: 1px solid #eaeaea;
-            flex-wrap: wrap;
-        }
-        
-        .link-btn {
-            display: inline-flex;
-            align-items: center;
-            gap: 0.5rem;
-            padding: 0.6rem 1.2rem;
-            background: #3498db;
-            color: white;
-            text-decoration: none;
-            border-radius: 4px;
-            font-size: 0.9rem;
-            transition: background 0.2s;
-        }
-        
-        .link-btn:hover {
-            background: #2980b9;
-        }
-        
-        .link-btn.secondary {
-            background: white;
-            color: #555;
-            border: 1px solid #ddd;
-        }
-        
-        .link-btn.secondary:hover {
-            background: #f8f9fa;
-        }
-        
-        .note {
-            background: #f8f9fa;
-            padding: 1rem;
-            border-left: 3px solid #3498db;
-            margin: 1rem 0;
-            border-radius: 0 4px 4px 0;
-        }
-        
-        @media (max-width: 768px) {
-            .container {
-                padding: 1rem;
-            }
-            
-            .doc-section {
-                padding: 1.5rem;
-            }
-            
-            .stats {
-                flex-direction: column;
-                gap: 0.75rem;
-            }
-            
-            .stat {
-                min-width: auto;
-            }
-        }
-    </style>
-</head>
-<body>
-    <div class="container">
-        <header class="header">
-            <div>
-                <h1>Telegem</h1>
-                <p class="tagline">Telegram Bot Framework for Ruby</p>
-            </div>
-            
-            <div class="stats">
-                <div class="stat">
-                    <div class="stat-label">Version</div>
-                    <div class="stat-value" id="gem-version">Loading...</div>
-                </div>
-                <div class="stat">
-                    <div class="stat-label">Downloads</div>
-                    <div class="stat-value" id="gem-downloads">Loading...</div>
-                </div>
-            </div>
-            
-            <div class="doc-nav">
-                <button class="nav-btn active" onclick="showDoc('quickstart')">Quick Start</button>
-                <button class="nav-btn" onclick="showDoc('ctx')">Context API</button>
-                <button class="nav-btn" onclick="showDoc('bot')">Bot API</button>
-                <button class="nav-btn" onclick="showDoc('scenes')">Scenes</button>
-                <button class="nav-btn" onclick="showDoc('webhook')">Webhook</button>
-            </div>
-        </header>
-
-        <!-- Quick Start -->
-        <section id="quickstart-doc" class="doc-section">
-            <h2>Quick Start</h2>
-            
-            <h3>Installation</h3>
-            <div class="code-block">
-# Add to Gemfile
-gem 'telegem'
-
-# Or install directly
-$ gem install telegem
-            </div>
-            
-            <h3>Basic Usage</h3>
-            <div class="code-block">
-require 'telegem'
-
-bot = Telegem.new("YOUR_BOT_TOKEN")
-
-bot.command('start') do |ctx|
-  ctx.reply("Welcome to Telegem!")
-end
-
-bot.command('help') do |ctx|
-  ctx.reply("Available commands: /start, /help")
-end
-
-# Start the bot
-bot.start_polling
-            </div>
-            
-            <div class="note">
-                Replace <code>YOUR_BOT_TOKEN</code> with your actual Telegram Bot token from @BotFather
-            </div>
-            
-            <div class="links">
-                <a href="https://rubygems.org/gems/telegem" class="link-btn">📦 View on RubyGems</a>
-                <a href="https://gitlab.com/ruby-telegem/telegem" class="link-btn secondary">🐱 GitLab Repository</a>
-            </div>
-        </section>
-
-        <!-- ctx API -->
-        <section id="ctx-doc" class="doc-section" style="display: none;">
-            <h2>Context API</h2>
-            <p>The context object provides access to the current update and response methods.</p>
-            
-            <h3>Properties</h3>
-            <ul class="method-list">
-                <li class="method-item">
-                    <div class="method-name">ctx.message</div>
-                    <div class="method-desc">Current message object</div>
-                </li>
-                <li class="method-item">
-                    <div class="method-name">ctx.from</div>
-                    <div class="method-desc">User who sent the message</div>
-                </li>
-                <li class="method-item">
-                    <div class="method-name">ctx.chat</div>
-                    <div class="method-desc">Chat information</div>
-                </li>
-                <li class="method-item">
-                    <div class="method-name">ctx.session</div>
-                    <div class="method-desc">Persistent user storage</div>
-                </li>
-            </ul>
-            
-            <h3>Methods</h3>
-            <div class="code-block">
-# Send message
-ctx.reply("Hello!")
-
-# Send photo
-ctx.photo("photo.jpg", caption: "My photo")
-
-# Edit message
-ctx.edit_message_text("Updated text")
-
-# Delete message
-ctx.delete_message(message_id)
-            </div>
-            
-            <div class="links">
-                <a href="https://gitlab.com/ruby-telegem/telegem/-/tree/main/docs/context.md" class="link-btn">📄 Full Context Docs</a>
-            </div>
-        </section>
-
-        <!-- Bot API -->
-        <section id="bot-doc" class="doc-section" style="display: none;">
-            <h2>Bot API</h2>
-            <p>Configure handlers and control bot lifecycle.</p>
-            
-            <div class="code-block">
-# Handle commands
-bot.command('start') { |ctx| ctx.reply("Welcome") }
-
-# Handle text patterns
-bot.hears(/hello/i) { |ctx| ctx.reply("Hi there!") }
-
-# Handle specific update types
-bot.on(:photo) { |ctx| ctx.reply("Nice photo!") }
-bot.on(:callback_query) { |ctx| ctx.answer_callback_query }
-
-# Start bot
-bot.start_polling
-# or
-bot.webhook.run
-            </div>
-            
-            <div class="links">
-                <a href="https://gitlab.com/ruby-telegem/telegem/-/tree/main/docs/bot.md" class="link-btn">📄 Bot API Reference</a>
-            </div>
-        </section>
-
-        <!-- Scenes -->
-        <section id="scenes-doc" class="doc-section" style="display: none;">
-            <h2>Scenes</h2>
-            <p>Multi-step conversations for complex interactions.</p>
-            
-            <div class="code-block">
-bot.scene :registration do
-  step :ask_name do |ctx|
-    ctx.reply("What is your name?")
-  end
-  
-  step :save_name do |ctx|
-    ctx.session[:name] = ctx.message.text
-    ctx.reply("Hello #{ctx.session[:name]}!")
-    ctx.leave_scene
-  end
-end
-
-# Enter scene
-bot.command('register') { |ctx| ctx.enter_scene(:registration) }
-            </div>
-            
-            <div class="links">
-                <a href="https://gitlab.com/ruby-telegem/telegem/-/tree/main/docs/scenes.md" class="link-btn">📄 Scenes Guide</a>
-            </div>
-        </section>
-
-        <!-- Webhook -->
-        <section id="webhook-doc" class="doc-section" style="display: none;">
-            <h2>Webhook Deployment</h2>
-            <p>Production deployment with webhooks.</p>
-            
-            <div class="code-block">
-# Production setup
-bot = Telegem.new("TOKEN")
-
-# Configure webhook
-bot.webhook(
-  url: 'https://your-domain.com/webhook',
-  port: 3000
-).run
-
-# For cloud platforms
-bot.webhook.run # Auto-detects platform
-            </div>
-            
-            <div class="note">
-                Webhook mode is recommended for production. Uses less resources than polling.
-            </div>
-            
-            <div class="links">
-                <a href="https://gitlab.com/ruby-telegem/telegem/-/tree/main/docs/deployment.md" class="link-btn">📄 Deployment Guide</a>
-            </div>
-        </section>
-
-        <!-- Footer -->
-        <div class="doc-section">
-            <div class="links">
-                <a href="https://gitlab.com/ruby-telegem/telegem" class="link-btn">🏠 Main Repository</a>
-                <a href="https://rubygems.org/gems/telegem" class="link-btn secondary">💎 RubyGems</a>
-                <a href="https://gitlab.com/ruby-telegem/telegem/-/issues" class="link-btn secondary">🐛 Issue Tracker</a>
-            </div>
-        </div>
-    </div>
-
-    <script>
-        async function fetchGemStats() {
-            try {
-                const response = await fetch('https://rubygems.org/api/v1/gems/telegem.json');
-                const data = await response.json();
-                
-                if (data.version) {
-                    document.getElementById('gem-version').textContent = `v${data.version}`;
-                }
-                
-                if (data.downloads) {
-                    document.getElementById('gem-downloads').textContent = 
-                        data.downloads.toLocaleString();
-                }
-            } catch (error) {
-                document.getElementById('gem-version').textContent = 'v3.0.0';
-                document.getElementById('gem-downloads').textContent = 'N/A';
-            }
-        }
-        
-        function showDoc(section) {
-            document.querySelectorAll('.doc-section').forEach(el => {
-                el.style.display = 'none';
-            });
-            
-            document.getElementById(`${section}-doc`).style.display = 'block';
-            
-            document.querySelectorAll('.nav-btn').forEach(btn => {
-                btn.classList.remove('active');
-            });
-            event.target.classList.add('active');
-            
-            window.scrollTo(0, 0);
-        }
-        
-        document.addEventListener('DOMContentLoaded', () => {
-            fetchGemStats();
-        });
-    </script>
-</body>
-</html>