telegem 3.2.2 → 3.2.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3e38340f8acfbe77b677a30960ba7f5f7e074b7fe373890b676d492f30141207
-  data.tar.gz: 9ad810bb1fb0e63af1de6a1120f8adcc791e2c40765446731e67eee2d4b82d6a
+  metadata.gz: 64cc027dc87d2e24f181a24705a85243f95c7f498a44f70fcb175d8a9b2dd597
+  data.tar.gz: 37310a9a9c973f31f3dfd5b93e8347843a50c8218475b90a7f055df116c8353e
 SHA512:
-  metadata.gz: ebea1b6df44831d3fbb912f345cce9f5bee57f9e887fa39df1f7dd8056b5a360f7703b56c5f591de17e13aa105b9a911737c00364bc48ea21af974dcf19382c1
-  data.tar.gz: 2727f777908d295aff07fe535c11a5a6238cb841e2f4944ca7b26973ed87cb140671aa45cc2d3cf937cc422a507b31b7f69e165e1641c5255691bc2d930b7060
+  metadata.gz: 9cd4708d09629445cf1398677521270c22991eee81b45204d2384570ba14876c937888cf86fc9ba8bfdad78138a48ea9bee6fed6e019a12ae89b29433f91e881
+  data.tar.gz: ee85cb0026f096291a1700d825e68cf21f08385e1c7eaf5396763e00fbe4edecfb574b4ed1017293e4e41a06d60b98be5963893b6b0ba2e53f8816396ae33dfc

data/Readme.md

@@ -108,7 +108,7 @@ Perfect For:
 
 ---
 
-[📚 Documentation](https://www.rubydoc.info/gems/telegem/3.2.0/index)
+[📚 Documentation](https://rubydoc.info/gems/telegem/3.2.2/index)
 
 
 

data/docs/ctx.md

@@ -0,0 +1,437 @@
+The Context object (ctx) is the heart of every Telegem bot handler. It provides access to everything about the current update and methods to interact with Telegram.
+
+---
+
+📦 Basic Properties
+
+Property Type Description
+ctx.update Update Raw Telegram update object
+ctx.bot Bot The bot instance
+ctx.state Hash Temporary state for current request (cleared after)
+ctx.session Hash Persistent user session (stored between requests)
+ctx.match MatchData Regex match data from hears or pattern matching
+ctx.scene String Current scene name (if in a scene)
+
+---
+
+👤 User & Chat Information
+
+```ruby
+ctx.from          # User who sent the message
+ctx.from.id       # User ID
+ctx.from.username # Username (may be nil)
+ctx.from.first_name
+ctx.from.last_name
+
+ctx.chat          # Current chat
+ctx.chat.id       # Chat ID
+ctx.chat.type     # "private", "group", "supergroup", "channel"
+
+ctx.user_id       # Shortcut for ctx.from&.id
+```
+
+---
+
+📨 Message Access
+
+```ruby
+ctx.message                    # Current message
+ctx.message.text               # Message text
+ctx.message.caption            # Caption for media
+ctx.message.message_id
+ctx.message.date
+
+ctx.message.reply_to_message   # Message being replied to
+ctx.reply_to_message           # Same as above
+
+ctx.message.photo              # Array of photo sizes
+ctx.message.document           # Document object
+ctx.message.audio
+ctx.message.video
+ctx.message.voice
+ctx.message.sticker
+ctx.message.location
+
+ctx.message.entities           # Formatting entities
+ctx.message.caption_entities   # Caption entities
+```
+
+---
+
+🔍 Update Type Detection
+
+```ruby
+ctx.callback_query     # Callback query object (if present)
+ctx.inline_query       # Inline query object
+ctx.chosen_inline_result
+ctx.poll               # Poll object
+ctx.poll_answer
+ctx.chat_member
+ctx.my_chat_member
+ctx.chat_join_request
+```
+
+---
+
+📝 Message Content Shortcuts
+
+```ruby
+ctx.text               # ctx.message&.text
+ctx.data               # ctx.callback_query&.data
+ctx.query              # ctx.inline_query&.query
+ctx.command?           # True if message is a command
+ctx.command            # Command name (e.g., "start")
+ctx.command_args       # Arguments after command
+```
+
+---
+
+💬 Sending Messages
+
+Basic Text
+
+```ruby
+ctx.reply("Hello world")                    # Simple reply
+ctx.reply("Hello", parse_mode: "Markdown")  # With formatting
+ctx.reply("Hello", disable_web_page_preview: true)
+ctx.reply("Hello", reply_to_message_id: 123)
+```
+
+With Keyboard
+
+```ruby
+# Reply keyboard
+keyboard = Telegem::Markup.keyboard do
+  button "Option 1"
+  button "Option 2"
+  request_location "Share Location"
+end
+ctx.reply("Choose:", reply_markup: keyboard)
+
+# Inline keyboard
+inline = Telegem::Markup.inline do
+  callback "Yes", "confirm"
+  callback "No", "cancel"
+  url "Visit", "https://example.com"
+end
+ctx.reply("Confirm?", reply_markup: inline)
+```
+
+Remove Keyboard
+
+```ruby
+ctx.remove_keyboard                    # Just removes keyboard
+ctx.remove_keyboard("Done!")            # Sends message + removes keyboard
+ctx.remove_keyboard(selective: true)    # Only for specific users
+```
+
+Force Reply
+
+```ruby
+ctx.reply("What's your name?", reply_markup: Telegem::Markup.force_reply)
+```
+
+---
+
+🖼️ Sending Media
+
+Photos
+
+```ruby
+ctx.photo("https://example.com/image.jpg")
+ctx.photo("https://example.com/image.jpg", caption: "Beautiful gem")
+ctx.photo(File.open("local.jpg"))
+ctx.photo(File.open("local.jpg"), caption: "Local file")
+```
+
+Documents
+
+```ruby
+ctx.document("https://example.com/file.pdf")
+ctx.document(File.open("report.pdf"), caption: "Monthly report")
+ctx.document(file_id)  # Using Telegram file_id
+```
+
+Audio
+
+```ruby
+ctx.audio("song.mp3", title: "My Song", performer: "Artist", duration: 180)
+```
+
+Video
+
+```ruby
+ctx.video("video.mp4", caption: "Check this out", width: 1920, height: 1080)
+```
+
+Voice
+
+```ruby
+ctx.voice("voice.ogg")  # Must be OGG format
+```
+
+Sticker
+
+```ruby
+ctx.sticker("CAACAgIAAxkBAAIBZmd...")  # Sticker file_id
+```
+
+Location
+
+```ruby
+ctx.location(6.454, 3.394)  # Latitude, Longitude
+```
+
+Contact
+
+```ruby
+ctx.contact("+1234567890", "John", last_name: "Doe")
+```
+
+---
+
+✏️ Editing Messages
+
+```ruby
+ctx.edit_message_text("Updated text")
+ctx.edit_message_text("New text", message_id: 123)  # Specific message
+
+ctx.edit_message_caption("New caption")
+ctx.edit_message_media(new_photo)
+ctx.edit_message_reply_markup(new_keyboard)
+
+ctx.edit_message_live_location(6.455, 3.395)  # For live locations
+ctx.stop_message_live_location
+```
+
+---
+
+❌ Deleting Messages
+
+```ruby
+ctx.delete_message                 # Deletes current message
+ctx.delete_message(123)            # Deletes specific message ID
+```
+
+---
+
+🔄 Replying to Callbacks
+
+```ruby
+ctx.answer_callback_query("Done!")                    # Simple toast
+ctx.answer_callback_query("Error!", show_alert: true) # Alert popup
+ctx.answer_callback_query(url: "https://example.com") # Open URL
+ctx.answer_callback_query(text: "Loading...", cache_time: 5)
+```
+
+---
+
+🔎 Inline Queries
+
+```ruby
+ctx.answer_inline_query(results, cache_time: 300)
+ctx.answer_inline_query(results, next_offset: "20")  # Pagination
+
+# Results array of InlineQueryResult objects
+results = [
+  Telegem::Types::InlineQueryResultArticle.new(
+    id: "1",
+    title: "Result",
+    input_message_content: { message_text: "Text" }
+  )
+]
+```
+
+---
+
+📥 File Operations
+
+```ruby
+ctx.download_file(file_id, "local/path")  # Download file
+ctx.file(file_id)                          # Get file info
+ctx.file_path(file_id)                     # Get path on Telegram servers
+```
+
+---
+
+🎬 Chat Actions (Typing Indicators)
+
+```ruby
+ctx.typing                          # "typing..."
+ctx.uploading_photo                  # "sending photo..."
+ctx.uploading_video                  # "sending video..."
+ctx.uploading_audio                  # "sending audio..."
+ctx.uploading_document                # "sending document..."
+ctx.find_location                     # "finding location..."
+ctx.record_video                      # "recording video..."
+ctx.record_audio                      # "recording audio..."
+ctx.choose_sticker                    # "choosing sticker..."
+```
+
+All accept optional **options:
+
+```ruby
+ctx.typing(business_connection_id: "123")  # For business connections
+```
+
+---
+
+👥 Chat Management
+
+```ruby
+ctx.kick_chat_member(user_id)                 # Kick user
+ctx.ban_chat_member(user_id, until_date: future_time)
+ctx.unban_chat_member(user_id, only_if_banned: true)
+
+ctx.restrict_chat_member(user_id, permissions: { can_send_messages: false })
+ctx.promote_chat_member(user_id, can_invite_users: true)
+
+ctx.get_chat_administrators
+ctx.get_chat_member(user_id)
+ctx.get_chat_members_count
+
+ctx.leave_chat
+```
+
+---
+
+📌 Pinning Messages
+
+```ruby
+ctx.pin_message(123)                        # Pin message
+ctx.pin_message(123, disable_notification: true)
+ctx.unpin_message                            # Unpin current
+ctx.unpin_message(123)                       # Unpin specific
+ctx.unpin_all_messages
+```
+
+---
+
+🔁 Forwarding & Copying
+
+```ruby
+ctx.forward_message(from_chat_id, message_id)
+ctx.copy_message(from_chat_id, message_id, caption: "New caption")
+```
+
+---
+
+🌐 Web App & Polls
+
+```ruby
+ctx.web_app_data                # Data from Web App
+
+ctx.send_poll("Question?", ["Option1", "Option2"], is_anonymous: true)
+ctx.stop_poll(message_id)
+```
+
+---
+
+🎭 Scenes (Multi-step Conversations)
+
+```ruby
+ctx.enter_scene(:survey)         # Enter scene
+ctx.leave_scene                   # Leave current scene
+ctx.leave_scene(reason: :cancel) # Leave with reason
+ctx.in_scene?                     # Check if in a scene
+ctx.current_scene                 # Get current scene name
+
+ctx.ask("What's your name?")      # Prompt for response (scene helper)
+ctx.next_step                      # Move to next scene step
+ctx.next_step(:payment)            # Move to specific step
+ctx.scene_data                     # Get scene data hash
+```
+
+---
+
+🎨 Keyboard Building Helpers
+
+```ruby
+# Create and use in one line
+ctx.reply_with_keyboard("Choose:", Telegem::Markup.keyboard { button "Yes" })
+
+ctx.reply_with_inline_keyboard("Options:", Telegem::Markup.inline { callback "Yes", "data" })
+```
+
+---
+
+📊 Poll Helpers
+
+```ruby
+ctx.poll?                         # True if update is a poll
+ctx.poll_answer?                   # True if poll answer
+ctx.poll_answer                     # Get poll answer object
+```
+
+---
+
+⏱️ Timing & Metadata
+
+```ruby
+ctx.logger                         # Bot's logger
+ctx.api                             # Direct API client
+ctx.raw_update                      # Original update hash
+ctx.update_id                       # Update ID
+```
+
+---
+
+🔄 Session Management
+
+```ruby
+ctx.session[:user_preference] = "dark"  # Store in session
+pref = ctx.session[:user_preference]     # Retrieve
+ctx.session.delete(:temp_data)           # Delete
+ctx.session.clear                         # Clear all
+```
+
+---
+
+🎯 Complete Usage Example
+
+```ruby
+bot.command('start') do |ctx|
+  ctx.session[:visits] ||= 0
+  ctx.session[:visits] += 1
+  
+  keyboard = Telegem::Markup.keyboard do
+    button "💎 Random Gem"
+    request_location "📍 Share Location"
+  end
+  
+  ctx.reply(
+    "Welcome! You've visited #{ctx.session[:visits]} times", 
+    reply_markup: keyboard
+  )
+end
+
+bot.hears(/^gem$/i) do |ctx|
+  ctx.typing
+  sleep 1  # Simulate processing
+  
+  gem = GemDatabase.random
+  ctx.photo(gem.image_url, caption: "#{gem.name}\n#{gem.fact}")
+end
+
+bot.callback_query('favorite') do |ctx|
+  gem_id = ctx.data.split('_').last
+  ctx.session[:favorites] ||= []
+  ctx.session[:favorites] << gem_id
+  
+  ctx.answer_callback_query("Added to favorites! ❤️")
+  ctx.edit_message_text("⭐ Favorited!")
+end
+```
+
+---
+
+⚠️ Error Handling
+
+```ruby
+bot.error do |error, ctx|
+  ctx.logger.error("Error for user #{ctx.user_id}: #{error.message}")
+  ctx.reply("Something went wrong. Please try again.") if ctx.chat
+end
+```
+
+---

data/docs/file_extract.md

@@ -0,0 +1,378 @@
+
+
+# Telegem::Plugins::FileExtract
+
+**Version:** 3.2.2  
+**Status:** Production Ready  
+**Dependencies:** `pdf-reader` 
+
+---
+
+## Overview
+
+FileExtractor provides seamless document processing for Telegram bots. It automatically detects file types, extracts structured content, and handles all edge cases—eliminating boilerplate code for developers.
+
+Unlike traditional approaches that require manual MIME type checking and format-specific handlers, FileExtractor implements a unified interface that works across all supported formats.
+
+---
+
+## Installation
+
+Add to your Gemfile:
+
+```ruby
+gem 'telegem'
+```
+
+---
+
+Quick Start
+
+```ruby
+# Initialize with any Telegram file_id
+extractor = Telegem::Plugins::FileExtract.new(
+  bot,
+  ctx.message.document.file_id
+)
+
+# Extract content - auto-detects file type
+result = extractor.extract
+
+if result[:success]
+  # Unified response structure across all file types
+  puts "Type: #{result[:type]}"
+  puts "Content: #{result[:content]}"
+  puts "Metadata: #{result[:metadata]}"
+else
+  # Graceful error handling
+  puts "Error: #{result[:error]}"
+end
+```
+
+---
+
+Supported Formats
+
+| format | Mime type | extension | features |
+ |:--------:| :--------:| :--------: |:--------:|
+| pdf | application/pdf | .pdf | text extraction and page count |
+| json| application/json | .json | ful parsibg nested structure |
+| html | text/html | .html | tag stripping |
+| plain text| text/plain | .txt | full content |
+ 
+
+Note: All formats except PDF work without additional dependencies.
+
+---
+
+API Reference
+
+Constructor
+
+```ruby
+def initialize(bot, file_id, **options)
+```
+
+| Parameter |  Type Required | Default Description |
+ |:--------: | :--------:| :--------:| :--------:|
+| bot | Telegem::Bot ✓ | – Active bot instance
+| file_id | String ✓|  – Telegram file identifier
+| auto_delete |  Boolean  |true Remove temp files after processing|
+| max_size | Integer | 50_000_000 Maximum file size in bytes (50MB) |
+| timeout | Integer  | 30 Processing timeout in seconds |
+
+
+Instance Methods
+
+extract → Hash
+
+Processes the file and returns a standardized response hash.
+
+Success Response:
+
+```ruby
+{
+  success: true,
+  type: :pdf,                 # Symbol identifying file format
+  content: "extracted text",  # Parsed content (String, Hash, or Array)
+  metadata: {
+    size: 45210,             # File size in bytes
+    # Format-specific fields (see below)
+  },
+  error: nil
+}
+```
+
+Error Response:
+
+```ruby
+{
+  success: false,
+  type: :unknown,
+  content: nil,
+  metadata: {},
+  error: "Descriptive error message"
+}
+```
+
+---
+
+Format-Specific Behavior
+
+PDF Documents
+
+Requirements: gem 'pdf-reader'
+
+```ruby
+result = extractor.extract
+
+if result[:success]
+  puts "Pages: #{result[:metadata][:pages]}"
+  puts "Content: #{result[:content][0..500]}..."
+end
+```
+
+Metadata:
+
+```ruby
+metadata: {
+  pages: 12,        # Total page count
+  size: 1048576     # File size in bytes
+}
+```
+
+Error Cases:
+
+- Malformed PDF format – Corrupted or invalid PDF structure
+-  Encrypted PDF (password protected) – Document requires password
+- PDF contains no extractable text – Scanned/image-only document
+
+---
+
+JSON Documents
+
+```ruby
+result = extractor.extract
+
+if result[:success]
+  # Content is already parsed Ruby objects
+  data = result[:content]
+  puts data['user']['name']  # Direct hash access
+end
+```
+
+Metadata:
+
+```ruby
+metadata: {
+  size: 1250,
+  structure: "hash",    # "hash", "array", or "scalar"
+  keys: 5              # Top-level keys (hash only)
+}
+```
+
+Error Cases:
+
+- Invalid JSON: unexpected token – Syntax error with position
+- JSON file is empty – Zero-byte file
+- File encoding not supported – Non-UTF8 encoding
+
+---
+
+HTML Documents
+
+```ruby
+result = extractor.extract
+
+if result[:success]
+  # HTML tags stripped, whitespace normalized
+  text = result[:content]
+  
+  # Original HTML available when keep_original: true
+  original = result[:metadata][:original] if @keep_original
+end
+```
+
+Metadata:
+
+```ruby
+metadata: {
+  size: 3072,
+  original: "<html>...</html>"  # Only if keep_original: true
+}
+```
+
+Error Cases:
+
+- HTML file is empty – Zero-byte file
+- HTML contains no extractable text – Only tags, comments, or scripts
+
+---
+
+Text-Based Formats (TXT, CSV, Markdown)
+
+```ruby
+result = extractor.extract
+
+if result[:success]
+  lines = result[:metadata][:lines]
+  encoding = result[:metadata][:encoding]
+end
+```
+
+Metadata:
+
+```ruby
+metadata: {
+  size: 2048,
+  lines: 42,           # Line count
+  encoding: "UTF-8"    # Detected encoding
+}
+```
+
+Error Cases:
+- Text file is empty – Zero-byte file
+- File encoding not supported – Binary or invalid UTF-8
+
+---
+
+Error Handling
+
+FileExtractor never raises exceptions during normal operation. All errors are captured and returned in the standardized hash format.
+
+
+
+Client-Side Error Handling
+
+```ruby
+result = extractor.extract
+
+unless result[:success]
+  case result[:error]
+  when /encrypted/i
+    ctx.reply("🔒 Please send an unencrypted PDF")
+  when /malformed/i
+    ctx.reply("📄 File appears corrupted, please resend")
+  when /size exceeds/i
+    ctx.reply("📦 File too large (max 50MB)")
+  else
+    ctx.reply("❌ #{result[:error]}")
+  end
+end
+```
+
+---
+
+
+Benchmarks: (50KB file, Ruby 3.2)
+
+-  PDF: ~150ms
+-  JSON: ~20ms
+- HTML: ~15ms
+- Text: ~5ms
+
+---
+
+Security Considerations
+
+File Size Limits
+
+Default max_size: 50_000_000 prevents denial-of-service attacks via large file uploads.
+
+Temporary File Management
+
+All files are written to Dir.tmpdir with:
+
+- Random filename generation (SecureRandom.hex)
+-  Automatic deletion (auto_delete: true)
+-  Explicit cleanup in ensure blocks
+
+Memory Protection
+
+- Large files are never fully read into memory unless required
+- Streaming parsers used where available
+-  Configurable timeouts prevent hanging operations
+
+---
+
+Common Patterns
+
+Reply-to-Message Processing
+
+```ruby
+bot.command('extract') do |ctx|
+  replied = ctx.message.reply_to_message
+  
+  if replied&.document
+    result = FileExtractor.new(bot, replied.document.file_id).extract
+    
+    if result[:success]
+      ctx.reply("📄 Extracted from #{result[:type]}:\n\n#{result[:content][0..300]}")
+    else
+      ctx.reply("❌ #{result[:error]}")
+    end
+  end
+end
+```
+
+Batch Processing
+
+```ruby
+files = updates.map do |update|
+  next unless update.message&.document
+  
+  Thread.new do
+    FileExtractor.new(bot, update.message.document.file_id).extract
+  end
+end.map(&:value)
+```
+
+Caching Extracted Content
+
+```ruby
+class CachedExtractor < Telegem::Plugins::FileExtractor
+  def extract
+    cache_key = "extract:#{@file_id}"
+    
+    Rails.cache.fetch(cache_key, expires_in: 1.hour) do
+      super
+    end
+  end
+end
+```
+
+---
+
+Troubleshooting
+
+PDF::Reader Not Found
+
+```
+LoadError: cannot load such file -- pdf/reader
+```
+
+Solution: gem install pdf-reader or add to Gemfile
+
+File ID Expired
+
+```
+Error: File not found
+```
+
+Solution: File IDs expire after 24 hours. Request fresh file from user.
+
+Memory Usage Spikes
+
+Solution: Reduce max_size or process files sequentially rather than in parallel.
+
+Unsupported File Types
+
+Solution: Check file extension or MIME type before extraction:
+
+```ruby
+if ctx.message.document.mime_type.start_with?('image/')
+  # Handle images separately
+else
+  result = FileExtractor.new(bot, file_id).extract
+end
+```

data/lib/core/bot.rb

@@ -134,6 +134,22 @@ module Telegem
         end 
       end 
       
+      def set_my_profile_photo(photo, **options)
+        @api.call('setMyProfilePhoto', { photo: photo }.merge(options))
+      end
+
+      def remove_my_profile_photo
+        @api.call('removeMyProfilePhoto', {})
+      end
+
+      def get_user_profile_audios(user_id, **options)
+        result = @api.call('getUserProfileAudios', { user_id: user_id }.merge(options))
+        result ? Types::UserProfileAudios.new(result) : nil
+      end
+
+      def create_forum_topic(chat_id, name, **options)
+        @api.call('createForumTopic', { chat_id: chat_id, name: name }.merge(options))
+      end
       def location(&block)
         on(:message, location: true) do |ctx|
           block.call(ctx) 
@@ -369,4 +385,4 @@ module Telegem
       end
     end
   end
-end
+end 

data/lib/markup/keyboard.rb

@@ -27,14 +27,19 @@ module Telegem
         self
       end
 
-      def button(text, **options)
-        if @buttons.empty? || !@buttons.last.is_a?(Array)
-          @buttons << [{ text: text }.merge(options)]
-        else
-          @buttons.last << { text: text }.merge(options)
-        end
-        self
-      end
+      def button(text, style: nil, icon_custom_emoji_id: nil, **options)
+        btn = {
+          text: text
+      }.merge(options)
+      btn[:style] = style if style 
+      btn[:icon_custom_emoji_id] = icon_custom_emoji_id if icon_custom_emoji_id
+      if @buttons.empty? || @buttons.last.is_a?(Array)
+        @buttons << [btn]
+      else 
+        @buttons.last << btn
+      end 
+      self 
+    end 
 
       def request_contact(text)
         button(text, request_contact: true)
@@ -114,14 +119,19 @@ module Telegem
         self
       end
 
-      def button(text, **options)
-        if @buttons.empty? || !@buttons.last.is_a?(Array)
-          @buttons << [{ text: text }.merge(options)]
-        else
-          @buttons.last << { text: text }.merge(options)
-        end
-        self
-      end
+     def button(text, style: nil, icon_custom_emoji_id: nil, **options)
+        btn = {
+          text: text
+      }.merge(options)
+      btn[:style] = style if style 
+      btn[:icon_custom_emoji_id] = icon_custom_emoji_id if icon_custom_emoji_id
+      if @buttons.empty? || @buttons.last.is_a?(Array)
+        @buttons << [btn]
+      else 
+        @buttons.last << btn
+      end 
+      self 
+    end 
 
       def url(text, url)
         button(text, url: url)

data/lib/telegem.rb

@@ -1,12 +1,12 @@
-# lib/telegem.rb - MAIN ENTRY POINT
+
 require 'logger'
 require 'json'
 
 module Telegem
-  VERSION = "3.2.2".freeze 
+  VERSION = "3.2.4".freeze
 end
 
-# Load core components
+#
 require_relative 'api/client'
 require_relative 'api/types'
 require_relative 'core/bot'
@@ -16,17 +16,17 @@ require_relative 'core/scene'
 require_relative 'session/middleware'
 require_relative 'session/memory_store'
 require_relative 'markup/keyboard'
-# Webhook is loaded lazily when needed
+
 require_relative 'plugins/file_extract'
 require_relative 'session/scene_middleware'
 
 module Telegem
-  # Main entry point: Telegem.new(token)
+
   def self.new(token, **options)
     Core::Bot.new(token, **options)
   end
   
-  # Shortcut for creating keyboards
+
   def self.keyboard(&block)
     Markup.keyboard(&block)
   end
@@ -35,28 +35,23 @@ module Telegem
     Markup.inline(&block)
   end
   
-  # Remove keyboard markup
   def self.remove_keyboard(**options)
     Markup.remove(**options)
   end
   
-  # Force reply markup
   def self.force_reply(**options)
     Markup.force_reply(**options)
   end
   
-  # Current version
   def self.version
     VERSION
   end
-  
-  # Quick webhook setup
+
   def self.webhook(bot, **options)
     require_relative 'webhook/server'
     Webhook::Server.setup(bot, **options)
   end
   
-  # Framework information
   def self.info
     <<~INFO
       🤖 Telegem #{VERSION}
@@ -77,7 +72,7 @@ module Telegem
   end
 end
 
-# Optional global shortcut (enabled by env var)
+
 if ENV['TELEGEM_GLOBAL'] == 'true'
   def Telegem(token, **options)
     ::Telegem.new(token, **options)

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: telegem
 version: !ruby/object:Gem::Version
-  version: 3.2.2
+  version: 3.2.4
 platform: ruby
 authors:
 - sick_phantom
@@ -9,34 +9,20 @@ bindir: bin
 cert_chain: []
 date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
-- !ruby/object:Gem::Dependency
-  name: httpx
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.0'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.0'
 - !ruby/object:Gem::Dependency
   name: concurrent-ruby
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.0'
+        version: 1.3.6
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.0'
+        version: 1.3.6
 - !ruby/object:Gem::Dependency
   name: securerandom
   requirement: !ruby/object:Gem::Requirement
@@ -57,56 +43,56 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.0'
+        version: 2.35.2
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.0'
+        version: 2.35.2
 - !ruby/object:Gem::Dependency
   name: async-http
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.100'
+        version: 0.92.1
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.100'
+        version: 0.92.1
 - !ruby/object:Gem::Dependency
   name: pdf-reader
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.0'
+        version: 2.14.1
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.0'
+        version: 2.14.1
 - !ruby/object:Gem::Dependency
   name: docx
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.3'
+        version: 0.10.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.3'
+        version: 0.10.0
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
@@ -158,6 +144,9 @@ files:
 - assets/logo.png
 - bin/.gitkeep
 - bin/telegem-ssl
+- docs/.gitkeep
+- docs/ctx.md
+- docs/file_extract.md
 - examples/.gitkeep
 - lib/api/client.rb
 - lib/api/types.rb
@@ -173,7 +162,6 @@ files:
 - lib/session/memory_store.rb
 - lib/session/middleware.rb
 - lib/session/scene_middleware.rb
-- lib/telegem.code-workspace
 - lib/telegem.rb
 - lib/webhook/.gitkeep
 - lib/webhook/server.rb
@@ -188,7 +176,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.2.2!\n\n\U0001F4DA Documentation:
+post_install_message: "Thanks for installing Telegem 3.2.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/lib/telegem.code-workspace

@@ -1,8 +0,0 @@
-{
-	"folders": [
-		{
-			"path": ".."
-		}
-	],
-	"settings": {}
-}