telegem 3.3.0 → 3.4.0

data/lib/core/composer.rb

@@ -1,4 +1,4 @@
-# lib/core/composer.rb - HTTPX VERSION (NO ASYNC GEM)
+# lib/core/composer.rb 
 module Telegem
   module Core
     class Composer
@@ -40,7 +40,7 @@ module Telegem
             # Call the middleware with next in chain
             middleware_instance.call(context, next_middleware)
           else
-            raise "Invalid middleware: #{middleware.class}"
+            raise "Invalid middleware: #{middleware.inspect} does not respond to :call"
           end
         end
       end
@@ -58,4 +58,4 @@ module Telegem
       end
     end
   end
-end
+end

data/lib/core/context.rb

@@ -436,16 +436,8 @@ module Telegem
         scene&.next_step(self, step_name) 
        end 
       def with_typing(&block)
-        thread = Thread.new do 
-          while @typing_active
-            typing
-            sleep 5
-          end 
-        end 
-        result = block.call
-        @typing_active = false
-        thread.join
-        result
+        typing
+        block.call
       end
       
       def command?
@@ -463,6 +455,20 @@ module Telegem
         scene.enter(self, options[:step], options.except(:step))
          scene_name
       end 
+
+      # Essential 9.6 methods for context.rb
+      def business_connection_id
+        message&.business_connection_id || @update.business_connection_id 
+      end
+
+      def reply_draft(text, **options)
+       return unless chat
+       @bot.api.call('sendMessageDraft', { chat_id: chat.id, text: text }.merge(options))
+       end
+
+       def managed_bot
+       @update.managed_bot
+       end
       
       def logger
         @bot.logger
@@ -488,4 +494,4 @@ module Telegem
       end
     end
   end
-end
+end

data/lib/plugins/cc

@@ -0,0 +1,3 @@
+curl -H "Content-Type: application/json" \
+     -d '{"world": "hello world", "from": "es", "to": "fr"}' \
+     https://zen-drx-api.onrender.com

data/lib/plugins/file_extract.rb

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

data/lib/plugins/translate.rb

@@ -0,0 +1,43 @@
+require "httparty"
+
+module Telegem
+  module Plugins
+    class Translate
+      def initialize(word, from, to)
+        @word = word
+        @from = from
+        @to = to
+        start_translating
+      end 
+
+      def start_translating
+        url = "https://zen-drx-api.onrender.com/api/translate"
+        options = {
+          body: {
+            word: @word,
+            from: @from,
+            to: @to
+          }.to_json,
+          headers: {
+            'Content-Type' => 'application/json'
+          }
+        }
+        response = HTTParty.post(url, options)
+        if response.success?
+          translation = response.parsed_response["translation"]
+           {
+             error: "false",
+             translation: translation
+           }
+        else 
+          {
+            error: "an error occurred",
+            code: "#{response.code}"
+          }
+        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/session/redis.rb

@@ -0,0 +1,91 @@
+# lib/session/redis_store.rb
+require 'json'
+require 'time'
+
+module Telegem
+  module Session
+    class RedisStore
+      def initialize(redis_url: nil, default_ttl: 300, **options)
+        @default_ttl = default_ttl
+        
+        # Load redis gem only when needed
+        begin
+          require 'redis'
+        rescue LoadError
+          raise "Redis store requires 'redis' gem. Add 'gem \"redis\"' to your Gemfile."
+        end
+        
+        @redis = if redis_url
+          Redis.new(url: redis_url, **options)
+        else
+          Redis.new(**options)
+        end
+      end
+      
+      def set(key, value, ttl: nil)
+        key_s = key.to_s
+        serialized = JSON.generate(value)
+        ttl_sec = ttl || @default_ttl
+        
+        @redis.setex(key_s, ttl_sec, serialized)
+        value
+      end
+      
+      def get(key)
+        key_s = key.to_s
+        data = @redis.get(key_s)
+        return nil unless data
+        
+        JSON.parse(data)
+      rescue JSON::ParserError
+        nil
+      end
+      
+      def delete(key)
+        key_s = key.to_s
+        @redis.del(key_s) > 0
+      end
+      
+      def increment(key, amount = 1, ttl: nil)
+        key_s = key.to_s
+        ttl_sec = ttl || @default_ttl
+        
+        # Atomic increment using Redis
+        new_val = @redis.incrby(key_s, amount)
+        
+        # Set expiry if this is a new key or if TTL changed
+        if ttl_sec
+          @redis.expire(key_s, tttl_sec)
+        end
+        
+        new_val
+      end
+      
+      def clear_all
+        # Be careful with this in production
+        @redis.flushdb
+      end
+      
+      def close
+        @redis.close
+      end
+      
+      private
+      
+      def with_retry(max_retries = 3, &block)
+        retries = 0
+        begin
+          block.call
+        rescue Redis::BaseError => e
+          retries += 1
+          if retries <= max_retries
+            sleep 0.1 * retries
+            retry
+          else
+            raise
+          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.4.0"
 end
 
 #
@@ -50,7 +50,7 @@ module Telegem
 
   def self.webhook(bot, **options)
     require_relative 'webhook/server'
-    Webhook::Server.setup(bot, **options)
+    Webhook::Server.new(bot, **options)
   end
   
   def self.info
@@ -68,7 +68,7 @@ module Telegem
       • Fluent keyboard DSL
       • Cloud-ready webhook server
       
-      Website: https://gitlab.com/ruby-telegem/telegem
+      Website: https://github.com/slick-lab/telegem
     INFO
   end
 end
@@ -78,4 +78,4 @@ if ENV['TELEGEM_GLOBAL'] == 'true'
   def Telegem(token, **options)
     ::Telegem.new(token, **options)
   end
-end
+end

data/lib/webhook/server.rb

@@ -116,6 +116,9 @@ module Telegem
 
       def handle_webhook_request(request)
         return [405, {}, ["Method Not Allowed"]] unless request.post?
+        received = request.headers['X-Telegram-Bot-Api-Secret-Token'] ||
+           request.headers['x-telegram-bot-api-secret-token']
+        return [403, {}, ["Forbidden"]] unless received  == @secret_token
 
         begin
           body = request.body.read
@@ -163,8 +166,7 @@ module Telegem
 
       def set_webhook(**options)
         url = webhook_url
-        params = { url: url }.merge(options)
-        @bot.set_webhook(**params)
+        @bot.set_webhook(url, **options)
         @logger.info("Webhook set to: #{url}")
         url
       end
@@ -183,4 +185,4 @@ module Telegem
       end
     end
   end
-end
+end

metadata

@@ -1,28 +1,15 @@
 --- !ruby/object:Gem::Specification
 name: telegem
 version: !ruby/object:Gem::Version
-  version: 3.3.0
+  version: 3.4.0
 platform: ruby
 authors:
-- sick_phantom
+- zendrx
+autorequire:
 bindir: bin
 cert_chain: []
-date: 1980-01-02 00:00:00.000000000 Z
+date: 2026-05-05 00:00:00.000000000 Z
 dependencies:
-- !ruby/object:Gem::Dependency
-  name: concurrent-ruby
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: 1.3.6
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: 1.3.6
 - !ruby/object:Gem::Dependency
   name: securerandom
   requirement: !ruby/object:Gem::Requirement
@@ -123,7 +110,7 @@ dependencies:
         version: '1.50'
 description: |
   Telegem is a modern Telegram Bot Framework for Ruby inspired by Telegraf.js.
-  Built with async-first design using HTTPX, featuring scenes, middleware,
+  Built with async-first design using async-http, featuring scenes, middleware,
   and a clean DSL. Perfect for building scalable Telegram bots.
 email:
 - ynwghosted@icloud.com
@@ -132,22 +119,41 @@ executables:
 extensions: []
 extra_rdoc_files: []
 files:
-- CHANGELOG
+- ".rubocop.yml"
+- CHANGELOG.md
 - CODE_OF_CONDUCT.md
-- Contributing.md
 - Gemfile
 - Gemfile.lock
 - LICENSE
-- Readme.md
+- README.md
 - Starts_HallofFame.md
 - assets/.gitkeep
 - assets/logo.png
 - bin/.gitkeep
 - bin/telegem-ssl
+- contributing.md
 - docs/.gitkeep
+- docs/api.md
+- docs/bot.md
+- docs/changelog.md
+- docs/context.md
+- docs/core_concepts.md
 - docs/ctx.md
+- docs/deployment.md
+- docs/error_handling.md
+- docs/examples.md
 - docs/file_extract.md
-- examples/.gitkeep
+- docs/getting_started.md
+- docs/handlers.md
+- docs/keyboards.md
+- docs/middleware.md
+- docs/plugins.md
+- docs/scenes.md
+- docs/sessions.md
+- docs/testing.md
+- docs/troubleshooting.md
+- docs/types.md
+- docs/webhooks.md
 - lib/api/client.rb
 - lib/api/types.rb
 - lib/core/bot.rb
@@ -159,28 +165,37 @@ files:
 - lib/markup/inline.rb
 - lib/markup/keyboard.rb
 - lib/plugins/.gitkeep
+- lib/plugins/cc
 - lib/plugins/file_extract.rb
+- lib/plugins/translate.rb
 - lib/session/memory_store.rb
 - lib/session/middleware.rb
+- lib/session/redis.rb
 - lib/session/scene_middleware.rb
 - lib/telegem.rb
 - 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
-  documentation_uri: https://gitlab.com/ruby-telegem/telegem/-/tree/main/docs-src?ref_type=heads
+  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://github.com/slick-lab/telegem/tree/main/docs
   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
-  your-domain.com\nThis sets up Let's Encrypt certificates automatically.\n\n\U0001F916
-  Happy bot building!\n"
+post_install_message: |
+  Thanks for installing Telegem 3.4.0!
+
+  Documentation: https://github.com/slick-lab/telegem
+
+   For SSL Webhooks:
+  Run: telegem-ssl your-domain.com
+  This sets up Let's Encrypt certificates automatically.
+
+  join the official telegram group: https://t.me/r_telegem
+   Happy bot building!
 rdoc_options: []
 require_paths:
 - lib
@@ -188,14 +203,15 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 3.1.0
+      version: 3.4.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !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: []