telegram-support-bot 0.1.09 → 0.1.10

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 15900469360f291d85f69a938dc8f25cc9826ec0fab4105c954e0f58aea48868
-  data.tar.gz: 441423cab220f879327d6474bafb069c8fa099966f7cc45c6ac2896944a52238
+  metadata.gz: 9263ca971ffb1e1bb24ae8bc23342c4596748573e7b694485173e14dd2d82d44
+  data.tar.gz: fce5aa69e55343db503d12779a3b66b4f2caabd407f18b1e6668532d1abf9bbb
 SHA512:
-  metadata.gz: 5fa0913384b4a0ecc87dd7c37cc546fc6d8a5e937c9154b7bdeb91d80ed3070cb33d4f5bc6d9d051fe5d84b865bfc904638528e7259cb4a366f5e978e448ecf3
-  data.tar.gz: c844cfaf107d7bed62378b7dfd170d28ee8a4e81f17802c7924cc8629a0dc3485242b5966dbc0371bdddffa2bbd5e861068e0970ebb5d5561c7da1b3a663b06d
+  metadata.gz: 60ab56248d3f245ab2aa8530f8b6c2254003e881c08f632d75e81648cafa0273d35c9cb35cd4d2aece9ec567de0e5effae6ef97205f578cc931695bfa01b1769
+  data.tar.gz: 2e6f1fa2f22a606cc418a2f3f054cc38a7565093d4187c609333583ca22db00c77b9f313f3f45aa0dac6eb5877d1386de91f2ba72730e3bab3caf5fdb9d2294f

data/.idea/workspace.xml

@@ -4,15 +4,15 @@
     <option name="autoReloadType" value="SELECTIVE" />
   </component>
   <component name="ChangeListManager">
-    <list default="true" id="edf498b0-8552-42f1-846d-0c79d29ff991" name="Changes" comment="">
-      <change beforePath="$PROJECT_DIR$/.idea/workspace.xml" beforeDir="false" afterPath="$PROJECT_DIR$/.idea/workspace.xml" afterDir="false" />
-      <change beforePath="$PROJECT_DIR$/README.md" beforeDir="false" afterPath="$PROJECT_DIR$/README.md" afterDir="false" />
-    </list>
+    <list default="true" id="edf498b0-8552-42f1-846d-0c79d29ff991" name="Changes" comment="" />
     <option name="SHOW_DIALOG" value="false" />
     <option name="HIGHLIGHT_CONFLICTS" value="true" />
     <option name="HIGHLIGHT_NON_ACTIVE_CHANGELIST" value="false" />
     <option name="LAST_RESOLUTION" value="IGNORE" />
   </component>
+  <component name="EmbeddingIndexingInfo">
+    <option name="cachedIndexableFilesCount" value="26" />
+  </component>
   <component name="FileTemplateManagerImpl">
     <option name="RECENT_TEMPLATES">
       <list>
@@ -26,6 +26,10 @@
   <component name="MarkdownSettingsMigration">
     <option name="stateVersion" value="1" />
   </component>
+  <component name="McpProjectServerCommands">
+    <commands />
+    <urls />
+  </component>
   <component name="ProjectColorInfo">{
   &quot;associatedIndex&quot;: 4
 }</component>
@@ -37,30 +41,38 @@
     <option name="hideEmptyMiddlePackages" value="true" />
     <option name="showLibraryContents" value="true" />
   </component>
-  <component name="PropertiesComponent">{
-  &quot;keyToString&quot;: {
-    &quot;DefaultRubyCreateTestTemplate&quot;: &quot;Minitest Spec&quot;,
-    &quot;RSpec.Unnamed.executor&quot;: &quot;Run&quot;,
-    &quot;Ruby.scratch_61.executor&quot;: &quot;Run&quot;,
-    &quot;RunOnceActivity.OpenProjectViewOnStart&quot;: &quot;true&quot;,
-    &quot;RunOnceActivity.ShowReadmeOnStart&quot;: &quot;true&quot;,
-    &quot;git-widget-placeholder&quot;: &quot;main&quot;,
-    &quot;last_opened_file_path&quot;: &quot;/home/max/code/tg-sample&quot;,
-    &quot;node.js.detected.package.eslint&quot;: &quot;true&quot;,
-    &quot;node.js.detected.package.tslint&quot;: &quot;true&quot;,
-    &quot;node.js.selected.package.eslint&quot;: &quot;(autodetect)&quot;,
-    &quot;node.js.selected.package.tslint&quot;: &quot;(autodetect)&quot;,
-    &quot;nodejs_package_manager_path&quot;: &quot;npm&quot;,
-    &quot;ruby.structure.view.model.defaults.configured&quot;: &quot;true&quot;,
-    &quot;settings.editor.selected.configurable&quot;: &quot;org.jetbrains.plugins.ruby.settings.RubyActiveModuleSdkConfigurable&quot;,
-    &quot;vue.rearranger.settings.migration&quot;: &quot;true&quot;
+  <component name="PropertiesComponent"><![CDATA[{
+  "keyToString": {
+    "DefaultRubyCreateTestTemplate": "Minitest Spec",
+    "ModuleVcsDetector.initialDetectionPerformed": "true",
+    "RSpec.Unnamed.executor": "Run",
+    "Ruby.scratch_61.executor": "Run",
+    "RunOnceActivity.MCP Project settings loaded": "true",
+    "RunOnceActivity.OpenProjectViewOnStart": "true",
+    "RunOnceActivity.ShowReadmeOnStart": "true",
+    "RunOnceActivity.TerminalTabsStorage.copyFrom.TerminalArrangementManager.252": "true",
+    "RunOnceActivity.git.unshallow": "true",
+    "RunOnceActivity.typescript.service.memoryLimit.init": "true",
+    "com.intellij.ml.llm.matterhorn.ej.ui.settings.DefaultModelSelectionForGA.v1": "true",
+    "git-widget-placeholder": "main",
+    "junie.onboarding.icon.badge.shown": "true",
+    "last_opened_file_path": "/Users/max/code/gems/telegram_support_bot",
+    "node.js.detected.package.eslint": "true",
+    "node.js.detected.package.tslint": "true",
+    "node.js.selected.package.eslint": "(autodetect)",
+    "node.js.selected.package.tslint": "(autodetect)",
+    "nodejs_package_manager_path": "npm",
+    "ruby.structure.view.model.defaults.configured": "true",
+    "settings.editor.selected.configurable": "org.jetbrains.plugins.ruby.settings.RubyActiveModuleSdkConfigurable",
+    "to.speed.mode.migration.done": "true",
+    "vue.rearranger.settings.migration": "true"
   },
-  &quot;keyToStringList&quot;: {
-    &quot;com.intellij.ide.scratch.ScratchImplUtil$2/New Scratch File&quot;: [
-      &quot;ruby&quot;
+  "keyToStringList": {
+    "com.intellij.ide.scratch.ScratchImplUtil$2/New Scratch File": [
+      "ruby"
     ]
   }
-}</component>
+}]]></component>
   <component name="RecentsManager">
     <key name="CopyFile.RECENT_KEYS">
       <recent name="$PROJECT_DIR$/spec/telegram_support_bot/adapters" />
@@ -80,11 +92,7 @@
       <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="ALTERN_SDK_NAME" VALUE="" />
       <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="myPassParentEnvs" VALUE="true" />
       <EXTENSION ID="BundlerRunConfigurationExtension" BUNDLE_MODE="AUTO" bundleExecEnabled="true" />
-      <EXTENSION ID="RubyCoverageRunConfigurationExtension" track_test_folders="true" runner="rcov" ENABLE_BRANCH_COVERAGE="true" ENABLE_FORKED_COVERAGE="true">
-        <COVERAGE_PATTERN ENABLED="true">
-          <PATTERN REGEXPS="/.rvm/" INCLUDED="false" />
-        </COVERAGE_PATTERN>
-      </EXTENSION>
+      <EXTENSION ID="RubyCoverageRunConfigurationExtension" runner="rcov" />
       <EXTENSION ID="org.jetbrains.plugins.ruby.rails.run.RailsRunConfigurationExtension" SCRATCH_USE_RAILS_RUNNER="false" />
       <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="TESTS_FOLDER_PATH" VALUE="$MODULE_DIR$/spec" />
       <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="TEST_SCRIPT_PATH" VALUE="" />
@@ -111,6 +119,7 @@
       <RUBY_RUN_CONFIG NAME="ALTERN_SDK_NAME" VALUE="" />
       <RUBY_RUN_CONFIG NAME="myPassParentEnvs" VALUE="true" />
       <EXTENSION ID="BundlerRunConfigurationExtension" BUNDLE_MODE="AUTO" bundleExecEnabled="true" />
+      <EXTENSION ID="RubyCoverageRunConfigurationExtension" runner="rcov" />
       <EXTENSION ID="org.jetbrains.plugins.ruby.rails.run.RailsRunConfigurationExtension" SCRATCH_USE_RAILS_RUNNER="false" />
       <RUBY_RUN_CONFIG NAME="SCRIPT_PATH" VALUE="$APPLICATION_CONFIG_DIR$/scratches/scratch_61.rb" />
       <RUBY_RUN_CONFIG NAME="SCRIPT_ARGS" VALUE="" />
@@ -126,6 +135,13 @@
       </list>
     </recent_temporary>
   </component>
+  <component name="SharedIndexes">
+    <attachedChunks>
+      <set>
+        <option value="bundled-js-predefined-d6986cc7102b-9b0f141eb926-JavaScript-RM-253.30387.79" />
+      </set>
+    </attachedChunks>
+  </component>
   <component name="SpellCheckerSettings" RuntimeDictionaries="0" Folders="0" CustomDictionaries="0" DefaultDictionary="application-level" UseSingleDictionary="true" transferred="true" />
   <component name="SpringUtil" SPRING_PRE_LOADER_OPTION="true" RAKE_SPRING_PRE_LOADER_OPTION="true" RAILS_SPRING_PRE_LOADER_OPTION="true" />
   <component name="TaskManager">
@@ -141,6 +157,7 @@
       <workItem from="1708944249622" duration="627000" />
       <workItem from="1708949675518" duration="80000" />
       <workItem from="1708951183744" duration="310000" />
+      <workItem from="1770972800781" duration="13916000" />
     </task>
     <servers />
   </component>

data/CHANGELOG.md

@@ -4,6 +4,19 @@ All notable changes to this project will be documented in this file.
 
 ## [Unreleased]
 
+## [0.1.10] - 2026-02-25
+
+### Added
+- Multi-bot runtime support in one process with keyed configuration and processing:
+  `configure(:bot_key)` and `process_update(update, bot: :bot_key)`.
+- Bot-scoped adapter/state-store/scheduler instances to isolate mappings, reactions, and user profiles per bot key.
+- Redis state namespace isolation for non-default bot keys.
+- Multi-bot isolation test coverage for message mappings, support chat routing, contact profiles, and Redis namespaces.
+
+### Changed
+- Backward compatibility preserved: no-arg `configure` and `process_update` continue using `:default`.
+- Development dependency resolution now has Ruby-version-aware constraints for older runtimes.
+
 ## [0.1.09] - 2026-02-13
 
 ### Added

data/README.md

@@ -27,7 +27,7 @@ gem 'telegram-support-bot'
 
 1. **Create Your Bot** via BotFather on Telegram to get your bot token.
 2. **Deploy Your Application** and set up a controller action for webhook callbacks, directing them
-   to `TelegramSupportBot.process_update`.
+   to `TelegramSupportBot.process_update` (or `TelegramSupportBot.process_update(update, bot: :your_key)` for keyed bots).
 3. **Set the Webhook URL** using the Telegram Bot API to your controller action.
 
 ### Setting Up Your Telegram Bot
@@ -60,6 +60,50 @@ TelegramSupportBot.configure do |config|
 end
 ```
 
+### Multiple Bots In One Process
+
+Use keyed configuration when one app process serves multiple Telegram bots/chats:
+
+```ruby
+TelegramSupportBot.configure(:default) do |config|
+  config.adapter_options = { token: ENV.fetch('TELEGRAM_DEFAULT_TOKEN') }
+  config.support_chat_id = ENV.fetch('TELEGRAM_DEFAULT_SUPPORT_CHAT_ID')
+end
+
+TelegramSupportBot.configure(:partners) do |config|
+  config.adapter_options = { token: ENV.fetch('TELEGRAM_PARTNERS_TOKEN') }
+  config.support_chat_id = ENV.fetch('TELEGRAM_PARTNERS_SUPPORT_CHAT_ID')
+end
+
+# Route incoming webhook to the matching bot key:
+TelegramSupportBot.process_update(update, bot: :partners)
+```
+
+Backward compatibility is preserved:
+- `TelegramSupportBot.configure { ... }` configures `:default`
+- `TelegramSupportBot.process_update(update)` processes with `:default`
+
+Typical webhook routing in Rails:
+
+```ruby
+# legacy/default bot
+post '/v2/telegram/support' => 'api/v2/telegram#support'
+# keyed bot
+post '/v2/telegram/:bot_key/support' => 'api/v2/telegram#support'
+```
+
+```ruby
+def support
+  update = JSON.parse(request.body.read)
+  bot_key = params[:bot_key].presence&.to_sym || :default
+  TelegramSupportBot.process_update(update, bot: bot_key)
+  head :ok
+end
+```
+
+When using Redis state store, non-default bot keys are namespaced automatically
+(`telegram_support_bot:<bot_key>:...`) so mappings/profiles do not leak across bots.
+
 3. **Interact with Users**: Messages to your bot will be forwarded to the support chat, and replies
    in the chat will be sent back to the users.
 

data/lib/telegram_support_bot/state_store.rb

@@ -27,9 +27,9 @@ module TelegramSupportBot
       end
     end
 
-    def self.build(configuration)
+    def self.build(configuration, bot_key: TelegramSupportBot::DEFAULT_BOT_KEY)
       backend = configuration.state_store.to_sym
-      options = configuration.state_store_options || {}
+      options = normalize_options(configuration.state_store_options)
 
       case backend
       when :memory
@@ -41,6 +41,7 @@ module TelegramSupportBot
         )
       when :redis
         require_relative 'state_stores/redis'
+        options = isolate_redis_namespace(options, bot_key)
         StateStores::Redis.new(
           mapping_ttl_seconds: configuration.mapping_ttl_seconds,
           reaction_count_ttl_seconds: configuration.reaction_count_ttl_seconds,
@@ -51,6 +52,25 @@ module TelegramSupportBot
         raise ArgumentError, "Unsupported state store backend: #{backend}"
       end
     end
+
+    def self.normalize_options(options)
+      (options || {}).each_with_object({}) do |(key, value), memo|
+        memo[key.to_sym] = value
+      end
+    end
+    private_class_method :normalize_options
+
+    def self.isolate_redis_namespace(options, bot_key)
+      normalized_bot_key = (bot_key || TelegramSupportBot::DEFAULT_BOT_KEY).to_sym
+      return options if normalized_bot_key == TelegramSupportBot::DEFAULT_BOT_KEY
+
+      base_namespace = options[:namespace] || StateStores::Redis::DEFAULT_NAMESPACE
+      suffix = ":#{normalized_bot_key}"
+      namespaced = base_namespace.to_s.end_with?(suffix) ? base_namespace.to_s : "#{base_namespace}#{suffix}"
+
+      options.merge(namespace: namespaced)
+    end
+    private_class_method :isolate_redis_namespace
   end
 end
 

data/lib/telegram_support_bot/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module TelegramSupportBot
-  VERSION = "0.1.09"
+  VERSION = "0.1.10"
 end

data/lib/telegram_support_bot.rb

@@ -10,70 +10,153 @@ require_relative 'telegram_support_bot/adapters/telegram_bot'
 require_relative 'telegram_support_bot/adapters/telegram_bot_ruby'
 
 module TelegramSupportBot
-  class << self
-    attr_accessor :configuration
+  DEFAULT_BOT_KEY = :default
+  BOT_CONTEXT_THREAD_KEY = :telegram_support_bot_current_bot_key
 
+  class << self
     # Provides a method to configure the gem.
-    def configure
-      self.configuration ||= Configuration.new
-      yield(configuration) if block_given?
+    def configure(bot_key = DEFAULT_BOT_KEY)
+      key = normalize_bot_key(bot_key)
+      config = configuration(key)
+      yield(config) if block_given?
+      config
+    end
+
+    def configuration(bot_key = nil)
+      key = bot_key.nil? ? current_bot_key : normalize_bot_key(bot_key)
+      configurations[key] ||= Configuration.new
+    end
+
+    def configuration=(config)
+      configurations[DEFAULT_BOT_KEY] = config
     end
 
     # Lazily builds and returns the adapter based on the current configuration.
     # This method initializes the adapter when it's first called.
-    def adapter
-      @adapter ||= AdapterFactory.build(configuration.adapter, configuration.adapter_options)
+    def adapter(bot_key = nil)
+      key = bot_key.nil? ? current_bot_key : normalize_bot_key(bot_key)
+      adapters[key] ||= AdapterFactory.build(configuration(key).adapter, configuration(key).adapter_options)
     end
 
-    def state_store
-      @state_store ||= StateStore.build(configuration)
+    def state_store(bot_key = nil)
+      key = bot_key.nil? ? current_bot_key : normalize_bot_key(bot_key)
+      state_stores[key] ||= StateStore.build(configuration(key), bot_key: key)
     end
 
-    def message_map
-      state_store.message_map
+    def message_map(bot_key = nil)
+      state_store(bot_key).message_map
     end
 
-    def reverse_message_map
-      state_store.reverse_message_map
+    def reverse_message_map(bot_key = nil)
+      state_store(bot_key).reverse_message_map
     end
 
-    def reaction_count_state
-      state_store.reaction_count_state
+    def reaction_count_state(bot_key = nil)
+      state_store(bot_key).reaction_count_state
     end
 
-    def user_profiles
-      state_store.user_profiles
+    def user_profiles(bot_key = nil)
+      state_store(bot_key).user_profiles
     end
 
-    def user_profile(chat_id)
-      user_profiles[chat_id] || user_profiles[chat_id.to_s] || user_profiles[chat_id.to_i]
+    def user_profile(chat_id, bot: nil)
+      profiles = user_profiles(bot)
+      profiles[chat_id] || profiles[chat_id.to_s] || profiles[chat_id.to_i]
     end
 
-    def scheduler
-      @scheduler ||= AutoAwayScheduler.new(adapter, configuration)
+    def scheduler(bot_key = nil)
+      key = bot_key.nil? ? current_bot_key : normalize_bot_key(bot_key)
+      schedulers[key] ||= AutoAwayScheduler.new(adapter(key), configuration(key))
     end
 
-    def process_update(update)
-      # Handle different types of updates
-      if update['message']
-        # Process standard messages
-        process_message(update['message'])
-      elsif update['message_reaction']
-        process_message_reaction(update['message_reaction'])
-      elsif update['message_reaction_count']
-        process_message_reaction_count(update['message_reaction_count'])
-      elsif update['my_chat_member']
-        # Handle the bot being added to or removed from a chat
-        handle_my_chat_member_update(update['my_chat_member'])
-        # Add other update types as needed
-      else
-        # Log or handle unknown update types
-        puts "Received an unknown type of update: #{update}"
+    def process_update(update, bot: DEFAULT_BOT_KEY)
+      with_bot_context(bot) do
+        # Handle different types of updates
+        if update['message']
+          # Process standard messages
+          process_message(update['message'])
+        elsif update['message_reaction']
+          process_message_reaction(update['message_reaction'])
+        elsif update['message_reaction_count']
+          process_message_reaction_count(update['message_reaction_count'])
+        elsif update['my_chat_member']
+          # Handle the bot being added to or removed from a chat
+          handle_my_chat_member_update(update['my_chat_member'])
+          # Add other update types as needed
+        else
+          # Log or handle unknown update types
+          puts "Received an unknown type of update: #{update}"
+        end
       end
     end
 
+    # Reset the adapter instance (useful for testing or reconfiguration).
+    def reset_adapter!(bot_key = nil)
+      reset_registry!(adapters, bot_key)
+    end
+
+    def reset_state_store!(bot_key = nil)
+      reset_registry!(state_stores, bot_key)
+    end
+
+    def reset_scheduler!(bot_key = nil)
+      reset_registry!(schedulers, bot_key)
+    end
+
+    def reset_configuration!(bot_key = nil)
+      reset_registry!(configurations, bot_key)
+    end
+
+    def reset!(bot_key = nil)
+      reset_adapter!(bot_key)
+      reset_state_store!(bot_key)
+      reset_scheduler!(bot_key)
+      reset_configuration!(bot_key)
+    end
+
     private
 
+    def configurations
+      @configurations ||= {}
+    end
+
+    def adapters
+      @adapters ||= {}
+    end
+
+    def state_stores
+      @state_stores ||= {}
+    end
+
+    def schedulers
+      @schedulers ||= {}
+    end
+
+    def current_bot_key
+      Thread.current[BOT_CONTEXT_THREAD_KEY] || DEFAULT_BOT_KEY
+    end
+
+    def with_bot_context(bot_key)
+      normalized_bot_key = normalize_bot_key(bot_key)
+      previous_bot_key = Thread.current[BOT_CONTEXT_THREAD_KEY]
+      Thread.current[BOT_CONTEXT_THREAD_KEY] = normalized_bot_key
+      yield
+    ensure
+      Thread.current[BOT_CONTEXT_THREAD_KEY] = previous_bot_key
+    end
+
+    def normalize_bot_key(bot_key)
+      (bot_key || DEFAULT_BOT_KEY).to_sym
+    end
+
+    def reset_registry!(registry, bot_key)
+      if bot_key.nil?
+        registry.clear
+      else
+        registry.delete(normalize_bot_key(bot_key))
+      end
+    end
+
     def process_message(message)
       chat_id = message.dig('chat', 'id')
 
@@ -511,12 +594,4 @@ module TelegramSupportBot
 
   end
 
-  # Reset the adapter instance (useful for testing or reconfiguration).
-  def self.reset_adapter!
-    @adapter = nil
-  end
-
-  def self.reset_state_store!
-    @state_store = nil
-  end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: telegram-support-bot
 version: !ruby/object:Gem::Version
-  version: 0.1.09
+  version: 0.1.10
 platform: ruby
 authors:
 - Max Buslaev
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-02-13 00:00:00.000000000 Z
+date: 2026-02-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: redis