telegem 3.3.0 → 3.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 156ed056e2f5201d26aaa636b1bd2fdace0499dedca7aa52cff1692546480733
-  data.tar.gz: b0fef7cc585db195c4eeef5c0d656a659b1d12f8e9ea25506745c9318bc5dca8
+  metadata.gz: 3a7cc82173aa5648e1b1d119971c9fec495db0bb9f2764135ffa15bd5c641e1e
+  data.tar.gz: ec409f5eecba8209c1f1f7e6237f2eddddebb67251fe9ffe4d8f329845256758
 SHA512:
-  metadata.gz: a99c675b08fec66843ecc4d41880a74043a0498a486db404049e63eeb523ab746f186c482ce828550e010fa8f4f4ebd1102507e73532fb681c912c48c144417e
-  data.tar.gz: 0dc7360428b2d1fcfe383941f54c0b44f75af45c35eb7cb9cfbbfee190445c095bd5fac6007cd2ec885736ec8eea38ca9e286030b9b4486cd97ac4bef353d96c
+  metadata.gz: 0e3eaf7311d7cf248b0b59bfa1e0fd7a4ae745129dae8abc0d6a50be55b85c8d86a399913585e72b70fbff935e07450418d6085d2e3ce7ba8e6de3999235593c
+  data.tar.gz: 93f600342a065a36014d8e3d0c37c455ec1bfe1db9ac43801ce5b9cb04d66906dd036b7b239f2e47359bb36cb324ed2fdb3894d56ea146abafd9c20612670a06

data/.rubocop.yml

@@ -0,0 +1,57 @@
+AllCops:
+  TargetRubyVersion: 3.3
+  NewCops: enable
+  DisplayCopNames: true
+  Exclude:
+    - 'bin/**/*'
+    - 'node_modules/**/*'
+    - 'vendor/**/*'
+    - 'tmp/**/*'
+    - 'log/**/*'
+    - 'db/schema.rb'
+
+# Optional: enable extra cops if you add gems (rubocop-performance, rubocop-rspec, rubocop-security)
+# require:
+#   - rubocop-performance
+#   - rubocop-rspec
+#   - rubocop-security
+
+Layout/LineLength:
+  Max: 100
+
+Layout/IndentationWidth:
+  Width: 2
+
+Metrics/MethodLength:
+  Max: 30
+  CountComments: false
+
+Metrics/BlockLength:
+  Exclude:
+    - 'spec/**/*'
+    - 'test/**/*'
+  Max: 200
+
+Style/StringLiterals:
+  EnforcedStyle: single_quotes
+
+Style/FrozenStringLiteralComment:
+  Enabled: true
+
+Naming/PredicateName:
+  Enabled: true
+
+Lint/UnusedMethodArgument:
+  Enabled: true
+
+Lint/UselessAssignment:
+  Enabled: true
+
+Style/Documentation:
+  Enabled: false
+
+# Allow longer files for generated code
+Metrics/LineLength:
+  Exclude:
+    - 'assets/**/*'
+    - 'vendor/**/*'

data/CHANGELOG.md

@@ -0,0 +1,121 @@
+# Telegem Changelog
+
+## v3.4.0(latest)
+
+- added bot api 9.6 full support 
+- all fixes from v3.3.2-rc.1
+
+
+## v3.3.2-rc.1
+
+### Fixed
+- Webhook `set_webhook` now correctly passes URL as positional argument
+- Removed unsafe thread usage in `Context#with_typing` (async-safe now)
+- Added automatic retry with exponential backoff in API client
+- Improved `telegem-ssl` to detect dnf/yum on Fedora/RHEL
+
+### Changed
+- No breaking changes. Safe upgrade from v3.3.1.
+
+
+## v3.3.1
+### Features 
+- improved memeorystore to include diskbackup
+- added 'telegem-init' cli 
+
+
+## v3.1.1 
+
+### New Features
+
+-FileExtractor Plugin: New plugin for extracting content from various file types (PDF, JSON, HTML, TXT)
+- Async File Download: Added download method to API client for downloading Telegram files
+- Context File Helpers: Added download_file, download_photo, download_document methods to Context
+- Extended File Support: Plugin supports PDF text extraction, JSON parsing, HTML/raw text processing
+- Async/Sync Dual Mode: All file operations available in both sync (download) and async (download!) modes
+
+## v3.1.0 
+
+### features 
+- BREAKING: Rewrote polling system to prevent duplicate messages
+- Fixed thread deadlock in async polling loop
+- Added scene_middleware.rb for scene-based conversations
+- Improved MemoryStore with TTL and thread safety
+- Enhanced keyboard markup builder with web_app support
+-  Added message reaction and chat boost update types
+- Fixed callback query handling for inline keyboards
+
+## v3.0.0
+### features 
+
+- BREAKING: Complete async rewrite with async gem
+- New HTTP client using HTTPX with proper async/await pattern
+- Added scene system for multi-step conversations
+- Middleware composer system for plugin architecture
+- Type system with dynamic accessors for Telegram objects
+- Session management with memory store
+- Rate limiting middleware
+- File upload support via multipart forms
+
+## v2.0.0
+
+- BREAKING: Ruby 3.0+ requirement
+- Added webhook support with Rack middleware
+- Inline query and callback query handlers
+- Location, contact, and poll answer handlers
+- Keyboard markup helpers (Telegem::Markup)
+- Improved error handling with custom error classes
+- Logging integration with configurable loggers
+
+## v1.5.0
+
+- Added command argument parsing (ctx.command_args)
+- Message entity parsing (mentions, hashtags, bot commands)
+- Chat member update handlers
+- Pre-checkout and shipping query support
+- File download helper methods
+- Context helper methods for common API calls
+
+## v1.0.0
+
+- Stable API release
+- Message handlers with text pattern matching
+- Command handlers with regex support
+- Basic context object with chat/message accessors
+- Simple API client with error handling
+- Polling and webhook modes
+- Configuration options for timeout and limits
+
+## v0.5.0
+
+- Added callback query support
+- Inline keyboard builder
+- Message editing and deletion helpers
+- Media sending methods (photo, document, audio, video)
+- Chat action methods (typing, upload indicators)
+
+## v0.3.0
+
+- Middleware system with bot.use
+- Session management foundation
+- Basic rate limiting
+- Command filtering by chat type
+- Improved logging with debug levels
+
+## v0.2.0
+
+- Basic polling implementation
+- Message type detection (text, photo, document)
+- Command parsing with arguments
+- Simple reply methods
+- Error handling for API calls
+
+## v0.1.0 (Initial Release)
+
+- Basic Telegram Bot API wrapper
+- Send/receive messages
+- Simple command handling
+- Minimal dependencies (just httparty)
+- Support for basic message types
+
+---

data/Gemfile

@@ -5,5 +5,5 @@ gemspec
 group :development do
   gem 'rake', '~> 13.0'
   gem 'rspec', '~> 3.0'
-  gem 'pry', '~> 0.14.0'
+  gem 'pry', '~> 0.16.0'
 end

data/README.md

@@ -0,0 +1,147 @@
+# Telegem Documentation
+
+Welcome to the comprehensive documentation for Telegem, a modern Ruby framework for building Telegram bots.
+
+[![Gem Version](https://badge.fury.io/rb/telegem.svg)](https://badge.fury.io/rb/telegem)
+[![Join Telegram Group](https://img.shields.io/badge/Telegram-Join%20Group-2CA5E0?style=flat-square&logo=telegram&logoColor=white)](https://t.me/r_telegem)
+
+
+
+## Table of Contents
+
+### Getting Started
+- [README](README.md) - Main project README
+- [Getting Started](getting_started.md) - Installation and basic setup
+- [Core Concepts](core_concepts.md) - Understanding Telegem architecture
+
+### Core Components
+- [Bot](bot.md) - Main bot class and configuration
+- [Context](context.md) - Update context and response methods
+- [Handlers](handlers.md) - Command, hears, and event handlers
+- [Middleware](middleware.md) - Request processing pipeline
+- [Scenes](scenes.md) - Multi-step conversation flows
+- [Sessions](sessions.md) - Data persistence between updates
+
+### API & Types
+- [API](api.md) - Telegram API client usage
+- [Types](types.md) - Type-safe API response handling
+- [Keyboards](keyboards.md) - Inline and reply keyboard DSL
+
+### Advanced Features
+- [Plugins](plugins.md) - Built-in and custom plugins
+- [Webhooks](webhooks.md) - Production webhook deployment
+- [Error Handling](error_handling.md) - Comprehensive error management
+- [Testing](testing.md) - Unit and integration testing
+- [Deployment](deployment.md) - Production deployment guides
+
+### Examples & Guides
+- [Examples](examples.md) - Complete bot examples
+- [Troubleshooting](troubleshooting.md) - Common issues and solutions
+- [Contributing](contributing.md) - Development guidelines
+- [Changelog](changelog.md) - Version history and changes
+
+## Quick Start
+
+1. **Install Telegem:**
+```bash
+gem install telegem
+```
+
+2. **Create your first bot:**
+```ruby
+require 'telegem'
+
+bot = Telegem.new(token: 'YOUR_BOT_TOKEN')
+
+bot.command('start') do |ctx|
+  ctx.reply('Hello, World!')
+end
+
+bot.start_polling
+```
+
+3. **Explore features:**
+   - Add [handlers](handlers.md) for different message types
+   - Use [sessions](sessions.md) for data persistence
+   - Implement [scenes](scenes.md) for complex conversations
+   - Deploy with [webhooks](webhooks.md) for production
+
+## Key Features
+
+- **Async I/O**: Built on the Async gem for high performance
+- **Type Safety**: Automatic type conversion for API responses
+- **Session Management**: Built-in session stores (Memory, Redis)
+- **Plugin System**: Extensible with custom plugins
+- **Scene System**: Complex conversation flows
+- **Middleware**: Request processing pipeline
+- **Error Handling**: Comprehensive error recovery
+- **Testing**: Full test suite with mocking support
+
+## Architecture Overview
+
+```
+┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐
+│   Telegram API  │◄──►│   API Client    │◄──►│     Handlers     │
+└─────────────────┘    └─────────────────┘    └─────────────────┘
+                                ▲
+                                │
+                    ┌─────────────────┐
+                    │   Middleware    │
+                    └─────────────────┘
+                                ▲
+                                │
+                    ┌─────────────────┐
+                    │    Sessions     │
+                    └─────────────────┘
+```
+
+## Support
+
+- **Documentation**: You're reading it!
+- **Issues**: [GitHub Issues](https://github.com/telegem/telegem/issues)
+- **Discussions**: [GitHub Discussions](https://github.com/telegem/telegem/discussions)
+- **Examples**: Check the `examples/` directory
+
+## Contributing
+
+We welcome contributions! See our [contributing guide](contributing.md) for details.
+
+## License
+
+Telegem is released under the MIT License. See the main README for details.
+
+---
+
+**Happy bot building with Telegem! 🤖**
+
+```ruby
+gem 'telegem'
+```
+
+## Basic Usage
+
+```ruby
+require 'telegem'
+
+bot = Telegem.new('YOUR_BOT_TOKEN')
+
+bot.command('start') do |ctx|
+  ctx.reply("Hello, #{ctx.from.first_name}!")
+end
+
+bot.start_polling
+```
+
+## Requirements
+
+- Ruby 3.0+
+- Telegram Bot Token from [@BotFather](https://t.me/botfather)
+
+## License
+
+MIT License - see [LICENSE](../LICENSE) file for details.
+
+## Contributing
+
+See [Contributing Guide](contributing.md) for development setup and contribution guidelines.</content>
+<parameter name="filePath">/home/slick/telegem/docs/README.md

data/bin/telegem-ssl

@@ -4,48 +4,94 @@
 require 'fileutils'
 require 'yaml'
 
-puts "🔐 Telegem SSL Setup"
-puts "=" * 10
+puts "Telegem SSL Setup"
+puts "=" * 40
 
+# Check for existing config
 if File.exist?('.telegem-ssl')
-  puts "🚫 SSL config already exists at .telegem-ssl"
+  puts "SSL config already exists at .telegem-ssl"
   print "Overwrite? (y/n): "
-  exit unless gets.chomp.downcase == 'y'
+  response = gets.chomp.downcase
+  unless response == 'y'
+    puts "Setup cancelled."
+    exit 1
+  end
 end
 
 # Get domain
 domain = ARGV[0]
 unless domain
-  print "🌐 Enter domain (e.g., bot.example.com): "
+  print "Enter domain (e.g., bot.example.com): "
   domain = gets.chomp
 end
 
-# Get email  
+# Get email
 email = ARGV[1] || "admin@#{domain}"
 
-# Check certbot
-unless system("which certbot > /dev/null")
-  puts "📦 Installing certbot..."
-  system("sudo apt update && sudo apt install -y certbot")
+# Detect package manager and install certbot
+def install_certbot
+  return true if system("command -v certbot > /dev/null 2>&1")
+  
+  puts "Installing certbot..."
+  
+  case
+  when system("command -v apt > /dev/null 2>&1")
+    system("sudo apt update && sudo apt install -y certbot")
+  when system("command -v dnf > /dev/null 2>&1")
+    system("sudo dnf install -y certbot")
+  when system("command -v yum > /dev/null 2>&1")
+    system("sudo yum install -y certbot")
+  when system("command -v brew > /dev/null 2>&1")
+    system("brew install certbot")
+  else
+    puts "Could not detect package manager. Please install certbot manually:"
+    puts "  https://certbot.eff.org/instructions"
+    return false
+  end
+  
+  system("command -v certbot > /dev/null 2>&1")
+end
+
+unless install_certbot
+  puts "Failed to install certbot. Exiting."
+  exit 1
 end
 
 # Generate certificate
-puts "\n📄 Getting SSL certificate..."
+puts "Getting SSL certificate..."
+
+# Try standalone mode first, fall back to webroot
 cert_cmd = "sudo certbot certonly --standalone -d #{domain} --email #{email} --agree-tos --non-interactive"
 puts "Running: #{cert_cmd}"
 
-if system(cert_cmd)
-  # Create config
-  config = {
-    domain: domain,
-    cert_path: "/etc/letsencrypt/live/#{domain}/fullchain.pem",
-    key_path: "/etc/letsencrypt/live/#{domain}/privkey.pem"
-  }
+unless system(cert_cmd)
+  puts "Standalone mode failed. Trying webroot mode..."
+  print "Enter webroot path (e.g., /var/www/html): "
+  webroot = gets.chomp
   
-  File.write(".telegem-ssl", config.to_yaml)
-  puts "✅ SSL configured! Certificate valid for 90 days."
-  puts "📁 Config saved to .telegem-ssl"
-  puts "\n🚀 Start your bot: ruby bot.rb"
-else
-  puts "❌ Failed to get certificate. Check domain and try again."
-end
+  cert_cmd = "sudo certbot certonly --webroot -w #{webroot} -d #{domain} --email #{email} --agree-tos --non-interactive"
+  puts "Running: #{cert_cmd}"
+  
+  unless system(cert_cmd)
+    puts "Failed to get certificate. Check domain and try again."
+    exit 1
+  end
+end
+
+# Create config
+config = {
+  domain: domain,
+  cert_path: "/etc/letsencrypt/live/#{domain}/fullchain.pem",
+  key_path: "/etc/letsencrypt/live/#{domain}/privkey.pem"
+}
+
+File.write(".telegem-ssl", config.to_yaml)
+puts "SSL configured. Certificate valid for 90 days."
+puts "Config saved to .telegem-ssl"
+
+# Auto-renewal instructions
+puts "\nAuto-renewal setup (recommended):"
+puts "  Add this to crontab (crontab -e):"
+puts "  0 0 1 * * certbot renew --quiet && systemctl reload your-bot"
+
+puts "\nStart your bot: ruby bot.rb"