telegem 3.3.0 → 3.3.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 156ed056e2f5201d26aaa636b1bd2fdace0499dedca7aa52cff1692546480733
-  data.tar.gz: b0fef7cc585db195c4eeef5c0d656a659b1d12f8e9ea25506745c9318bc5dca8
+  metadata.gz: 0d2afc9e262ffced76a28974a69c6e652bf433b2b6da80c6827d45e6da43002a
+  data.tar.gz: 61f440f2523473e3f5435075bfece0519c374f4aa498d789cc6752c5ce285abf
 SHA512:
-  metadata.gz: a99c675b08fec66843ecc4d41880a74043a0498a486db404049e63eeb523ab746f186c482ce828550e010fa8f4f4ebd1102507e73532fb681c912c48c144417e
-  data.tar.gz: 0dc7360428b2d1fcfe383941f54c0b44f75af45c35eb7cb9cfbbfee190445c095bd5fac6007cd2ec885736ec8eea38ca9e286030b9b4486cd97ac4bef353d96c
+  metadata.gz: 378d55910d0b38b255b35ea357af4cb88f45000362b9d16688dff82a02fe3e5119e71e591c2cec61556d9c9cc82c0edd914ba7cd153ba1cae04c0e97b3f6d229
+  data.tar.gz: 527cb2833282c03d7f19145d7421e6df5d867ffbb479846ac9e969a8be339450c7358fdefaced5952dfc7d96b999348253a2494b2a2fe3d9c55480073587a421

data/CHANGELOG.md

@@ -0,0 +1,103 @@
+# Telegem Changelog
+
+## v3.3.1(lastest) 
+### 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

@@ -4,10 +4,6 @@ Modern, blazing-fast async Telegram Bot API for Ruby - Inspired by Telegraf, bui
 
 ![Gem Version](https://badge.fury.io/rb/telegem.svg) ![GitLab](https://img.shields.io/badge/gitlab-telegem-orange) ![Ruby Version](https://img.shields.io/badge/Ruby-3.0+-red.svg) ![License](https://img.shields.io/badge/License-MIT-blue.svg) ![Async I/O](https://img.shields.io/badge/Async-I/O-green.svg) 
 
-![GitLab stars](https://img.shields.io/gitlab/stars/ruby-telegem/telegem?style=for-the-badge&logo=gitlab&color=orange)
-![GitLab contributors](https://img.shields.io/gitlab/contributors/ruby-telegem/telegem?style=for-the-badge&logo=gitlab)
-![GitLab last commit](https://img.shields.io/gitlab/last-commit/ruby-telegem/telegem?style=for-the-badge&logo=gitlab)
-![GitLab license](https://img.shields.io/gitlab/license/ruby-telegem/telegem?style=for-the-badge&logo=gitlab)
 
 
 
@@ -299,4 +295,4 @@ ruby -r telegem -e "puts 'Welcome to Telegem! 🚀'"
 
 ---
 
-Built with ❤️ for the Ruby community. Happy bot building! 🤖✨
+Built with ❤️ for the Ruby community. Happy bot building! 🤖✨

data/bin/telegem-init

@@ -0,0 +1,32 @@
+#!/usr/bin/env ruby
+# bin/telegem-init
+
+require 'fileutils'
+
+puts " Creating a telegem application..."
+
+# Create the nested directory structure
+FileUtils.mkdir_p("src/handlers")
+
+
+code = <<~RUBY
+  require 'telegem'
+  require 'dotenv/load'
+  
+  # Load all handlers from the handlers directory relative to this file
+  Dir[File.join(__dir__, 'handlers', '*.rb')].each { |file| require file }
+
+  bot = Telegem.new(ENV['BOT_TOKEN'])
+
+  puts "Bot is starting..."
+  bot.start_polling
+RUBY
+
+File.write('src/bot.rb', code)
+
+# Optional: Create a blank .env file so the bot doesn't crash on load
+File.write('.env', "BOT_TOKEN=your_token_here") unless File.exist?('.env')
+
+puts "Successfully created src/bot.rb"
+puts " Structure created: src/handlers/"
+puts " Done working. Run your bot with: ruby src/bot.rb"

data/lib/api/types.rb

@@ -62,6 +62,21 @@ module Telegem
         @_accessors_defined[name] = true
       end
       
+      # helpers for converting nested objects
+      def wrap(key, klass)
+        if @_raw_data[key] && !@_raw_data[key].is_a?(klass)
+          @_raw_data[key] = klass.new(@_raw_data[key])
+        end
+      end
+      
+      def wrap_array(key, klass)
+        if @_raw_data[key] && @_raw_data[key].is_a?(Array)
+          @_raw_data[key] = @_raw_data[key].map do |v|
+            v.is_a?(klass) ? v : klass.new(v)
+          end
+        end
+      end
+      
       def snake_to_camel(str)
         str.gsub(/_([a-z])/) { $1.upcase }
       end
@@ -250,84 +265,104 @@ module Telegem
       private
       
       def convert_complex_fields
-        if @_raw_data['date'] && !@_raw_data['date'].is_a?(Time)
-          @_raw_data['date'] = Time.at(@_raw_data['date'])
-        end
-        
-        if @_raw_data['edit_date'] && !@_raw_data['edit_date'].is_a?(Time)
-          @_raw_data['edit_date'] = Time.at(@_raw_data['edit_date'])
-        end
-        
-        if @_raw_data['forward_date'] && !@_raw_data['forward_date'].is_a?(Time)
-          @_raw_data['forward_date'] = Time.at(@_raw_data['forward_date'])
-        end
-        
-        @_raw_data['from'] = User.new(@_raw_data['from']) if @_raw_data['from'] && !@_raw_data['from'].is_a?(User)
-        @_raw_data['chat'] = Chat.new(@_raw_data['chat']) if @_raw_data['chat'] && !@_raw_data['chat'].is_a?(Chat)
-        @_raw_data['via_bot'] = User.new(@_raw_data['via_bot']) if @_raw_data['via_bot'] && !@_raw_data['via_bot'].is_a?(User)
-        @_raw_data['forward_from'] = User.new(@_raw_data['forward_from']) if @_raw_data['forward_from'] && !@_raw_data['forward_from'].is_a?(User)
-        @_raw_data['forward_from_chat'] = Chat.new(@_raw_data['forward_from_chat']) if @_raw_data['forward_from_chat'] && !@_raw_data['forward_from_chat'].is_a?(Chat)
-        @_raw_data['left_chat_member'] = User.new(@_raw_data['left_chat_member']) if @_raw_data['left_chat_member'] && !@_raw_data['left_chat_member'].is_a?(User)
-        
-        if @_raw_data['entities'] && @_raw_data['entities'].is_a?(Array)
-          @_raw_data['entities'] = @_raw_data['entities'].map do |e|
-            e.is_a?(MessageEntity) ? e : MessageEntity.new(e)
-          end
-        end
-        
-        if @_raw_data['caption_entities'] && @_raw_data['caption_entities'].is_a?(Array)
-          @_raw_data['caption_entities'] = @_raw_data['caption_entities'].map do |e|
-            e.is_a?(MessageEntity) ? e : MessageEntity.new(e)
-          end
-        end
-        
-        if @_raw_data['reply_to_message'] && !@_raw_data['reply_to_message'].is_a?(Message)
-          @_raw_data['reply_to_message'] = Message.new(@_raw_data['reply_to_message'])
-        end
-        
-        if @_raw_data['pinned_message'] && !@_raw_data['pinned_message'].is_a?(Message)
-          @_raw_data['pinned_message'] = Message.new(@_raw_data['pinned_message'])
-        end
-        
-        if @_raw_data['new_chat_members'] && @_raw_data['new_chat_members'].is_a?(Array)
-          @_raw_data['new_chat_members'] = @_raw_data['new_chat_members'].map do |u|
-            u.is_a?(User) ? u : User.new(u)
-          end
-        end
-        
+        # time conversions
+        @_raw_data['date'] = Time.at(@_raw_data['date']) if @_raw_data['date'] && !@_raw_data['date'].is_a?(Time)
+        @_raw_data['edit_date'] = Time.at(@_raw_data['edit_date']) if @_raw_data['edit_date'] && !@_raw_data['edit_date'].is_a?(Time)
+        @_raw_data['forward_date'] = Time.at(@_raw_data['forward_date']) if @_raw_data['forward_date'] && !@_raw_data['forward_date'].is_a?(Time)
+
+        # basic object wrappers
+        wrap('from', User)
+        wrap('chat', Chat)
+        wrap('via_bot', User)
+        wrap('forward_from', User)
+        wrap('forward_from_chat', Chat)
+        wrap('left_chat_member', User)
+
+        wrap_array('entities', MessageEntity)
+        wrap_array('caption_entities', MessageEntity)
+
+        wrap('reply_to_message', Message)
+        wrap('pinned_message', Message)
+        wrap_array('new_chat_members', User)
+
+        # media and other nested types
+        wrap('contact', Contact)
+        wrap('location', Location)
+        wrap('venue', Venue)
+        wrap('dice', Dice)
+        wrap('poll', Poll)
+        wrap('proximity_alert_triggered', ProximityAlertTriggered)
+        wrap('web_app_data', WebAppData)
+
+        wrap('animation', Animation)
+        wrap('audio', Audio)
+        wrap('document', Document)
+        wrap('video', Video)
+        wrap('voice', Voice)
+        wrap('video_note', VideoNote)
+        wrap('sticker', Sticker)
+
+        wrap('invoice', Invoice)
+        wrap('successful_payment', SuccessfulPayment)
+        wrap('reply_markup', BaseType)
+
+        wrap('passport_data', PassportData)
+
+        wrap('video_chat_scheduled', VideoChatScheduled)
+        wrap('video_chat_started', VideoChatStarted)
+        wrap('video_chat_ended', VideoChatEnded)
+        wrap('video_chat_participants_invited', VideoChatParticipantsInvited)
+        wrap('video_chat_location', VideoChatLocation)
+
+        # new message event objects introduced in later API versions
+        wrap('message_auto_delete_timer_changed', MessageAutoDeleteTimerChanged)
+        wrap('forum_topic_created', ForumTopicCreated)
+        wrap('forum_topic_edited', ForumTopicEdited)
+        wrap('forum_topic_closed', ForumTopicClosed)
+        wrap('forum_topic_reopened', ForumTopicReopened)
+        wrap('general_forum_topic_hidden', GeneralForumTopicHidden)
+        wrap('general_forum_topic_unhidden', GeneralForumTopicUnhidden)
+        wrap('write_access_allowed', WriteAccessAllowed)
+
+        # arrays of sizes and photos
+        wrap_array('photo', PhotoSize)
+        wrap_array('new_chat_photo', PhotoSize)
+
+        # fall back to original media wrapper for backward compatibility
         wrap_media_objects
       end
       
       def wrap_media_objects
-        # Media files
-        @_raw_data['document'] = BaseType.new(@_raw_data['document']) if @_raw_data['document'] && !@_raw_data['document'].is_a?(BaseType)
-        @_raw_data['audio'] = BaseType.new(@_raw_data['audio']) if @_raw_data['audio'] && !@_raw_data['audio'].is_a?(BaseType)
-        @_raw_data['video'] = BaseType.new(@_raw_data['video']) if @_raw_data['video'] && !@_raw_data['video'].is_a?(BaseType)
-        @_raw_data['voice'] = BaseType.new(@_raw_data['voice']) if @_raw_data['voice'] && !@_raw_data['voice'].is_a?(BaseType)
-        @_raw_data['video_note'] = BaseType.new(@_raw_data['video_note']) if @_raw_data['video_note'] && !@_raw_data['video_note'].is_a?(BaseType)
-        @_raw_data['sticker'] = BaseType.new(@_raw_data['sticker']) if @_raw_data['sticker'] && !@_raw_data['sticker'].is_a?(BaseType)
-        
+        # Media files (fall‑back to generic types if no specific class defined)
+        @_raw_data['document'] = Document.new(@_raw_data['document']) if @_raw_data['document'] && !@_raw_data['document'].is_a?(Document)
+        @_raw_data['animation'] = Animation.new(@_raw_data['animation']) if @_raw_data['animation'] && !@_raw_data['animation'].is_a?(Animation)
+        @_raw_data['audio'] = Audio.new(@_raw_data['audio']) if @_raw_data['audio'] && !@_raw_data['audio'].is_a?(Audio)
+        @_raw_data['video'] = Video.new(@_raw_data['video']) if @_raw_data['video'] && !@_raw_data['video'].is_a?(Video)
+        @_raw_data['voice'] = Voice.new(@_raw_data['voice']) if @_raw_data['voice'] && !@_raw_data['voice'].is_a?(Voice)
+        @_raw_data['video_note'] = VideoNote.new(@_raw_data['video_note']) if @_raw_data['video_note'] && !@_raw_data['video_note'].is_a?(VideoNote)
+        @_raw_data['sticker'] = Sticker.new(@_raw_data['sticker']) if @_raw_data['sticker'] && !@_raw_data['sticker'].is_a?(Sticker)
+
         # Photo array
         if @_raw_data['photo'] && @_raw_data['photo'].is_a?(Array)
           @_raw_data['photo'] = @_raw_data['photo'].map do |p|
-            p.is_a?(BaseType) ? p : BaseType.new(p)
+            p.is_a?(PhotoSize) ? p : PhotoSize.new(p)
           end
         end
-        
+
         # Contact, location, venue
-        @_raw_data['contact'] = BaseType.new(@_raw_data['contact']) if @_raw_data['contact'] && !@_raw_data['contact'].is_a?(BaseType)
-        @_raw_data['location'] = BaseType.new(@_raw_data['location']) if @_raw_data['location'] && !@_raw_data['location'].is_a?(BaseType)
-        @_raw_data['venue'] = BaseType.new(@_raw_data['venue']) if @_raw_data['venue'] && !@_raw_data['venue'].is_a?(BaseType)
-        
+        @_raw_data['contact'] = Contact.new(@_raw_data['contact']) if @_raw_data['contact'] && !@_raw_data['contact'].is_a?(Contact)
+        @_raw_data['location'] = Location.new(@_raw_data['location']) if @_raw_data['location'] && !@_raw_data['location'].is_a?(Location)
+        @_raw_data['venue'] = Venue.new(@_raw_data['venue']) if @_raw_data['venue'] && !@_raw_data['venue'].is_a?(Venue)
+
         # Payment & other
-        @_raw_data['invoice'] = BaseType.new(@_raw_data['invoice']) if @_raw_data['invoice'] && !@_raw_data['invoice'].is_a?(BaseType)
-        @_raw_data['successful_payment'] = BaseType.new(@_raw_data['successful_payment']) if @_raw_data['successful_payment'] && !@_raw_data['successful_payment'].is_a?(BaseType)
+        @_raw_data['invoice'] = Invoice.new(@_raw_data['invoice']) if @_raw_data['invoice'] && !@_raw_data['invoice'].is_a?(Invoice)
+        @_raw_data['successful_payment'] = SuccessfulPayment.new(@_raw_data['successful_payment']) if @_raw_data['successful_payment'] && !@_raw_data['successful_payment'].is_a?(SuccessfulPayment)
         @_raw_data['reply_markup'] = BaseType.new(@_raw_data['reply_markup']) if @_raw_data['reply_markup'] && !@_raw_data['reply_markup'].is_a?(BaseType)
-        
+
         # Chat photo array
         if @_raw_data['new_chat_photo'] && @_raw_data['new_chat_photo'].is_a?(Array)
           @_raw_data['new_chat_photo'] = @_raw_data['new_chat_photo'].map do |p|
-            p.is_a?(BaseType) ? p : BaseType.new(p)
+            p.is_a?(PhotoSize) ? p : PhotoSize.new(p)
           end
         end
       end
@@ -428,15 +463,218 @@ module Telegem
       private
       
       def convert_update_objects
-        @_raw_data['message'] = Message.new(@_raw_data['message']) if @_raw_data['message'] && !@_raw_data['message'].is_a?(Message)
-        @_raw_data['edited_message'] = Message.new(@_raw_data['edited_message']) if @_raw_data['edited_message'] && !@_raw_data['edited_message'].is_a?(Message)
-        @_raw_data['channel_post'] = Message.new(@_raw_data['channel_post']) if @_raw_data['channel_post'] && !@_raw_data['channel_post'].is_a?(Message)
-        @_raw_data['edited_channel_post'] = Message.new(@_raw_data['edited_channel_post']) if @_raw_data['edited_channel_post'] && !@_raw_data['edited_channel_post'].is_a?(Message)
-        
-        if @_raw_data['callback_query'] && !@_raw_data['callback_query'].is_a?(CallbackQuery)
-          @_raw_data['callback_query'] = CallbackQuery.new(@_raw_data['callback_query'])
+        wrap('message', Message)
+        wrap('edited_message', Message)
+        wrap('channel_post', Message)
+        wrap('edited_channel_post', Message)
+
+        wrap('inline_query', InlineQuery)
+        wrap('chosen_inline_result', ChosenInlineResult)
+        wrap('callback_query', CallbackQuery)
+        wrap('shipping_query', ShippingQuery)
+        wrap('pre_checkout_query', PreCheckoutQuery)
+        wrap('poll', Poll)
+        wrap('poll_answer', PollAnswer)
+        wrap('my_chat_member', ChatMemberUpdated)
+        wrap('chat_member', ChatMemberUpdated)
+        wrap('chat_join_request', ChatJoinRequest)
+        wrap('forum_topic_created', ForumTopicCreated)
+        wrap('forum_topic_edited', ForumTopicEdited)
+        wrap('forum_topic_closed', ForumTopicClosed)
+        wrap('forum_topic_reopened', ForumTopicReopened)
+        wrap('general_forum_topic_hidden', GeneralForumTopicHidden)
+        wrap('general_forum_topic_unhidden', GeneralForumTopicUnhidden)
+        wrap('write_access_allowed', WriteAccessAllowed)
+      end
+    end
+
+    # additional types returned by various methods / updates
+    class PhotoSize < BaseType; end
+    class Audio < BaseType; end
+    class Document < BaseType; end
+    class Video < BaseType; end
+    class Voice < BaseType; end
+    class VideoNote < BaseType; end
+    class Animation < BaseType; end
+    class Sticker < BaseType; end
+    class Contact < BaseType; end
+    class Dice < BaseType; end
+
+    class Location < BaseType; end
+    class Venue < BaseType; end
+    class ProximityAlertTriggered < BaseType; end
+    class WebAppData < BaseType; end
+    class PassportData < BaseType; end
+
+    class Invoice < BaseType; end
+    class SuccessfulPayment < BaseType; end
+    class ShippingAddress < BaseType; end
+    class OrderInfo < BaseType; end
+
+    class ShippingQuery < BaseType
+      def initialize(data)
+        super(data)
+        wrap('from', User)
+        wrap('shipping_address', ShippingAddress)
+      end
+    end
+
+    class PreCheckoutQuery < BaseType
+      def initialize(data)
+        super(data)
+        wrap('from', User)
+        wrap('shipping_address', ShippingAddress)
+        wrap('order_info', OrderInfo)
+      end
+    end
+
+    class PollOption < BaseType; end
+    class PollAnswer < BaseType; end
+
+    class Poll < BaseType
+      def initialize(data)
+        super(data)
+        wrap_array('options', PollOption)
+        wrap_array('explanation_entities', MessageEntity)
+      end
+    end
+
+    class ChatPermissions < BaseType; end
+    class ChatPhoto < BaseType; end
+    class ChatInviteLink < BaseType; end
+
+    # status-specific chat member objects. they inherit from ChatMember
+    class ChatMember < BaseType; end
+    class ChatMemberOwner < ChatMember; end
+    class ChatMemberAdministrator < ChatMember; end
+    class ChatMemberMember < ChatMember; end
+    class ChatMemberRestricted < ChatMember; end
+    class ChatMemberLeft < ChatMember; end
+    class ChatMemberBanned < ChatMember; end
+
+    class ChatAdministratorRights < BaseType; end
+
+    class ChatMemberUpdated < BaseType
+      def initialize(data)
+        super(data)
+        wrap('chat', Chat)
+        wrap('from', User)
+        wrap_member('old_chat_member')
+        wrap_member('new_chat_member')
+        wrap('invite_link', ChatInviteLink)
+        if @_raw_data['date'] && !@_raw_data['date'].is_a?(Time)
+          @_raw_data['date'] = Time.at(@_raw_data['date'])
+        end
+      end
+
+      private
+
+      def wrap_member(key)
+        return unless @_raw_data[key]
+        status = @_raw_data[key]['status']
+        klass = case status
+                when 'creator' then ChatMemberOwner
+                when 'administrator' then ChatMemberAdministrator
+                when 'member' then ChatMemberMember
+                when 'restricted' then ChatMemberRestricted
+                when 'left' then ChatMemberLeft
+                when 'kicked' then ChatMemberBanned
+                else ChatMember
+                end
+        @_raw_data[key] = klass.new(@_raw_data[key])
+      end
+    end
+
+    class ChatJoinRequest < BaseType
+      def initialize(data)
+        super(data)
+        wrap('chat', Chat)
+        wrap('from', User)
+        wrap('invite_link', ChatInviteLink)
+        if @_raw_data['date'] && !@_raw_data['date'].is_a?(Time)
+          @_raw_data['date'] = Time.at(@_raw_data['date'])
         end
       end
     end
+
+    class InlineQuery < BaseType
+      def initialize(data)
+        super(data)
+        wrap('from', User)
+        wrap('location', Location)
+      end
+    end
+
+    class ChosenInlineResult < BaseType
+      def initialize(data)
+        super(data)
+        wrap('from', User)
+        wrap('location', Location)
+      end
+    end
+
+    class InlineQueryResult < BaseType; end
+    class InlineQueryResultArticle < InlineQueryResult; end
+    class InlineQueryResultPhoto < InlineQueryResult; end
+    class InlineQueryResultGif < InlineQueryResult; end
+    class InlineQueryResultMpeg4Gif < InlineQueryResult; end
+    class InlineQueryResultVideo < InlineQueryResult; end
+    class InlineQueryResultAudio < InlineQueryResult; end
+    class InlineQueryResultVoice < InlineQueryResult; end
+    class InlineQueryResultDocument < InlineQueryResult; end
+    class InlineQueryResultLocation < InlineQueryResult; end
+    class InlineQueryResultVenue < InlineQueryResult; end
+    class InlineQueryResultContact < InlineQueryResult; end
+    class InlineQueryResultGame < InlineQueryResult; end
+    class InlineQueryResultSticker < InlineQueryResult; end
+    class InlineQueryResultCachedPhoto < InlineQueryResult; end
+    class InlineQueryResultCachedGif < InlineQueryResult; end
+    class InlineQueryResultCachedMpeg4Gif < InlineQueryResult; end
+    class InlineQueryResultCachedSticker < InlineQueryResult; end
+    class InlineQueryResultCachedDocument < InlineQueryResult; end
+    class InlineQueryResultCachedVideo < InlineQueryResult; end
+    class InlineQueryResultCachedAudio < InlineQueryResult; end
+    class InlineQueryResultCachedVoice < InlineQueryResult; end
+
+    class UserProfilePhotos < BaseType
+      def initialize(data)
+        super(data)
+        wrap_array('photos', PhotoSize)
+      end
+    end
+
+    class UserProfileAudios < BaseType
+      def initialize(data)
+        super(data)
+        wrap_array('audios', Audio)
+      end
+    end
+
+    # generic utility objects returned by the API
+    class File < BaseType; end
+    class ResponseParameters < BaseType; end
+    class MaskPosition < BaseType; end
+    class StickerSet < BaseType; end
+
+    # new message event payloads (each a simple wrapper)
+    class MessageAutoDeleteTimerChanged < BaseType; end
+    class ForumTopicCreated < BaseType; end
+    class ForumTopicEdited < BaseType; end
+    class ForumTopicClosed < BaseType; end
+    class ForumTopicReopened < BaseType; end
+    class GeneralForumTopicHidden < BaseType; end
+    class GeneralForumTopicUnhidden < BaseType; end
+    class WriteAccessAllowed < BaseType; end
+
+    class BotCommand < BaseType; end
+    class BotCommandScope < BaseType; end
+    class WebhookInfo < BaseType; end
+
+    class VideoChatScheduled < BaseType; end
+    class VideoChatStarted < BaseType; end
+    class VideoChatEnded < BaseType; end
+    class VideoChatParticipantsInvited < BaseType; end
+    class VideoChatLocation < BaseType; end
+
   end
 end

data/lib/plugins/file_extract.rb

@@ -179,5 +179,5 @@ module Telegem
       end 
     end 
   end 
-end 
-end 
+end
+end 

data/lib/session/memory_store.rb

@@ -1,125 +1,108 @@
-# lib/session/memory_store.rb - PRODUCTION READY
+# lib/session/memory_store.rb
+require 'json'
+require 'time'
+require 'fileutils'
+
 module Telegem
   module Session
     class MemoryStore
-      def initialize
+      def initialize(
+        default_ttl: 300,
+        cleanup_interval: 300,
+        backup_path: nil,
+        backup_interval: 60
+      )
         @store = {}
         @ttls = {}
-        @default_ttl = 300  # 5 minutes
-        @cleanup_interval = 60  # Clean expired every minute
+        @default_ttl = default_ttl
+        @cleanup_interval = cleanup_interval
+        @backup_path = backup_path
+        @backup_interval = backup_interval
+
         @last_cleanup = Time.now
+        @last_backup = Time.now
+
+        restore! if @backup_path && File.exist?(@backup_path)
       end
 
-      # Store with optional TTL
       def set(key, value, ttl: nil)
-          auto_cleanup
-          key_s = key.to_s
-          @store[key_s] = value
-          @ttls[key_s] = Time.now + (ttl || @default_ttl)
-          value
-        end
+        auto_cleanup
+        key_s = key.to_s
 
-      # Get value if not expired
-      def get(key)
-          key_s = key.to_s
-          return nil unless @store.key?(key_s)
-          
-          # Auto-clean if expired
-          if expired?(key_s)
-            delete(key_s)
-            return nil
-          end
-          
-          @store[key_s]
-        end
+        @store[key_s] = value
+        @ttls[key_s] = Time.now + (ttl || @default_ttl)
 
-      # Check if key exists and not expired
-      def exist?(key)
-          key_s = key.to_s
-          return false unless @store.key?(key_s)
-          !expired?(key_s)
-        end
+        auto_backup
+        value
+      end
 
-      # Delete key
-      def delete(key)
-          key_s = key.to_s
-          @store.delete(key_s)
-          @ttls.delete(key_s)
-          true
-        end
+      def get(key)
+        key_s = key.to_s
+        return nil unless @store.key?(key_s)
 
-      # Increment counter (for rate limiting)
-      def increment(key, amount = 1, ttl: nil)
-          key_s = key.to_s
-          current = get(key_s) || 0
-          new_value = current + amount
-          set(key_s, new_value, ttl: ttl)
-          new_value
+        if expired?(key_s)
+          delete(key_s)
+          return nil
         end
 
-      # Decrement counter
-      def decrement(key, amount = 1)
-        increment(key, -amount)
+        @store[key_s]
       end
 
-      # Clear expired entries (auto-called)
-      def cleanup
-          now = Time.now
-          @ttls.each do |key, expires|
-            if now > expires
-              @store.delete(key)
-              @ttls.delete(key)
-            end
-          end
-          @last_cleanup = now
-        end 
-
-      # Clear everything
-      def clear
-          @store.clear
-          @ttls.clear
-          @last_cleanup = Time.now
-        end
-
-      # Get all keys (non-expired)
-      def keys
-          auto_cleanup
-          @store.keys.select { |k| !expired?(k) }
-        end
+      def delete(key)
+        key_s = key.to_s
+        @store.delete(key_s)
+        @ttls.delete(key_s)
+        true
+      end
 
-      # Get size (non-expired entries)
-      def size
-        keys.size
+      def increment(key, amount = 1, ttl: nil)
+        current = get(key) || 0
+        # Ensure we are working with numbers 
+        val = current.to_i rescue 0
+        new_val = val + amount
+        set(key, new_val, ttl: ttl)
+        new_val
       end
 
-      def empty?
-        size == 0
+      # --- Persistence Logic (The "Telecr" Way) ---
+
+      def backup!
+        return unless @backup_path
+        
+        # 1. Prepare data
+        data = {
+          "store" => @store,
+          "ttls"  => @ttls.transform_values(&:to_i), # Save as Unix timestamp
+          "timestamp" => Time.now.to_i
+        }
+
+        # 2. Ensure directory exists
+        FileUtils.mkdir_p(File.dirname(@backup_path))
+
+        # 3. ATOMIC WRITE: Write to temp, then rename
+        temp_path = "#{@backup_path}.tmp"
+        File.write(temp_path, JSON.generate(data))
+        File.rename(temp_path, @backup_path)
+        
+        @last_backup = Time.now
       end
 
-      # Get TTL remaining in seconds
-      def ttl(key)
-          key_s = key.to_s
-          return -1 unless @ttls[key_s]
-          
-          remaining = @ttls[key_s] - Time.now
-          remaining > 0 ? remaining.ceil : -1
-        end
+      def restore!
+        return unless @backup_path && File.exist?(@backup_path)
 
-      # Set TTL for existing key
-      def expire(key, ttl)
-          key_s = key.to_s
-          return false unless @store.key?(key_s)
+        begin
+          raw = JSON.parse(File.read(@backup_path))
           
-          @ttls[key_s] = Time.now + ttl
-          true
-        end
+          @store.clear
+          @ttls.clear
 
-      # Redis-like scan for pattern matching
-      def scan(pattern = "*", count: 10)
-          auto_cleanup
-          regex = pattern_to_regex(pattern)
-          matching_keys = @store.keys.select { |k| k.match?(regex) && !expired?(k) }
-          matching_keys.first(count)
+          raw["store"].each { |k, v| @store[k] = v }
+          raw["ttls"].each do |k, v|
+            @ttls[k] = Time.at(v)
+          end
+        rescue => e
+          warn "Telegem: Failed to restore backup: #{e.message}"
+        end
       end
 
       private
@@ -129,15 +112,19 @@ module Telegem
       end
 
       def auto_cleanup
-        if Time.now - @last_cleanup > @cleanup_interval
-          cleanup
+        if (Time.now - @last_cleanup) > @cleanup_interval
+          now = Time.now
+          expired_keys = @ttls.select { |_, expires| now > expires }.keys
+          expired_keys.each { |k| delete(k) }
+          @last_cleanup = now
         end
       end
 
-      def pattern_to_regex(pattern)
-        regex_str = pattern.gsub('*', '.*').gsub('?', '.')
-        Regexp.new("^#{regex_str}$")
+      def auto_backup
+        if @backup_path && (Time.now - @last_backup) > @backup_interval
+          backup!
+        end
       end
     end
   end
-end
+end

data/lib/telegem.rb

@@ -3,7 +3,7 @@ require 'logger'
 require 'json'
 
 module Telegem
-  VERSION = "3.3.0".freeze
+  VERSION = "3.3.1".freeze
 end
 
 #
@@ -78,4 +78,4 @@ if ENV['TELEGEM_GLOBAL'] == 'true'
   def Telegem(token, **options)
     ::Telegem.new(token, **options)
   end
-end
+end

metadata

@@ -1,13 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: telegem
 version: !ruby/object:Gem::Version
-  version: 3.3.0
+  version: 3.3.1
 platform: ruby
 authors:
-- sick_phantom
+- zendrx
+autorequire:
 bindir: bin
 cert_chain: []
-date: 1980-01-02 00:00:00.000000000 Z
+date: 2026-04-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: concurrent-ruby
@@ -129,10 +130,11 @@ email:
 - ynwghosted@icloud.com
 executables:
 - telegem-ssl
+- telegem-init
 extensions: []
 extra_rdoc_files: []
 files:
-- CHANGELOG
+- CHANGELOG.md
 - CODE_OF_CONDUCT.md
 - Contributing.md
 - Gemfile
@@ -143,6 +145,7 @@ files:
 - assets/.gitkeep
 - assets/logo.png
 - bin/.gitkeep
+- bin/telegem-init
 - bin/telegem-ssl
 - docs/.gitkeep
 - docs/ctx.md
@@ -167,18 +170,18 @@ files:
 - lib/webhook/.gitkeep
 - lib/webhook/server.rb
 - public/.gitkeep
-homepage: https://gitlab.com/ruby-telegem/telegem
+homepage: https://github.com/slick-lab/telegem
 licenses:
 - MIT
 metadata:
-  homepage_uri: https://gitlab.com/ruby-telegem/telegem/-/blob/main/README.md
-  source_code_uri: https://gitlab.com/ruby-telegem/telegem
-  changelog_uri: https://gitlab.com/ruby-telegem/telegem/-/blob/main/CHANGELOG.md
-  bug_tracker_uri: https://gitlab.com/ruby-telegem/telegem/-/issues
+  homepage_uri: https://github.com/slick-lab/telegem/-/blob/main/README.md
+  source_code_uri: https://github.com/slick-lab/telegem
+  changelog_uri: https://github.com/slick-lab/telegem/-/blob/main/CHANGELOG.md
+  bug_tracker_uri: https://github.com/slick-lab/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.3.0!\n\n\U0001F4DA Documentation:
-  https://gitlab.com/ruby-telegem/telegem\n\n\U0001F510 For SSL Webhooks:\nRun: telegem-ssl
+post_install_message: "Thanks for installing Telegem 3.3.1!\n\n\U0001F4DA Documentation:
+  https://github.com/slick-lab/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"
 rdoc_options: []
@@ -195,7 +198,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.6
+rubygems_version: 3.5.22
+signing_key:
 specification_version: 4
 summary: Modern, fast Telegram Bot Framework for Ruby
 test_files: []

data/CHANGELOG

@@ -1,95 +0,0 @@
-Telegem Changelog
-
-v3.1.1 (current)
-
-🚀 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 
-
-· 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
-
-· 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
-
----