decide.rb 0.6.2 → 0.7.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cdfca1b85746ead6ae446e0b9bfb697a4cfb08685581cabe78cf6462d88db9a4
-  data.tar.gz: ab375b8863a3e88c39e3f8ce3c6c7957758b2d557c7770f260ba4278843a6fea
+  metadata.gz: 8ac9878aee3455667ca2fa5e7b4226af3588387e8f42a5a67e102b96c9b2e74d
+  data.tar.gz: 3f168429cc20342dca21ab57ad82ab498e3ee2d83623713c3f730966d05e7032
 SHA512:
-  metadata.gz: '08fa1bb4c0444cc2a843b853cf9d6050910574c161a409fda2a65f4e628c014abd55416c5e5ef4e4ddeae8b182673186ce61998bba2187cfcb37521ed81dcd60'
-  data.tar.gz: 968ddeb2cd7fac20a82f409c047083d375be4eec79a3c99c0596b8d1bc78ac14000431ddfdc5d66bd20d3ba23f6a6e173a88ec098245e8b461efcc9af818e713
+  metadata.gz: b8b3240f864d16a1c31eb2575ec700a0bd5674feee8818fe2e6342e2c0807cc8f0c6ac9fc780699d6ccc0c896ce615f829b7d121c7d059c2f3dad1aef192e321
+  data.tar.gz: 3098b0a090dbe5b71eb90cefa2e57127632d40b333aa678c0a0ee6a09bc26e351b3005554bf259ad2011cc4745aef32a158f57cd8d93980efe2c0df33edf3c53

data/CHANGELOG.md

@@ -1,3 +1,62 @@
+# 0.7.0
+
+* Add reactor that can react to action results and issue actions
+
+```ruby
+ActionResult = Data.define(:value)
+Action = Data.define(:value)
+
+reactor = Reactor.define do
+  react :action_result do
+    issue :action
+    issue :another_action
+  end
+
+  react proc { action_result in ActionResult(value: 42) } do
+    issue Action.new(value: "the answer")
+  end
+
+  react ActionResult do
+    issue Action.new(value: action_result.value)
+  end
+end
+
+reactor.react(:action_result)
+# => [:action, :another_action]
+reactor.react(ActionResult.new(value: 42)
+# => #<data Action value="the answer">
+reactor.react(ActionResult.new(value: 1)
+# => #<data Action value=1>
+```
+
+* Add `lmap_on_action_result` extension to reactor
+* Add `rmap_on_action` (aliased to `map_on_action`) extensions to reactor
+* Add `combine_with_decider` extension to reactor
+
+```ruby
+decider = Decider.define do
+  initial_state 0
+
+  decide :action do
+    emit :result
+  end
+
+  decide :another_action do
+    emit :another_result
+  end
+end
+
+reactor = Decider::Reactor.define do
+  react :result do
+    issue :another_action
+  end
+end
+
+decider = reactor.combine_with_decider(decider)
+decider.decide(:action)
+# => [:result, :another_result]
+```
+
 # 0.6.2
 
 * Add `many` extension that takes a decider and manage many instances

data/lib/decider/reactor.rb

@@ -0,0 +1,144 @@
+# frozen_string_literal: true
+
+module Decider
+  module Reactor
+    class Module < ::Module
+      REACT_FALLBACK = proc { [nil, proc {}] }
+
+      React = Data.define(:action_result, :_actions) do
+        def issue(*actions)
+          _actions.push(*actions)
+        end
+      end
+
+      def initialize(reactions:)
+        define_method(:react) do |action_result|
+          context = React.new(action_result: action_result, _actions: [])
+
+          reactions.find(REACT_FALLBACK) do |arg, _|
+            case arg
+            in Proc => fn
+              context.instance_exec(&fn)
+            in artype
+              action_result in ^artype
+            else
+              false
+            end
+          end => [_, handler]
+
+          context.instance_exec(&handler)
+          context._actions
+        end
+
+        define_method(:lmap_on_action_result) do |fn|
+          Decider::Reactor.lmap_on_action_result(fn, self)
+        end
+
+        define_method(:rmap_on_action) do |fn|
+          Decider::Reactor.rmap_on_action(fn, self)
+        end
+
+        define_method(:map_on_action) do |fn|
+          Decider::Reactor.rmap_on_action(fn, self)
+        end
+
+        define_method(:combine_with_decider) do |decider|
+          Decider::Reactor.combine_with_decider(self, decider)
+        end
+      end
+    end
+
+    class Builder
+      DEFAULT = Object.new
+
+      attr_reader :module
+
+      def initialize
+        @reactions = {}
+      end
+
+      def build(&block)
+        instance_exec(&block) if block_given?
+
+        reactor = Class.new
+
+        @module = Module.new(
+          reactions: reactions
+        )
+
+        reactor.extend(@module)
+
+        reactor
+      end
+
+      private
+
+      attr_reader :reactions
+
+      def react(arg, &block)
+        reactions[arg] = block
+      end
+    end
+    private_constant :Builder
+
+    def self.define(&block)
+      builder = Builder.new
+      builder.build(&block)
+    end
+
+    def self.lmap_on_action_result(fn, reactor)
+      define do
+        react proc { true } do
+          reactor.react(fn.call(action_result)).each do |action|
+            issue action
+          end
+        end
+      end
+    end
+
+    def self.rmap_on_action(fn, reactor)
+      define do
+        react proc { true } do
+          reactor.react(action_result).each do |action|
+            issue fn.call(action)
+          end
+        end
+      end
+    end
+
+    def self.map_on_action(fn, reactor)
+      rmap_on_action(fn, reactor)
+    end
+
+    def self.combine_with_decider(reactor, decider)
+      Decider.define do
+        initial_state decider.initial_state
+
+        decide proc { true } do
+          fn = ->(commands, events, ds) {
+            case commands
+            in []
+              events
+            in [head, *tail]
+              new_events = decider.decide(head, ds)
+              new_commands = new_events.flat_map { |action_result| reactor.react(action_result) }
+              new_state = new_events.reduce(ds, &decider.evolve)
+
+              fn.call(tail + new_commands, events + new_events, new_state)
+            end
+          }
+
+          fn.call([command], [], state).each { |event| emit event }
+        end
+
+        evolve proc { true } do
+          decider.evolve(state, event)
+        end
+
+        terminal? do
+          decider.terminal?(state)
+        end
+      end
+    end
+  end
+end

data/lib/decider/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Decider
-  VERSION = "0.6.2"
+  VERSION = "0.7.1"
 end

data/lib/decider.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+require "decider/reactor"
+
 module Decider
   StateAlreadyDefined = Class.new(StandardError)
   StateNotDefined = Class.new(StandardError)

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: decide.rb
 version: !ruby/object:Gem::Version
-  version: 0.6.2
+  version: 0.7.1
 platform: ruby
 authors:
 - Jan Dudulski
 bindir: exe
 cert_chain: []
-date: 2025-06-23 00:00:00.000000000 Z
+date: 2025-07-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: concurrent-ruby
@@ -71,6 +71,7 @@ files:
 - lib/decider.rb
 - lib/decider/event_sourcing.rb
 - lib/decider/in_memory.rb
+- lib/decider/reactor.rb
 - lib/decider/state.rb
 - lib/decider/version.rb
 - sig/decider.rbs