eventsimple 1.0.0 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8b1d2a6b5eb979f7ba40f0bd7500b001b43497259e56432cb0f6c4d3bf9d2816
-  data.tar.gz: e0d2cc3ca58637a1d0267f634b03575f03db026bcba7f62d25d6b82b7228c610
+  metadata.gz: c89fd452fb688ea84659fb341c78b8c30ce14632a948750fab7ec831d34baf0e
+  data.tar.gz: ef3abdd6bd8158e65e476a23170c9e9b42329974abd7de679f2ca27c2203972e
 SHA512:
-  metadata.gz: 76d5867b765ae7cb39a87ee8f094a70f2fdd5d9cb81f69e198cf26e4dffa01ae15fccc40afce852922f8f1fc408c01c59d13aa87e6d59f81b52d0f1ad446cd6a
-  data.tar.gz: 2713b5f26dbd5ada7db2135e2cd7453a1dea13e853f8046b57d989553bbe4ae08052dc1aa1b59b87bfdc3e5eb782cbf8ae90fc7e47f116641444efcd57a06e2f
+  metadata.gz: 804e17de52e7f4f5c172b1e3a8735c1037966298aaf40952ffc36446ad37514890fabe4cf602164932723598c83d8060a6ab0f9a05d39d01b932b9fbcd0bd401
+  data.tar.gz: 77589ed9dbb33bd4142282599f00a53790468ebdd1695d74bd19a1a7d515937988c31c70db84cbc2b91a76ce0e3b32aab910735cacbfc3f4e81ce055fc4023c7

data/CHANGELOG.md

@@ -6,6 +6,14 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## Unreleased
 
+## 1.1.0 - 2023-06-11
+### Changed
+- Reactors now use ActiveJob instead of Sidekiq directly. This allows for more
+  flexibility in the future and allows for the use of other job backends.
+  The reactor class definition must now inherit from Eventsimple::Reactor and are no longer
+  instantiated with the event as an argument. Instead, the event is passed to the `call` method.
+  This change is backwards compatible with existing inflight reactor jobs.
+
 ## 1.0.0 - 2023-05-03
 ### Changed
 - Release under MIT license

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    eventsimple (1.0.0)
+    eventsimple (1.1.0)
       dry-struct (~> 1.6)
       dry-types (~> 1.7)
       pg (~> 1.4)
@@ -12,67 +12,67 @@ PATH
 GEM
   remote: https://rubygems.org/
   specs:
-    actioncable (7.0.4.3)
-      actionpack (= 7.0.4.3)
-      activesupport (= 7.0.4.3)
+    actioncable (7.0.5)
+      actionpack (= 7.0.5)
+      activesupport (= 7.0.5)
       nio4r (~> 2.0)
       websocket-driver (>= 0.6.1)
-    actionmailbox (7.0.4.3)
-      actionpack (= 7.0.4.3)
-      activejob (= 7.0.4.3)
-      activerecord (= 7.0.4.3)
-      activestorage (= 7.0.4.3)
-      activesupport (= 7.0.4.3)
+    actionmailbox (7.0.5)
+      actionpack (= 7.0.5)
+      activejob (= 7.0.5)
+      activerecord (= 7.0.5)
+      activestorage (= 7.0.5)
+      activesupport (= 7.0.5)
       mail (>= 2.7.1)
       net-imap
       net-pop
       net-smtp
-    actionmailer (7.0.4.3)
-      actionpack (= 7.0.4.3)
-      actionview (= 7.0.4.3)
-      activejob (= 7.0.4.3)
-      activesupport (= 7.0.4.3)
+    actionmailer (7.0.5)
+      actionpack (= 7.0.5)
+      actionview (= 7.0.5)
+      activejob (= 7.0.5)
+      activesupport (= 7.0.5)
       mail (~> 2.5, >= 2.5.4)
       net-imap
       net-pop
       net-smtp
       rails-dom-testing (~> 2.0)
-    actionpack (7.0.4.3)
-      actionview (= 7.0.4.3)
-      activesupport (= 7.0.4.3)
-      rack (~> 2.0, >= 2.2.0)
+    actionpack (7.0.5)
+      actionview (= 7.0.5)
+      activesupport (= 7.0.5)
+      rack (~> 2.0, >= 2.2.4)
       rack-test (>= 0.6.3)
       rails-dom-testing (~> 2.0)
       rails-html-sanitizer (~> 1.0, >= 1.2.0)
-    actiontext (7.0.4.3)
-      actionpack (= 7.0.4.3)
-      activerecord (= 7.0.4.3)
-      activestorage (= 7.0.4.3)
-      activesupport (= 7.0.4.3)
+    actiontext (7.0.5)
+      actionpack (= 7.0.5)
+      activerecord (= 7.0.5)
+      activestorage (= 7.0.5)
+      activesupport (= 7.0.5)
       globalid (>= 0.6.0)
       nokogiri (>= 1.8.5)
-    actionview (7.0.4.3)
-      activesupport (= 7.0.4.3)
+    actionview (7.0.5)
+      activesupport (= 7.0.5)
       builder (~> 3.1)
       erubi (~> 1.4)
       rails-dom-testing (~> 2.0)
       rails-html-sanitizer (~> 1.1, >= 1.2.0)
-    activejob (7.0.4.3)
-      activesupport (= 7.0.4.3)
+    activejob (7.0.5)
+      activesupport (= 7.0.5)
       globalid (>= 0.3.6)
-    activemodel (7.0.4.3)
-      activesupport (= 7.0.4.3)
-    activerecord (7.0.4.3)
-      activemodel (= 7.0.4.3)
-      activesupport (= 7.0.4.3)
-    activestorage (7.0.4.3)
-      actionpack (= 7.0.4.3)
-      activejob (= 7.0.4.3)
-      activerecord (= 7.0.4.3)
-      activesupport (= 7.0.4.3)
+    activemodel (7.0.5)
+      activesupport (= 7.0.5)
+    activerecord (7.0.5)
+      activemodel (= 7.0.5)
+      activesupport (= 7.0.5)
+    activestorage (7.0.5)
+      actionpack (= 7.0.5)
+      activejob (= 7.0.5)
+      activerecord (= 7.0.5)
+      activesupport (= 7.0.5)
       marcel (~> 1.0)
       mini_mime (>= 1.1.0)
-    activesupport (7.0.4.3)
+    activesupport (7.0.5)
       concurrent-ruby (~> 1.0, >= 1.0.2)
       i18n (>= 1.6, < 2)
       minitest (>= 5.1)
@@ -88,7 +88,7 @@ GEM
       thor (~> 1.0)
     coderay (1.1.3)
     concurrent-ruby (1.2.2)
-    connection_pool (2.4.0)
+    connection_pool (2.4.1)
     crass (1.0.6)
     date (3.3.3)
     diff-lcs (1.5.0)
@@ -136,16 +136,18 @@ GEM
       guard (~> 2.1)
       guard-compat (~> 1.1)
       rspec (>= 2.99.0, < 4.0)
-    i18n (1.13.0)
+    i18n (1.14.1)
       concurrent-ruby (~> 1.0)
     ice_nine (0.11.2)
     json (2.6.3)
+    language_server-protocol (3.17.0.3)
+    lint_roller (1.0.0)
     listen (3.8.0)
       rb-fsevent (~> 0.10, >= 0.10.3)
       rb-inotify (~> 0.9, >= 0.9.10)
-    loofah (2.20.0)
+    loofah (2.21.3)
       crass (~> 1.0.2)
-      nokogiri (>= 1.5.9)
+      nokogiri (>= 1.12.0)
     lumberjack (1.2.8)
     mail (2.8.1)
       mini_mime (>= 0.1.1)
@@ -167,9 +169,9 @@ GEM
     net-smtp (0.3.3)
       net-protocol
     nio4r (2.5.9)
-    nokogiri (1.14.3-arm64-darwin)
+    nokogiri (1.15.2-arm64-darwin)
       racc (~> 1.4)
-    nokogiri (1.14.3-x86_64-linux)
+    nokogiri (1.15.2-x86_64-linux)
       racc (~> 1.4)
     notiffany (0.1.3)
       nenv (~> 0.1)
@@ -177,42 +179,44 @@ GEM
     parallel (1.23.0)
     parse_a_changelog (1.2.0)
       treetop (~> 1.6)
-    parser (3.2.2.1)
+    parser (3.2.2.3)
       ast (~> 2.4.1)
+      racc
     pg (1.5.3)
     polyglot (0.3.5)
     pry (0.14.2)
       coderay (~> 1.1)
       method_source (~> 1.0)
     public_suffix (5.0.1)
-    puma (6.2.2)
+    puma (6.3.0)
       nio4r (~> 2.0)
-    racc (1.6.2)
+    racc (1.7.0)
     rack (2.2.7)
     rack-test (2.1.0)
       rack (>= 1.3)
-    rails (7.0.4.3)
-      actioncable (= 7.0.4.3)
-      actionmailbox (= 7.0.4.3)
-      actionmailer (= 7.0.4.3)
-      actionpack (= 7.0.4.3)
-      actiontext (= 7.0.4.3)
-      actionview (= 7.0.4.3)
-      activejob (= 7.0.4.3)
-      activemodel (= 7.0.4.3)
-      activerecord (= 7.0.4.3)
-      activestorage (= 7.0.4.3)
-      activesupport (= 7.0.4.3)
+    rails (7.0.5)
+      actioncable (= 7.0.5)
+      actionmailbox (= 7.0.5)
+      actionmailer (= 7.0.5)
+      actionpack (= 7.0.5)
+      actiontext (= 7.0.5)
+      actionview (= 7.0.5)
+      activejob (= 7.0.5)
+      activemodel (= 7.0.5)
+      activerecord (= 7.0.5)
+      activestorage (= 7.0.5)
+      activesupport (= 7.0.5)
       bundler (>= 1.15.0)
-      railties (= 7.0.4.3)
+      railties (= 7.0.5)
     rails-dom-testing (2.0.3)
       activesupport (>= 4.2.0)
       nokogiri (>= 1.6)
-    rails-html-sanitizer (1.5.0)
-      loofah (~> 2.19, >= 2.19.1)
-    railties (7.0.4.3)
-      actionpack (= 7.0.4.3)
-      activesupport (= 7.0.4.3)
+    rails-html-sanitizer (1.6.0)
+      loofah (~> 2.21)
+      nokogiri (~> 1.14)
+    railties (7.0.5)
+      actionpack (= 7.0.5)
+      activesupport (= 7.0.5)
       method_source
       rake (>= 12.2)
       thor (~> 1.0)
@@ -225,7 +229,7 @@ GEM
     rchardet (1.8.0)
     redis-client (0.14.1)
       connection_pool
-    regexp_parser (2.8.0)
+    regexp_parser (2.8.1)
     retriable (3.1.2)
     rexml (3.2.5)
     rspec (3.12.0)
@@ -240,16 +244,16 @@ GEM
     rspec-mocks (3.12.5)
       diff-lcs (>= 1.2.0, < 2.0)
       rspec-support (~> 3.12.0)
-    rspec-rails (6.0.1)
+    rspec-rails (6.0.3)
       actionpack (>= 6.1)
       activesupport (>= 6.1)
       railties (>= 6.1)
-      rspec-core (~> 3.11)
-      rspec-expectations (~> 3.11)
-      rspec-mocks (~> 3.11)
-      rspec-support (~> 3.11)
+      rspec-core (~> 3.12)
+      rspec-expectations (~> 3.12)
+      rspec-mocks (~> 3.12)
+      rspec-support (~> 3.12)
     rspec-support (3.12.0)
-    rubocop (1.50.2)
+    rubocop (1.52.0)
       json (~> 2.3)
       parallel (~> 1.10)
       parser (>= 3.2.0.0)
@@ -259,30 +263,47 @@ GEM
       rubocop-ast (>= 1.28.0, < 2.0)
       ruby-progressbar (~> 1.7)
       unicode-display_width (>= 2.4.0, < 3.0)
-    rubocop-ast (1.28.1)
+    rubocop-ast (1.29.0)
       parser (>= 3.2.1.0)
     rubocop-capybara (2.18.0)
       rubocop (~> 1.41)
-    rubocop-performance (1.17.1)
+    rubocop-factory_bot (2.23.1)
+      rubocop (~> 1.33)
+    rubocop-performance (1.18.0)
       rubocop (>= 1.7.0, < 2.0)
       rubocop-ast (>= 0.4.0)
     rubocop-rails (2.19.1)
       activesupport (>= 4.2.0)
       rack (>= 1.1)
       rubocop (>= 1.33.0, < 2.0)
-    rubocop-rspec (2.20.0)
+    rubocop-rspec (2.22.0)
       rubocop (~> 1.33)
       rubocop-capybara (~> 2.17)
-    rubocop-vendor (0.9.2)
+      rubocop-factory_bot (~> 2.22)
+    rubocop-vendor (0.11.0)
       rubocop (>= 0.53.0)
     ruby-progressbar (1.13.0)
     shellany (0.0.1)
-    sidekiq (7.1.0)
+    sidekiq (7.1.1)
       concurrent-ruby (< 2)
       connection_pool (>= 2.3.0)
       rack (>= 2.2.4)
       redis-client (>= 0.14.0)
-    thor (1.2.1)
+    standard (1.29.0)
+      language_server-protocol (~> 3.17.0.2)
+      lint_roller (~> 1.0)
+      rubocop (~> 1.52.0)
+      standard-custom (~> 1.0.0)
+      standard-performance (~> 1.1.0)
+    standard-custom (1.0.1)
+      lint_roller (~> 1.0)
+    standard-performance (1.1.0)
+      lint_roller (~> 1.0)
+      rubocop-performance (~> 1.18.0)
+    standard-rails (0.1.0)
+      lint_roller (~> 1.0)
+      rubocop-rails (~> 2.19.0)
+    thor (1.2.2)
     timeout (0.3.2)
     treetop (1.6.12)
       polyglot (~> 0.3)
@@ -292,12 +313,11 @@ GEM
     websocket-driver (0.7.5)
       websocket-extensions (>= 0.1.0)
     websocket-extensions (0.1.5)
-    ws-style (6.14.6)
-      rubocop (>= 1.36)
-      rubocop-performance (>= 1.10.2)
-      rubocop-rails (>= 2.9.1)
+    ws-style (7.1.0)
       rubocop-rspec (>= 2.2.0)
-      rubocop-vendor (>= 0.6.0)
+      rubocop-vendor (>= 0.11)
+      standard (>= 1.28.2)
+      standard-rails (>= 0.1.0)
     zeitwerk (2.6.8)
 
 PLATFORMS

data/README.md

@@ -1,8 +1,8 @@
 # Eventsimple
-[![Github Actions Badge](https://github.com/wealthsimple/eventsimple/actions/workflows/main.yml/badge.svg)](https://github.com/wealthsimple/eventsimple/actions)
+[![Github Actions](https://github.com/wealthsimple/eventsimple/actions/workflows/default.yml/badge.svg)](https://github.com/wealthsimple/eventsimple/actions/workflows/default.yml) [![Gem Version](https://badge.fury.io/rb/eventsimple.svg?v=1)](https://rubygems.org/gems/eventsimple)
 
 ## What
-Eventsimple implements a simple deterministic event driven system using ActiveRecord and Sidekiq.
+Eventsimple implements a simple deterministic event driven system using ActiveRecord and ActiveJob.
 
 Use Eventsimple to:
 
@@ -11,10 +11,10 @@ Use Eventsimple to:
 * Implement a transactional outbox.
 * Store audit logs of changes to your ActiveRecord objects.
 
-Eventsimple uses standard Rails features like [Single Table Inheritance](https://api.rubyonrails.org/classes/ActiveRecord/Inheritance.html) and [Optimistic Locking](https://api.rubyonrails.org/classes/ActiveRecord/Locking/Optimistic.html) to implement a simple event driven system.
-Async workflows are handled using [Sidekiq](https://github.com/sidekiq/sidekiq).
+Eventsimple uses standard Rails features like [Single Table Inheritance](https://api.rubyonrails.org/classes/ActiveRecord/Inheritance.html) and [Optimistic Locking](https://api.rubyonrails.org/classes/ActiveRecord/Locking/Optimistic.html).
+Async workflows are handled using [ActiveJob](https://guides.rubyonrails.org/active_job_basics.html).
 
-Typical events in Eventsimple are ActiveRecord models using STI and look like this:
+Typical events in Eventsimple are ActiveRecord models that look like this:
 
 ```ruby
  <UserComponent::Events::Created
@@ -40,19 +40,53 @@ Typical events in Eventsimple are ActiveRecord models using STI and look like th
 
 ## Setup
 
-Add the following line to your Gemfile:
+Add the following line to your Gemfile and run `bundle install`:
 
 ```
 gem 'eventsimple'
 ```
-Then run `bundle install`
 
-The eventsimple UI allows you to view and navigate event history. Add the following line to your routes.rb to use it:
+The eventsimple UI allows you to view and navigate event history. Add the following line to your routes.rb:
 
 ```
 mount Eventsimple::Engine => '/eventsimple'
 ```
 
+Setup an initializer in `config/initializers/eventsimple.rb`:
+
+```ruby
+  Eventsimple.configure do |config|
+    # Optional: Register your dispatch classes here.
+    # Dispatch classes are used to register reactors to events.
+    # Reactors are used to implement side effects.
+    # See the Reactors section below for more details.
+    config.dispatchers = []
+
+    # Optional: Entity updates use optimistic locking to enforce sequential updates.
+    # Set the max number of times to retry on concurrency failures.
+    # Defaults to 2
+    config.max_concurrency_retries = 2
+
+    # Optional: the metadata column is used to store optional metadata associated with the event.
+    # The default implemention enforces a typed constraint on the metadata column
+    # with the following two properties: `actor_id` and `reason`
+    # Use a custom metadata class to override this behaviour.
+    # Defaults to `Eventsimple::Metadata`
+    config.metadata_klass = 'Eventsimple::Metadata'
+
+    # Optional: Reactors inherit from an ActiveJob base class.
+    # Set the parent class for reactors.
+    # Defaults to ActiveJob::Base.
+    config.active_job_parent_klass = 'ApplicationJob'
+
+    # Optional: When using an ActiveJob adapter that writes to a different data store like redis,
+    # it is possible that the reactor is executed before the transaction persisting the event is committed. This can result in noisy errors when using processors like Sidekiq.
+    # Enable this option to retry the reactor inline if the event is not found.
+    # Defaults to false.
+    config.retry_reactor_on_record_not_found = true
+  end
+```
+
 Generate a migration and add `Eventsimple` to an existing ActiveRecord model.
 
 ```ruby
@@ -93,7 +127,7 @@ add_column :users, :lock_version, :integer
 
 Adding lock_version to the model enables [optimistic locking](https://api.rubyonrails.org/classes/ActiveRecord/Locking/Optimistic.html) and protects against concurrent updates to stale versions of the model. Eventsimple will automatically retry on concurrency failures.
 
-`events_namespace` is an optional argument pointing to the directory where your events classes are defined. If you do not specify this argument, Eventsimple will store the full namespace of the event classes in the STI type column.
+`events_namespace` is an optional argument pointing to the directory where your events classes are defined. If you do not specify this argument, Eventsimple will store the full namespace of the event classes in the STI column.
 
 ### Event Table definition
 
@@ -192,14 +226,14 @@ They should **only** contain business logic that make additional database writes
 This is because executing writes to other data stores, e.g API call or writes to kafka/sqs, will result in the transaction being non-deterministic.
 
 #### Async Reactors
-Async reactors are executed via Sidekiq. Eventsimple implements checks to enforce reliable eventually consistent behaviour.
+Async reactors are executed via ActiveJob. Eventsimple implements checks to enforce reliable eventually consistent behaviour.
 
 Use Async reactors to kick off async workflows or writes to external data sources as a side effect of model updates.
 
 Reactor example:
 
 ```ruby
-# Register your dispatch class in an initializer.
+# Register your dispatch classes in config/initializers/eventsimple.rb.
 Eventsimple.configure do |config|
   config.dispatchers = %w[
     UserComponent::Dispatcher
@@ -224,15 +258,10 @@ end
 
 # Reactor classes accept the event as the only argument in the constructor
 # and must define a `call` method
-module UserComponent::Reactors::Created
+module UserComponent::Reactors::Created < Eventsimple::Reactor
   class SendNotification
-    def initialize(event)
-      @event = event
-      @user = event.aggregate
-    end
-    attr_reader :event, :user
-
-    def call
+    def call(event)
+      user = event.aggregate
       # do something
     end
   end
@@ -242,7 +271,7 @@ end
 ## Configuring an outbox consumer
 
 For many use cases, async reactors are sufficient to handle workflows like making an API call or publishing to a message broker.
-However since reactors use Sidekiq, order is not guaranteed.
+However since reactors use ActiveJob, order is not guaranteed.
 
 Eventsimple provides an outbox implementation with order and eventual consistency guarantees.
 

data/Rakefile

@@ -3,6 +3,7 @@
 require "bundler/setup"
 
 APP_RAKEFILE = File.expand_path('spec/dummy/Rakefile', __dir__)
+Rake.load_rakefile 'spec/dummy/Rakefile'
 load 'rails/tasks/engine.rake'
 
 load 'rails/tasks/statistics.rake'

data/app/controllers/eventsimple/entities_controller.rb

@@ -6,7 +6,7 @@ module Eventsimple
       @model_class = event_classes.find { |d| d.name == @model_name }
       @aggregate_id = params[:id]
       @event_id = params[:e] || -1
-      @tab_id = params[:t] == 'event' ? 'event' : 'entity'
+      @tab_id = (params[:t] == 'event') ? 'event' : 'entity'
 
       primary_key = @model_class.event_class._aggregate_id
       @entity = @model_class.find_by!(primary_key => @aggregate_id)

data/eventsimple.gemspec

@@ -8,8 +8,8 @@ Gem::Specification.new do |spec|
   spec.authors = ['Zulfiqar Ali']
   spec.email = ['zulfiqar@wealthsimple.com']
 
-  spec.summary = 'Event driven toolkit using Rails and Sidekiq'
-  spec.description = 'Event driven architecture using Rails and Sidekiq'
+  spec.summary = 'Event sourcing toolkit using Rails and ActiveJob'
+  spec.description = 'Event sourcing toolkit using Rails and ActiveJob'
   spec.homepage = 'https://github.com/wealthsimple/eventsimple'
   spec.required_ruby_version = ">= 3.2.0"
 

data/lib/eventsimple/configuration.rb

@@ -2,8 +2,10 @@
 
 module Eventsimple
   class Configuration
-    attr_reader :max_concurrency_retries, :dispatchers
+    attr_reader :max_concurrency_retries
     attr_writer :metadata_klass
+    attr_writer :active_job_parent_klass
+    attr_accessor :retry_reactor_on_record_not_found
 
     attr_accessor :ui_visible_models
 
@@ -11,6 +13,8 @@ module Eventsimple
       @dispatchers = []
       @max_concurrency_retries = 2
       @metadata_klass = 'Eventsimple::Metadata'
+      @active_job_parent_klass = 'ActiveJob::Base'
+      @retry_reactor_on_record_not_found = false
 
       @ui_visible_models = [] # internal use only
     end
@@ -29,8 +33,19 @@ module Eventsimple
       @dispatchers = value
     end
 
+    # rubocop:disable Naming/MemoizedInstanceVariableName
+
+    def dispatchers
+      @dispatchers_klass_consts ||= @dispatchers.map(&:constantize)
+    end
+
     def metadata_klass
-      @klass ||= @metadata_klass.constantize # rubocop:disable Naming/MemoizedInstanceVariableName
+      @metadata_klass_const ||= @metadata_klass.constantize
+    end
+
+    def active_job_parent_klass
+      @active_job_parent_klass_const ||= @active_job_parent_klass.constantize
     end
+    # rubocop:enable Naming/MemoizedInstanceVariableName
   end
 end

data/lib/eventsimple/engine.rb

@@ -11,11 +11,9 @@ module Eventsimple
     end
 
     config.after_initialize do
-      dispatchers = Eventsimple.configuration.dispatchers.map(&:constantize)
+      require 'eventsimple/reactor'
 
-      unless dispatchers.all? { |dispatcher| dispatcher.superclass == Eventsimple::Dispatcher }
-        raise ArgumentError, 'dispatchers must inherit from Eventsimple::Dispatcher'
-      end
+      verify_dispatchers!
 
       retry_intervals = Array.new(Eventsimple.configuration.max_concurrency_retries) { 0 }
 
@@ -33,5 +31,13 @@ module Eventsimple
         }
       end
     end
+
+    def verify_dispatchers!
+      unless Eventsimple.configuration.dispatchers.all? { |dispatcher|
+        dispatcher < Eventsimple::Dispatcher
+      }
+        raise ArgumentError, 'dispatchers must inherit from Eventsimple::Dispatcher'
+      end
+    end
   end
 end

data/lib/eventsimple/event_dispatcher.rb

@@ -29,11 +29,11 @@ module Eventsimple
     def self.dispatch(event)
       reactors = rules.for(event)
       reactors.sync.each do |reactor|
-        reactor.new(event).call
+        reactor.perform_now(event)
         event.reload
       end
       reactors.async.each do |reactor|
-        ReactorWorker.perform_async(event.to_global_id.to_s, reactor.to_s)
+        reactor.perform_later(event)
       end
     end
 

data/lib/eventsimple/outbox/consumer.rb

@@ -13,7 +13,7 @@ module Eventsimple
 
           Signal.trap('SIGINT') do
             self.stop_consumer = true
-            STDOUT.puts('SIGINT received, stopping consumer')
+            $stdout.puts('SIGINT received, stopping consumer')
           end
         end
       end

data/lib/eventsimple/reactor.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+module Eventsimple
+  class Reactor < Eventsimple.configuration.active_job_parent_klass
+    queue_as :eventsimple
+
+    def perform(event)
+      call(event)
+    end
+
+    around_perform do |job, block|
+      event_global_id = job.arguments.first
+      reactor_class = job.arguments.second
+
+      # For non database based processors like sidekiq, the reactor may trigger before the
+      # transaction is committed. Attempt to wait for the transaction to be commited before
+      # running the reactor. This is not a perfect solution, but it's better than nothing.
+      if Eventsimple.configuration.retry_reactor_on_record_not_found
+        begin
+          Retriable.with_context(:reactor) do
+            ApplicationRecord.uncached { GlobalID::Locator.locate(event_global_id) }
+          end
+        rescue ActiveRecord::RecordNotFound
+          Rails.logger.error("Event #{event_global_id} not found for reactor: #{reactor_class}")
+          return
+        end
+      end
+
+      block.call
+    end
+  end
+end

data/lib/eventsimple/reactor_worker.rb

@@ -1,5 +1,6 @@
 # frozen_string_literal: true
 
+# legacy worker for backwards compatibility when upgrading from Eventsimple <= 1.0.0
 module Eventsimple
   class ReactorWorker
     include Sidekiq::Worker
@@ -12,7 +13,7 @@ module Eventsimple
       Rails.logger.error("Event #{event_global_id} not found for reactor: #{reactor_class}")
     else
       reactor = reactor_class.constantize
-      reactor.new(event).call
+      reactor.new.call(event)
     end
   end
 end

data/lib/eventsimple/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Eventsimple
-  VERSION = '1.0.0'
+  VERSION = '1.1.0'
 end

data/lib/eventsimple.rb

@@ -4,6 +4,7 @@ require "eventsimple/version"
 require "eventsimple/engine"
 
 require 'active_model'
+require 'active_job'
 require 'active_support'
 require 'dry-types'
 require 'dry-struct'

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: eventsimple
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.1.0
 platform: ruby
 authors:
 - Zulfiqar Ali
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-05-03 00:00:00.000000000 Z
+date: 2023-06-15 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: dry-struct
@@ -220,14 +220,13 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-description: Event driven architecture using Rails and Sidekiq
+description: Event sourcing toolkit using Rails and ActiveJob
 email:
 - zulfiqar@wealthsimple.com
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- ".DS_Store"
 - ".rspec"
 - ".rubocop.yml"
 - ".ruby-version"
@@ -272,6 +271,7 @@ files:
 - lib/eventsimple/metadata_type.rb
 - lib/eventsimple/outbox/consumer.rb
 - lib/eventsimple/outbox/models/cursor.rb
+- lib/eventsimple/reactor.rb
 - lib/eventsimple/reactor_worker.rb
 - lib/eventsimple/support/spec_helpers.rb
 - lib/eventsimple/version.rb
@@ -300,5 +300,5 @@ requirements: []
 rubygems_version: 3.4.10
 signing_key: 
 specification_version: 4
-summary: Event driven toolkit using Rails and Sidekiq
+summary: Event sourcing toolkit using Rails and ActiveJob
 test_files: []