solrengine-realtime 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e24339e63d6e1bea90aa6dd8bac526f5ef32659451ea97866b4b2d90f927b171
-  data.tar.gz: c64312b31bd91b27311431729677109b22a9dee0de8e38a3b8784e3cbff2352d
+  metadata.gz: e82459ac5e5f823da98101741161c00aa3f7ce6ae18118979b698c65895a5195
+  data.tar.gz: 1e7e6f233474d46a3433477cd5514487b841b80867e272b10e1f9a62f4edc31a
 SHA512:
-  metadata.gz: 4bb5d4ecb5d4bdf28d9d90c7308506bbd17cda2ab4bed4f0f7534b9fe72f68aeaff195c87b329bb7c6af3d0b46ae7bb560c58d5405f1429da0db68699461b25b
-  data.tar.gz: 2b610121748e95b28ce407e363bdb7221708f8f8b1ba87ac4558f0a4133e2f2e283cc428f5d30585c4450397d5be6b262409d703056385e3dcd212fefb09fd93
+  metadata.gz: 6fc37b96ecb575e062841dd55d92ed80f813c14be0a1a051c0148066d3e9db1ad21acdf2b9f562da25cfa91dcb55c5b24e4c19c0fb0378873d65f48050e49a27
+  data.tar.gz: c1d2a5812ed1f613e399bca1424e6ee470c561ea8fe94d2a49375a33fa4661c1a1f9fd022d78be7a3ef471e627609799d02835b2650485e8a7911b140b8d79ca

data/lib/solrengine/realtime/account_monitor.rb

@@ -5,7 +5,8 @@ require "websocket-client-simple"
 module Solrengine
   module Realtime
     # Subscribes to Solana WebSocket RPC for real-time account changes.
-    # When an account changes, calls Solrengine::Realtime.on_account_change.
+    # When an account changes, dispatches to all registered subscribers
+    # via Solrengine::Realtime.dispatch.
     class AccountMonitor
       SOLANA_ADDRESS_REGEX = /\A[1-9A-HJ-NP-Za-km-z]{32,44}\z/
       RECONNECT_DELAY = 5
@@ -136,7 +137,7 @@ module Solrengine
             sleep BROADCAST_DELAY
             @mutex.synchronize { @account_changed = false }
             begin
-              Solrengine::Realtime.on_account_change.call(@wallet_address)
+              Solrengine::Realtime.dispatch(@wallet_address)
             rescue => e
               logger.error("[SolanaWS] Callback error: #{e.message}")
             end

data/lib/solrengine/realtime/version.rb

@@ -2,6 +2,6 @@
 
 module Solrengine
   module Realtime
-    VERSION = "0.1.0"
+    VERSION = "0.2.0"
   end
 end

data/lib/solrengine/realtime.rb

@@ -6,8 +6,71 @@ require_relative "realtime/engine" if defined?(Rails::Engine)
 
 module Solrengine
   module Realtime
-    mattr_accessor :on_account_change
+    # Reserved name used by the legacy single-callback API
+    # (Solrengine::Realtime.on_account_change=).
+    LEGACY_SUBSCRIBER_NAME = :legacy_on_account_change
 
+    class << self
+      # Registry of account-change subscribers, keyed by name.
+      def subscribers
+        @subscribers ||= {}
+      end
+
+      # Register a subscriber. The block is called with the wallet address
+      # whenever a monitored account changes. Registering under an existing
+      # name replaces the previous subscriber.
+      def subscribe(name, &block)
+        raise ArgumentError, "a block is required" unless block
+
+        subscribers[name] = block
+        block
+      end
+
+      # Remove a subscriber by name. Returns the removed block, or nil.
+      def unsubscribe(name)
+        subscribers.delete(name)
+      end
+
+      # Dispatch an account change to all registered subscribers.
+      # A subscriber raising is logged and does not prevent the remaining
+      # subscribers from running. With zero subscribers this is a no-op.
+      def dispatch(wallet_address)
+        subscribers.dup.each do |name, block|
+          block.call(wallet_address)
+        rescue => e
+          log_subscriber_error(name, e)
+        end
+        nil
+      end
+
+      # Legacy single-callback API (soft-deprecated; prefer subscribe/unsubscribe).
+      # Assignment registers the callable under LEGACY_SUBSCRIBER_NAME;
+      # re-assignment replaces it, preserving the 0.1 replace semantics.
+      def on_account_change=(callable)
+        if callable.nil?
+          unsubscribe(LEGACY_SUBSCRIBER_NAME)
+        else
+          subscribers[LEGACY_SUBSCRIBER_NAME] = callable
+        end
+      end
+
+      def on_account_change
+        subscribers[LEGACY_SUBSCRIBER_NAME]
+      end
+
+      private
+
+      def log_subscriber_error(name, error)
+        message = "[Solrengine::Realtime] Subscriber #{name.inspect} raised: #{error.class}: #{error.message}"
+        if defined?(Rails) && Rails.respond_to?(:logger) && Rails.logger
+          Rails.logger.warn(message)
+        else
+          warn(message)
+        end
+      end
+    end
+
+    # Default subscriber, kept from 0.1; assigning on_account_change= replaces it.
     self.on_account_change = ->(wallet_address) {
       puts "[SolRengine] Account changed: #{wallet_address}"
     }

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: solrengine-realtime
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - Jose Ferrer
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-03-21 00:00:00.000000000 Z
+date: 2026-06-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport