telegem 3.3.1 → 3.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0d2afc9e262ffced76a28974a69c6e652bf433b2b6da80c6827d45e6da43002a
-  data.tar.gz: 61f440f2523473e3f5435075bfece0519c374f4aa498d789cc6752c5ce285abf
+  metadata.gz: 45cc39ffb7a5897950caff2309dbeb1e5d479d8d20e13e2219fc9165ec4026d5
+  data.tar.gz: '039472d0308d1e42b752cee2a93a0cdd0880ee1677608964911d5ba6e947a750'
 SHA512:
-  metadata.gz: 378d55910d0b38b255b35ea357af4cb88f45000362b9d16688dff82a02fe3e5119e71e591c2cec61556d9c9cc82c0edd914ba7cd153ba1cae04c0e97b3f6d229
-  data.tar.gz: 527cb2833282c03d7f19145d7421e6df5d867ffbb479846ac9e969a8be339450c7358fdefaced5952dfc7d96b999348253a2494b2a2fe3d9c55480073587a421
+  metadata.gz: 8108374c406751c497c309a50a40a7aa99776f1c6871a2f1cc700b96bfa328046bdcaf2e9848cd9aa28b90dcb780f42f1c790ad03f85261d3a16c1802186c812
+  data.tar.gz: 37f9fd3006d5702f049f79817e9a9fe0054c04b4ecbdedd4e06daa2fe314f28eb98fdfb539fdcba4280c12a9eeff82c2b7851eb2edb2c28c5285a8eb94e223a8

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

@@ -1,6 +1,50 @@
 # Telegem Changelog
 
-## v3.3.1(lastest) 
+## v3.5.0 (latest)
+
+### Added
+- **Bot API 10.0 Full Support**
+  - Guest mode support: `SentGuestMessage` type and `guest_message` update type
+  - Message reactions: Support for deleting reactions via `call('deleteAllMessageReactions', ...)` and `call('deleteMessageReaction', ...)`
+  - Live photos: `LivePhoto`, `InputMediaLivePhoto`, `PaidMediaLivePhoto`, `InputPaidMediaLivePhoto` types
+  - Poll media enhancements: `PollMedia`, `InputPollMedia`, `InputPollOptionMedia` types
+  - Business access: New types and methods accessible via generic `call` method
+  - Enhanced chat administrators: Support for `return_bots` parameter in `getChatAdministrators`
+  - User guest query support: `supports_guest_queries` field in User type
+  - Message guest fields: `guest_bot_caller_user`, `guest_bot_caller_chat`, `guest_query_id`, `live_photo` in Message type
+  - Poll media fields: `media`, `explanation_media` in Poll type; `media` in PollOption type
+  - Reaction permissions: `can_react_to_messages` in ChatPermissions and ChatMemberRestricted types
+
+### Changed
+- Updated API version support to Bot API 10.0
+- All new API methods automatically supported through generic `call()` and `call!()` methods
+
+## v3.4.0
+
+- added bot api 9.6 full support 
+- all fixes from v3.3.2-rc.1
+- enhanced install message
+- requires ruby v >= 3.4.x
+- added bot api 9.6 helper to ctx
+- introduced redis store to `session/redis_store.rb`
+- new translate plugin
+- added more docs to support telegem -v 3.x
+- improved error message on invalid middlewares
+- removed `concurrent-ruby` gem to keep telegem lightweight
+
+## 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 

data/README.md

@@ -0,0 +1,148 @@
+# Telegem Documentation
+
+Welcome to the comprehensive documentation for Telegem, a modern Ruby framework for building Telegram bots.
+
+[![CodeQl](https://github.com/slick-lab/telegem/actions/workflows/github-code-scanning/codeql/badge.svg)](https://github.com/slick-lab/telegem/actions/workflows/github-code-scanning/codeql)
+[![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"