telegem 3.3.1 → 3.4.0

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.1".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

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,29 +1,15 @@
 --- !ruby/object:Gem::Specification
 name: telegem
 version: !ruby/object:Gem::Version
-  version: 3.3.1
+  version: 3.4.0
 platform: ruby
 authors:
 - zendrx
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-04-24 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
@@ -124,33 +110,50 @@ 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
 executables:
 - telegem-ssl
-- telegem-init
 extensions: []
 extra_rdoc_files: []
 files:
+- ".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-init
 - 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
@@ -162,14 +165,16 @@ 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://github.com/slick-lab/telegem
 licenses:
 - MIT
@@ -178,12 +183,19 @@ metadata:
   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
+  documentation_uri: https://github.com/slick-lab/telegem/tree/main/docs
   rubygems_mfa_required: 'false'
-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"
+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
@@ -191,7 +203,7 @@ 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:
   - - ">="

data/Contributing.md

@@ -1,161 +0,0 @@
-# 🤝 contributing to Telegem
-
- Thank you for your interest in contributing to Telegem! This document provides guidelines and instructions for contributing to Telegem. 
- whether you are fixing bugs, improving documentation or proposing new features, your contributions are welcome 
- 
- ## 📋 Table of Contents
-- [Code of Conduct](#-code-of-conduct)
-- [Getting Started](#-getting-started)
-- [How to Contribute](#-how-to-contribute)
-- [Reporting Bugs](#reporting-bugs)
-- [Suggesting Features](#suggesting-features)
-- [Code Contributions](#code-contributions)
-- [Documentation](#documentation)
-- [Development Setup](#-development-setup)
-- [Pull Request Process](#-pull-request-process)
-- [Style Guides](#-style-guides)
-- [Community](#-community)
-- [Recognition](#-recognition)
-
-## code of conduct
-
-We are committed to providing a welcoming and inspiring community for all. Please read our [Code of Conduct](CODE_OF_CONDUCT.md) before participating.
-
-## 🚀 Getting Started
-
-### Prerequisites
-- Ruby v3.x
-- Git
-
-### Quick Start
-1. **Fork the repository** on GitLab
-2. **Clone your fork:**
-   ```bash
-   git clone https://gitlab.com/your-username/telegem.git
-   cd telegem
-   ```
- 3. Install dependencies 
-   ```bash 
-   $ gem install 
-   ```
- 4. run test 
- ```bash 
-  $ rspec test/spec.rb
-  ```
-  ## How to contribute 
-  
-  ##reporting bugs 
-   Bugs are tracked as Gitlab Issues 
-   
-   **before submitting a bug report:**
-   - check if the issue has already been reported 
-   - update to the latest version to see if issues persists
-   - check the documentation and existing solutions to the issue 
-   **A good report includes:**
-   1. clear descriptive title
-   2. steps to be reproduced (be specific)
-   3. expected behavior 
-   4. relevant logs or message 
-   
-   Code Contributions
-
-1. Find an issue to work on:
-   - Check issues labeled good first issue or help wanted
-   - Comment on the issue to let us know you're working on it
-2. Create a feature branch:
-   ```bash
-   git checkout -b feature/your-feature-name
-   # or
-   git checkout -b fix/issue-description
-   ```
-3. Make your changes
-4. Write/update tests
-5. Update documentation if needed
-6. Run tests locally:
-   ```bash
-   rspec test/spec.rb
-   ```
-
-Documentation
-
-Good documentation is crucial! You can help by:
-
-- Fixing typos or unclear explanations
-- Adding examples to existing documentation
-- Writing tutorials or how-to guides
-- Improving API documentation
-- Translating documentation
-
-Testing
-
-```bash
-# Run all tests
- rspec test/spec.rb
- 
-bundle exec bundle-audit
-```
-
-🎯 Pull Request Process
-
-1. Update your fork with the latest changes from upstream:
-   ```bash
-   git remote add upstream https://gitlab.com/ruby-telegem/telegem.git
-   git fetch upstream
-   git rebase upstream/main
-   ```
-2. Ensure all tests pass
-3. Update documentation if your changes affect functionality
-4. Create a Merge Request (MR) on GitLab:
-   - Use a clear, descriptive title
-   - Reference any related issues (e.g., "Closes #123")
-5. Address review feedback promptly
-6. Once approved, a maintainer will merge your changes
-
-
-
-
-
-👥 Community
-
-Discussion
-
-- Issues: GitLab Issues
-- Merge Requests: GitLab MRs
-
-Getting Help
-
-- Search existing issues and documentation first
-- Be respectful and patient with other community members
-- Provide as much context as possible when asking for help
-
-🏆 Recognition
-
-All contributors are recognized in our HALL_OF_FAME.md. We appreciate every contribution, big or small!
-
-Contributors who make significant impact may be:
-
-- Added to the "Active Contributors" section
--  Given commit access (for trusted, regular contributors)
-- Featured in release notes
-
-
-
-Release Cycle
-
--  We follow Semantic Versioning
-- Major releases
-- Minor releases
-- Patch releases 
-
-License
-
-By contributing, you agree that your contributions will be licensed under the project's LICENSE.
-
----
-
-Thank you for contributing to Telegem! Your efforts help make this project better for everyone. 🚀
-
-```
-  
-
-