decide.rb 0.6.2 → 0.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cdfca1b85746ead6ae446e0b9bfb697a4cfb08685581cabe78cf6462d88db9a4
-  data.tar.gz: ab375b8863a3e88c39e3f8ce3c6c7957758b2d557c7770f260ba4278843a6fea
+  metadata.gz: 560335da25429790af3eb660d743eb7233c3dad032f9582462de1142c9cf3d91
+  data.tar.gz: c42275236a358e3eac7189cf6e7f57cdc3106aa9e00f203b96d139f24360ee91
 SHA512:
-  metadata.gz: '08fa1bb4c0444cc2a843b853cf9d6050910574c161a409fda2a65f4e628c014abd55416c5e5ef4e4ddeae8b182673186ce61998bba2187cfcb37521ed81dcd60'
-  data.tar.gz: 968ddeb2cd7fac20a82f409c047083d375be4eec79a3c99c0596b8d1bc78ac14000431ddfdc5d66bd20d3ba23f6a6e173a88ec098245e8b461efcc9af818e713
+  metadata.gz: 0da501705ecb75d91b1696f468c9360bc950e7cc0f5ac1ce52a3427beccb2bba8eca1688bee73e874c46c40f17d579ddde4b132a2e6fe04e3737b7091f99619d
+  data.tar.gz: ea55c13433fb463d9746da6fe08016353bc0d38c3aae988f0b7249cfac86ed5325b0bcbb02c3833e5997f43db61f7b293a822988a851273dc39b087d7e4b2e14

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,142 @@
+# frozen_string_literal: true
+
+module Decider::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

data/lib/decider/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Decider
-  VERSION = "0.6.2"
+  VERSION = "0.7.0"
 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.0
 platform: ruby
 authors:
 - Jan Dudulski
 bindir: exe
 cert_chain: []
-date: 2025-06-23 00:00:00.000000000 Z
+date: 2025-07-14 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