telegem 3.4.0 → 3.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3a7cc82173aa5648e1b1d119971c9fec495db0bb9f2764135ffa15bd5c641e1e
-  data.tar.gz: ec409f5eecba8209c1f1f7e6237f2eddddebb67251fe9ffe4d8f329845256758
+  metadata.gz: 4afe1dcca2394d2581b01adf2f297704cce042bbb305837b69d67db564d32078
+  data.tar.gz: '05094b45797bea03c29e90e41579039b68edcc3d45e4dfd53956f0c4096f9cb6'
 SHA512:
-  metadata.gz: 0e3eaf7311d7cf248b0b59bfa1e0fd7a4ae745129dae8abc0d6a50be55b85c8d86a399913585e72b70fbff935e07450418d6085d2e3ce7ba8e6de3999235593c
-  data.tar.gz: 93f600342a065a36014d8e3d0c37c455ec1bfe1db9ac43801ce5b9cb04d66906dd036b7b239f2e47359bb36cb324ed2fdb3894d56ea146abafd9c20612670a06
+  metadata.gz: 182b284882e0df817bd5ecb593c3408c37a3e70fc28167013bf21aa5e6118132415103b26ae2bb2c3eaa223b260643714613c4dfeaea20d9c3c50108d744239e
+  data.tar.gz: dbe43b9158685118b5b1ca4354f8774bfb86ccaf968b7b8be188eb0fb5fd792d58667e2b8cf97f84d7495e8ef8d30d06737882af400a73a225f414446a8fb0be

data/.anv

@@ -0,0 +1,2 @@
+MqN668oTPw02OB5qFP+xPQtmeYEWQcSYBRVKxCAivCMPyOXtN05diXDe+WFt
+PteENrSqYiUv3BYtr/Ox0+r2nsIvWbYcv6x/+4q2cwILkcE=

data/CHANGELOG.md

@@ -1,10 +1,36 @@
 # Telegem Changelog
 
-## v3.4.0(latest)
+## 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
 

data/README.md

@@ -2,6 +2,8 @@
 
 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)
+[![Lines of Code](https://img.shields.io/badge/LOC-2907-red)](https://github.com/slick-lab/telegem)
 [![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)
 

data/_config.yml

@@ -0,0 +1,10 @@
+site:
+  title: Telegem Documentation
+  description: Build Telegram bots with Ruby - Complete documentation and guides
+  url: https://slick-lab.github.io/telegem
+  baseurl: /telegem
+theme: jekyll-theme-slate
+markdown: kramdown
+kramdown:
+  input: GFM
+  hard_wrap: false

data/docs/changelog.md

@@ -1,182 +1,147 @@
-# Changelog
+# Telegem Changelog
 
-All notable changes to Telegem will be documented in this file.
-
-The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
-and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
-
-## [Unreleased]
+## v3.5.0 (latest)
 
 ### Added
-- Comprehensive documentation covering all features and edge cases
-- Error handling guide with recovery strategies
-- Deployment guides for various platforms (Heroku, Docker, AWS)
-- Testing framework with examples and best practices
-- Troubleshooting guide for common issues
-- Performance optimization tips
-- Security best practices
-- Plugin development guide
-- Async operation handling
-- Rate limiting middleware
-- Health check endpoints
-- Structured logging support
-- Connection pooling for better performance
-- Graceful degradation features
-- Input validation middleware
-- Monitoring and metrics collection
+- **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
-- Improved error messages and user feedback
-- Enhanced session management with TTL support
-- Better async operation handling
-- More robust webhook server implementation
-- Improved plugin architecture
+- 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
-- Memory leaks in long-running processes
-- Race conditions in concurrent operations
-- File upload size validation
-- SSL certificate handling
-- Session persistence issues
+- 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
 
-## [1.0.0] - 2024-01-15
+### Changed
+- No breaking changes. Safe upgrade from v3.3.1.
 
-### Added
-- Initial release of Telegem framework
-- Core bot functionality with command and hears handlers
-- Telegram API client with automatic retries
-- Session management with memory and Redis stores
-- Scene system for multi-step conversations
-- Inline and reply keyboard DSL
-- Webhook and polling support
-- FileExtract plugin for document processing
-- Translate plugin for text translation
-- Middleware system for request processing
-- Type-safe API response handling
-- Comprehensive error handling
-- Async I/O support with Async gem
-- Rate limiting and timeout handling
-- SSL/TLS support for webhooks
-
-### Technical Details
-- Ruby 3.0+ requirement
-- Async gem for concurrency
-- Modular architecture with plugins
-- RESTful API design
-- Comprehensive test coverage
-- Production-ready deployment options
 
----
+## v3.3.1
+### Features 
+- improved memeorystore to include diskbackup
+- added 'telegem-init' cli 
 
-## Version History
-
-### Pre-1.0 Releases
-
-#### [0.5.0] - 2023-12-01
-- Beta release with core functionality
-- Basic bot operations
-- API client implementation
-- Handler system
-- Session management
-
-#### [0.3.0] - 2023-11-15
-- Alpha release
-- Basic Telegram API integration
-- Command parsing
-- Message handling
-
-#### [0.1.0] - 2023-10-01
-- Initial prototype
-- Basic bot framework structure
-- Proof of concept implementation
-
-## Migration Guide
-
-### Upgrading from 0.x to 1.0
-
-#### Breaking Changes
-1. **Handler Registration:**
-   ```ruby
-   # Old
-   bot.on('/start') { |ctx| ... }
-
-   # New
-   bot.command('start') { |ctx| ... }
-   ```
-
-2. **Session Store:**
-   ```ruby
-   # Old
-   bot.session_store = Redis.new
-
-   # New
-   bot.session_store = Telegem::Session::RedisStore.new(ENV['REDIS_URL'])
-   ```
-
-3. **Middleware:**
-   ```ruby
-   # Old
-   bot.middleware.add(MyMiddleware)
-
-   # New
-   bot.use MyMiddleware.new
-   ```
-
-#### New Features
-- Async operations support
-- Plugin system
-- Enhanced error handling
-- Webhook SSL support
-- Scene system improvements
-
-#### Migration Steps
-1. Update handler registrations
-2. Configure new session store format
-3. Update middleware usage
-4. Add error handling
-5. Test thoroughly
-
-## Future Plans
-
-### Version 1.1.0 (Planned)
-- [ ] Database session store
-- [ ] Message queue integration
-- [ ] Advanced rate limiting
-- [ ] Bot analytics dashboard
-- [ ] Multi-language support
-
-### Version 1.2.0 (Planned)
-- [ ] Voice message handling
-- [ ] Location services integration
-- [ ] Payment processing
-- [ ] Bot-to-bot communication
-- [ ] Advanced scene workflows
-
-### Version 2.0.0 (Planned)
-- [ ] GraphQL API support
-- [ ] Real-time updates with WebSocket
-- [ ] Machine learning integrations
-- [ ] Advanced NLP features
-- [ ] Multi-platform bot support
-
-## Contributing
-
-When contributing to Telegem, please:
-1. Update the changelog with your changes
-2. Follow the existing format
-3. Add entries under [Unreleased] section
-4. Categorize changes as Added, Changed, Fixed, or Removed
-
-## Categories
-
-- **Added** for new features
-- **Changed** for changes in existing functionality
-- **Deprecated** for soon-to-be removed features
-- **Removed** for now removed features
-- **Fixed** for any bug fixes
-- **Security** in case of vulnerabilities
 
----
+## 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
 
-This changelog follows the principles of [Keep a Changelog](https://keepachangelog.com/en/1.0.0/) and is automatically updated with each release.</content>
-<parameter name="filePath">/home/slick/telegem/docs/changelog.md
+- 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
+
+---