ruby_event_store 2.17.1 → 2.19.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 584a718972b372e273512e4af2e7da9448c4b6d95f8a38f2e97f86dcf75a4bb8
-  data.tar.gz: f29d2fe958a8a214f6d1e80491130b429ceb9cab0a26b507f5b47f1284592ee5
+  metadata.gz: 7f21bbf176c36c5948ac817d5e6cf13972d608c25eeb11d691831ba3a51f09bd
+  data.tar.gz: f9cd6d162d9927454ccd9bba582d53644a83a635c775c515283ea32654209652
 SHA512:
-  metadata.gz: 3565b061885fb4dd9cec8adbe77fcf0f87f9f810e5c5792626bc50f701fdfafdb464bd2bccdf5686a7617e8c3be2d7b5af47b4b6b8d9e887ae5189c283c7573e
-  data.tar.gz: be7a632720eb7c60deb0da18171a45a58cce1e53df18be9707bc237a382ba1d7116313f2e7a277a2bf9ca7a3bf98b434c98f56d814b1b051974dd9ccd6fc5c8f
+  metadata.gz: 5cbe530dace472f1e46a7bfe52cdfb11adb0b4f4b38e59fb448fb68d679fdd5a8cd76be0dc6fdcc29ecb6d4e316845d6022eafd4499cc303e66601c64336556a
+  data.tar.gz: b1288e6f0a95d0eb90550f089a791b6e23583f4939426bdc655e63d94814837187b95cd81860c07de666be07063667dcf1823103bbae3cbede2d6d075077ef0a

data/lib/ruby_event_store/client.rb

@@ -18,7 +18,7 @@ module RubyEventStore
       @mapper = batch_mapper?(mapper) ? mapper : Mappers::BatchMapper.new(mapper)
       @broker =
         message_broker ||
-          Broker.new(subscriptions: subscriptions || Subscriptions.new, dispatcher: dispatcher || Dispatcher.new)
+          Broker.new(subscriptions: subscriptions || Subscriptions.new, dispatcher: dispatcher || SyncScheduler.new)
       @clock = clock
       @metadata = Concurrent::ThreadLocalVar.new
       @correlation_id_generator = correlation_id_generator
@@ -33,7 +33,7 @@ module RubyEventStore
           event_store = RubyEventStore::Client.new(
             message_broker: RubyEventStore::Broker.new(
               subscriptions: RubyEventStore::Subscriptions.new,
-              dispatcher: RubyEventStore::Dispatcher.new
+              dispatcher: RubyEventStore::SyncScheduler.new
             )
           )
         EOW
@@ -46,15 +46,15 @@ module RubyEventStore
     end
 
     def rescue_from_double_json_serialization!
-      return unless repository.respond_to? :rescue_from_double_json_serialization!
-      repository.rescue_from_double_json_serialization!
+      return unless @repository.respond_to? :rescue_from_double_json_serialization!
+      @repository.rescue_from_double_json_serialization!
     end
 
     # Persists events and notifies subscribed handlers about them
     #
     # @param events [Array<Event>, Event] event(s)
     # @param stream_name [String] name of the stream for persisting events.
-    # @param expected_version [:any, :auto, :none, Integer] controls optimistic locking strategy. {http://railseventstore.org/docs/expected_version/ Read more}
+    # @param expected_version [:any, :auto, :none, Integer] controls optimistic locking strategy. {https://railseventstore.org/docs/core-concepts/expected-version Read more}
     # @return [self]
     def publish(events, topic: nil, stream_name: GLOBAL_STREAM, expected_version: :any)
       enriched_events = enrich_events_metadata(events)
@@ -62,15 +62,15 @@ module RubyEventStore
       append_records_to_stream(records, stream_name: stream_name, expected_version: expected_version)
       enriched_events.zip(records) do |event, record|
         with_metadata(correlation_id: event.metadata.fetch(:correlation_id), causation_id: event.event_id) do
-          if broker.public_method(:call).arity == 3
-            broker.call(topic || event.event_type, event, record)
+          if @broker.public_method(:call).arity == 3
+            @broker.call(topic || event.event_type, event, record)
           else
             warn <<~EOW
               Message broker shall support topics.
               Topic WILL BE IGNORED in the current broker.
               Modify the broker implementation to pass topic as an argument to broker.call method.
             EOW
-            broker.call(event, record)
+            @broker.call(event, record)
           end
         end
       end
@@ -98,7 +98,12 @@ module RubyEventStore
     # @param expected_version (see #publish)
     # @return [self]
     def link(event_ids, stream_name:, expected_version: :any)
-      repository.link_to_stream(Array(event_ids), Stream.new(stream_name), ExpectedVersion.new(expected_version))
+      if event_ids.nil? || Array(event_ids).any?(&:nil?)
+        warn <<~EOW
+          Passing `nil` to link is deprecated and will raise ArgumentError in RubyEventStore 3.0.
+        EOW
+      end
+      @repository.link_to_stream(Array(event_ids), Stream.new(stream_name), ExpectedVersion.new(expected_version))
       self
     end
 
@@ -109,23 +114,23 @@ module RubyEventStore
     # @param stream_name [String] name of the stream to be cleared.
     # @return [self]
     def delete_stream(stream_name)
-      repository.delete_stream(Stream.new(stream_name))
+      @repository.delete_stream(Stream.new(stream_name))
       self
     end
 
     # Starts building a query specification for reading events.
-    # {http://railseventstore.org/docs/read/ More info.}
+    # {https://railseventstore.org/docs/core-concepts/read More info.}
     #
     # @return [Specification]
     def read
-      Specification.new(SpecificationReader.new(repository, mapper))
+      Specification.new(SpecificationReader.new(@repository, @mapper))
     end
 
     # Gets list of streams where event is stored or linked
     #
     # @return [Array<Stream>] where event is stored or linked
     def streams_of(event_id)
-      repository.streams_of(event_id)
+      @repository.streams_of(event_id)
     end
 
     # Gets position of the event in given stream
@@ -137,9 +142,9 @@ module RubyEventStore
     # @param event_id [String]
     # @param stream_name [String]
     # @return [Integer] nonnegative integer position of event in stream
-    # @raise [EventNotInStream]
+    # @raise [EventNotFoundInStream]
     def position_in_stream(event_id, stream_name)
-      repository.position_in_stream(event_id, Stream.new(stream_name))
+      @repository.position_in_stream(event_id, Stream.new(stream_name))
     end
 
     # Gets position of the event in global stream
@@ -152,7 +157,7 @@ module RubyEventStore
     # @raise [EventNotFound]
     # @return [Integer] nonnegno ative integer position of event in global stream
     def global_position(event_id)
-      repository.global_position(event_id)
+      @repository.global_position(event_id)
     end
 
     # Checks whether event is linked in given stream
@@ -162,7 +167,7 @@ module RubyEventStore
     # @return [Boolean] true if event is linked to given stream, false otherwise
     def event_in_stream?(event_id, stream_name)
       stream = Stream.new(stream_name)
-      stream.global? ? repository.has_event?(event_id) : repository.event_in_stream?(event_id, stream)
+      stream.global? ? @repository.has_event?(event_id) : @repository.event_in_stream?(event_id, stream)
     end
 
     # Subscribes a handler (subscriber) that will be invoked for published events of provided type.
@@ -180,7 +185,7 @@ module RubyEventStore
     def subscribe(subscriber = nil, to:, &proc)
       raise ArgumentError, "subscriber must be first argument or block, cannot be both" if subscriber && proc
       subscriber ||= proc
-      broker.add_subscription(subscriber, to.map { |event_klass| event_type_resolver.call(event_klass) })
+      @broker.add_subscription(subscriber, to.map { |event_klass| @event_type_resolver.call(event_klass) })
     end
 
     # Subscribes a handler (subscriber) that will be invoked for all published events
@@ -195,7 +200,7 @@ module RubyEventStore
     #   @raise [ArgumentError, SubscriberNotExist]
     def subscribe_to_all_events(subscriber = nil, &proc)
       raise ArgumentError, "subscriber must be first argument or block, cannot be both" if subscriber && proc
-      broker.add_global_subscription(subscriber || proc)
+      @broker.add_global_subscription(subscriber || proc)
     end
 
     # Get list of handlers subscribed to an event
@@ -203,7 +208,7 @@ module RubyEventStore
     # @param to [Class, String] type of events to get list of sybscribed handlers
     # @return [Array<Object, Class>]
     def subscribers_for(event_class)
-      broker.all_subscriptions_for(event_type_resolver.call(event_class))
+      @broker.all_subscriptions_for(@event_type_resolver.call(event_class))
     end
 
     # Builder object for collecting temporary handlers (subscribers)
@@ -222,7 +227,7 @@ module RubyEventStore
       # will be called for all published events.
       # The subscription is active only during the invocation
       # of the block of code provided to {Client#within}.
-      # {http://railseventstore.org/docs/subscribe/#temporary-subscriptions Read more.}
+      # {https://railseventstore.org/docs/core-concepts/subscribe#temporary-subscriptions Read more.}
       #
       # @param handlers [Object, Class] handlers passed as objects or classes
       # @param handler2 [Proc] handler passed as proc
@@ -237,7 +242,7 @@ module RubyEventStore
       # will be called for published events of provided type.
       # The subscription is active only during the invocation
       # of the block of code provided to {Client#within}.
-      # {http://railseventstore.org/docs/subscribe/#temporary-subscriptions Read more.}
+      # {https://railseventstore.org/docs/core-concepts/subscribe#temporary-subscriptions Read more.}
       #
       # @overload subscribe(handler, to:)
       #   @param handler [Object, Class] handler passed as objects or classes
@@ -255,7 +260,7 @@ module RubyEventStore
 
       # Invokes the block of code provided to {Client#within}
       # and then unsubscribes temporary handlers.
-      # {http://railseventstore.org/docs/subscribe/#temporary-subscriptions Read more.}
+      # {https://railseventstore.org/docs/core-concepts/subscribe#temporary-subscriptions Read more.}
       #
       # @return [Object] value returned by the invoked block of code
       def call
@@ -280,17 +285,17 @@ module RubyEventStore
     end
 
     # Use for starting temporary subscriptions.
-    # {http://railseventstore.org/docs/subscribe/#temporary-subscriptions Read more}
+    # {https://railseventstore.org/docs/core-concepts/subscribe#temporary-subscriptions Read more}
     #
     # @param block [Proc] block of code during which the temporary subscriptions will be active
     # @return [Within] builder object which collects temporary subscriptions
     def within(&block)
       raise ArgumentError if block.nil?
-      Within.new(block, broker, event_type_resolver)
+      Within.new(block, @broker, @event_type_resolver)
     end
 
     # Set additional metadata for all events published within the provided block
-    # {http://railseventstore.org/docs/request_metadata#passing-your-own-metadata-using-with_metadata-method Read more}
+    # {https://railseventstore.org/docs/core-concepts/request-metadata#passing-your-own-metadata-using-with_metadata Read more}
     #
     # @param metadata [Hash] metadata to set for events
     # @param block [Proc] block of code during which the metadata will be added
@@ -304,13 +309,13 @@ module RubyEventStore
     end
 
     # Deserialize event which was serialized for async event handlers
-    # {http://railseventstore.org/docs/subscribe/#async-handlers Read more}
+    # {https://railseventstore.org/docs/core-concepts/subscribe#async-handlers Read more}
     #
     # @return [Event] deserialized event
     def deserialize(serializer:, event_type:, event_id:, data:, metadata:, timestamp: nil, valid_at: nil)
       extract_timestamp = lambda { |m| (m[:timestamp] || Time.parse(m.fetch("timestamp"))).iso8601 }
 
-      mapper.records_to_events(
+      @mapper.records_to_events(
         [
           SerializedRecord.new(
             event_type: event_type,
@@ -325,7 +330,7 @@ module RubyEventStore
     end
 
     # Read additional metadata which will be added for published events
-    # {http://railseventstore.org/docs/request_metadata#passing-your-own-metadata-using-with_metadata-method Read more}
+    # {https://railseventstore.org/docs/core-concepts/request-metadata#passing-your-own-metadata-using-with_metadata Read more}
     #
     # @return [Hash]
     def metadata
@@ -337,7 +342,7 @@ module RubyEventStore
     # Does not notify any subscribed handlers.
     # Does not enrich with additional current metadata.
     # Does not allow changing which streams these events are in.
-    # {http://railseventstore.org/docs/migrating_messages Read more}
+    # {https://railseventstore.org/docs/advanced-topics/migrating-existing-events Read more}
     #
     # @example Add data and metadata to existing events
     #
@@ -362,7 +367,7 @@ module RubyEventStore
     # @param events [Array<Event>, Event] event(s) to serialize and overwrite again
     # @return [self]
     def overwrite(events_or_event)
-      repository.update_messages(transform(Array(events_or_event)))
+      @repository.update_messages(transform(Array(events_or_event)))
       self
     end
 
@@ -376,23 +381,28 @@ module RubyEventStore
     private
 
     def transform(events)
-      mapper.events_to_records(events)
+      @mapper.events_to_records(events)
     end
 
     def enrich_events_metadata(events)
+      if events.nil? || Array(events).any?(&:nil?)
+        warn <<~EOW
+          Passing `nil` to publish/append is deprecated and will raise ArgumentError in RubyEventStore 3.0.
+        EOW
+      end
       events = Array(events)
       events.each { |event| enrich_event_metadata(event) }
     end
 
     def enrich_event_metadata(event)
       metadata.each { |key, value| event.metadata[key] ||= value }
-      event.metadata[:timestamp] ||= clock.call
+      event.metadata[:timestamp] ||= @clock.call
       event.metadata[:valid_at] ||= event.metadata.fetch(:timestamp)
-      event.metadata[:correlation_id] ||= correlation_id_generator.call
+      event.metadata[:correlation_id] ||= @correlation_id_generator.call
     end
 
     def append_records_to_stream(records, stream_name:, expected_version:)
-      repository.append_to_stream(records, Stream.new(stream_name), ExpectedVersion.new(expected_version))
+      @repository.append_to_stream(records, Stream.new(stream_name), ExpectedVersion.new(expected_version))
     end
 
     protected
@@ -412,7 +422,5 @@ module RubyEventStore
     def default_correlation_id_generator
       -> { SecureRandom.uuid }
     end
-
-    attr_reader :repository, :mapper, :broker, :clock, :correlation_id_generator, :event_type_resolver
   end
 end

data/lib/ruby_event_store/dispatcher.rb

@@ -1,20 +1,12 @@
 # frozen_string_literal: true
 
 module RubyEventStore
-  class Dispatcher
-    def call(subscriber, event, _)
-      subscriber = subscriber.new if Class === subscriber
-      subscriber.call(event)
-    end
-
-    def verify(subscriber)
-      begin
-        subscriber_instance = Class === subscriber ? subscriber.new : subscriber
-      rescue ArgumentError
-        false
-      else
-        subscriber_instance.respond_to?(:call)
-      end
+  class Dispatcher < SyncScheduler
+    def initialize
+      warn <<~EOW
+        DEPRECATION WARNING: `RubyEventStore::Dispatcher` is deprecated and will be removed in the next major release.
+        Use `RubyEventStore::SyncScheduler` instead.
+      EOW
     end
   end
 end

data/lib/ruby_event_store/event.rb

@@ -78,7 +78,7 @@ module RubyEventStore
     end
 
     # Reads correlation_id from metadata.
-    # {http://railseventstore.org/docs/correlation_causation/ Find out more}
+    # {https://railseventstore.org/docs/core-concepts/correlation-causation Find out more}
     #
     # @return [String, nil]
     def correlation_id
@@ -86,7 +86,7 @@ module RubyEventStore
     end
 
     # Sets correlation_id in metadata.
-    # {http://railseventstore.org/docs/correlation_causation/ Find out more}
+    # {https://railseventstore.org/docs/core-concepts/correlation-causation Find out more}
     #
     # @param val [String]
     # @return [String]
@@ -95,7 +95,7 @@ module RubyEventStore
     end
 
     # Reads causation_id from metadata.
-    # {http://railseventstore.org/docs/correlation_causation/ Find out more}
+    # {https://railseventstore.org/docs/core-concepts/correlation-causation Find out more}
     #
     # @return [String, nil]
     def causation_id
@@ -103,7 +103,7 @@ module RubyEventStore
     end
 
     # Sets causation_id= in metadata.
-    # {http://railseventstore.org/docs/correlation_causation/ Find out more}
+    # {https://railseventstore.org/docs/core-concepts/correlation-causation Find out more}
     #
     # @param val [String]
     # @return [String]
@@ -113,7 +113,7 @@ module RubyEventStore
 
     # Sets correlation_id and causation_id in metadata based
     # on correlation_id and message_id of the provided message.
-    # {http://railseventstore.org/docs/correlation_causation/ Find out more}
+    # {https://railseventstore.org/docs/core-concepts/correlation-causation Find out more}
     #
     # @param other_message [Event, command] message to correlate with. Most likely an event or a command. Must respond to correlation_id and message_id.
     # @return [String] set causation_id
@@ -123,6 +123,21 @@ module RubyEventStore
       self
     end
 
+    # Returns a hash of the name/value pairs for the given event attributes.
+    #
+    # @param attributes [Array] attributes to deconstruct
+    # @return [Hash] deconstructed event
+    def deconstruct_keys(attributes)
+      {
+        causation_id: causation_id,
+        correlation_id: correlation_id,
+        data: data,
+        event_id: event_id,
+        event_type: event_type,
+        metadata: metadata.to_h
+      }.slice(*attributes)
+    end
+
     alias_method :eql?, :==
   end
 end

data/lib/ruby_event_store/immediate_async_dispatcher.rb

@@ -1,17 +1,13 @@
 # frozen_string_literal: true
 
 module RubyEventStore
-  class ImmediateAsyncDispatcher
+  class ImmediateAsyncDispatcher < ImmediateDispatcher
     def initialize(scheduler:)
-      @scheduler = scheduler
-    end
-
-    def call(subscriber, _, record)
-      @scheduler.call(subscriber, record)
-    end
-
-    def verify(subscriber)
-      @scheduler.verify(subscriber)
+      warn <<~EOW
+        DEPRECATION WARNING: `RubyEventStore::ImmediateAsyncDispatcher` is deprecated and will be removed in the next major release.
+        Use `RubyEventStore::ImmediateDispatcher` instead.
+      EOW
+      super
     end
   end
 end

data/lib/ruby_event_store/immediate_dispatcher.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module RubyEventStore
+  class ImmediateDispatcher
+    def initialize(scheduler:)
+      @scheduler = scheduler
+    end
+
+    def call(subscriber, _, record)
+      @scheduler.call(subscriber, record)
+    end
+
+    def verify(subscriber)
+      @scheduler.verify(subscriber)
+    end
+  end
+end

data/lib/ruby_event_store/in_memory_repository.rb

@@ -8,7 +8,7 @@ module RubyEventStore
         Mixing expected version :any and specific position (or :auto) is unsupported.
 
         Read more about expected versions here:
-        https://railseventstore.org/docs/v2/expected_version/
+        https://railseventstore.org/docs/core-concepts/expected-version
         EOS
       end
     end
@@ -100,7 +100,7 @@ module RubyEventStore
     end
 
     def count(spec)
-      read_scope(spec).count
+      read_scope(spec).size # mutant:disable
     end
 
     def update_messages(records)
@@ -234,12 +234,18 @@ module RubyEventStore
     end
 
     def ensure_supported_any_usage(resolved_version, stream)
-      if @ensure_supported_any_usage
-        stream_positions = streams.fetch(stream.name, Array.new).map(&:position)
-        if resolved_version.nil?
-          raise UnsupportedVersionAnyUsage if !stream_positions.compact.empty?
+      stream_positions = streams.fetch(stream.name, Array.new).map(&:position)
+      violation =
+        (resolved_version.nil? && !stream_positions.compact.empty?) ||
+        (!resolved_version.nil? && stream_positions.include?(nil))
+
+      if violation
+        if @ensure_supported_any_usage
+          raise UnsupportedVersionAnyUsage
         else
-          raise UnsupportedVersionAnyUsage if stream_positions.include?(nil)
+          warn <<~EOW
+            Mixing expected version :any and specific position (or :auto) is deprecated and will raise UnsupportedVersionAnyUsage in RubyEventStore 3.0.
+          EOW
         end
       end
     end

data/lib/ruby_event_store/instrumented_broker.rb

@@ -2,55 +2,75 @@
 
 module RubyEventStore
   class InstrumentedBroker
+    DEPRECATION_MESSAGE = <<~EOW
+      Instrumentation event names *.rails_event_store are deprecated and will be removed in the next major release.
+      Use *.ruby_event_store instead.
+    EOW
+    private_constant :DEPRECATION_MESSAGE
+
     def initialize(broker, instrumentation)
       @broker = broker
       @instrumentation = instrumentation
     end
 
     def call(topic, event, record)
-      instrumentation.instrument("call.broker.rails_event_store", topic: topic, event: event, record: record) do
-        if broker.public_method(:call).arity == 3
-          broker.call(topic, event, record)
-        else
-          warn <<~EOW
-            Message broker shall support topics.
-            Topic WILL BE IGNORED in the current broker.
-            Modify the broker implementation to pass topic as an argument to broker.call method.
-          EOW
-          broker.call(event, record)
+      instrumentation.instrument("call.broker.ruby_event_store", topic: topic, event: event, record: record) do
+        deprecated_instrument("call.broker.rails_event_store", topic: topic, event: event, record: record) do
+          if broker.public_method(:call).arity == 3
+            broker.call(topic, event, record)
+          else
+            warn <<~EOW
+              Message broker shall support topics.
+              Topic WILL BE IGNORED in the current broker.
+              Modify the broker implementation to pass topic as an argument to broker.call method.
+            EOW
+            broker.call(event, record)
+          end
         end
       end
     end
 
     def add_subscription(subscriber, topics)
-      instrumentation.instrument("add_subscription.broker.rails_event_store", subscriber: subscriber, topics: topics) do
-        broker.add_subscription(subscriber, topics)
+      instrumentation.instrument("add_subscription.broker.ruby_event_store", subscriber: subscriber, topics: topics) do
+        deprecated_instrument("add_subscription.broker.rails_event_store", subscriber: subscriber, topics: topics) do
+          broker.add_subscription(subscriber, topics)
+        end
       end
     end
 
     def add_global_subscription(subscriber)
-      instrumentation.instrument("add_global_subscription.broker.rails_event_store", subscriber: subscriber) do
-        broker.add_global_subscription(subscriber)
+      instrumentation.instrument("add_global_subscription.broker.ruby_event_store", subscriber: subscriber) do
+        deprecated_instrument("add_global_subscription.broker.rails_event_store", subscriber: subscriber) do
+          broker.add_global_subscription(subscriber)
+        end
       end
     end
 
     def add_thread_subscription(subscriber, topics)
       instrumentation.instrument(
-        "add_thread_subscription.broker.rails_event_store",
+        "add_thread_subscription.broker.ruby_event_store",
         subscriber: subscriber,
         topics: topics,
-      ) { broker.add_thread_subscription(subscriber, topics) }
+      ) do
+        deprecated_instrument("add_thread_subscription.broker.rails_event_store", subscriber: subscriber, topics: topics) do
+          broker.add_thread_subscription(subscriber, topics)
+        end
+      end
     end
 
     def add_thread_global_subscription(subscriber)
-      instrumentation.instrument("add_thread_global_subscription.broker.rails_event_store", subscriber: subscriber) do
-        broker.add_thread_global_subscription(subscriber)
+      instrumentation.instrument("add_thread_global_subscription.broker.ruby_event_store", subscriber: subscriber) do
+        deprecated_instrument("add_thread_global_subscription.broker.rails_event_store", subscriber: subscriber) do
+          broker.add_thread_global_subscription(subscriber)
+        end
       end
     end
 
     def all_subscriptions_for(topic)
-      instrumentation.instrument("all_subscriptions_for.broker.rails_event_store", topic: topic) do
-        broker.all_subscriptions_for(topic)
+      instrumentation.instrument("all_subscriptions_for.broker.ruby_event_store", topic: topic) do
+        deprecated_instrument("all_subscriptions_for.broker.rails_event_store", topic: topic) do
+          broker.all_subscriptions_for(topic)
+        end
       end
     end
 
@@ -69,5 +89,17 @@ module RubyEventStore
     private
 
     attr_reader :instrumentation, :broker
+
+    def deprecated_instrument(name, payload, &block)
+      canonical_name = name.sub("rails_event_store", "ruby_event_store")
+      old_listeners = instrumentation.notifier.all_listeners_for(name)
+      new_listeners = instrumentation.notifier.all_listeners_for(canonical_name)
+      if (old_listeners - new_listeners).any?
+        warn DEPRECATION_MESSAGE
+        instrumentation.instrument(name, payload, &block)
+      else
+        yield
+      end
+    end
   end
 end

data/lib/ruby_event_store/instrumented_dispatcher.rb

@@ -2,14 +2,22 @@
 
 module RubyEventStore
   class InstrumentedDispatcher
+    DEPRECATION_MESSAGE = <<~EOW
+      Instrumentation event names *.rails_event_store are deprecated and will be removed in the next major release.
+      Use *.ruby_event_store instead.
+    EOW
+    private_constant :DEPRECATION_MESSAGE
+
     def initialize(dispatcher, instrumentation)
       @dispatcher = dispatcher
       @instrumentation = instrumentation
     end
 
     def call(subscriber, event, record)
-      instrumentation.instrument("call.dispatcher.rails_event_store", event: event, subscriber: subscriber) do
-        dispatcher.call(subscriber, event, record)
+      instrumentation.instrument("call.dispatcher.ruby_event_store", event: event, subscriber: subscriber) do
+        deprecated_instrument("call.dispatcher.rails_event_store", event: event, subscriber: subscriber) do
+          dispatcher.call(subscriber, event, record)
+        end
       end
     end
 
@@ -28,5 +36,17 @@ module RubyEventStore
     private
 
     attr_reader :instrumentation, :dispatcher
+
+    def deprecated_instrument(name, payload, &block)
+      canonical_name = name.sub("rails_event_store", "ruby_event_store")
+      old_listeners = instrumentation.notifier.all_listeners_for(name)
+      new_listeners = instrumentation.notifier.all_listeners_for(canonical_name)
+      if (old_listeners - new_listeners).any?
+        warn DEPRECATION_MESSAGE
+        instrumentation.instrument(name, payload, &block)
+      else
+        yield
+      end
+    end
   end
 end